# Zugriff über die Kommandozeile

Alles, was du im [Horizon-Dashboard](https://datalab.tuwien.ac.at/de/infrastructure/openstack/login/) machen kannst, geht auch über die Kommandozeile mit dem
`openstack`-Client. Das ist praktisch für Automatisierung und für Aufgaben, die sich in der GUI mühsam durchklicken.

## Client installieren { #install-the-client }

``` bash
pip install python-openstackclient
```

## Zugangsdaten holen { #get-your-credentials }

1. Geh in Horizon zu **Project → API Access** (manchmal **Compute → Access & Security → API Access**) und klick auf
   **Download OpenStack RC File**.
2. Öffne die heruntergeladene Datei und setz `OS_CLOUD`, oder (bei älteren Setups) lade sie direkt mit `source`:

   ``` bash
   source openrc.sh
   ```

   Gib dein TU-Wien-Passwort ein, wenn du danach gefragt wirst. Die Umgebungsvariablen gelten nur in der aktuellen
   Shell.

!!! note
    Die RC-Datei enthält deine Zugangsdaten im Klartext. Committe sie nicht in ein Repository und gib sie nicht weiter.

## Nützliche Befehle { #useful-commands }

``` bash
openstack flavor list                        # available flavors
openstack image list                         # available images
openstack server list                        # your instances
openstack server create --flavor a1.standard.4 --image ubuntu-noble-24.04 --key-name mykey myvm
openstack server ssh --login ubuntu myvm    # ssh into an instance by name
openstack floating ip create public          # allocate a floating IP
openstack server add floating ip myvm <ip>  # attach it to an instance
openstack server delete myvm
```

Ersetz `<ip>` und `mykey`/`myvm` durch deine eigenen Werte. Die vollständige Befehlsreferenz findest du in der
[offiziellen Dokumentation der OpenStack-CLI](https://datalab.tuwien.ac.at/de/infrastructure/openstack/links/).

## Skripte { #scripting }

Da der Client nur aus Befehlen besteht, kannst du ihn mit einer Shell deiner Wahl skripten. Wenn du deklarative
Infrastruktur bevorzugst, gibt es auch die
[Ansible-Collection `openstack.cloud`](https://docs.ansible.com/ansible/latest/collections/openstack/cloud/index.html).