Appearance
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 中:
- 打开目标项目,在左侧进入“接口管理”。
- 点击“导入”,选择“URL 导入”。
- 格式选择
Swagger 2.0,填入http://127.0.0.1:7001/v2/api-docs。 - 选择导入到的目录;首次导入建议新建目录,例如
CRM Center(本地)。 - 确认导入。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 目录后,即可按同样模板执行构建和启动命令。
