etcd

Today we're announcing etcd v3.1.0-alpha.0, as part of etcd v3.1 release process.

Please try the alpha and report any bugs to help stabilize the v3.1 release.

Some highlights of what’s new in etcd 3.1:

V3 features:

• gRPC smart proxy with watch coalescing and key caching
• Authentication
• Lease information lookup RPC
• Automatic client endpoint synchronization to cluster (in progress)

General server features:

• Faster linearizable reads (in progress)
• Server gateway for static client endpoints
• Automatic cluster leadership transfer on server shutdown
• Membership health checking to prevent accidental quorum loss
• Embeddable etcd server

Complete release notes for 3.1 will be bundled with the 3.1 general release around mid-October.

Getting started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.1.0-alpha.0/etcd-v3.1.0-alpha.0-linux-amd64.tar.gz -o etcd-v3.1.0-alpha.0-linux-amd64.tar.gz
tar xzvf etcd-v3.1.0-alpha.0-linux-amd64.tar.gz && cd etcd-v3.1.0-alpha.0-linux-amd64
./etcd --version

Git SHA: 5c20531
Go Version: go1.7.1
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

Mac OS (Darwin)

curl -L https://github.com/coreos/etcd/releases/download/v3.1.0-alpha.0/etcd-v3.1.0-alpha.0-darwin-amd64.zip -o etcd-v3.1.0-alpha.0-darwin-amd64.zip
unzip etcd-v3.1.0-alpha.0-darwin-amd64.zip && cd etcd-v3.1.0-alpha.0-darwin-amd64
./etcd --version

ACI / rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.1.0-alpha.0

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.1.0-alpha.0

For more details, please check Docker guide.

Today we're announcing etcd v3.0.9. This is primarily a bug fix release, backward-compatible with all previous v3.0.0+ releases. Please read NEWS for highlighted changes.

Bug fixes

• GH6367: clientv3: drain buffered WatchResponses before resuming
• GH6387: ctlv3: fix line parsing for Windows
• GH6404: etcd/auth: fix range handling bugs
• GH6412: embed: warn on domain name in listener
• GH6429: clientv3: balancer panics when call up after close

Getting started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.0.9/etcd-v3.0.9-linux-amd64.tar.gz -o etcd-v3.0.9-linux-amd64.tar.gz
tar xzvf etcd-v3.0.9-linux-amd64.tar.gz && cd etcd-v3.0.9-linux-amd64
./etcd --version

Git SHA: 494c012
Go Version: go1.6.3
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

Mac OS (Darwin)

curl -L https://github.com/coreos/etcd/releases/download/v3.0.9/etcd-v3.0.9-darwin-amd64.zip -o etcd-v3.0.9-darwin-amd64.zip
unzip etcd-v3.0.9-darwin-amd64.zip && cd etcd-v3.0.9-darwin-amd64
./etcd --version

ACI / rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.9

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.9

For more details, please check Docker guide.

Today we're announcing etcd v3.0.8. This is primarily a bug fix release, backward-compatible with all previous v3.0.0+ releases. Please read NEWS for highlighted changes.

Bug fixes

• GH6325: etcdctl: fix quotes in txn and watch
• GH6344: etcdctl/ctlv3: don't crash when we should prompt for pw
• GH6365: embed: reject domain names before binding
• GH6370: etcdctl: restore should create a snapshot
• GH6381: wal: fsync directory after wal file rename

Getting started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.0.8/etcd-v3.0.8-linux-amd64.tar.gz -o etcd-v3.0.8-linux-amd64.tar.gz
tar xzvf etcd-v3.0.8-linux-amd64.tar.gz && cd etcd-v3.0.8-linux-amd64
./etcd --version

Git SHA: d40982f
Go Version: go1.6.3
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

Mac OS (Darwin)

curl -L https://github.com/coreos/etcd/releases/download/v3.0.8/etcd-v3.0.8-darwin-amd64.zip -o etcd-v3.0.8-darwin-amd64.zip
unzip etcd-v3.0.8-darwin-amd64.zip && cd etcd-v3.0.8-darwin-amd64
./etcd --version

ACI / rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.8

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.8

For more details, please check Docker guide.

Today we're announcing etcd v3.0.7. This is primarily a bug fix release, backward-compatible with all previous v3.0.0+ releases. Please read NEWS for highlighted changes.

Bug fixes

• GH6253: discovery: reject IP address records in SRVGetCluster
• GH6267: wal: fix CRC corruption on writes following write tears
• GH6269: wal: On non-Windows OS, hold file lock while renaming WAL directory
• GH6284: clientv3/concurrency: fix unintended deadlock on key prefixes
• GH6309: etcdserver: allow zero kv index for cluster upgrade
• GH6310: wal: use page buffered writer for writing records

Getting started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.0.7/etcd-v3.0.7-linux-amd64.tar.gz -o etcd-v3.0.7-linux-amd64.tar.gz
tar xzvf etcd-v3.0.7-linux-amd64.tar.gz && cd etcd-v3.0.7-linux-amd64
./etcd --version

Git SHA: 5695120
Go Version: go1.6.3
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

Mac OS (Darwin)

curl -L https://github.com/coreos/etcd/releases/download/v3.0.7/etcd-v3.0.7-darwin-amd64.zip -o etcd-v3.0.7-darwin-amd64.zip
unzip etcd-v3.0.7-darwin-amd64.zip && cd etcd-v3.0.7-darwin-amd64
./etcd --version

ACI / rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.7

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.7

For more details, please check Docker guide.

We had a few more last-minute fixes, so here is another release.

Today we're announcing etcd v3.0.6. This is primarily a bug fix release, backward-compatible with all previous v3.0.0+ releases. Please read NEWS for highlighted changes.

Bug fixes

• GH6098: recover lessor before recovering mvcc store and transactionally revoke leases
• GH6175: rafthttp: fix race between streamReader.stop() and connection closer
• GH6226: vendor: update grpc/grpc-go for clientconn patch (grpc/grpc-go#842)

Getting started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.0.6/etcd-v3.0.6-linux-amd64.tar.gz -o etcd-v3.0.6-linux-amd64.tar.gz
tar xzvf etcd-v3.0.6-linux-amd64.tar.gz && cd etcd-v3.0.6-linux-amd64
./etcd --version

Git SHA: 9efa00d
Go Version: go1.6.3
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

Mac OS (Darwin)

curl -L https://github.com/coreos/etcd/releases/download/v3.0.6/etcd-v3.0.6-darwin-amd64.zip -o etcd-v3.0.6-darwin-amd64.zip
unzip etcd-v3.0.6-darwin-amd64.zip && cd etcd-v3.0.6-darwin-amd64
./etcd --version

ACI / rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.6

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.6

For more details, please check Docker guide.

Today we're announcing etcd v3.0.5. This is primarily a bug fix release, backward-compatible with all previous v3.0.0+ releases. Please read NEWS for highlighted changes.

Bug fixes

• GH5845: clientv3: respect up/down notifications from grpc
• GH6077: v2http: use guest access in non-TLS mode
• GH6136: clientv3: close watcher stream once all watchers detach
• GH6142: clientv3: handle watchGrpcStream shutdown if prior to goroutine start
• GH6152: mvcc: fix count
• GH6166: clientv3: support non-blocking New()
• GH6222: integration: NewClusterV3() should launch cluster before creating clients

Security changes

• GH6084: etcdctl: set TLS servername on discovery

Other changes

• GH6218: vendor: boltdb/bolt v1.3.0 for Go 1.7

Getting started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.0.5/etcd-v3.0.5-linux-amd64.tar.gz -o etcd-v3.0.5-linux-amd64.tar.gz
tar xzvf etcd-v3.0.5-linux-amd64.tar.gz && cd etcd-v3.0.5-linux-amd64
./etcd --version

Git SHA: 43f7c94
Go Version: go1.6.3
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

Mac OS (Darwin)

curl -L https://github.com/coreos/etcd/releases/download/v3.0.5/etcd-v3.0.5-darwin-amd64.zip -o etcd-v3.0.5-darwin-amd64.zip
unzip etcd-v3.0.5-darwin-amd64.zip && cd etcd-v3.0.5-darwin-amd64
./etcd --version

ACI / rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.5

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.5

For more details, please check Docker guide.

Today we're announcing etcd v3.0.4. This is primarily a bug fix release, backward-compatible with all previous v3.0.0+ releases.

Bug fixes

• GH5956: *: fix issue found in fast lease renew
• GH5969: *: fix 'gogo/protobuf' compatibility issue (Fix for GH5942)
• GH5995: rpctypes, clientv3: retry RPC on EtcdStopped
• GH6006: etcdmain: correctly check return values from SdNotify()
• GH6009: v3rpc: don't elide next progress notification on progress notification
• GH6032: fix a few issues in grpc gateway
• GH6045: etcdserver, api, membership: don't race on setting version
• GH6056: scripts/genproto: use latest grpc-gateway c8ec92d0

Security changes

• GH5991: etcdserver/api/v2http: client certificate auth via common name
• Compiled with Go 1.6.3

Other changes

• GH5951: *: update grpc-gateway and its import paths
• GH5973: fileutil: rework purge tests so they don't poll
• GH5976: integration: drain keepalives in TestLeaseKeepAliveCloseAfterDisconnectRevoke
• GH5990: clientv3/integration: fix race in TestWatchCompactRevision
• GH5999: Add support for formating output of ls command in json or extended format
• GH6011: e2e: use a single member cluster in TestCtlV3Migrate
• GH6047: Documentation: fix links in upgrades
• GH6058: Dockerfile-release: add '/var/lib/etcd/'

Getting started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.0.4/etcd-v3.0.4-linux-amd64.tar.gz -o etcd-v3.0.4-linux-amd64.tar.gz
tar xzvf etcd-v3.0.4-linux-amd64.tar.gz && cd etcd-v3.0.4-linux-amd64
./etcd --version

Git SHA: d53923c
Go Version: go1.6.3
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

Mac OS (Darwin)

curl -L https://github.com/coreos/etcd/releases/download/v3.0.4/etcd-v3.0.4-darwin-amd64.zip -o etcd-v3.0.4-darwin-amd64.zip
unzip etcd-v3.0.4-darwin-amd64.zip && cd etcd-v3.0.4-darwin-amd64
./etcd --version

ACI / rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.4

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.4

For more details, please check Docker guide.

Today we're announcing etcd v3.0.3. This is primarily a bug fix release.

Bug fixes

• GH5918: etcdmain: only get initial cluster setting if the member is not initialized
• GH5921: raft: do not change RecentActive when resetState for progress
• GH5937: Revert "Dockerfile: use 'ENTRYPOINT' instead of 'CMD'"
• GH5948: vendor: update grpc (Fix GH5871)

Other changes

• GH5885: etcdserver: fix TestSnap
• GH5906: e2e: add basic upgrade tests
• GH5916: etcdctl: only takes 127.0.0.1:2379 as default endpoint

Getting started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.0.3/etcd-v3.0.3-linux-amd64.tar.gz -o etcd-v3.0.3-linux-amd64.tar.gz
tar xzvf etcd-v3.0.3-linux-amd64.tar.gz && cd etcd-v3.0.3-linux-amd64
./etcd --version

Git SHA: 24a90ba
Go Version: go1.6.2
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

Mac OS (Darwin)

curl -L https://github.com/coreos/etcd/releases/download/v3.0.3/etcd-v3.0.3-darwin-amd64.zip -o etcd-v3.0.3-darwin-amd64.zip
unzip etcd-v3.0.3-darwin-amd64.zip && cd etcd-v3.0.3-darwin-amd64
./etcd --version

ACI / rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.3

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.3

For more details, please check Docker guide.

Today we're announcing etcd v3.0.2. This is a bug-fix release.

Changelog

• GH5848: etcdserver/api: print only major.minor version API
• GH5855: wal: release wal locks before renaming directory on init
• GH5861: v3rpc: do not panic on user error for watch
• GH5862: etcdserver: commit before sending snapshot
• GH5876: Dockerfile: use 'ENTRYPOINT' instead of 'CMD'
• GH5883: clientv3: fix sync base
• GH5888: client: make set/delete one shot operations
• GH5897: v3rpc: lock progress and prevKV map correctly

Getting Started

Linux

curl -L https://github.com/coreos/etcd/releases/download/v3.0.2/etcd-v3.0.2-linux-amd64.tar.gz -o etcd-v3.0.2-linux-amd64.tar.gz
tar xzvf etcd-v3.0.2-linux-amd64.tar.gz && cd etcd-v3.0.2-linux-amd64
./etcd --version

Git SHA: faeeb2f
Go Version: go1.6.2
Go OS/Arch: linux/amd64

# start a local etcd server
./etcd

# write,read to etcd
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

OS X

curl -L https://github.com/coreos/etcd/releases/download/v3.0.2/etcd-v3.0.2-darwin-amd64.zip -o etcd-v3.0.2-darwin-amd64.zip
unzip etcd-v3.0.2-darwin-amd64.zip && cd etcd-v3.0.2-darwin-amd64
./etcd --version

ACI/rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.2

For more details, please check rkt commands.

Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.2

For more details, please check Docker guide.

Today we're announcing etcd v3.0.1. This is a minor bug-fix release.

Changelog

• GH5841: etcdserver: exit on missing backend only if semver is >= 3.0.0
• GH5843: Documentation: fix typo in api_grpc_gateway.md
• GH5844: *: test, docs with go1.6+

Getting Started

Linux

To run etcd on Linux, run the following in a terminal

curl -L https://github.com/coreos/etcd/releases/download/v3.0.1/etcd-v3.0.1-linux-amd64.tar.gz -o etcd-v3.0.1-linux-amd64.tar.gz
tar xzvf etcd-v3.0.1-linux-amd64.tar.gz
cd etcd-v3.0.1-linux-amd64
./etcd

To try out etcdctl

ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

OS X

To run etcd on OS X

curl -L https://github.com/coreos/etcd/releases/download/v3.0.1/etcd-v3.0.1-darwin-amd64.zip -o etcd-v3.0.1-darwin-amd64.zip
unzip etcd-v3.0.1-darwin-amd64.zip
cd etcd-v3.0.1-darwin-amd64
./etcd

To try out etcdctl

ETCDCTL_API=3 ./etcdctl put foo "bar"
ETCDCTL_API=3 ./etcdctl get foo

ACI/rkt

To run etcd with rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.1

For more details, please check rkt commands.

Docker

To run etcd with Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.1

For more details, please check docker guide.

Today we're announcing etcd v3.0.0, the first stable of etcd 3.0. Check out our blog post.

etcd 3.0 features have all been internally tested. We will try our best to not break any of the stable v3 APIs (except the experimental features) after this release, and the system is generally considered ready for use. However, we cannot test all possible configurations, and etcd 3.0 needs user testing before being declared ready for production use. Please help test the new features in your environment and give feedback to the team.

Notable Enhancements

We released etcd v2.0.0 a year ago. etcd v3 incorporates much expert feedback and thousands of hours of production use by the etcd community. The v3 API solves many issues related to etcd v2 scalability, with a new storage engine, and a new API fully supporting Multi-Version Concurrency Control (MVCC). All v3 API calls are served via gRPC and HTTP/2. For more detail, please see this performance documentation.

What’s new?

Some highlights of etcd 3.0 server improvements:

• Improved latency and throughput
  • Less protocol overhead via gRPC API layer
  • Better disk utilization in write ahead log
• New storage backend: lower memory overhead per key
• Automatic TLS configuration

Some highlights of the new stable etcd3 API:

• Flat binary keyspace: no key-value hierarchy / directories
  • Support key get and watch by prefix
  • Support key get and watch by interval
• Multiversion keyspace: access historical revisions of keys
• Transactions: combine multiple requests into one operation
• Leases: a single TTL for sets of keys
• Maintenance/Alarm: protect etcd from accidental overutilization with storage quotas

Some highlights of new etcdctl:

• Mirror: mirror etcd to another data center
• Lock: mutex on top of etcd
• Elect: leader election
• Snapshot: stores point-in-time state of etcd backend
• Endpoint: health checking

Experimental Features/APIs:

• v3 Auth API
• etcd gateway subcommand

Getting Started

Linux

To run etcd on Linux, run the following in a terminal

curl -L https://github.com/coreos/etcd/releases/download/v3.0.0/etcd-v3.0.0-linux-amd64.tar.gz -o etcd-v3.0.0-linux-amd64.tar.gz
tar xzvf etcd-v3.0.0-linux-amd64.tar.gz
cd etcd-v3.0.0-linux-amd64
./etcd

To try out etcdctl

ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 ./etcdctl --endpoints=localhost:2379 get foo

OS X

To run etcd on OS X

curl -L https://github.com/coreos/etcd/releases/download/v3.0.0/etcd-v3.0.0-darwin-amd64.zip -o etcd-v3.0.0-darwin-amd64.zip
unzip etcd-v3.0.0-darwin-amd64.zip
cd etcd-v3.0.0-darwin-amd64
./etcd

To try out etcdctl

ETCDCTL_API=3 ./etcdctl put foo "bar"
ETCDCTL_API=3 ./etcdctl get foo

ACI/rkt

To run etcd with rkt

rkt trust --prefix coreos.com/etcd
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.0

For more details, please check rkt commands.

Docker

To run etcd with Docker

docker run --name etcd quay.io/coreos/etcd:v3.0.0

For more details, please check docker guide.

Today we're announcing etcd v2.3.7. This is a minor bug-fix release.

Changelog

• GH5683: store: copy old value when refresh + CAS

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

rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v2.3.7

For more info about rkt command line, please check rkt commands.

Today we're announcing etcd v2.3.6. This is a minor bug-fix release.

Changelog

• GH5448: etcd: fix refresh feature

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

rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v2.3.6

For more info about rkt command line, please check rkt commands.

Today we're announcing etcd v2.3.5. This is a minor bug-fix release.

Changelog

• GH5265: v2http: allow empty role for GET '/users'
• GH5366: raft: do not panic when removing all the nodes from cluster
• GH5371: Documentation/v2: fix auth_api.md bug
• GH5375: Documentation/v2: fix typo for updating a member
• GH5144: *: fix invalid access to backend struct
• GH5168: etcdserver: stop raft after stopping apply scheduler
• GH5379: etcdserver: wait for snapshots before closing raft

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

rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v2.3.5

For more info about rkt command line, please check rkt commands.

Today we're announcing etcd v2.3.4. This is a minor bug-fix release.

Changelog

• GH5269: httpproxy: fix race on getting close notifier channel
• GH5310: etcdctl/ctlv2: total-timeout for Sync
• GH5312: etcdctl: Add --wal-dir and --backup-wal-dir options to backup command
• GH5320: v2/README: add known bugs

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

rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v2.3.4

For more info about rkt command line, please check rkt commands.

Today we're announcing etcd v3.0.0-beta.0, the first pre-release of etcd 3.0.

What’s Beta?

This beta release includes all major features planned for etcd 3.0. These features have all been internally tested. We do not expect significant changes to the v3 API after this release, and the system is generally considered ready for use. However, we cannot test all possible configurations, and etcd 3.0 needs user testing before being declared ready for production use. Please help test the new features in your environment and give feedback to the team.

Notable Enhancements

We released etcd v2.0.0 a year ago. etcd v3 incorporates much expert feedback and thousands of hours of production use by the etcd community. The v3 API solves many issues related to etcd v2 scalability, with a new storage engine, and a new API fully supporting Multi-Version Concurrency Control (MVCC). All v3 API calls are served via gRPC and HTTP/2. For more detail, please see this performance documentation.

What’s new?

Some highlights of etcd 3.0 server improvements:

• Improved latency and throughput
• Lower per key memory overhead
• Automatic TLS configuration

Some highlights of the new etcd3 API:

• Flat binary keyspace
• No key-value hierarchy / directories
  • Support query/watch by prefix
• Transactions: combine multiple requests into one operation
• Leases: a single TTL for sets of keys
• Maintenance/Alarm: protect etcd against unexpected shutdown, with disk quota limits

Some highlights of new etcdctl:

• Mirror: mirror etcd to another data center
• Lock: mutex on top of etcd
• Elect: leader election
• Snapshot: stores point-in-time state of etcd backend
• Endpoint: health checking

There are many more additions, improvements, and fixes. We will cover them all in the stable release notes.

What’s next?

Our highest priority is to polish the etcd 3.0 beta as it makes the last few steps toward a stable release. The 3.0.0 release will also include additional improvements:

• Authentication
• Better documentation
• Tools and guides for migrating from etcd v2.

Thanks to everyone who contributed to the release!

Getting Started

OS X

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

curl -L  https://github.com/coreos/etcd/releases/download/v3.0.0-beta.0/etcd-v3.0.0-beta.0-darwin-amd64.zip -o etcd-v3.0.0-beta.0-darwin-amd64.zip
unzip etcd-v3.0.0-beta.0-darwin-amd64.zip
cd etcd-v3.0.0-beta.0-darwin-amd64
./etcd

Open another terminal:

ETCDCTL_API=3 ./etcdctl put mykey "this is awesome"
ETCDCTL_API=3 ./etcdctl get mykey

Linux

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

curl -L  https://github.com/coreos/etcd/releases/download/v3.0.0-beta.0/etcd-v3.0.0-beta.0-linux-amd64.tar.gz -o etcd-v3.0.0-beta.0-linux-amd64.tar.gz
tar xzvf etcd-v3.0.0-beta.0-linux-amd64.tar.gz
cd etcd-v3.0.0-beta.0-linux-amd64
./etcd

Open another terminal:

ETCDCTL_API=3 ./etcdctl put mykey "this is awesome"
ETCDCTL_API=3 ./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:v3.0.0-beta.0

For advanced usage, please check our docker guide.

ACI/rkt

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

rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v3.0.0-beta.0

For more info about rkt command line, please check rkt commands.

Today we're announcing etcd v2.3.3.

This is a minor bug-fix release. GH3762 introduced a regression where updating a user with an empty password can overwrite the previous password. All releases after 2.3.0-alpha.0 are affected. If you run etcd of version 2.3.0-alpha.0 or higher with auth feature enabled, we strongly recommend the upgrade.

Changelog

• GH5196: etcdserver/auth: check empty password

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

Changelog

• GH5028: etcdmain: start on unsupported arch when ETCD_UNSUPPORTED_ARCH is set
• GH5049: etcdctl: don't crash on duplicate role in user grant
• GH5051: etcdctl: don't panic on ListUser with roles
• GH5120: etcdserver: close response body when getting cluster information
• Compiled with Go 1.6.2

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

Changelog

GH4888: rafthttp: proposal does not block other raft messages when there is no leader
GH4898: client: client returns user defined context error when the passed in context is canceled.

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

We are pleased to announce etcd 2.3.0. etcd 2.3 contains many new features, improvements and a stable v2 auth API.

etcd 2.3 is fully compatible with etcd 2.2. Upgrading from etcd 2.2 to etcd 2.3 is a zero-downtime rolling upgrade. The basic approach is to upgrade a cluster running etcd 2.2 by upgrading each member, one-by-one, to etcd 2.3. For more details, please read the upgrade guide.

Also, with this release, etcd 2.3 is the current stable etcd release. All bug fixes and feature improvements will go into new etcd 2.3.x releases, and won't normally be backported to etcd 2.2.x.

New features

Strict runtime reconfiguration check

In version 2.3, etcd will reject reconfiguration that might cause quorum loss when strict checking is enabled. For example, when adding new members to an existing cluster, it is recommended to add one member at a time, because the quorum increases whether the new member is reachable or not. Adding multiple unreachable peers can actually cause the cluster to lose quorum. The new --strict-reconfig-check option causes etcd to reject such membership change requests, and prevents quorum loss due to newly-added, but as-yet unreachable, members.

Runtime profiling

Enable runtime profiling by specifying the --enable-pprof option to etcd. Profiling data is available over HTTP at a new /debug/pprof URL. Endpoints are served by the net/http/pprof package. Please visit the net/http/pprof documentation for more detail.

Refreshing TTL keys

Time-to-Live (TTL) keys in etcd now can be refreshed without notifying watchers. This avoids generating noisy traffic when a watcher is only interested in the expiration of TTL keys, and doesn’t care about refresh updates. For more details, please check the API doc

Experimental v3 support

v3 server

etcd 2.3 is first release of etcd that supports the experimental v3 API, including the cluster, kv, lease, and watcher APIs.

The etcd v3 API is now ready for experimentation and testing. The v3 API is almost stable; we do not expect it to significantly change.

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

v3 client API

A v3 etcd client now is available for experimental use and development. The client API is currently unstable; it may change in the next release. However, feel free to experiment with the new client. Your feedback is welcome!

v3 etcdctl

A v3 etcdctl now is available for experimental use and testing. The command, its arguments, options, and output format are unstable; all may change in the next release. However, feel free to experiment with the new etcdctl. Your 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/etcd-v2.3.0-darwin-amd64.zip -o etcd-v2.3.0-darwin-amd64.zip
unzip etcd-v2.3.0-darwin-amd64.zip
cd etcd-v2.3.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/etcd-v2.3.0-linux-amd64.tar.gz -o etcd-v2.3.0-linux-amd64.tar.gz
tar xzvf etcd-v2.3.0-linux-amd64.tar.gz
cd etcd-v2.3.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

ACI/rkt

The etcd ACI is now signed by the CoreOS App Signing Key so you'll need to explicitly choose to trust the key. To get started with rkt on Linux run the following commands 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 trust --prefix coreos.com/etcd
# gpg key fingerprint is: 18AD 5014 C99E F7E3 BA5F  6CE9 50BD D3E0 FC8A 365E
rkt run --volume data-dir,kind=host,source=/tmp --mds-register=false coreos.com/etcd:v2.3.0