Skip to content

Releases: etcd-io/etcd

v3.1.1

17 Feb 22:05
Compare
Choose a tag to compare

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

Release signing key can be found at coreos.com/security/app-signing-key.

Bug fixes
  • GH6898: etcdserver: let maintenance services require root role
  • GH7227: clientv3: use DialContext
  • GH7260: auth: correct initialization in NewAuthStore()
  • GH7338: clientv3: fix lease keepalive duration
Getting started
Linux
ETCD_VER=v3.1.1
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: ac1c7eb
Go Version: go1.7.5
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v3.1.1
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64/* /tmp/test-etcd

/tmp/test-etcd/etcd --version
Docker
docker run --net=host \
    --name etcd-v3.1.1 \
    --volume=/tmp/etcd-data:/etcd-data \
    quay.io/coreos/etcd:v3.1.1 \
    /usr/local/bin/etcd \
    --name my-etcd-1 \
    --data-dir /etcd-data \
    --listen-client-urls http://0.0.0.0:2379 \
    --advertise-client-urls http://0.0.0.0:2379 \
    --listen-peer-urls http://0.0.0.0:2380 \
    --initial-advertise-peer-urls http://0.0.0.0:2380 \
    --initial-cluster my-etcd-1=http://0.0.0.0:2380 \
    --initial-cluster-token my-etcd-token \
    --initial-cluster-state new \
    --auto-compaction-retention 1

docker exec etcd-v3.1.1 /bin/sh -c "export ETCDCTL_API=3 && /usr/local/bin/etcd -version"
docker exec etcd-v3.1.1 /bin/sh -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl version"
docker exec etcd-v3.1.1 /bin/sh -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl endpoint health"

docker exec etcd-v3.1.1 /bin/sh -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl put foo bar"
docker exec etcd-v3.1.1 /bin/sh -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl get --consistency=s foo"

For more details, please check Docker guide.

v2.3.8

17 Feb 21:53
Compare
Choose a tag to compare

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

Release signing key can be found at coreos.com/security/app-signing-key.

Bug fixes
  • GH7282: snap: fix write snap
Getting started
Linux
ETCD_VER=v2.3.8
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: 7e4fc7e
Go Version: go1.7.5
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
/tmp/test-etcd/etcdctl --endpoints=localhost:2379 set foo "bar"
/tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v2.3.8
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64/* /tmp/test-etcd

/tmp/test-etcd/etcd --version
Docker
docker run --net=host \
    --name etcd-v2.3.8 \
    --volume=/tmp/etcd-data:/etcd-data \
    quay.io/coreos/etcd:v2.3.8 \
    /usr/local/bin/etcd \
    --name my-etcd-1 \
    --data-dir /etcd-data \
    --listen-client-urls http://0.0.0.0:2379 \
    --advertise-client-urls http://0.0.0.0:2379 \
    --listen-peer-urls http://0.0.0.0:2380 \
    --initial-advertise-peer-urls http://0.0.0.0:2380 \
    --initial-cluster my-etcd-1=http://0.0.0.0:2380 \
    --initial-cluster-token my-etcd-token \
    --initial-cluster-state new

docker exec etcd-v2.3.8 /bin/sh -c "/usr/local/bin/etcd -version"
docker exec etcd-v2.3.8 /bin/sh -c "/usr/local/bin/etcdctl version"

docker exec etcd-v2.3.8 /bin/sh -c "/usr/local/bin/etcdctl set foo bar"
docker exec etcd-v2.3.8 /bin/sh -c "/usr/local/bin/etcdctl get foo"

For more details, please check Docker guide.

v3.1.0

20 Jan 20:55
Compare
Choose a tag to compare

Today we're announcing etcd v3.1.0, backward-compatible with all previous v3.0.0+ releases.
For the 3.1 release, we focused on fixing bugs and reducing issue backlog. Besides that, we introduced a number of new features.

Please read NEWS for highlighted changes.

Release signing key can be found at coreos.com/security/app-signing-key.

New features
  • GH6038: api: transfer leadership when stopping leader
  • GH6321: api: lease timetolive
  • GH6330: clientv3: add SetEndpoints method
  • GH6474: clientv3: add 'Sync' method
  • GH6273: ctlv3: add 'print-value-only' flag to get command
  • GH6439: etcdctl/ctlv3: make-mirror: feature add to modify/remove prefix in dest cluster
  • GH6799: etcdmain: configurable 'etcd' binary log-output
  • GH7030: etcdmain: add '--metrics' option to support different level of metrics reporting
  • GH6172: clientv3/concurrency: remove session manager and add ttl
  • experimental gRPC proxy; see gRPC proxy for more detail
Notable changes
  • GH6106: etcdserver, embed: stricter reconfig checking
  • GH6156: etcdserver: reject member removal that breaks active quorum
  • GH6170: use default ip for advertise URL
  • GH6629: clientv3: drop Config.Logger field
  • GH6672: *: sort by ASCEND by default when missing sort order
  • GH6653: acbuild: add symlinks to /usr/local/bin/etcd*
Security changes
  • GH6084: etcdctl: set TLS servername on discovery
  • GH7145: transport: warn on user-provided CA
Bug fix
  • GH6649: discovery: add upper limit for waiting on a retry
  • GH5845: clientv3: respect up/down notifications from grpc
  • GH6077: v2http: use guest access in non-TLS mode
  • GH6166: clientv3: support non-blocking New()
  • GH6253: discovery: reject IP address records in SRVGetCluster
  • GH6365: embed: reject domain names before binding
  • GH6888: Use monotonic time in lease
  • GH7023: clientv3: fix lease "freezing" on unhealthy cluster
  • GH7148: clientv3: don't reset stream on keepaliveonce or revoke failure
  • GH7195: concurrency: fix stm restart on concurrent key deletion
  • GH7203: etcdctlv3: snapshot restore works with lease key
Enhancements
  • GH6543: etcdserver: use linearizableReadNotify for txn

There are over 10 minor bug fixes, please check git history for more details.

Getting started
Linux
ETCD_VER=v3.1.0
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: 8ba2897
Go Version: go1.7.4
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v3.1.0
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64/* /tmp/test-etcd

/tmp/test-etcd/etcd --version
Run in containers
rkt
RKT_VERSION=v1.23.0

GITHUB_URL=https://github.com/coreos/rkt/releases/download

DOWNLOAD_URL=${GITHUB_URL}

rm -f /tmp/rkt-${RKT_VERSION}.tar.gz
rm -rf /tmp/test-rkt-${RKT_VERSION} && mkdir -p /tmp/test-rkt-${RKT_VERSION}

curl -L ${DOWNLOAD_URL}/${RKT_VERSION}/rkt-${RKT_VERSION}.tar.gz -o /tmp/rkt-${RKT_VERSION}.tar.gz
tar xzvf /tmp/rkt-${RKT_VERSION}.tar.gz -C /tmp/test-rkt-${RKT_VERSION} --strip-components=1

# sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /usr/local/bin
sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /

/rkt version


sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.23.0 \
    quay.io/coreos/etcd:v3.1.0 \
    --exec=/bin/sh -- -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl version"

sudo rm -rf /tmp/etcd-data
sudo mkdir -p /tmp/etcd-data
sudo chown -R root:$(whoami) /tmp/etcd-data
sudo chmod -R a+rw /tmp/etcd-data

sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.23.0 \
    --net=host \
    --volume etcd-data-dir,kind=host,source=/tmp/etcd-data \
    --mount volume=etcd-data-dir,target=/tmp/etcd-data \
    quay.io/coreos/etcd:v3.1.0 -- \
    --name my-etcd-1 \
    --data-dir /tmp/etcd-data \
    --listen-client-urls http://localhost:2379 \
    --advertise-client-urls http://localhost:2379 \
    --listen-peer-urls http://localhost:2380 \
    --initial-advertise-peer-urls http://localhost:2380 \
    --initial-cluster my-etcd-1=http://localhost:2380 \
    --initial-cluster-token my-etcd-token \
    --initial-cluster-state new \
    --auto-compaction-retention 1

sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.23.0 \
    quay.io/coreos/etcd:v3.1.0 \
    --exec=/bin/sh -- -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl put foo bar"

For more details, please check rkt commands.

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

For more details, please check Docker guide.

v3.0.17

20 Jan 19:32
Compare
Choose a tag to compare

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

Release signing key can be found at coreos.com/security/app-signing-key.

Bug fixes
  • GH6085: etcdserver, lease: tie lease min ttl to election timeout
  • GH7203: etcdctlv3: snapshot restore works with lease key
Getting started
Linux
ETCD_VER=v3.0.17
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: cc198e2
Go Version: go1.6.4
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v3.0.17
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64/* /tmp/test-etcd

/tmp/test-etcd/etcd --version
Run in containers
rkt
RKT_VERSION=v1.23.0

GITHUB_URL=https://github.com/coreos/rkt/releases/download

DOWNLOAD_URL=${GITHUB_URL}

rm -f /tmp/rkt-${RKT_VERSION}.tar.gz
rm -rf /tmp/test-rkt-${RKT_VERSION} && mkdir -p /tmp/test-rkt-${RKT_VERSION}

curl -L ${DOWNLOAD_URL}/${RKT_VERSION}/rkt-${RKT_VERSION}.tar.gz -o /tmp/rkt-${RKT_VERSION}.tar.gz
tar xzvf /tmp/rkt-${RKT_VERSION}.tar.gz -C /tmp/test-rkt-${RKT_VERSION} --strip-components=1

# sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /usr/local/bin
sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /

/rkt version


sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.23.0 \
    quay.io/coreos/etcd:v3.0.17 \
    --exec=/bin/sh -- -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl version"

sudo rm -rf /tmp/etcd-data
sudo mkdir -p /tmp/etcd-data
sudo chown -R root:$(whoami) /tmp/etcd-data
sudo chmod -R a+rw /tmp/etcd-data

sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.23.0 \
    --net=host \
    --volume etcd-data-dir,kind=host,source=/tmp/etcd-data \
    --mount volume=etcd-data-dir,target=/tmp/etcd-data \
    quay.io/coreos/etcd:v3.0.17 -- \
    --name my-etcd-1 \
    --data-dir /tmp/etcd-data \
    --listen-client-urls http://localhost:2379 \
    --advertise-client-urls http://localhost:2379 \
    --listen-peer-urls http://localhost:2380 \
    --initial-advertise-peer-urls http://localhost:2380 \
    --initial-cluster my-etcd-1=http://localhost:2380 \
    --initial-cluster-token my-etcd-token \
    --initial-cluster-state new \
    --auto-compaction-retention 1

sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.23.0 \
    quay.io/coreos/etcd:v3.0.17 \
    --exec=/bin/sh -- -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl put foo bar"

For more details, please check rkt commands.

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

For more details, please check Docker guide.

v3.0.16

13 Jan 20:42
Compare
Choose a tag to compare

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

Release signing key can be found at coreos.com/security/app-signing-key.

Bug fixes
  • GH6929: etcdserver: use context for Renew
  • GH7023: clientv3: fix lease "freezing" on unhealthy cluster
  • GH7148: clientv3: don't reset stream on keepaliveonce or revoke failure
Getting started
Linux
ETCD_VER=v3.0.16
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: a23109a
Go Version: go1.6.4
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v3.0.16
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64/* /tmp/test-etcd

/tmp/test-etcd/etcd --version
Run in containers
rkt
RKT_VERSION=v1.22.0

GITHUB_URL=https://github.com/coreos/rkt/releases/download

DOWNLOAD_URL=${GITHUB_URL}

rm -f /tmp/rkt-${RKT_VERSION}.tar.gz
rm -rf /tmp/test-rkt-${RKT_VERSION} && mkdir -p /tmp/test-rkt-${RKT_VERSION}

curl -L ${DOWNLOAD_URL}/${RKT_VERSION}/rkt-${RKT_VERSION}.tar.gz -o /tmp/rkt-${RKT_VERSION}.tar.gz
tar xzvf /tmp/rkt-${RKT_VERSION}.tar.gz -C /tmp/test-rkt-${RKT_VERSION} --strip-components=1

# sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /usr/local/bin
sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /

/rkt version


sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.22.0 \
    quay.io/coreos/etcd:v3.0.16 \
    --exec=/bin/sh -- -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl version"

sudo rm -rf /tmp/etcd-data
sudo mkdir -p /tmp/etcd-data
sudo chown -R root:$(whoami) /tmp/etcd-data
sudo chmod -R a+rw /tmp/etcd-data

sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.22.0 \
    --net=host \
    --volume etcd-data-dir,kind=host,source=/tmp/etcd-data \
    --mount volume=etcd-data-dir,target=/tmp/etcd-data \
    quay.io/coreos/etcd:v3.0.16 -- \
    --name my-etcd-1 \
    --data-dir /tmp/etcd-data \
    --listen-client-urls http://localhost:2379 \
    --advertise-client-urls http://localhost:2379 \
    --listen-peer-urls http://localhost:2380 \
    --initial-advertise-peer-urls http://localhost:2380 \
    --initial-cluster my-etcd-1=http://localhost:2380 \
    --initial-cluster-token my-etcd-token \
    --initial-cluster-state new \
    --auto-compaction-retention 1

sudo /rkt \
    --trust-keys-from-https \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.22.0 \
    quay.io/coreos/etcd:v3.0.16 \
    --exec=/bin/sh -- -c "export ETCDCTL_API=3 && /usr/local/bin/etcdctl put foo bar"

For more details, please check rkt commands.

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

For more details, please check Docker guide.

v3.1.0-rc.1

18 Nov 19:30
Compare
Choose a tag to compare
v3.1.0-rc.1 Pre-release
Pre-release

Today we're announcing etcd v3.1.0-rc.1, 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

General server features:

  • Faster linearizable reads
  • 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.

Getting started
Linux
ETCD_VER=v3.1.0-rc.1
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: 3d5ba43
Go Version: go1.7.3
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v3.1.0-rc.1
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64/* /tmp/test-etcd

/tmp/test-etcd/etcd --version
Run in containers
ACI / rkt
RKT_VERSION=v1.19.0

GITHUB_URL=https://github.com/coreos/rkt/releases/download

DOWNLOAD_URL=${GITHUB_URL}

rm -f /tmp/rkt-${RKT_VERSION}.tar.gz
rm -rf /tmp/test-rkt-${RKT_VERSION} && mkdir -p /tmp/test-rkt-${RKT_VERSION}

curl -L ${DOWNLOAD_URL}/${RKT_VERSION}/rkt-${RKT_VERSION}.tar.gz -o /tmp/rkt-${RKT_VERSION}.tar.gz
tar xzvf /tmp/rkt-${RKT_VERSION}.tar.gz -C /tmp/test-rkt-${RKT_VERSION} --strip-components=1

# sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /usr/local/bin
sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /

/rkt version

sudo /rkt \
    --trust-keys-from-https \
    --dir=/var/lib/rkt \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.19.0 \
    --net=host \
    --volume data-dir,kind=host,source=/tmp \
    coreos.com/etcd:v3.1.0-rc.1 -- \
    --name my-etcd-1 \
    --listen-client-urls http://localhost:2379 \
    --advertise-client-urls http://localhost:2379 \
    --listen-peer-urls http://localhost:2380 \
    --initial-advertise-peer-urls http://localhost:2380 \
    --initial-cluster my-etcd-1=http://localhost:2380 \
    --initial-cluster-token my-etcd-token \
    --initial-cluster-state new

For more details, please check rkt commands.

Docker
docker run --name etcd quay.io/coreos/etcd:v3.1.0-rc.1

For more details, please check Docker guide.

v3.0.15

11 Nov 19:09
Compare
Choose a tag to compare

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

Bug fixes
  • GH6816: clientv3: let watchers cancel when reconnecting
  • GH6820: mvcc: return -1 for wrong watcher range key >= end
Getting started
Linux
ETCD_VER=v3.0.15
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: fc00305
Go Version: go1.6.3
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v3.0.15
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64/* /tmp/test-etcd

/tmp/test-etcd/etcd --version
Run in containers
ACI / rkt
RKT_VERSION=v1.19.0

GITHUB_URL=https://github.com/coreos/rkt/releases/download

DOWNLOAD_URL=${GITHUB_URL}

rm -f /tmp/rkt-${RKT_VERSION}.tar.gz
rm -rf /tmp/test-rkt-${RKT_VERSION} && mkdir -p /tmp/test-rkt-${RKT_VERSION}

curl -L ${DOWNLOAD_URL}/${RKT_VERSION}/rkt-${RKT_VERSION}.tar.gz -o /tmp/rkt-${RKT_VERSION}.tar.gz
tar xzvf /tmp/rkt-${RKT_VERSION}.tar.gz -C /tmp/test-rkt-${RKT_VERSION} --strip-components=1

# sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /usr/local/bin
sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /

/rkt version

sudo /rkt \
    --trust-keys-from-https \
    --dir=/var/lib/rkt \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.19.0 \
    --net=host \
    --volume data-dir,kind=host,source=/tmp \
    coreos.com/etcd:v3.0.15 -- \
    --name my-etcd-1 \
    --listen-client-urls http://localhost:2379 \
    --advertise-client-urls http://localhost:2379 \
    --listen-peer-urls http://localhost:2380 \
    --initial-advertise-peer-urls http://localhost:2380 \
    --initial-cluster my-etcd-1=http://localhost:2380 \
    --initial-cluster-token my-etcd-token \
    --initial-cluster-state new

For more details, please check rkt commands.

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

For more details, please check Docker guide.

v3.0.14

04 Nov 19:54
Compare
Choose a tag to compare

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

Bug fixes
  • GH6793: Add a no-ttl flag to etcdctl migrate to discard keys on transform
  • GH6794: ctlv3: fix migration
Getting started
Linux
ETCD_VER=v3.0.14
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: 8a37349
Go Version: go1.6.3
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v3.0.14
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64 /tmp/test-etcd

/tmp/test-etcd/etcd --version
Run in containers
ACI / rkt
RKT_VERSION=v1.18.0

GITHUB_URL=https://github.com/coreos/rkt/releases/download
DOWNLOAD_URL=${GITHUB_URL}

rm -f /tmp/rkt-${RKT_VERSION}.tar.gz
rm -rf /tmp/test-rkt-${RKT_VERSION} && mkdir -p /tmp/test-rkt-${RKT_VERSION}

curl -L ${DOWNLOAD_URL}/${RKT_VERSION}/rkt-${RKT_VERSION}.tar.gz -o /tmp/rkt-${RKT_VERSION}.tar.gz
tar xzvf /tmp/rkt-${RKT_VERSION}.tar.gz -C /tmp/test-rkt-${RKT_VERSION} --strip-components=1

# sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /usr/local/bin
sudo cp /tmp/test-rkt-${RKT_VERSION}/rkt /

/rkt version

sudo /rkt \
    --trust-keys-from-https \
    --dir=/var/lib/rkt \
    run \
    --stage1-name coreos.com/rkt/stage1-fly:1.18.0 \
    --net=host \
    --volume data-dir,kind=host,source=/tmp \
    coreos.com/etcd:v3.0.14 -- \
    --name my-etcd-1 \
    --listen-client-urls http://localhost:2379 \
    --advertise-client-urls http://localhost:2379 \
    --listen-peer-urls http://localhost:2380 \
    --initial-advertise-peer-urls http://localhost:2380 \
    --initial-cluster my-etcd-1=http://localhost:2380 \
    --initial-cluster-token my-etcd-token \
    --initial-cluster-state new

For more details, please check rkt commands.

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

For more details, please check Docker guide.

v3.0.13

24 Oct 18:17
Compare
Choose a tag to compare

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

Bug fixes
  • GH6356: auth, e2e: the root role should be granted access to every key
  • GH6622: Backport arm fixes
  • GH6633: mvcc: fix rev inconsistency
  • GH6690: etcdctl: fix migrate in outputing client.Node to json
Getting started
Linux
ETCD_VER=v3.0.13
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: c99d0d4
Go Version: go1.6.3
Go OS/Arch: linux/amd64
# start a local etcd server
/tmp/test-etcd/etcd

# write,read to etcd
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 put foo "bar"
ETCDCTL_API=3 /tmp/test-etcd/etcdctl --endpoints=localhost:2379 get foo
Mac OS (Darwin)
ETCD_VER=v3.0.13
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64 /tmp/test-etcd

/tmp/test-etcd/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.13

For more details, please check rkt commands.

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

For more details, please check Docker guide.

v3.1.0-rc.0

14 Oct 21:47
Compare
Choose a tag to compare
v3.1.0-rc.0 Pre-release
Pre-release

Today we're announcing etcd v3.1.0-rc.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

General server features:

  • Faster linearizable reads
  • 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.

Getting started
Linux
ETCD_VER=v3.1.0-rc.0
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz
mkdir -p /tmp/test-etcd && tar xzvf /tmp/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /tmp/test-etcd --strip-components=1

/tmp/test-etcd/etcd --version

Git SHA: 8334790
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)
ETCD_VER=v3.1.0-rc.0
DOWNLOAD_URL=https://github.com/coreos/etcd/releases/download
curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mkdir -p /tmp/test-etcd && unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && mv /tmp/etcd-${ETCD_VER}-darwin-amd64 /tmp/test-etcd

/tmp/test-etcd/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-rc.0

For more details, please check rkt commands.

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

For more details, please check Docker guide.