etcdctl的使用[v2版本]

左手的ㄟ右手 2022-06-13 11:23 299阅读 0赞

## 说明：本文介绍etcdctl v2版本的使用，etcdctl v3版本的使用请参考：[https://blog.csdn.net/huwh\_/article/details/80225902][https_blog.csdn.net_huwh_article_details_80225902] ##

## 一、etcdctl介绍 ##

etcdctl是一个命令行的客户端，它提供了一个简洁的命令，可理解为命令工具集，可以方便我们在对服务进行测试或者手动修改数据库内容。etcdctl与其他xxxctl的命令原理及操作类似（例如kubectl，systemctl）。

用法：etcdctl \[global options\] command \[command options\]\[args...\]

## 二、Etcd常用命令 ##

### （一）数据库操作命令 ###

etcd 在键的组织上采用了层次化的空间结构（类似于文件系统中目录的概念），数据库操作围绕对键值和目录的 CRUD \[增删改查\]（符合 REST 风格的一套操作：Create, Read, Update, Delete）完整生命周期的管理。

具体的命令选项参数可以通过 etcdctl command --help来获取相关帮助。

#### 1）对象为键值 ####

1.  ##### set\[增:无论是否存在\]:etcdctl set key value #####
2.  ##### mk\[增:必须不存在\]:etcdctl mk key value #####
3.  ##### rm\[删\]:etcdctl rm key #####
4.  ##### update\[改\]:etcdctl update key value #####
5.  ##### get\[查\]:etcdctl get key #####

#### 2）对象为目录 ####

1.  ##### setdir\[增:无论是否存在\]:etcdctl setdir dir #####
2.  ##### mkdir\[增:必须不存在\]: etcdctl mkdir dir #####
3.  ##### rmdir\[删\]:etcdctl rmdir dir #####
4.  ##### updatedir\[改\]:etcdctl updatedir dir #####
5.  ##### ls\[查\]:etcdclt ls #####

### （二）非数据库操作命令 ###

1.  ##### backup\[备份 etcd 的数据\] #####
    
    etcdctl backup
2.  ##### watch\[监测一个键值的变化，一旦键值发生更新，就会输出最新的值并退出\] #####
    
    etcdctl watch key
3.  ##### exec-watch\[监测一个键值的变化，一旦键值发生更新，就执行给定命令\] #####
    
    etcdctl exec-watch key --sh -c "ls"
4.  ##### member\[通过 list、add、remove、update 命令列出、添加、删除 、更新etcd 实例到 etcd 集群中\] #####
    
    etcdctl member list；etcdctl member add 实例；etcdctl member remove 实例；etcdctl member update 实例。
5.  ##### etcdctl cluster-health\[检查集群健康状态\] #####

### （三）常用配置参数 ###

设置配置文件，默认为/etc/etcd/etcd.conf。

<table style="border-collapse:collapse;margin:0px;padding:0px;"> 
 <thead style="margin-top:0px;width:740px;"> 
 <tr> 
 <th style="border:1px solid rgb(221,221,221);padding:7px 15px 7px 10px;vertical-align:top;color:rgb(51,51,51);min-width:0px;background:rgb(240,240,240) no-repeat 100% 50%;"> 
 <div style="margin:0px;padding:0px;"> 
 配置参数 
 </div></th> 
 <th style="border:1px solid rgb(221,221,221);padding:7px 15px 7px 10px;vertical-align:top;color:rgb(51,51,51);min-width:0px;background:rgb(240,240,240) no-repeat 100% 50%;"> 
 <div style="margin:0px;padding:0px;"> 
 参数说明 
 </div></th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-name</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">节点名称</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-data-dir</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">保存日志和快照的目录，默认为当前工作目录，指定节点的数据存储目录</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-addr</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">公布的ip地址和端口。 默认为127.0.0.1:2379</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-bind-addr</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">用于客户端连接的监听地址，默认为-addr配置</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-peers</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">集群成员逗号分隔的列表，例如 127.0.0.1:2380,127.0.0.1:2381</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-peer-addr</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">集群服务通讯的公布的IP地址，默认为 127.0.0.1:2380.</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-peer-bind-addr</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">集群服务通讯的监听地址，默认为-peer-addr配置</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-wal-dir</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">指定节点的was文件的存储目录，若指定了该参数，wal文件会和其他数据文件分开存储</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-listen-client-urls</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-listen-peer-urls</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">监听URL，用于与其他节点通讯</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-initial-advertise-peer-urls</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">告知集群其他节点url.</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-advertise-client-urls</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">告知客户端url, 也就是服务的url</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-initial-cluster-token</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">集群的ID</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-initial-cluster</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">集群中所有节点</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-initial-cluster-state</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-initial-cluster-state=new 表示从无到有搭建etcd集群</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-discovery-srv</td> 
 <td style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">用于DNS动态服务发现，指定DNS SRV域名</td> 
 </tr> 
 <tr> 
 <td colspan="1" style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">-discovery</td> 
 <td colspan="1" style="border:1px solid rgb(221,221,221);padding:7px 10px;vertical-align:top;">用于etcd动态发现，指定etcd发现服务的URL [https://discovery.etcd.io/],用环境变量表示</td> 
 </tr> 
 </tbody> 
</table>

[https_blog.csdn.net_huwh_article_details_80225902]: https://blog.csdn.net/huwh_/article/details/80225902