SuperAPI AI 工具集

gha-pipelines

部署与运维

查看项目

更新于 10-15 22:38

技能介绍

用途:为 homelab 仓库创建和修改 GitHub Actions CI/CD 工作流,涵盖校验流水线、OCI 制品晋级和基础设施相关流程。

主要能力与约定:仓库使用 mise 管理工具版本,使 CI 与本地开发版本一致;工作流应委托 Taskfile 命令而非直接调用 CLI。工具安装统一使用 jdx/mise-action@v3,禁止 apt-get/brew。常用动作包括 actions/checkout@v6、docker/login-action@v3、actions/github-script@v7、fluxcd/flux2/action@v2。路径触发需包含工作流文件本身与 .mise.toml。每个工作流文件加 YAML schema 注释,权限保持最小化(如 contents: read,仅在推送 GHCR 时加 packages: write)。

工作流清单:kubernetes-validate.yaml(PR 触发,lint、展开 ResourceSet、构建、模板、kubeconform、pluto)、infrastructure-validate.yaml(PR 触发,格式检查与按模块矩阵测试)、renovate-validate.yaml、build-platform-artifact.yaml(main 推送构建 OCI 制品并打集成标签)、tag-validated-artifact.yaml(状态事件或手动,将已验证制品晋级为稳定 semver)、renovate.yaml(每小时定时)、label-sync.yaml。

OCI 晋级要点:集成轮询使用 semver >= 0.0.0-0(接受 -rc.N),live 轮询 >= 0.0.0(仅稳定版);tag-validated-artifact 有幂等保护,重新打标签前检查已存在的 validated-* 标签;构建工作流查询 GHCR 最新稳定标签、递增 patch 并创建下一个 RC。

反模式:禁止用 apt-get/brew 装工具;禁止用原始 curl/jq 调 GitHub API;禁止在工作流中硬编码版本;禁止 permissions: write-all;禁止省略 workflow_dispatch。

限制:资料未提供具体安装命令、价格或平台支持范围等信息。