etcd的简单使用

etcdctl--debug-ojsonsetmykeyok--ttl100
Cluster-Endpoints:http://localhost:2379,http://localhost:2379,http://localhost:4001,http://localhost:4001
Curl-Example:curl-XPUThttp://localhost:2379/v2/keys/mykey-dvalue=ok-dttl=100
{"action":"set","node":{"key":"/mykey","value":"ok","expiration":"2015-08-14T03:15:14.665295244Z","ttl":100,"modifiedIndex":19036,"createdIndex":19036},"etcdIndex":19036,"raftIndex":100957,"raftTerm":129}

#etcdctl--debug-ojsongetmykey
Cluster-Endpoints:http://localhost:2379,http://localhost:2379,http://localhost:4001,http://localhost:4001
Curl-Example:curl-XGEThttp://localhost:2379/v2/keys/mykey?consistent=true&recursive=false&sorted=false{"action":"get","node":{"key":"/mykey","value":"ok","expiration":"2015-08-14T03:15:14.665295244Z","ttl":23,"modifiedIndex":19036,"createdIndex":19036},"etcdIndex":19077,"raftIndex":101148,"raftTerm":129}

Error:100:Keynotfound(/mykey)[19084]

监控键值的改动

etcdctlwatchkey
curl-XGEThttp://localhost:2379/v2/keys/key?consistent=true&wait=true

etcdctl--debugwatchmykey
Cluster-Endpoints:http://localhost:2379,http://localhost:2379,http://localhost:4001,http://localhost:4001
Curl-Example:curl-XGET'target='_blank'>http://localhost:2379/v2/keys/mykey?consistent=true&wait=true[/code]

当监测到键值设置为kkkkk时打印
kkkkk

若etcdctlwatch带上–forever参数则会不退出一直监测键值的改动,比如这里检测到了set和delete操作
#etcdctl--debug-ojsonwatchmykey--forever
Curl-Example:curl-XGEThttp://localhost:2379/v2/keys/mykey?consistent=true&wait=true
{"action":"set","node":{"key":"/mykey","value":"kkkkk","modifiedIndex":19656,"createdIndex":19656},"prevNode":{"key":"/mykey","value":"kkkkk","modifiedIndex":19645,"createdIndex":19645},"etcdIndex":19655,"raftIndex":104107,"raftTerm":131}Curl-Example:curl-XGEThttp://localhost:2379/v2/keys/mykeyconsistent=true&wait=true&waitIndex=19657
{"action":"delete","node":{"key":"/mykey","modifiedIndex":19661,"createdIndex":19656},"prevNode":{"key":"/mykey","value":"kkkkk","modifiedIndex":19656,"createdIndex":19656},"etcdIndex":19656,"raftIndex":104115,"raftTerm":131}Curl-Example:curl-XGET'target='_blank'>http://localhost:2379/v2/keys/mykey?consistent=true&wait=true&waitIndex=19662[/code]

对于目录类型的key可以用–recursive来检测目录下的子keys的改动同样可以用作监测的命令是exec-watch，相比watch，增加了监测到改动可以执行自定义的操作etcdctlwatchkeycommand
#etcdctlexec-watchmykey--sh-c'echohit'
hit

目录相关的操作
etcdctlmkdirdirname创建一个目录可以关联多个子keys，比如先建立一个名叫mydir的dir
etcdctl--debug-ojsonmkdirmydir
Curl-Example:curl-XPUT'target='_blank'>http://localhost:2379/v2/keys/mydir?dir=true&prevExist=false[/code]

在这个dir下面可以建立多个keys
#etcdctl--debug-ojsonset/mydir/key111111
Curl-Example:curl-XPUThttp://localhost:2379/v2/keys/mydir/key1-dvalue=11111
{"action":"set","node":{"key":"/mydir/key1","value":"11111","modifiedIndex":20850,"createdIndex":20850},"etcdIndex":20850,"raftIndex":110723,"raftTerm":148}#etcdctl--debug-ojsonset/mydir/key222222
Curl-Example:curl-XPUThttp://localhost:2379/v2/keys/mydir/key2-dvalue=22222
{"action":"set","node":{"key":"/mydir/key2","value":"22222","modifiedIndex":20855,"createdIndex":20855},"etcdIndex":20855,"raftIndex":110747,"raftTerm":148}

可以用etcdctllsdirname进行查看，得到该dir下面的2个key
#etcdctl--debug-ojsonls/mydir
Curl-Example:curl-XGEThttp://localhost:2379/v2/keys/mydir?consistent=true&recursive=false&sorted=false/mydir/key2
/mydir/key1

如果向目录名的路径post一个value，那么在这个目录下面会自动用createdIndex创建一个key
#curl-XPOSThttp://localhost:2379/v2/keys/mydir-dvalue=33333
{"action":"create","node":{"key":"/mydir/21442","value":"33333","modifiedIndex":21442,"createdIndex":21442}}#etcdctl--debug-ojsonls/mydir
Curl-Example:curl-XGEThttp://localhost:2379/v2/keys/mydir?consistent=true&recursive=false&sorted=false/mydir/key1
/mydir/key2
/mydir/21442

用rmdir删除目录要保证目录下没有keys，不然会失败
#etcdctl--debug-ojsonrmdirmydir
Curl-Example:curl-XDELETEhttp://localhost:2379/v2/keys/mydir?dir=true&recursive=falseError:108:Directorynotempty(/mydir)[21682]

若要将目录和keys都删除可以用rm指令
#etcdctl--debug-ojsonrmmydir--recursive=true
Curl-Example:curl-XDELETEhttp://localhost:2379/v2/keys/mydir?dir=false&recursive=true
#etcdctl--debug-ojsonls/mydir
Curl-Example:curl-XGEThttp://localhost:2379/v2/keys/mydir?consistent=true&recursive=false&sorted=falseError:100:Keynotfound(/mydir)[21883]

状态查看
etcd分别提供了查看leader、自己以及store状态的接口查看leader的状态
curlhttp://127.0.0.1:2379/v2/stats/leader{"leader":"27e6981eec74137d","followers":{"3955a9b061e52de1":{"latency":{"current":0.158241,"average":0.22540039942528703,"standardDeviation":0.17653730983599686,"minimum":0.087808,"maximum":1.988291},"counts":{"fail":0,"success":348}}}}
查看自己的状态
curlhttp://127.0.0.1:2379/v2/stats/self#curlhttp://127.0.0.1:2379/v2/stats/self{"name":"infra0","id":"27e6981eec74137d","state":"StateLeader","startTime":"2015-08-14T12:52:39.624477849+08:00","leaderInfo":{"leader":"27e6981eec74137d","uptime":"2m37.095030303s","startTime":"2015-08-14T12:55:31.332765166+08:00"},"recvAppendRequestCnt":429,"sendAppendRequestCnt":1064,"sendPkgRate":6.896118337343223,"sendBandwidthRate":1170.6850489473857}
查看store的状态
curlhttp://127.0.0.1:2379/v2/stats/store{"getsSuccess":13,"getsFail":2152,"setsSuccess":120,"setsFail":2,"deleteSuccess":6,"deleteFail":0,"updateSuccess":0,"updateFail":0,"createSuccess":961,"createFail":186,"compareAndSwapSuccess":19631,"compareAndSwapFail":296,"compareAndDeleteSuccess":0,"compareAndDeleteFail":0,"expireCount":849,"watchers":0}

其他接口以及更详尽的接口说明可以看官网说明