# aelek73/rke2-ansible-terraform-proxmox architecture

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

- Interactive diagram: https://gitdiagram.com/aelek73/rke2-ansible-terraform-proxmox
- Repository: https://github.com/aelek73/rke2-ansible-terraform-proxmox

## Overview

This repository automates RKE2 cluster creation and upgrades on Proxmox: an operator prepares VM templates and Terraform inputs, provisions VMs, then runs Ansible playbooks to install servers and agents. The README also documents sequential server joining, kubeconfig endpoint adjustment, and cluster access. Upgrade playbooks are a separate operational path driven by the upgrade variables. Relationships below are based on README instructions only; no source excerpts were available to verify implementation details.

Main entry points: [`main.tf`](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/main.tf) (VM provisioning), [`terraform.tfvars`](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/terraform.tfvars) (Terraform inputs), [`ansible/rke2-install-first-server.yaml`](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-install-first-server.yaml) (First server install), [`ansible/rke2-install-server.yaml`](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-install-server.yaml) (Additional server install)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provisioning["VM provisioning"]
  node_template["VM template setup"]
  node_terraform["VM provisioning<br/>[main.tf]"]
  node_tf_inputs["Terraform inputs<br/>[terraform.tfvars]"]
  node_tf_variables["Terraform variables<br/>[variable.tf]"]
end

subgraph group_configuration["Cluster configuration"]
  node_inventory["Host inventory"]
  node_install_config["Install settings<br/>[env_vars.yaml]"]
  node_upgrade_config["Upgrade settings"]
end

subgraph group_deployment["RKE2 deployment"]
  node_first_server["First server install"]
  node_server_install["Additional server install"]
  node_agent_install["Agent install"]
  node_cluster[("RKE2 cluster")]
end

subgraph group_upgrades["Cluster upgrades"]
  node_server_upgrade["Server upgrade"]
  node_agent_upgrade["Agent upgrade"]
end

node_operator(("Operator"))
node_proxmox[("Proxmox")]
node_kubectl(("Cluster access"))

node_operator -->|"runs on host"| node_template
node_operator -->|"fills"| node_tf_inputs
node_tf_inputs -->|"configures"| node_terraform
node_terraform -->|"creates VMs"| node_proxmox
node_operator -->|"edits"| node_inventory
node_operator -->|"edits"| node_install_config
node_operator -->|"runs first"| node_first_server
node_first_server -->|"installs initial server"| node_cluster
node_operator -->|"runs sequentially"| node_server_install
node_server_install -->|"joins servers"| node_cluster
node_operator -->|"runs on agents"| node_agent_install
node_agent_install -->|"joins agents"| node_cluster
node_operator -->|"sets destination version"| node_upgrade_config
node_operator -->|"runs on servers"| node_server_upgrade
node_server_upgrade -->|"upgrades servers"| node_cluster
node_operator -->|"runs on agents"| node_agent_upgrade
node_agent_upgrade -->|"upgrades agents"| node_cluster
node_operator -->|"exports kubeconfig"| node_kubectl
node_kubectl -->|"queries nodes"| node_cluster

click node_template "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/create-ci-template.sh"
click node_terraform "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/main.tf"
click node_tf_inputs "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/terraform.tfvars"
click node_tf_variables "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/variable.tf"
click node_inventory "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/inventory_file"
click node_install_config "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/env_vars.yaml"
click node_upgrade_config "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/env_vars_upgrade.yaml"
click node_first_server "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-install-first-server.yaml"
click node_server_install "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-install-server.yaml"
click node_agent_install "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-install-agent.yaml"
click node_server_upgrade "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-upgrade-server.yaml"
click node_agent_upgrade "https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-upgrade-agent.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_template,node_terraform,node_tf_inputs,node_tf_variables toneBlue
class node_inventory,node_install_config,node_upgrade_config,node_proxmox toneAmber
class node_first_server,node_server_install,node_agent_install,node_cluster toneMint
class node_server_upgrade,node_agent_upgrade toneRose
class node_operator,node_kubectl toneIndigo
```

## Components

### VM provisioning

- [VM template setup](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/create-ci-template.sh): `create-ci-template.sh`
- [VM provisioning](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/main.tf): `main.tf`
- [Terraform inputs](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/terraform.tfvars): `terraform.tfvars`
- [Terraform variables](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/variable.tf): `variable.tf`

### Cluster configuration

- [Host inventory](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/inventory_file): `ansible/inventory_file`
- [Install settings](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/env_vars.yaml): `ansible/env_vars.yaml`
- [Upgrade settings](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/env_vars_upgrade.yaml): `ansible/env_vars_upgrade.yaml`

### RKE2 deployment

- [First server install](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-install-first-server.yaml): `ansible/rke2-install-first-server.yaml`
- [Additional server install](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-install-server.yaml): `ansible/rke2-install-server.yaml`
- [Agent install](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-install-agent.yaml): `ansible/rke2-install-agent.yaml`
- **RKE2 cluster**

### Cluster upgrades

- [Server upgrade](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-upgrade-server.yaml): `ansible/rke2-upgrade-server.yaml`
- [Agent upgrade](https://github.com/aelek73/rke2-ansible-terraform-proxmox/blob/main/ansible/rke2-upgrade-agent.yaml): `ansible/rke2-upgrade-agent.yaml`

### Other components

- **Operator**
- **Proxmox**
- **Cluster access**

## Connections

- Operator → VM template setup: runs on host (evidence: `readme.md`)
- Operator → Terraform inputs: fills (evidence: `readme.md`)
- Terraform inputs → VM provisioning: configures (evidence: `readme.md`)
- VM provisioning → Proxmox: creates VMs (evidence: `readme.md`)
- Operator → Host inventory: edits (evidence: `readme.md`)
- Operator → Install settings: edits (evidence: `readme.md`)
- Operator → First server install: runs first (evidence: `readme.md`)
- First server install → RKE2 cluster: installs initial server (evidence: `readme.md`)
- Operator → Additional server install: runs sequentially (evidence: `readme.md`)
- Additional server install → RKE2 cluster: joins servers (evidence: `readme.md`)
- Operator → Agent install: runs on agents (evidence: `readme.md`)
- Agent install → RKE2 cluster: joins agents (evidence: `readme.md`)
- Operator → Upgrade settings: sets destination version (evidence: `readme.md`)
- Operator → Server upgrade: runs on servers (evidence: `readme.md`)
- Server upgrade → RKE2 cluster: upgrades servers (evidence: `readme.md`)
- Operator → Agent upgrade: runs on agents (evidence: `readme.md`)
- Agent upgrade → RKE2 cluster: upgrades agents (evidence: `readme.md`)
- Operator → Cluster access: exports kubeconfig (evidence: `readme.md`)
- Cluster access → RKE2 cluster: queries nodes (evidence: `readme.md`)
