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

Keine Beschreibung

Struktur: 32372e1d70
Branches Tags
etcd-io__etcd
Matt Keller 32372e1d70 raft: Fixed a test misassumption vor 10 Jahren
Documentation 25c87f13fd Merge pull request #3354 from mx2323/faq vor 10 Jahren
Godeps 8738a88fae Godeps: update bolt dependency vor 10 Jahren
client 27b9963959 client: always cancel in-flight request when do request vor 10 Jahren
discovery 6b23a8131f *: test gofmt with -s and fix reported issues vor 10 Jahren
error 6b23a8131f *: test gofmt with -s and fix reported issues vor 10 Jahren
etcdctl 044b23c3ca Merge pull request #3356 from xiang90/travis vor 10 Jahren
etcdctlv3 5cd109949a etcdctl: support txn vor 10 Jahren
etcdmain 58455a2ae4 etcdmain: check error before assigning peer transport vor 10 Jahren
etcdserver 8f6bf029f8 etcdserver: specify request timeout error due to connection lost vor 10 Jahren
hack 46a2ae77a1 hack/benchmark: add script for benchmark vor 10 Jahren
integration 3702be476b integration: only print critical log vor 10 Jahren
logos d375b67a50 logos: add SVG and PNG logos vor 11 Jahren
pkg 57e88465bf pkg/transport: print ClientCertAuth in TLSInfo.String() vor 10 Jahren
proxy ece39c9462 proxy: always cancel in-flight request vor 10 Jahren
raft 32372e1d70 raft: Fixed a test misassumption vor 10 Jahren
rafthttp 8f6bf029f8 etcdserver: specify request timeout error due to connection lost vor 10 Jahren
scripts 1239e1ce6f test, scripts: use /usr/bin/env to find bash vor 10 Jahren
snap 7a6d33620f snap: export durations of marshalling cost during snapshot save vor 10 Jahren
storage 0d38c13990 storage: use temp path to handle test file vor 10 Jahren
store a7b9bff939 store: add 0 as padding for better lexicographic sorting. vor 10 Jahren
tools 3632a1b9b1 *: add initial read benchmark for etcd v3 vor 10 Jahren
version f199a484af *: only print out major.minor version for cluster version vor 10 Jahren
wal 39a4b6a5e5 pkg/fileutil: support perallocate 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 31395d257c travis: test for go 1.5 build vor 10 Jahren
CONTRIBUTING.md ad843341a9 Contributing: Link to reporting bugs doc vor 10 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 9106675fd4 Procfile: use proxy as default vor 10 Jahren
README.md 1b5e41e3f4 doc: add reporting bug doc vor 10 Jahren
ROADMAP.md 329647ab62 roadmap: update roadmap vor 10 Jahren
build e62a3b8a62 Merge pull request #2891 from glensc/patch-1 vor 10 Jahren
build.bat 4a0d8ee4bd build: implemented build shell-script for Windows vor 10 Jahren
cover 1239e1ce6f test, scripts: use /usr/bin/env to find bash vor 10 Jahren
main.go 02be882c8f migrate: remove starter code vor 11 Jahren
test 1e2b0acf6d test: activate test for storage package 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 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.

Reporting bugs

See reporting bugs for details about reporting any issue you may encounter..

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.