Startseite Erkunden Hilfe
Registrieren Anmelden
publics
/
etcd-io__etcd
0
0
Fork 0
Dateien Issues 0 Pull-Requests 0 Wiki

Keine Beschreibung

Struktur: be6f49ba32
Branches Tags
etcd-io__etcd
Xiang Li be6f49ba32 Merge pull request #2758 from lavagetto/master vor 10 Jahren
Documentation 968f3d9711 docs: clarify the disaster recovery guide vor 10 Jahren
Godeps 73adb20166 *: update context pkg vor 11 Jahren
client 39dae50e71 client: fix test name typo vor 10 Jahren
discovery 9b65ff6959 discovery: drop trailing . from srv target vor 11 Jahren
error f1ed69e883 *: switch to line comments for copyright vor 11 Jahren
etcdctl 57270ec0b7 etcdctl: add extended as output format vor 10 Jahren
etcdmain 1811701427 Revert "etcdserver: fix cluster fallback recovery" vor 10 Jahren
etcdserver ebecee34e0 Merge pull request #2701 from yichengq/rafthttp-anon vor 10 Jahren
hack b85496922f etcdmain: simplify proxy start logic vor 11 Jahren
integration a42b9708ae integration: add tests around the membership change issues vor 10 Jahren
logos d375b67a50 logos: add SVG and PNG logos vor 11 Jahren
migrate 05e240b892 *: update protobuf vor 11 Jahren
pkg 39c7060d3b pkg/fileutil: add filelock support for solaris vor 10 Jahren
proxy 1b4bcedf99 Merge pull request #2637 from bakins/proxy-randomize-endpoints vor 11 Jahren
raft 6b7891c643 raft: fix typo in raftlog vor 10 Jahren
rafthttp 9f19b5660f rafthttp: add AddRemote vor 10 Jahren
scripts 117cb995a5 script: genproto assumes bash; specify bash vor 10 Jahren
snap f697916793 snap: load should only return ErrNoSnapshot vor 10 Jahren
store 2a675c08c2 store: always check the error vor 10 Jahren
tools 3127a3b659 tools/etcd-tester: wait longer for health vor 10 Jahren
version 0d25b20fc0 *: bump to v2.1.0-alpha.0+git vor 10 Jahren
wal d1d7feacc9 wal: change io.EOF returned by readFull to io.ErrUnexpectedEOF 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 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 d9ad6aa2a9 *: update to use IANA-assigned ports vor 11 Jahren
build a9157ce6d3 build: do not build internal debugging tool 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 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.