Der openstack-Kommandozeilen-Client ist das eine Werkzeug, das alle anderen OpenStack-Dienste verbindet. Ob Sie Instanzen starten, Netze verkabeln oder einem Fehler nachgehen – er spricht über eine einheitliche Schnittstelle mit Nova, Neutron, Cinder, Keystone und dem Rest. Ihn flüssig zu beherrschen ist der Unterschied zwischen Raten und Diagnostizieren.

Dieser Leitfaden ist ein praktischer Werkzeugkasten: wie Sie sich authentifizieren, die überall geltende Befehlsgrammatik, die Ausgabe-Tricks, die Skripting mühelos machen, und ein Erstdiagnose-Workflow, wenn etwas hängt. Er ist das Bindegewebe zwischen den anderen Tutorials – vom Anlegen eines Projekts und Benutzers bis zum Starten einer Instanz.

Voraussetzungen

• Zugang zu einer OpenStack-2025.2-Cloud und Zugangsdaten (eine openrc-Datei oder ein clouds.yaml-Eintrag).
• Der installierte Unified Client: pip install python-openstackclient.

Schritt 1: Authentifizieren durch Sourcen der openrc

Jeder Befehl braucht ein Token. Der klassische Weg ist, eine RC-Datei zu sourcen, die die OS_*-Umgebungsvariablen exportiert; Sie werden nach Ihrem Passwort gefragt:

source ~/acme-openrc
openstack token issue

Oder clouds.yaml für mehrere Clouds nutzen

Wenn Sie mehrere Clouds jonglieren, definieren Sie sie einmalig in ~/.config/openstack/clouds.yaml und wählen mit --os-cloud. Das erspart das wiederholte Sourcen von Dateien:

openstack --os-cloud acme server list
export OS_CLOUD=acme   # einen Standard für die Sitzung setzen

Schritt 2: Die Befehlsgrammatik lernen

Fast jeder Befehl folgt dem Muster openstack <objekt> <aktion> [args]. Sobald Sie das verinnerlicht haben, können Sie Befehle erraten, die Sie nie genutzt haben:

openstack server list
openstack server show web-01
openstack server create ...
openstack server delete web-01
openstack network list
openstack volume list
openstack image list

Schritt 3: Ausgabe formatieren und filtern

Die CLI kann Tabellen, reine Werte, JSON oder YAML ausgeben – essenziell fürs Skripting. Nutzen Sie -f für das Format und -c zur Spaltenauswahl:

# Ein einzelner Wert, perfekt für Skripte
openstack server show web-01 -f value -c status

JSON zum Weiterleiten an jq
openstack server list -f json | jq '.[].Name'
Bestimmte Spalten wählen
openstack server list -c Name -c Status -c Networks

Jeden Befehl entdecken

Wenn Sie die genaue Syntax nicht kennen, dokumentiert sich der Client selbst. Listen Sie Befehle auf und lesen Sie die Hilfe je Befehl:

openstack help
openstack server create --help

Schritt 4: Ressourcen tiefgehend prüfen

Das Verb show ist Ihr Mikroskop. Mit Spaltenauswahl kombiniert fördert es genau das Feld zutage, das Sie brauchen – eine Fehlermeldung, eine IP, einen Status:

openstack server show web-01 -c status -c addresses -c fault
openstack network show acme-net
openstack volume show data-vol01 -c status -c attachments

Schritt 5: Ein Erstdiagnose-Workflow

Wenn etwas nicht stimmt, arbeiten Sie vom Symptom nach innen. Diese vier Schritte lösen die meisten alltäglichen Probleme.

Fehler und Status der Instanz lesen

Ist ein Server im Zustand ERROR, verrät das Fault-Feld meist den Grund – kein gültiger Host, Image-Problem, Quota:

openstack server show web-01 -c status -c fault
openstack server event list web-01

Das Konsolen-Log lesen

Bei Boot-Fehlern, SSH-Problemen oder cloud-init-Themen ist das Konsolen-Log die Wahrheit aus dem Inneren der VM:

openstack console log show web-01 | tail -n 40

Dienst- und Agent-Gesundheit prüfen

Schlagen viele Operationen fehl, ist evtl. ein Control-Plane-Dienst oder Agent ausgefallen. Suchen Sie nach allem, was nicht up/enabled ist:

openstack compute service list
openstack network agent list
openstack volume service list

Debug für API-Fehler einschalten

Scheitert ein Befehl mit einem undurchsichtigen Fehler, gibt --debug die vollständige REST-Anfrage und -Antwort aus, inklusive des echten Fehlers des Dienstes:

openstack server create ... --debug 2>&1 | less

Häufige Fehler und Fehlersuche

The request you have made requires authentication

Ihr Token ist abgelaufen oder die RC-Variablen sind nicht gesetzt. Sourcen Sie Ihre openrc erneut und bestätigen Sie mit openstack token issue. Prüfen Sie mit env | grep OS_, was tatsächlich exportiert ist.

Public endpoint for ... not found

Der Client findet einen Dienst nicht im Katalog – oft eine falsche Region oder ein nicht bereitgestellter Dienst. Prüfen Sie mit openstack catalog list und setzen Sie OS_REGION_NAME korrekt.

Could not find resource <name>

Namen sind auf Ihr Projekt bezogen. Bestätigen Sie, dass Sie im richtigen Projekt sind (openstack token issue zeigt den Scope) und dass die Ressource existiert (openstack <objekt> list); nutzen Sie die ID statt des Namens zur Eindeutigkeit.

SSL- oder Zertifikatsfehler

Für ein Labor mit selbstsignierten Zertifikaten verweisen Sie den Client mit OS_CACERT auf das CA-Bundle oder nutzen als letzten Ausweg --insecure – niemals in Produktion.

Ein praktischer Alias und Tab-Vervollständigung

Aktivieren Sie die Shell-Vervollständigung, um weniger Zeit mit dem Tippen von Objekt- und Aktionsnamen zu verbringen:

openstack complete | sudo tee /etc/bash_completion.d/osc.bash
source /etc/bash_completion.d/osc.bash

Fazit

Mit Authentifizierung, der universellen Befehlsgrammatik, Ausgabeformatierung und einer engen Diagnose-Schleife wird die OpenStack-CLI zur Drehscheibe, die jede andere Fähigkeit verbindet – Identität, Compute, Networking und Storage. Beherrschen Sie sie, und der Rest von OpenStack verliert seinen Schrecken.

clouditiv stellt Ihnen genau diese CLI und API auf einer gemanagten, souveränen Cloud bereit – plus ein poliertes Dashboard für die Vorgänge, die Sie lieber klicken als tippen, sodass Teams die Macht der Kommandozeile und den Komfort einer gemanagten Plattform erhalten.