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

Concept	Description
Application	Kubernetes resource tracking a Git repo path to a cluster/namespace
AppProject	Logical grouping with source/destination restrictions and RBAC
ApplicationSet	Template for generating multiple Applications from generators
Sync	Process of applying Git manifests to cluster
Health	Status assessment of deployed resources

Task Reference

Application Management

Create, sync, delete Applications → references/applications.md
App of Apps pattern, multi-source sidecar → references/applications/app-of-apps.md

Multi-Cluster & Templating

List, Cluster, Git, Matrix generators → references/applicationsets.md
Merge, Pull Request, Go templates, Progressive Syncs → references/applicationsets/advanced.md

Manifest Tools

Helm charts, values, OCI registries → references/helm.md
Helm options, random values, hook mapping → references/helm/options.md
General kustomize (bases, overlays, components, replacements) → kustomize skill
ArgoCD kustomize overrides, multi-source Helm+kustomize → references/kustomize.md

Sync Configuration

Sync waves, hooks, phases, retry → references/sync-options.md
Selective sync, skip reconciliation, namespace metadata → references/sync-options/advanced.md

Operations & Admin

AppProjects, RBAC policies, roles → references/operations.md
Health checks, notifications, cluster management → references/operations/health-notifications.md

Repository Setup

Private repos, SSH, HTTPS, GitHub App, credential templates → references/repositories.md
Helm repos, OCI registries, declarative ConfigMaps → references/repositories/helm-repos.md

Troubleshooting

Sync issues, auth, CLI, resource errors → references/troubleshooting.md
Cluster connectivity, Redis, performance → references/troubleshooting/advanced.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

argocd

SKILL.md.claude/skills/argocd/SKILL.md