# automation-avenue/k8s-on-proxmox architecture

> Architecture diagram of the GitHub repository automation-avenue/k8s-on-proxmox, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/automation-avenue/k8s-on-proxmox
- Repository: https://github.com/automation-avenue/k8s-on-proxmox

## Overview

This repository is a README-only, hands-on guide for building a small Kubernetes cluster on Proxmox, not an automation package. Its documented workflow provisions three VMs, configures their Ubuntu hosts and container runtime, and then begins Kubernetes setup; the supplied README excerpt ends during containerd configuration. The diagram captures documented stages and capabilities only. There are no source excerpts, so relationships are supported by the README and later steps beyond the excerpt are omitted.

Main entry points: [`README.md`](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md) (containerd runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provision["Proxmox provisioning"]
  node_proxmox["Proxmox host"]
  node_vmset["Master and workers<br/>[README.md]"]
end

subgraph group_hosts["Host preparation"]
  node_ubuntu["Ubuntu VM hosts<br/>[README.md]"]
  node_network["Static host networking<br/>[README.md]"]
  node_updates["Host updates<br/>[README.md]"]
  node_guestagent["Guest agent<br/>[README.md]"]
  node_swap["Swap configuration<br/>[README.md]"]
  node_kernelmods["Kernel modules<br/>[README.md]"]
  node_sysctl["Kernel networking<br/>[README.md]"]
end

subgraph group_runtime["Container runtime"]
  node_containerd["containerd runtime<br/>[README.md]"]
  node_runtimeconfig["containerd configuration<br/>[README.md]"]
end

node_operator(("Cluster operator"))

node_operator -->|"creates VMs"| node_proxmox
node_proxmox -->|"hosts"| node_vmset
node_operator -->|"assigns addresses"| node_network
node_operator -->|"updates hosts"| node_updates
node_operator -->|"installs"| node_guestagent
node_operator -->|"disables"| node_swap
node_operator -->|"configures"| node_kernelmods
node_operator -->|"sets parameters"| node_sysctl
node_operator -->|"installs"| node_containerd
node_containerd -->|"generates config"| node_runtimeconfig
node_operator -->|"sets cgroup mode"| node_runtimeconfig

click node_vmset "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_ubuntu "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_network "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_updates "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_guestagent "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_swap "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_kernelmods "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_sysctl "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_containerd "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md"
click node_runtimeconfig "https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.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_proxmox,node_vmset toneBlue
class node_ubuntu,node_network,node_updates,node_guestagent,node_swap,node_kernelmods,node_sysctl toneAmber
class node_containerd,node_runtimeconfig toneMint
class node_operator toneIndigo
```

## Components

### Proxmox provisioning

- **Proxmox host**
- [Master and workers](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`

### Host preparation

- [Ubuntu VM hosts](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`
- [Static host networking](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`
- [Host updates](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`
- [Guest agent](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`
- [Swap configuration](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`
- [Kernel modules](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`
- [Kernel networking](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`

### Container runtime

- [containerd runtime](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`
- [containerd configuration](https://github.com/automation-avenue/k8s-on-proxmox/blob/main/README.md): `README.md`

### Other components

- **Cluster operator**

## Connections

- Cluster operator → Proxmox host: creates VMs (evidence: `README.md`)
- Proxmox host → Master and workers: hosts (evidence: `README.md`)
- Cluster operator → Static host networking: assigns addresses (evidence: `README.md`)
- Cluster operator → Host updates: updates hosts (evidence: `README.md`)
- Cluster operator → Guest agent: installs (evidence: `README.md`)
- Cluster operator → Swap configuration: disables (evidence: `README.md`)
- Cluster operator → Kernel modules: configures (evidence: `README.md`)
- Cluster operator → Kernel networking: sets parameters (evidence: `README.md`)
- Cluster operator → containerd runtime: installs (evidence: `README.md`)
- containerd runtime → containerd configuration: generates config (evidence: `README.md`)
- Cluster operator → containerd configuration: sets cgroup mode (evidence: `README.md`)
