Step 01 of 06
Understand the idea
With a push-based deployment, a pipeline connects to a cluster and applies changes. With GitOps, a controller in the cluster reads the desired configuration and works to make the cluster match it.
Key technical ideas
Pull-based CD removes cluster credentials from CI
In push CD, GitLab CI/CD needs a kubeconfig or cloud role able to mutate the cluster. In GitOps, CI writes or proposes Git changes. Argo CD, already inside the cluster, pulls approved desired state and applies it.
Reconciliation is the recurring control-loop pattern
Kubernetes controllers compare desired objects with actual objects. Terraform compares configuration with provider state. Argo CD compares Git with the cluster. The pattern is stable: observe, diff, act, repeat.
Drift detection turns manual fixes into visible debt
Someone can still run kubectl edit deployment beacon. Argo CD will notice that live state differs from Git. Depending on policy it can self-heal or report OutOfSync. Either way, the emergency tweak becomes visible.
App and config repositories have different blast radii
The app repository builds Beacon. The config repository says which digest runs in which cluster. Keeping them separate lets many engineers contribute code without gaining direct production deployment rights.
desired: 21 C in the logbook
observed: 18 C in the room
diff: heat needed
action: turn heater on
repeat: measure againThe thermostat does not need a remote operator holding the heater switch. It reads desired state, observes reality and acts until they match.
Push CD and pull GitOps
| Question | Push from CI | Pull with GitOps |
|---|---|---|
Who has cluster creds? | pipelinener | In-cluster controller |
Source of truth | Pipeline run | Git config repo |
Drift handling | Often invisible | Reported or self-healed |
Audit trail | CI logs | Git commit plus sync history |
Technical terms used at work
Desired state — The resources and versions Git says should exist in the cluster.
Drift — A difference between live Kubernetes objects and the Git-declared version.
Self-heal — Automatic correction of live drift back to the declared Git state.
Sync wave — An Argo CD annotation that orders resources during a sync.
