cloud-init auf einer frischen Debian- oder Ubuntu-Instanz steuern: user-data, status --wait und sichere Wiederholungsläufe

Ziel

Sicherstellen, dass cloud-init die Konfiguration eines Debian- oder Ubuntu-Cloud-Images abgeschlossen hat, eine user-data-Datei vor dem produktiven Einsatz validieren und sie auf derselben Instanz gefahrlos erneut testen.

Voraussetzungen

Eine Instanz, die von einem Cloud-Image mit installiertem cloud-init gestartet wurde (Standard bei Debian- und Ubuntu-Cloud-/Server-Images); Shell-Zugriff, beim ersten Boot idealerweise über die Konsole des Anbieters, falls user-data das Netzwerk lahmlegt.

Schritte

1. Nach dem Boot jede weitere Automatisierung anhalten, bis das Provisioning abgeschlossen ist: cloud-init status --wait. Die Befehlsreferenz beschreibt --wait als Blockieren, "until cloud-init completes", und der einfache Unterbefehl status meldet, ob cloud-init running, done, disabled oder in einem Fehlerzustand ist; bei einem Absturz lautet der Exit-Code 1, bei behebbaren Fehlern 2.
2. Bei einem Fehler die beiden Logdateien lesen, auf die cloud-init selbst für die Fehlersuche verweist: /var/log/cloud-init.log (detaillierte Ablaufspur der Module) und /var/log/cloud-init-output.log (aufgezeichnete Ausgabe auf stdout/stderr dessen, was cloud-init ausgeführt hat).
3. Vor dem Zuweisen einer neuen user-data-Datei an eine Instanz diese lokal validieren: cloud-init schema --system --annotate. Der Unterbefehl schema kann "Validate cloud-config files using jsonschema"; --system richtet ihn auf die tatsächlich verwendeten user-data statt auf ein Dateiargument, und --annotate markiert die fehlerhaften Zeilen direkt im Text.
4. Um das Provisioning auf einer laufenden Instanz erneut zu testen, statt eine neue zu starten, den Zustand von cloud-init zurücksetzen: cloud-init clean --logs --reboot. Der Unterbefehl clean entfernt cloud-init-Artefakte, "to simulate a clean instance" (um eine saubere Instanz nachzubilden); beim nächsten Boot durchläuft cloud-init alle Phasen wieder so wie beim ersten Mal. --logs löscht zusätzlich die bisherigen Logdateien, damit sich die Ausgabe des neuen Laufs nicht mit der alten vermischt.
5. Nach dem Neustart Schritt 1 wiederholen, um zu bestätigen, dass der neue Lauf abgeschlossen wurde, und bei Auffälligkeiten die neue /var/log/cloud-init.log mit der vorherigen vergleichen (diff).

Erwartetes Ergebnis

cloud-init status --wait kehrt nach dem Provisioning mit Exit-Code 0 zurück, und cloud-init schema --system meldet für die aktiven user-data keine Fehler.

Grenzen und Prüfbasis

cloud-init clean verwirft auf einer Produktivinstanz zwar selbst keine Nutzerdaten, setzt aber die Kennzeichen der Host-Identität zurück, mit denen entschieden wird, ob es sich um den ersten Boot handelt (mit --machine-id zusätzlich /etc/machine-id). Das ist für das Klonen von Golden Images und für Tests gedacht, nicht für den Regelbetrieb; es ist als Laborschritt zu behandeln. --reboot ist nötig, damit der erneute Lauf automatisch startet; ohne diese Option ist stattdessen ein manueller Aufruf von cloud-init init erforderlich.