# 任务集群与 Mozilla Taskcluster CI 交互。对于大多数操作，请使用本机“taskcluster”CLI。 Python 帮助程序脚本 (`tc.py`) 仅处理本机 CLI 无法处理的内容。 ## 先决条件 ### 任务集群 CLI 酿造安装任务集群任务集群版本 ### 身份验证只读操作（状态、日志、工件）无需身份验证即可工作。写入操作需要凭据。 # 交互登录（推荐本地使用）导出 TASKCLUSTER_ROOT_URL=https://firefox-ci-tc.services.mozilla.com 任务集群登录 # 或者直接设置凭证导出 TASKCLUSTER_CLIENT_ID=您的客户端 ID 导出 TASKCLUSTER_ACCESS_TOKEN=您的访问令牌 ## 本机 CLI — 用于大多数操作当以 Firefox CI 为目标时，始终设置根 URL：导出 TASKCLUSTER_ROOT_URL=https://firefox-ci-tc.services.mozilla.com ### 任务操作 # 任务状态任务集群任务状态 # 流式传输任务日志任务集群任务日志 # 完整任务定义 (JSON) taskcluster 任务 def # 重新运行任务（相同任务ID） taskcluster 任务重新运行 # 取消任务任务集群任务取消 ### 任务组行动 # 列出组中的所有任务（带有状态过滤器选项）任务集群组列表 --all 任务集群组列表 --failed 任务集群组列表 --running # 群组状态汇总任务集群组状态 # 取消组内所有任务任务集群组取消 --force ### 工作池操作对于工作池管理（列出工作人员、终止、批量取消），请参阅“references/worker-pools.md”。它们直接使用“taskcluster api workerManager”和“taskcluster api 队列”。 ## Python 助手 — tc.py 使用此本地技能检查路径： SKILLS_ROOT=/Users/jwmoss/github_moz/agent-skills/skills TC="$SKILLS_ROOT/taskcluster/scripts/tc.py" 该帮助程序处理本机 CLI 未很好涵盖的两个类别： ### 工件列表（带 URL 的完整 JSON）本机“taskcluster 任务工件”仅列出名称。当您需要 URL、内容类型或到期日期来查找和下载特定工件时，请使用“tc.py”。 # JSON 格式的完整工件列表（URL、内容类型、过期时间） uv 运行“$TC”工件 # 对于特定的运行 uv run "$TC" 工件 --run 0 # 通过管道连接到 jq 以查找特定工件 uv 运行“$TC”工件 | jq '.artifacts[] |选择(.name | contains("log")) | .url' ### 具有状态计数的组状态 (JSON) 本机“taskcluster group status”输出不是结构化 JSON。当您需要机器可读的状态计数来编写脚本或分析时，请使用“tc.py”。 # 具有 TotalTasks 和 stateCounts 细分的结构化 JSON uv run "$TC" 组状态 ### 树内操作（需要身份验证）树内操作在 Firefox 任务图中定义，并通过 Taskcluster 挂钩触发。这些 API 相当于 Treeherder 的“自定义操作”菜单中的操作。 **所需范围**：`hooks:trigger-hook:project-gecko/in-tree-action-*` # 列出任务的可用操作 uv run "$TC" 动作列表 # 通过树内操作重新触发（保留任务图依赖性） # 使用这个代替`taskcluster任务重新触发`，它会清除依赖关系 uv run "$TC" 重新触发 # 重新触发多次（默认：5） uv run "$TC" 重新触发多个 --times 10 # 确认失败 - 重新运行失败的测试以确定间歇性与回归 uv run "$TC" 确认失败 # Backfill — 对之前的推送运行测试以找到回归范围 uv run "$TC" 回填 # 使用可选的 JSON 输入按名称触发任何操作 uv run "$TC" 操作 --input '{"key": "value"}' `tc.py` 操作命令接受任务 ID 和完整的 Taskcluster URL： uv 运行“$TC”重新触发 https://firefox-ci-tc.services.mozilla.com/tasks/fuCPrKG2T62-4YH1tWYa7Q ## 常见工作流程 ### 调试任务失败导出 TASKCLUSTER_ROOT_URL=https://firefox-ci-tc.services.mozilla.com # 1.检查任务状态任务集群任务状态 # 2.查看日志任务集群任务日志 # 3.检查完整定义 taskcluster 任务 def # 4.查看组内所有任务任务集群组列表 --all ### 重新触发失败的任务 # 通过树内操作重新触发（对于 Firefox CI 正确 - 保留依赖关系） uv run "$TC" 重新触发 # 重新运行相同的任务（相同的任务ID，没有创建新任务） taskcluster 任务重新运行注意：“taskcluster 任务重新触发”会清除依赖项并中断依赖于上游工件的 Firefox CI 任务（例如，需要构建输出的签名任务）。始终对 Firefox CI 任务使用 `uv run "$TC" retrigger`。 ### 调查间歇性故障 # 1.检查测试的历史通过/失败率 treeherder-cli --history "test_name" --history-count 20 --repo autoland --json # 2. 将失败的作业与过去类似的作业进行比较 treeherder-cli --similar-history --similar-count 50 --repo autoland --json # 3. 检查错误行以获取已知错误建议 uvx --来自 lumberjackth lj 错误 autoland # 4. 如果分诊提示间歇性，请在 CI 中确认 uv run "$TC" 确认失败 # 5. 如果分类表明回归，则回填以找到罪魁祸首推送 uv run "$TC" 回填 ## 相关技能 * **treeherder** ：通过修订查询 CI 作业结果以获取任务 ID * **lando** : 检查登陆作业状态 * **os-integrations** : 运行 Firefox mach try 命令 ## 参考文献 * `references/actions.md` \- 树内操作的详细指南（确认失败、回填等） * `references/examples.md` \- 常见使用模式和工作流程 * `references/integration.md` \- 与其他 Mozilla 工具集成 * `references/worker-pools.md` \-工作池管理、批量操作和紧急关闭 ## 文档 * **Taskcluster 文档**： * **Taskcluster CLI** ： * **Firefox CI** : * **操作规范** ：

任务簇

包含技能