Container (neu)

Diese Seite befindet sich derzeit in Bearbeitung.

Die Container-Funktion steht derzeit ausschließlich den Tarifen "Professional Web af.stack", "Professional Web Bladeserver" und den Hauptusern (keinen DCP-Usern) zur Verfügung.

Container allgemein

Container sind eine leistungsstarke Technologie im Bereich der Anwendungsverwaltung und -bereitstellung unter Linux. Sie ermöglichen die Isolierung von Anwendungen und deren Abhängigkeiten in eigenständigen, tragbaren Einheiten. Diese Container können nahtlos auf verschiedenen Linux-basierten Systemen ausgeführt werden, was die Softwareentwicklung, Bereitstellung und Skalierung erheblich vereinfacht.

Das Container-Feature bieten wir Ihnen bei uns ab den Tarifen Professional Web af.stack und Professional Web Bladeserver an und dieses finden Sie dann im DCP unter "Webspace" -> "Container".

Eine Anleitung, wie Sie einen Container per SSH erstellen können, finden Sie hier.

Container-Feature aktivieren

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.

1. 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-Zugang") auch auf aktiv gestellt sind.
2. Klicken Sie zum Schluss auf den Button "Übernehmen" (2), damit die Einstellungen gespeichert werden.

Container

Containerübersicht

1. Hier erhalten Sie eine Übersicht über Ihre angelegten Container.
2. Mit dem Button "+ Neu anlegen" können Sie einen neuen Container anlegen.
3. Hier sehen Sie den von Ihnen vergebenen Namen des angelegten Containers.
4. An dieser Stelle wird die Image, die Sie installiert haben, angezeigt.
5. Hier werden die von Ihnen ausgewälten Ports angezeigt.
6. Der Status zeigt an, ob der Container "aktiv" oder "inaktiv" ist.

Container anlegen

Wenn Sie einen Container über das DCP anlegen möchten, müssen Sie das entsprechende Template auswählen. Wir haben hierfür eine kleine Liste an Templates vorgefertigt. Falls es das Template noch nicht gibt, können Sie dieses selbst unter Templates -> + Neu anlegen erstellen. Wir unterstützen Sie hierbei aber gerne, falls es Unklarheiten gibt. Nachdem Sie ein Template (als Beispiel Nextcloud) ausgewählt haben, sieht das Ganze wie folgt aus:

1. An dieser Stelle wählen Sie das Template aus, welches für den Container benutzt werden soll.
2. Zu dem Template gibt es bei unseren angelegten Templates immer eine kurze Beschreibung, sodass Sie sehen können, um was für ein Image es sich handelt.
3. Hier können Sie einen beliebigen Namen für den Container setzen. Dieser wird auch bei neuen Volumes verwendet.
4. Hier können Sie den Haken setzen, damit der Container automatisch neugestartet wird, wenn dieser aus irgendeinem Grund (Server-Neustart, Probleme mit dem Container) ausgeschaltet wird. Wenn man dies nicht wünscht, wählt man diesen Punkt nicht an.
   Achtung! Ein Server-Neustart kann immer erfolgen, auch in der Nacht, falls es irgendwelche Probleme gibt.
5. Wenn der Container über HTTP und insbesondere über eine Subdomain erreichbar sein soll, können Sie hier bereits den Haken anwählen.
6. Hier können Sie dann die Domain auswählen und vorab den Subdomainnamen ergänzen (hier bspw. cloud).
7. Wenn für die Subdomain auch direkt ein SSL-Zertifikat verwendet werden soll, müssen Sie hier auch den Haken setzen.
8. Über diesen Button können Sie den Container schließlich anlegen.

---

Umgebungsvariablen

Falls in den Templates bearbeitbare Umgebungsvariablen gesetzt sind, werden diese unterhalb des Anlegen-Buttons angezeigt:

1. Hier werden beispielhaft mögliche Umgebungsvariablen für Nextcloud angezeigt. In diesem Beispiel müsste die Datenbank vorab angelegt und der Datenbankuser, Hostname, Datenbankname & das Datenbankpasswort dort dementsprechend angepasst werden.

---

Mount-Konfiguration

1. Hier wird der Pfad im Container angezeigt. Als Beispiel hier: /var/www/html für das Hauptdatenverzeichnis von Nextcloud. Diese können Sie bspw. der Dokumentation der Container entnehmen.
2. In der Beschreibung steht, wofür der Mount verwendet werden soll (z.B. Benutzerdaten, Konfigurationen).
3. Beim Typ können Sie zwischen folgenden Optionen wählen:
   • Neues Volume
     • Es wird ein neues Volume für den Container angelegt. Diese Option eignet sich für neue Container ohne bestehende Daten. Das Volume wird dem Container eindeutig zugeordnet.
   • Existierendes Volume
     • Ein bereits vorhandenes Volume kann ausgewählt und eingebunden werden.
     • Diese Option ist sinnvoll, um Daten aus bestehenden Containern weiterzuverwenden.
   • Webroot Pfad
     • Statt eines Volumes kann ein Verzeichnis aus dem Webroot eingebunden werden.
     • Der Container greift in diesem Fall direkt auf den angegebenen Webroot-Pfad zu.
     • Diese Option eignet sich z.B. für Webanwendungen mit direktem Dateizugriff.
   • Webroot Datei (ist nur als Option vorhanden, wenn beim Template der Typ "Datei" gewählt wurde, Volumes sind bei dem Typ nicht vorhanden)
     • Es kann eine einzelne Datei aus dem Webroot eingebunden werden.
     • Diese Option eignet sich z.B. für Konfigurationsdateien oder spezielle Dateien, die vom Container benötigt werden.
4. Die Konfiguration hängt davon ab, was beim Typ gewählt wurde. Bei "Neues Volume" muss hier nichts weiter konfiguriert werden. Bei "Existierendes Volume" muss ausgewählt werden, welches Volume verwendet werden soll. Bei "Webroot Pfad" und "Webroot Datei" muss dementsprechend das Verzeichnis bzw. die Datei ausgewählt werden.

Container-Templates

In der Übersicht Container Templates werden alle verfügbaren Container-Templates angezeigt. Diese Templates dienen als Grundlage für die spätere Erstellung von Containern im DCP.

Hier sehen Sie sowohl selbst erstellte Templates als auch ggf. von uns bereitgestellte oder importierte Templates.

Übersicht der Templates

1. Der Name des Container-Templates. Dieser Name wird bei der Container-Erstellung zur Auswahl angezeigt. Über einen Klick auf den Namen kann das Template geöffnet und bearbeitet werden.
2. Kurze Beschreibung des Templates und der darin enthaltenen Anwendung.
3. Die Quelle gibt an, woher das Template stammt. Mögliche Quellen sind z.B.:
   • Eigene über das DCP erstellte Templates
   • Von uns bereitgestellte Templates

---

Container-Template anlegen

Container-Templates bilden die Grundlage für die spätere Erstellung von Containern im DCP. In einem Template werden unter anderem das verwendete Docker-Image, Mounts, Ports sowie Umgebungsvariablen definiert.

Ein einmal erstelltes Template kann anschließend mehrfach verwendet werden, um Container mit identischer Grundkonfiguration anzulegen. Es gibt bereits einige Templates von uns vorgefertigt. Falls Sie noch eigene Container erstellen möchten, können Sie das über den "+ Neu anlegen"-Button (1) in der Template-Übersicht machen.

Ein Template legen Sie wie folgt an:

1. Hier vergeben Sie einen eindeutigen Namen für das Container-Template. Dieser Name wird später bei der Container-Erstellung zur Auswahl angezeigt.
2. In der Beschreibung können Sie kurz erläutern, wofür das Template gedacht ist. Die Beschreibung wird bei der Auswahl des Templates angezeigt und erleichtert die Zuordnung.
3. Wählen Sie hier das Repository aus, aus dem das Image bezogen werden soll. Es gibt hier "docker.io", "ghcr.io", "lscr.io", "quay.io", "mcr.microsoft.com" und "public.ecr.aws".
4. Geben Sie hier den Namen des Docker-Images an (z.B. nextcloud). Über die Suche kann geprüft werden, ob das Image im ausgewählten Repository verfügbar ist.
5. Der Tag bestimmt die Version des Images (z.B. latest). Alternativ kann hier auch eine feste Version angegeben werden, um unbeabsichtigte Updates zu vermeiden.
6. Wenn Sie soweit alle Settings gesetzt haben, können Sie mit dem Button Erstellen das Template anlegen.
7. Bei bereits erstellten Templates besteht die Option, dass über den Button "Export JSON" die Inhalte des Templates heruntergeladen werden können. Über Import JSON können die Inhalte importiert werden. Das ist bspw. praktisch, wenn Sie für sich ein von uns erstelltes Template bearbeiten wollen.

---

Mount-Konfiguration

In der Mount-Konfiguration legen Sie fest, welche Dateien oder Verzeichnisse aus dem Host-System in den Container eingebunden werden.

1. Typ
   • Wählen Sie hier zwischen:
     • Verzeichnis – bindet ein komplettes Verzeichnis ein (häufigster Anwendungsfall).
     • Datei – bindet eine einzelne Datei in den Container ein.
2. Pfad im Container
   • Geben Sie hier den Zielpfad innerhalb des Containers an.
   • Beispiel: /var/www/html für das Hauptdatenverzeichnis von Nextcloud.
3. Beschreibung
   • Sie können hier festhalten, wofür der Mount verwendet wird (z.B. Benutzerdaten, Konfigurationen).
4. Weitere Mounts
   • Über das +-Symbol können zusätzliche Mounts hinzugefügt werden.
   • Mehrere Mounts sind sinnvoll, um Daten, Konfigurationen und Logs getrennt abzulegen.

---

Netzwerkfreigaben

Unter Netzwerkfreigaben definieren Sie, über welche Ports und Protokolle der Container erreichbar ist.

1. Port
   • Tragen Sie hier den Port ein, auf dem der Dienst im Container lauscht (z.B. 80).
2. Service
   • Wählen Sie das passende Protokoll:
     • TCP – für allgemeine TCP-Dienste.
     • UDP – für UDP-basierte Dienste.
     • HTTP – für Webdienste ohne Verschlüsselung.
     • HTTPS – für Webdienste mit TLS/SSL.
3. Beschreibung
   • Hier kann beschrieben werden, wofür der jeweilige Port genutzt wird (z.B. Weboberfläche).
4. Weitere Ports
   • Über das +-Symbol können weitere Netzwerkfreigaben hinzugefügt werden.
   • Ein Container kann mehrere Ports gleichzeitig bereitstellen.

---

Umgebungsvariablen

Umgebungsvariablen ermöglichen es, Container flexibel zu konfigurieren, ohne das Image selbst zu verändern.

1. Variablenname
   • Der Name der Umgebungsvariable, wie er vom Container erwartet wird (z.B. MYSQL_USER).
2. Beschreibung
   • Erläutert die Funktion der Variable (z.B. Datenbankbenutzer, Hostname, Datenbankname).
3. Standardwert
   • Der hier hinterlegte Wert wird bei der Container-Erstellung automatisch übernommen.
   • Dieser Wert kann später beim Anlegen eines Containers angepasst werden, wenn die Option "Bearbeitbar" aktiviert ist.
4. Bearbeitbar
   • Ist diese Option aktiviert, kann der Wert beim Erstellen des Containers geändert werden.
   • Deaktivierte Variablen sind fest im Template definiert.
5. Weitere Variablen
   • Über das +-Symbol können zusätzliche Umgebungsvariablen ergänzt werden.

---

Hinweise

• Änderungen an einem Template wirken sich nicht auf bereits existierende Container aus.
• Eigene Templates können jederzeit bearbeitet oder gelöscht werden.

Container einer Subdomain zuweisen

Falls der Container per HTTP (über Port 80) erreicht werden soll, muss der Container im DCP noch mit einer Subdomain verknüpft werden. Das können Sie grundsätzlich vorab beim Anlegen des Containers einstellen, siehe oben beim "Container Anlegen"-Schritt. Falls Sie das aber nachträglich noch machen möchten: Hierfür muss unter Domains -> Subdomains -> IhreDomain.tld die gewünschte Subdomain angeklickt, beim Subdomaintyp "Container" (1) und schließlich der richtige Container (2) ausgewählt werden. Klicken Sie nun noch auf "Übernehmen", um die neuen Einstellungen für die Subdomains abzuspeichern (3).