Etcd Explained

etcd
Programming Language:Go
Service Name:etcd
Genre:Key–value database
License:Apache License 2.0

etcd is a key-value database commonly deployed with distributed systems.[1] The software is used by Kubernetes. It is written in the Go programming language and published under the Apache License 2.0.

History

etcd was originally developed as part of the CoreOS project, it was first announced in June of 2013. It was later donated to the Cloud Native Computing Foundation (CNCF).[2] It became a CNCF incubating project in December 2018, and graduated in November of 2020.[3] [4] At the time, the maintainer team consisted of 10 members, including: Amazon, Google Cloud, IBM, Alibaba, and Red Hat., all 32 of the CFNFs Kubernetes compliant distributions and platforms used etcd as their datastore.

According to a 2024 report by the CNCF, the project had over 3300 contributors and at least 450 contributing companies.[5]

The first stable version of etcd, v2.0.0, was released on January 28, 2015.[6] [7] v3.0.0 was released on June 30, 2016.[8]

Name

The name "etcd" is derived from the Unix convention of storing system configuration files in the /etc directory, which applies to a single system, etcd stores configurations for a distributed system, hence the appended "d" standing for "distributed".[9] [10]

Architecture

The software consists of three executables:

On particular database entries, locks can be set to prevent writing by other entities while it is being used. It uses the raft consensus algorithm.

Etcd was initially inspired by Chubby, a distributed lock manager developed Google in 2006, as well as Apache ZooKeeper.[11] [12] [13] [14]

Features

It supports TLS/SSL encryption, exposes a client-facing gRPC API, and supports multiversion concurrency control,[15] and runtime cluster membership reconfiguration.[16]

The official IANA assigned ports for etcd are TCP 2379/2380.[17]

Users

Etcd is used to store cluster data by default for most Kubernetes implementations, like AWS EKS.[18] One notable exception being Google Kubernetes Engine, whose control-plane datastore was migrated from etcd to a Spanner-based store in 2024, while preserving etcd compatibility.[19]

Kubernetes also depends on the etcd API to communicate with its datastore, meaning that all storage backends used by it are required to support the etcd API.[20]

See also

Notes and References

  1. Book: Dobies, Jason . Kubernetes Operators . Wood . Joshua . O'Reilly Media.
  2. Book: Burns, Brendan . Designing distributed systems: patterns and paradigms for scalable, reliable services, using Kubernetes . 2024 . O'Reilly . 978-1-0981-5635-0 . Second . Sebastopol.
  3. News: etcd gets ready to graduate AWS Open Source Blog . 2 December 2025 . AWS Blog . 17 November 2020.
  4. News: Cloud Native Computing Foundation Announces etcd Graduation . 2 December 2025 . CNCF . 24 November 2020.
  5. News: etcd Project Journey Report . 3 December 2025 . CNCF . 25 September 2024.
  6. News: etcd 2.0 Release - First Major Stable Release . 2 December 2025 . CoreOS . 28 Jan 2015 . https://web.archive.org/web/20160304042106/https://coreos.com/blog/etcd-2.0-release-first-major-stable-release/ . 4 Mar 2016 . dead.
  7. News: Lee . Gyuho . Betz . Joe . etcd: Current status and future roadmap . 2 December 2025 . Kubernetes . 11 December 2018 . en.
  8. News: Release v3.0.0 · etcd-io/etcd . 3 December 2025 . GitHub . Jun 30, 2016 . en.
  9. Web site: What Is etcd? . IBM . 3 December 2025 . en . 1 October 2021.
  10. Web site: etcd versus other key-value stores . etcd . 3 December 2025 . en.
  11. Web site: Google Research Publication: Chubby Distributed Lock Service . research.google.com . 2 December 2025.
  12. News: etcd: the Not-so-Secret Sauce in Google’s Kubernetes and Pivotal’s Cloud Foundry . 2 December 2025 . datacenterknowledge . 16 Jul 2014 . en.
  13. News: Distributed Key-Value Store etcd Graduates at CNCF . 2 December 2025 . InfoQ . 29 Nov 2020 . en.
  14. News: Kubernetes Podcast from Google: Episode 95 - etcd, with Xiang Li . 2 December 2025 . kubernetespodcast.com . 17 Mar 2020.
  15. News: CNCF to host etcd . 3 December 2025 . CNCF . 11 December 2018.
  16. Web site: Runtime reconfiguration . etcd . 3 December 2025 . en.
  17. Web site: Service Name and Transport Protocol Port Number Registry . IANA . 3 December 2025.
  18. News: Explore etcd Defragmentation in Amazon EKS Containers . 3 December 2025 . AWS Blogs . 25 September 2023.
  19. News: Google Kubernetes Engine supports 65,000-node clusters . 3 December 2025 . Google Cloud Blog . 14 Nov 2024.
  20. Web site: How etcd works with and without Kubernetes . LearnKube . 3 December 2025 . en.