欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

etcd基本操作

程序员文章站 2022-07-13 22:10:42
...

概述

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的接口变动较大,尚未进行验证

数据库操作

1、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,则会抛出异常

2、mk:设置键的值,仅当该键不存在时设置 ,如果已存在,则抛出异常

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

3、update:更新一个键的值,仅当该键存在时,如果不存在,则抛出异常

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

4、get:获取某个键的值,如果不存在,则抛出异常

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

5、rm:删除某个键值 ,如果键不存在,则抛出异常

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

6、mkdir:如果给定的键目录不存在,则创建一个新的键目录,如果存在,则报错

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

7、setdir:创建一个键目录,无论存在与否。

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

8、updatedir:更新一个已经存在的目录,如果不存在,则抛出异常

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

9、rmdir:删除一个空目录或者键值对。如果目录不为空,则抛出异常

etcdctl rmdir /dir

10、ls:列出目录下的键或子目录,默认不显示子目录的内容

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

非数据库操作

1、backup:备份etcd数据

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

2、watch:监测一个键值的变化,一旦键值发生更新,就会输出最新的值并退出

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

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

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

4、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

1、set操作

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

2、get操作

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

3、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