iac.htora.dev · security templates

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

  1. Git is the source of truth. Deploying means merging.
  2. Argo CD pulls from Git, so nothing outside the cluster needs credentials into it.
  3. OutOfSync means the cluster and Git differ. Healthy means it is running well.
  4. Self-heal undoes hand edits. Prune removes what was deleted from Git.
  5. An AppProject limits which repositories and namespaces an application may use.

Commands

List applicationsargocd app list
See what differsargocd app diff <app>
Sync nowargocd app sync <app>
Deployment historyargocd app history <app>
Roll backgit 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.

Read the full pageDownload PDF

Registry 0.23.0. Built 2026-11-17.

Made by Habibullah Tora. Source on GitHub. Code under the MIT licence, writing under CC BY 4.0.