etcd

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

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

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

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

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

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

Changelog

• etcd: Fix a lockup with watchers and a large number of transactions (https://github.com/coreos/etcd/pull/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

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 https://github.com/coreos/etcd/issues/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

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

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.

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.

0.1.2 Blog Post: http://coreos.com/blog/etcd-v0.1.2-new-dashboard-and-bugfixes/

Thank you to all of the contributors in this release:

Andrew Hobden, AndyPook, Antonio Terreno, Brandon Philips, David Fisher, Deniz Adrian, Derek Chiang (Enchi Jiang), Diwaker Gupta, Evan, Fabrizio (Misto) Milo, Fatih Arslan, Geoff Hayes, Yifan Gu, Jose Plana, Michael Burns, Michael Marineau, Michael Stillwell, Rob Szumski, Roberto Aguilar, Theo Hultberg, Xiang Li, kelseyhightower

This is a small release that fixes some bugs that users have reported.

Important changes include:

• Moving all client API endpoints to the /v1/ namespace
• Fixing testAndSet prefix in the raft log
• Denying mixed versions while the internal protocol is in flux (see internal-protocol-versioning

This is the first release of etcd: v0.1.0. Kick the tires on the REST API with curl, try out the the command line utility etcdctl or test out how it operates on your 17 node cross data center cluster.

Checkout the blog post for more details.

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

curl -L  https://github.com/coreos/etcd/releases/download/v0.1.0/etcd-v0.1.0-Darwin.tar.gz -o etcd-v0.1.0.tar.gz
tar xzvf etcd-v0.1.0.tar.gz
cd etcd-v0.1.0
./etcd &
# Press enter to background etcd
./etcdctl set mykey "this is awesome"
./etcdctl get mykey

This setup a single etcd node and set and retrieved a key using etcdctl. Next steps? Read the full docs to setup a cluster, configure TLS and more.

We are already planning v0.2.0. Lets make v0.2.0 even more awesome.