Keine Beschreibung

Ryan Bourgeois 4e85f932e0 proxy: Reuse a bytes buffer as proxy request body. vor 10 Jahren
Documentation de1c9c08e1 Merge pull request #2842 from SpencerBrown/SpencerBrown-patch-2 vor 10 Jahren
Godeps af5286c63b Fix godeps to be usable vor 10 Jahren
client 48e144ae2e client: Support creating directory through KeysAPI vor 10 Jahren
discovery e9931fb8b1 discovery: do not return error from etcd vor 10 Jahren
error f1ed69e883 *: switch to line comments for copyright vor 11 Jahren
etcdctl 3d8fe3b3ca etcdctl/cluster_health: improve output if failed to get leader stats vor 10 Jahren
etcdmain 6f8c36c2ab etcdmain: use double-dash in message flag vor 10 Jahren
etcdserver 42fe370b35 Merge pull request #2848 from xiang90/metrics vor 10 Jahren
hack b85496922f etcdmain: simplify proxy start logic vor 11 Jahren
integration a88a53274f security: Lazily create the security directories. Fixes #2755, may find new instances for #2741 vor 10 Jahren
logos d375b67a50 logos: add SVG and PNG logos vor 11 Jahren
migrate 05e240b892 *: update protobuf vor 11 Jahren
pkg 3153e635d5 Revert "Treat URLs have same IP address as same" vor 10 Jahren
proxy 4e85f932e0 proxy: Reuse a bytes buffer as proxy request body. vor 10 Jahren
raft 0ca6be31f8 raft: remove wrong invariant vor 10 Jahren
rafthttp 0d3d4c5b01 rafthttp: print out log when clusterID mismatch instead of exiting vor 10 Jahren
scripts 845cb61213 storage: add kv and event proto vor 10 Jahren
snap f697916793 snap: load should only return ErrNoSnapshot vor 10 Jahren
storage 6c207b9277 stroage: kill todo vor 10 Jahren
store 2a675c08c2 store: always check the error vor 10 Jahren
tools e71d43b58e tools/functional-testing: add help message for flags vor 10 Jahren
version 6296054ff6 etcdhttp: version endpoint also returns cluster version. vor 10 Jahren
wal 34ac145b38 *: use namespace and subsystem in metrics vor 10 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 90ad78aa46 travis: stop install tools cover and vet vor 10 Jahren
CONTRIBUTING.md 0c63e16ae0 docs: small fixes to spelling and similar vor 10 Jahren
DCO fd9ad4fa2c docs(readme/contrib): clean up README, merge changes from CONTRIBUTING.md and split out DCO vor 11 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 efb0b6e5c8 Fix link to etcd-migrate in README.md vor 10 Jahren
ROADMAP.md d4bd57229d *: Initial roadmap vor 10 Jahren
build 3914defd8a version: added more version information vor 10 Jahren
cover 491362f5db scripts: add build, cover and update test vor 11 Jahren
main.go 02be882c8f migrate: remove starter code vor 11 Jahren
test fde7a7a10c test: run integration tests in verbose mode vor 10 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 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.

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.