Keine Beschreibung

Gyuho Lee 487c8d3d61 etcdserver: fix "lease_expired_total" metrics vor 7 Jahren
.github c8a2c7f64f *: eschew you from documentation vor 9 Jahren
Documentation 39ea00bc92 Documentation/upgrades: backport all upgrade guides vor 7 Jahren
alarm ef44f71da9 *: update LICENSE header vor 9 Jahren
auth d62e39d5ca *: deprecate "metadata.NewContext" vor 8 Jahren
client 15e9510d2c client: fail over to next endpoint on oneshot failure vor 8 Jahren
clientv3 2160c476a2 clientv3: skip "TestDialTimeout" vor 7 Jahren
cmd 3fd6e7e1de vendor: pin grpc v1.7.5, grpc-gateway v1.3.0 (no code change) vor 8 Jahren
compactor 0265457183 compactor: fix error message of Revision compactor vor 8 Jahren
contrib 7c6a9a7317 contrib/raftexample: use bytes.Buffer.String (no 'string()') vor 8 Jahren
discovery 07ad18178d pkg/srv: package for SRV utilities vor 8 Jahren
e2e a089a747b5 e2e: remove "/v3beta" endpoints vor 7 Jahren
embed 288ef7d6fc embed: fix gRPC server panic on GracefulStop vor 8 Jahren
error 8ab42fb045 *: move v2http handlers without /v2 prefix to etcdhttp vor 8 Jahren
etcdctl 83c94e9e58 etcdctl: highlight "defrag" command caveats vor 8 Jahren
etcdmain b44b91462e etcdmain: add more details to TLS HandshakeFailure vor 8 Jahren
etcdserver 487c8d3d61 etcdserver: fix "lease_expired_total" metrics vor 7 Jahren
hack f8fc817ce8 *: remove unused env vars vor 8 Jahren
integration 7b7722ed97 integration: test GracefulStop on secure embedded server vor 8 Jahren
lease 6e5e3d134e *: enforce max lease TTL with 9,000,000,000 seconds vor 8 Jahren
logos d375b67a50 logos: add SVG and PNG logos vor 11 Jahren
mvcc 33633da64c mvcc: fix watchable store test for 3.2 cherrypick of #9281 vor 8 Jahren
pkg 1fc300ecbd testutil: don't panic on AssertNil on non-nil errors vor 8 Jahren
proxy ceaa55e57e httpproxy: cancel requests when client closes a connection vor 8 Jahren
raft eb1589ad35 *: regenerate proto vor 8 Jahren
rafthttp 29185da0e0 Merge pull request #9502 from jpbetz/automated-cherry-pick-of-#9415-release-3.2 vor 7 Jahren
scripts a2850218b2 scripts/build-docker: build both gcr.io and quay.io images vor 8 Jahren
snap f6cd4d4f5b snap, etcdserver: tighten up snapshot path handling vor 8 Jahren
store 978cf804ca store: replace testify asserts with testutil asserts vor 8 Jahren
tests a5dc3b7cb1 tests: move test scripts vor 7 Jahren
tools 2a63909648 tools/functional-tester: remove duplicate grpclog set vor 8 Jahren
version 71e96522dc version: bump up to 3.2.18+git vor 7 Jahren
wal 78a5eb79b5 *: add swagger and grpc-gateway assets for v3lock and v3election vor 8 Jahren
.dockerignore f734ba9974 Add .dockerignore to avoid including .git in docker build context vor 11 Jahren
.gitignore 4ed57689cb gitignore: sync with master branch vor 8 Jahren
.godir 03bacc1984 create .godir vor 11 Jahren
.header 71e6c4b06a .header: update to 'etcd Authors' vor 9 Jahren
.travis.yml e48a18256f travis: use Go 1.8.7, sync with master vor 8 Jahren
CONTRIBUTING.md c8a2c7f64f *: eschew you from documentation vor 9 Jahren
DCO fd9ad4fa2c docs(readme/contrib): clean up README, merge changes from CONTRIBUTING.md and split out DCO vor 12 Jahren
Dockerfile 8a71f749d7 *: separate Dockerfile for quay build trigger vor 9 Jahren
Dockerfile-release b9d91483d0 Dockerfile-release: add nsswitch.conf into image vor 9 Jahren
Dockerfile-release.arm64 0c8988aa07 build-docker: Updates for multi-arch release vor 8 Jahren
Dockerfile-release.ppc64le 0c8988aa07 build-docker: Updates for multi-arch release vor 8 Jahren
Dockerfile-test 52be1d7b19 hack/scripts-dev: add Makefile, Dockerfile-test vor 8 Jahren
LICENSE 3381177341 License project under the Apache License Version 2.0 vor 12 Jahren
MAINTAINERS 9d74eb5c60 MAINTAINERS: add Fanmin vor 9 Jahren
Makefile a5dc3b7cb1 tests: move test scripts vor 7 Jahren
NEWS 2511535ea0 NEWS: update v3.1.6 vor 8 Jahren
NOTICE 054de85da2 feat(*): initial commit vor 12 Jahren
Procfile 3351ea1ae2 Procfile: v3 as default vor 9 Jahren
README.md 25eef5a6e4 Merge pull request #7893 from philips/readme-tagline vor 8 Jahren
ROADMAP.md 83efd2c745 ROADMAP: make 'release-3.2' stable branch vor 8 Jahren
V2Procfile 3351ea1ae2 Procfile: v3 as default vor 9 Jahren
bill-of-materials.json 8de0c0419a vendor: Switch from boltdb v1.3.0 to coreos/bbolt v1.3.1-coreos.3 vor 8 Jahren
bill-of-materials.override.json 959d55ae80 bill-of-materials: regenerate with multi licenses vor 8 Jahren
build 743192aa3b *: clear rarer shellcheck errors on scripts vor 8 Jahren
build.bat b1d41016b2 vendor: only vendor on emitted binaries vor 9 Jahren
build.ps1 751a8d5b04 build: add option to enable binaries stripping for windows vor 9 Jahren
cover 1239e1ce6f test, scripts: use /usr/bin/env to find bash vor 10 Jahren
etcd.conf.yml.sample fa0f278783 embed: add 'enable-pprof' tag for config file vor 8 Jahren
glide.lock 3fd6e7e1de vendor: pin grpc v1.7.5, grpc-gateway v1.3.0 (no code change) vor 8 Jahren
glide.yaml 3fd6e7e1de vendor: pin grpc v1.7.5, grpc-gateway v1.3.0 (no code change) vor 8 Jahren
main.go ef44f71da9 *: update LICENSE header vor 9 Jahren
main_test.go 7e05b33aa0 *: remove os.Kill from signal.Notify vor 8 Jahren
test 5579dc200d test: bump up clientv3/integration timeout vor 8 Jahren

README.md

etcd

Go Report Card Build Status Build Status Docker Repository on Quay.io

Note: The master branch may be in an unstable or even broken state during development. Please use releases instead of the master branch in order to get stable binaries.

the etcd v2 documentation has moved

etcd Logo

etcd is a distributed reliable key-value store for the most critical data of a distributed system, with a focus on being:

  • Simple: well-defined, user-facing API (gRPC)
  • Secure: automatic TLS with optional client cert authentication
  • Fast: benchmarked 10,000 writes/sec
  • Reliable: properly distributed using Raft

etcd is written in Go and uses the Raft consensus algorithm to manage a highly-available replicated log.

etcd is used in production by many companies, and the development team stands behind it in critical deployment scenarios, where etcd is frequently teamed with applications such as Kubernetes, fleet, locksmith, vulcand, Doorman, and many others. Reliability is further ensured by rigorous testing.

See etcdctl for a simple command line client.

Getting started

Getting etcd

The easiest way to get etcd is to use one of the pre-built release binaries which are available for OSX, Linux, Windows, rkt, and Docker. Instructions for using these binaries are on the GitHub releases page.

For those wanting to try the very latest version, build the latest version of etcd from the master branch. This first needs Go installed (version 1.8+ is required). 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:

ETCDCTL_API=3 etcdctl put mykey "this is awesome"
ETCDCTL_API=3 etcdctl get mykey

That's it! etcd is now running and serving client requests. For more

etcd TCP ports

The official etcd ports are 2379 for client requests, and 2380 for peer communication.

Running a local etcd cluster

First install goreman, which manages Procfile-based applications.

Our Procfile script will set up a local example cluster. 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.

Every cluster member and proxy accepts key value reads and key value writes.

Running etcd on Kubernetes

To run an etcd cluster on Kubernetes, try etcd operator.

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.

Reporting bugs

See reporting bugs for details about reporting any issues.

License

etcd is under the Apache 2.0 license. See the LICENSE file for details.