etcd v0.4.2

• Improvements to the clustering documents
• Set content-type properly on errors (#469)
• Standbys re-join if they should be part of the cluster (#810, #815, #818)

Thanks for everyone who reported bugs in this release @drusellers, @wereHamster, @jefferai.

etcd v0.4.1

Fast followup release to add some documentation and an accidentally removed API endpoint:

• Re-introduce DELETE on the machines endpoint
• Document the machines endpoint

etcd v0.4.0

For a full details read the blog post about this release: http://coreos.com/blog/etcd-0.4.0/

Changelog

• Introduced standby mode
• Added HEAD requests
• Set logs NOCOW flag when BTRFS is detected to avoid fsync overhead
• Fix all known data races, and pass Go race detector (TODO: re-run race detector)
• Fixed timeouts when using HTTPS
• Improved snapshot stability
• Migration of machine names to new IPs
• Updated peer discovery ordering

etcd 0.3.0 - Cluster Discovery, new API and Windows Support

Changelog

For full details see the 0.3.0 blog post.

Getting Started

CoreOS / Docker

To run it it in a docker container on CoreOS:

docker run -i -t -p 4002:4001 coreos/etcd

curl -L http://127.0.0.1:4002/v2/keys/mykey -XPUT -d value="this is awesome"
curl -L http://127.0.0.1:4002/v2/keys/mykey

OS X

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

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

Open another terminal:

# Press enter to background etcd
./etcdctl set mykey "this is awesome"
./etcdctl get mykey

v0.2.0

Changelog

For full details see the 0.2.0 blog post. This is the first stable release with the v2 API. See the README for details.

Getting Started

CoreOS / Docker

To run it it in a docker container on CoreOS:

docker run -i -t -p 4002:4001 coreos/etcd

curl -L http://127.0.0.1:4002/v2/keys/mykey -XPUT -d value="this is awesome"
curl -L http://127.0.0.1:4002/v2/keys/mykey

OS X

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

curl -L  https://github.com/coreos/etcd/releases/download/v0.2.0/etcd-v0.2.0-Darwin-x86_64.tar.gz -o etcd-v0.2.0-Darwin-x86_64.tar.gz
tar xzvf etcd-v0.2.0-Darwin-x86_64.tar.gz
cd etcd-v0.2.0-Darwin-x86_64
./etcd

Open another terminal:

# Press enter to background etcd
./etcdctl set mykey "this is awesome"
./etcdctl get mykey

v0.2.0-rc4

Changelog

• etcd: Fix a lockup with watchers and a large number of transactions (#413)
• etcdctl: remove bumpy caps from updatedir and setdir commands

Getting Started

CoreOS / Docker

To run it it in a docker container on CoreOS:

docker run -i -t -p 4002:4001 coreos/etcd
curl -L http://127.0.0.1:4002/v2/keys/mykey -XPUT -d value="this is awesome"
curl -L http://127.0.0.1:4002/v2/keys/mykey

OS X

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

curl -L  https://github.com/coreos/etcd/releases/download/v0.2.0-rc4/etcd-v0.2.0-rc4-Darwin-x86_64.tar.gz -o etcd-v0.2.0-rc4-Darwin-x86_64.tar.gz
tar xzvf etcd-v0.2.0-rc4-Darwin-x86_64.tar.gz
cd etcd-v0.2.0-rc4-Darwin-x86_64
./etcd

Open another terminal:

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

v0.2.0-rc3

This release sees a variety of bug fixes and new features that should get us close to a final 0.2.0 release. There have also been a few minor adjustments to the v2 API in this release to solve problems people were seeing.

etcd

• New leader election module (see https://github.com/coreos/etcd#leader-election)
• Documentation added for the lock module (see https://github.com/coreos/etcd#lock)
• Flags added to adjust heartbeat and election timeouts
• Remove the PrevValue field from the Node object (see http://thread.gmane.org/gmane.comp.distributed.etcd/56)
• Add a dir parameter for explicitly creating, updating and deleting directories (see #349)
• Dashboard module had a variety of bug fixes
• Added directory TTL API documentation

etcdctl

• etcdctl --debug dumps the cluster peers to ease debugging
• etcdctl ls --recursive prints out the key space recursively now
• etcdctl --peers is parsed identically to the etcd flag

Getting Started

CoreOS / Docker

To run it it in a docker container on CoreOS:

docker run -i -t -p 4002:4001 coreos/etcd

curl -L http://127.0.0.1:4002/v2/keys/mykey -XPUT -d value="this is awesome"
curl -L http://127.0.0.1:4002/v2/keys/mykey

OS X

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

curl -L  https://github.com/coreos/etcd/releases/download/v0.2.0-rc3/etcd-v0.2.0-rc3-Darwin-x86_64.tar.gz -o etcd-v0.2.0-rc3-Darwin-x86_64.tar.gz
tar xzvf etcd-v0.2.0-rc3-Darwin-x86_64.tar.gz
cd etcd-v0.2.0-rc3-Darwin-x86_64
./etcd

Open another terminal:

# Press enter to background etcd
./etcdctl set mykey "this is awesome"
./etcdctl get mykey

v0.2.0-rc2

The major changes in this release are some adjustments to the v2 response format to improve usability for clients, a new lock module and the usual set of bug fixes.

etcd

• etcd: mod/lock has been merged into the API, docs forthcoming
• etcd: Based on feedback from a number of people we have a simpler response format in the v2 API on master. go-etcd and etcdctl master have been updated too.

$ curl -L http://127.0.0.1:4001/v2/keys/?recursive=true
{
    "action": "get",
    "node": {
        "dir": true,
        "key": "/",
        "nodes": [
            {
                "createdIndex": 2,
                "dir": true,
                "key": "/foo_dir",
                "modifiedIndex": 2,
                "nodes": [
                    {
                        "createdIndex": 2,
                        "key": "/foo_dir/foo",
                        "modifiedIndex": 2,
                        "value": "bar"
                    }
                ]
            }
        ]
    }
}

etcdctl

• etcdctl: exec-watch tool added to exec a script whenever a key changes

v0.2.0-rc1: CAS, Tiered Config, Refactoring, Hardening

This is a release candidate for v0.2.0. We've added a lot of additional features since v0.1.0:

• Compare-and-Swap (CAS) operations are now available so you can conditional set values on keys. It's an essential component to building distributed lock systems.
• Tiered configuration allows you to specify arguments on the command line, through environment variables, or by loading a configuration file.
• Recursive GET requests can retrieve all data within a directory.
• GET requests can be fully consistent by specifying the consistent=true query parameter.
• Clients can now watch for expiring keys.
• Versioning on the internal protocol will allow you to run multiple versions of etcd in a cluster and perform rolling upgrades.

We've also dedicated a ton of resources to refactoring code and significantly improving unit tests and migration tests.

Please download the binaries and give us your feedback. If you have any trouble, just send an issue to the GitHub Issues page.

v0.2.0-rc0: a preview of the v2 API

This is a preview release of etcd 0.2.0 with the new etcd v2 API. This branch is still baking but we wanted to give people a chance to try out the new API and have time to give us feedback on the changes. You can find the v2 API docs here: http://docs.etcd.apiary.io/

As always trying out etcd is as easy as downloading one of the binaries below and extracting it and then running:

./etcd
./etcdctl set hello-world "This is my first key"
./etcdctl get hello-world

If you are filing issues please indicate you are running v0.2.0-rc0 and send PRs against the 0.2 branch.