CI/CD / 系统课时

区分 OutOfSync 与 Health

区分 OutOfSync 与 Health

Argo CD 同时展示同步状态和资源健康状态,但两者回答的是不同问题:前者比较 Git 期望状态与集群实际状态,后者判断资源当前是否健康运行。把它们混在一起,会导致看到 OutOfSync 就误判服务故障,或看到 Healthy 就忽略配置漂移。

学习目标

  • 区分 Sync Status 与 Health Status 的判断对象
  • 正确理解 OutOfSync、Progressing 和 Degraded 等常见状态
  • 根据状态组合选择验证和排查方向

两个状态回答不同问题

Sync Status 关注配置是否一致。当 Argo CD 计算出的期望 manifests 与集群实际资源存在受管理字段差异时,Application 可能显示 OutOfSync;一致时通常显示 Synced。

Health Status 关注资源是否处于预期运行状态。例如 Deployment 正在滚动更新时可能显示 Progressing,副本达到要求并可用后通常进入 Healthy。资源无法达到健康条件时则可能出现 Degraded 等状态。

Argo CD同步状态与健康状态的二维关系

因此,OutOfSync 本身不是故障告警,Progressing 也不必然表示部署失败。判断应用情况时必须把两个维度一起看。

用命令同时检查状态

假设已经存在名为 myapp 的 Application,可以读取它的总体状态:

bash
argocd app get myapp

预期输出

text
Name:               argocd/myapp
Sync Status:        Synced
Health Status:      Healthy

真实输出还会包含 Project、Server、Namespace、Source 等信息,状态也取决于当时的集群。这里需要重点读取的是 Sync Status 与 Health Status 两行,而不是把整个命令是否成功当作应用健康依据。

常见组合怎样解释

Synced + Healthy 表示 Argo CD 观察到的配置与期望状态一致,并且资源健康。这是最容易理解的稳定状态。

OutOfSync + Healthy 表示存在配置差异,但当前资源仍可能正常提供服务。例如有人手工修改了 Deployment 副本数,应用本身依然健康运行。此时应查看 diff,确认是人为漂移、控制器改写字段,还是 Git 中确实出现了待同步变更。

Synced + Progressing 常见于刚完成同步之后。新的 Deployment 配置已经写入集群,所以配置可以是 Synced,但 Pod 尚未全部 Ready,健康状态仍处于 Progressing。此时更应该观察 rollout,而不是重复点击同步。

Synced + Degraded 则说明期望配置已经应用,但资源没有达到健康状态,例如 Deployment 新版本无法形成足够的可用副本。此时继续同步同一份配置通常不能解决问题,应转向工作负载、事件和 Pod 日志排查。

OutOfSync 先看差异

发现 OutOfSync 后,先让 Argo CD 告诉你实际差在哪里,而不是立即同步覆盖现场。

bash
argocd app diff myapp

预期结果

text
===== apps/Deployment myapp/myapp =====
<diff output>

<diff output> 表示实际差异内容,其字段和格式取决于 Git 期望状态与当前集群资源,因此不能预先固定。若命令没有显示差异,则应结合 Application 状态、资源跟踪方式和差异忽略配置继续检查。

Progressing 要看资源是否前进

Progressing 的关键不是状态名称本身,而是资源有没有持续向健康状态推进。对于 Deployment,可以直接检查 rollout:

bash
kubectl rollout status deployment/myapp -n myapp --timeout=60s

预期输出

text
deployment "myapp" successfully rolled out

如果超时,实际错误文本会随 Kubernetes 版本和资源状态不同。此时继续检查 Pod Ready 状态、事件、镜像拉取、探针以及调度条件,才能确定为什么 Health 长时间不能进入 Healthy。

判断 Argo CD 应用时可以始终问两个独立问题:Git 与集群是否一致?资源是否正常运行? 前一个问题对应 Sync Status,后一个问题对应 Health Status。保持这两个维度分离,才能决定下一步应该查看 diff、执行同步,还是进入 Kubernetes 工作负载排障。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分 OutOfSync 与 Health

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通