Skip to content

Commit 53cffb8

Browse files
committed
adding etcd overview
1 parent a5013ca commit 53cffb8

File tree

2 files changed

+39
-0
lines changed

2 files changed

+39
-0
lines changed

architecture/control-plane.adoc

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,13 @@ include::modules/understanding-machine-config-operator.adoc[leveloffset=+1]
5252
5353
* For information about preventing the control plane machines from rebooting after the Machine Config Operator makes changes to the machine configuration, see xref:../support/troubleshooting/troubleshooting-operator-issues.adoc#troubleshooting-disabling-autoreboot-mco_troubleshooting-operator-issues[Disabling Machine Config Operator from automatically rebooting].
5454
55+
include::modules/etcd-overview.adoc[leveloffset=+1]
56+
57+
[role="_additional-resources"]
58+
.Additional resources
59+
* xref:../scalability_and_performance/recommended-host-practices.adoc#recommended-etcd-practices_recommended-host-practices[Recommended etcd practices]
60+
* xref:../backup_and_restore/control_plane_backup_and_restore/backing-up-etcd.adoc#backing-up-etcd[Backing up etcd]
61+
5562
include::modules/hosted-control-planes-overview.adoc[leveloffset=+1]
5663

5764
[role="_additional-resources"]

modules/etcd-overview.adoc

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * architecture/control-plane.adoc
4+
5+
6+
:_content-type: CONCEPT
7+
[id="etcd-overview_{context}"]
8+
= Overview of etcd
9+
10+
etcd is a consistent, distributed key-value store that holds small amounts of data that can fit entirely in memory. Although etcd is a core component of many projects, it is the primary data store for Kubernetes, which is the standard system for container orchestration.
11+
12+
[id="etcd-benefits_{context}"]
13+
== Benefits of using etcd
14+
15+
By using etcd, you can benefit in several ways:
16+
17+
* Maintain consistent uptime for your cloud-native applications, and keep them working even if individual servers fail
18+
* Store and replicate all cluster states for Kubernetes
19+
* Distribute configuration data to provide redundancy and resiliency for the configuration of nodes
20+
21+
[id="etcd-architecture_{context}"]
22+
== How etcd works
23+
24+
To ensure a reliable approach to cluster configuration and management, etcd uses the etcd Operator. The Operator simplifies the use of etcd on a Kubernetes container platform like {product-title}. With the etcd Operator, you can create or delete etcd members, resize clusters, perform backups, and upgrade etcd.
25+
26+
The etcd Operator observes, analyzes, and acts:
27+
28+
. It observes the cluster state by using the Kubernetes API.
29+
. It analyzes differences between the current state and the state that you want.
30+
. It fixes the differences through the etcd cluster management APIs, the Kubernetes API, or both.
31+
32+
etcd holds the cluster state, which is constantly updated. This state is continuously persisted, which leads to a high number of small changes at high frequency. As a result, it is critical to back the etcd cluster member with fast, low-latency I/O. For more information about best practices for etcd, see "Recommended etcd practices".

0 commit comments

Comments
 (0)