Enjoy_Container

Dieses Repository dient der Verwaltung der Dockerfiles für die Jupytermachine an der Fakultät für Physik.

Erstellen eines neuen Images

Das basis Image stellt alle für die Verwendung im Jupyterhub notwendigen Funktionen bereit und sollte als Startpunkt für neue Images dienen. Um ein neues Image erstellen sind folgende Schritte notwendig:

1. Erstellen eines neune Ordners in diesem Repository auf Branch "Test".
2. Erstellen eines Dockerfiles in diesem Ordner. Eventuelle zusätzliche Scripte & CO, die für den Bau des Image benötigt werden, sollten ebenfalls hier liegen.
3. Das Dockerfile sollte mit USER $NB_USER abschließen.
4. Lokal testen, ob das Image gebaut wird.
5. Committen und Pushen der Änderungen. Die CI kümmert sich dann um das bauen des Images und speichert es anschließend.

Testen eines neuen Images

Um ein neues Image zu testen, ist eine Testinstanz unter noch nicht da eingerichtet.

Ein neues Image auf die Jupytermachine bringen.

Für die reguläre Verwendung der Images müssen diese vorher auf etwaige Sicherheitslücken geprüft werden und werden dann freigeschaltet. Kontaktiert dafür bitte den Jupyter-Hiwi.

Images lokal verwenden

Die Images können auch auf einen lokalen Rechner gepullt werden und ausgeführt werden mit docker run -p 8888:8888 -v <workdir>:/home/jovyan --user "$(id -u):$(id -g)" --env JUPYTER_ENABLE_LAB=true gitlab.etp.kit.edu:5050/jeppelt/enjoy_container/<image>.