ArgoCD

ArgoCD is our declarative, GitOps continuous delivery tool for Kubernetes. It serves as the foundation for managing all infrastructure and platform deployments across Titanbay’s GKE clusters.

Overview

Titanbay uses ArgoCD to implement GitOps principles across all Kubernetes environments. ArgoCD watches our Git repositories and automatically synchronises the desired state defined in manifests to the live state in our clusters.

Key Concepts

Cluster Topology

ArgoCD is deployed across 4 GKE clusters with a hub-and-spoke architecture:

graph TD
    subgraph hub["Infra Management Cluster (Hub)"]
        argocd_ha["ArgoCD HA<br/>Self-managing<br/>Manages all clusters"]
    end

    subgraph dev["TB Platform Dev"]
        argocd_dev["ArgoCD (Helm)<br/>Managed by Hub"]
    end

    subgraph qa["TB Platform QA"]
        argocd_qa["ArgoCD (Helm)<br/>Managed by Hub"]
    end

    subgraph prod["TB Platform Prod"]
        argocd_prod["ArgoCD (Helm)<br/>Managed by Hub"]
    end

    argocd_ha --> argocd_dev
    argocd_ha --> argocd_qa
    argocd_ha --> argocd_prod

Cluster Details

Repository Structure

ArgoCD manifests are organised under k8s/infra-services/argocd/:

argocd/
├── base/                           # Core ArgoCD manifests for infra-mgmt cluster
│   ├── argocd-ha-3.2.1.yaml        # HA ArgoCD standalone manifest
│   ├── argocd-image-updater-*.yaml # Image Updater configuration
│   ├── pod-disruption-budgets.yaml # PDBs for high availability
│   └── ...
├── overlays/
│   └── infra-platform-cluster/     # Infra management cluster overlay
│       ├── apps/                   # ArgoCD Applications (app-of-apps)
│       ├── application-sets/       # ApplicationSets for dynamic generation
│       ├── projects/               # AppProject definitions
│       └── patches/                # Cluster-specific patches
└── tb-platform/                    # ArgoCD for tb-platform clusters
    ├── base/                       # Helm-based ArgoCD configuration
    │   └── argocd-helm.yaml        # Helm chart Application
    └── overlays/
        ├── tb-platform-dev/        # Dev cluster overlay
        ├── tb-platform-qa/         # QA cluster overlay
        └── tb-platform-prod/       # Prod cluster overlay

AppProjects

ArgoCD Projects provide logical groupings with RBAC controls:

What’s Next

• Managed Services - What ArgoCD manages on the infra management cluster
• Cluster Topology - Detailed view of ArgoCD deployment across clusters
• Self-Management - How ArgoCD maintains and updates itself