# Eine virtuelle Maschine erstellen

Diese Anleitung führt dich durch das Erstellen deiner ersten virtuellen Maschine (Instance) im OpenStack-Dashboard
([Horizon](https://datalab.tuwien.ac.at/de/infrastructure/openstack/login/)). Wenn du deinen Zugang noch nicht eingerichtet hast, lies zuerst [Anmelden](https://datalab.tuwien.ac.at/de/infrastructure/openstack/login/) und
[Ein Projekt anlegen](https://datalab.tuwien.ac.at/de/infrastructure/openstack/creating-a-project/).

## Schritt 1: SSH-Keypair hinzufügen { #step-1-add-an-ssh-key-pair }

Du brauchst ein SSH-Keypair, um dich bei deiner VM anzumelden. Wenn du schon eines hast, das du verwenden willst, spring
zu „Public Key importieren“. Sonst erzeugst du ein neues:

``` bash
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
```

Das erstellt einen Public Key (`~/.ssh/id_ed25519.pub`) und einen Private Key (`~/.ssh/id_ed25519`). Bewahr den
Private Key sicher auf und gib ihn niemals weiter.

Jetzt in Horizon:

1. Geh zu **Project → Compute → Key Pairs** und klick auf **Create Key Pair**.
2. Entweder **erstellst du ein neues Keypair** (Horizon lädt dann den Private Key für dich herunter) oder du
   **importierst deinen Public Key**:

   ``` bash
   cat ~/.ssh/id_ed25519.pub
   ```

   Füg die Ausgabe in das Feld **Public Key** ein.

!!! danger
    Wenn du ein Keypair über Horizon erstellst und den heruntergeladenen Private Key vor der ersten Nutzung verlierst,
    kannst du dich nicht bei der Instance anmelden. Bewahr eine Kopie an einem sicheren Ort auf.

## Schritt 2: Die nötigen Ports öffnen { #step-2-open-the-relevant-ports }

Standardmäßig erlaubt die Security Group `default` **keinen eingehenden Traffic**. Damit du deine Instance von außen
erreichst, musst du Regeln für die nötigen Ports (zum Beispiel SSH) zur Default-Gruppe hinzufügen oder eine zusätzliche
Security Group zuweisen. Siehe [Netzwerk](https://datalab.tuwien.ac.at/de/infrastructure/openstack/networking/#security-groups).

## Schritt 3: Eine Instance starten { #step-3-boot-an-instance }

1. Geh zu **Project → Compute → Instances** und klick auf **Launch Instance**.
2. Gib der Instance einen **Name**.
3. **Source**: Wähle ein [Image](https://datalab.tuwien.ac.at/de/infrastructure/openstack/images/). (Optional: Wähl hier mit **Create New Volume** eine größere Disk, wenn die
   Standard-Disk des Images zu klein ist.)
4. **Flavor**: Wähle einen [Flavor](https://datalab.tuwien.ac.at/de/infrastructure/openstack/flavors/). Mit dem Pfeil klappst du die Größenoptionen auf.
5. **Networks**: Wähle das Netzwerk, das angehängt werden soll. Das Netzwerk `default`/`private` ist meist automatisch
   ausgewählt.
6. **Security Groups**: Die Default-Gruppe ist ausgewählt. Füg alle zusätzlichen Gruppen hinzu, die du in Schritt 2
   vorbereitet hast.
7. **Key Pair**: Wähle das Keypair aus Schritt 1. **Das ist Pflicht**, ohne Keypair kannst du dich nicht anmelden.
8. Klick auf **Launch Instance**.

Nach ein paar Minuten erscheint die Instance unter **Instances** mit dem Status „Running“.

## Schritt 4: Eine Floating IP zuweisen { #step-4-assign-a-floating-ip }

Eine Instance in einem privaten Netzwerk hat standardmäßig keine öffentliche Adresse. Damit du sie von außen erreichst,
reservierst du eine Floating IP und verknüpfst sie mit der Instance:

1. Geh zu **Project → Network → Floating IPs** und klick auf **Allocate IP to Project**.
2. Wähle das öffentliche Netzwerk (z. B. `public`) und klick auf **Allocate IP**.
3. Klick neben der neuen IP auf **Associate** und wähle deine Instance.

!!! note
    Floating IPs sind begrenzt. Jede bekommt einen DNS-Eintrag (siehe [Netzwerk](https://datalab.tuwien.ac.at/de/infrastructure/openstack/networking/#dns)). Gib sie wieder
    frei, wenn du sie nicht mehr brauchst.

## Schritt 5: Anmelden { #step-5-log-in }

Der Login-User hängt vom gewählten [Image](https://datalab.tuwien.ac.at/de/infrastructure/openstack/images/) ab, zum Beispiel `ubuntu` für Ubuntu, `cloud-user`/`rocky` für
Rocky oder `admin` für Debian-kompatible Images:

``` bash
ssh ubuntu@<floating ip>
```

Beim ersten Login wird das Keypair aus Schritt 1 verwendet, du brauchst also kein Passwort.

## Nächste Schritte { #next-steps }

- [Ein Volume einbinden oder persistenten Speicher hinzufügen](https://datalab.tuwien.ac.at/de/infrastructure/openstack/storage/).
- [Ein privates Netzwerk oder einen Router anlegen](https://datalab.tuwien.ac.at/de/infrastructure/openstack/networking/).
- [Deine VM über die Kommandozeile steuern](https://datalab.tuwien.ac.at/de/infrastructure/openstack/cli/).