seewe
fa276082e1
- bash 与 PowerShell 双版本脚本，默认导入 dev、prod 命名空间（不再导入 public） - 命名空间 ID 可通过 NACOS_NAMESPACES 覆盖，地址/账号/密码走环境变量 - 导入前检查命名空间是否存在（缺失仅告警），逐文件输出导入结果 - 重写 README：文件清单、导入前需修改的配置项、命名空间与脚本用法说明
59 lines
3.4 KiB
Markdown
59 lines
3.4 KiB
Markdown
# Nacos 配置说明
|
||
|
||
本目录存放 seewis-cloud-plus 各服务的 Nacos 配置种子文件，并提供一键导入脚本（支持 dev / prod 双命名空间）。
|
||
|
||
## 文件清单
|
||
|
||
| 文件 | 说明 | 导入前通常需要修改 |
|
||
|---|---|---|
|
||
| `application-common.yml` | 所有服务共享的公共配置 | `spring.data.redis`（host/port/password）、`spring.rabbitmq`、`sa-token.jwt-secret-key`（务必换成自己的随机串）、监控账号（nacos discovery metadata） |
|
||
| `datasource.yml` | 数据库连接 | 各库 jdbc 地址/账号/密码（system / job / ai / workflow） |
|
||
| `ruoyi-auth.yml` | 认证服务 | `security.captcha`（验证码开关与类型）、`security.xcx.apps`（小程序 appid/密钥兜底配置，正式建议用参数管理 `sys.account.xcxApps`）、`justauth`（三方登录密钥） |
|
||
| `ruoyi-gateway.yml` | 网关 | `security.ignore.whites`（放行白名单）、路由规则 |
|
||
| `ruoyi-system.yml` | 系统模块 | `spring.liquibase.enabled`：**全新空库首次启动改为 `true`** 初始化表结构和种子数据，初始化完成后建议改回 `false` |
|
||
| `ruoyi-resource.yml` / `ruoyi-job.yml` / `ruoyi-workflow.yml` / `ruoyi-gen.yml` / `ruoyi-ai.yml` / `ruoyi-snailai-server.yml` / `ruoyi-snailjob-server.yml` | 对应模块 | 各自的 liquibase 开关、第三方参数，按需修改 |
|
||
| `ruoyi-monitor.yml` | SpringBoot Admin 监控 | 监控服务账号密码，按需修改 |
|
||
| `seata-server.properties` | Seata 服务端配置 | 脚本只导入 `*.yml`，此文件需手动在 Nacos 控制台创建（dataId `seata-server.properties`，group `DEFAULT_GROUP`，类型 `properties`） |
|
||
|
||
> 注意：**导入会覆盖服务器上 dataId 相同的同名配置**（按 dataId 全量覆盖），服务器上已有个性化修改的配置请先备份或在控制台核对差异。
|
||
|
||
## 命名空间
|
||
|
||
- 默认导入到 **`dev` 和 `prod`** 两个命名空间，**不会**导入 `public`。
|
||
- 需要先在 Nacos 控制台创建命名空间，**命名空间 ID 必须为 `dev` / `prod`**；如使用其他 ID，通过环境变量 `NACOS_NAMESPACES` 指定（如 `NACOS_NAMESPACES=dev-id-1,prod-id-2`）。
|
||
- 服务的注册与配置拉取必须使用相同命名空间：各服务 `application.yml` / maven profile 中的 `spring.cloud.nacos.discovery.namespace` 与 `spring.cloud.nacos.config.namespace` 需与目标命名空间 ID 一致，否则服务找不到配置。
|
||
|
||
## 导入脚本
|
||
|
||
脚本与本目录的 yml 放在一起，自动导入当前目录下所有 `*.yml`。
|
||
|
||
### Linux / macOS
|
||
|
||
```bash
|
||
chmod +x import-nacos-config.sh
|
||
./import-nacos-config.sh
|
||
```
|
||
|
||
### Windows（PowerShell 5.1+，Win10 1803+ 自带 curl.exe）
|
||
|
||
```powershell
|
||
powershell -ExecutionPolicy Bypass -File .\import-nacos-config.ps1
|
||
```
|
||
|
||
### 环境变量（两个脚本通用）
|
||
|
||
| 变量 | 说明 | 默认值 |
|
||
|---|---|--------------------------|
|
||
| `NACOS_ADDR` | Nacos 地址 | `http://localhost:8848` |
|
||
| `NACOS_USER` | 用户名 | `nacos` |
|
||
| `NACOS_PASS` | 密码 | 未设置时交互输入（避免密码进 shell 历史） |
|
||
| `NACOS_NAMESPACES` | 目标命名空间 ID，逗号分隔 | `dev,prod` |
|
||
|
||
示例：只导入到 dev，指向本地 Nacos：
|
||
|
||
```bash
|
||
NACOS_ADDR=http://127.0.0.1:8848 NACOS_NAMESPACES=dev ./import-nacos-config.sh
|
||
```
|
||
|
||
脚本使用 Nacos 3.x 的 v3 admin API（v1/v2 写接口在 3.x 已移除）；密码输入优先走环境变量 `NACOS_PASS`，否则交互式输入。
|