Cloudcomputing Kurzanleitung - Docker Host: Unterschied zwischen den Versionen

Anleitung
Anleitung
Informationen
Betriebssystem	Alle
Service	Cloudcomputing
Interessant für	Angestellte, Studierende und Gäste
HilfeWiki des ZIM der Uni Paderborn

Version vom 18. Juni 2021, 08:57 Uhr

Cloudcomputing

Allgemeine Informationen

In dieser Anleitung erfahren Sie, wie Sie einen Docker Host auf einer Instanz des Cloudcomputing-Dienstes der Universität erstellen.

Dieser Artikel erfordert grundlegende Erfahrung im Umgang mit Linux.

Was ist zu tun?[Bearbeiten | Quelltext bearbeiten]

eine Ubuntu Instanz erstellen
Docker installieren
ggf. grafische Containerverwaltung einrichten

Erstellen einer Ubuntu Instanz[Bearbeiten | Quelltext bearbeiten]

Zunächst benötigen Sie eine Instanz, auf welcher Sie Docker bereitstellen können - für dieses Tutorial verwenden wir Ubuntu 20.04. An dieser Stelle werden wir nur eine sehr kurze Anleitung zur Erstellung einer Instanz geben - eine ausführlichere Anleitung finden Sie im QuickStartGuide.

Vorraussetzung ist ein vorhandnes Schlüsselpaar! Falls Sie noch kein Schlüsselpaar angelegt haben finden Sie hier eine Anleitung.

1. Erstellen Sie einen Datenträger unter Datenträger/Datenträger mit den folgenden Einstellungen:

2. Legen Sie unter Netzwerk/Sicherheitsgruppen eine neue Sicherheitsgruppe an mit dem Namen Docker an. Erstellen Sie eine neue Sicherheitsregel für den Port des SSH-Dienstes - hier bietet OpenStack bereits eine Standardregel.

Beachten Sie bitte, falls Sie über Docker einen Dienst bereitstellen wollen, dass Sie auch die Ports für diesen Dienst freigeben, um ihn später zu erreichen.

3. Erstellen Sie eine neue Instanz unter Compute/Instanzen über den Button Instanz starten. Vergeben Sie den Namen Ubuntu-20.04-Docker. Als Quelle wählen Sie den zuvor erstellen Datenträger aus. Die Wahl der Variante hängt von Ihren Anforderungen ab - für dieses Tutorial wählen wir medium aus. Falls Sie bereits ein Netzwerk angelegt haben, können Sie die Instanz diesem zuordnen. Unter Sicherheitsgruppen ordnen Sie die zuvor erstellte Sicherheitsgruppe der Instanz zu. Ihr Schlüsselpaar sollte automatisch zur Instanz hinzugefügt worden sein. Klicken Sie anschließend auf Instanz starten.

4. Im Kontextmenü der Instanz können Sie dieser eine Floating IP zuweisen, damit diese von Aussen erreichbar ist.

Docker installieren[Bearbeiten | Quelltext bearbeiten]

Loggen Sie sich auf der erstellten Instanz per SSH ein.

Zunächst muss das System aktualisiert werden. Dazu führen Sie den Befehl sudo apt update && sudo apt upgrade -y aus. Anschließend können Sie Docker mit dem Befehl sudo apt install docker.io -y installieren.

Damit der Dienst gestartet wird müssen Sie ihn mit sudo systemctl enable --now docker aktivieren.

Damit Sie Docker nicht immer mit dem sudo-Befehl ausführen müssen, können Sie ihren Benutzer zur Gruppe docker hinzufügen. Dafür geben Sie den Befehl sudo usermod -aG docker $USER ein. Möchten Sie einen anderen Benutzer als den aktiven Benutzer hinzufügen, tragen Sie diesen anstelle von $USER den Namen des Benutzers ein. Starten Sie anschließend das System mit sudo reboot neu und verbinden Sie sich wieder per SSH.

Die aktuell installierte Docker Version können Sie sich mit dem Befehl docker --version ausgeben lassen.

Um zu überprüfen, ob Docker korrekt installiert wurde, bietet Docker einen Hallo Welt-Container zum testen an. Diesen starten Sie mit den Befehl docker run hello-world. Treten beim starten des Containers keine Fehler auf, ist der Dienst korrekt installiert.

Eine Einführung mit Docker bietet der Getting Started Bereich der Docker Dokumentation.

Grafische Containerverwaltung mit Portainer[Bearbeiten | Quelltext bearbeiten]

Portainer ist eine Open-Source-Management-UI für Docker. Sie erleichtert die Verwaltung von Container, Volumes und Netzwerken in Docker. Portainer wird selbst in einem Docker-Container ausgeführt und ist somit sehr leicht zu installieren.

Erzeugen Sie zunächst ein Volume, in dem Portainer seine Daten ablegen kann: docker volume create portianer_data.

Danach müssten Sie lediglich den Container starten. Beachten Sie bitte, dass die Weboberfläche von Portainer über den Port 9000 bereitgestellt wird. Damit dieser erreichbar wird müssen Sie zunächst eine neue Sicherheitsregel definieren und den Port freigeben - eine Anleitung dazu finden Sie im QuickStartGuide.

docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce

Nun können Sie Portainer über http://[Floating IP]:9000/ aufrufen. Für Floating IP setzten Sie die Floating IP-Adresse ihrer Instanz ein.

Weitere Informationen zur Nutzung von Portainer finden Sie in der Portainer Dokumentation.

Bei Fragen oder Problemen wenden Sie sich bitte telefonisch oder per E-Mail an uns:

Tel. IT: +49 (5251) 60-5544 • Tel. Medien: +49 (5251) 60-2821 • E-Mail: zim@uni-paderborn.de

Das Notebook-Café ist die Benutzerberatung des ZIM - Sie finden uns in Raum I0.401

Wir sind zu folgenden Zeiten erreichbar:

	Mo	Di - Fr
Vor-Ort-Support	Geschlossen	Über die Feiertage geschlossen
Telefonsupport	08:30 - 13:00	Über die Feiertage geschlossen

Das ZIM:Servicecenter Medien auf H1 hat aktuell zu folgenden Zeiten geöffnet:

Mo	Di - Fr
08:00 - 16:00	Über die Feiertage geschlossen

@@ Zeile 8: / Zeile 8: @@
 |marker=Draft
 }}
-Kurzer Einleitungstext
+In dieser Anleitung erfahren Sie, wie Sie einen Docker Host auf einer Instanz des Cloudcomputing-Dienstes der Universität erstellen.
+<bootstrap_alert color=info>Dieser Artikel erfordert grundlegende Erfahrung im Umgang mit Linux.
+</bootstrap_alert>
 == Was ist zu tun? ==
-* Stichpunktartige Auflistung
+* eine Ubuntu Instanz erstellen
-* aller Arbeitsschritte
+* Docker installieren
+* ggf. grafische Containerverwaltung einrichten
-== Schritt-für-Schritt Anleitung ==
+== Erstellen einer Ubuntu Instanz ==
-Jeder Arbeitschritt wird hier genau erklärt und ggf. mit Screenshots hinterlegt.
+Zunächst benötigen Sie eine Instanz, auf welcher Sie Docker bereitstellen können - für dieses Tutorial verwenden wir Ubuntu 20.04.
+An dieser Stelle werden wir nur eine sehr kurze Anleitung zur Erstellung einer Instanz geben - eine ausführlichere Anleitung finden Sie im [https://hilfe.uni-paderborn.de/Cloudcomputing_Quick-Start QuickStartGuide].
-=== Dabei sollten ===
+'''Vorraussetzung ist ein vorhandnes Schlüsselpaar!''' Falls Sie noch kein Schlüsselpaar angelegt haben finden Sie [https://hilfe.uni-paderborn.de/Cloudcomputing_Quick-Start#Schl.C3.BCsselpaare hier] eine Anleitung.
-Unterschritte
-=== in sinnvolle Abschnitte ===
+. Erstellen Sie einen Datenträger unter ''Datenträger/Datenträger'' mit den folgenden Einstellungen:
-unterteilt werden
-=== dazu nutzt man dann ===
+[[Datei:Screenshot_OpenStack_Datentraeger_Docker.png |mini|200px|thumb|none]]
-Überschriften dritter Ordnung
-=== Nebenbei ===
+. Legen Sie unter ''Netzwerk/Sicherheitsgruppen'' eine neue Sicherheitsgruppe an mit dem Namen ''Docker'' an.
-* Hier nochmal der Hinweis auf den Menüpunkt "Mitmachen" links im Hauptmenü, hinter dem sich wertvolle Anleitungen und Hinweise verstecken.
+Erstellen Sie eine neue Sicherheitsregel für den Port des SSH-Dienstes - hier bietet OpenStack bereits eine Standardregel.
-* Erfahrene Redakteure finden unterhalb der "Kategorie:Utility templates" interessantes Handwerkszeug für fortgeschrittene Textmanipulationen.
-== Siehe auch ==
+Beachten Sie bitte, falls Sie über Docker einen Dienst bereitstellen wollen, dass Sie auch die Ports für diesen Dienst freigeben, um ihn später zu erreichen.
-Weitere interessante Artikel zum gleichen Themenfeld verlinken
+. Erstellen Sie eine neue Instanz unter ''Compute/Instanzen'' über den Button ''Instanz starten''. Vergeben Sie den Namen <code>Ubuntu-20.04-Docker</code>. Als Quelle wählen Sie den zuvor erstellen Datenträger aus.
+Die Wahl der ''Variante'' hängt von Ihren Anforderungen ab - für dieses Tutorial wählen wir <code>medium</code> aus.
+Falls Sie bereits ein Netzwerk angelegt haben, können Sie die Instanz diesem zuordnen. Unter ''Sicherheitsgruppen'' ordnen Sie die zuvor erstellte Sicherheitsgruppe der Instanz zu. Ihr Schlüsselpaar sollte automatisch zur Instanz hinzugefügt worden sein. Klicken Sie anschließend auf ''Instanz starten''.
+. Im Kontextmenü der Instanz können Sie dieser eine Floating IP zuweisen, damit diese von Aussen erreichbar ist.
+== Docker installieren  ==
+Loggen Sie sich auf der erstellten Instanz per SSH ein.
+Zunächst muss das System aktualisiert werden. Dazu führen Sie den Befehl <code>sudo apt update && sudo apt upgrade -y</code> aus.
+Anschließend können Sie Docker mit dem Befehl <code>sudo apt install docker.io -y</code> installieren.
+Damit der Dienst gestartet wird müssen Sie ihn mit <code>sudo systemctl enable --now docker</code> aktivieren.
+Damit Sie Docker nicht immer mit dem <code>sudo</code>-Befehl ausführen müssen, können Sie ihren Benutzer zur Gruppe <code>docker</code> hinzufügen.
+Dafür geben Sie den Befehl <code>sudo usermod -aG docker $USER</code> ein. Möchten Sie einen anderen Benutzer als den aktiven Benutzer hinzufügen, tragen Sie diesen anstelle von ''$USER'' den Namen des Benutzers ein. Starten Sie anschließend das System mit <code>sudo reboot</code> neu und verbinden Sie sich wieder per SSH.
+Die aktuell installierte Docker Version können Sie sich mit dem Befehl <code>docker --version</code> ausgeben lassen.
+Um zu überprüfen, ob Docker korrekt installiert wurde, bietet Docker einen ''Hallo Welt''-Container zum testen an.
+Diesen starten Sie mit den Befehl <code>docker run hello-world</code>. Treten beim starten des Containers keine Fehler auf, ist der Dienst korrekt installiert.
+Eine Einführung mit Docker bietet der [https://docs.docker.com/get-started/ Getting Started] Bereich der Docker Dokumentation.
+== Grafische Containerverwaltung mit Portainer ==
+Portainer ist eine Open-Source-Management-UI für Docker. Sie erleichtert die Verwaltung von Container, Volumes und Netzwerken in Docker. Portainer wird selbst in einem
+Docker-Container ausgeführt und ist somit sehr leicht zu installieren.
+Erzeugen Sie zunächst ein Volume, in dem Portainer seine Daten ablegen kann: <code>docker volume create portianer_data</code>.
+Danach müssten Sie lediglich den Container starten. Beachten Sie bitte, dass die Weboberfläche von Portainer über den Port 9000 bereitgestellt wird.
+Damit dieser erreichbar wird müssen Sie zunächst eine neue Sicherheitsregel definieren und den Port freigeben - eine Anleitung dazu finden Sie im [https://hilfe.uni-paderborn.de/Cloudcomputing_Quick-Start#Sicherheitsgruppen QuickStartGuide].
+<source>docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce</source>
+Nun können Sie Portainer über <code>http://[Floating IP]:9000/</code> aufrufen. Für ''Floating IP'' setzten Sie die Floating IP-Adresse ihrer Instanz ein.
+Weitere Informationen zur Nutzung von Portainer finden Sie in der [https://documentation.portainer.io/v2.0/containers/create/ Portainer Dokumentation].