Skip to content

CRM Center 本地启动与 Apifox 导入 ​

适用项目:/Users/admin/code/hc-project/api-java/hc-crm-center

本文用于本地运行 hc-crm-center-service 并接入开发环境 Nacos,然后将服务生成的 Swagger 接口定义快速导入 Apifox。

同一套构建、启动流程适用于 hc-payroll-center(薪酬中心,端口 7006)等其他 Center 模块:替换仓库路径、JAR 名与端口即可。第 8 节给出“什么场景用什么启动方式”,并附 Payroll 的完整命令。

1. 前置条件 ​

  • 已安装并可使用 JDK 8 与 Maven;
  • 已接入公司网络,能够访问开发环境 Nacos;
  • 已从团队维护的环境信息中取得 Nacos 地址、命名空间、账号和密码;
  • 服务使用的开发环境 Redis、数据库、RabbitMQ 等依赖由 Nacos 配置提供,通常无需在本机另行启动。

不要将环境账号或密码提交到代码库、博客文档或 Apifox 项目变量中。建议仅在当前终端使用环境变量。

2. 构建 ​

首次运行,以及本地 Java 代码、资源文件或 pom.xml 有改动后,在项目聚合根目录执行:

bash
cd /Users/admin/code/hc-project/api-java/hc-crm-center
mvn -pl hc-crm-center-service -am package -DskipTests -Dmaven.javadoc.skip=true

构建成功后,运行产物为:

text
/Users/admin/code/hc-project/api-java/hc-crm-center/hc-crm-center-service/target/hc-crm-center-service.jar

没有改动本地代码、资源或 Maven 依赖时,后续启动可跳过构建,直接使用已有 JAR。

不要在父目录执行 mvn spring-boot:run。根模块只是 Maven 聚合模块,没有可运行的 Spring Boot 主程序,因此会出现 No plugin found for prefix 'spring-boot' 等错误。

3. 启动并接入开发环境 Nacos ​

本节启动方式会把本机实例注册到开发环境 Nacos(默认行为),适合需要 dev 流量调到本机的场景。只做本地调试、不想影响 dev 时,改用第 8.1 节的 register-enabled=false 启动。

先在当前终端设置 Nacos 凭证。HC_NACOS_* 是本机终端变量名,可按实际环境信息填写:

bash
export HC_NACOS_IP='开发环境 Nacos 地址'
export HC_NACOS_PORT='8848'
export HC_NACOS_NAMESPACE='hc-erp'
export HC_NACOS_GROUP='DEFAULT_GROUP'
export HC_NACOS_USERNAME='开发环境 Nacos 用户名'
export HC_NACOS_PASSWORD='开发环境 Nacos 密码'

本地通过 127.0.0.1:7001 调试、且不希望本机实例出现在开发环境 Nacos 时,使用下面的命令:

bash
cd /Users/admin/code/hc-project/api-java/hc-crm-center/hc-crm-center-service

java -jar target/hc-crm-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip="$HC_NACOS_IP" \
  --hc.nacos.port="$HC_NACOS_PORT" \
  --hc.nacos.config_namespace="$HC_NACOS_NAMESPACE" \
  --hc.nacos.discovery_namespace="$HC_NACOS_NAMESPACE" \
  --hc.nacos.group="$HC_NACOS_GROUP" \
  --hc.nacos.username="$HC_NACOS_USERNAME" \
  --hc.nacos.password="$HC_NACOS_PASSWORD"

这个参数只关闭“服务注册”,不会关闭从 Nacos 读取配置,因此仍然会使用开发环境的远程配置。

如果需要让开发环境网关或其他服务通过 Nacos 找到本机实例,去掉 --spring.cloud.nacos.discovery.register-enabled=false,然后启动:

bash
java -jar target/hc-crm-center-service.jar \
  --hc.nacos.ip="$HC_NACOS_IP" \
  --hc.nacos.port="$HC_NACOS_PORT" \
  --hc.nacos.config_namespace="$HC_NACOS_NAMESPACE" \
  --hc.nacos.discovery_namespace="$HC_NACOS_NAMESPACE" \
  --hc.nacos.group="$HC_NACOS_GROUP" \
  --hc.nacos.username="$HC_NACOS_USERNAME" \
  --hc.nacos.password="$HC_NACOS_PASSWORD"

--logging.json.format=true 只在团队要求 JSON 控制台日志时添加;本机调试 Apifox 不需要这个参数。

bash
java -jar hc-payroll-center-service/target/hc-payroll-center-service.jar \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp \
  --logging.json.format=true

日志中出现 Started CRMCenterApplication 即表示应用启动完成。服务默认监听 7001 端口。

如果看到下面的日志错误:

text
Failed to create parent directories for [/data/logs/hc-crm-center-service/hc-crm-center-service.json]

这是开发环境公共日志配置使用了 Linux 固定目录,而本机没有 /data/logs,不是 Nacos 连接失败。日志中的级别通常是 WARN;继续等待启动结束,并按下面的健康检查确认服务状态。若最终没有出现 Started CRMCenterApplication,再处理日志目录问题。

本地调试通常不需要 JSON 文件日志,可先不要添加 --logging.json.format=true。如果必须保留文件日志,需要由团队统一调整公共 logback-config.xml 的日志目录,或在本机准备具有写权限的 /data/logs/hc-crm-center-service 目录;不要把临时目录修改提交到项目配置。

运行 ​

这两条命令是为了让两个独立的 Maven 项目互相识别,并确认代码能编译通过。 hc-tenant-center 依赖了: com.hcframework.boot:hc-auth-center-api 但 hc-auth-center 和 hc-tenant-center 是两个独立项目,不会自动一起编译。 第一条: cd hc-auth-center

bash
cd /Users/admin/code/hc-project/api-java/hc-auth-center
mvn clean -pl hc-auth-center-api -am -DskipTests install

cd /Users/admin/code/hc-project/api-java/hc-tenant-center
mvn -pl hc-tenant-center-service -am -DskipTests compile

完整流程是:

auth-center-api: clean install
        ↓
tenant-center: compile
        ↓
IDEA: Reload Maven

健康检查 ​

在另一个终端执行:

bash
curl -i http://127.0.0.1:7001/actuator/health

返回 HTTP 200 且响应包含 UP,说明本机服务可用。

停止服务 ​

在启动服务的终端按 Ctrl+C。服务会注销本机在 Nacos 中的实例;不要关闭或停止开发环境 Nacos 本身。

4. 快速导入 Apifox ​

服务启动并通过健康检查后,Swagger 2 JSON 地址为:

text
http://127.0.0.1:7001/v2/api-docs

在浏览器打开该地址,能看到一段 JSON,即表示可以导入。

在 Apifox Desktop 中:

  1. 打开目标项目,在左侧进入“接口管理”。
  2. 点击“导入”,选择“URL 导入”。
  3. 格式选择 Swagger 2.0,填入 http://127.0.0.1:7001/v2/api-docs。
  4. 选择导入到的目录;首次导入建议新建目录,例如 CRM Center(本地)。
  5. 确认导入。Apifox 会生成接口、请求参数、响应模型和接口分组。

之后接口注解或字段发生变化,只要服务已重新构建并启动,在同一导入入口再次从该 URL 导入,选择“更新已有接口”即可同步。

5. 在 Apifox 调试接口 ​

创建一个名为“本地 CRM”的环境,并设置:

text
baseUrl = http://127.0.0.1:7001

将接口的服务器地址切换为该环境。CRM 接口通常依赖网关传入的登录、租户和权限上下文;直接请求本地端口时,如返回未登录、无租户或无权限,需要使用团队规定的本地调试请求头或通过开发环境网关发起调用,不能仅凭 Apifox 导入解决鉴权问题。

6. 常见问题 ​

现象原因与处理
No plugin found for prefix 'spring-boot'在父聚合模块执行了 mvn spring-boot:run。使用第 2 节的构建命令,再使用第 3 节的 java -jar 命令。
curl 连接不上 7001服务尚未完成启动或已经退出。先查看启动终端,确认有 Started CRMCenterApplication。
日志提示 /data/logs/hc-crm-center-service 不存在远程公共日志配置使用了 Linux 文件目录。本机开发可先忽略该 WARN,以 Started CRMCenterApplication 和健康检查结果为准;需要文件日志时联系基础设施维护统一日志配置。
Apifox URL 导入失败先在浏览器访问 http://127.0.0.1:7001/v2/api-docs。若打不开,先处理服务启动问题;若返回非 JSON,保留响应内容并排查 Swagger 配置。
启动后访问业务接口报认证、租户或权限错误服务已启动,但请求缺少网关上下文。按团队约定设置本地调试请求头,或改经开发环境网关调用。
改了代码但 Apifox 接口没有变化重新执行构建、重启 JAR,然后在 Apifox 选择“更新已有接口”重新导入。
Nacos 服务列表出现两个 IP(多出本机 IP)说明有第二个实例注册进了同一个 discovery namespace,调用方会把流量分摊给它。日常本地调试改用第 8.1 节 register-enabled=false 启动;已停止的残留实例会随心跳超时自动剔除。

7. 是否需要每次构建 ​

变更情况是否重新构建
仅停止后再次启动否,直接启动已有 JAR。
Nacos 中的远程配置变化通常不需要构建,重启服务以重新加载配置。
修改 Java 代码、application.yml、Mapper XML 等本地资源是。
修改 pom.xml 或依赖版本是。

8. 什么场景用什么启动方式(Payroll 示例) ​

先区分两件事:构建(mvn package)只产出 JAR,不会向 Nacos 注册任何实例;运行(java -jar)才会把本机注册进开发环境。所以“只构建”天然不影响 dev,要不要“注册”取决于你是否需要本地实例被 dev 调到。

场景启动方式注册到 dev Nacos说明
只打包、不运行(改代码、出产物)第 2 节的构建命令否打包不碰 Nacos,dev 无感知。
需要 dev 其他服务或网关调到本机第 8.2 节命令(默认,不带开关)是dev 列表会出现两个 IP,调用方按权重分摊流量,部分请求可能打到本机。
日常本地调试:只本机访问,或本服务作为调用方(推荐)第 8.1 节命令(register-enabled=false)否实例不进 dev 注册表;仍可订阅并调用其他服务,dev 永远调不到本机。
想让实例出现在列表但不接流量把 register-enabled=false 换成 --spring.cloud.nacos.discovery.instance-enabled=false是,但以下线状态展示少数联调场景才用。

8.1 日常本地调试(推荐):不注册 dev ​

先构建(Payroll 聚合根目录):

bash
cd /Users/admin/code/hc-project/api-java/hc-payroll-center
mvn -pl hc-payroll-center-service -am package -DskipTests -Dmaven.javadoc.skip=true

按第 3 节先导出 HC_NACOS_* 凭证环境变量,然后完整启动命令为:

bash
cd /Users/admin/code/hc-project/api-java/hc-payroll-center/hc-payroll-center-service

java -jar target/hc-payroll-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip="$HC_NACOS_IP" \
  --hc.nacos.port="$HC_NACOS_PORT" \
  --hc.nacos.config_namespace="$HC_NACOS_NAMESPACE" \
  --hc.nacos.discovery_namespace="$HC_NACOS_NAMESPACE" \
  --hc.nacos.group="$HC_NACOS_GROUP" \
  --hc.nacos.username="$HC_NACOS_USERNAME" \
  --hc.nacos.password="$HC_NACOS_PASSWORD" \
  --logging.json.format=true

Payroll 默认端口 7006,日志出现 Started PayrollCenterApplication 即启动完成。

--spring.cloud.nacos.discovery.register-enabled=false 是 Spring Cloud Alibaba 原生开关,语义为“只订阅、不注册”:本机仍能通过 Nacos 发现并调用 system、process、pay 等其他服务,但 dev 调用方看不到本机,Nacos 服务列表也不会多出本机 IP。给第 3 节 CRM 命令加上同一个参数,就是 CRM 的不注册版本。

8.2 需要被 dev 调用时:注册到 dev ​

与第 3 节同逻辑,换成 Payroll 路径即可,不要加 register-enabled=false:

bash
cd /Users/admin/code/hc-project/api-java/hc-payroll-center/hc-payroll-center-service

java -jar target/hc-payroll-center-service.jar \
  --hc.nacos.ip="$HC_NACOS_IP" \
  --hc.nacos.port="$HC_NACOS_PORT" \
  --hc.nacos.config_namespace="$HC_NACOS_NAMESPACE" \
  --hc.nacos.discovery_namespace="$HC_NACOS_NAMESPACE" \
  --hc.nacos.group="$HC_NACOS_GROUP" \
  --hc.nacos.username="$HC_NACOS_USERNAME" \
  --hc.nacos.password="$HC_NACOS_PASSWORD" \
  --logging.json.format=true

8.3 Nacos 出现两个 IP 是怎么回事 ​

每个运行中的实例都用自己的机器 IP 注册,同一服务名下有几个实例就有几个 IP。dev 服务器常驻一份;本机若按 8.2 启动,就会多出一个本机 IP。两个 IP 不是主备关系,而是两个平等的实例——调用方会做负载均衡(默认按权重,两个健康实例近似各分一半流量),这正是本机实例会影响 dev 的原因。

停止本地实例后:正常 Ctrl+C 会立刻反注册;进程被强杀时,Nacos 会在心跳超时(默认约 15 秒)后自动剔除。若列表里一直残留旧 IP,先检查本机是否还有残留的 payroll java 进程。

9. 各系统启动命令速查(本地调试不注册版) ​

来源:微服务信息.docx。以下命令均为日常本地调试推荐版,带 --spring.cloud.nacos.discovery.register-enabled=false(只订阅、不注册,dev 看不到本机);需要被 dev 调用时,去掉该行即可(同第 8.2 节)。

前提:在对应仓库根目录先执行构建,例如:

bash
cd /Users/admin/code/hc-project/api-java/hc-payroll-center
mvn -pl hc-payroll-center-service -am package -DskipTests -Dmaven.javadoc.skip=true

其他服务把模块名换成各自的 *-service 即可。命令里的账号密码为开发环境值,文档若会公开,建议改用第 3 节的环境变量写法;需要 JSON 日志时可追加 --logging.json.format=true。

9.3 ERP 服务(命名空间 hc-erp,Nacos 账号 hc-erp) ​

hc-crm-center-service(客户管理,端口 7001)

bash
cd /Users/admin/code/hc-project/api-java/hc-crm-center

java -jar target/hc-crm-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp
bash
java -jar target/hc-crm-center-service.jar \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp \
  --logging.json.format=true

hc-insurance-center-service(社保管理,端口 7002)

Git:git@codeup.aliyun.com:6258dc2fe273565207e57146/hc-insurance/hc-insurance-center.git

bash
cd /Users/admin/code/hc-project/api-java/hc-insurance-center

java -jar hc-insurance-center-service/target/hc-insurance-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp

hc-pms-center-service(项目管理,端口 7003)

Git:git@codeup.aliyun.com:6258dc2fe273565207e57146/hc-pms/hc-pms-center.git

bash
cd /Users/admin/code/hc-project/api-java/hc-pms-center

java -jar hc-pms-center-service/target/hc-pms-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp

hc-personnel-center-service(人力管理,端口 7004)

Git:https://codeup.aliyun.com/6258dc2fe273565207e57146/hc-personnel/hc-personnel-center.git

bash
cd /Users/admin/code/hc-project/api-java/hc-personnel-center

java -jar hc-personnel-center-service/target/hc-personnel-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp

ide 配置

``` --spring.cloud.nacos.discovery.register-enabled=false --hc.nacos.ip=192.168.1.77 --hc.nacos.port=8848 --hc.nacos.config_namespace=hc-erp --hc.nacos.discovery_namespace=hc-erp --hc.nacos.group=DEFAULT_GROUP --hc.nacos.username=hc-erp --hc.nacos.password=hc-erp ```

环境变量

NACOS_IP=192.168.1.77;NACOS_PORT=8848;NACOS_GROUP=DEFAULT_GROUP;NACOS_CONFIG_NAMESPACE=hc-erp;NACOS_DISCOVERY_NAMESPACE=hc-erp;NACOS_USERNAME=hc-erp;NACOS_PASSWORD=hc-erp

hc-cins-center-service(商保中心,端口 7005)

Git:https://codeup.aliyun.com/6258dc2fe273565207e57146/hc-insurance/hc-cins-center.git

bash
cd /Users/admin/code/hc-project/api-java/hc-cins-center

java -jar hc-cins-center-service/target/hc-cins-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp

hc-payroll-center-service(薪酬管理,端口 7006)

bash
cd /Users/admin/code/hc-project/api-java/hc-payroll-center

java -jar hc-payroll-center-service/target/hc-payroll-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp

hc-hire-center-service(招聘中心,端口 7007)

bash
cd /Users/admin/code/hc-project/api-java/hc-hire-center

java -jar hc-hire-center-service/target/hc-hire-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp

hc-invoice-center-service(发票中心,端口 7008)

bash
cd /Users/admin/code/hc-project/api-java/hc-invoice-center

java -jar hc-invoice-center-service/target/hc-invoice-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp

hc-commission-center-service(佣金服务,端口 7009)

bash
cd /Users/admin/code/hc-project/api-java/hc-commission-center

java -jar hc-commission-center-service/target/hc-commission-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-erp \
  --hc.nacos.discovery_namespace=hc-erp \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-erp \
  --hc.nacos.password=hc-erp
  

### 9.1 中台服务(命名空间 hc-center,Nacos 账号 nacos)

**hc-certification-center-service(认证服务,端口 9001)**

```bash
cd /Users/admin/code/hc-project/api-java/hc-certification-center

java -jar hc-certification-center-service/target/hc-certification-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-user-center-service(用户服务,端口 9002)

bash
cd /Users/admin/code/hc-project/api-java/hc-user-center

java -jar hc-user-center-service/target/hc-user-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-auth-center-service(权限服务,端口 9003)

bash
cd /Users/admin/code/hc-project/api-java/hc-auth-center

java -jar hc-auth-center-service/target/hc-auth-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-system-center-service(系统服务,端口 9004)

bash
cd /Users/admin/code/hc-project/api-java/hc-system-center

java -jar hc-system-center-service/target/hc-system-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-log-center-service(日志服务,端口 9005)

bash
cd /Users/admin/code/hc-project/api-java/hc-log-center

java -jar hc-log-center-service/target/hc-log-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-tenant-center-service(租户服务,端口 9006)

bash
cd /Users/admin/code/hc-project/api-java/hc-tenant-center

java -jar hc-tenant-center-service/target/hc-tenant-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

ide 配置

``` --spring.cloud.nacos.discovery.register-enabled=false --hc.nacos.ip=192.168.1.77 --hc.nacos.port=8848 --hc.nacos.config_namespace=hc-center --hc.nacos.discovery_namespace=hc-center --hc.nacos.group=DEFAULT_GROUP --hc.nacos.username=nacos --hc.nacos.password=o6cxhtSMWK8apnScKQWx ```

环境变量

NACOS_IP=192.168.1.77;NACOS_PORT=8848;NACOS_GROUP=DEFAULT_GROUP;NACOS_CONFIG_NAMESPACE=hc-center;NACOS_DISCOVERY_NAMESPACE=hc-center;NACOS_USERNAME=nacos;NACOS_PASSWORD=o6cxhtSMWK8apnScKQWx

hc-support-center-service(支撑服务,端口 9007)

bash
cd /Users/admin/code/hc-project/api-java/hc-support-center

java -jar hc-support-center-service/target/hc-support-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-integrated-center-service(集成中心,端口 9009)

bash
cd /Users/admin/code/hc-project/api-java/hc-integrated-center

java -jar hc-integrated-center-service/target/hc-integrated-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-process-center-service(流程中心,端口 9010)

bash
cd /Users/admin/code/hc-project/api-java/hc-process-center

java -jar hc-process-center-service/target/hc-process-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-message-center-service(消息中心,端口 9011)

bash
cd /Users/admin/code/hc-project/api-java/hc-message-center

java -jar hc-message-center-service/target/hc-message-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

hc-task-center-service(任务中心,端口 9012)

Git:git@codeup.aliyun.com:6258dc2fe273565207e57146/hc-center/hc-saas-platform/hc-task-center.git

bash
cd /Users/admin/code/hc-project/api-java/hc-task-center

java -jar hc-task-center-service/target/hc-task-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-center \
  --hc.nacos.discovery_namespace=hc-center \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=nacos \
  --hc.nacos.password=o6cxhtSMWK8apnScKQWx

9.2 PAAS 服务(命名空间 hc-paas,Nacos 账号 hc-paas) ​

hc-paas-desform-service(表单引擎,端口 1001)

bash
cd /Users/admin/code/hc-project/api-java/hc-paas-desform

java -jar hc-paas-desform-service/target/hc-paas-desform-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-paas \
  --hc.nacos.discovery_namespace=hc-paas \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-paas \
  --hc.nacos.password=hc-paas

hc-paas-sign-service(签约引擎,端口 1002)

bash
cd /Users/admin/code/hc-project/api-java/hc-paas-sign

java -jar hc-paas-sign-service/target/hc-paas-sign-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-paas \
  --hc.nacos.discovery_namespace=hc-paas \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-paas \
  --hc.nacos.password=hc-paas

ide 配置

``` --spring.cloud.nacos.discovery.register-enabled=false --hc.nacos.ip=192.168.1.77 --hc.nacos.port=8848 --hc.nacos.config_namespace=hc-paas --hc.nacos.discovery_namespace=hc-paas --hc.nacos.group=DEFAULT_GROUP --hc.nacos.username=hc-paas --hc.nacos.password=hc-paas ```

环境变量

NACOS_IP=192.168.1.77;NACOS_PORT=8848;NACOS_GROUP=DEFAULT_GROUP;NACOS_CONFIG_NAMESPACE=hc-paas;NACOS_DISCOVERY_NAMESPACE=hc-paas;NACOS_USERNAME=hc-paas;NACOS_PASSWORD=hc-paas

hc-paas-datasource-service(数据源组件,端口 1003)

bash
cd /Users/admin/code/hc-project/api-java/hc-paas-datasource

java -jar hc-paas-datasource-service/target/hc-paas-datasource-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-paas \
  --hc.nacos.discovery_namespace=hc-paas \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-paas \
  --hc.nacos.password=hc-paas

hc-paas-excel-service(智能结算组件,端口 1004)

bash
cd /Users/admin/code/hc-project/api-java/hc-paas-excel

java -jar hc-paas-excel-service/target/hc-paas-excel-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-paas \
  --hc.nacos.discovery_namespace=hc-paas \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-paas \
  --hc.nacos.password=hc-paas

### 9.4 支付服务(命名空间 hc-pay,Nacos 账号 hc-pay)

**hc-pay-center-service(支付中心,端口 9008)**

```bash
cd /Users/admin/code/hc-project/api-java/hc-pay-center

java -jar hc-pay-center-service/target/hc-pay-center-service.jar \
  --spring.cloud.nacos.discovery.register-enabled=false \
  --hc.nacos.ip=192.168.1.77 \
  --hc.nacos.port=8848 \
  --hc.nacos.config_namespace=hc-pay \
  --hc.nacos.discovery_namespace=hc-pay \
  --hc.nacos.group=DEFAULT_GROUP \
  --hc.nacos.username=hc-pay \
  --hc.nacos.password=hc-pay

9.5 说明 ​

以下 5 个服务已按 微服务信息.docx 补入第 9.1、9.3 节:

  • hc-task-center-service:任务中心,端口 9012,命名空间 hc-center;
  • hc-insurance-center-service:社保管理,端口 7002,命名空间 hc-erp;
  • hc-pms-center-service:项目管理,端口 7003,命名空间 hc-erp;
  • hc-personnel-center-service:人力管理,端口 7004,命名空间 hc-erp;
  • hc-cins-center-service:商保中心,端口 7005,命名空间 hc-erp。

目前本机 api-java 下暂无这 5 个对应代码仓库;把各服务仓库克隆到上面的 hc-*-center 目录后,即可按同样模板执行构建和启动命令。

Lucking