Quelltext der Seite Tutorial: OpenStack CLI auf eigenem Server installieren & nutzen

[[category:fertig]][[category:Webhosting]][[category:FAQ-Webhosting]]
== OpenStack CLI auf eigenem Server installieren & nutzen ==
Da die OpenStack-eigene Horizon-Oberfläche beispielsweise keine direkte Möglichkeit bietet, Snapshots herunterzuladen, besteht die Option, die OpenStack CLI auf einem eigenen Server zu installieren und diese mit unserer API zu verbinden. Über die API können zudem alle Funktionen genutzt werden, die auch über Horizon verfügbar sind.

===Schritt 1: API Zugang aktivieren===
Um den API Zugang zu aktivieren, müssen Sie ein Passwort für diesen anlegen.

[[File:Afstack api activate.png]]
# Ihr API-Username.
# Ihr API-Passwort.
# Ihre Konfigurationsdatei, um auf die API zuzugreifen. <div style="border:1px solid #808080; margin:5px 3px 0px 3px; padding:0 5px 2px 5px; background:#EEEEEE"> '''Hinweis''': Diese wird aber nicht für die CLI verwendet. Stattdessen wird die Konfigurationsdatei in der Openstack-Oberfläche genutzt. Dazu in den nächsten Schritten mehr. </div>
# Hiermit aktivieren Sie den API-Zugang.

===Schritt 2: Konfigurationsdatei herunterladen===

Hierzu müssen Sie sich zuerst in die Horizon-Oberfläche mit dem in Schritt 1 aktivierten API-Zugang einloggen:
[[File:Openstack_login.png]]
Danach müssen Sie einmal oben rechts auf Ihren Benutzernamen ('''1''') und im aufgegangenen Menü auf "Openstack RC Datei"('''2''') klicken, um die Datei herunterzuladen:

[[Datei:Openstackrc.png]]

Diese Datei können Sie erstmal zwischenlagern. Diese wird nämlich im Installationsschritt benötigt.

===Schritt 3: Openstack auf einem Gerät installieren===

* Verzeichnis für die Openstack CLI anlegen:
<syntaxhighlight lang="sh"> mkdir openstack && cd openstack</syntaxhighlight>

* Virtual Environment mit venv erzeugen und aktivieren:
<syntaxhighlight lang="sh"> python3 -m venv venv </syntaxhighlight>
<syntaxhighlight lang="sh"> source venv/bin/activate</syntaxhighlight>

* pip updaten:
<syntaxhighlight lang="sh">pip install --upgrade pip </syntaxhighlight>

* Pakete installieren:
<syntaxhighlight lang="sh">pip install python-openstackclient python-barbicanclient python-cinderclient python-designateclient python-glanceclient python-heatclient python-neutronclient python-novaclient python-octaviaclient </syntaxhighlight>

* Die openrc-Datei, die in Schritt 2 heruntergeladen wurde, in das openstack-Verzeichnis kopieren.

* openrc laden:
<syntaxhighlight lang="sh">source $openrc_dateiname</syntaxhighlight>
:* '''$openrc_dateiname''' ist der Name der heruntergeladenen Konfigurationsdatei. 
* Danach kommt die Ausgabe, bei der Sie das Passwort Ihres API-Zugangs eingeben müssen:
<syntaxhighlight lang="sh">Please enter your OpenStack Password for project stack12345 as user a12345:</syntaxhighlight>

* Serverliste zum Prüfen, ob alles korrekt lief:
<syntaxhighlight lang="sh">openstack server list</syntaxhighlight>
<syntaxhighlight>+-------------------+-------------------+--------+-------------------+-------------------+---------+
| ID                | Name              | Status | Networks          | Image             | Flavor  |
+-------------------+-------------------+--------+-------------------+-------------------+---------+
| d1234c23-1234-123 | supportwiki       | ACTIVE | shared-public-net | N/A (booted from  | a1.xs   |
| 2-abcd-artfiles11 |                   |        |work=192.0.2.161/24,| volume)          |         |
| cd                |                   |        |2001:db8:8893::abc/64|                 |         |
|                   |                   |        |                   |                   |         |
+-------------------+-------------------+--------+-------------------+-------------------+---------+</syntaxhighlight>

* Und nun können Sie die OpenStack CLI auf Ihrem Server verwenden.

== Beispiel: Wie lade ich ein Snapshot herunter? ==
<div style="border:1px solid #808080; margin:5px 3px 0px 3px; padding:0 5px 2px 5px; background:#EEEEEE"> Getestet wurde die Anleitung in '''Ubuntu 22.04''' und '''macOS Sonoma 14.5'''</div>
* Um aus einer VM per Snapshot ein Image zu erstellen, muss man folgenden Befehl ausführen:
<syntaxhighlight lang="sh">nova image-create $instance_name $image_name</syntaxhighlight>
:* '''$instance_name''' ist der Name des Servers, von dem ein Snapshot als Image erstellt werden soll
:* '''$image_name''' ist der Name der neu erstellten Imagedatei, diesen kann man frei wählen.
<syntaxhighlight lang="sh">glance image-download $image_id --file snapshot_name.qcow2</syntaxhighlight>
* Hiermit wird das Image heruntergeladen:
:* '''$image_id''' ist die Image-ID, welche Sie bspw. über den Befehl <code>openstack image list</code> (siehe unten) einsehen können.

* Die Image-ID können Sie sich über die Imageliste anzeigen:
<syntaxhighlight lang="sh">openstack image list</syntaxhighlight>
<syntaxhighlight lang="sh">+--------------------------------------+--------------------------------------+--------+
| ID                                   | Name                                 | Status |
+--------------------------------------+--------------------------------------+--------+
| 123456cc-d123-12df-a3cb-d1234567c1bb | test                                 | active |
+--------------------------------------+--------------------------------------+--------+</syntaxhighlight>