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.