docs(deploy): 更新部署文档支持多环境配置和资源管理

- 说明支持多环境配置,文件命名规则调整为 config.{env}.yaml
- 修改示例命令,复制配置文件从示例文件开始
- 更新生产环境配置文件命名和编辑说明
- 调整上传配置文件到NFS服务器的命令,统一命名为 config.yaml
- 增加调整 deploy.sh 中资源限制的说明和示例(CPU、内存)
- 添加查看服务资源使用及详细配置的命令示例
- 改进文档中健康检查和资源使用监控相关内容
This commit is contained in:
zhouyonggao 2026-03-16 18:34:04 +08:00
parent 5afb699635
commit e873ee9a2e
2 changed files with 50 additions and 13 deletions

View File

@ -11,17 +11,23 @@
## 一、准备工作 ## 一、准备工作
### 1.1 创建配置文件 ### 1.1 准备配置文件
#### 1.1.1 复制配置模板 > 💡 **说明**:现在支持多环境配置,文件命名规则为 `config.{env}.yaml`,例如:
> - `config.dev.yaml` - 开发环境
> - `config.test.yaml` - 测试环境
> - `config.prod.yaml` - 生产环境
#### 1.1.1 复制配置模板(可选)
```bash ```bash
cd /Users/zhouyonggao/Project/post-bank-point-mall cd /Users/zhouyonggao/Project/post-bank-point-mall
cp trans_hub/app/ymt/post_bank_point_mall/service/configs/config.yaml \ # 如果还没有配置文件,可以从示例复制
trans_hub/app/ymt/post_bank_point_mall/service/configs/config-prod.yaml cp trans_hub/app/ymt/post_bank_point_mall/service/configs/config.example.yaml \
trans_hub/app/ymt/post_bank_point_mall/service/configs/config.prod.yaml
``` ```
#### 1.1.2 修改生产环境配置 #### 1.1.2 修改生产环境配置
编辑 `trans_hub/app/ymt/post_bank_point_mall/service/configs/config-prod.yaml` 编辑 `trans_hub/app/ymt/post_bank_point_mall/service/configs/config.prod.yaml`
```yaml ```yaml
env: prod # 改为 prod env: prod # 改为 prod
@ -94,8 +100,9 @@ chmod 755 /data/nfs/trans-hub/post_bank_point_mall/config
# 从本地上传配置文件到 NFS 服务器 # 从本地上传配置文件到 NFS 服务器
cd /Users/zhouyonggao/Project/post-bank-point-mall cd /Users/zhouyonggao/Project/post-bank-point-mall
# 如果 NFS 服务器是独立服务器172.29.104.45 # 上传对应环境的配置文件(重命名为 config.yaml
scp trans_hub/app/ymt/post_bank_point_mall/service/configs/config-prod.yaml \ # 例如:上传生产环境配置
scp trans_hub/app/ymt/post_bank_point_mall/service/configs/config.prod.yaml \
root@172.29.104.45:/data/nfs/trans-hub/post_bank_point_mall/config/config.yaml root@172.29.104.45:/data/nfs/trans-hub/post_bank_point_mall/config/config.yaml
# 验证文件是否存在 # 验证文件是否存在
@ -243,11 +250,11 @@ curl -I http://localhost:12022/health
### 5.1 更新配置文件 ### 5.1 更新配置文件
```bash ```bash
# 修改本地配置 # 修改本地配置(根据环境选择对应的文件)
vim trans_hub/app/ymt/post_bank_point_mall/service/configs/config-prod.yaml vim trans_hub/app/ymt/post_bank_point_mall/service/configs/config.prod.yaml
# 重新上传到 NFS # 重新上传到 NFS(重命名为 config.yaml
scp trans_hub/app/ymt/post_bank_point_mall/service/configs/config-prod.yaml \ scp trans_hub/app/ymt/post_bank_point_mall/service/configs/config.prod.yaml \
root@172.29.104.45:/data/nfs/trans-hub/post_bank_point_mall/config/config.yaml root@172.29.104.45:/data/nfs/trans-hub/post_bank_point_mall/config/config.yaml
``` ```
@ -325,6 +332,32 @@ docker service update --replicas 3 trans-hub_post_bank_point_mall
docker service update --replicas 1 trans-hub_post_bank_point_mall docker service update --replicas 1 trans-hub_post_bank_point_mall
``` ```
### 6.8 调整资源限制
```bash
# 修改 deploy.sh 中的资源配置
vim devops/stack/business/post-bank-point-mall/deploy.sh
# 例如:调整 CPU 限制为 50%
export CPU_LIMIT=0.50
# 调整内存限制为 1G
export MEM_LIMIT=1024M
# 重新部署
bash deploy.sh
```
### 6.9 查看资源使用情况
```bash
# 查看服务资源使用
docker stats $(docker ps -q | head -5)
# 查看服务详细配置
docker service inspect trans-hub_post_bank_point_mall --format='{{.Spec.TaskTemplate.Resources}}'
```
### 6.8 健康检查 ### 6.8 健康检查
确保服务健康检查正常: 确保服务健康检查正常:
@ -377,8 +410,12 @@ docker images | grep post_bank_point_mall
# 查看服务状态 # 查看服务状态
watch -n 2 'docker service ls | grep post_bank_point_mall' watch -n 2 'docker service ls | grep post_bank_point_mall'
# 查看资源使用 # 查看资源使用(实时)
docker stats $(docker ps -q | head -5) docker stats $(docker ps -q | head -5)
# 查看服务资源限制配置
docker service inspect trans-hub_post_bank_point_mall \
--format='{{.Spec.TaskTemplate.Resources.Limits.NanoCPUs}},{{.Spec.TaskTemplate.Resources.Limits.MemoryBytes}}'
``` ```
### 8.2 日志收集 ### 8.2 日志收集

@ -1 +1 @@
Subproject commit ce4850724c2a3d9685488f6bfaf3fdd05cf6ae1f Subproject commit 50cf8ea4a8f5a05862bc4bb7be95427cf05dd7d4