Releases · etcd-io/etcd

Main features

new etcd client [GH 3083]

We release a new etcd client in etcd repo to replace the old go-etcd client. The new client provides a clean set of APIs and improves the functionality around request cancellation and error reporting. It is still under development and might not be as stable as go-etcd. We encourage you to get it a try.

etcdctl now uses the new etcd client. The new client should improve the stability and reliability of etcdctl.

experimental v3 API demo [GH 3248]

We’ve proposed (a new version of the etcd API)[https://github.com/coreos/etcd/blob/master/Documentation/rfc/v3api.md] recently. etcd 2.2 supports a subset of the API for testing and demo purposes. It is a non-clustered version and should not be put in production. You can enable it by setting --experimental-v3demo flag, the build and use the etcdctlv3 in etcd repo to interact with it.

cluster health monitoring [GH 3210 3197]

In 2.2, etcd members check for connectivity and timing differences to other other members to ensure the cluster wide health. etcd members report anything unhealthy every 30 seconds as log output.

etcdctl supports a new flag --forever for cluster-health subcommand. With that flag set, etcdctl will monitor cluster health continuously. You can now run etcdctl cluster-health --forever and it will print out the cluster health information every 10 seconds.

new documentation

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.2.0-alpha.0/etcd-v2.2.0-alpha.0-darwin-amd64.zip -o etcd-v2.2.0-alpha.0-darwin-amd64.zip
unzip etcd-v2.2.0-alpha.0-darwin-amd64.zip
cd etcd-v2.2.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.2.0-alpha.0/etcd-v2.2.0-alpha.0-linux-amd64.tar.gz -o etcd-v2.2.0-alpha.0-linux-amd64.tar.gz
tar xzvf etcd-v2.2.0-alpha.0-linux-amd64.tar.gz
cd etcd-v2.2.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.2.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.2.0-alpha.0

Main features

authentication features [GH 2242]

/v2/auth endpoint adds the authentication feature to the v2 API, providing users, roles and basic authentication. etcdctl support, etcd/client support and the REST API on authentication has been implemented, and they are super easy to use. You can check authentication documentation to start. This is an experimental feature, which will be improved based on user feedback.

more stable transportation [GH 2323 2620 2544]

In order to reduce the connection creation overhead and to make raft transportation more efficient and stable, etcd now maintains long running connections with other peers.
To reduce the raft command commit latency, each raft append message is now attached to a commit index. The commit latency is reduced from 100ms to 1ms under light load (<100 writes/second).
etcd/raft now provides better internal flow control, significantly reducing the possibility of raft message loss, and improving cpu and memory efficiency.

functional testing

fault-injecting, functional testing framework is built to test the functionality of an etcd cluster with a focus on failure-resistance under heavy usage. we have run it continuously for the last four months, and etcd has shown to be robust under many kinds of harsh failure scenarios. For more details, please check the blog post here.

better logging [GH 2707 2923 2926]

Leveled logging is supported now. Users can set an expected log level for etcd and its subpackages. At the meantime, we have moved verbose repeated logging to DEBUG log level, so etcd's default log will be significantly more readable. You can control leveled logging using flags here.

metrics [GH 2785]

etcd introduces a new metrics feature, which can be used for real-time monitoring and debugging. It exposes statistics about both client behaviors and resource usage. This is an experimental feature, which will be improved based on user feedback.

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.1.1/etcd-v2.1.1-darwin-amd64.zip -o etcd-v2.1.1-darwin-amd64.zip
unzip etcd-v2.1.1-darwin-amd64.zip
cd etcd-v2.1.1-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.1.1/etcd-v2.1.1-linux-amd64.tar.gz -o etcd-v2.1.1-linux-amd64.tar.gz
tar xzvf etcd-v2.1.1-linux-amd64.tar.gz
cd etcd-v2.1.1-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.1.1

ACI/Rocket

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

rkt run coreos.com/etcd:v2.1.1

Main features

new authentication features

[GH2242] /v2/auth added the auth feature to the v2 API, providing Users, Roles and Basic Authentication.
etcdctl support, etcd/client support and the REST API are ready
Documentation available at https://github.com/coreos/etcd/blob/master/Documentation/auth_api.md

better logging

[GH2707] leveled logging is supported now. Users can set an expected log level for etcd and its subpackages.
[GH2923 2926] move verbose repeated logging to DEBUG log level

more stable transportation

[GH2323] In order to reduce the connection creation overhead and to make raft transportation more efficient and stable, etcd now maintains long running connections with other peers.
[GH2620] To reduce the raft command commit latency, each raft append message is now attached to a commit index. The commit latency is reduced from 100ms to 1ms under light load (<100 writes/second).
[GH2544] etcd/raft now provides better internal flow control, significantly reducing the possibility of raft message loss, and improving cpu and memory efficiency.

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.1.0-rc.0/etcd-v2.1.0-rc.0-darwin-amd64.zip -o etcd-v2.1.0-rc.0-darwin-amd64.zip
unzip etcd-v2.1.0-rc.0-darwin-amd64.zip
cd etcd-v2.1.0-rc.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.1.0-rc.0/etcd-v2.1.0-rc.0-linux-amd64.tar.gz -o etcd-v2.1.0-rc.0-linux-amd64.tar.gz
tar xzvf etcd-v2.1.0-rc.0-linux-amd64.tar.gz
cd etcd-v2.1.0-rc.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.1.0-rc.0

ACI/Rocket

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

rkt run coreos.com/etcd:v2.1.0-rc.0

Changelog

[GH 3030] The -advertise-client-urls flag is no longer required if falling back to proxy mode when discovery, or using read-only proxy mode.

This bug only affected the initial cluster bootstrapping and incorrectly required the -advertise-client-urls flag to be set in certain circumstances. There is no problem for existing clusters that have already been started.

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.0.13/etcd-v2.0.13-darwin-amd64.zip -o etcd-v2.0.13-darwin-amd64.zip
unzip etcd-v2.0.13-darwin-amd64.zip
cd etcd-v2.0.13-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.0.13/etcd-v2.0.13-linux-amd64.tar.gz -o etcd-v2.0.13-linux-amd64.tar.gz
tar xzvf etcd-v2.0.13-linux-amd64.tar.gz
cd etcd-v2.0.13-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 4001:4001 -v /usr/share/ca-certificates/:/etc/ssl/certs quay.io/coreos/etcd:v2.0.13

ACI/Rocket

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

rkt run coreos.com/etcd:v2.0.13

Main features

new security features

[GH2242] /v2/auth added the auth feature to the v2 API, providing Users, Roles and Basic Authentication.
Both etcdctl support and REST API are in place
Documentation available at https://github.com/coreos/etcd/blob/master/Documentation/auth_api.md

better logging

[GH2707] leveled logging is supported now. Users could set expected log level for etcd and its subpackages.
[GH2923 2926] move verbose repeated logging to DEBUG log level

more stable transportation

[GH2323] To reduce the connection creation overhead and make raft transportation more efficient and stable, etcd now keeps long term connections with other peers.
[GH2620] To reduce the raft command commit latency, each raft append message now attached with a commit index. The commit latency is reduced from 100ms to 1ms under light load (<100 writes/second).
[GH2544] etcd/raft now provides better internal flow control. It significantly reduce the possibility of raft message loss, and improves the cpu/memory efficiency.

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.1.0-alpha.1/etcd-v2.1.0-alpha.1-darwin-amd64.zip -o etcd-v2.1.0-alpha.1-darwin-amd64.zip
unzip etcd-v2.1.0-alpha.1-darwin-amd64.zip
cd etcd-v2.1.0-alpha.1-darwin-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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.1.0-alpha.1/etcd-v2.1.0-alpha.1-linux-amd64.tar.gz -o etcd-v2.1.0-alpha.1-linux-amd64.tar.gz
tar xzvf etcd-v2.1.0-alpha.1-linux-amd64.tar.gz
cd etcd-v2.1.0-alpha.1-linux-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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.1.0-alpha.1

ACI/Rocket

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

rkt run coreos.com/etcd:v2.1.0-alpha.1

Changelog

[GH 2323] Improve raft stability by making peer communication timeouts configurable
[GH 2650] Improve error messages when the etcdctl cluster-health command cannot gather cluster health
[GH 2877] etcd can now recover after bootstrap related errors
[GH 2884] Improve performance under high load by reusing network connections when running in proxy mode
[GH 2902] etcd no longer sends invalid requests to the active etcd cluster members when running in proxy mode.
[GH 2916] The etcd build script now works outside of a git repository, but the version info in the resulting binary will not contain a valid Git SHA.
[GH 2947] The -advertise-client-urls flag is no longer required when running in proxy mode

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.0.12/etcd-v2.0.12-darwin-amd64.zip -o etcd-v2.0.12-darwin-amd64.zip
unzip etcd-v2.0.12-darwin-amd64.zip
cd etcd-v2.0.12-darwin-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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.0.12/etcd-v2.0.12-linux-amd64.tar.gz -o etcd-v2.0.12-linux-amd64.tar.gz
tar xzvf etcd-v2.0.12-linux-amd64.tar.gz
cd etcd-v2.0.12-linux-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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 4001:4001 -v /usr/share/ca-certificates/:/etc/ssl/certs quay.io/coreos/etcd:v2.0.12

ACI/Rocket

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

rkt run coreos.com/etcd:v2.0.12

Changelog

[GH2689] newly joined members no longer panic when recovering a snapshot
[GH2705] stats no longer update before being initialized
[GH2743] fix connection leak in proxy mode
[GH2756] improve the reliability of the etcdctl member remove command
[GH2758] improve the disaster recovery documentation
[GH2560] improve the output of the -version flag. Now includes the git-sha and Go runtime version
[GH2761] the -advertise-client-urls flag is now required when the setting -listen-client-urls flag
[GH2749] correct a typo in the string representation of raftLog
[GH2751 GH2811] support filelock for Solaris and Plan 9

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.0.11/etcd-v2.0.11-darwin-amd64.zip -o etcd-v2.0.11-darwin-amd64.zip
unzip etcd-v2.0.11-darwin-amd64.zip
cd etcd-v2.0.11-darwin-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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.0.11/etcd-v2.0.11-linux-amd64.tar.gz -o etcd-v2.0.11-linux-amd64.tar.gz
tar xzvf etcd-v2.0.11-linux-amd64.tar.gz
cd etcd-v2.0.11-linux-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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 4001:4001 -v /usr/share/ca-certificates/:/etc/ssl/certs quay.io/coreos/etcd:v2.0.11

ACI/Rocket

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

rkt run coreos.com/etcd:v2.0.11

Main features

new security features

[GH2242] /v2/security added the to the v2 API, providing Users, Roles and Basic Authentication
etcdctl support forthcoming, but the model and REST API are in place
Documentation available at https://github.com/coreos/etcd/blob/master/Documentation/security_api.md

more stable transportation

[GH2323] To reduce the connection creation overhead and make raft transportation more efficient and stable, etcd now keeps long term connections with other peers.
[GH2620] To reduce the raft command commit latency, each raft append message now attached with a commit index. The commit latency is reduced from 100ms to 1ms under light load (<100 writes/second).
[GH2544] etcd/raft now provides better internal flow control. It significantly reduce the possibility of raft message loss, and improves the cpu/memory efficiency.

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.1.0-alpha.0/etcd-v2.1.0-alpha.0-darwin-amd64.zip -o etcd-v2.1.0-alpha.0-darwin-amd64.zip
unzip etcd-v2.1.0-alpha.0-darwin-amd64.zip
cd etcd-v2.1.0-alpha.0-darwin-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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.1.0-alpha.0/etcd-v2.1.0-alpha.0-linux-amd64.tar.gz -o etcd-v2.1.0-alpha.0-linux-amd64.tar.gz
tar xzvf etcd-v2.1.0-alpha.0-linux-amd64.tar.gz
cd etcd-v2.1.0-alpha.0-linux-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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.1.0-alpha.0

ACI/Rocket

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

rkt run coreos.com/etcd:v2.1.0-alpha.0

Changelog

[GH2549] proxy shuffles endpoints to avoid being stuck to one member
[GH2488, 2226] stop using resolved address to avoid TLS failure.
[GH2645] fix the bug that machine power-off might lead to corrupted wal.
[GH2665] fix the bug that etcdserver.Send does not print correct error log for messages to removed members
[GH2664] etcdctl backup tool uses new file layout
[GH2684] fix the bug that PUT request with prevExist=true and prevIndex/prevValue set is not parsed to CompareAndSwap
[GH2661] fix the bug that etcd failed to recovery from recoverable WALs.
[GH2721] improve etcdctl help doc by adding ‘extended’ to output format

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.0.10/etcd-v2.0.10-darwin-amd64.zip -o etcd-v2.0.10-darwin-amd64.zip
unzip etcd-v2.0.10-darwin-amd64.zip
cd etcd-v2.0.10-darwin-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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.0.10/etcd-v2.0.10-linux-amd64.tar.gz -o etcd-v2.0.10-linux-amd64.tar.gz
tar xzvf etcd-v2.0.10-linux-amd64.tar.gz
cd etcd-v2.0.10-linux-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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 4001:4001 -v /usr/share/ca-certificates/:/etc/ssl/certs quay.io/coreos/etcd:v2.0.10

ACI/Rocket

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

rkt run coreos.com/etcd:v2.0.10

Changelog

[GH2622] etcd watchers no longer hang under when many watchers watch the same key.
[GH2638] etcdctl now support import hidden keys from the given snapshot.

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.0.9/etcd-v2.0.9-darwin-amd64.zip -o etcd-v2.0.9-darwin-amd64.zip
unzip etcd-v2.0.9-darwin-amd64.zip
cd etcd-v2.0.9-darwin-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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.0.9/etcd-v2.0.9-linux-amd64.tar.gz -o etcd-v2.0.9-linux-amd64.tar.gz
tar xzvf etcd-v2.0.9-linux-amd64.tar.gz
cd etcd-v2.0.9-linux-amd64
./etcd

Open another terminal:

# Press enter to background etcd
./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 4001:4001 -v /usr/share/ca-certificates/:/etc/ssl/certs quay.io/coreos/etcd:v2.0.9

ACI/Rocket

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

rkt run coreos.com/etcd:v2.0.9

Releases: etcd-io/etcd

v2.2.0-alpha.0

Main features

new etcd client [GH 3083]

experimental v3 API demo [GH 3248]

cluster health monitoring [GH 3210 3197]

new documentation

Getting Started

OS X

Linux

Docker

ACI/rkt

v2.1.1

Main features

authentication features [GH 2242]

more stable transportation [GH 2323 2620 2544]

functional testing

better logging [GH 2707 2923 2926]

metrics [GH 2785]

Getting Started

OS X

Linux

Docker

ACI/Rocket

v2.1.0-rc.0

Main features

new authentication features

better logging

more stable transportation

Getting Started

OS X

Linux

Docker

ACI/Rocket

v2.0.13

Changelog

Getting Started

OS X

Linux

Docker

ACI/Rocket

v2.1.0-alpha.1

Main features

new security features

better logging

more stable transportation

Getting Started

OS X

Linux

Docker

ACI/Rocket

v2.0.12

Changelog

Getting Started

OS X

Linux

Docker

ACI/Rocket

v2.0.11

Changelog

Getting Started

OS X

Linux

Docker

ACI/Rocket

v2.1.0-alpha.0

Main features

new security features

more stable transportation

Getting Started

OS X

Linux

Docker

ACI/Rocket

v2.0.10

Changelog

Getting Started

OS X

Linux

Docker