openstack-CLI verwenden

Installieren Sie den openstack-Client, und führen Sie mit der Datei clouds.yaml oder openrc.sh eines Anwendungs-Credentials Befehle für ein Projekt aus.

Der openstack-Befehlszeilenclient arbeitet über ein Anwendungs-Credential mit Ihrem Projekt. Die Konsole generiert dafür zwei Dateien: clouds.yaml und openrc.sh. Verwenden Sie eine davon.

Voraussetzungen

  • Erstellen Sie im Projekt ein Anwendungs-Credential, und laden Sie clouds.yaml oder openrc.sh herunter. Siehe Anwendungs-Credential erstellen.
  • Für Ihre eigene Verwendung genügt ein persönliches Credential. Für eine CI-Pipeline, auf die andere angewiesen sind, verwenden Sie das Credential eines Dienstkontos, das weiter funktioniert, wenn Personen ausscheiden.
  • Sie benötigen einen Rechner mit Python 3.

Client installieren

openstack-Client installieren
python3 -m venv ~/.venvs/openstack
. ~/.venvs/openstack/bin/activate
pip install python-openstackclient python-octaviaclient python-barbicanclient
openstack --version

Die Befehle installieren den Client in einer virtuellen Python-Umgebung.

clouds.yaml verwenden

Kopieren Sie clouds.yaml in den Ordner, in dem der Client danach sucht, und machen Sie die Datei nur für Sie lesbar:

clouds.yaml installieren
mkdir -p ~/.config/openstack
install -m 600 clouds.yaml ~/.config/openstack/clouds.yaml

Wählen Sie den Cloud-Eintrag aus der Datei aus, der bulutistan heißt:

Cloud auswählen
export OS_CLOUD=bulutistan

Führen Sie Befehle aus:

Befehle ausführen
openstack server list
openstack network list
openstack volume list
openstack loadbalancer list

Anstatt OS_CLOUD zu setzen, können Sie die Cloud mit jedem Befehl übergeben: openstack --os-cloud bulutistan server list. Die Datei legt bereits die Region und die Schnittstelle public fest, sodass Sie sie nicht hinzufügen müssen.

openrc.sh verwenden

Laden Sie die Datei in Ihre Shell, und führen Sie Befehle aus:

openrc.sh laden
. ./openrc.sh
openstack server list

Die Datei setzt die OS_*-Umgebungsvariablen des Credentials. Sie löscht außerdem Projekt- und Benutzervariablen, die eine ältere openrc-Datei in der Shell hinterlassen kann, weil ein Anwendungs-Credential bereits an sein Projekt gebunden ist und eine übrig gebliebene Projekteinstellung die Anmeldung fehlschlagen lässt. Fügen Sie keine OS_PROJECT_*-Variablen hinzu.

Überprüfen

Fordern Sie ein Token an. Der Befehl gibt die ID des Projekts aus, an das das Credential gebunden ist:

Credential prüfen
openstack token issue -c project_id -f value

Wenn der Befehl mit einem Authentifizierungsfehler fehlschlägt, stellen Sie sicher, dass das Credential unter Identität & ZugriffOpenStack-API-Zugriff noch aktiv ist. Siehe Credentials rotieren und widerrufen.

Auf dieser Seite