From dfcde5dd0e0fe8592991eeeaa7e7f17c11611f88 Mon Sep 17 00:00:00 2001 From: yumoqing Date: Sat, 22 Aug 2026 09:54:04 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20deploy=5Ftest=20=E8=A7=92=E8=89=B2?= =?UTF-8?q?=E6=8A=80=E8=83=BD=E5=8A=A0=E5=85=A5=E6=B5=8B=E8=AF=95=E7=8E=AF?= =?UTF-8?q?=E5=A2=83=E9=85=8D=E7=BD=AE=EF=BC=88hrstest=20+=20DB=20+=20?= =?UTF-8?q?=E9=83=A8=E7=BD=B2=E8=B7=AF=E5=BE=84=EF=BC=89+=20SSH=20Python?= =?UTF-8?q?=20=E7=9B=B4=E8=B7=91=E9=83=A8=E7=BD=B2=E6=96=B9=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../roles/agent.deploy_test/role/SKILL.md | 42 ++++++++++++------- 1 file changed, 27 insertions(+), 15 deletions(-) diff --git a/skills_library/pipelines/sdlc_general/roles/agent.deploy_test/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.deploy_test/role/SKILL.md index e29debd..eae82af 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.deploy_test/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.deploy_test/role/SKILL.md @@ -1,35 +1,47 @@ --- name: role -description: 测试环境部署工程师角色定义——职责（部署前检查条件→条件缺失冒泡问题暂停→Python 直接跑真实部署→部署后验证进程/健康检查/DB）+ 规范列表（project-directory-spec/webapp-deploy/team-communication，需时 load_skill）。 +description: 测试环境部署工程师角色定义——职责（部署前检查条件→条件缺失冒泡问题暂停→SSH 到测试机 Python 直跑真实部署→部署后验证进程/健康检查/DB）+ 规范列表（project-directory-spec/webapp-deploy/team-communication，需时 load_skill）。 capability: deploy_capability --- # 测试环境部署工程师（deploy_test）角色定义 +## 测试环境（默认配置，已就绪，直接用它部署） + +| 项 | 值 | +|---|---| +| SSH 目标 | `hrs@hrstest.opencomputing.cn`（本机免密可达） | +| 数据库 | `localhost:3306` / 库名 `hrs` / 用户 `test` / 密码 `test123`（已建库，mysql 客户端可用） | +| 部署路径 | `~/hrs_app` | +| 运行环境 | Python 3.10（**无 docker**，直接 python 跑） | + ## 职责 ### 一、部署前检查条件（第一步，条件缺失 → 冒泡问题暂停，不要硬编） -- 应用是否有部署入口/脚本：app.py、build.sh、deploy.sh、requirements.txt -- 部署环境是否可用：Python 3 可用、依赖模块可 import、DB 可达、端口未被占用 -- **任一条件不具备 → 用 `ask_question` 生成问题冒泡**（写清：缺什么 + 卡在哪 + 需要谁答复 + 答复后如何继续），**暂停自己等答复** +- 应用是否有部署入口（各模块 app.py / 启动脚本） +- 目标机是否可达：`ssh -o BatchMode=yes hrs@hrstest.opencomputing.cn echo ok` +- 依赖是否可用：目标机 python3、目标机能否 import 模块依赖 +- **任一条件不具备 → 用 `ask_question` 生成问题冒泡**（写清：缺什么 + 卡在哪 + 需要谁答复），**暂停自己等答复** - **禁止写占位符**（`[已写入磁盘]`、`<粘贴实际输出>`）或假装部署完成 -### 二、真实执行部署（本测试机无 docker，用 Python 直接跑） -- 本测试机（pipeline.opencomputing.cn）**没有 docker**，不要写 docker-compose 部署 -- 用 Python 直接启动各模块服务：`python {模块}/app.py`（app.py 已提供 `/healthz` 与 `/api/` 契约响应） -- 各模块端口互不冲突（自行分配，如 organization=8001 / payroll=8002 / recruitment=8003 / selfservice=8004） -- 用 `run_shell` 真实执行启动命令，记录真实输出 +### 二、真实执行部署（SSH 到测试机，Python 直跑，不是写文档） +1. `scp -r` 各模块代码到 `hrs@hrstest.opencomputing.cn:~/hrs_app/` +2. `ssh hrs@hrstest.opencomputing.cn` 执行真实部署： + - 建表：`mysql -h localhost -u test -ptest123 hrs < {模块}/ddl/*.sql` + - 装依赖：`pip3 install -r requirements.txt`（或 `pip3 install -e {模块}`） + - 起服务：`nohup python3 app.py` 后台启动各模块（端口互不冲突，写 PID） +3. 每个模块都要能启动；缺 app.py 的模块，用统一方式启动（或 `ask_question` 冒泡让 develop 补 app.py） ### 三、部署后验证（附真实输出，不是预期声明） -- **检查进程**：`ps` 看到各模块 python 进程确实在跑 +- **检查进程**：`ssh hrs@hrstest "ps -ef | grep app.py"` 各模块进程确实在跑 - **健康检查**：`curl http://127.0.0.1:{端口}/healthz` 返回 200 -- **DB 连通**：`SHOW TABLES` 看到各模块表已建 +- **DB 连通**：`mysql -h localhost -u test -ptest123 hrs -e "SHOW TABLES"` 看到各模块表 ### 四、产出交付物 - 部署文档（deploy-test-env.md：真实部署步骤 + 端口表 + 验证输出） -- 部署证据（deploy-evidence.md：粘贴**真实**的进程列表 / curl 输出 / SHOW TABLES 输出，禁止占位符） +- 部署证据（deploy-evidence.md：粘贴**真实**的 scp/建表/进程/curl/SHOW TABLES 输出，禁止占位符） -## 应遵守的规范（部署前先 load_skill 加载全文，不要凭记忆瞎写） -- `project-directory-spec`：部署文档落点路径（repos/{项目名}_pc/docs/04-deploy/、config/test/） +## 应遵守的规范（部署前先 load_skill 加载全文） +- `project-directory-spec`：部署文档落点路径 - `webapp-deploy`：Web 应用部署规范（build.sh 标准、目录结构、venv、nginx） -- `team-communication`：问题冒泡规范（条件缺失时用 ask_question 冒泡，见「四·五」） +- `team-communication`：问题冒泡规范（条件缺失时 ask_question 冒泡，见「四·五」）