Zum Inhalt springen
Beta

Coriolis STACKIT Installer

Zuletzt aktualisiert am

Der Coriolis STACKIT Installer stellt eine Cloudbase Coriolis Appliance auf STACKIT bereit und unterstützt ihre Wartung. Für die Bereitstellung validiert ein einzelnes Go-Binary das OVA und die Zielplatzierung, bereitet ein wiederverwendbares STACKIT-Image vor, stellt die Laufzeitinfrastruktur bereit und konfiguriert den Zugriff ohne Terraform, STACKIT CLI, serielle Konsole oder manuelle Schritte in der WebConsole.

Dieses Asset deckt Bereitstellung, wiederholbare Provisionierung, Statusprüfungen und ausdrücklich freigegebene In-place-Service-Updates mit verpflichtenden Volume-Snapshots ab. Die Wartung erfolgt auf der bestehenden VM über STACKIT Server Agent und Run Command, ohne manuelle SSH- oder Konsolenanmeldung. Cloudbase Coriolis stellt nach der erfolgreichen Bereitstellung die eigentlichen Migrations- und Disaster-Recovery-Funktionen bereit.

Cloud Framework Cloudbase Coriolis Informieren Sie sich über die Migrations-, Replikations- und Disaster-Recovery-Funktionen des bereitgestellten Produkts. Seite öffnen
  • OVA-Prüfung und Platzierungsvalidierung: Liest OVF-Metadaten, berechnet den SHA-256-Hash des OVA und lehnt ungeeignete Disk-Größen, Availability Zones oder Machine Types vor dem Image-Upload ab.
  • Image-Normalisierung: Überträgt die VMDK auf eine temporäre STACKIT-Hilfs-VM, konvertiert sie über RAW nach QCOW2, installiert den STACKIT Server Agent offline und importiert ein wiederverwendbares Image.
  • Image-Wiederverwendung und -Freigabe: Findet normalisierte Images anhand des OVA-Hashs, setzt unterbrochene Importe fort und unterstützt projektbezogene, organisationsweite oder zentrale Image-Projekte.
  • STACKIT-Infrastruktur: Erstellt oder verwendet Netzwerk, Security Group, Appliance-VM, Public IP, DNS-Record und unterstützende Ressourcen anhand deklarativer YAML-Einstellungen.
  • Bootstrap und Erreichbarkeit: Konfiguriert Hostname und Appliance-Administratorkennwort über Run Command und stellt anschließend direktes HTTPS mit ACME DNS-01 oder optional eine TLS-Terminierung über einen STACKIT Application Load Balancer bereit.
  • Wiederholbare Ausführung: Verwendet passende Infrastruktur, generierte Zugangsdaten und gültige Zertifikate bei Folgeläufen erneut und liefert ein strukturiertes JSON-Ergebnis für nachgelagerte Automatisierung.
  • Status und Versionssuche: Meldet installierte Release, Container-Zustand, Speicherbelegung, aktive Ausführungen und aktivierte Zeitpläne. Ermittelt veröffentlichte Releases und prüft die Verfügbarkeit der benötigten Komponenten-Images für neuere Ziele im selben Release-Stream.
  • Freigegebene Service-Updates: Verlangt eine ausdrückliche Planfreigabe und ein exklusives Wartungsfenster. Stoppt Appliance-Dienste und VM, erstellt kalte Snapshots aller angeschlossenen Volumes, startet dieselbe VM erneut und führt das Service-Update aus. Eine persistente Statusdatei ermöglicht die Überwachung und unabhängige Prüfungen von Zielversion, Datenbestand, Konfiguration und TLS.

Typische Eingaben für die Bereitstellung sind:

  • ein STACKIT Service-Account-Key und die ID des Zielprojekts;
  • die STACKIT-Zielregion;
  • ein unterstütztes Cloudbase-Coriolis-OVA;
  • eine YAML-Konfiguration auf Basis des Repository-Beispiels.

Das erfolgreiche Bereitstellungsergebnis enthält das ermittelte Image, Netzwerk, Server, Security Group, Public IP und die Anmeldedaten als JSON. Wenn die Ausgabe eines generierten Appliance-Kennworts aktiviert ist, leiten Sie stdout direkt an einen geschützten Secret Store weiter, statt die Ausgabe in Terminal- oder Build-Logs aufzubewahren.

Die Wartung verwendet Projekt, Region und Zugangsdaten derselben Konfiguration und wählt eine bestehende Appliance anhand der Server-ID aus; ein OVA ist nicht erforderlich. Statusprüfung, Versionssuche und Update-Planung liefern JSON. Bewahren Sie die Update-Statusdatei geschützt auf persistentem Speicher auf, bis der Versuch vollständig geprüft ist.

Für eine neue Bereitstellung:

  1. Erstellen Sie das Binary mit make check oder verwenden Sie ein geeignetes vorkompiliertes Binary, sobald eines verfügbar ist.
  2. Kopieren Sie die Beispiel-YAML-Datei, ergänzen Sie projektspezifische Werte und schützen Sie den Service-Account-Key sowie fest vorgegebene Kennwörter.
  3. Führen Sie --dry-run aus, um Konfiguration, OVA-Metadaten, Dimensionierung und den aufgelösten Bereitstellungsplan ohne Cloud-Änderungen zu prüfen.
  4. Führen Sie --check-cloud aus, um Authentifizierung, Platzierung und optionalen DNS- oder Load-Balancer-Zugriff zu prüfen, und validieren Sie Quotas separat.
  5. Starten Sie die Bereitstellung, speichern Sie das JSON-Ergebnis sicher und wiederholen Sie denselben Befehl, um die Wiederverwendung der Ressourcen zu bestätigen.

Verwenden Sie die bestehende Deployment-Konfiguration und wählen Sie die Appliance ausdrücklich aus:

Terminal-Fenster
CONFIG="config.local.yaml"
SERVER_ID="<appliance-server-id>"
bin/coriolis-stackit status --config "$CONFIG" --server-id "$SERVER_ID"
bin/coriolis-stackit versions --config "$CONFIG" --server-id "$SERVER_ID"
bin/coriolis-stackit update --config "$CONFIG" \
--server-id "$SERVER_ID" --latest-compatible

--latest-compatible wählt das neueste geeignete Ziel im installierten YYMM-Release-Stream, nicht die neueste Release über alle Streams hinweg. Alternativ planen Sie mit einer numerischen --target-version. Der wörtliche Wert latest wird nicht unterstützt. Prüfen Sie die Release Notes, die numerische target_version des Plans, die Snapshot-Volumes und den Wert approval. Eine fehlgeschlagene Versionsabfrage bedeutet nicht, dass die Appliance aktuell ist.

Planen Sie vor der Ausführung ein Wartungsfenster mit Ausfallzeit ein. Lassen Sie Ausführungen aller Mandanten abschließen, deaktivieren Sie sämtliche Transfer-Zeitpläne und verhindern Sie neue Aufträge durch Benutzer, Automatisierung und Worker. Appliance und Paketmanager müssen bereit sein; die geprüften Dateisysteme müssen unter 80 % belegt sein.

Führen Sie das geprüfte numerische Ziel mit einer neuen persistenten Statusdatei je Versuch aus:

Terminal-Fenster
TARGET_VERSION="<numeric-target-from-plan>"
STATE_FILE="<new-persistent-status-file.json>"
bin/coriolis-stackit update --config "$CONFIG" \
--server-id "$SERVER_ID" --target-version "$TARGET_VERSION" \
--apply --approve-plan "<approval-from-reviewed-plan>" \
--confirm-server-id "$SERVER_ID" --state-file "$STATE_FILE"
bin/coriolis-stackit update-status --config "$CONFIG" \
--server-id "$SERVER_ID" --state-file "$STATE_FILE"

Ohne --apply stoppt die Planung keine Dienste, erstellt keine Snapshots und führt kein Update aus. Bei der Ausführung entstehen neue native STACKIT-Snapshots aller angeschlossenen Volumes einschließlich Boot-Volume, während die VM gestoppt ist. Erst wenn alle Snapshots verfügbar sind, startet die VM erneut. Die Snapshots sind verpflichtend und bleiben erhalten; VM und Boot-Volume werden nicht ersetzt.

Lassen Sie die CLI bis zur Rückkehr von update --apply verbunden. Ein erfolgreicher Aufruf bestätigt den Start des Updaters, nicht den Abschluss. Wiederholen Sie update-status mit derselben Datei bis stage: verified und führen Sie danach einen repräsentativen Funktionstest durch, bevor Sie den Normalbetrieb freigeben. Eine fehlgeschlagene Verifikation muss untersucht werden; wiederholen Sie nicht ungeprüft --apply und entfernen Sie keine Wartungssperre.

  • Bedienrechner: Benötigt das Installer-Binary, Lesezugriff auf das OVA, ausgehendes HTTPS zu den STACKIT APIs und während eines neuen Image-Imports temporär ausgehendes TCP/22 zur Hilfs-VM. Zum Bauen aus dem Quellcode ist Go 1.25 oder neuer erforderlich.
  • Service-Account-Berechtigungen: Die automatische Aktivierung von Run Command erfordert die Rolle Project Editor. Der gewählte Ablauf benötigt außerdem Lese- und Schreibzugriff auf die verwendeten IaaS-, Server-Agent-, DNS- sowie optionalen Load-Balancer- und Zertifikatsressourcen.
  • Quota und Konnektivität: Der erste Import verwendet zusätzlich zum finalen Image und den Appliance-Ressourcen temporär eine Hilfs-VM, zwei Datenvolumes, eine Public IP, eine Security Group und ein Keypair.
  • OVA-Format: Das OVA muss TAR-basiert sein und genau eine OVF-Datei sowie eine referenzierte virtuelle Disk enthalten. Der Installer unterstützt derzeit eine Appliance-Disk.
  • Storage-Performance: Der dokumentierte Standard verwendet storage_premium_perf12 für Appliance- und Normalisierungsvolumes, da Konvertierung, Image-Upload, Migration und Backup anhaltende I/O-Last erzeugen.
  • Wartungszugriff: Bestehende Appliances benötigen einen funktionsfähigen Server Agent und einen bereits aktivierten Run-Command-Service. Updates erfordern zusätzlich Rechte für Server-Stopp/-Start und Volume-Snapshots, Snapshot-Quota sowie Zugriff auf Release Notes und benötigte Images. Das ursprüngliche OVA wird für die Wartung nicht benötigt.
  • Die Security Group der Appliance öffnet standardmäßig nur TCP/443. Der STACKIT Server Agent nutzt einen ausgehenden Managementkanal und benötigt keine Ingress-Regel.
  • Ein neuer OVA-Import erlaubt temporär TCP/22 von 0.0.0.0/0 zur Hilfs-VM. Der Zugriff erfordert einen einmaligen Schlüssel und einen über den Server Agent verifizierten Hostkey. Wiederholen Sie nach einem fehlgeschlagenen Import zeitnah den Lauf oder bereinigen Sie verbliebene Hilfsressourcen.
  • Bei direktem TLS verbleibt der private Schlüssel auf der Appliance. Der optionale Application Load Balancer deckt nur den HTTPS-Webpfad ab und leitet nicht jede Coriolis-Migrations- oder Worker-Verbindung weiter.
  • Vorhandene Server, fehlerhafte VMs, Security-Group-Regeln und lizenzierter Appliance-Zustand werden niemals implizit gelöscht oder ersetzt.
  • Update-Snapshots sichern die Appliance-Volumes, nicht externe Datenbanken, Worker oder entfernte Quell- und Zielsysteme. Halten Sie für den Produktivbetrieb ein unabhängiges Backup und einen getesteten Wiederherstellungsplan vor.
  • Es gibt keinen automatischen Rollback. Bewahren Sie Statusdatei und Snapshots für die Wiederherstellung auf; laufende Container oder eine erreichbare Weboberfläche allein ersetzen keine funktionale Abnahme.
  • Service-Updates unterstützen nur neuere numerische Releases im installierten YYMM-Stream, keine Stream-Wechsel, Downgrades oder Neuinstallationen. Technische Eignung ersetzt nicht die Abstimmung des unterstützten Upgrade-Pfads mit Cloudbase.
  • Ein Service-Update enthält nicht zwingend alle Betriebssystemänderungen eines neueren OVA. Der Installer überträgt keine Lizenzen, Projekte, Endpoints, Transferzustände oder Anwendungsdaten auf eine andere Appliance.
  • Ein neues OVA erzeugt ein neues normalisiertes Image, ersetzt aber niemals automatisch einen vorhandenen zustandsbehafteten Server.
  • --check-cloud prüft Zugriff und Platzierung, reserviert jedoch keine Ressourcen und ersetzt keine vollständige Quota-Prüfung.
  • Bei der Übernahme eines vorhandenen Servers können aktivierte Verwaltungsfunktionen Hostname, Administratorkennwort oder TLS-Konfiguration ändern. Sichern Sie eine lizenzierte Produktiv-Appliance vor der ersten Übernahme.