etcdutl

etcd 离线数据管理工具

补充说明

etcdutl 是 etcd 3.5+ 提供的离线工具，用于查看快照、恢复快照、备份、整理和迁移数据。它直接操作数据文件，不需要 etcd 服务在线。

常用示例

etcdutl snapshot status /backup/etcd.db -w table
etcdutl snapshot restore /backup/etcd.db \
  --data-dir /var/lib/etcd-restore \
  --initial-cluster node1=https://10.0.0.1:2380 \
  --initial-cluster-token etcd-cluster-1 \
  --initial-advertise-peer-urls https://10.0.0.1:2380
etcdutl backup --data-dir /var/lib/etcd --backup-dir /backup/etcd
etcdutl defrag --data-dir /var/lib/etcd
etcdutl hashkv --data-dir /var/lib/etcd
etcdutl migrate --data-dir /var/lib/etcd

易错点与排错

• 恢复必须写到新数据目录，不能覆盖在线成员的数据目录。
• --initial-cluster、token 和 peer URL 要和目标集群规划一致。
• 快照恢复的是某个 revision；恢复后成员可能落后于原集群。
• 单成员恢复和多成员集群恢复的参数不同；先确认拓扑。
• defrag 会阻塞访问，在线操作要用 etcdctl 并逐个成员执行。
• etcdutl 和 etcdctl 职责不同；快照恢复优先用 etcdutl。
• 版本不匹配可能导致数据格式无法读取；升级前保留旧二进制。
• 操作前备份数据目录，确认磁盘空间和文件权限。

相关命令

• etcdctl — 在线客户端
• systemctl — 管理 etcd 服务
• kubectl — Kubernetes 控制面