etcd

This is the first release of etcd supporting the full v3 API, including cluster, kv, lease, and watcher APIs.

etcd 2.3.0-alpha.1 is fully compatible with etcd 2.2. For upgrading production clusters, however, please wait until the stable 2.3 release.

v3 server API

v3 API is now ready for experimenting. The v3 API is now almost stable; we do not expect it to significantly change.

To enable the v3 API, start etcd with additional --experimental-v3demo and --experimental-gRPC-addr flags.

v3 client API

v3 client now is available for experimenting. The client API is unstable; it may change in the next release. However, feel free to experiment with the new client, any feedback is welcome!

v3 etcdctl

v3 etcdctl now is available for experimenting. The command, its arguments, options, and output format are unstable; it may change in the next release. However, feel free to experiment with the new etcdctl, any feedback is welcome!

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

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.1

Changelog

• [GH 3830] Godeps: update boltdb to fix arm64 build
• [GH 4215] etcdmain: fix proxy srv lookup
• [GH 4254] client: do not timeout when wait is true
• [GH 4281] etcdserver, auth: not cache a flag of auth status
• update gRPC dependencies (git SHA e29d659177655e589850ba7d3d83f7ce12ef23dd)

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.5/etcd-v2.2.5-darwin-amd64.zip -o etcd-v2.2.5-darwin-amd64.zip
unzip etcd-v2.2.5-darwin-amd64.zip
cd etcd-v2.2.5-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.5/etcd-v2.2.5-linux-amd64.tar.gz -o etcd-v2.2.5-linux-amd64.tar.gz
tar xzvf etcd-v2.2.5-linux-amd64.tar.gz
cd etcd-v2.2.5-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 --name etcd quay.io/coreos/etcd:v2.2.5
docker exec etcd /etcdctl set foo bar

For advanced usage, please check our docker guide.

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.5

Changelog

[GH 4150] etcdctl: update dir command should not require value arguement
[[GH 4153/4174](https://github.com/coreos/etcd/pull/4153, https://github.com/coreos/etcd/pull/4174)] etcdmain: avoid wrap TLS listener so HTTP server can get TLS configuration from connection
Build etcd with go 1.5.3, which includes a security fix to the math/big package affecting the crypto/tls package

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.4/etcd-v2.2.4-darwin-amd64.zip -o etcd-v2.2.4-darwin-amd64.zip
unzip etcd-v2.2.4-darwin-amd64.zip
cd etcd-v2.2.4-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.4/etcd-v2.2.4-linux-amd64.tar.gz -o etcd-v2.2.4-linux-amd64.tar.gz
tar xzvf etcd-v2.2.4-linux-amd64.tar.gz
cd etcd-v2.2.4-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 --name etcd quay.io/coreos/etcd:v2.2.4
docker exec etcd /etcdctl set foo bar

For advanced usage, please check our docker guide.

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.4

Changelog

[GH 3905] etcdctl: cluster health exit with non-zero when cluster is unhealthy
[GH 3927] client: fix goroutine leak in unreleased context
[GH 3972] store: fix data race when modify event in watchHub.
[GH 4020] client: support set endpoints
[GH 4037] etcdmain: fix writing incomplete proxy config file
[GH 4089] etcdsever: avoid creating member dir before finishing validate bootstrap
[GH 4089] etcdserver: always check if the data dir is writable before starting

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.3/etcd-v2.2.3-darwin-amd64.zip -o etcd-v2.2.3-darwin-amd64.zip
unzip etcd-v2.2.3-darwin-amd64.zip
cd etcd-v2.2.3-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.3/etcd-v2.2.3-linux-amd64.tar.gz -o etcd-v2.2.3-linux-amd64.tar.gz
tar xzvf etcd-v2.2.3-linux-amd64.tar.gz
cd etcd-v2.2.3-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 --name etcd quay.io/coreos/etcd:v2.2.3
docker exec etcd /etcdctl set foo bar

For advanced usage, please check our docker guide.

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.3

Changelog

• [GH 3697] fix health check result in etcdctl cluster-health
• [GH 3792] generate v5 ugorji/go/codec unmarshal code in client package
• [GH 3829] fix unset SYSLOG_IDENTIFIER when etcd is logging to the journal
• [GH 3590 GH 3794] improve logging when discovery procedure fails
• [GH 3757 GH 3758] fix various data races detected by race detector
• [GH 3868] fix rejecting to modify pre-defined guest role

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.2/etcd-v2.2.2-darwin-amd64.zip -o etcd-v2.2.2-darwin-amd64.zip
unzip etcd-v2.2.2-darwin-amd64.zip
cd etcd-v2.2.2-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.2/etcd-v2.2.2-linux-amd64.tar.gz -o etcd-v2.2.2-linux-amd64.tar.gz
tar xzvf etcd-v2.2.2-linux-amd64.tar.gz
cd etcd-v2.2.2-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 --name etcd quay.io/coreos/etcd:v2.2.2
docker exec etcd /etcdctl set foo bar

For advanced usage, please check our docker guide.

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.2

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

Changelog

• [GH 3482] support Nodes type in client package for sorting
• [GH 3506] improve panic logging output when starting etcd with corrupted data dir
• [GH 3530 GH 3611] fix non-customizable request timeout in etcdctl
• [GH 3556] improve output when missing initial flags
• [GH 3564] improve output when retrying unavailable endpoint in proxy
• [GH 3594] etcd no longer hangs forever when fails to finish discovery
• [GH 3596] fix Content-Type header for version API
• [GH 3633] improve logging output when systemd notify fails
• [GH 3635] support literal IPv6 address with zone in URL flags
• [GH 3655 GH 3681] update dependency for bug fix and restorable dependency list
• [GH 3685] fix mk command in etcdctl

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.1/etcd-v2.2.1-darwin-amd64.zip -o etcd-v2.2.1-darwin-amd64.zip
unzip etcd-v2.2.1-darwin-amd64.zip
cd etcd-v2.2.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.2.1/etcd-v2.2.1-linux-amd64.tar.gz -o etcd-v2.2.1-linux-amd64.tar.gz
tar xzvf etcd-v2.2.1-linux-amd64.tar.gz
cd etcd-v2.2.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 --name etcd quay.io/coreos/etcd:v2.2.1
docker exec etcd /etcdctl set foo bar

For advanced usage, please check our docker guide.

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.1

Zero-Downtime Rolling Upgrade from 2.1

Upgrading from etcd 2.1 to etcd 2.2 is a zero-downtime rolling upgrade. The basic approach is that you can upgrade a cluster running etcd 2.1 one-by one to etcd 2.2. For more details, please read the upgrade documentation. If you are running your cluster under etcd 0.4.x, please follow the snapshot migration documentation to upgrade your cluster.
Also, with this release, etcd 2.2 is now the current stable etcd release; as such, all bug fixes will go into new etcd 2.2.x releases and won't be backported to etcd 2.1.x.

Major Changes

[GH 3083] New etcd client

Today we added a new Go etcd client binding 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. We encourage you to try it out for new projects and provide feedback on the API via the etcd-dev mailing list. In this release etcdctl also uses this new client, which will improve its reliability.

[GH 3248] Experimental v3 API and new storage demo

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

This new API also provides an efficient, reliable and scalable way to access the new disk storage backend. The new disk storage backend allows etcd to do incremental snapshots and decreases the memory pressure of large datasets while retaining hot data in memory for fast access. The new storage backend combined with the v3 API will provide even better performance and stability than today’s in-memory store that supports the v2 API.

etcd 2.2 supports a subset of the v3 API for testing and demo purposes. Note that this early preview is a non-clustered version and should not be used in production. You can enable it by setting --experimental-v3demo flag, then build and use the etcdctlv3 tool in the etcd repo to interact with it.

We plan to support an experimental clustered version of v3 API in the next etcd minor release, etcd v2.3.0, currently targeted for release at the end of October.

[GH 3210 GH 3197] Active cluster health checking

In previous releases of etcd, the leader of the cluster was solely responsible for monitoring the health of other members. With this new release, all members of an etcd cluster now regularly check for connectivity and timing differences to other members to ensure cluster-wide health. To ease debugging potential issues etcd now report members that are observed as unhealthy every 30 seconds in the logs. This new feature also helps users explore and understand the stability of their cluster - for example, by exposing clock synchronization issues that might cause incorrect TTL expiration or issue caused by partial network partitions between members.

etcdctl supports a new flag --forever for the 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.

Improved documentation

Based on feedback from the community, we've made a number of improvements to the readability and understandability of our documentation. Moreover, we added two key new documents:

• Design of runtime reconfiguration
• Design of discovery service and its protocol
• how to report a bug to etcd
• FAQ

[GH 3275] v2 API change

The newly created unique key is padded with 0s. We now can sort the created unique keys in lexicographic order.

Default GOMAXPROCS changes with Go 1.5

Since Go 1.5, by default Go programs run with GOMAXPROCS set to the number of cores available; in prior releases it defaulted to 1. When compiled with Go 1.5, etcd follows the default behavior described above. The released binaries are compiled with Go 1.5. The number of cores used is printed out on start.

[GH 3413] Support Dedicated WAL Directory

etcd 2.2 supports using a dedicated disk to store wal files, which could improve the throughput and stabilize the cluster. It is highly recommended to dedicate a wal disk and set --wal-dir to point to a directory on that device for a production cluster deployment.

[GH 3390] Introduce flag --endpoint in etcdctl

We recommend to use flag --endpoint to specify the etcd cluster endpoints in etcdctl instead of flag --peers. Though two flags perform the same, name --endpoint is clear and straightforward.

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/etcd-v2.2.0-darwin-amd64.zip -o etcd-v2.2.0-darwin-amd64.zip
unzip etcd-v2.2.0-darwin-amd64.zip
cd etcd-v2.2.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/etcd-v2.2.0-linux-amd64.tar.gz -o etcd-v2.2.0-linux-amd64.tar.gz
tar xzvf etcd-v2.2.0-linux-amd64.tar.gz
cd etcd-v2.2.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 --name etcd quay.io/coreos/etcd:v2.2.0
docker exec etcd /etcdctl set foo bar

For advanced usage, please check our docker guide.

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

Changelog

• [GH 3378] when invalid TLS files are provided etcd logs a helpful error message and shuts down cleanly.

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

ACI/Rocket

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

rkt run coreos.com/etcd:v2.1.3

Main features

new etcd client [GH 3083]

We’re releasing a new etcd client in the 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 give 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 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, then build and use the etcdctlv3 tool in the etcd repo to interact with it.

v2 API change [GH 2564]

The newly created unique key is padded with 0s. We now can sort the created unique keys in lexicographic order.

default GOMAXPROCS changes with Go 1.5

Since Go 1.5, by default Go programs run with GOMAXPROCS set to the number of cores available; in prior releases it defaulted to 1. When compiled with Go 1.5, etcd follows the default behavior described above. The released binaries are compiled with Go 1.5. The number of cores used is printed out on start.

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 the 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

• design of runtime reconfiguration
• design of discovery service and its protocol
• how to report a bug to etcd
• FAQ

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

Changelog

• [GH 3129] refuse to start when listening on HTTPS and the TLS cert and/or key is missing
• [GH 2234] log a warning when listening on HTTP and TLS is set
• [GH 3149] fix start etcd failure after failing to use proxy mode in member-mode data directory
• [GH 3143] improve output for command line flag parsing errors
• [GH 3257] improve retry mechanism when using the etcd discovery service
• [GH 3118] limit the max election timeout setting to 50 seconds
• [GH 3249] fix struct alignment issue when running under arm64
• [GH 2905] specify request timeout caused by leader election
• [GH 3235] improve error response codes for key etcd requests
• [GH 3238] support cluster health check when auth is enabled
• [GH 3332] log the etcd version during startup
• [GH 3350] fix peer-url and initial-cluster mismatch issue when using discovery SRV
• stop spamming snapshot logging at INFO level when there is a member failure

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

ACI/Rocket

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

rkt run coreos.com/etcd:v2.1.2

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 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, then 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

• design of runtime reconfiguration
• design of discovery service and its protocol
• how to report a bug to etcd

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

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.1

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

• design of runtime reconfiguration
• design of discovery service and its protocol
• how to report a bug to etcd

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