Skip to main content
RunBook Academy

KubernetesCXVII · Change ManagementChange management

Change management as risk governance — the goal of a change

Advanced⏱ ~15 minkubectl

What you'll learn

  • Define change management as risk governance, not bureaucracy
  • Identify the four pillars of a change: plan, review, execute, verify
  • Distinguish risk classes and the governance each requires
  • Identify the production failure modes of unmanaged change

Prerequisites

Verified against Kubernetes 1.34.x · kubeadm 1.34.x · kubectl 1.34.x · etcd 3.6.x · CoreDNS 1.11.x · containerd 1.7.x / 2.x · 2026-08-16

Not yet marked complete on this device.

Change management is the discipline of paying down the risk of change in small, well-understood pieces. The goal is not zero changes; the goal is reversible, well-understood change. A cluster that cannot change is a cluster that is decaying; a cluster that changes without governance is a cluster that is an incident away from an outage.

The four pillars

A change is governed by four pillars:

  1. Plan. The change is described in a document: what is changing, why, what is the risk class, what is the rollback, what is the validation, what is the communication.
  2. Review. A second pair of eyes reads the plan. The reviewer is not the author; the reviewer’s job is to find the thing the author missed.
  3. Execute. The change is run during a window, with the steps from the plan, with the rollback in reach.
  4. Verify. The validation runs. The window closes. The post-change review (PCR) is written.
flowchart LR
    A[Plan] --> B[Review]
    B --> C[Execute]
    C --> D[Verify]
    D --> E[PCR or PIR]
    E --> F[Improvements to next change]
    F --> A

The cycle is the same for every change. The depth of each pillar scales with the risk class: a one-line config tweak gets a single-paragraph plan and a peer review; a control-plane upgrade gets a multi-page plan, a CAB review, and a staged rollout.

Risk classes

A change is classified by the magnitude of its blast radius:

  • Class 1 — No impact. A change that cannot affect the workload’s behaviour. A label flip on a non-selected resource. A documentation update. The review is a peer.
  • Class 2 — Bounded impact. A change that can affect a single workload, in a single namespace, with a tested rollback. A deployment rollout. A config push. The review is a senior engineer.
  • Class 3 — Cluster-wide. A change that can affect the control plane, multiple namespaces, or the cluster’s connectivity. A CNI upgrade. An etcd compaction. The review is a Change Advisory Board (CAB).
flowchart TD
    A[Change] --> B{Risk class?}
    B -->|Class 1| C[Peer review]
    B -->|Class 2| D[Senior review]
    B -->|Class 3| E[CAB review]
    C --> F[Single window]
    D --> G[Pre-staging rehearsal]
    E --> H[Multi-stage rollout]

The class determines the review depth. A Class 1 review that turns out to be Class 3 is a failure of judgement; the remediation is to re-classify and re-review.

The plan

The plan is the change’s contract. The plan is a single document. It contains:

  • Summary. A one-paragraph description of the change.
  • Risk class. The class and the rationale.
  • Owner. The human whose pager lights up.
  • Pre-change gate. The conditions that must be true before the window opens.
  • Execution. The exact command sequence.
  • Validation. The post-change checks.
  • Rollback. The procedure if validation fails.
  • Communication. The audience, the channel, the timing.
  • PIR/PCR. The template for the review.

A plan that is missing any of these is a plan that has decided the missing part is not important.

The review

The review is the second pair of eyes. The reviewer’s job is to find the thing the author missed: the PDB that the drain would violate, the half-imaged node that the cordon would ignore, the certificate that the upgrade would rotate, the readiness probe that the new version would fail.

The review is not a rubber stamp. The review is a contract: the reviewer has signed that they have read the plan and have not found a fatal error. The signature is the audit trail.

The execution

The execution is the plan in action. The execution is run by the owner, with the same pager, with the rollback in reach. The execution is the moment when the plan is no longer a document; it is the cluster.

The most common execution failure is the “in-flight decision”: the operator notices something the plan did not cover and makes a judgement call. The judgement call is a change that was not in the plan. The remediation is to stop and amend the plan, or to escalate.

The verify

The verify is the post-change validation. The verify is the evidence: KPIs, PDBs, synthetic traffic, the operator’s signature. The verify is the only thing that closes the window.

Production discipline

Change management is the discipline of paying down the risk of change in small, well-understood pieces. The cluster’s discipline is the four pillars: plan, review, execute, verify. The cycle is the same for every change; the depth scales with the risk class.

  • Execute within the window. The window is the rectangle that contains the change; an in-flight decision that the plan did not cover belongs outside it, so stop and amend the plan or escalate.
  • Verify with mechanical checks. KPIs, PDBs, synthetic traffic, and the operator’s signature are the evidence that closes the window — nothing else does.

Quiz

Knowledge check · 4 questions

  1. Q1. Which of the following best describes the goal of change management?

  2. Q2. Every change in a production cluster must follow the same review depth regardless of risk class.

  3. Q3. An operator plans to upgrade the cluster's CNI from Calico 3.27 to 3.28 during a maintenance window. The change is in a Class 3 risk class. What must the plan contain?

    The cluster is HA (3 control-plane nodes), 30 workers across 3 domains, with a CNI-driven NetworkPolicy that enforces egress to a specific egress proxy. The CNI upgrade is kubeadm-driven. The operator is on the on-call pager.

  4. Q4. Name the four pillars of change management and explain what each one does.

Passing score: 75%. Answers are checked in this browser.