Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

GitOps

A operational framework that takes DevOps best practices used for application development such as version control, collaboration, compliance, and CI/CD, and applies them to infrastructure automation. GitOps uses Git as a single source of truth for declarative infrastructure and applications.

GitOps is an operational framework that applies the practices developers already use for application code — version control, pull requests, review, and CI/CD — to infrastructure and deployment. Its defining idea is that Git is the single source of truth: the desired state of a system is declared in a repository, and automation continuously reconciles the running environment to match what the repository says it should be. Any change happens through a commit, which makes every change reviewable, auditable, and reversible.

  • Declarative desired state - The whole system is described as data in Git, not as a sequence of imperative deploy steps.
  • Git as source of truth - The repository is authoritative; the live environment is a projection of it, not the other way around.
  • Continuous reconciliation - Agents watch for drift between declared and actual state and pull the system back into line.
  • Change through pull request - Every modification is a reviewable commit, giving you an approval trail and instant rollback via revert.

For API teams, GitOps is why a repository full of OpenAPI definitions, gateway configuration, and governance rules can serve as the operational backbone rather than just documentation. When the contract and the deployed reality both trace back to the same commit history, governance stops being a periodic audit and becomes a property of the pipeline — and, as I keep writing, that Git-anchored source of truth is exactly what makes an API estate legible to the automated and agentic tooling now reading it.

Referenced on the API Evangelist blog

Where this standard shows up across sixteen years of my writing at apievangelist.com — how it fits into API design, governance, and the agentic turn.