在Kubernetes (K8s) 中，etcdctl 是用于直接与 etcd 集群交互的命令行工具，主要用于管理和调试 etcd 存储中的键值对数据。etcd 是 K8s 集群的核心组件之一，它作为一个高可用的分布式键值存储系统，用于保存集群的所有重要配置数据。
以下是如何在 Kubernetes 环境中使用 etcdctl 的基本步骤和常见命令示例：
- 安装 etcdctl：
- 通常，如果你正在运行 Kubernetes 集群并且想要在集群外操作 etcd，你需要从 etcd 的官方 GitHub 仓库下载对应版本的
etcdctl二进制文件，然后将其移动到系统的 PATH 路径中，例如/usr/local/bin，并通过chmod命令赋予执行权限。
- 设置 API 版本：
- Kubernetes 1.6 及更高版本使用的是 etcd v3 API。在使用
etcdctl时，需要明确指定 API 版本为 3，这通常是通过设置环境变量来实现的：
export ETCDCTL_API=3
- 如果你不想每次都手动设置，可以在命令行中直接指定：
ETCDCTL_API=3 etcdctl [commands]
- 基本命令示例：
- 连接 etcd 集群：
# 指定 etcd 集群地址 ETCDCTL_API=3 etcdctl --endpoints=https://<etcd-node-1>:2379,https://<etcd-node-2>:2379 endpoint health
- 上述命令用来检查与 etcd 集群的连接以及集群健康状况。注意，如果是安全模式，需要使用 HTTPS，并且可能需要提供证书和密钥信息。
- 读取键值：
ETCDCTL_API=3 etcdctl get /path/to/key
- 此命令用于获取指定键
/path/to/key的值。 - 写入键值：
ETCDCTL_API=3 etcdctl put /path/to/key value
- 此命令用于在 etcd 中设置一个键值对，其中
value是要存储的数据。 - 删除键值：
ETCDCTL_API=3 etcdctl del /path/to/key
- 删除指定的键及其关联的值。
- 查询范围内的键：
ETCDCTL_API=3 etcdctl get --prefix /path/to/prefix
- 查询所有以
/path/to/prefix开头的键值对。 - 监听键的变化：
ETCDCTL_API=3 etcdctl watch /path/to/key
- 实时监听指定键的变更。
- 更多高级操作：
包括事务处理、批量操作、lease管理、成员管理等，可以根据etcdctl的帮助文档进一步探索。
综上所述，请确保替换 <etcd-node-x> 为实际 etcd 节点的地址，并且在必要时提供认证凭据。此外，etcd 3.x 版本的 etcdctl 支持丰富的命令行选项和功能，请查阅官方文档以获取最新的使用指南和完整的命令列表。请注意，由于 etcd 是一个分布式数据库，因此执行写操作时可能需要一些时间才能在所有节点上同步。此外，对于生产环境中的 Kubernetes 集群，你可能需要具有适当的权限和认证信息才能执行 etcdctl 命令。
