首页/云/Kubernetes 速查/etcd 快照备份与恢复要点
集群运维与排障54 条

etcd 快照备份与恢复要点

定期 snapshot save 备份 etcd;恢复要停 etcd、把快照 restore 到新数据目录再切回,属高风险操作,需按官方流程演练。

Kubernetes 速查云更新于 2026-10-12

备份与校验

备份与校验
ETCDCTL_API=3 etcdctl --endpoints=https://127.0.0.1:2379 \
  --cacert=/etc/kubernetes/pki/etcd/ca.crt \
  --cert=/etc/kubernetes/pki/etcd/server.crt \
  --key=/etc/kubernetes/pki/etcd/server.key \
  snapshot save /backup/etcd-$(date +%F).db
ETCDCTL_API=3 etcdctl --write-out=table snapshot status /backup/etcd-$(date +%F).db
恢复前先在测试环境演练:apiVersion 里的对象都要经 apiserver 校验,恢复后需核对组件与证书时间点。

易错点

  • 只备份不定检:快照文件损坏或导出时间点不对,恢复时才发现
  • 恢复用错证书或数据目录权限,etcd 起不来会连带 apiserver 不可用

数据来源与参考

  • Kubernetes 官方文档 · 备份 etcd 集群
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌