Browse Docs

🐙 ArgoCD

What is ArgoCD

ArgoCD is a declarative, GitOps continuous delivery tool for Kubernetes.

Your Git repository is the single source of truth; ArgoCD watches it and continuously syncs the cluster to match the desired state.

1Git repo ──► ArgoCD ──► Kubernetes cluster

Key concepts

  • Application — a group of Kubernetes resources described in Git.
  • Project — groups applications and scopes their permissions.
  • Source — the repo to render from (git, helm, kustomize, …).
  • Sync — reconcile the live cluster with the desired state.

Install

1kubectl create namespace argocd
2kubectl apply -n argocd \
3  -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
4
5# expose the UI
6kubectl port-forward svc/argocd-server -n argocd 8080:443

CLI

 1argocd login localhost:8080
 2
 3argocd app create myapp \
 4  --repo https://github.com/org/repo.git \
 5  --path deploy \
 6  --dest-server https://kubernetes.default.svc \
 7  --dest-namespace default
 8
 9argocd app list
10argocd app sync myapp
11argocd app get myapp

Ops notes

  • With syncPolicy.automated set, ArgoCD re-applies any drift on its own.
  • Don’t commit plaintext secrets to Git — pair ArgoCD with an external secret manager (Vault, sealed-secrets, SOPS/ksops).
Sunday, October 4, 2026 Tuesday, August 1, 2023