Skip to content

Add "What Is Immutable Infrastructure?" explainer#20120

Draft
alexleventer wants to merge 1 commit into
masterfrom
workprentice/what-is-immutable-infrastructure
Draft

Add "What Is Immutable Infrastructure?" explainer#20120
alexleventer wants to merge 1 commit into
masterfrom
workprentice/what-is-immutable-infrastructure

Conversation

@alexleventer

Copy link
Copy Markdown
Contributor

What this adds

A new what-is explainer: What Is Immutable Infrastructure? (content/what-is/what-is-immutable-infrastructure.md). It's a natural sibling to the drift explainer (#20098) — immutability is the structural way to prevent drift, and the cloud-security explainer already name-drops "immutable infrastructure" without anywhere to point.

What it covers

  • Definition — replace-don't-patch; the running fleet as a disposable build artifact
  • History — snowflake/phoenix/immutable-server lineage and Chad Fowler's 2013 coinage (with the attributions kept straight — Chad Fowler ≠ Martin Fowler)
  • How it works — golden images/Packer, containers/Kubernetes, blue-green and immutable updates
  • Mutable vs. immutable — 7-row comparison table
  • Benefits and trade-offs — including an honest "when not to use it" (stateful data, build-time cost, automation maturity)
  • Relationship to IaC and drift, and how Pulumi supports it (replaceOnChanges, deleteBeforeReplace, provider-API-driven replacement, scheduled drift detection as the safety net)
  • FAQ with six doubt-remover questions

Sourcing

Factual claims (definitions, historical attributions/dates, AWS/Kubernetes/HashiCorp mechanics) were grounded against primary sources via a fact-check research pass before drafting. Claims that couldn't be verified to a primary source (e.g. a specific coiner for "pets vs cattle", specific adoption stats) are deliberately framed as metaphor/engineering reasoning rather than asserted as cited fact.

Notes

  • Passes make lint (markdown); title is Title Case, H2s sentence case, meta_desc under 160.
  • Cross-links the drift explainer, which ships in Add "What Is Infrastructure Drift?" explainer #20098 — until that merges the daily link checker would flag that one internal link as pending. No effect on the Hugo build.
  • Follow-up opportunity: add an inbound link from what-is-cloud-security.md (which mentions "immutable infrastructure" unlinked) once this is live.

🤖 Generated with Claude Code

…tructure explainer

New what-is explainer covering the immutable model: replace-don't-patch,
golden images/Packer, containers, blue-green and immutable updates, the
mutable-vs-immutable contrast, benefits, trade-offs, and how it prevents
drift. Grounded in primary sources (AWS Well-Architected, Kubernetes and
HashiCorp docs, the original Chad Fowler and Martin Fowler posts).

Cross-links the drift, IaC, configuration-management, and cloud-security
explainers plus the replaceOnChanges/deleteBeforeReplace resource options.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@pulumi-bot

Copy link
Copy Markdown
Collaborator

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants