Agent Skills
返回列表
🔒

Argo CD 镜像标签自动升级

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/advance-gitops-app-manifests-to-newer-container-tags-with-argo-cd-image-updater。

技能介绍

要解决的问题

在 Argo CD 管理的 Kubernetes 应用里，镜像 tag 往往散落在多个 GitOps 清单中。当某个已批准镜像发布了新 tag，团队常需要手动找到 Application、清单文件和镜像字段，再逐个改 tag。这样做的问题不只是重复劳动：手工编辑容易遗漏某个 manifest、偏离 Git 中的单一事实来源，也会把“镜像更新”和“Argo CD 同步”割裂开，增加审计和回滚难度。

技能如何工作

核心能力是围绕 Argo CD Image Updater，跟踪已批准的容器镜像，并把匹配的 GitOps 清单变更写回，而不是在 Argo CD Application 中手动编辑 tag。

关键步骤：

  • 先确认前置条件：应用由 Argo CD 管理，集群内已具备 Argo CD Image Updater，并拥有镜像注册表访问权限。
  • 再确认写回通道：具备 Git 写权限或 Argo CD API 写回权限，让清单变更能够进入 Argo CD 所使用的源。
  • 更新时把镜像 tag 的变更落到匹配的 GitOps 清单，而不是只改运行时状态。
  • 最后交由 Argo CD 完成声明式同步，让部署结果仍然可追溯、可回滚。

适用边界

它适合已经采用 Argo CD、镜像版本由清单声明、且允许程序化写回的场景。如果注册表权限、Git 分支保护、PR review 或 Argo CD API 权限不清晰，直接写入生产清单会有风险。资料同时说明：无法自动提取基于源代码的安装或使用说明；在敏感工作流中运行前，应查看上游项目 https://github.com/1991513ccie-png/skills，并参考官方文档 https://argocd-image-updater.readthedocs.io/。

使用场景

  • 已批准镜像发布新 tag 后，需要把 Argo CD 管理的多个清单中的镜像 tag 统一更新，而不是逐个文件手改。
  • 在拥有 Git 或 Argo CD API 写回权限的仓库中，希望跟踪注册表里的新镜像版本并生成清单变更。
  • Argo CD Application 的镜像 tag 落后于已批准版本，需要以可审计方式写回 GitOps 源并触发同步。
  • 多环境（开发/测试/生产）要批量推进同一镜像的较新 tag，同时保持清单与 Git 单一事实来源一致。

适合人员

  • 平台/DevOps 工程师，负责 Argo CD 管理的 Kubernetes 应用，希望减少逐个清单手动改 tag 的重复操作。
  • SRE，在已批准镜像发布后需要安全更新 GitOps 清单，并确保变更可追溯、可回滚。
  • GitOps 维护者，拥有 Git 或 Argo CD API 写权限，想把镜像 tag 推进标准化为清单变更流程。
  • Kubernetes 平台负责人，负责注册表访问与 Argo CD 同步策略，需要控制哪些 tag 可被自动推进。