4. Argo CD 中的滚动升级策略：Sync 策略、Prune、Self-Heal 与 Hooks

在 Argo CD 的滚动升级场景中，同步策略、资源清理、自愈机制以及同步波次与钩子共同构成了升级流程的核心控制面。理解这些组件的交互方式，是校准资源配额与性能调优的前提。

4.1 Sync 策略：自动与手动模式

Argo CD 提供两种同步触发模式，决定了集群状态与 Git 仓库状态之间的偏差如何被处理。

4.2 Prune 与 Self-Heal 机制

Prune 负责清理 Git 仓库中已删除的资源，Self-Heal 则确保集群状态始终与 Git 仓库保持一致。两者在滚动升级中扮演不同角色。

• Prune 行为：当 Git 仓库中移除某个资源定义后，Argo CD 在同步时会删除集群中对应的资源。在滚动升级中，Prune 常用于清理旧版本的 Service、ConfigMap 或临时 Job。
• Self-Heal 行为：当集群中的资源被手动修改（如 kubectl edit）或因故障漂移时，Argo CD 会自动将其恢复为 Git 仓库中的定义。在升级过程中，Self-Heal 可能干扰正在进行的滚动更新，需谨慎配置。

4.3 Sync Waves 与 Hooks 在滚动升级中的应用

Sync Waves 和 Hooks 是 Argo CD 实现有序、分阶段滚动升级的核心机制。通过定义资源同步的先后顺序和前置/后置任务，可以精确控制升级流程。

4.3.1 Sync Waves：分阶段资源同步

每个资源可以通过 argocd.argoproj.io/sync-wave 注解指定一个整数值（默认 0）。Argo CD 按照 wave 值从小到大依次同步资源，同一 wave 内的资源并行同步。

apiVersion: apps/v1
kind: Deployment
metadata:
  annotations:
    argocd.argoproj.io/sync-wave: "3"
spec:
  replicas: 5
  ...
---
apiVersion: v1
kind: Service
metadata:
  annotations:
    argocd.argoproj.io/sync-wave: "2"
spec:
  ...
---
apiVersion: v1
kind: ConfigMap
metadata:
  annotations:
    argocd.argoproj.io/sync-wave: "1"
data:
  ...

在滚动升级中，典型的 Wave 分配策略如下：

4.3.2 Sync Hooks：升级前后的任务编排

Hooks 是在同步生命周期特定阶段执行的 Job 或 Pod，常用于数据库迁移、缓存预热、健康检查等任务。Hooks 类型包括 PreSync、Sync、PostSync、SyncFail。

apiVersion: batch/v1
kind: Job
metadata:
  generateName: db-migration-
  annotations:
    argocd.argoproj.io/hook: PreSync
    argocd.argoproj.io/hook-delete-policy: HookSucceeded
spec:
  template:
    spec:
      containers:
      - name: migration
        image: myapp/migration:latest
        command: ["/bin/sh", "-c", "flyway migrate"]
      restartPolicy: Never

4.4 滚动升级流程总览

下图展示了 Argo CD 在滚动升级中，结合 Sync Waves、Hooks 以及 Prune/Self-Heal 的完整执行流程：

4.5 资源配额校准与性能调优要点

在滚动升级过程中，Sync Waves 和 Hooks 的编排直接影响资源使用峰值。以下是针对资源配额校准的关键调优参数：

• Wave 间延迟：通过 argocd.argoproj.io/sync-wave-delay 注解（单位秒）在 Wave 之间插入等待时间，降低 API Server 瞬时压力。
• Hooks 资源限制：为 Hook Job 设置明确的 resources.requests 和 resources.limits，避免迁移任务抢占滚动升级所需资源。
• Prune 策略：在滚动升级期间，建议将 prune: false 配合手动同步，升级完成后再执行一次全量 Prune 清理。
• Self-Heal 窗口：使用 syncOptions: ApplyOutOfSyncOnly=true 减少不必要的状态对比，降低 Controller 资源消耗。