Skip to content

Commit 43b5c46

Browse files
author
Tim Bannister
committed
Redo cluster architecture diagram explanation
Use a <details> element so that the main flow of the explanation is still about cluster architecture, and not about the caveats around which components might be optional.
1 parent 9836d10 commit 43b5c46

File tree

1 file changed

+15
-3
lines changed
  • content/en/docs/concepts/architecture

1 file changed

+15
-3
lines changed

‎content/en/docs/concepts/architecture/_index.md

+15-3
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,19 @@ usually runs multiple nodes, providing fault-tolerance and high availability.
1515

1616
This document outlines the various components you need to have for a complete and working Kubernetes cluster.
1717

18-
{{< figure src="/images/docs/kubernetes-cluster-architecture.svg" alt="The control plane (kube-apiserver, etcd, kube-controller-manager, kube-scheduler) and several nodes. Each node is running a kubelet and kube-proxy."
19-
title="Kubernetes cluster components"
20-
caption="**Note:** This diagram presents an example reference architecture for a Kubernetes cluster. The actual distribution of components can vary based on specific cluster setups and requirements." class="diagram-large" >}}
18+
{{< figure src="/images/docs/kubernetes-cluster-architecture.svg" alt="The control plane (kube-apiserver, etcd, kube-controller-manager, kube-scheduler) and several nodes. Each node is running a kubelet and kube-proxy." caption="Figure 1. Kubernetes cluster components." class="diagram-large" >}}
19+
20+
{{< details summary="About this architecture" >}}
21+
The diagram in Figure 1 presents an example reference architecture for a Kubernetes cluster.
22+
The actual distribution of components can vary based on specific cluster setups and requirements.
23+
24+
In the diagram, each node runs the [`kube-proxy`](#kube-proxy) component. You need a
25+
network proxy component on each node to ensure that the
26+
{{< glossary_tooltip text="Service" term_id="service">}} API and associated behaviors
27+
are available on your cluster network. However, some network plugins provide their own,
28+
third party implementation of proxying. When you use that kind of network plugin,
29+
the node does not need to run `kube-proxy`.
30+
{{< /details >}}
2131

2232
## Control plane components
2333

@@ -75,6 +85,8 @@ The following controllers can have cloud provider dependencies:
7585
- Route controller: For setting up routes in the underlying cloud infrastructure
7686
- Service controller: For creating, updating and deleting cloud provider load balancers
7787

88+
---
89+
7890
## Node components
7991

8092
Node components run on every node, maintaining running pods and providing the Kubernetes runtime environment.

0 commit comments

Comments
 (0)