Keine Beschreibung

Xiang Li e3817adb5b etcdserver: loose member validation for joining existing cluster vor 11 Jahren
Documentation 2a980ee336 Merge pull request #2503 from yichengq/339 vor 11 Jahren
Godeps 05e240b892 *: update protobuf vor 11 Jahren
client 9fe78c8bc4 client: don't use nested actions vor 11 Jahren
discovery cd85451971 client: clarify relationship of AfterIndex and waitIndex vor 11 Jahren
error f1ed69e883 *: switch to line comments for copyright vor 11 Jahren
etcdctl b218fc67e4 etcdctl: mark unstarted member vor 11 Jahren
etcdmain 0ac05e310e etcdmain: print error when non-flag args remain vor 11 Jahren
etcdserver e3817adb5b etcdserver: loose member validation for joining existing cluster vor 11 Jahren
hack b85496922f etcdmain: simplify proxy start logic vor 11 Jahren
integration 87e3de8b8b integration: fix decrease cluster tests vor 11 Jahren
logos d375b67a50 logos: add SVG and PNG logos vor 11 Jahren
migrate 05e240b892 *: update protobuf vor 11 Jahren
pkg 4611c3b2d7 netutil: add BasicAuth function vor 11 Jahren
proxy f1ed69e883 *: switch to line comments for copyright vor 11 Jahren
raft 05e240b892 *: update protobuf vor 11 Jahren
rafthttp d9cb77aad5 rafthttp: report snapshot failure when dropping MsgSnap vor 11 Jahren
scripts 05e240b892 *: update protobuf vor 11 Jahren
snap 05e240b892 *: update protobuf vor 11 Jahren
store afed8cf044 store: fixed clone error for store stats. vor 11 Jahren
tools d920c5b801 tools/etcd-tester: stress cluster using 50MB snapshot vor 11 Jahren
version 16183bc22b version: not return err NotExist in Detect vor 11 Jahren
wal 05e240b892 *: update protobuf vor 11 Jahren
.dockerignore f734ba9974 Add .dockerignore to avoid including .git in docker build context vor 11 Jahren
.gitignore 677d9d1bea etcd: use old default data-dir format vor 11 Jahren
.godir 03bacc1984 create .godir vor 11 Jahren
.header f1ed69e883 *: switch to line comments for copyright vor 11 Jahren
.travis.yml 92dca0af0f *: remove shadowing of variables from etcd and add travis test vor 11 Jahren
CONTRIBUTING.md 5b4fe8a558 CONTRIBUTING: update link to style guide vor 11 Jahren
DCO fd9ad4fa2c docs(readme/contrib): clean up README, merge changes from CONTRIBUTING.md and split out DCO vor 12 Jahren
Dockerfile 3e234918ee Dockerfile: initial commit vor 11 Jahren
LICENSE 3381177341 License project under the Apache License Version 2.0 vor 12 Jahren
MAINTAINERS c7ff6d4410 MAINTAINERS: add Brandon Philips vor 11 Jahren
NOTICE 054de85da2 feat(*): initial commit vor 12 Jahren
Procfile fbabcedcc9 etcd: fix proxy vor 11 Jahren
README.md 45d790c345 docs: add branch management vor 11 Jahren
build 5c0d3889f8 Added go build flag '-installsuffix cgo' to create a static library. This is needed when go 1.4 is used to build. vor 11 Jahren
cover 491362f5db scripts: add build, cover and update test vor 11 Jahren
main.go 02be882c8f migrate: remove starter code vor 11 Jahren
test 5e0077cc0c etcdserver: print out extra files in data dir instead of erroring vor 11 Jahren

README.md

etcd

Build Status Docker Repository on Quay.io

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.

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

If you're considering etcd for production use, please see: production-ready.md

Getting Started

Getting etcd

The latest release and setup instructions are available at GitHub.

You can build a latest etcd from master branch. All development occurs on the master branch which includes new features and bug fixes.

Bug fixes should target the master branch and ported to the appropriate release branch 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 4001 for client communication and on port 7001 for server-to-server communication.

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

curl -L http://127.0.0.1:4001/v2/keys/mykey -XPUT -d value="this is awesome"
curl -L http://127.0.0.1:4001/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 Profile 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.

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:4001/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.