ArgoCD

ArgoCD

Declarative GitOps continuous delivery for Kubernetes. ArgoCD continuously monitors Git repositories and automatically syncs application state to match desired configuration.

Quick Start

Install ArgoCD:

kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/​argoproj/​argo-cd/​stable/​manifests/​install.yaml

Access UI:

kubectl port-forward svc/​argocd-server -n argocd 8080:443
# Get initial admin password
argocd admin initial-password -n argocd

CLI Login:

argocd login localhost:8080 --insecure

Core Concepts

Task Reference

Application Management

• Create, sync, delete Applications → references/​applications.md
• App of Apps pattern → references/​applications.md

Multi-Cluster & Templating

• ApplicationSets with generators → references/​applicationsets.md
• List, Cluster, Git, Matrix generators → references/​applicationsets.md

Manifest Tools

• Helm charts, values, OCI registries → references/​helm.md
• Kustomize overlays, patches → references/​kustomize.md

Sync Configuration

• Sync waves, hooks, phases → references/​sync-options.md
• Prune, replace, server-side apply → references/​sync-options.md

Operations & Admin

• RBAC policies, roles → references/​operations.md
• Projects, health checks, notifications → references/​operations.md

Repository Setup

• Private repos, SSH, HTTPS, GitHub App → references/​repositories.md
• Credential templates, certificates → references/​repositories.md

Troubleshooting

• Common issues, FAQ → references/​troubleshooting.md

Common CLI Commands

# Application management
argocd app create <name> --repo <url> --path <path> --dest-server https://kubernetes.default.svc --dest-namespace <ns>
argocd app sync <name>
argocd app get <name>
argocd app delete <name>
argocd app list

# Cluster management
argocd cluster add <context-name>
argocd cluster list

# Repository management
argocd repo add <url> [--ssh-private-key-path | --username/​--password]
argocd repo list

# Project management
argocd proj create <name> -d <server>,<namespace> -s <repo-url>
argocd proj list

Minimal Application Example

apiVersion: argoproj.io/​v1alpha1
kind: Application
metadata:
  name: myapp
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/​org/​repo.git
    targetRevision: HEAD
    path: manifests
  destination:
    server: https://kubernetes.default.svc
    namespace: myapp
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

Official Documentation

• ArgoCD Docs
• Application Spec
• CLI Reference