工程开发
cross-repo-coordination avatar

cross-repo-coordination

协调 GitHub Actions 运行器配置跨仓库更新,确保工作流标签与运行器规模集相符,以防止作业排队等待。

简介

cross-repo-coordination 技能是一种专业的工程工具,旨在管理多个 project-beta 仓库之间的 GitHub Actions 运行器标签同步。在微服务或多仓库架构中,当 Helm 图表或 ArgoCD 应用中的 runnerScaleSetName 值被修改时,运行器基础设施与工作流定义之间的脱节经常会导致作业陷入“排队”状态。该代理可自动审计 .github/workflows/ 文件以识别差异,生成迁移计划(支持零停机双池策略和快速切换部署),并使用基于 Shell 的补丁执行自动化 PR 创建,从而使基础设施变更与 CI/CD 执行环境保持一致。

  • 对工作流文件执行自动化审计,以检测多个 Git 仓库中过时的 runs-on 标签。

  • 为与 arc-beta-runners 或自定义运行器池相关的基础设施变更生成迁移文档和影响分析。

  • 支持多阶段迁移策略,包括双池部署(蓝绿部署)和同步更新。

  • 使用 sed 和 git-cli 自动化修补 YAML 工作流文件,以高效更新运行器标识符。

  • 提供验证工具,可通过 GitHub CLI (gh) 检查运行器健康状态、标签注册和活动作业状态。

  • 非常适合管理 Rackspace Spot 实例或基于 Kubernetes 的运行器控制器的 DevOps 工程师和平台团队成员。

  • 输入包括目标 runnerScaleSetName 和仓库名称;输出包括迁移 PR、状态报告和验证日志。

  • 限制:需要对仓库工作流的写入权限,并假设 .github/workflows/ 具有标准化的目录结构。

  • 建议在进行基础设施升级、从标准 ubuntu-latest 运行器迁移到自托管 ARC 运行器,或添加具有 GPU 支持等硬件限制的专业运行器池时使用。

  • 与 ArgoCD 和基于 Helm 的 GitOps 工作流紧密集成,确保基础设施即代码 (IaC) 与应用层级的 CI 配置保持一致。

仓库统计

Star 数
0
Fork 数
0
Open Issue 数
5
主要语言
Shell
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 20:11
在 GitHub 查看