Prérequis
Avant de commencer, assurez-vous d'avoir installé Jupyter Lab sur votre ordinateur personnel. Voici comment procéder :
Installation via Python
-
Créez un environnement virtuel :
bash $ python3 -m venv jupyter_test
-
Activez l'environnement virtuel :
bash $ source jupyter_test/bin/activate
-
Installez Jupyter Lab :
bash $ pip install jupyterlab
Note : Si vous utilisez Anaconda (version 2024.06), Jupyter est déjà inclus.
Accès à Jupyter sur la frontale ($HOME)
Partie I : Démarrer un job avec un serveur Jupyter Notebook sur la vm-projet
Étape 1 : Connexion à votre compte
Connectez-vous à votre compte explor en utilisant SSH :
$ ssh -p <port> login@193.54.9.82
login@193.54.9.82's password:
Étape 2 : Charger les modules nécessaires
Chargez les modules nécessaires pour lancer Jupyter sur la vm-projet :
[login@vm-projet ~]$ module load anaconda3/2024.06
[login@vm-projet ~]$ source $HOME_ANACONDA/anaconda.rc
(base) [login@vm-projet ~]$
Étape 3 : Lancer Jupyter Notebook
Lancez Jupyter Notebook avec la commande suivante :
(base) [login@vm-projet ~]$ jupyter notebook --no-browser --port=8888 --ip=0.0.0.0
Exemple de sortie :
[I 2025-03-06 10:52:44.630 ServerApp] Jupyter Server 2.14.1 is running at:
[I 2025-03-06 10:52:44.630 ServerApp] http://vm-projet:8888/tree?token=856bf559f7b34d11a5c87e4e755b7221d4757ef001bf94b6
Notez l'URL fournie, car vous en aurez besoin pour vous connecter au serveur.
Partie II : Ouvrir un notebook à travers un tunnel SSH
Étape 1 : Ouvrir le tunnel SSH
Ouvrez un tunnel SSH dans une session shell sur votre poste de travail :
$ ssh -fNL 8888:localhost:8888 -p <port> login@193.54.9.82
login@193.54.9.82's password:
- Le premier port (8888) correspond à votre machine locale. Vous pouvez l'adapter si nécessaire.
- Le second port (8888) est celui du serveur, tel que spécifié lors du lancement de Jupyter Notebook dans la vm-projet.
Étape 2 : Lancer le notebook
Activez votre environnement virtuel et lancez Jupyter :
$ source jupyter_test/bin/activate
(jupyter_test) user@work-station:~$ jupyter notebook
Étape 3 : Accéder au notebook
Dans votre navigateur, ouvrez l'URL fournie par le serveur de notebook, en remplaçant le nom de la vm-projet par localhost
:
Remplacez :
http://vm-projet:8888/tree?token=856bf559f7b34d11a5c87e4e755b7221d4757ef001bf94b6
Par :
http://localhost:8888/tree?token=856bf559f7b34d11a5c87e4e755b7221d4757ef001bf94b6
Vous devriez maintenant être connecté à votre notebook Jupyter en cours d'exécution sur la vm-projet.
Accès à Jupyter sur les noeuds de calcul
Partie I : Démarrer un job avec un serveur Jupyter Notebook sur un nœud de calcul
Étape 1 : Connexion à votre compte
Connectez-vous à votre compte explor en utilisant SSH :
$ ssh -p <port> login@193.54.9.82
login@193.54.9.82's password:
Étape 2 : Demander une réservation
Demandez une réservation pour une connexion interactive à un nœud, exemple pour un nœud GPU :
[login@vm-projet ~]$ salloc -A projet -N1 -p gpu -w noeud -t 1:00:00 srun --pty bash
Exemple de sortie :
salloc: Pending job allocation 1344365
salloc: job 1344365 queued and waiting for resources
salloc: job 1344365 has been allocated resources
salloc: Granted job allocation 1344365
salloc: Waiting for resource configuration
salloc: Nodes gpf01 are ready for job
Étape 3 : Charger les modules nécessaires
Chargez les modules nécessaires pour lancer Jupyter sur le nœud :
[login@noeud ~]$ module load anaconda3/2024.06
[login@noeud ~]$ source $HOME_ANACONDA/anaconda.rc
(base) [login@noeud ~]$
Étape 4 : Lancer Jupyter Notebook
Lancez Jupyter Notebook avec la commande suivante :
(base) [login@noeud ~]$ jupyter notebook --no-browser --port=8888 --ip=0.0.0.0
Exemple de sortie :
[I 2024-11-22 18:50:20.263 ServerApp] Jupyter Server 2.14.1 is running at:
[I 2024-11-22 18:50:20.263 ServerApp] http://noeud:8888/tree?token=0cd965475476ce5b0a5235c4f6fc5f0c82123eb0e8c5b354
Notez l'URL fournie, car vous en aurez besoin pour vous connecter au serveur, ainsi que le nom du nœud de calcul.
Partie II : Ouvrir un notebook à travers un tunnel SSH
Étape 1 : Ouvrir le tunnel SSH
Ouvrez un tunnel SSH dans une session shell sur votre poste de travail :
$ ssh -fNL 8888:noeud:8888 -p <port> login@193.54.9.82
login@193.54.9.82's password:
- Le premier port (8888) correspond à votre machine locale. Vous pouvez l'adapter si nécessaire.
- Le second port (8888) est celui du serveur, tel que spécifié lors du lancement de Jupyter Notebook.
Étape 2 : Lancer le notebook
Activez votre environnement virtuel et lancez Jupyter Lab :
$ source jupyter_test/bin/activate
(jupyter_test) user@work-station:~$ jupyter notebook
Étape 3 : Accéder au notebook
Dans votre navigateur, ouvrez l'URL fournie par le serveur de notebook, en remplaçant le nom du nœud par localhost
:
Remplacez :
http://noeud:8888/tree?token=0cd965475476ce5b0a5235c4f6fc5f0c82123eb0e8c5b354
Par :
http://localhost:8888/tree?token=0cd965475476ce5b0a5235c4f6fc5f0c82123eb0e8c5b354
Vous devriez maintenant être connecté à votre notebook Jupyter en cours d'exécution sur le nœud de calcul.