Core ConceptsADR Library

ADR-005: Argo CD for GitOps

Status

Accepted (2026-05-28)

Context

We need GitOps reconciliation for the payments namespace.

Decision

Argo CD v3.4.2 with multi-source Application pattern (chart from upstream + values from this repo).

Consequences

  • Web UI for sync visibility.
  • Multi-source pattern keeps Helm values reviewable in PR.
  • API version argoproj.io/v1alpha1 (Argo CD has not promoted past v1alpha1).

Alternatives considered

  • Flux: valid alternative; chosen Argo for its UI + multi-source ergonomics.
  • Helm directly via CI: rejected — no drift detection, no self-heal.