etcd基本操做

目录

• 概述
• 安装etcd
• 使用etcdctl操做etcd
  • 数据库操做
  • 非数据库操做
• 使用curl操做etcd

概述

etcd是一个用于共享配置和服务的高可用键值存储系统，由CoreOS使用开发并做为CoreOS的基础服务启动。etcd的灵感来源于Apache ZooKeeper和doozer，其特色：

• 简单：可用curl进行操做（HTTP+JSON）
• 安全：可以使用SSL客户端证书验证
• 快速：基准测试在每一个实例1000次写入每秒
• 可靠: 使用Raft协议来进行合理的分布式
  etcd是go语言写的，并使用Raft一致性算法来管理一个高可用的复制日志。

etcd 2.0以后，规范了端口号的使用，而且写入了IANA组织的标准端口记录。etcd将提供给外部客户端的端口变为2379，而etcd服务间通讯的端口变为2380

安装etcd

etcd的安装很是简单，能够直接下载编译后的可执行文件，启动以下：

etcd -name etcd1 -data-dir /data/etcd --advertise-client-urls http://10.116.21.131:2379,http://127.0.0.1:2379 --listen-client-urls http://10.116.21.131:2379,http://127.0.0.1:2379

使用etcdctl操做etcd

须要说明的是，下面全部操做都是针对etcd2.0可用，etcd3.0的接口变更较大，还没有进行验证

数据库操做

一、set：设置键值

#支持的选项：
    --ttl "0"    #该键值的超时时间，单位为s，默认为0，永不超时
    --swap-with-value value    #若该键如今的值为value，则进行设置操做
    --swap-with-index '0'    #若该键如今的索引值是指定索引，则进行设置操做
    
#示例：
    etcdctl set /foo/bar "hello"    #设置/foo/bar的值为hello
    etcdctl set /foo/bar "hello" --ttl 60    #设置/foo/bar的值为hello，而且超时时间为60s
    etcdctl set /foo/bar "world" --swap-with-value "hello" #当/foo/bar的值为hello时，则设置/foo/bar的值为world，若是不为hello，则会抛出异常

二、mk：设置键的值，仅当该键不存在时设置 ，若是已存在，则抛出异常

etcdctl mk /foo/new_bar "hello"
#支持的选项：
    --ttl "0"

三、update：更新一个键的值，仅当该键存在时，若是不存在，则抛出异常

etcdctl update /foo/bar "world"
支持的选项：
    --ttl "0"    #单位为s，默认为0，永不超时

四、get：获取某个键的值，若是不存在，则抛出异常

etcdctl get /foo/bar
#支持的选项：
    --sort    #对结果进行排序
    --consistent    #将请求结果发给主节点，保证获取内容的一致性

五、rm：删除某个键值 ，若是键不存在，则抛出异常

etcdctl rm testkey
#支持的选项：
    --dir    #若是键是空目录或者键值对则删除
    --recursive    #删除目录和全部子键
    --with-value    #检查现有的值是否匹配,匹配时才删除
    --with-index '0'     #检查现有的index是否匹配

六、mkdir：若是给定的键目录不存在，则建立一个新的键目录，若是存在，则报错

etcdctl mkdir testdir
#支持的选项：
    --ttl "0"

七、setdir：建立一个键目录，不管存在与否。

etcdctl setdir testdir
#支持的选项：
    --ttl "0"

八、updatedir：更新一个已经存在的目录，若是不存在，则抛出异常

#支持的选项：
    --ttl "0"

九、rmdir：删除一个空目录或者键值对。若是目录不为空，则抛出异常

etcdctl rmdir /dir

十、ls：列出目录下的键或子目录，默认不显示子目录的内容

etcdctl set dir/test "hello"
etcdctl ls dir
#支持的选项：
    --sort    #将结果排序
    --recursive    #若是目录下有子目录，则递归输出子目录中的内容
    -p    #对于输出为目录的，在最后添加"/"进行区分

非数据库操做

一、backup：备份etcd数据

etcdctl backup --data-dir /data/etcd --backup-dir /data/backup/etcd
#支持的选项：
    --data-dir    #etcd的数据目录
    --backup-dir    #备份到指定路径

二、watch：监测一个键值的变化，一旦键值发生更新，就会输出最新的值并退出

etcdctl watch testkey
#支持的选项：
    --forever    #一直监测，直到用户按"Ctrl+C"退出
    --after-index '0'    #在指定index以前一直监测
    --recursive    #返回全部的键值和子键值

三、exec-watch：监测一个键值的变化 ，一旦键值发生更新，就执行给定的命令

etcdctl exec-watch testkey -- sh -c 'ls'
#支持的选项：
    --after-index "0"    #在指定的index前一直监测
    --recursive    #返回全部的值和子键值

四、member：经过list、add、remove命令列出、添加、删除etcd实例到etcd集群中

etcdctl member list
#支持的选项：
    --debug     #输出 cURL 命令，显示执行命令的时候发起的请求
    --no-sync   #发出请求以前不一样步集群信息
    --output, -o 'simple'   #输出内容的格式 (simple 为原始信息，json 为进行    json格式解码，易读性好一些)
    --peers, -C     #指定集群中的同伴信息，用逗号隔开 (默认为: "127.0.0.1:4001")
    --cert-file     #HTTPS 下客户端使用的 SSL 证书文件
    --key-file  #HTTPS 下客户端使用的 SSL 密钥文件
    --ca-file   #服务端使用 HTTPS 时，使用 CA 文件进行验证

使用curl操做etcd

一、set操做

curl -L http://127.0.0.1:2379/v2/keys/foo/bar -XPUT -d value="hello world"

二、get操做

curl -L http://127.0.0.1:2379/v2/keys/foo/bar

三、rm操做

curl -L http://127.0.0.1:2379/v2/keys/foo/bar -XDELETE
{
"action":"delete",
"node:{
    "key":"/foo/bar",
    "modifiedIndex":28,
    "createdIndex":27
    },
"prevNode":{
    "key":"/foo/bar",
    "value":"hi, etcd",
    "modifiedIndex":27,
    "createdIndex":27
    }
}

参考：
https://tonydeng.github.io/2015/11/24/etcd-the-first-using/
http://cizixs.com/2016/08/02/intro-to-etcd