docs: clarify diff behavior with server-side apply and Server Side Diff

Signed-off-by: Amelie <151891463+amellab@users.noreply.github.com>
This commit is contained in:
Amelie 2026-02-26 16:20:34 -07:00 committed by GitHub
parent 02635b4d10
commit 3bd992d8d6
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -23,7 +23,7 @@ The following `argocd admin` command prints information about fields excluded fr
argocd admin settings resource-overrides ignore-differences ./deploy.yaml --argocd-cm-path ./argocd-cm.yaml
```
**Diff results when using server-side apply**
**Diff results when using server-side apply (without Server Side Diff)**
When `server-side apply` is enabled, `diff` results may include changes applied by the Kubernetes API server during reconciliation,
such as defaulted fields or updates to `managedFields`.
@ -31,6 +31,8 @@ such as defaulted fields or updates to `managedFields`.
In these cases, Argo CD reports the state observed in the cluster, even if the change was not directly introduced by a user action.
Reviewing the `diff` output produced by the command above can help determine whether the reported difference requires attention.
When Server Side Diff is enabled, Kubernetes managed changes such as defaulted fields and `managedFields` are not expected to appear in the diff.
**Health Assessment**
Argo CD provides built-in [health assessment](./health.md) for several Kubernetes resources which can be further