# ansilh/kubernetes-the-hardway-virtualbox architecture

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

- Interactive diagram: https://gitdiagram.com/ansilh/kubernetes-the-hardway-virtualbox
- Repository: https://github.com/ansilh/kubernetes-the-hardway-virtualbox

## Overview

This repository is an instructional guide for setting up a Kubernetes cluster in VirtualBox, not a software runtime. Its principal workflow takes an operator from VM and load-balancer prerequisites through cluster bootstrapping and access, then networking and add-ons. The README documents the ordered guide and major capabilities; source excerpts were unavailable, so relationships below reflect that documentation rather than inspected implementation details.

Main entry points: [`01.Prerequisites-VM-Configuration.md`](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/01.Prerequisites-VM-Configuration.md) (VM prerequisites), [`02.Prerequisites-HA-LB-Configuration.md`](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/02.Prerequisites-HA-LB-Configuration.md) (HA load balancer), [`03.Install-Client-Tools.md`](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/03.Install-Client-Tools.md) (Client tools), [`04.Certificate-Authority.md`](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/04.Certificate-Authority.md) (Certificates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Cluster foundation"]
  node_vm["VM prerequisites"]
  node_ha_lb["HA load balancer"]
  node_tools["Client tools"]
end

subgraph group_security["Identity and control plane"]
  node_ca["Certificates"]
  node_kubeconfig["Kubernetes configs"]
  node_encryption["Data encryption"]
  node_etcd["etcd bootstrap"]
  node_control["Control plane"]
  node_workers["Worker nodes"]
end

subgraph group_network["Networking and access"]
  node_kubectl["Remote kubectl"]
  node_routes["Pod routes"]
  node_bare_lb["Bare-metal load balancer"]
  node_lb_test["Load-balancer test"]
end

subgraph group_addons["Cluster add-ons"]
  node_dns["DNS add-on<br/>[12.DNS-Add-On.md]"]
  node_metrics["Metrics server"]
  node_dashboard["Dashboard<br/>[16.Dash-Board.md]"]
  node_iscsi["iSCSI provisioner"]
  node_ingress["NGINX ingress"]
  node_helm["Helm charts<br/>[19.Helm_Charts.md]"]
  node_coredns_config["CoreDNS manifest<br/>[coredns.yaml]"]
  node_iscsi_class["iSCSI storage class"]
  node_iscsi_deploy["iSCSI deployment"]
  node_iscsi_pvc["iSCSI claim"]
end

node_operator(("Cluster operator"))

node_operator -->|"starts with"| node_vm
node_vm -->|"continues to"| node_ha_lb
node_ha_lb -->|"continues to"| node_tools
node_tools -->|"continues to"| node_ca
node_ca -->|"continues to"| node_kubeconfig
node_kubeconfig -->|"continues to"| node_encryption
node_encryption -->|"continues to"| node_etcd
node_etcd -->|"continues to"| node_control
node_control -->|"continues to"| node_workers
node_workers -->|"continues to"| node_kubectl
node_kubectl -->|"continues to"| node_routes
node_routes -->|"continues to"| node_dns
node_dns -->|"continues to"| node_bare_lb
node_bare_lb -->|"continues to"| node_lb_test
node_lb_test -->|"continues to"| node_metrics
node_metrics -->|"continues to"| node_dashboard
node_dashboard -->|"continues to"| node_iscsi
node_iscsi -->|"continues to"| node_ingress

click node_vm "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/01.Prerequisites-VM-Configuration.md"
click node_ha_lb "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/02.Prerequisites-HA-LB-Configuration.md"
click node_tools "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/03.Install-Client-Tools.md"
click node_ca "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/04.Certificate-Authority.md"
click node_kubeconfig "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/05.Kubernetes-configuration-files.md"
click node_encryption "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/06.Data-encryption-keys.md"
click node_etcd "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/07.Bootstrapping-etcd.md"
click node_control "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/08.Bootstrapping-kubernetes-controllers.md"
click node_workers "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/09.Bootstrapping-kubernetes-workers.md"
click node_kubectl "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/10.Configuring-kubectl.md"
click node_routes "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/11.Pod-Network-Routes.md"
click node_dns "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/12.DNS-Add-On.md"
click node_bare_lb "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/13.Load-Balancer.md"
click node_lb_test "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/14.Test-Loadbalancer-type.md"
click node_metrics "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/15.Deploy-Metric-Server.md"
click node_dashboard "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/16.Dash-Board.md"
click node_iscsi "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/17.Dynamic-iSCSI-Volume-Provisioner.md"
click node_ingress "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/18.Ingress-Controller-using-NGINX.md"
click node_helm "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/19.Helm_Charts.md"
click node_coredns_config "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/config/coredns.yaml"
click node_iscsi_class "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/config/iscsi-provisioner-class.yaml"
click node_iscsi_deploy "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/config/iscsi-provisioner-d.yaml"
click node_iscsi_pvc "https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/config/iscsi-provisioner-pvc.yaml"

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_vm,node_ha_lb,node_tools toneBlue
class node_ca,node_kubeconfig,node_encryption,node_etcd,node_control,node_workers toneAmber
class node_kubectl,node_routes,node_bare_lb,node_lb_test toneMint
class node_dns,node_metrics,node_dashboard,node_iscsi,node_ingress,node_helm,node_coredns_config,node_iscsi_class,node_iscsi_deploy,node_iscsi_pvc toneRose
class node_operator toneIndigo
```

## Components

### Cluster foundation

- [VM prerequisites](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/01.Prerequisites-VM-Configuration.md): `01.Prerequisites-VM-Configuration.md`
- [HA load balancer](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/02.Prerequisites-HA-LB-Configuration.md): `02.Prerequisites-HA-LB-Configuration.md`
- [Client tools](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/03.Install-Client-Tools.md): `03.Install-Client-Tools.md`

### Identity and control plane

- [Certificates](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/04.Certificate-Authority.md): `04.Certificate-Authority.md`
- [Kubernetes configs](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/05.Kubernetes-configuration-files.md): `05.Kubernetes-configuration-files.md`
- [Data encryption](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/06.Data-encryption-keys.md): `06.Data-encryption-keys.md`
- [etcd bootstrap](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/07.Bootstrapping-etcd.md): `07.Bootstrapping-etcd.md`
- [Control plane](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/08.Bootstrapping-kubernetes-controllers.md): `08.Bootstrapping-kubernetes-controllers.md`
- [Worker nodes](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/09.Bootstrapping-kubernetes-workers.md): `09.Bootstrapping-kubernetes-workers.md`

### Networking and access

- [Remote kubectl](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/10.Configuring-kubectl.md): `10.Configuring-kubectl.md`
- [Pod routes](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/11.Pod-Network-Routes.md): `11.Pod-Network-Routes.md`
- [Bare-metal load balancer](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/13.Load-Balancer.md): `13.Load-Balancer.md`
- [Load-balancer test](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/14.Test-Loadbalancer-type.md): `14.Test-Loadbalancer-type.md`

### Cluster add-ons

- [DNS add-on](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/12.DNS-Add-On.md): `12.DNS-Add-On.md`
- [Metrics server](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/15.Deploy-Metric-Server.md): `15.Deploy-Metric-Server.md`
- [Dashboard](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/16.Dash-Board.md): `16.Dash-Board.md`
- [iSCSI provisioner](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/17.Dynamic-iSCSI-Volume-Provisioner.md): `17.Dynamic-iSCSI-Volume-Provisioner.md`
- [NGINX ingress](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/18.Ingress-Controller-using-NGINX.md): `18.Ingress-Controller-using-NGINX.md`
- [Helm charts](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/19.Helm_Charts.md): `19.Helm_Charts.md`
- [CoreDNS manifest](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/config/coredns.yaml): `config/coredns.yaml`
- [iSCSI storage class](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/config/iscsi-provisioner-class.yaml): `config/iscsi-provisioner-class.yaml`
- [iSCSI deployment](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/config/iscsi-provisioner-d.yaml): `config/iscsi-provisioner-d.yaml`
- [iSCSI claim](https://github.com/ansilh/kubernetes-the-hardway-virtualbox/blob/master/config/iscsi-provisioner-pvc.yaml): `config/iscsi-provisioner-pvc.yaml`

### Other components

- **Cluster operator**

## Connections

- Cluster operator → VM prerequisites: starts with (evidence: `README.md`)
- VM prerequisites → HA load balancer: continues to (evidence: `README.md`)
- HA load balancer → Client tools: continues to (evidence: `README.md`)
- Client tools → Certificates: continues to (evidence: `README.md`)
- 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 → DNS add-on: continues to (evidence: `README.md`)
- DNS add-on → Bare-metal load balancer: continues to (evidence: `README.md`)
- Bare-metal load balancer → Load-balancer test: continues to (evidence: `README.md`)
- Load-balancer test → Metrics server: continues to (evidence: `README.md`)
- Metrics server → Dashboard: continues to (evidence: `README.md`)
- Dashboard → iSCSI provisioner: continues to (evidence: `README.md`)
- iSCSI provisioner → NGINX ingress: continues to (evidence: `README.md`)
