---

name: argocd description: GitOps continuous delivery for Kubernetes with ArgoCD. Use when creating/managing ArgoCD Applications, ApplicationSets, App of Apps patterns, Helm/Kustomize deployments, sync configurations, RBAC/projects setup, notifications, health checks, or private repository configuration.

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:

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

Access UI:

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

CLI Login:

Copyargocd 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

Copy# 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

CopyapiVersion: 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