v2.3.0-alpha.0

Main features

clustered v3 API

v3 API is now supported across an etcd cluster. All etcd members in the cluster always maintain consistent v3 data set.

[GH 3800] Experimental v3 watch API

The etcd team is focused on a new version of the etcd API. The new API provides improved features to the key/value store including: range reads, multi-key transactions, binary keys/values, and a longer, more reliable key change history.

etcd 2.3.0-alpha.0 adds support for watch API for testing and demo purposes. v3 watch API is much more powerful than the watch feature in the v2 API. It supports watching multiple keys and prefixes in one request, using a single connection between the client and etcd server. Moreover, it allows one to watch all events that occurred on any key in the history.

You can enable it by setting --experimental-v3demo flag, then build and use the etcdctlv3 tool in the etcd repo to interact with it.

[GH 3479 GH 3543] New flag --strict-reconfig-check

If the flag is enabled, etcd checks reconfiguration changes on etcd cluster more strictly. The check forbids adding or removing one member if the operation changes quorum and the number of changed quorum is larger than the number of initialized nodes.

Thanks to Hitoshi Mitake for introducing this feature.

[GH 3790] etcdtop tool to analyze popular etcd commands

etcdtop is a real-time workload analyzer of command traffic to one etcd server. It is useful for rapid diagnosis of production usage issues and analysis of the distribution of requests.

Thanks to Tyler Neely for contributing this tool!

[GH 3555] Improved documentation

Based on feedback from the community, we've made a number of improvements to the readability and understandability of our documentation:

Proxy promotion
Benchmark for new disk storage

Getting Started

OS X

To get started on OSX run the following in a terminal:

curl -L  https://github.com/coreos/etcd/releases/download/v2.3.0-alpha.0/etcd-v2.3.0-alpha.0-darwin-amd64.zip -o etcd-v2.3.0-alpha.0-darwin-amd64.zip
unzip etcd-v2.3.0-alpha.0-darwin-amd64.zip
cd etcd-v2.3.0-alpha.0-darwin-amd64
./etcd

Open another terminal:

./etcdctl set mykey "this is awesome"
./etcdctl get mykey

Linux

To get started on Linux run the following in a terminal:

curl -L  https://github.com/coreos/etcd/releases/download/v2.3.0-alpha.0/etcd-v2.3.0-alpha.0-linux-amd64.tar.gz -o etcd-v2.3.0-alpha.0-linux-amd64.tar.gz
tar xzvf etcd-v2.3.0-alpha.0-linux-amd64.tar.gz
cd etcd-v2.3.0-alpha.0-linux-amd64
./etcd

Open another terminal:

./etcdctl set mykey "this is awesome"
./etcdctl get mykey

Docker

To get started with Docker on Linux run the following in a terminal:

docker run -p 2379:2379 -v /usr/share/ca-certificates/:/etc/ssl/certs quay.io/coreos/etcd:v2.3.0-alpha.0

ACI/rkt

To get started with rkt on Linux run the following in a terminal:

# for more info about rkt command line, see related doc at https://github.com/coreos/rkt/blob/master/Documentation/commands.md#rkt-run
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v2.3.0-alpha.0