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

Keine Beschreibung

Struktur: 5dcbb998f1
Branches Tags
etcd-io__etcd
Yicheng Qin 5dcbb998f1 *: bump to v2.1.3+git vor 9 Jahren
Documentation 61f4e74652 etcdmain: reject unreasonably high values of -election-timeout vor 9 Jahren
Godeps 436bacd77a *: introduce grpc dependency vor 9 Jahren
client 52c5203370 *: key handler should write auth error as etcd error vor 9 Jahren
discovery 3a346eac25 discovery: print out detailed cluster error vor 9 Jahren
error 52c5203370 *: key handler should write auth error as etcd error vor 9 Jahren
etcdctl cd2a2182cf etcdctl/cluster_health: set health var when checked healthy vor 9 Jahren
etcdmain dbac8c8f42 etcdmain: check error before assigning peer transport vor 9 Jahren
etcdserver 89640cf08f etcdserver: remove TODO to delete URLStringsEqual vor 9 Jahren
hack b85496922f etcdmain: simplify proxy start logic vor 10 Jahren
integration e7ed7a7b7a integration: always check error for function calls vor 9 Jahren
logos d375b67a50 logos: add SVG and PNG logos vor 10 Jahren
migrate 13f44e4b79 *: update generated proto code vor 9 Jahren
pkg ccb67a691b pkg/netutil: stop resolving in place vor 9 Jahren
proxy 7bca757d09 *: add metrics to `store` and `proxy`. vor 9 Jahren
raft c1c23626cb raft: downgrade the logging around snapshot to debugf vor 9 Jahren
rafthttp bd84e678e6 Merge pull request #3061 from yichengq/fix-stream-test vor 9 Jahren
scripts 2fb8347d36 etcdserver: add rpc proto vor 9 Jahren
snap 57a5520157 snap: Record the snapshot save duration on success rather than only on error. vor 9 Jahren
storage 883bb47dcf Merge pull request #3074 from xiang90/storage_restore vor 9 Jahren
store 07b82832f0 etcdserver: move atomics to make etcd work on arm64 vor 9 Jahren
tools e71d43b58e tools/functional-testing: add help message for flags vor 9 Jahren
version 5dcbb998f1 *: bump to v2.1.3+git vor 9 Jahren
wal 581ef05bab *: resolve proto warnings vor 9 Jahren
.dockerignore f734ba9974 Add .dockerignore to avoid including .git in docker build context vor 10 Jahren
.gitignore 677d9d1bea etcd: use old default data-dir format vor 10 Jahren
.godir 03bacc1984 create .godir vor 10 Jahren
.header f1ed69e883 *: switch to line comments for copyright vor 9 Jahren
.travis.yml 90ad78aa46 travis: stop install tools cover and vet vor 9 Jahren
CONTRIBUTING.md 0c63e16ae0 docs: small fixes to spelling and similar vor 9 Jahren
DCO fd9ad4fa2c docs(readme/contrib): clean up README, merge changes from CONTRIBUTING.md and split out DCO vor 10 Jahren
Dockerfile 3e234918ee Dockerfile: initial commit vor 10 Jahren
LICENSE 3381177341 License project under the Apache License Version 2.0 vor 11 Jahren
MAINTAINERS c7ff6d4410 MAINTAINERS: add Brandon Philips vor 10 Jahren
NOTICE 054de85da2 feat(*): initial commit vor 10 Jahren
Procfile 30db41e031 Procfile: use -listen-client-urls instead of -bind-addr vor 9 Jahren
README.md 9b962c8350 README: let roadmap point to ROADMAP.md vor 9 Jahren
ROADMAP.md d4bd57229d *: Initial roadmap vor 9 Jahren
build 17d5381059 build: default git sha to GitNotFound in case git fails vor 9 Jahren
cover 491362f5db scripts: add build, cover and update test vor 10 Jahren
main.go 02be882c8f migrate: remove starter code vor 9 Jahren
test d2ecd9cecf test: race detector doesn't work on armv7l vor 9 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 easiest way to get etcd is to install one of the pre-built binaries from the tagged releases: instructions are available on GitHub.

For those wanting to try the very latest version, you can build the latest version of etcd from the master branch. 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.

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.