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 已存在。

yaml
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,但不会仅因该配置而自动同步。实际仓库地址、路径和状态取决于环境。

可以显式执行同步:

bash
argocd app sync demo
argocd app get demo

预期输出中应看到同步操作完成,并在资源成功收敛后看到类似状态;具体时间、资源数量和附加字段可能不同:

text
Sync Status: Synced
Health Status: Healthy

开启自动同步

要让 Argo CD 自动处理检测到的期望状态变化,可以配置 automated。prune 和 selfHeal 是两个需要单独理解的能力,而不是“自动同步”的同义词。

yaml
syncPolicy:
  automated:
    prune: true
    selfHeal: true

这是片段示例,应放入上一份 Application 的 spec 下。配置生效后,Git 中受该 Application 管理的资源发生变化时可触发自动同步;prune: true 允许清理由 Git 期望状态中删除的受管资源,selfHeal: true 则允许 Argo CD 对集群侧发生的漂移进行自动修复。

可使用以下命令验证最终策略:

bash
kubectl -n argocd get application demo -o jsonpath='{.spec.syncPolicy.automated}'
printf '\n'

预期输出:

text
{"prune":true,"selfHeal":true}

观察 prune 与 selfHeal

两种能力处理的是不同方向的变化。假设 Deployment 原本由 Git 声明为 3 个副本,如果有人直接在集群中把副本数改为 5,selfHeal 关注的是让实时状态重新回到 Git 声明的状态。如果 Git 删除了某个由该 Application 管理的资源,prune 关注的是同步时删除集群中对应的受管资源。

可以在测试环境制造一次副本漂移:

bash
kubectl -n demo scale deployment demo --replicas=5
kubectl -n demo get deployment demo -o jsonpath='{.spec.replicas}'
printf '\n'

预期输出首先可能短暂显示人工设置的值:

text
5

在 selfHeal: true、Git 仍声明 3 个副本且 Argo CD 完成重新协调后,再次查询应恢复为:

text
3

实际恢复耗时受 Argo CD 的检测与协调周期影响。若一直没有恢复,应先检查 Application 是否启用了自动同步和 selfHeal、资源是否确实由该 Application 管理,以及应用是否存在同步错误。

手动与自动同步的核心差异不是“是否比较状态”:Argo CD 都会持续比较。真正需要决定的是发现差异以后由人批准执行,还是由控制器自动收敛;而 prune 与 selfHeal 又进一步决定自动收敛可以处理哪些差异。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置手动与自动同步

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

登录哪都通