Nenhuma descrição

Xiang Li 42b5bc021a Merge pull request #4186 from xiang90/fix_store 10 anos atrás
Documentation 39ed73c290 doc: remove proto in rfc, link to proto file in codebase 10 anos atrás
Godeps 1814867733 Godeps: remove golang.org/x/net/netutil 10 anos atrás
client dac56faf61 Merge pull request #4030 from mitake/endpoint-selection 10 anos atrás
contrib 58ac6aeb5a test: activate tests on contrib/raftexample 10 anos atrás
discovery 81229dbea9 *: add missing package descriptions 10 anos atrás
error 81229dbea9 *: add missing package descriptions 10 anos atrás
etcdctl dd02ec6554 etcdctl: ignore value in updatedir command 10 anos atrás
etcdctlv3 82eeffbd58 etcdserver: support sorted range requests in v3 api 10 anos atrás
etcdmain 811fbc5672 etcdmain: support keep alive listeners on limit listener connections 10 anos atrás
etcdserver efa9cd7e0c Merge pull request #4184 from heyitsanthony/v3-rangereq-sort 10 anos atrás
hack 90e8dcd9bf hack: benchmarking to use Content Type 10 anos atrás
integration b126ff77fb tests: only check for go1.5+ once 10 anos atrás
lease 6b1d9fb7ce *: stop lessor when etcdserver is stopped 10 anos atrás
logos d375b67a50 logos: add SVG and PNG logos 11 anos atrás
pkg 811fbc5672 etcdmain: support keep alive listeners on limit listener connections 10 anos atrás
proxy 81229dbea9 *: add missing package descriptions 10 anos atrás
raft eab052d5c4 Merge pull request #4141 from ngaut/ngaut/refactor 10 anos atrás
rafthttp 54a45ba2f5 *: fix typo 10 anos atrás
scripts 25f82b25f7 lease: modify API and persist lease to disk 10 anos atrás
snap 4be152bb4f rework 10 anos atrás
storage f01c8188f8 *: rename lease.DeleteableRange to lease.RangeDeleter 10 anos atrás
store 547250321b store: handle watch dir removal correctly 10 anos atrás
tools f5753f2f51 *: support lease Attach 10 anos atrás
version 81229dbea9 *: add missing package descriptions 10 anos atrás
wal a4de207d53 wal: fix shadowed variables 10 anos atrás
.dockerignore f734ba9974 Add .dockerignore to avoid including .git in docker build context 11 anos atrás
.gitignore 4f5f999847 tools/functional-test: add docker support 10 anos atrás
.godir 03bacc1984 create .godir 11 anos atrás
.header 58112f3abe header: change date to 2016 10 anos atrás
.travis.yml bbdd3c5f0e travis, test: allow failures with gotip 10 anos atrás
CONTRIBUTING.md 3dad5fffc0 documentation: changed link to style doc 10 anos atrás
DCO fd9ad4fa2c docs(readme/contrib): clean up README, merge changes from CONTRIBUTING.md and split out DCO 12 anos atrás
Dockerfile 3e234918ee Dockerfile: initial commit 11 anos atrás
LICENSE 3381177341 License project under the Apache License Version 2.0 12 anos atrás
MAINTAINERS 1a3092b954 MAINTAINERS: add Ben Darnell 10 anos atrás
NOTICE 054de85da2 feat(*): initial commit 12 anos atrás
Procfile b83b0af41f Procfile: change it to double-dash in Procfile 10 anos atrás
README.md 7b90099526 README: link to production users 10 anos atrás
ROADMAP.md 00b4880494 Update ROADMAP.md 10 anos atrás
V3DemoProcfile 7b90faafad V3DemoProcfile: use double dash 10 anos atrás
build 2c2fe7ee8e build: remove bash'ism 10 anos atrás
build.bat 4a0d8ee4bd build: implemented build shell-script for Windows 10 anos atrás
cover 1239e1ce6f test, scripts: use /usr/bin/env to find bash 10 anos atrás
main.go 02be882c8f migrate: remove starter code 11 anos atrás
test 58ac6aeb5a test: activate tests on contrib/raftexample 10 anos atrás

README.md

etcd

Build Status Build Status Docker Repository on Quay.io

Note: The master branch may be in an unstable or even broken state during development. Please use releases instead of the master branch in order to get stable binaries.

etcd Logo

etcd is a distributed, consistent key-value store for shared configuration and service discovery, with a focus on being:

  • Simple: curl'able user-facing API (HTTP+JSON)
  • Secure: optional SSL client cert authentication
  • Fast: benchmarked 1000s of writes/s per instance
  • Reliable: properly distributed using Raft

etcd is written in Go and uses the Raft consensus algorithm to manage a highly-available replicated log.

etcd is used in production by many companies, and the development team stands behind it in critical deployment scenarios, where etcd is frequently teamed with applications such as Kubernetes, fleet, locksmith, vulcand, and many others.

See etcdctl for a simple command line client. Or feel free to just use curl, as in the examples below.

Getting Started

Getting etcd

The easiest way to get etcd is to use one of the pre-built release binaries which are available for OSX, Linux, Windows, AppC (ACI), and Docker. Instructions for using these binaries are on the GitHub releases page.

For those wanting to try the very latest version, you can build the latest version of etcd from the master branch. You will first need Go installed on your machine (version 1.4+ is required). All development occurs on master, including new features and bug fixes. Bug fixes are first targeted at master and subsequently ported to release branches, as described in the branch management guide.

Running etcd

First start a single-member cluster of etcd:

./bin/etcd

This will bring up etcd listening on port 2379 for client communication and on port 2380 for server-to-server communication.

Next, let's set a single key, and then retrieve it:

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

You have successfully started an etcd and written a key to the store.

Running local etcd cluster

First install goreman, which manages Procfile-based applications.

Our Procfile script will set up a local example cluster. You can start it with:

goreman start

This will bring up 3 etcd members infra1, infra2 and infra3 and etcd proxy proxy, which runs locally and composes a cluster.

You can write a key to the cluster and retrieve the value back from any member or proxy.

Next Steps

Now it's time to dig into the full etcd API and other guides.

Contact

Contributing

See CONTRIBUTING for details on submitting patches and the contribution workflow.

Reporting bugs

See reporting bugs for details about reporting any issue you may encounter.

Project Details

Versioning

Service Versioning

etcd uses semantic versioning New minor versions may add additional features to the API.

You can get the version of etcd by issuing a request to /version:

curl -L http://127.0.0.1:2379/version

API Versioning

The v2 API responses should not change after the 2.0.0 release but new features will be added over time.

32-bit systems

etcd has known issues on 32-bit systems due to a bug in the Go runtime. See #358 for more information.

License

etcd is under the Apache 2.0 license. See the LICENSE file for details.