IBH Link UA:Docker

Voraussetzungen

Docker steht auf den dafür vorgesehenen IBH Link UA Quad-Core-Geräten zur Verfügung. Für Container, Images und persistente Daten wird eine geeignete SD-Karte benötigt.

Der SD-Karten-Slot befindet sich auf der Rückseite des Geräts:

Vor der ersten Verwendung muss die SD-Karte über die Weboberfläche formatiert werden:

Achtung: Beim Formatieren werden die vorhandenen Daten auf der SD-Karte gelöscht.

Docker aktivieren

Docker wird in der Weboberfläche im Bereich der optionalen Software aktiviert. Nach erfolgreicher Aktivierung stehen getrennte Ansichten für Images, Container und Docker-Compose-Dateien zur Verfügung.

Für das Laden von Images muss ein gültiger Nameserver eingetragen und die verwendete Registry vom Gerät aus erreichbar sein.

Images verwalten

Die Image-Ansicht dient zum Anzeigen und Verwalten der lokal vorhandenen Docker-Images. Nicht mehr benötigte Images können dort gelöscht werden. Vor dem Löschen muss geprüft werden, ob das Image noch von einem Container verwendet wird.

Container verwalten

Die Weboberfläche unterstützt die wichtigsten Betriebsaktionen für Container:

• Container erzeugen
• starten, stoppen und neu starten
• Container-Status aktualisieren
• Container-Log anzeigen
• Container löschen
• Container mit oder ohne Historie sichern beziehungsweise exportieren

Persistente Daten sollten über Volumes außerhalb des flüchtigen Container-Dateisystems abgelegt werden. Verwenden Sie nur die vom IBH Link UA zugelassenen Hostverzeichnisse.

Docker Compose

Docker-Compose-Konfigurationen können als YAML-Datei über die Weboberfläche verwaltet werden.

Verfügbare Aktionen:

• Compose-YAML hochladen
• ausgewählte YAML-Datei herunterladen
• YAML-Datei prüfen und übernehmen
• Compose-Projekt starten beziehungsweise aktualisieren
• nicht mehr benötigte YAML-Dateien löschen

Vor der Übernahme wird die YAML-Konfiguration geprüft. Zulässige, in der Konfiguration benötigte Hostverzeichnisse können beim Anwenden automatisch angelegt werden. Absolute, gerätespezifische Pfade sollten vermieden werden; Volumes und Pfade müssen zur vorgesehenen Verzeichnisstruktur des Geräts passen.

Private Registry

Für private Docker-Registries steht eine Registry-Anmeldung in der Weboberfläche zur Verfügung. Benötigt werden Registry-Adresse, Benutzername und Passwort. Verwenden Sie nach Möglichkeit eine TLS-gesicherte Registry und ein Konto mit den minimal erforderlichen Berechtigungen.

Optional: Portainer

Portainer kann als eigener Container betrieben werden, ist für die aktuelle Docker-Verwaltung über die IBH-Link-UA-Weboberfläche aber nicht erforderlich. Hinweise für bestehende Installationen stehen unter Docker Portainer.

Fehlersuche

Wenn ein Container oder Compose-Projekt nicht startet, prüfen Sie:

1. freien Speicherplatz auf der SD-Karte
2. DNS- und Netzwerkverbindung zur Registry
3. Container- beziehungsweise Compose-Log
4. verwendete Ports und bereits laufende Container
5. Volume-Pfade und Zugriffsrechte
6. konfigurierte Restart-Policy

Bei Änderungen an Netzwerkkonfiguration, Volumes oder Compose-Dateien sollte anschließend der Status in der Weboberfläche aktualisiert und das Container-Log kontrolliert werden.