Agent Skills
返回列表
🔒

ArgoCD 应用健康诊断

IT 运维与安全 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/argocd-application-health-runbook。

技能介绍

要解决的问题

ArgoCD 里的应用故障往往不是"部署失败"这么简单。一个应用可能显示 OutOfSync——Git 仓库和集群状态不一致;也可能陷入 Degraded——部署了但某个资源健康检查不通过;更麻烦的是某些资源直接 Missing,在应用视图里根本找不到。这三种状态混合出现时,靠人眼在 Web UI 里逐个资源翻看,既慢又容易漏掉根因。

技能如何工作

这个技能的思路是把诊断流程标准化,核心能力包括:

  • REST API 查询:调用 /api/v1/applications/{name} 获取指定应用的同步状态、资源健康状况和操作状态,拿到结构化的健康数据而不是肉眼扫 UI。
  • CLI 交叉验证:结合 argocd CLI 做补充检查,便于在脚本或终端环境里快速定位问题。
  • 分类自动修复:针对 OutOfSync、Degraded 和 Missing 三类资源条件,分别给出对应的自动修复步骤,而不是笼统地"重新 sync"。

关键步骤大致是:先通过 API 拿到应用整体状态和资源清单,定位处于异常条件的资源;再根据异常类型选择对应的修复路径执行;最后复查确认状态恢复。

适用边界

  • 它处理的是 ArgoCD 应用层面健康状态的诊断与修复,不覆盖集群级故障(如节点宕机、etcd 异常)或 ArgoCD 自身的高可用问题。
  • 自动修复步骤需要在目标环境验证后再执行,尤其是涉及删除或重建资源的操作。
  • 源资料提取自 Argo CD 官方上游文档,版本差异可能导致 API 字段行为不同,使用前建议核对所用 ArgoCD 版本的接口定义。

使用场景

  • ArgoCD 应用显示 Degraded,需要通过 API 查询资源健康条件定位根因并执行修复
  • Git 与集群状态不一致(OutOfSync),需要逐资源确认差异并按步骤恢复同步
  • 应用中部分资源在视图里 Missing,需要查询应用详情判断是否未部署或被删除
  • 批量排查多个 ArgoCD 应用的同步和健康状况,定位异常应用并处理

适合人员

  • 负责 Kubernetes 集群的运维工程师,需要在故障发生时快速诊断 ArgoCD 应用健康状态
  • 使用 GitOps 工作流的平台工程师,希望标准化处理 OutOfSync 与 Degraded 应用的流程
  • 负责发布流程的 DevOps 工程师,需要在 CI 或值班场景中快速定位同步失败原因
  • 平台团队值班人员,需要按手册执行修复步骤而不必每次翻 UI 排查