Bootstrap ArgoCD for GitOps Deployment

ArgoCD and GitOps

Note

Ansible does not install ArgoCD or apply the GitOps bootstrap. Run these steps after Cilium is ready.

Step 1: Install ArgoCD

kubectl apply -k bootstrap/argocd
kubectl wait --for=condition=available --timeout=600s deployment/argocd-server -n argocd
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath='{.data.password}' | base64 -d; echo

Note

ArgoCD is exposed via Gateway API in infrastructure/gateway/argocd-httproute.yaml (hostname: argocd.sudhanva.me).

This repo patches argocd-cmd-params-cm to set server.insecure: "true" because TLS is terminated at the Gateway. If the UI or CLI gets stuck in redirect loops, confirm the patch is applied and restart the argocd-server deployment.

Step 2: Prepare GitOps bootstrap

Update these files if you fork the repo. The default references point to nsudhanva/homelab:

• bootstrap/root.yaml
• bootstrap/templates/infra-appset.yaml
• bootstrap/templates/apps-appset.yaml
• infrastructure/cilium/cilium.yaml

Confirm the Longhorn data path in bootstrap/templates/longhorn.yaml matches your host.

Note

If you deploy the docs app, also update the image in apps/docs/deployment.yaml and the repository links in docs/docusaurus.config.ts.

flowchart TD
  Root["bootstrap/root.yaml"] --> Argo["ArgoCD"]
  Argo --> InfraSet["infra ApplicationSet"]
  Argo --> AppsSet["apps ApplicationSet"]
  InfraSet --> InfraApps["infra-* apps from infrastructure/"]
  AppsSet --> UserApps["app-* apps from apps/"]

Detailed ApplicationSet Wiring

flowchart TB
  subgraph Bootstrap["bootstrap/"]
    Root["root.yaml"]
    InfraAppSet["templates/infra-appset.yaml"]
    AppsAppSet["templates/apps-appset.yaml"]
  end

  subgraph Repo["Git repo"]
    InfraDir["infrastructure/*"]
    AppsDir["apps/*"]
    AppYaml["apps/*/app.yaml"]
  end

  subgraph Argo["ArgoCD namespace"]
    ArgoServer["argocd-server"]
    AppSetController["applicationset-controller"]
    InfraApps["Applications: infra-*"]
    UserApps["Applications: app-*"]
  end

  Root --> ArgoServer
  Root --> InfraAppSet
  Root --> AppsAppSet
  InfraAppSet --> AppSetController
  AppsAppSet --> AppSetController
  InfraDir --> InfraApps
  AppYaml --> UserApps
  AppsDir --> UserApps
  AppSetController --> InfraApps
  AppSetController --> UserApps

Step 3: Apply the bootstrap

kubectl apply -f bootstrap/root.yaml

Step 4: Verify ArgoCD applications

kubectl get apps -n argocd

For adding workloads, see Deploy Apps With GitOps.

How ApplicationSets work

ApplicationSets watch the apps/ and infrastructure/ folders and create applications automatically:

• apps/*/app.yaml defines app-<name> and its namespace
• infrastructure/* becomes infra-<folder>

Auto-sync is enabled in the ApplicationSets, so Git is the source of truth.