Tag 12: Infrastruktur als Code
Ziel: Die notes-VM nicht mehr per CLI, sondern mit OpenTofu und dem OpenNebula-Provider beschreiben, anlegen, ändern und wieder abbauen. · Dauer: ca. 60 min · Voraussetzung: Tag 10
Briefing
- OpenTofu ist die freie Abspaltung von Terraform,
mit derselben Sprache (HCL) und denselben Providern. Alles in diesem
Kapitel funktioniert mit
terraformgenauso. - Der Provider
OpenNebula/opennebulaübersetzt Ressourcen wieopennebula_virtual_machinein Aufrufe der XML-RPC-API (Tag 13). - Der Ablauf ist immer gleich:
initlädt den Provider,planzeigt, was passieren würde,applysetzt es um,destroyräumt ab. Was existiert, merkt sich OpenTofu im State (terraform.tfstate).
main.tf ── tofu plan/apply ──► Provider ── XML-RPC :2633 ──► oned
│ └─► VM notes-tf
└─ terraform.tfstate (was gehört zu mir?)
Drill 1: OpenTofu installieren
cd /tmp
curl -fsSLO https://github.com/opentofu/opentofu/releases/download/v1.13.9/tofu_1.13.9_linux_amd64.tar.gz
mkdir -p ~/.local/bin
tar xzf tofu_1.13.9_linux_amd64.tar.gz -C ~/.local/bin tofu
rm tofu_1.13.9_linux_amd64.tar.gzUbuntu nimmt ~/.local/bin beim nächsten Anmelden in den
PATH auf. Melde dich einmal ab und wieder an, dann:
tofu versionErwartet:
OpenTofu v1.13.9
on linux_amd64
Fortschritt speichern? Kostenlos registrieren
Drill 2: Die Beschreibung
mkdir -p ~/one-lab/tag12
cd ~/one-lab/tag12
cat > main.tf <<'EOF'
terraform {
required_providers {
opennebula = {
source = "OpenNebula/opennebula"
version = "1.5.0"
}
}
}
provider "opennebula" {
endpoint = "http://localhost:2633/RPC2"
username = "oneadmin"
password = var.one_password
}
variable "one_password" {
type = string
sensitive = true
}
variable "db_password" {
type = string
sensitive = true
}
variable "api_key" {
type = string
sensitive = true
}
data "opennebula_image" "basis" {
name = "notes-basis"
}
data "opennebula_virtual_network" "vnet" {
name = "vnet"
}
data "opennebula_virtual_network" "intern" {
name = "intern"
}
resource "opennebula_virtual_machine" "notes" {
name = "notes-tf"
cpu = 0.5
vcpu = 1
memory = 384
disk {
image_id = data.opennebula_image.basis.id
}
nic {
network_id = data.opennebula_virtual_network.vnet.id
}
nic {
network_id = data.opennebula_virtual_network.intern.id
}
context = {
NETWORK = "YES"
SSH_PUBLIC_KEY = "$USER[SSH_PUBLIC_KEY]"
SET_HOSTNAME = "$NAME"
DB_HOST = "10.10.10.20"
DB_PASSWORD = var.db_password
API_KEY = var.api_key
NOTES_VERSION = "0.7.1"
START_SCRIPT_BASE64 = filebase64("${path.module}/../tag10/notes-schnell.sh")
}
}
output "ip" {
value = opennebula_virtual_machine.notes.nic[0].computed_ip
}
EOFdata-Blöcke lesen Vorhandenes: das Image aus Tag 10 und die beiden Netze. Ihre IDs musst du nicht kennen.- Das Startskript aus Tag 10 kommt per
filebase64()direkt aus der Datei. Keinsed, keinSKRIPT-Platzhalter mehr. sensitive = trueverhindert, dass OpenTofu die Werte in Ausgaben zeigt.
Die Werte für die Variablen stehen in einer eigenen Datei, die OpenTofu von selbst liest:
cat > lab.auto.tfvars <<'EOF'
one_password = "lab-one-pass-123"
db_password = "lab-db-pass-123"
api_key = "lab-api-key-123"
EOFFortschritt speichern? Kostenlos registrieren
Drill 3: Init, Plan, Apply
tofu initErwartet (gekürzt):
Initializing provider plugins...
- Finding opennebula/opennebula versions matching "1.5.0"...
- Installing opennebula/opennebula v1.5.0...
...
OpenTofu has been successfully initialized!
tofu plan | grep -E 'will be|Plan:'Erwartet:
# opennebula_virtual_machine.notes will be created
Plan: 1 to add, 0 to change, 0 to destroy.
tofu apply -auto-approve | tail -4Erwartet (die IP weicht ab):
Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
Outputs:
ip = "192.168.150.43"
Die Datenbank des OneFlow-Service läuft noch, also verbindet sich die neue VM mit ihr:
IP=$(tofu output -raw ip)
until curl -s -m2 $IP:8080/version; do sleep 3; done; echo
curl -s $IP:8080/notes; echoErwartet (gekürzt):
0.7.1
[{"id":"602722bb-05ab-4559-ac6e-47609ba9ab2b","text":"Hallo OpenNebula"}]
Fortschritt speichern? Kostenlos registrieren
Drill 4: Ändern
Mehr Speicher, im Code:
sed -i 's/memory = 384/memory = 512/' main.tf
tofu plan | grep -E 'will be|memory|Plan:'Erwartet:
# opennebula_virtual_machine.notes will be updated in-place
~ memory = 384 -> 512
Plan: 0 to add, 1 to change, 0 to destroy.
updated in-place: Die VM bleibt dieselbe. Ein
must be replaced an dieser Stelle hieße Löschen und neu
anlegen, und das würdest du vor dem apply sehen.
tofu apply -auto-approve | grep -E 'Modif|complete'
onevm list | grep notes-tfErwartet:
opennebula_virtual_machine.notes: Modifying... [id=40]
opennebula_virtual_machine.notes: Modifications complete after 43s [id=40]
Apply complete! Resources: 0 added, 1 changed, 0 destroyed.
40 oneadmin oneadmin notes-tf runn 0.5 512M localhost 0d 00h02
43 Sekunden: Der Provider hat die VM ausgeschaltet, vergrößert und wieder gestartet, dieselben Schritte wie in Tag 7, nur automatisch.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
tofu state listErwartet:
data.opennebula_image.basis
data.opennebula_virtual_network.intern
data.opennebula_virtual_network.vnet
opennebula_virtual_machine.notes
diff ~/one-lab/tag12/main.tf ~/one-lab/code/loesung/tag12/main.tfErwartet: keine Ausgabe.
Challenge
Was passiert, wenn jemand die VM notes-tf an OpenTofu
vorbei per CLI löscht, und wie bekommst du sie zurück? Räum danach alles
ab, was OpenTofu angelegt hat.
Lösung
onevm terminate --hard notes-tfEine halbe Minute später:
tofu plan | grep -E 'will be|Plan:'Erwartet:
# opennebula_virtual_machine.notes has been deleted
# opennebula_virtual_machine.notes will be created
Plan: 1 to add, 0 to change, 0 to destroy.
OpenTofu vergleicht den State mit der Wirklichkeit, bemerkt die
fehlende VM und legt sie mit apply neu an. Infrastruktur
als Code repariert sich so nicht von selbst, aber jeder
plan zeigt die Abweichung. Abbauen:
tofu apply -auto-approve | grep complete
tofu destroy -auto-approve | tail -1Erwartet (gekürzt):
Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
Destroy complete! Resources: 1 destroyed.
destroy löscht nur, was im State steht. Das Image
notes-basis und die Netze waren nur gelesen
(data) und bleiben.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- State gehört nicht auf den Laptop: Im Team liegt der State in einem gemeinsamen Backend (S3, PostgreSQL, HTTP) mit Sperre, damit nicht zwei Leute gleichzeitig ändern.
- Passwörter:
lab.auto.tfvarsim Klartext ist fürs Lab. Im Betrieb kommen Werte aus Umgebungsvariablen (TF_VAR_db_password) oder einem Tresor wie OpenBao, und der Provider meldet sich mit einem Login-Token an. - Was in Code gehört: Templates, Netze, Security Groups, Gruppen und Quotas lassen sich ebenfalls mit dem Provider beschreiben. Damit wird die ganze Cloud-Konfiguration aus Tag 3 bis 8 versionierbar und reproduzierbar.