CertGrid CertGrid
Hands-on Lab·Certified Kubernetes Administrator

etcd Backup and Restore

Take a snapshot, create something after it, then restore and watch that thing cease to exist. Done on a real single-node cluster, including the three details that decide whether the restore comes back up: a version-matched binary, the member identity flags, and stopping the control plane first.

Cluster Architecture and Configuration Guide 24 of 103 Advanced

Written against the versions above. etcd 3.6 moved snapshot status and restore out of etcdctl. Guides written against 3.5 will not work here.

Single-node cluster, deliberately. Everything below runs on the control plane node as root.
Server NameIP AddressOSRolesCPURAMHDD
CKA4001192.168.0.191Ubuntu 26.04 LTSControl Plane Node2 Core4 GB50 GB

Before you start

  1. First problem: there is no etcdctl on the node

  2. A quirk worth knowing before it bites you

  3. Talk to etcd, and drop a habit from every older guide

  4. Take the snapshot

  5. Create something after the snapshot, so the restore is provable

  6. Restore, part one: build a new data directory offline

  7. Restore, part two: stop the control plane

  8. Restore, part three: swap the directory and restart

  9. Proof: the canary is gone

Official sources