jenkins

deploy/README.md

@@ -57,7 +57,7 @@ Harbor 项目和 Kubernetes 两个环境都会由流水线自动创建 `harbor-r
 | 密码 | Jenkins 凭据 `kra-mysql-root-password` 的值 |
 | 库名 | `kra`（与应用名一致） |
 
-提交后框架自动建表、写入种子数据（管理员账号、菜单、casbin）并把连接配置写回节点目录中的 `config.yaml`，Pod 重建后配置不丢失。初始化期间建议暂时保持后端为 1 个副本，完成后再扩容到 `KRA_REPLICAS`，避免多个 Pod 同时执行首次初始化。初始化完成后请执行一次后端滚动重启，让所有副本加载新配置。**不要**通过环境变量注入数据库 DSN：那会让应用跳过初始化向导，导致数据库有表无种子数据、无法登录。
+提交后框架自动建表、写入种子数据（管理员账号、菜单、casbin）并把连接配置写回节点目录中的 `config.yaml`，Pod 重建后配置不丢失。当前单节点部署固定使用 1 个后端副本，避免多个 Pod 同时执行首次初始化。未来如需扩容，必须先迁移到真正的共享存储，再调整 `KRA_REPLICAS` 并滚动重启，让所有副本加载新配置。**不要**通过环境变量注入数据库 DSN：那会让应用跳过初始化向导，导致数据库有表无种子数据、无法登录。
 
 ## 基于 kra 模板接入新项目
 
@@ -69,7 +69,7 @@ Harbor 项目和 Kubernetes 两个环境都会由流水线自动创建 `harbor-r
 | `IMAGE_REPO` | Harbor 镜像仓库路径 | `library/kra` |
 | `REGISTRY` | Harbor 地址 | `192.168.200.132` |
 | `BIN_NAME` | 后端二进制名，须与 `Makefile` 的 `make build` 产物一致 | `kratos-admin` |
-| `KRA_REPLICAS` | 前后端副本数 | `3` |
+| `KRA_REPLICAS` | 前后端副本数（当前单节点部署使用 1） | `1` |
 | `KRA_FRONTEND_NODEPORT` / `KRA_BACKEND_NODEPORT` | NodePort 端口，同一集群多个项目必须错开 | `30080` / `30081` |
 | `KRA_MYSQL_IMAGE` / `KRA_REDIS_IMAGE` | 中间件镜像 | daocloud mysql:8.4 / redis:7-alpine |
 | `GO_IMAGE` / `NODE_IMAGE` / `PNPM_VERSION` | 构建镜像与工具版本 | 见文件 |