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.

v0.1.2: New dashboard and bug fixes

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

v0.1.1: a small bugfix release

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

v0.1.0: the first release of etcd

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.