JupyterLab¶

Fonctionnalités clés de JupyterLab¶

• Interface modulaire et extensible : Personnalisez votre espace de travail pour répondre à vos besoins.
• Support multi-format : Travaillez avec des notebooks, des fichiers texte, des images et d'autres types de documents.
• Navigateur de fichiers intégré : Parcourez votre système de fichiers en toute simplicité.
• Tableaux de bord interactifs : Créez et utilisez des panneaux de contrôle interactifs.
• Éditeur de texte amélioré : Fonctionnalités de coloration syntaxique et d'autocomplétion de code.
• Système d'extension flexible : Ajoutez de nouvelles fonctionnalités et outils à votre environnement.

Fonctionnalités de déploiement¶

• Pré-dépendances installées :
• Python 3
• pip

• virtualenv

• Répertoire de travail : /root

  • Installation de JupyterLab :
  • Répertoire principal : /opt/data/jupyter/
  • Fichiers exécutables : /opt/data/jupyter/bin/
  • Fichiers de configuration : /opt/data/jupyter/etc/jupyter/
  • Ressources communes : /opt/data/jupyter/share/jupyter/
  • Packages Python : /opt/data/jupyter/lib/python3.12/site-packages/

• Bibliothèques installées clés :

  • numpy
  • matplotlib
  • ipython
  • jupyter_core
  • notebook
  • ipykernel
  • nbconvert
  • nbformat
  • jupyterlab-pygments
  • ipywidgets
  • jinja2
  • pillow

L'interface Web sera accessible à : https://lab{Server_ID_from_Invapi}.hostkey.in

Commencer après le déploiement de JupyterLab¶

Après avoir acheté une commande, vous recevrez un e‑mail de notification lorsque votre serveur sera prêt. Cet e‑mail contiendra votre adresse IP VPS et vos identifiants de connexion. Nos clients gèrent leur équipement via le panneau de contrôle serveur et l'API — Invapi.

Vous pouvez trouver les données d'authentification, soit dans la section Info >> Tags du panneau de contrôle de votre serveur, soit dans l'e‑mail que vous avez reçu :

• Lien pour accéder à l'interface Web de JupyterLab : - dans la balise webpanel;
• Login : root - pour la gestion du serveur, seul un mot de passe est requis pour s'authentifier auprès de JupyterLab;
• Mot de passe : Envoyé à votre adresse e‑mail après que le serveur soit prêt à être utilisé suite au déploiement du logiciel.

Autorisation et le menu de démarrage¶

Après une connexion réussie, vous verrez la page de démarrage de JupyterLab :

Cette page présente une interface intuitive offrant un accès aux fonctions et outils principaux de JupyterLab :

1. Barre supérieure :

   • Menu standard avec les options : File, Edit, View, Run, Kernel, Tabs, Settings, Help.
   • + Button pour créer un nouveau fichier ou ouvrir un nouveau terminal.
   • Icônes pour enregistrer, télécharger et mettre à jour.

2. Barre latérale gauche :

   • Navigateur de fichiers avec un champ de recherche Filter files by name.
   • Affiche le répertoire racine / et le dossier nginx, modifié pour la dernière fois il y a 2 heures.

3. Zone centrale (Launcher) :

   • Section Notebook avec une option pour créer un nouveau notebook Python 3 (ipykernel).
   • Section Console avec également une option Python 3 (ipykernel).
   • Section Other avec des options supplémentaires :
     • Terminal (pour ouvrir une ligne de commande);
     • Text File (pour créer un fichier texte);
     • Markdown File (pour créer un fichier de balisage);
     • Python File (pour créer un script Python);
     • Show Contextual Help (pour afficher l’aide contextuelle).

Commander JupyterLab via l'API¶

Pour installer ce logiciel en utilisant l'API, suivez les instructions suivantes

Here is the script Bash complet avec le modèle de service systemd ajouté:

Installation de JupyterLab sur Ubuntu depuis un script Ansible (Commandes Bash)¶

Ce guide convertit le script Ansible fourni en une série d'étapes de commandes Bash pour une installation manuelle sur un système Ubuntu.

Auto-installation de JupyterLab sur Ubuntu¶

1. Mettre à jour les paquets système :

   sudo apt update
   sudo apt upgrade -y
   

2. Configuration de l'utilisateur et du groupe

   sudo groupadd jupyter
   sudo useradd -g jupyter -u 2841 -m -s /bin/bash jupyter
   
   sudo mkdir -p /opt/data
   sudo chown jupyter:jupyter /opt/data
   sudo chmod 777 /opt/data
   

3. Installer les paquets requis

   sudo apt update
   sudo apt install -y python3 python3-pip jupyter python3-virtualenv jupyter-server
   

4. Configuration de l'environnement virtuel

   mkdir -p /opt/data/jupyter
   chown jupyter:jupyter /opt/data/jupyter
   chmod 755 /opt/data/jupyter
   
   sudo su - jupyter -c "virtualenv -p python3 /opt/data/jupyter"
   

5. Installer JupyterLab et les dépendances

   source /opt/data/jupyter/bin/activate
   pip install -U jupyterlab jupyter-core voila jupyter-server
   deactivate
   

6. Configurer les paramètres de JupyterLab

   sudo -u jupyter /opt/data/jupyter/bin/jupyter notebook --generate-config -y
   sudo /opt/data/jupyter/bin/jupyter notebook --generate-config -y
   

7. Personnaliser la configuration de JupyterLab (optionnel)

   sudo sed -i 's/^# c.ServerApp.allow_origin = '\''\''$/c.ServerApp.allow_origin = '\''*'\''/' /root/.jupyter/jupyter_notebook_config.py
   

8. Créer le service systemd. Copier et coller ce qui suit dans un fichier nommé jupyterlab.service dans votre répertoire actuel via vim ou nano.

   [Service]
   Type=simple
   PIDFile=/run/jupyterlab.pid
   WorkingDirectory=/opt/data
   ExecStart=/opt/data/jupyter/bin/jupyter-lab --config=/root/.jupyter/jupyter_server_config.json --allow-root --ip=0.0.0.0 --no-browser --notebook-dir=/opt/data/jupyter/share/jupyter
   User=root  
   Group=root  
   Restart=always
   RestartSec=10
   [Install]
   WantedBy=multi-user.target
   

9. Démarrer et activer le service JupyterLab

   sudo cp jupyterlab.service /usr/lib/systemd/system/jupyterlab.service
   sudo systemctl daemon-reload
   sudo systemctl start jupyterlab
   sudo systemctl enable jupyterlab
   

10. Obtenir le jeton du serveur

    jupyter server list
    

    pour voir le jeton du serveur

11. Accéder à l'interface Web Jupyter et configurer le mot de passe :

    Ouvrez un navigateur Web et accédez à https://your-server-ip:8888. (Remplacez your-server-ip par l'adresse IP réelle de votre serveur). Ensuite, utilisez le jeton du serveur pour configurer un nouveau Mot de passe.

Configuration facile avec un script Bash (déploiement SSH et Invapi)¶

#!/bin/bash

# Mettre à jour le système
sudo apt update -y

# Configurer l'utilisateur et le groupe
groupadd jupyter   # Créer le groupe 'jupyter' s'il n'existe pas
useradd -g jupyter -u 2841 -m -s /bin/bash jupyter  # Créer l'utilisateur 'jupyter' avec gid, uid, etc. spécifiés

# Créer les répertoires et définir les permissions
mkdir -p /opt/data  
chown jupyter:jupyter /opt/data
chmod 777 /opt/data

# Installer les paquets
sudo apt update
sudo apt install -y python3 python3-pip jupyter python3-virtualenv jupyter-server

# Créer l'environnement virtuel
mkdir -p /opt/data/jupyter
chown jupyter:jupyter /opt/data/jupyter
chmod 755 /opt/data/jupyter
sudo su - jupyter -c "virtualenv -p python3 /opt/data/jupyter"

# Installer JupyterLab et les dépendances
source /opt/data/jupyter/bin/activate
pip install -U jupyterlab jupyter-core voila jupyter-server
deactivate

# Configurer les paramètres de JupyterLab
sudo -u jupyter /opt/data/jupyter/bin/jupyter notebook --generate-config -y
sudo /opt/data/jupyter/bin/jupyter notebook --generate-config -y

# Personnaliser la configuration de JupyterLab (optionnel)
sudo sed -i 's/^# c.ServerApp.allow_origin = '\''\''$/c.ServerApp.allow_origin = '\''*'\''/' /root/.jupyter/jupyter_notebook_config.py

# Obtenir l'adresse IP du serveur
IP_ADDRESS=$(hostname -I | awk '{print $1}')

# Créer le fichier de service systemd
cat << EOF > /etc/systemd/system/jupyterlab.service
[Service]
Type=simple
PIDFile=/run/jupyterlab.pid
WorkingDirectory=/opt/data
ExecStart=/opt/data/jupyter/bin/jupyter-lab --config=/root/.jupyter/jupyter_server_config.json --allow-root --ip=0.0.0.0 --no-browser --notebook-dir=/opt/data/jupyter/share/jupyter
User=root  
Group=root  
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
EOF

# Activer et démarrer le service JupyterLab
sudo systemctl daemon-reload
sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab

echo "Installation de JupyterLab terminée."

Utiliser le script sur la ligne de commande BASH¶

• • Connectez-vous à votre serveur via SSH.*
• • Enregistrez le script sous un fichier .sh (par ex., install.sh).*
• • Rendre le script exécutable : chmod +x install.sh.*
• • Exécuter le script sur votre serveur : ./install.sh.*
• • Utilisez http://:8888/ pour vous connecter à l'interface Web.*
• • Trouvez le jeton de votre serveur en utilisant la commande :*

  jupyter server list
  

• • Utilisez ce jeton pour définir un nouveau mot de passe.*

Utiliser le script lors de la réinstallation du serveur¶

• Collez le script pour le système d'exploitation pris en charge dans le champ Post-install script de l'onglet Advanced options.
• • Démarrez la réinstallation en cliquant sur le bouton Réinstaller ce serveur.