STACKIT CLI installieren und effizient nutzen

Die Nutzung von Cloud-Plattformen ist längst fester Bestandteil der modernen IT. Mit STACKIT bietet die Schwarz Gruppe eine leistungsfähige deutsche Cloud Plattform, die sich zunehmend als Alternative zu den US-Hyperscalern positioniert.
Ähnlich wie die US-Hyperscaler bietet die STACKIT Cloud ebenfalls mehrere Wege, um mit dem Resource Mangager zu interagieren. Hierzu gehören zahlreiche Tools wie zum Beispiel Terraform, eigene SDKs und APIs oder die STACKIT CLI.

In diesem Beitrag zeigen wir, wie Sie die STACKIT CLI installieren, welche Befehle wirklich nützlich sind und warum sich dieses Tool für Cloud Administratoren und DevOps Teams lohnt.

Was ist die STACKIT CLI?

Die STACKIT CLI ist ein Kommandozeilen-Tool zur direkten Steuerung der STACKIT Cloud. Sie ermöglicht es, Ressourcen schnell, wiederholbar und automatisierbar zu verwalten, etwa zur Erstellung von Projekten, zur Bereitstellung von virtuellen Maschinen oder für die Integration in CI/CD-Prozesse. Die STACKIT CLI basiert auf die STACKIT API.

Die STACKIT CLI befindet sich zum Zeitpunkt dieses Blogposts noch in der Beta. Sie bietet Ihnen die Möglichkeit, Services bereitzustellen, die Sie im Web-Portal von STACKIT nicht bereitstellen können (z.B. Application Load Balancer). Auf der anderen Seite unterstützt die STACKIT CLI leider auch noch nicht alle Produkte, die Sie im Web-Portal konfigurieren können (z.B. Cloud Foundry).

Die STACKIT CLI wird als Open-Source Projekt in GitHub geführt:
https://github.com/stackitcloud/stackit-cli/tree/main

Installation der STACKIT CLI:

Windows

1. Zip Datei aus GitHub Release downloaden
   • Auf GitHub das neueste Release der STACKIT CLI öffnen und das passende Windows‑ZIP‑Archiv herunterladen.
2. Binary bereitstellen
   • stackit.exe entpacken und in einen Ordner Ihrer Wahl kopieren (z. B. C:\REWION\).
   • Tipp: Legen Sie stackit.exe in C:\Windows\System32, um die Anwendung systemweit verfügbar zu machen.
3. Umgebungsvariable setzen (Alternative zu System32):
   Nutzen Sie den folgenden Befehl in der PowerShell, um den Pfad der STACKIT CLI für Sie im System zu hinterlegen:

   [Environment]::SetEnvironmentVariable("Path", $Env:Path + ";C:\REWION","User")

4. Starten Sie die PowerShell Instanz neu
5. Prüfen & Nutzen
   Nutzen Sie die folgenden Befehle in der neuen PowerShell Instanz, um zu prüfen, ob die STACKIT CLI korrekt vom System gefunden wird und verwendet werden kann:

   where.exe stackit      # zeigt den Pfad
   stackit --version      # zeigt die installierte Version 

macOS

Unter macOS installieren Sie die STACKIT CLI am einfachsten über Homebrew:

1. Homebrew einrichten
   Falls noch nicht vorhanden, führen Sie im Terminal folgenden Befehl aus, um Homebrew zu installieren:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. STACKIT Tap hinzufügen
   Registrieren Sie das offizielle STACKIT-Repository aus Homebrew:

   brew tap stackitcloud/tap

3. STACKIT CLI installieren
   Installieren Sie die aktuelle Version als Cask—so bleiben auch Profil-Daten erhalten:

   brew install --cask stackit

4. Installation prüfen
   Verifizieren Sie, dass das Programm erreichbar ist und zeigen Sie die installierte Version an:

   which stackit  # zeigt den Pfad
   stackit --version # zeigt die installierte Version

Linux

Für Linux-Systeme stehen mehrere Varianten zur Verfügung. Die beiden meistgenutzten Methoden sind Snap und das Debian/Ubuntu-Repository (APT).

Snap (alle Distributionen)

1. Snap installieren (falls nötig)
   Ubuntu & Co. bringen Snap meist vorinstalliert mit. Ansonsten:

   sudo apt update sudo apt install snapd

2. STACKIT CLI per Snap ausrollen
   Holen Sie sich die aktuellste Version:

   sudo snap install stackit --beta --classic

3. Funktionstest
   Überprüfen Sie die Verfügbarkeit und Version:

   snap list stackit  # zeigt den Pfad
   stackit --version # zeigt die installierte Version

Debian/Ubuntu (APT)

1. Voraussetzungen
   Stellen Sie sicher, dass curl und gnupg installiert sind:

   sudo apt-get update sudo apt-get install curl gnupg

2. STACKIT-Signing-Key importieren
   Laden Sie den öffentlichen Schlüssel herunter und wandeln ihn ins passende Format um:

   curl https://packages.stackit.cloud/keys/key.gpg \ | sudo gpg --dearmor -o /usr/share/keyrings/stackit.gpg

3. Paketquelle hinzufügen
   Fügen Sie das STACKIT-Repository Ihrer Quellenliste hinzu:

   echo "deb [signed-by=/usr/share/keyrings/stackit.gpg] \ https://packages.stackit.cloud/apt/cli stackit main" \ | sudo tee /etc/apt/sources.list.d/stackit.list

4. Installation durchführen
   Aktualisieren Sie die Paketliste und installieren das CLI-Paket:

   sudo apt-get update
   sudo apt-get install stackit

5. Installation testen
   Prüfen Sie, ob der Befehl verfügbar ist und welche Version installiert wurde:

   which stackit  # zeigt den Pfad
   stackit --version # zeigt die installierte Version

Erste Schritte & nützliche Befehle

Nach der Anmeldung per stackit auth login (für Benutzer-Accounts) oder stackit auth activate-service-account (für Service-Accounts) können Sie direkt loslegen. Passen Sie zuerst Ihre Grundeinstellungen an:

1. 1. Projekt festlegen

      stackit config set --project-id <deine-project-id>

   2. Ausgabe-Tiefe einstellen

      stackit config set --verbosity <debug-level>

   3. Weitere Optionen anzeigen

      stackit config set --help
      

   4. Beispiele für die Operative Nutzung
      

      stackit --help #zeigt alle verfügbaren Befehle an 
      stackit server list # zeigt alle virtuellen Maschinen in Ihrem aktuellen Projekt an 
      stackit curl https://iaas.api.eu01.stackit.cloud/v1/projects//servers/ # zeigt das Wartungsfenster einer konkreten STACKIT VM an

Tipp: Für verschiedene Umgebungen (z. B. „Dev“ und „Prod“) legen Sie separate Profile an:

stackit config set --profile dev --project-id 11111111-2222-3333-4444-555555555555
stackit config set --profile prod --project-id 66666666-7777-8888-9999-000000000000