Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
de:services:application_services:jupyter:start [2023/03/30 16:19] – [Installation zusätzlicher Pakete per Conda in einem eigenen Environment] bwegman1de:services:application_services:jupyter:start [2024/01/24 16:50] (aktuell) – [Notebook-Image auswählen] bwegman1
Zeile 25: Zeile 25:
 Da Speicherung und Berechnung serverseitig passieren, muss keine Software installiert oder weitere Voraussetzungen erfüllt sein. Es muss lediglich ein moderner Browser zur Verfügung stehen. Für die Anmeldung an dem Dienst wird ein [[de:services:general_services:customer_portal:account_info|GWDG Full Account]] benötigt.  Da Speicherung und Berechnung serverseitig passieren, muss keine Software installiert oder weitere Voraussetzungen erfüllt sein. Es muss lediglich ein moderner Browser zur Verfügung stehen. Für die Anmeldung an dem Dienst wird ein [[de:services:general_services:customer_portal:account_info|GWDG Full Account]] benötigt. 
  
 +==== Notebook-Image auswählen ====
 +
 +Nach erfolgreicher Anmeldung erscheint eine Option zum Auswählen des Notebook-Images, mit dem der Notebook-Server gestartet werden soll:
 +  * GWDG default image (based on jupyter/datascience-notebook)
 +      * Dies war bisher und ist das Standard-Image.
 +  * Python Stack w/ TensorFlow (jupyter/tensorflow-notebook)
 +  * Python and R Spark Jupyter Notebook (jupyter/all-pyspark-notebook)
 +  * Data Science Jupyter Notebook (jupyter/datascience-notebook)
 +
 +Das Notebook-Image stellt die Umgebung des Notebook-Server zur Verfügung, insbesondere die vorinstallierte Software.
 +Obwohl das GWDG default image stark erweitert ist und auf dem regulären Data Science Notebook des Jupter-Projekts basiert, ist ein Image des Jupyter-Projekts möglicherweise in einigen Fälle besser geeignet als einfachere oder spezialisierte Umgebung.
 +
 +Ungeachtet des ausgewählten Images bleibt das Heimatverzeichnis des Benutzer und die Daten darin unverändert und stehen immer zur Verfügung.
 +
 +Das Notebook-Image kann nur geändert werden, wenn der Notebook-Server gestoppt ist und neu gestartet wird. Der Notebook-Server beendet sich nicht durch Abmeldung oder Schließen des Browsers, allerdings tritt dann nach einer Weile ein Timeout ein, der den Server beendet. Der Server kann aber direkt beendet werden über das Menü File -> Hub Control Panel -> "Stop my server". Dies stoppt tatsächlich den Server und die Funktion "Start my server" startet diesen erneut, so dass ein Image ausgewählt werden kann.
 +
 +=== Changelog Notebook-Images ===
 +
 +Ein einfaches Changelog mit [[en:services:application_services:jupyter:version-history|Änderungen (en)]] an dem "GWDG default image" ist verfügbar.
 ==== Starten eines Notebooks ==== ==== Starten eines Notebooks ====
  
Zeile 49: Zeile 68:
   * <code bash> mv -v .local/ .local.gwdg-disable </code>   * <code bash> mv -v .local/ .local.gwdg-disable </code>
   * Anschließend Notebook Server neustarten über: File - Hub Control Panel - Stop My Server   * Anschließend Notebook Server neustarten über: File - Hub Control Panel - Stop My Server
 +
 +<WRAP info>
 +Diese Aktion kann auch im Selfservice-Portal ausgeführt werden: https://jupyter-cloud.gwdg.de/selfservice
 +</WRAP>
 ==== Installation zusätzlicher Python Module ==== ==== Installation zusätzlicher Python Module ====
 Zusätzliche Python Module können über das Terminal und den Python package manager "pip" installiert werden. Hierzu muss über das Menü "New" -> "Terminal" ein Terminal geöffnet werden. Anschließend wird mit <code>pip install --user <module></code> ein neues Modul in das Home-Verzeichnis installiert. Zusätzliche Python Module können über das Terminal und den Python package manager "pip" installiert werden. Hierzu muss über das Menü "New" -> "Terminal" ein Terminal geöffnet werden. Anschließend wird mit <code>pip install --user <module></code> ein neues Modul in das Home-Verzeichnis installiert.
Zeile 66: Zeile 89:
 <WRAP tip> <WRAP tip>
 **mamba** ist eine alternative Implementierung des **conda** Paketmanagers. Sie sind austauschbar, die Verwendung von **mamba** wird empfohlen. **mamba** ist eine alternative Implementierung des **conda** Paketmanagers. Sie sind austauschbar, die Verwendung von **mamba** wird empfohlen.
 +https://github.com/mamba-org/mamba
 </WRAP> </WRAP>
  
Zeile 79: Zeile 103:
 === Erstellen eines neuen Environments === === Erstellen eines neuen Environments ===
  
-Im Folgenden wird ein neues, einfaches Conda-Environment ''wikidoku'' erstellt, beispielhaft das Python-Modul ''jinja2'' installiert und das Environment für das Notebook verfügbar gemacht.+Im Folgenden wird ein neues, einfaches Conda/Mamba-Environment ''wikidoku'' erstellt, beispielhaft das Python-Modul ''jinja2'' installiert und das Environment für das Notebook verfügbar gemacht.
  
 Erstellen und Aktivieren des Environments: Erstellen und Aktivieren des Environments:
 <code bash> <code bash>
-conda create -y --prefix ./wikidoku +mamba create -y --prefix ./wikidoku 
-conda activate ./wikidoku+mamba activate ./wikidoku
 </code> </code>
  
 Als nächstes wird beispielhaft das Paket ''jinja2'' installiert. An dieser Stelle kann nun beliebig Software aus beliebigen Conda-Channels installiert werden. Als nächstes wird beispielhaft das Paket ''jinja2'' installiert. An dieser Stelle kann nun beliebig Software aus beliebigen Conda-Channels installiert werden.
 <code bash> <code bash>
-conda install -y jinja2+mamba install -y jinja2
 </code> </code>
  
Zeile 96: Zeile 120:
 python3 -m ipykernel install --user --name wikidoku --display-name "Python (wikidoku)" python3 -m ipykernel install --user --name wikidoku --display-name "Python (wikidoku)"
 jupyter kernelspec list jupyter kernelspec list
-conda deactivate+mamba deactivate
 </code> </code>
  
Zeile 112: Zeile 136:
 Über ''New ->'' kann nun ein neues Notebook mit dem neue Environment gestartet werden. Bei einem vorhandenen Notebook kann nach dem Öffnen der Kernel gewechselt werden über das Menü ''Kernel -> Change Kernel''. Über ''New ->'' kann nun ein neues Notebook mit dem neue Environment gestartet werden. Bei einem vorhandenen Notebook kann nach dem Öffnen der Kernel gewechselt werden über das Menü ''Kernel -> Change Kernel''.
  
-=== Installieren anderer Kernel in einem Conda-Environment ===+=== Installieren anderer Kernel in einem Conda/Mamba-Environment ===
  
 Die Installation eines eigenständigen Python-Kernels nur für das aktuelle Environment ist möglich. Hier wird beispielhaft die Installation eines alten python-2.7-Kernels gezeigt. Die Installation eines eigenständigen Python-Kernels nur für das aktuelle Environment ist möglich. Hier wird beispielhaft die Installation eines alten python-2.7-Kernels gezeigt.
Zeile 119: Zeile 143:
 Danach erfolgt die Installation der Kernels, des ''jupyter''-Moduls für den Kernel und abschließend wird der neue Kernel für den Notebook-Server aktiviert: Danach erfolgt die Installation der Kernels, des ''jupyter''-Moduls für den Kernel und abschließend wird der neue Kernel für den Notebook-Server aktiviert:
 <code bash> <code bash>
-conda install -y python=2.7+mamba install -y python=2.7
 python -m pip install jupyter python -m pip install jupyter
 python -m ipykernel install --user --name oldpython --display-name "Python 2.7 (oldpython)" python -m ipykernel install --user --name oldpython --display-name "Python 2.7 (oldpython)"