OKC — Offline Kube Cluster

Prototype IaC pour créer un cluster Kubernetes hors ligne sur Proxmox.

Périmètre v0.1

• Proxmox existant
• VM Debian 13 créées depuis un template cloud-init
• Terraform avec le provider bpg/proxmox
• Ansible pour préparer les VM et installer Kubernetes avec kubeadm et containerd
• Miroir APT local et registre OCI local
• CNI : Cilium
• Topologie initiale : 1 control plane et 2 workers

Cette première étape prépare uniquement le socle Terraform. L'installation Kubernetes et les rôles Ansible viendront ensuite.

Prérequis

• Terraform/OpenTofu compatible avec la version du provider choisie
• API Proxmox accessible depuis la machine d'administration
• Template Debian 13 cloud-init déjà créé sur Proxmox
• Bridge réseau, stockage et IDs du template connus
• Accès au miroir APT et au registre OCI depuis le réseau des VM

Démarrage

1. Copier terraform/terraform.tfvars.example vers terraform/terraform.tfvars.

2. Renseigner les valeurs propres à l'environnement.

3. Fournir les secrets Proxmox via variables d'environnement, pas dans Git.

4. Depuis terraform/ :

   terraform init
   terraform validate
   terraform plan
   

Relire le plan avant d'appliquer. terraform apply crée des ressources réelles sur Proxmox.

État du projet

Le module Terraform ci-dessous est un squelette de départ : il documente les paramètres à fournir et la structure souhaitée. Les arguments précis de création de VM doivent être alignés sur la version du provider bpg/proxmox et sur le template existant avant le premier apply.

Hors périmètre de cette étape

• Création automatisée du template Debian
• Configuration du miroir APT et du registre OCI
• Rôles Ansible Kubernetes
• Amorçage kubeadm et installation Cilium
• Haute disponibilité du control plane