بدون توضیح

Gyuho Lee 90556d550d Merge pull request #11269 from jingyih/automated-cherry-pick-of-#11265-upstream-release-3.4 5 سال پیش
.github 08db37db54 Security: Create etcd security process 5 سال پیش
Documentation 21edf98fdb Documentation:fix clerical error 5 سال پیش
auth 61d6efda4c etcdserver: add check for nil options 5 سال پیش
client 1caaa9ed4a test: test update for Go 1.12.5 and related changes 5 سال پیش
clientv3 2c36cab87d Merge pull request #11223 from YoyinZyc/automated-cherry-pick-of-#11179-origin-release-3.4 5 سال پیش
contrib 1caaa9ed4a test: test update for Go 1.12.5 and related changes 5 سال پیش
embed c7c379e52e embed: expose ZapLoggerBuilder 5 سال پیش
etcdctl b7ff97f54e etcdctl: fix member add command 5 سال پیش
etcdmain 0ecc0d0542 etcdmain: update help message 5 سال پیش
etcdserver a00abf5f2a etcdserver: strip patch version in metrics 5 سال پیش
functional 2af1caf1a5 functional test: fix typo in agent log 5 سال پیش
hack f2f7fc23f7 *: update github.com links 6 سال پیش
integration 2c36cab87d Merge pull request #11223 from YoyinZyc/automated-cherry-pick-of-#11179-origin-release-3.4 5 سال پیش
lease f6a9ebe579 Merge pull request #10710 from j2gg0s/refactor-lease-bench-test 5 سال پیش
logos d375b67a50 logos: add SVG and PNG logos 10 سال پیش
mvcc 480d5510f9 etcdserver: trace compaction request; add return parameter 'trace' to applierV3.Compaction() mvcc: trace compaction request; add input parameter 'trace' to KV.Compact() 5 سال پیش
pkg 480d5510f9 etcdserver: trace compaction request; add return parameter 'trace' to applierV3.Compaction() mvcc: trace compaction request; add input parameter 'trace' to KV.Compact() 5 سال پیش
proxy 5d19b96341 proxy/grpcproxy: deprecate "grpc.ErrClientConnClosing" 5 سال پیش
raft 165ba72593 raft/log_test: fixed wrong index 5 سال پیش
scripts f3fbed5b72 Merge branch 'release-3.4' into automated-cherry-pick-of-#11237-origin-release-3.4 5 سال پیش
security 08db37db54 Security: Create etcd security process 5 سال پیش
tests b67862c0a6 etcdserver: strip patch version in cluster version 5 سال پیش
tools 480d5510f9 etcdserver: trace compaction request; add return parameter 'trace' to applierV3.Compaction() mvcc: trace compaction request; add input parameter 'trace' to KV.Compact() 5 سال پیش
vendor 9ed5f76dc0 vendor: upgrade to gRPC v1.23.1 5 سال پیش
version bbe86b066c version: 3.4.2 5 سال پیش
wal 34bd797e67 *: revert module import paths 5 سال پیش
.gitignore e86a12bad0 gitignore: ignore build result and runtime files 6 سال پیش
.header 71e6c4b06a .header: update to 'etcd Authors' 8 سال پیش
.travis.yml c9465f51d2 *: use Go 1.12.9 5 سال پیش
.words c454344f14 clientv3: Set authority used in cert checks to host of endpoint 5 سال پیش
CONTRIBUTING.md 69ed707fab CONTRIBUTING: clarify commit message style 6 سال پیش
DCO fd9ad4fa2c docs(readme/contrib): clean up README, merge changes from CONTRIBUTING.md and split out DCO 10 سال پیش
Dockerfile-release f856ce963b Dockerfile: rebase etcd image to debian 5 سال پیش
Dockerfile-release.arm64 f856ce963b Dockerfile: rebase etcd image to debian 5 سال پیش
Dockerfile-release.ppc64le f856ce963b Dockerfile: rebase etcd image to debian 5 سال پیش
LICENSE 3381177341 License project under the Apache License Version 2.0 11 سال پیش
MAINTAINERS 8d88fea0c8 MAINTAINERS: add @spzala 5 سال پیش
MAINTAINERS_RULES.md 15498dafc8 MAINTAINERS: add "MAINTAINERS_RULES" and second email 6 سال پیش
Makefile c9465f51d2 *: use Go 1.12.9 5 سال پیش
NOTICE 054de85da2 feat(*): initial commit 11 سال پیش
OWNERS ea0cf681c7 OWNERS: add hexfusion as approver and remove joelegasse 6 سال پیش
Procfile 6de62861b7 *: use "--logger=zap" for Procfile 6 سال پیش
Procfile.v2 182d071fd0 Documentation/v2: add Procfile.v2 for proxy 7 سال پیش
README.md 222dcc8d13 README: require Go 1.12+ 5 سال پیش
bill-of-materials.json bc95b1fa84 bill-of-materials: update 5 سال پیش
bill-of-materials.override.json 42a7ea6d33 etcd: Replace ghodss/yaml with sigs.k8s.io/yaml 5 سال پیش
build 75e440b105 build: fix import path 5 سال پیش
build.bat b1d41016b2 vendor: only vendor on emitted binaries 8 سال پیش
build.ps1 7300bfdd1d build.ps1: update import paths to "go.etcd.io/etcd" 6 سال پیش
code-of-conduct.md 2395f8e81c CODE_OF_CONDUCT: update CoC 7 سال پیش
etcd.conf.yml.sample 73a8bf1fb1 sample: correct directive name 6 سال پیش
functional.yaml 8230536171 functional.yaml: try lower snapshot count for flaky tests, error threshold 5 سال پیش
go.mod 9ed5f76dc0 vendor: upgrade to gRPC v1.23.1 5 سال پیش
go.sum 9ed5f76dc0 vendor: upgrade to gRPC v1.23.1 5 سال پیش
main.go 34bd797e67 *: revert module import paths 5 سال پیش
main_test.go 9ecbf5d2d1 main_test: skip test when invoked via go test 5 سال پیش
test 29cdc9abfc test: output etcd server logs when functional tests fail 5 سال پیش

README.md

etcd

Go Report Card Coverage Build Status Travis Build Status Semaphore Docs Godoc Releases LICENSE

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.

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, locksmith, vulcand, Doorman, and many others. Reliability is further ensured by rigorous testing.

See etcdctl for a simple command line client.

Community meetings

Community meeting will resume at 11:00 am on Thursday, January 10th, 2019.

etcd contributors and maintainers have monthly (every four weeks) meetings at 11:00 AM (USA Pacific) on Thursday.

An initial agenda will be posted to the shared Google docs a day before each meeting, and everyone is welcome to suggest additional topics or other agendas.

Please download and import the following iCalendar (.ics) files to calendar system.

Weekly: https://zoom.us/meeting/916003437/ics?icsToken=e4a085b6837f5802d9aef0d2ded4777d0faf1a71e39279c4a6d8b577993d879c

Join Zoom Meeting https://zoom.us/j/916003437

One tap mobile
+14086380986,,916003437# US (San Jose)
+16465588665,,916003437# US (New York)

Dial by location
        +1 408 638 0986 US (San Jose)
        +1 646 558 8665 US (New York)

Meeting ID: 916 003 437

To Find local number: https://zoom.us/u/actX55uPfS

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, and Docker on the release page.

For more installation guides, please check out play.etcd.io and operating etcd.

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.12+ 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.

If etcd is installed using the pre-built release binaries, run it from the installation location as below:

/tmp/etcd-download-test/etcd

The etcd command can be simply run as such if it is moved to the system path as below:

mv /tmp/etcd-download-test/etcd /usr/local/bin/
etcd

If etcd is built from the master branch, run it as below:

./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 put mykey "this is awesome"
etcdctl get mykey

etcd is now running and serving client requests. For more, please check out:

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 grpc-proxy, which runs locally and composes a cluster.

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

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.

Reporting a security vulnerability

A security vulnerability can be reported as an issue, however, GitHub and mailing lists may NOT always be an appropriate place for reporting vulnerabilities. In that case, please reach out to the project MAINTAINERS to first discuss the vulnerabilities with them and take necessary action per such discussion.

Issue and PR management

See issue triage guidelines for details on how issues are managed.

See PR management for guidelines on how pull requests are managed.

etcd Emeritus Maintainers

These emeritus maintainers dedicated a part of their career to etcd and reviewed code, triaged bugs, and pushed the project forward over a substantial period of time. Their contribution is greatly appreciated.

  • Fanmin Shi
  • Anthony Romano

License

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