How stevesea/argocd-helm-app-of-apps-example works
Project Type & Purpose
• This is a GitOps/CD “deployment” repository containing two Helm charts (argocd-example-apps and argocd-example-infra).
• Its sole purpose is to generate Argo CD AppProject and Application CRDs for multiple environments (test, staging, production) using the “App-of-Apps” pattern.
Main Components
a. Git Repositories
• This repo: Helm charts + values files per environment
• Application/deployment repos for each microservice (external)
b. CI/CD Pipelines
• CI pipeline in app repo (build/push Docker image, bump SemVer)
• CD pipeline in this repo (update manifests, merge branches, helm lint & package)
c. Artifact Stores
• Docker registry (for images)
• Helm chart repository (optional)
d. Argo CD Control Plane
• Argo CD server & repo-server deployed in Kubernetes
e. Kubernetes Cluster(s)
• One cluster per environment (namespaces: test, staging, production)
f. Helm Templating Engine (CLI or library)
• Renders applications.yaml & projects.yaml into CRDs
Relationships & Data Flows
➀ Developer pushes code → triggers CI in app repo → builds Docker image → pushes to Docker registry → tags app repo
➁ CI triggers CD pipeline in deployment repo → updates values/manifests on master → merges to test branch
➂ Argo CD instance (test) auto-syncs this repo’s test branch → helm template → generates AppProject & Application CRDs → applies to argocd namespace
➃ Argo CD then reads those generated Application CRDs → clones each microservice deployment repo → syncs Kubernetes manifests into the test namespace
➄ Promotion (test→staging→prod) happens via Git merge requests in the deployment repo; Argo CD for each environment auto-syncs its corresponding branch
Architectural Patterns & Design Principles
• GitOps: desired state pinned in Git branches
• App-of-Apps: one “umbrella” Argo CD Application per chart, which itself creates child Applications
• Environment isolation: separate branches and k8s namespaces/clusters
• Parameterization: Helm values maps drive per-environment generation