etcdctl is a command line client for etcd. It can be used in scripts or for administrators to explore an etcd cluster.
The latest release is available as a binary at Github along with etcd.
You can also build etcdctl from source:
./build
Setting a key on /foo/bar:
etcdctl set /foo/bar "Hello world"
Hello world
Getting a key:
etcdctl get /foo/bar
Hello world
Deleting a key:
etcdctl delete /foo/bar
Hello world
Tailing a key:
etcdctl watch /foo/bar -f
Hello world
.... client hangs forever until ctrl+C printing values as key change
etcdctl implements sets on top of the key-value store that etcd
provides. These are useful for storing lists of unique items. A common
use-case is servers of a particular type that register themselves under
an etcd key, so that they can be detected and used by clients.
Adding members to a set:
etcdctl sadd /queues amqp://user:password@rabbitmq1
amqp://user:password@rabbitmq1
etcdctl sadd /queues amqp://user:password@rabbitmq2 --ttl=60
amqp://user:password@rabbitmq2
List all members:
etcdctl smembers /queues
amqp://user:password@rabbitmq1
amqp://user:password@rabbitmq2
To delete a member:
etcdctl sdel /queues amqp://user:password@rabbitmq1
0 Success
1 Malformed etcdctl arguments
2 Failed to connect to host
3 Failed to auth (client cert rejected, ca validation failure, etc)
4 400 error from etcd
5 500 error from etcd
etcdctl uses semantic versioning. Releases will follow lockstep with the etcd release cycle.
etcdctl is under the Apache 2.0 license. See the LICENSE file for details.