Welcome to EtcdClient’s documentation!

EtcdClient is an asynchronous etcd client library with key-value methods, support for authentication and methods for retrieving statistics and managing members of etcd clusters. EtcdClient is built on top of Scala Futures and Promises, AsyncHttpClient, Netty and JSON4S.

It is implemented according to version 2 of the Etcd API. The complete etcd API information can be found on the etcd documentation.

The following is a document explaining how to use EtcdClient, in order to get you started as quickly as possible. There is also a scaladoc with more information about the implementation.

Both documents are supposed to complement each other. We recommend reading this document first, and referring to the scaladoc for any doubts on implementation that are not covered here. In particular, the exact contents of the responses returned by etcd are not covered here. However, it is only a matter of searching in the scaladoc for the selected case class representing the response of a particular operation. The implementation is straightforward.

The first part of the document is a quickstart for those who wish to quickly test the client. Next, we briefly explain the model used in order to render responses to HTTP requests made to etcd servers. Then we proceed to list all methods implemented by EtcdClient and examples to illustrate possible use cases. We hope that a few examples will suffice to get most users started.


Indices and tables