etcdctl

etcd 键值存储命令行客户端

补充说明

etcdctl 连接 etcd 集群读写键值、查看成员和健康状态、管理租约与快照。Kubernetes 的集群状态就存在 etcd 里，操作前必须确认目标集群和备份。

常用示例

etcdctl --endpoints=https://127.0.0.1:2379 endpoint health
etcdctl --endpoints=https://10.0.0.1:2379,https://10.0.0.2:2379 endpoint status -w table
etcdctl member list -w table
etcdctl put /app/config '{"debug":false}'
etcdctl get /app/config
etcdctl get /app/ --prefix --keys-only
etcdctl del /app/config
etcdctl watch /app/ --prefix
etcdctl lease grant 3600
etcdctl compact 12345
etcdctl defrag --endpoints=https://127.0.0.1:2379
etcdctl snapshot save /backup/etcd-$(date +%F).db

TLS 集群：

etcdctl \
  --endpoints=https://10.0.0.1:2379 \
  --cacert=/etc/etcd/ca.crt \
  --cert=/etc/etcd/client.crt \
  --key=/etc/etcd/client.key \
  endpoint health

易错点与排错

旧版本需要 ETCDCTL_API=3；v3.4 起默认就是 v3，混用 API 版本会出现读写不一致的错觉。
TLS 证书的 SAN 必须包含实际访问的主机名/IP；用 IP 连却只签了域名会握手失败。
集群失去多数派时读写都会失败；先看 endpoint health 和成员状态，不要盲目重启。
defrag 会阻塞当前成员的读写，逐个执行并观察集群健康。
compact 清除历史版本，defrag 回收磁盘空间；两者不能互相替代。
快照恢复要恢复到新集群/新数据目录，不能直接覆盖在线成员的数据目录。
Kubernetes 的 etcd 数据不要手工改键；误删系统键可能导致控制面异常。
get --prefix 很容易一次拉出大量数据；先加 --limit 或 --keys-only。

etcdctl

补充说明

常用示例

易错点与排错

相关命令