Soverstack CLI_

Command-Line-Interface zur Verwaltung Ihrer souveränen Infrastruktur

Installation

install.sh

curl -sSL https://get.soverstack.io | sh

Typischer Workflow

~/my-cluster

$ soverstack init my-cluster
$ soverstack validate
$ soverstack preflight
$ soverstack plan
$ soverstack apply

Befehle

$ soverstack init [project]

Erzeugt ein neues Projekt (platform.yaml, Inventory-Baum, SSH-Schlüssel, .env-Stubs).

$ soverstack validate [path]

Zod-Schema-Validierung und dateiübergreifende Konsistenz-Checks (offline, kein SSH).

$ soverstack preflight [path]

SSH zu jedem Node (im Rescue-Modus), sammelt Hardware-Fakten, berechnet den Disk-Allokationsplan und persistiert ihn für apply.

$ soverstack plan [path]

Diff zwischen Soll-Zustand (YAML) und aufgezeichnetem Zustand; zeigt die Aktionen, die apply ausführen würde.

$ soverstack apply [path]

Führt die Bootstrap-Pipeline aus (Debian-Reinstall → Bootstrap → Proxmox VE → Netzwerk → Cluster → Ceph) und deployt Services. Benötigt einen aktuellen Preflight-Snapshot.

$ soverstack add region|zone

Fügt eine Region oder Zone zu einem bestehenden Projekt hinzu; aktualisiert Inventory und SSH-Schlüssel.

$ soverstack generate ssh

Generiert oder rotiert SSH-Schlüssel pro Datacenter; alte Schlüssel bleiben in .ssh/.previous/, bis apply die neuen deployt.

Rescue-Modus erforderlich

Soverstack verwaltet das Disk-Layout von Grund auf (RAID1 OS, LUKS-Daten, Ceph OSDs) und muss die Zieldatenträger löschen. Booten Sie jeden Node in den Rescue-Modus Ihres Providers (Hetzner Robot, OVH Manager, Scaleway-Konsole, Latitude.sh-Panel oder USB/IPMI), bevor Sie preflight ausführen. Apply weigert sich, einen Node anzufassen, der auf der installierten Disk gebootet ist.