# kelseyhightower/kubernetes-the-hard-way architecture

> Architecture diagram of the GitHub repository kelseyhightower/kubernetes-the-hard-way, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kelseyhightower/kubernetes-the-hard-way
- Repository: https://github.com/kelseyhightower/kubernetes-the-hard-way

## Overview

Kubernetes The Hard Way is a learning tutorial, not an automated installer. Its main workflow takes a learner from machine prerequisites through infrastructure and security setup, bootstraps etcd and Kubernetes, then configures access, networking, validation, and cleanup. The graph follows the README’s ordered labs; it describes tutorial stages rather than asserting runtime calls between repository components. Configuration and service files support the labs, but the available evidence does not establish their specific relationships.

Main entry points: [`docs/01-prerequisites.md`](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/01-prerequisites.md) (Prerequisites), [`docs/02-jumpbox.md`](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/02-jumpbox.md) (Jumpbox), [`docs/03-compute-resources.md`](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/03-compute-resources.md) (Compute Resources), [`docs/04-certificate-authority.md`](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/04-certificate-authority.md) (CA and Certificates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Preparation"]
  node_prerequisites["Prerequisites"]
  node_jumpbox["Jumpbox<br/>[02-jumpbox.md]"]
  node_compute["Compute Resources"]
end

subgraph group_security["Security Setup"]
  node_certificates["CA and Certificates"]
  node_kubeconfigs["Kubernetes Configs"]
  node_encryption["Data Encryption"]
end

subgraph group_bootstrap["Cluster Bootstrap"]
  node_etcd["etcd Bootstrap"]
  node_controlplane["Control Plane"]
  node_workers["Worker Nodes"]
end

subgraph group_operations["Access and Validation"]
  node_kubectl["Remote kubectl"]
  node_routes["Pod Routes"]
  node_smoketest["Smoke Test<br/>[12-smoke-test.md]"]
  node_cleanup["Cleanup<br/>[13-cleanup.md]"]
end

node_learner(("Learner"))

node_learner -->|"starts with"| node_prerequisites
node_prerequisites -->|"continues to"| node_jumpbox
node_jumpbox -->|"continues to"| node_compute
node_compute -->|"continues to"| node_certificates
node_certificates -->|"continues to"| node_kubeconfigs
node_kubeconfigs -->|"continues to"| node_encryption
node_encryption -->|"continues to"| node_etcd
node_etcd -->|"continues to"| node_controlplane
node_controlplane -->|"continues to"| node_workers
node_workers -->|"continues to"| node_kubectl
node_kubectl -->|"continues to"| node_routes
node_routes -->|"continues to"| node_smoketest
node_smoketest -->|"ends with"| node_cleanup

click node_prerequisites "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/01-prerequisites.md"
click node_jumpbox "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/02-jumpbox.md"
click node_compute "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/03-compute-resources.md"
click node_certificates "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/04-certificate-authority.md"
click node_kubeconfigs "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/05-kubernetes-configuration-files.md"
click node_encryption "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/06-data-encryption-keys.md"
click node_etcd "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/07-bootstrapping-etcd.md"
click node_controlplane "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/08-bootstrapping-kubernetes-controllers.md"
click node_workers "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/09-bootstrapping-kubernetes-workers.md"
click node_kubectl "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/10-configuring-kubectl.md"
click node_routes "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/11-pod-network-routes.md"
click node_smoketest "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/12-smoke-test.md"
click node_cleanup "https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/13-cleanup.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_prerequisites,node_jumpbox,node_compute toneBlue
class node_certificates,node_kubeconfigs,node_encryption toneAmber
class node_etcd,node_controlplane,node_workers toneMint
class node_kubectl,node_routes,node_smoketest,node_cleanup toneRose
class node_learner toneIndigo
```

## Components

### Preparation

- [Prerequisites](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/01-prerequisites.md): `docs/01-prerequisites.md`
- [Jumpbox](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/02-jumpbox.md): `docs/02-jumpbox.md`
- [Compute Resources](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/03-compute-resources.md): `docs/03-compute-resources.md`

### Security Setup

- [CA and Certificates](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/04-certificate-authority.md): `docs/04-certificate-authority.md`
- [Kubernetes Configs](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/05-kubernetes-configuration-files.md): `docs/05-kubernetes-configuration-files.md`
- [Data Encryption](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/06-data-encryption-keys.md): `docs/06-data-encryption-keys.md`

### Cluster Bootstrap

- [etcd Bootstrap](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/07-bootstrapping-etcd.md): `docs/07-bootstrapping-etcd.md`
- [Control Plane](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/08-bootstrapping-kubernetes-controllers.md): `docs/08-bootstrapping-kubernetes-controllers.md`
- [Worker Nodes](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/09-bootstrapping-kubernetes-workers.md): `docs/09-bootstrapping-kubernetes-workers.md`

### Access and Validation

- [Remote kubectl](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/10-configuring-kubectl.md): `docs/10-configuring-kubectl.md`
- [Pod Routes](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/11-pod-network-routes.md): `docs/11-pod-network-routes.md`
- [Smoke Test](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/12-smoke-test.md): `docs/12-smoke-test.md`
- [Cleanup](https://github.com/kelseyhightower/kubernetes-the-hard-way/blob/master/docs/13-cleanup.md): `docs/13-cleanup.md`

### Other components

- **Learner**

## Connections

- Learner → Prerequisites: starts with (evidence: `README.md`)
- Prerequisites → Jumpbox: continues to (evidence: `README.md`)
- Jumpbox → Compute Resources: continues to (evidence: `README.md`)
- Compute Resources → CA and Certificates: continues to (evidence: `README.md`)
- CA and Certificates → Kubernetes Configs: continues to (evidence: `README.md`)
- Kubernetes Configs → Data Encryption: continues to (evidence: `README.md`)
- Data Encryption → etcd Bootstrap: continues to (evidence: `README.md`)
- etcd Bootstrap → Control Plane: continues to (evidence: `README.md`)
- Control Plane → Worker Nodes: continues to (evidence: `README.md`)
- Worker Nodes → Remote kubectl: continues to (evidence: `README.md`)
- Remote kubectl → Pod Routes: continues to (evidence: `README.md`)
- Pod Routes → Smoke Test: continues to (evidence: `README.md`)
- Smoke Test → Cleanup: ends with (evidence: `README.md`)
