Home/Refreshers/Argo CD: refresher
Argo CD
A controller inside a Kubernetes cluster that keeps the cluster matching a Git repository, and puts back changes made by hand.
Remember
- Git is the source of truth. Deploying means merging.
- Argo CD pulls from Git, so nothing outside the cluster needs credentials into it.
- OutOfSync means the cluster and Git differ. Healthy means it is running well.
- Self-heal undoes hand edits. Prune removes what was deleted from Git.
- An AppProject limits which repositories and namespaces an application may use.
Commands
| List applications | argocd app list |
| See what differs | argocd app diff <app> |
| Sync now | argocd app sync <app> |
| Deployment history | argocd app history <app> |
| Roll back | git revert <commit>, then let it sync |
Watch out
- targetRevision: HEAD follows any merge, from anyone. Name a protected branch or a tag.
- Without the resources finalizer, deleting an Application leaves its workloads running with nobody managing them.
- A floating Helm chart version changes the cluster whenever the chart's author publishes.
Check it worked
Change something by hand in the cluster. Within minutes it shows OutOfSync, and with self-heal on it is put back.