Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision |
client:container [2021/10/05 09:51 CEST] – [Konfiguration des Containers] chr | client:container [2021/11/18 11:19 CET] – [Metadaten, Container-Typ] Daten-Container update risenman |
---|
==== Auswahl des Imagetyps ==== | ==== Auswahl des Imagetyps ==== |
| |
[{{ :bwsuite:container:bwlp_suite_new_image.png?400|bwLehrpool-Suite: Auswahl zwischen VM und Container}}]Den Wizard zur Erstellung eines Docker-Abbildes erreichen Sie nach Auswahl per Schaltfläche „Neues Docker-Image“ (siehe Abb. rechts). | [{{ :bwsuite:container:211118_bwlp_suite_new_image.png?400|bwLehrpool-Suite: Auswahl zwischen VM und Container}}]Den Wizard zur Erstellung eines Docker-Abbildes erreichen Sie nach Auswahl per Schaltfläche „Neues Docker-Image“ (siehe Abb. rechts). |
| |
<note important>Bitte beachten Sie eventuelle Warnungen unter „Hinweis“. Überprüfen Sie gegebenenfalls wie [[https://www.bwlehrpool.de/wiki/doku.php/client/bwlehrpool-suite#menueleiste|hier beschrieben]], ob eine neue Version der bwLehrpool-Suite zur Verfügung steht.</note> | <note important>Bitte beachten Sie eventuelle Warnungen unter „Hinweis“. Überprüfen Sie gegebenenfalls wie [[https://www.bwlehrpool.de/wiki/doku.php/client/bwlehrpool-suite#menueleiste|hier beschrieben]], ob eine neue Version der bwLehrpool-Suite zur Verfügung steht.</note> |
==== Anlegen des Container-Image ==== | ==== Anlegen des Container-Image ==== |
| |
[{{ :bwsuite:container:bwlp_suite_new_image_container.png?400|bwLehrpool-Suite: Container-Image erstellen}}] | [{{ :bwsuite:container:211118_bwlp_suite_new_image_container.png?400|bwLehrpool-Suite: Container-Image erstellen}}] |
Für die Erstellung eines Container-Images stehen Ihnen verschiedene Möglichkeiten zur Auswahl. Sie können dabei das Image aus einem Dockerfile oder einem Git-Repository bauen lassen, oder auf bestehende Abbilder aus einem Image-Repositorium, beispielsweise [[https://hub.docker.com/|Docker Hub]]), zurückgreifen. | Für die Erstellung eines Container-Images stehen Ihnen zwei Möglichkeiten zur Auswahl. Sie können ihr selbstgebautes Image als Docker-Archive exportieren und hochladen, oder auf bestehende Abbilder aus einem Image-Repositorium, beispielsweise [[https://hub.docker.com/|Docker Hub]]), zurückgreifen. |
| |
| <html><!-- Vielleicht gibt es später die entsprechenden Funktionen um Containr Images mit Dockerfiles zu bauen... |
| |
- Falls ein eigenes Images gebaut werden soll: Verwenden Sie die Eingabeoptionen „Dockerfile“ oder „Git Repository“. | - Falls ein eigenes Images gebaut werden soll: Verwenden Sie die Eingabeoptionen „Dockerfile“ oder „Git Repository“. |
* Dockerfile: Zum Erstellen eines eigenen Dockerfiles: Anleitung [[https://docs.docker.com/engine/reference/builder/|Docker-Referenz]]. | * Dockerfile: Zum Erstellen eines eigenen Dockerfiles: Anleitung [[https://docs.docker.com/engine/reference/builder/|Docker-Referenz]]. |
* Git-Repository: Für komplexere Images können Sie auch entsprechend der [[https://docs.docker.com/engine/reference/commandline/build/|Docker-Build-Anleitung]] einen Link auf ein Git-Repository angeben. Hierdurch ist es beispielsweise möglich, dem endgültigen Image weitere Dateien wie Konfigurationen oder Skripte hinzuzufügen. | * Git-Repository: Für komplexere Images können Sie auch entsprechend der [[https://docs.docker.com/engine/reference/commandline/build/|Docker-Build-Anleitung]] einen Link auf ein Git-Repository angeben. Hierdurch ist es beispielsweise möglich, dem endgültigen Image weitere Dateien wie Konfigurationen oder Skripte hinzuzufügen. |
| --></html> |
| - Docker-Archive ist die bevorzugte Methode, um in bwLehrpool Container-Images anzulegen. Exportieren Sie Ihr erstelltes Image mit [[https://docs.docker.com/engine/reference/commandline/save/|docker save]] und fügen Sie es dem Upload hinzu. |
- Soll ein bestehendes Image von Docker Hub verwendet werden, geben Sie lediglich den Repository-Namen an (z.b. python:3.7, tensorflow/tensorflow:nightly-gpu-jupyter, etc.). | - Soll ein bestehendes Image von Docker Hub verwendet werden, geben Sie lediglich den Repository-Namen an (z.b. python:3.7, tensorflow/tensorflow:nightly-gpu-jupyter, etc.). |
- Geben Sie Ihrem Container-Images einen sprechenden Namen. | - Geben Sie Ihrem Container-Images einen sprechenden Namen. |
| |
<note important>Der Bau von Container-Images findet derzeit noch auf Clients statt. Sollte dies zu viel Zeit in Anspruch nehmen, können Sie dem Upload auch ein vorgebautes Container-Image hinzufügen ([[https://docs.docker.com/engine/reference/commandline/save/|docker save]]). Das Bauen eines Images soll in einem späteren Schritt im bwLehrpool-System erfolgen </note> | <note important> Die Dateiendung für Archive muss für bwLehrpool-Suite **.tar** lauten.</note> |
| <note important> Beachten Sie beim Exportieren von Docker-Images, dass für das Docker-Archive Dateiberechtigungen stimmen.</note> |
| |
| <note tip>Docker-Archive profitieren aktuell von [[satellite:dnbd3_lokales_caching|lokalem Caching]] </note> |
| |
| |
==== Metadaten, Container-Typ ==== | ==== Metadaten, Container-Typ ==== |
| |
[{{ :bwsuite:container:bwlp_suite_new_image_container_meta.png?direct&400|}}] Geben Sie im letzen Schritt dem Container-Image eine Beschreibung und legen den Typ des Container-Image fest. | [{{ :bwsuite:container:bwlp_suite_new_image_container_meta.png?direct&400|}}] Geben Sie im letzten Schritt dem Container-Image eine Beschreibung und legen den Typ des Container-Image fest. |
| |
=== Beschreibung === | === Beschreibung === |
Vergeben Sie dem Image eine aussagekräftige Beschreibung mit Informationen wie: | Vergeben Sie dem Image eine aussagekräftige Beschreibung mit Informationen wie: |
* Welches Quell-Image benutzt wird, von wo es stammt, | * Welches Quell-Image benutzt wird, von wo es stammt, |
* welche Anwendung in welcher Version in dem Container enthalten sind, … | * Welche Anwendung in welcher Version in dem Container enthalten sind, … |
| |
=== Container-Image-Typ === | === Container-Image-Typ === |
| |
Der Typ eines Container-Images legt fest, wie dieser in Veranstaltungen oder in anderen Systemen genutzt wwird. Derzeit werden zwei Arten unterstützt: | Der Typ eines Container-Images legt fest, wie dieser in Veranstaltungen oder in anderen Systemen genutzt wird. Derzeit werden zwei Arten unterstützt: |
| |
| * Pool (Default): Ein einfaches Container-Image, das rein zur Verwendung auf bwLehrpool-Clients erstellt wurde. |
| * Daten: Ein spezielles Container-Image, das nur Daten enthält. Beispielsweise können so Daten-Container mit Trainingsdaten für Machine-Learning (Mnist, ImageNet, CIFAR, ...) separat bereitgestellt werden. |
| <note important>Daten für einen Daten-Container müssen derzeit unter **/data/** abgelegt sein! Verwenden Sie zur Erstellung von Daten-Container kleine Basis-Images wie [[https://hub.docker.com/_/alpine|Alpine]] oder [[https://hub.docker.com/_/busybox|BusyBox]]</note> |
| |
* Pool (Default): Ein einfaches Container-Image, das rein zur Verwendung auf bwLehrpool-Clientrechnern erstellt wurde. | <html><!-- Batch-System bezieht seine Container von eigener Container-Registry |
* Daten: Ein spezielles Container-Image, das nur Daten enthält. Beispielsweise können so Daten-Container mit Trainingsdaten für Machine-Learning (Mnist, ImageNet, CIFAR, ...) bereitgestellt werden. | * Pool/Batch: Ein modifiziertes Container-Image, das sowohl für Lehrveranstaltungen auf bwLehrpool-Clients als auch für das neue bwLehrpool-Cluster-System verwendet werden kann. (**todo:** bwlp-cluster side and link) |
* Pool/Batch: Ein modifiziertes Container-Image, das sowohl für Lehrveranstaltungen auf bwLehrpool-Clientrechnern als auch für das neue bwLehrpool-Cluster-System verwendet werden kann. (**todo:** bwlp-cluster side and link) | --></html> |
| |
Nach Angabe der Beschreibung und des gewünschten Imagetyps können Sie wie gewohnt mittels „Weiter“ die Zugriffsberechtigungen Ihres Containers festlegen oder direkt per „Fertigstellen“ die Konfiguration abschließen. | Nach Angabe der Beschreibung und des gewünschten Imagetyps können Sie wie gewohnt mittels „Weiter“ die Zugriffsberechtigungen Ihres Containers festlegen oder direkt per „Fertigstellen“ die Konfiguration abschließen. |