bwCloud SCOPE nutzen

Für dieses Tutorial sind die ersten Schritte Voraussetzung.

Der initiale Zugriff auf Instanzen ist nur mittels SSH möglich. Dieser öffentliche SSH-Key wird beim Erzeugen einer virtuellen Maschine automatisch in das Linux-System eingespielt. Anschließend können Sie sich von außen per SSH auf das System einloggen. Instanzen in der bwCloud können automatisiert gesteuert werden. Mit den folgenden Schritten können Sie Ihre Instanz dafür vorbereiten.

Bitte beachten: Speichern Sie keine personenbezogenen und/oder sensiblen Daten oder Informationen in der bwCloud ab. Wir können kein ausreichendes Schutzniveau anbieten um beispielsweise den Anforderungen der ZENDAS hinsichtlich Datenschutz etc. zu entsprechen.

Schritt 3: SSH-Key Paar erzeugen[ssh_key_gen]

Im folgenden wird der Vorgang zur Erzeugung eines SSH-Key Paares (öffentlicher und geheimer SSH-Key) beschrieben.

1. Für Windows Benutzer mittels PuTTYgen.
2. Für Linux und Mac user.

1. Windows Benutzer mittels PuTTYgen

Erst muss PuTTYgen installiert werden. Mit diesem Programm wird das SSH-Schlüsselpaar erzeugt.

PuTTYgen Installation Laden Sie sich das Programm puttygen.exe herunter.

1. Gehen Sie dazu z.B. auf die Seite putty.org.
2. Klicken Sie auf der Website auf Download Putty.
3. Suchen Sie auf der sich anschließend öffnende Seite nach der Quelle 'puttygen.exe (a RSA and DSA key generation utility)'.
4. Laden Sie das zu Ihrem System passende Programm (64-bit x86 or 64-bit x86) herunter.
5. Starten Sie das Programm/ die Datei puttygen.exe direkt.

SSH-Key Erzeugen Einen SSH-Key Paar erzeugen und in das richtige Format bringen.

1. Wählen Sie folgende Einstellungen: den Type RSA, die Bit-Stärke mindestens 4096 und ein Passwort für den Schlüssel.
2. Klicken Sie auf den Button Generate rechts neben der Beschriftung Generate a public/private key pair.
3. Bewegen Sie die Maus mit unregelmäßigen Bewegungen über den Bildschirm um genügend Entropie für die Schlüsselerzeugung zu generieren. Wenn die Schlüsselerzeugung erfolgreich abgeschlossen wurde, wird Ihnen der öffentliche Schlüssel in einem Textfeld angzeigt.
4. Öffnen Sie einen einfachen Texteditor (z. B. Notepad) und kopieren Sie den erzeugten öffentlichen Schlüssel aus dem Textfeld in den Editor.
5. Veränderen Sie das Format des Schlüssels zu einem Einzeiler. ssh-rsa AAAAB3N...SMQQ== mail@example.com
6. Speichern Sie den öffentlichen Schlüssel in einem Verzeichnis ab.
7. Speichern Sie den privaten Schlüssel im selben Verzeichnis wie zuvor den öffentlichen Schlüssel ab. Klicken Sie dazu auf den Button Save private key.

Schritt-für-Schritt Anleitung und Slideshow ausklappen

• 

  Laden Sie sich das Programm puttygen.exe herunter. Gehen Sie dazu z. B. auf die Seite PuTTY Download Page.

• 

  Klicken Sie auf den Button Generate um mit der Schlüsselgenerierung zu beginnen.

• 

  Bewegen Sie die Maus in unregelmäßigen Bewegungen über den Bildschirm, um die Schlüsselgenerierung mit zufälligen Werten zu unterstützen.

• 

  Nach der erfolgreichen Schlüsselgenerierung wird Ihnen der öffentliche SSH-Key im Textfeld angezeigt (siehe markierter Bereich im Bild). Kopieren Sie diesen Text in ein Textfenster (z.B. in das Programm "Editor" oder "Notepad") und sichern Sie ihn in einem gesonderten Verzeichnis.

• 

  Sichern Sie auch den privaten SSH-Key. Klicken Sie dazu auf den Button Save private key. Speichern Sie den geheimen SSH-Key im gleichen Verzeichnis wie den öffentlichen Schlüssel.

• 

  Sicherung des privaten, geheimen SSH-Keys.

2. Linux und Mac Benutzer

Führen Sie im Terminal den folgenden Befehl aus.

1. Ein Schlüsselpaar wird unter dem Namen myKey erzeugt. ssh-keygen \ -t rsa \ -b 4096 \ -f ~/.ssh/myKey In der Eingabe, tragen sie ein sicheres Passwort ein. Bewahren Sie ihr Passwort gut auf. Ohne dieses können Sie das Schlüsselpaar nicht verwenden. Der öffentliche Schlüssel hat die Dateiendung `.pub`.
2. Stellen Sie sicher, das ander Benutzer nicht auf ihren privaten Schlüssel zugreifen können. chmod 600 ~/.ssh/mykey

⇈ Hoch

Schritt 4: SSH-Key Registrierung[ssh_key]

Sie müssen dafür Ihren persönlichen öffentlichen SSH-Keys in bwCloud registrieren.

1. Loggen Sie sich in die bwCloud ein wie unter Erste Schritte: Schritt 2 beschrieben
2. Klicken Sie unterhalb von Projekt → Compute auf Schlüsselpaare Sie bekommen eine Übersicht mit den von Ihnen (bereits) importierten Schlüsselpaaren angezeigt.
3. Klicken Sie rechts oben auf den Button Schlüsselpaar importieren. Es öffnet sich ein Dialog.
4. Geben Sie Ihrem SSH-Key einen eindeutigen Namen und kopieren Sie in das Textfeld darunter den öffentlichen SSH-Key.
5. Klicken Sie anschließend auf den Button Schlüsselpaar importieren. Wenn der Vorgang erfolgreich war bekommen Sie eine Übersicht mit dem importierten SSH-Key(s) angezeigt.

Schritt-für-Schritt Anleitung und Slideshow ausklappen

• 

  Gehen Sie auf die portal.bw-cloud.org und loggen Sie sich ein. Geben Sie als User Name Ihren eduPersonPrincipalName an. Dieser besteht aus Ihrer Kennung und der Domain Ihrer Heimatorganisation (bsp: KennungXYZ@uni-mannheim.de). Geben Sie als Password das von Ihnen zuvor gesetzte Dienstpasswort ein und klicken Sie auf Connect

• 

  Wenn der Loginvorgang erfolgreich war, dann sehen Sie eine Übersicht mit den den von Ihnen genutzten Ressourcen.

• 

  Klicken Sie unterhalb von Projekt → Compute auf Schlüsselpaar und dann auf Schlüsselpaar importieren.

• 

  Es öffnet sich ein Dialog. Geben Sie Ihrem SSH-Key einen eindeutigen Namen und kopieren Sie in das Textfeld darunter den öffentlichen SSH-Key. Klicken Sie anschließend auf den Button Schlüsselpaar importieren.

• 

  Wenn der Vorgang erfolgreich war bekommen Sie eine Übersicht mit dem importierten SSH-Key(s) angezeigt.

⇈ Hoch

Schritt 5: Eine Instanz starten[launch_instance]

1. Klicken Sie im linken Menü auf Instances. In der neuen Seite klicken sie auf den Button Launch Instance. Es öffnet sich ein Dialog, der Sie Schritt-für-Schritt durch den Vorgang führt.
2. Als erste tragen Sie für die Instanz einen aussagekräftigen Namen ein, z. B. myVM01. Klicken Sie dann unten auf den Button Next.
3. Wählen Sie nun eine Quelle/ Image aus, auf die ihre Instanz basieren soll, z. B. Debian X. Dies geschieht mit einem Klick auf den Pfeil hoch. Im Bereich Allocated wird das ausgewählte Image angezeigt. Wenn Sie diese Auswahl verwerfen möchten, klicken Sie auf den Pfeil runter in der Zeile.
4. Im nächsten Schritt muss das Flavor ausgewählt werden. Sollte Ihre aktuelle Quota zu gering für ein Flavor sein, wird dies durch ein gelbes Warnsymbol dargestellt.
5. Als nächstes wählen Sie das Netzwerk aus. Hier müssen Sie nichts verändern. da die Standardeinstellung meistens ausreicht.
6. Was die Security Group angeht, so müssen Sie idR an dieser Stelle nichts ändern. Anpassungen sind zu späteren Zeitpunkten möglich.
7. Im nächsten Schritt wählen Sie den öffentlichen SSH-Key aus, der in die Instanz integriert werden soll. Dieser Schritt ist sehr wichtig, da ohne einen öffentlichen SSH-Key kein Zugang zur laufenden Instanz möglich ist.
8. Nun klicken Sie auf den Button Launch Instance. Die Instanz wird gestartet.
9. Wenn die Instanz fertig gestartet und eingerichtet ist, wird die IP-Adresse in der Übersicht angezeigt. Unter diser IP-Adresse ist die Instanz erreichbar.

Sie können sich nun per SSH mit der Instanz verbinden. Die entsprechenden SSH-Benutzernamen entnehmen Sie dieser Liste.

Schritt-für-Schritt Anleitung und Slideshow ausklappen

• 

  Nach dem Loginvorgang bekommen Sie eine Übersicht der verfügbaren Quota angezeigt.

• 

  Klicken Sie im linken Menü auf Instances und in der neuen Seite auf den Button Launch Instance.

• 

  Es öffnet sich ein Dialog, der Sie Schritt-für-Schritt durch den Vorgang führt.

• 

  Als erste geben Sie der Instanz einen aussagekräftigen Namen und tragen diesen in das entsprechende Feld ein. Klicken Sie dann unten auf den Button Next oder auf Source* im linken Menü.

• 

  Wählen Sie nun eine Vorlage aus, auf die ihre Instanz basieren soll.

• 

  Im Bereich Allocated wird das ausgewählte Image angezeigt. Momentan ist noch kein Image ausgewählt, weshalb der Bereich leer ist. Um ein Image auszuwählen, klicken Sie auf den Pfeil hoch in der jeweiligen Zeile (rot umrandet). In unserem Beispiel wählen wir das Image "Debian 9" aus.

• 

  Im Bereich Allocated ist nun die Auswahl zu sehen - das Image mit dem Namen "Debian 9". Wenn Sie diese Auswahl verwerfen möchten, klicken Sie auf den Pfeil runter in der Zeile.

• 

  Im nächsten Schritt muss das Flavor ausgewählt werden. Dies geschieht wieder mit einem Klick auf den Pfeil hoch (rot umrandet). Sollte Ihre aktuelle Quota zu gering für ein Flavor sein, wird dies durch ein gelbes Warnsymbol dargestellt.

• 

  Wir haben in unserem Beispiel das Flavor "m1.tiny" ausgewählt.

• 

  Als nächstes wählen Sie das Netzwerk aus. In den allermeisten Fällen müssen Sie hier nichts verändern, da die Standardeinstellung meistens passt.

• 

  Auch was die Security Group angeht, so müssen Sie idR hier nichts ändern.

• 

  Im nächsten Schritt wählen Sie den öffentlichen SSH-Key aus, der in die Instanz integriert werden soll. Dieser Schritt ist sehr wichtig, da ohne einen öffentlichen SSH-Key kein Zugang zur laufenden Instanz möglich ist.

• 

  Nun klicken Sie auf den Button Launch Instance - und die Instanz wird gestartet.

• 

  Die Instanz wird gebaut...

• 

  Die Instanz wird eingerichtet...

• 

  Die Instanz ist fertig gestartet und eingerichtet. Die IP Adressen, unter denen sie erreichbar ist, werden in der Übersicht angezeigt (roter Pfeil). Sie können sich nun per SSH mit der Instanz verbinden.

⇈ Hoch

Schritt 6: SSH-Client einrichten[ssh_client]

Diese Anleitung beschreibt die Vorbereitung, um mit den zuvor erzeugten öffentlichen und privaten SSH-Keys auf die virtuellen Maschinen zu gelangen.

1. Für Windows Benutzer mittels PuTTY.
2. Für Linux und Mac user.

1. Windows Benutzer mittels PuTTY

Der SSH-Client PuTTY ist ein einfaches und kostenfreies Programm, um unter Windows per SSH Zugriff auf die gestarteten Instanzen zu bekommen.

PuTTY Installation Laden Sie sich das ProgrammPuTTY herunter. Dafür gibt es zwei Möglichkeiten.

1. Gehen Sie dazu z. B. auf zentrale Seite putty.org und klicken dort auf den Link Download PuTTY.
2. Die sich anschließend öffnende Seite verweist auf die Quellen.
3. Möglichkeit bei der Quelle *'MSI (Windows Installer)'*:
   1. Speichern Sie den entsprechenden Installer für Ihr System (häufig 64-bit x86) ab.
   2. Starten Sie den Installationsprozess.
   3. Starten Sie das Programm PuTTY.
   Möglichkeit bei der Quelle *'putty.exe (the SSH and Telnet client itself)'*:
   1. Speichern Sie den entsprechenden Installer für Ihr System (64-bit x86 oder 64-bit x86) ab.
   2. Starten Sie das Programm/ die Datei putty.exe direkt.

PuTTY Einrichtung

1. PuTTY starten.
2. Klicken Sie im linken Menübaum auf die Punkte Connection → SSH → Auth.
3. Klicken Sie nun auf den Button Browser unterhalb des Textes Private key file for authentication. Wählen Sie nun die Datei mit Ihrem privaten SSH-Key aus.
4. Wenn Sie diesen Vorgang nicht jedes Mal erneut durchführen wollen, dann empfehlen wir Ihnen die aktuellen Einstellungen von PuTTY als Profil abzuspeichern. Klicken Sie dazu im linken Menübaum auf den obersten Punkt Session.
5. Benennen Sie nun die aktuellen Einstellungen (und Session) entweder mit einem eigenen Namen und/oder klicken Sie auf den Button Save.
6. Starten Sie nun PuTTY neu. Der zuvor ausgewählte geheime SSH-Key ist wieder ausgewählt.

Schritt-für-Schritt Anleitung und Slideshow ausklappen

• 

  Laden Sie sich das Programm putty.exe herunter. Gehen Sie dazu z. B. auf die Seite PuTTY Download Page

• 

  Klicken Sie im linken Menübaum auf Connection → SSH → Auth um den geheimen privaten SSH-Key aufwählen zu können.

• 

  Klicken Sie auf den Button Browse und wählen Sie den zuvor abgespeicherten privaten SSH-Key aus.

• 

  Im Textfeld neben dem Button Browse sollte sich nun der komplette Pfad zu der Datei mit dem privaten geheimen SSH-Key befinden.

• 

  Wenn Sie diese Einstellungen dauerhaft nutzen und sichern wollen, klicken Sie im linken Menübaum auf den obersten Punkt Session. Wenn Sie der Session einen eigenen Namen geben wollen, tragen Sie diesen im Textfeld unterhalb der Beschriftung Saved Sessions ein. Klicken Sie anschließend auf den Button Save um die Einstellungen abzuspeichern.

2. Linux und Mac Benutzer

1. Fügen Sie den folgenden Inhalt in Ihre SSH-Konfigurationsdatei ~/.ssh/config ein. Erzeugen die Datei, falls diese bisher nicht existiert. Host myVM01 HostName <IP> User debian IdentityFile ~/.ssh/myKey Ersetzen Sie <IP> durch die IP-Adresse Ihrer Instanz.

⇈ Hoch

Schritt 7: SSH-Verbindung aufbauen[ssh_connection]

Sie können sich nun via SSH mit der Instanz verbinden.

1. Für Windows Benutzer mittels PuTTYgen.
2. Für Linux und Mac user.

1. Windows Benutzer mittels PuTTY

1. Öffnen Sie PuTTY. Tragen Sie die IP-Adresse ihrer Instanz ein.
2. Klicken Sie auf Verbinden.
3. Ein Terminal-Fenster öffnet sich. Darin sehen Sie den (grünen) Debian-Prompt der Remote-Instanz.

2. Linux und Mac Benutzer

1. Führen Sie den folgenden Befehl aus. ssh myVM01
2. In dem Terminal-Fenster erscheint der (grünen) Debian-Prompt der Remote-Instanz.

⇈ Hoch

Schritt 8: Instanz mit Ansible einrichten[nutzen_auto_methode]

Um Ihre Standardinstanz zu steuern und anzupassen, sollten Sie automatisierte Methoden verwenden.

1. Erzeugen Sie einen Zugangstoken/ Application Credential, wie in unseren FAQ definiert. Diesen brauchen Sie im folgenden, für unser Ansible-Template.
2. In unserem Wiki sind erprobte Methoden zur Automatisierung gelistet. Nutzen Sie das dort angegebene Ansible-Template. Folgen Sie den dort beschriebenen Schritten.

⇈ Hoch

Schritt 9: Port für Zugriff öffnen[open_port]

Eine neue virtuelle Maschine in der bwCloud ist per Standard zunächst nur per SSH (Port 22) von außen erreichbar. Dies ist definiert in der zugewiesenen Sicherheitsgruppe, z. B. default. Alle anderen Ports sind geschlossen, d.h. Anfragen auf diesen Ports kommen nicht durch. Einige Informationen zur Sicherheit mit offenen Ports sind im FAQ aufgeführt.
Sobald sich die Regeln einer Sicherheitsgruppe ändern, werden diese Änderungen für alle damit verbundenen Instanzen wirksam. Die virtuellen Maschinen müssen also nicht erneut gebootet werden.

Beispiel:

• Ein Webserver soll über HTTPS erreichbar sein. Der entsprechende Port 443 muss in der Sicherheitsgruppe/ Security Group geöffnet werden.

Die Schritt-für-Schritt-Anleitung erklärt detailliert, wie ein Port mithilfe des Dashboards geöffnet werden kann.

1. Klicken Sie im linken Menü auf Network und auf den Unterpunkt Security Groups. Sie bekommen eine Übersicht über die aktuell definierten Sicherheitsgruppen. Die Standardgruppe trägt den Namen default.
2. Klicken Sie in der entsprechenden Zeile auf den Button Manage Rules. Es öffnet sich eine Übersicht über alle zu dieser Sicherheitsgruppe definierten Regeln.
3. Wenn Sie eine neue Regel hinzufügen möchten, klicken Sie auf den Button Add Rule. Es öffnet sich ein Dialog, in dem Sie die neue Regel beschreiben können.
4. Zwei gleichartige Möglichkeiten aus dem im Dropdown-Menü sind:
   • Wählen Sie den Punkt Rule den Eintrag HTTPS aus.
   • Wählen Sie den Punkt Custom TCP Rule aus. Im Feld Port tragen Sie Portnummer 443 ein.
5. Ihr Server sollte nicht von überall außen erreichbar sein. Der Eintrag in dem Feld CIDR beschränkt den Zugriff auf ein bestimmtes Netzsegment. Tragen Sie dort die zu erlaubenden IP-Adressen ein.
6. Im Feld "Direction" kann die Richtung festgelegt werden:
   • Ingress = Eingehende Verbindungen
   • Egress = Ausgehende Verbindungen
7. Klicken Sie auf Add und die neue Regel wird angelegt. Die Übersicht wird erneut geladen und die neue Regel erscheint in der Liste.

Schritt-für-Schritt Anleitung und Slideshow ausklappen

• 

  Nach dem Loginvorgang bekommen Sie eine Übersicht der verfügbaren Quota angezeigt.

• 

  Klicken Sie im linken Menü auf Network und auf den Unterpunkt Security Groups.

• 

  Klicken Sie in der entsprechenden Zeile auf den Button Manage Rules. Die Standardgruppe trägt den Namen default.

• 

  Wenn Sie eine neue Regel hinzufügen möchten, klicken Sie auf den Button Add Rule.

• 

  Wenn beispielsweise der Zugriff via HTTPS erlaubt werden soll, wählen Sie im Dropdown-Menü des ersten Punktes ("Rule") den Eintrag HTTPS.

• 

  Klicken Sie anschließend auf Add. Die Übersicht wird erneut geladen und die neue Regel erscheint in der Liste.

• 

  Soll eine individueller Port geöffnet werden, wählen Sie im Dialog unter "Rule" den Wert Custom TCP Rule aus. Im Feld "Port" können Sie die entsprechende Portnummer eintragen. Im Feld "CIDR" können Sie den Zugriff auf einzelne Netzsegmente einstellen. Im Feld "Direction" kann die Richtung festgelegt werden:

• 

  Die Übersicht wird erneut geladen und die neue Regel erscheint in der Liste

⇈ Hoch