Skip to main content

GitOps Delivery

GitOps makes Git the desired-state source and makes cluster changes auditable. It is strongest when application teams can own configuration safely while platform teams own guardrails.

GitOps deployment flow architecture

Repository models

ModelUse when
App repo contains manifestsSmall teams, simple environments, tight app ownership.
Separate config repoStrong environment control, platform-owned deployment policy.
Mono config repoCentralized governance, easier global review, higher repo coordination cost.
Per-team config repoBetter ownership, more policy automation required.

Delivery controls

  • CI builds and signs immutable artifacts.
  • CD reconciles manifests and surfaces drift.
  • Admission policy validates cluster safety.
  • Rollout health uses workload readiness and SLO impact, not just object sync status.

Failure modes

  • Auto-sync hides broken rollout if health checks are weak.
  • Manual kubectl changes bypass Git and create drift.
  • Helm values become an unreviewed configuration API.
  • Environment overlays diverge so much that staging no longer predicts production.