CI/CD / 系统课时
配置手动与自动同步
配置手动与自动同步
Argo CD 是否发现 Git 变化后立即修改集群,由同步策略决定。本课通过同一个 Application 配置手动同步、自动同步、prune 与 selfHeal,并用实际命令观察 Git 期望状态和集群实时状态发生偏差时,各种策略分别会做什么。
学习目标
- 区分手动同步与自动同步的触发方式
- 正确配置
prune与selfHeal并理解风险边界 - 通过 Application 状态验证不同同步策略
同步策略控制什么
Argo CD 持续比较 Git 中的期望状态与 Kubernetes 集群中的实时状态。出现差异时,Application 通常会显示 OutOfSync,但是否立即执行变更取决于同步策略。
手动同步适合希望先审查差异、再明确批准部署的环境。自动同步则允许 Argo CD 在检测到 Git 中出现新的期望状态后自动执行同步,更适合已经建立代码审查和自动验证流程的 GitOps 仓库。

配置手动同步
Application 不配置 spec.syncPolicy.automated 时,可以保持手动同步。下面创建一个最小 Application,假设仓库中的 apps/demo 是有效 Helm Chart,目标 Namespace 已存在。
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: demo
namespace: argocd
spec:
project: default
source:
repoURL: https://github.com/example/platform-config.git
targetRevision: main
path: apps/demo
destination:
server: https://kubernetes.default.svc
namespace: demo
syncPolicy: {}这是配置文件,不会直接产生固定控制台输出。提交并由 Argo CD 读取后,如果 Git 与集群存在差异,应用可处于 OutOfSync,但不会仅因该配置而自动同步。实际仓库地址、路径和状态取决于环境。
可以显式执行同步:
argocd app sync demo
argocd app get demo预期输出中应看到同步操作完成,并在资源成功收敛后看到类似状态;具体时间、资源数量和附加字段可能不同:
Sync Status: Synced
Health Status: Healthy开启自动同步
要让 Argo CD 自动处理检测到的期望状态变化,可以配置 automated。prune 和 selfHeal 是两个需要单独理解的能力,而不是“自动同步”的同义词。
syncPolicy:
automated:
prune: true
selfHeal: true这是片段示例,应放入上一份 Application 的 spec 下。配置生效后,Git 中受该 Application 管理的资源发生变化时可触发自动同步;prune: true 允许清理由 Git 期望状态中删除的受管资源,selfHeal: true 则允许 Argo CD 对集群侧发生的漂移进行自动修复。
可使用以下命令验证最终策略:
kubectl -n argocd get application demo -o jsonpath='{.spec.syncPolicy.automated}'
printf '\n'预期输出:
{"prune":true,"selfHeal":true}观察 prune 与 selfHeal
两种能力处理的是不同方向的变化。假设 Deployment 原本由 Git 声明为 3 个副本,如果有人直接在集群中把副本数改为 5,selfHeal 关注的是让实时状态重新回到 Git 声明的状态。如果 Git 删除了某个由该 Application 管理的资源,prune 关注的是同步时删除集群中对应的受管资源。
可以在测试环境制造一次副本漂移:
kubectl -n demo scale deployment demo --replicas=5
kubectl -n demo get deployment demo -o jsonpath='{.spec.replicas}'
printf '\n'预期输出首先可能短暂显示人工设置的值:
5在 selfHeal: true、Git 仍声明 3 个副本且 Argo CD 完成重新协调后,再次查询应恢复为:
3实际恢复耗时受 Argo CD 的检测与协调周期影响。若一直没有恢复,应先检查 Application 是否启用了自动同步和 selfHeal、资源是否确实由该 Application 管理,以及应用是否存在同步错误。
手动与自动同步的核心差异不是“是否比较状态”:Argo CD 都会持续比较。真正需要决定的是发现差异以后由人批准执行,还是由控制器自动收敛;而 prune 与 selfHeal 又进一步决定自动收敛可以处理哪些差异。