Quelltext der Seite Tutorial: Wie erstelle ich einen Container per SSH?

[[category:ueberarbeiten]][[category:FAQ-Webhosting]]

'''Dieser Artikel befindet sich zur Zeit in Bearbeitung'''

== Container per SSH erstellen ==
=== Schritt 1: Container-Funktion aktivieren ===

[[Datei:Containeraktivieren.png]]
Wenn Sie im DCP zum Container-Feature unter "Webspace" -> "Container" gehen, werden Sie sehen, dass das Feature erst im Haupt-FTP-User aktiviert werden muss, bevor man das ganze überhaupt nutzen kann.  
Das können Sie tun, indem Sie dort auf den Link "FTP-Benutzer-Verwaltung" klicken und in der FTP-User-Übersicht auf Ihren Hauptaccount klicken. Dieser besteht in der Regel aus einem kleinen "a" und einer fünfstelligen Zahlenfolge und ist auch der Benutzername für das DCP, bpsw. a12345.

[[Datei:Containeraktiverenpart2.png]]
#Wenn Sie im richtigen FTP-User sind, sollten Sie an dieser Stelle ('''1''') die Container-Funktion aktivieren können. Ggfs. können Sie hier zusätzlich prüfen, ob die anderen Settings ("Aktiv" & "SSH") auch auf aktiv gestellt sind.
#Klicken Sie zum Schluss auf den Button "Übernehmen"('''2'''), damit die Einstellungen gespeichert werden.

=== Schritt 2: Per SSH mit dem Server verbinden ===

Zuerst müssen Sie sich mit dem Hauptuser per SSH auf dem Server anmelden. Nur der Hauptuser ist berechtigt, die Container zu verwalten. 
(DCP-User können die Container-Funktion vorerst nicht verwenden)
Wie Sie sich per SSH mit dem Server verbinden können, finden Sie hier: https://support.artfiles.de/Tutorial:_SSH-Zugang_nutzen

=== Schritt 3: Image raussuchen, welches man installieren möchte ===

Im [https://hub.docker.com/ Docker Hub] können Sie nach Ihrem gewünschten Image suchen und dementsprechend bei uns installieren.
Alternativ können Sie per SSH direkt auf dem Server nach dem gewünschten Image suchen mit <br>
<syntaxhighlight lang="sh">docker search --filter is-official=true *NameDerGesuchtenImage*</syntaxhighlight>

Im Beispiel von "NextCloud" würde das so aussehen:<br>
<syntaxhighlight lang="sh">docker search --filter is-official=true nextcloud</syntaxhighlight>

Falls Sie hier nicht die standardmäßig letzte Version installieren möchten, können Sie mit diesem Befehl nach dem korrekten Tag suchen.:<br>
<syntaxhighlight lang="sh">docker search --list-tags VollständigerImageName</syntaxhighlight>

Im Beispiel von "NextCloud" würde das so aussehen:<br>
<syntaxhighlight lang="sh">docker search --list-tags docker.io/library/nextcloud</syntaxhighlight>

Für die Image-Installation können Sie über [https://hub.docker.com/ Docker Hub] ggfs. weitere Informationen bzgl. Umgebungsvariablen, Mount- und Portzuweisungen einsehen.

=== Schritt 4: Container anlegen und starten ===

:'''Vorab''': Falls ein Image bereits lokal existiert (prüfbar mit <code>docker images</code>), sollte man sicherheitshalber einmal den Befehl
:<syntaxhighlight lang="sh">docker pull IMAGE:TAG</syntaxhighlight>
:ausführen und die lokale Image (falls gewünscht) updaten.
----
Mit dem Befehl <br>
<syntaxhighlight lang="sh">docker run [OPTIONS] IMAGE [:TAG|@DIGEST] [CMD] [ARG…]</syntaxhighlight>
können Images installiert und direkt gestartet werden. 
<br>

Standardmäßig sollte bei der Image-Installation zusätzlich zum Image-Namen <code>IMAGE:TAG</code> ein <code>-d -p HOSTPORT:CONTAINERPORT -v VOLUME:VOLUMEDESTINATION</code> mitgegeben werden:<br>
<syntaxhighlight lang="sh">docker run -d -p HOSTPORT:CONTAINERPORT -v VOLUMENAME:VOLUMEDESTINATION IMAGE:TAG</syntaxhighlight>

:Mit <code>-d</code> können Sie bei der Erstellung mit angeben, dass der Container im Hintergrund laufen und somit attached werden soll. 
:Mit <code>-p HOSTPORT:CONTAINERPORT</code> können Sie Ihrem Container einen Port zuweisen, damit dieser bspw. über Port 80 erreichbar ist. 
::*'''Host-Port''': Der "Host-Port" ist der Port auf dem Host-System (der Maschine, auf der der Container ausgeführt wird). Dies ist der Port, auf den externe Anwendungen oder Dienste zugreifen können, um mit dem Container zu kommunizieren.
::*'''Container-Port''': Der "Container-Port" ist der Port, der im Container selbst geöffnet ist und auf den der Host-Port gemappt wird. Dies ist der Port, den die Anwendungen innerhalb des Containers verwenden, um eingehenden Netzwerkverkehr zu empfangen. Hier können Sie diese Ports eintragen, bspw. für HTTP Port 80.
:Mit <code>-v VOLUME:VOLUMEDESTINATION</code> können Sie Ihrem Container ein eigenes Volumen zuweisen.

<br>
Für den Container sind die Hostports im Bereich 40000-40100 freigegeben, folglich könnte ein vollständiger Befehl so aussehen:<br>
<syntaxhighlight lang="sh">docker run -d -p 40042:80 -v nextcloud:/var/www/html docker.io/library/nextcloud:latest</syntaxhighlight>

Falls Sie möchten, können Sie mit dem Parameter <code>--name</code> dem Container auch einen Namen zuweisen:

<syntaxhighlight lang="sh">docker run -d -p 40042:80 -v nextcloud:/var/www/html --name SupportTest docker.io/library/nextcloud:latest</syntaxhighlight>

Alternativ können Sie auch zuerst per 
<syntaxhighlight lang="sh">docker create -p HOSTPORT:CONTAINERPORT -v VOLUME:VOLUMEDESTINATION IMAGE:TAG</syntaxhighlight> den Container nur erstellen, falls der Container erst später mit 
<syntaxhighlight lang="sh">docker start -a IMAGENAME</syntaxhighlight>
gestartet werden soll.

=== Schritt 5: Prüfen, ob Container angelegt worden ist ===

Mit dem Befehl <br>
<syntaxhighlight lang="sh">docker ps -a</syntaxhighlight>
können Sie einsehen, welche Container bereits angelegt worden sind, und somit prüfen, ob Ihre Container-Installation funktioniert hat.
<br>

== Nützliche Befehle ==
=== Container oder Image löschen ===
'''<big>Container</big>'''

Um einen Container zu löschen, wird der Befehl
<syntaxhighlight lang="sh">docker rm -f CONTAINERID</syntaxhighlight>
verwendet. Die Container-ID können Sie sich mit <code> docker ps -a </code> anzeigen lassen.
::Falls gewünscht, kann hier der Parameter <code>-v</code> ergänzt werden, um auch das angebundene Volumen zu löschen. Das sollte aber nur gemacht werden, wenn alle Daten des Containers wirklich gelöscht werden sollen.
----
'''<big>Images</big>'''

Mit dem Befehl
<syntaxhighlight lang="sh">docker rmi -f IMAGEID</syntaxhighlight>
können lokale Images gelöscht werden, wenn diese nicht mehr benötigt werden. Die Image IDs können mit <code>docker images</code> angezeigt werden.

=== Volumes erstellen & löschen ===

Volumes werden grundsätzlich beim Anlegen von Containern mit dem Parameter <code>-v</code> automatisch erstellt.
Man kann diese aber auch mit dem Befehl
<syntaxhighlight lang="sh">docker volume create VOLUMENAME</syntaxhighlight>
erstellen.<br>
----
Hierbei kann auch eine Auflistung aller Volumes mit
<syntaxhighlight lang="sh">docker volume list</syntaxhighlight>
hilfreich sein.
----
Falls ein bestimmtes Volume gelöscht werden soll, sollte der Befehl
<syntaxhighlight lang="sh">docker volume rm VOLUMENAME</syntaxhighlight>
genutzt werden.
----
Um unbenutzte, nicht von irgendeinem Container referenzierte Volumes zu löschen, wird 
<syntaxhighlight lang="sh">docker volume prune</syntaxhighlight>
verwendet.