v2.1.0-rc.0

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

v2.0.13

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

v2.1.0-alpha.1

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

v2.0.12

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

v2.0.11

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

v2.1.0-alpha.0

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

v2.0.10

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

v2.0.9

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

v2.0.8

Changelog

• etcd now supports IPv6
• etcd now verifies the heartbeat and election flags earlier in the startup process to avoid runtime panics.
• etcd now ignores extra files found in the data directory during start up
• etcd proxy no longer fails to restart after initial configuration
• The -initial-cluster flag is no longer required when bootstrapping a single member cluster with the -name flag set
• Fix store statistic reporting issue
• Removal of consensus-based cluster restarts for upgrades due to bugs in etcd 0.4's go-raft implementation
• add ‘etcdctl import’ command to import the migration snap generated in v0.4.8 etcd to 2.0 etcd cluster
• etcdctl takes an additional 2379, which is the IANA port of etcd client URL, as the default port
• etcd no longer builds debugging tools into bin/ directory

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

ACI/Rocket

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

rkt run coreos.com/etcd:v2.0.8

v0.4.9

Changelog

• new /v2/migration/snapshot endpoint to support creating point-in-time snapshot.
  the snapshot will be returned in HTTP body be default
  the snapshot will be saved under data-dir if disk=true
• documentation about default value of --bind-addr and --peer-bind-addr is fixed

Getting Started

OS X

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

curl -L  https://github.com/coreos/etcd/releases/download/v0.4.9/etcd-v0.4.9-darwin-amd64.zip -o etcd-v0.4.9-darwin-amd64.zip.
unzip etcd-v0.4.9-darwin-amd64.zip.
cd etcd-v0.4.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/v0.4.9/etcd-v0.4.9-linux-amd64.tar.gz -o etcd-v0.4.9-linux-amd64.tar.gz
tar xzvf etcd-v0.4.9-linux-amd64.tar.gz
cd etcd-v0.4.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 /etc/ssl/certs/:/etc/ssl/certs/  quay.io/coreos/etcd:v0.4.9

Open another terminal:

docker run --net=host quay.io/coreos/etcd:v0.4.9 /etcdctl set mykey "this is awesome"
docker run --net=host quay.io/coreos/etcd:v0.4.9 /etcdctl get mykey