GitOps

Overview

Use GitOps-first changes for infra and deployment workflows, then validate locally and let Argo CD reconcile. Only apply directly to the cluster when explicitly instructed or in an emergency.

Workflow

1. Locate the source of truth

   • Argo CD apps and overlays: argocd/
   • Kubernetes manifests: kubernetes/
   • IaC: tofu/, ansible/
   • Service-specific instructions: nearest README.md

2. Edit manifests in Git

   • Prefer updating Argo CD apps/overlays instead of raw kubectl applies.
   • Keep environment-specific changes in overlays.