Comment installer JupyterLab sur Rocky Linux 9

Jupyter est une application web gratuite et open-source pour le calcul interactif et la science des données.

Jupyter prend en charge tous les langages de programmation et fournit plusieurs logiciels, tels que JupyterLab, qui offre un environnement d’édition multi-notebook riche en fonctionnalités et à onglets, Notebook en tant qu’outil d’édition de notebook léger et simplifié, Qtconsole, et bien d’autres.

Dans ce guide, nous vous montrerons des instructions étape par étape sur la façon d’installer JupyterLab sur le serveur Rocky Linux 9. Vous installerez JupyterLab, activerez l’authentification JupyterLab, puis configurerez Nginx en tant que proxy inverse.

Prérequis

Pour compléter ce guide, assurez-vous d’avoir les éléments suivants :

Un serveur Rocky Linux 9.
Un utilisateur non-root avec des privilèges sudo.
Un SELinux avec un statut permissif.

Installer les dépendances

Avant d’installer JupyterLab, vous devez installer des dépendances sur votre serveur Rocky Linux. Cela inclut Pip, Node.js et des outils de développement. En plus de cela, vous installerez également Nginx pour le proxy inverse.

Pour commencer, exécutez la commande ci-dessous pour installer les paquets de développement sur votre système.

sudo dnf -y groupinstall development

Ensuite, installez Pip, Node.js et Nginx en utilisant la commande suivante.

sudo dnf install -y python3-pip nodejs nginx

Une fois l’installation terminée, passez à l’étape suivante.

install deps

Configuration de l’environnement virtuel Python

Dans cet exemple, vous installerez et exécuterez JupyterLab avec un utilisateur normal. Assurez-vous donc que votre utilisateur est préparé avec des privilèges sudo.

Connectez-vous à votre utilisateur en utilisant la commande ci-dessous.

su - user

Créez un nouveau répertoire ~/project et déplacez-vous dedans. Ensuite, créez un nouvel environnement virtuel Python venv.

mkdir -p ~/project; cd ~/project  
python3 -m venv venv

Une fois l’environnement virtuel venv créé, vous pouvez l’activer en utilisant la commande ci-dessous.

source venv/bin/activate

Ici, votre invite devrait devenir comme (venv) alice@hostname, ce qui signifie que votre environnement virtuel Python est actif.

setup venv

Installation de JupyterLab

Maintenant que vous avez créé un environnement virtuel Python, vous êtes prêt à installer JupyterLab. Dans cette section, vous installerez JupyterLab, générerez la configuration de JupyterLab, configurerez l’authentification par mot de passe, puis vérifierez JupyterLab.

Pour installer JupyterLab, exécutez la commande pip3 ci-dessous.

pip3 install jupyter

Une fois l’installation commencée, vous devriez obtenir une sortie comme celle-ci :

install jupyterlab

Après l’installation, exécutez la commande ci-dessous pour localiser le fichier binaire Jupyter et vérifier la version de JupyterLab.

which jupyter  
jupyter --version

Vous devriez obtenir le fichier binaire JupyterLab situé dans votre environnement virtuel Python. Et la version de JupyterLab est 4.1.1.

verify jupyter

Ensuite, exécutez la commande Jupyter ci-dessous pour générer la configuration du serveur Jupyter et configurer l’authentification par mot de passe.

jupyter server --generate-config  
jupyter server password

Lorsque vous êtes invité à entrer le mot de passe, saisissez votre nouveau mot de passe et répétez.

generate password jupyter server

Ensuite, exécutez la commande ci-dessous pour générer JupyterLab et saisissez y lorsqu’on vous demande de remplacer. Ensuite, vérifiez votre configuration JupyterLab.

jupyter lab --generate-config  
jupyter lab --show-config

Comme vous pouvez le voir ci-dessous, l’authentification par mot de passe est hachée et le chemin d’accès de votre JupyterLab devrait être accessible.

generate config file jupyter lab

Vous pouvez maintenant exécuter la commande ci-dessous pour ouvrir le port 8888 pour JupyterLab. Ensuite, démarrez votre JupyterLab sur l’IP locale 192.168.5.120, et assurez-vous de changer l’adresse IP.

sudo firewall-cmd --add-port=8888/tcp  
jupyter lab --ip 192.168.5.120

Une fois démarré, vous devriez obtenir une sortie similaire à celle-ci :

test jupyterlab install

Maintenant, ouvrez votre navigateur web et visitez votre adresse IP locale avec le port 8888, http://192.168.5.120:8888/. Vous serez accueilli par la page de connexion JupyterLab.

Saisissez votre mot de passe et appuyez sur Se connecter.

Si cela réussit, vous devriez obtenir le tableau de bord JupyterLab comme suit :

jupyterlab dashboard

Enfin, retournez à votre terminal et appuyez sur Ctrl+c pour terminer le processus JupyterLab. Dans l’étape suivante, vous configurerez JupyterLab en tant que service systemd.

Exécution de JupyterLab en tant que service Systemd

Avec JupyterLab installé, vous allez maintenant créer un nouveau service systemd pour JupyterLab. Cela vous permet de gérer JupyterLab facilement via l’utilitaire système. De plus, vous pouvez démarrer JupyterLab au démarrage en activant le service.

Exécutez maintenant la commande de l’éditeur nano suivante pour créer un nouveau service jupyterlab /etc/systemd/system/jupyterlab.service.

sudo nano /etc/systemd/system/jupyterlab.service

Ajoutez la configuration ci-dessous au fichier et assurez-vous de changer les détails de l’utilisateur avec votre utilisateur. Cela inclut le chemin binaire du programme Jupyter et la configuration générée.

[Unit]  
Description=Service JupyterLab  
  
[Service]  
Type=simple  
PIDFile=/run/jupyter.pid  
ExecStart=/home/alice/project/venv/bin/jupyter lab --config=/home/alice/.jupyter/jupyter_lab_config.py  
User=alice  
Group=alice  
WorkingDirectory=/home/alice/project  
Restart=always  
RestartSec=10  
  
[Install]  
WantedBy=multi-user.target

Lorsque vous avez terminé, enregistrez et quittez le fichier.

Ensuite, exécutez la commande ci-dessous pour recharger le gestionnaire systemd et appliquer les modifications systemd.

sudo systemctl daemon-reload

Puis, démarrez et activez le service jupyterlab avec la commande suivante.

sudo systemctl start jupyterlab  
sudo systemctl enable jupyterlab

jupyterlab systemd

Une fois démarré, exécutez la commande ci-dessous pour vérifier votre service jupyterlab.

sudo systemctl status jupyterlab

Si le service jupyterlab est en cours d’exécution, vous devriez obtenir une sortie comme suit :

check jupyterlab service

Configuration de l’accès à distance pour JupyterLab

Pour exécuter JupyterLab derrière un proxy inverse, vous devez activer l’accès à distance sur votre installation JupyterLab. Vous devez modifier le script de configuration JupyterLab par défaut et activer l’accès à distance à partir de là.

Exécutez la commande de l’éditeur nano suivante pour ouvrir le script de configuration JupyterLab ~/.jupyter/jupyter_lab_config.py.

nano ~/.jupyter/jupyter_lab_config.py

Décommentez le paramètre c.ServerApp.allow_remote_access et changez la valeur en True. Cela activera l’accès à distance pour le proxy inverse dans l’installation de JupyterLab.

c.ServerApp.allow_remote_access = True

Lorsque vous avez terminé, enregistrez et quittez le fichier.

Ensuite, exécutez la commande ci-dessous pour redémarrer le service JupyterLab et vérifier le jeton généré. Ce jeton sera utilisé pour se connecter à JupyterLab sous le proxy inverse.

sudo systemctl restart jupyterlab  
sudo systemctl status jupyterlab

En bas du journal de service, vous pouvez voir le jeton JupyterLab.

Configuration du proxy inverse Nginx

Maintenant que vous avez autorisé l’accès à distance dans JupyterLab, vous êtes prêt à configurer Nginx en tant que proxy inverse pour votre installation JupyterLab.

Tout d’abord, exécutez la commande de l’éditeur nano suivante pour créer une nouvelle configuration Nginx /etc/nginx/conf.d/jupyterlab.conf.

sudo nano /etc/nginx/conf.d/jupyterlab.conf

Insérez la configuration ci-dessous et assurez-vous de changer le nom de domaine avec votre installation locale de JupyterLab.

server {  
listen 80;  
server_name jupyterlab.howtoforge.local;  
  
access_log /var/log/nginx/howtoforge.local.access.log;  
error_log /var/log/nginx/howtoforge.local.error.log;  
  
location / {  
proxy_pass http://127.0.0.1:8888;  
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
proxy_set_header X-Real-IP $remote_addr;  
proxy_set_header Host $http_host;  
proxy_http_version 1.1;  
proxy_redirect off;  
proxy_buffering off;  
proxy_set_header Upgrade $http_upgrade;  
proxy_set_header Connection "upgrade";  
proxy_read_timeout 86400;  
}  
}

Enregistrez et quittez le fichier lorsque vous avez terminé.

Exécutez maintenant la commande ci-dessous pour vérifier votre syntaxe Nginx. Si cela réussit, vous devriez obtenir une sortie ‘syntax is ok - test is successful’.

sudo nginx -t

Ensuite, démarrez et activez le service Nginx en utilisant la commande suivante.

sudo systemctl start nginx  
sudo systemctl enable nginx

setup nginx

Une fois Nginx démarré, vérifiez le service avec la commande ci-dessous. Assurez-vous que le service Nginx est en cours d’exécution.

sudo systemctl status nginx

verify nginx

Enfin, exécutez la commande ci-dessous pour ouvrir le port HTTP sur votre système et autoriser le trafic vers votre installation JupyterLab.

sudo firewall-cmd --add-service={http,https} --permanent  
sudo firewall-cmd --reload

Avec cela, votre installation JupyterLab devrait être accessible via le proxy inverse.

Connexion à JupyterLab

Ouvrez un nouvel onglet dans votre navigateur web et visitez le nom de domaine de votre installation JupyterLab, comme http://jupyterlab.howtoforge.local/. Si votre installation est réussie, vous serez accueilli par la page de connexion JupyterLab.

Faites défiler jusqu’en bas de la page et collez votre jeton JupyterLab. Ensuite, saisissez le nouveau mot de passe pour votre installation JupyterLab et appuyez sur Se connecter et définir le nouveau mot de passe.

Si vous avez le bon jeton, vous devriez obtenir le tableau de bord JupyterLab et votre mot de passe devrait également être changé.