--- name: jenkins-test-control description: Jenkins 测试执行与管理。用于通过 SSH 查看 Jenkins job\/build 日志并归档，同时可通过 Jenkins API 查询、触发、停止、重跑构建；当需要查看测试详情、触发或停止 Jenkins 测试时使用。 --- # Jenkins 测试执行与管理 ## 概述通过 SSH 获取 Jenkins 构建结果与日志，输出结论与建议并归档到 `testrun\/`；必要时通过 Jenkins API 触发、停止或重跑构建。 ## 工作流 1) 明确输入与操作类型 - Jenkins master 地址、job 名称、build 编号（或“最新”）。 - Jenkins 部署目录（默认 `\/mnt\/hdd01\/jenkins\/home\/`）。 - 是否需要落盘到 `testrun\/` 子目录。 2) 定位 build 目录 - 目录模板：`\/mnt\/hdd01\/jenkins\/home\/jobs\/\/builds\/\/` - 最新 build 示例： ```bash ssh "ls -1 \/mnt\/hdd01\/jenkins\/home\/jobs\/\/builds | grep -E '^[0-9]+$' | sort -n | tail -n 1" ``` 3) 判断构建结果 - 读取 `build.xml` 中 ``： ```bash ssh "rg -n '' \/mnt\/hdd01\/jenkins\/home\/jobs\/\/builds\/\/build.xml" ``` - 如无结果，查看是否还在构建或查 console 日志的结束标记。 4) 提取关键异常\/失败 - 首选关键字：`FATAL|ERROR|Exception|FAIL|FAILED|streamLoadFailCount` ```bash ssh "rg -n 'FATAL|ERROR|Exception|FAIL|FAILED|streamLoadFailCount' \/mnt\/hdd01\/jenkins\/home\/jobs\/\/builds\/\/log" ``` - 如需要上下文，用 `sed -n ',p'` 取片段。 5) 输出结论 - 先结论（SUCCESS\/FAILURE\/UNSTABLE），再关键异常与时间点，最后给出建议。 - 若只有构建告警（如依赖重叠），说明其性质是否影响测试结果。 6) 归档到 testrun - 在 `testrun\/<任务名>\/README.md` 记录：任务信息、时间、结果、关键日志、结论。 - 内容需脱敏，避免账号\/密钥进入仓库（testrun 不提交，可记录内网地址）。 ## Jenkins 构建控制（停止\/重跑）脚本：`.codex\/skills\/jenkins-test-control\/scripts\/jenkins_build_control.py` 依赖：`requests`、`click`（用 uv 管理）环境变量： - `JENKINS_URL` - `JENKINS_USER` - `JENKINS_TOKEN` 用法： ```bash uv run python3 .codex\/skills\/jenkins-test-control\/scripts\/jenkins_build_control.py --job --build --stop --rebuild ``` 查询构建状态： ```bash uv run python3 .codex\/skills\/jenkins-test-control\/scripts\/jenkins_build_control.py --job --build --status ``` 查询最新构建： ```bash uv run python3 .codex\/skills\/jenkins-test-control\/scripts\/jenkins_build_control.py --job --latest ``` 查询队列状态： ```bash uv run python3 .codex\/skills\/jenkins-test-control\/scripts\/jenkins_build_control.py --job --queue-id ``` 等待构建完成并输出结果： ```bash uv run python3 .codex\/skills\/jenkins-test-control\/scripts\/jenkins_build_control.py --job --build --wait ``` 写入 testrun 记录： ```bash uv run python3 .codex\/skills\/jenkins-test-control\/scripts\/jenkins_build_control.py --job --latest --testrun-file testrun\/\/README.md ``` 说明： - 默认尝试 `\/\/rebuild`，失败则回退到 `buildWithParameters`（参数来自目标 build）。 - 可用 `--param KEY=VALUE` 覆盖单个参数。 - `--queue-id\/--queue-url` 可用于查看队列项是否已分配 build。 - 触发重跑时默认等待 30s 尝试获取 `queue_build_number\/queue_build_url`（可用 `--queue-wait-seconds 0` 关闭）。 - `--wait` 可轮询直到构建结束，`--wait-timeout 0` 表示无限等待。 - `--testrun-file` 会追加一行构建信息到指定 README。 - 使用前先确认操作影响与目标 build。 ## 注意事项 - SSH 如提示 host key 变更，先人工确认再处理 `known_hosts`。 - 涉及集群影响操作前先征求确认。