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

Keine Beschreibung

Struktur: 4b0d9f69c7
Branches Tags
etcd-io__etcd
Xiang Li 4b0d9f69c7 storage: add a simple backend and kv example vor 10 Jahren
Documentation 5203de5566 Documentation: add the R client etseed to libraries-and-tools.md vor 10 Jahren
Godeps 9d831e3075 *: godep btree 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 57270ec0b7 etcdctl: add extended as output format vor 10 Jahren
etcdmain a6a649f1c3 etcdserver: stop exposing Cluster struct vor 10 Jahren
etcdserver 6296054ff6 etcdhttp: version endpoint also returns cluster version. vor 10 Jahren
hack b85496922f etcdmain: simplify proxy start logic vor 11 Jahren
integration a6a649f1c3 etcdserver: stop exposing Cluster struct vor 10 Jahren
logos d375b67a50 logos: add SVG and PNG logos vor 11 Jahren
migrate 05e240b892 *: update protobuf vor 10 Jahren
pkg 256a7cfe8c pkg/wait: fix TestWaitTestStress vor 10 Jahren
proxy a68efe7d1e proxy: Fix connection leak when client disconnect vor 10 Jahren
raft 6b7891c643 raft: fix typo in raftlog vor 10 Jahren
rafthttp 1c1cccd236 rafthttp: stop etcd if it is found removed when stream dial vor 10 Jahren
scripts beb606f066 Merge pull request #2704 from philips/build-aci-port-mountpoint vor 10 Jahren
snap f697916793 snap: load should only return ErrNoSnapshot vor 10 Jahren
storage 4b0d9f69c7 storage: add a simple backend and kv example 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 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 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 10 Jahren
test 5e0077cc0c etcdserver: print out extra files in data dir instead of erroring 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.