IBH Link UA:Docker: Unterschied zwischen den Versionen
KKeine Bearbeitungszusammenfassung |
Axel (Diskussion | Beiträge) Docker-Webverwaltung, Compose, Registry und Fehlersuche aktualisiert |
||
| Zeile 1: | Zeile 1: | ||
== Voraussetzungen == | |||
Der SD-Karten Slot befindet sich auf der Rückseite des | 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: | |||
[[Image:IBH_Link_UA_SD_Card_Slot.png|433px]] | [[Image:IBH_Link_UA_SD_Card_Slot.png|433px]] | ||
Vor der ersten Verwendung muss die SD-Karte über die Weboberfläche formatiert werden: | |||
[[Image:IBH_Link_UA_Docker_SD_Karte_formatieren.png|615px]] | |||
'''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. | |||
[[Image:IBH_Link_UA_Docker_Container.png|1106px]] | |||
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 [[IBH Link UA:Docker Portainer|Docker Portainer]]. | ||
== Fehlersuche == | |||
Wenn ein Container oder Compose-Projekt nicht startet, prüfen Sie: | |||
# freien Speicherplatz auf der SD-Karte | |||
# DNS- und Netzwerkverbindung zur Registry | |||
# Container- beziehungsweise Compose-Log | |||
# verwendete Ports und bereits laufende Container | |||
# Volume-Pfade und Zugriffsrechte | |||
# 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. | |||
Aktuelle Version vom 5. August 2026, 11:35 Uhr
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:
- freien Speicherplatz auf der SD-Karte
- DNS- und Netzwerkverbindung zur Registry
- Container- beziehungsweise Compose-Log
- verwendete Ports und bereits laufende Container
- Volume-Pfade und Zugriffsrechte
- 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.