Zum Inhalt springen
Trainingslager IT-Trainingslager

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 terraform genauso.
  • Der Provider OpenNebula/opennebula übersetzt Ressourcen wie opennebula_virtual_machine in Aufrufe der XML-RPC-API (Tag 13).
  • Der Ablauf ist immer gleich: init lädt den Provider, plan zeigt, was passieren würde, apply setzt es um, destroy rä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.gz

Ubuntu nimmt ~/.local/bin beim nächsten Anmelden in den PATH auf. Melde dich einmal ab und wieder an, dann:

tofu version

Erwartet:

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
}
EOF
  • data-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. Kein sed, kein SKRIPT-Platzhalter mehr.
  • sensitive = true verhindert, 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"
EOF

Fortschritt speichern? Kostenlos registrieren

Drill 3: Init, Plan, Apply

tofu init

Erwartet (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 -4

Erwartet (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; echo

Erwartet (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-tf

Erwartet:

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 list

Erwartet:

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.tf

Erwartet: 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-tf

Eine 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 -1

Erwartet (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.tfvars im 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.