Argo CD Cheatsheet

Argo CD CheatsheetKapitel 07 von 12

Argo CD Drift und Diff

Stand Argo CD 3.5 · Edition 2026.11 · Release-Daten geprüft am 30. Oktober 2026

ignoreDifferences

Erwartete Abweichungen ausblenden statt Dauer-OutOfSync: jsonPointers (Feldpfad), jqPathExpressions (Listenelemente selektieren), managedFieldsManagers (alles eines Field-Managers, z.B. kube-controller-manager).

Gilt per Default nur für den Diff, mit Sync-Option RespectIgnoreDifferences=true auch beim Apply. System-weit: resource.customizations.ignoreDifferences in argocd-cm.

Seit v3.0 ignoriert der Vergleich status bei allen Ressourcen (ignoreResourceStatusField: all).

Server-Side Diff (stabil seit v3.1) rechnet per SSA-Dry-Run gegen den API-Server, bei bestehenden Ressourcen greifen Defaults und Validating Webhooks schon im Diff (neue Ressourcen ohne SSA-Dry-Run), Mutating Webhooks nur mit IncludeMutationWebhook=true. Je App per argocd.argoproj.io/compare-options: ServerSideDiff=true, global per controller.diff.server.side: "true" in argocd-cmd-params-cm. Ab 3.6 (angekündigt) automatisch bei ServerSideApply=true, Opt-out ServerSideDiff=false.

spec:
  ignoreDifferences:
    - group: apps
      kind: Deployment
      jsonPointers:
        - /spec/replicas    # HPA steuert Replicas
    - group: "*"
      kind: "*"
      managedFieldsManagers:
        - kube-controller-manager