Seminar Proxmox VE – Automatisierung mit OpenTofu und Ansible

Das Seminar verbindet drei klar abgegrenzte Aufgaben: OpenTofu stellt virtuelle Ressourcen bereit, cloud-init initialisiert neue Instanzen und Ansible übernimmt die laufende Systemkonfiguration. Eine kleine Proxmox-Umgebung dient als durchgehendes Projekt. Die Übergaben zwischen den Werkzeugen werden explizit gestaltet, damit etwa VM-Adressen und SSH-Zugänge nicht durch manuelle Zwischenschritte übertragen werden müssen.

Die Übungen verwenden einen vorab auf die Proxmox-Version abgestimmten Community-Provider. API-Funktionen und gegebenenfalls zusätzlich benötigte SSH-Operationen werden getrennt betrachtet. Der Umfang konzentriert sich auf Linux-VMs und vorhandene Netze sowie Speicherbereiche. Die Neuinstallation eines Clusters, Speicherdesign und grundlegende Netzwerkkonfiguration werden vorausgesetzt.

Inhaltsübersicht

1. Zielumgebung und Zugriffsmodell
2. VM-Vorlagen und Ressourcenmodell
3. Bereitstellung mit OpenTofu
4. Erststart und Ansible-Übergabe
5. Konfiguration und Änderungen
6. Fehlerfälle und Lebenszyklus

Seminarinhalte

Zielumgebung und Zugriffsmodell

• Ressourcenpools, vorhandene Bridges, Speicher und erlaubte VM-Bereiche für das Übungsprojekt festlegen.
• API-Benutzer und Token mit den konkret benötigten Rechten einrichten und deren Zusammenspiel prüfen.
• Providerkompatibilität, Zertifikatsprüfung und gegebenenfalls zusätzliche SSH-Berechtigungen verifizieren.

VM-Vorlagen und Ressourcenmodell

• Eine vorbereitete Linux-Vorlage auf cloud-init-Unterstützung und geeignete Geräte prüfen.
• VM-Klone, CPU, Arbeitsspeicher, Datenträger und Netzwerkkarten als IaC-Ressourcen beschreiben.
• Stabile VM-Identitäten und Ressourcenadressen auch bei späteren Änderungen erhalten.

Bereitstellung mit OpenTofu

• Ein parametriertes VM-Modul erstellen und Plan sowie Abhängigkeiten vor der Anwendung prüfen.
• Mehrere Instanzen mit eindeutigen Kennungen und begrenztem Ressourcenbedarf bereitstellen.
• Provider-Rückgaben, Taskzustände und tatsächliche VM-Konfiguration miteinander abgleichen.

Erststart und Ansible-Übergabe

• Hostnamen, Schlüssel und Netzwerkeinstellungen über geeignete cloud-init-Eingaben setzen.
• Auf abgeschlossene Initialisierung und verlässliche Erreichbarkeit warten.
• Ausgaben kontrolliert in ein Ansible-Inventory oder einen passenden Inventarisierungsprozess überführen.

Konfiguration und Änderungen

• Dienste mit Ansible einrichten und Funktionsprüfungen unabhängig vom Bereitstellungsstatus ausführen.
• Eine zusätzliche VM sowie eine begrenzte Konfigurationsänderung ohne manuelle Zwischenschritte umsetzen.
• Providerupdates, VM-Ersetzungen und Änderungen an dauerhaften Daten fachlich bewerten.

Fehlerfälle und Lebenszyklus

• Berechtigungsfehler, unvollständige Klone und fehlgeschlagene Initialisierung getrennt diagnostizieren.
• Bestand, State und Konfiguration vor einem erneuten Lauf abgleichen.
• Übungsressourcen gezielt abbauen und die Grenzen zwischen IaC-Neubereitstellung und Backup-Wiederherstellung berücksichtigen.

Praxisübungen

1. Einen begrenzten API-Zugang prüfen und mit OpenTofu zwei VMs aus einer vorbereiteten Vorlage klonen. Die geplanten Parameter mit der tatsächlichen Konfiguration in Proxmox vergleichen.
2. Instanzdaten über cloud-init setzen und die erreichbaren VMs automatisch an Ansible übergeben. Einen Dienst installieren und seine Funktion aus einem getrennten Testschritt überprüfen.
3. Eine dritte VM hinzufügen, einen unzureichend berechtigten Lauf untersuchen und nach der Korrektur wiederholen. Anschließend ausschließlich die zum Übungsprojekt gehörenden Ressourcen entfernen.

Technische Übungsumgebung

Vorbereiteter Proxmox-Host oder Cluster mit abgestimmtem Provider, Linux-VM-Vorlage, vorhandenen Bridges und Speicherbereichen; Ressourcen für mindestens drei Test-VMs.

Weiterführende Seminare

Passende fachliche Ergänzungen sind Infrastructure as Code – CI/CD mit GitLab, Secrets Management – Ansible Vault, SOPS und OpenBao. Die jeweiligen Voraussetzungen bleiben maßgeblich.