Jupyter est un bloc-notes interactif basé sur un navigateur populaire pour la programmation, les mathématiques et la science des données. Il s'agit d'une application Web qui nous permet de créer et de partager des documents contenant du code en direct, des équations, des visualisations et du texte narratif. Il prend en charge un certain nombre de langages via des plugins ("noyaux"), tels que Python, Ruby, Haskell, R, Scala et Julia. Dans ce tutoriel, nous allons vous montrer comment installer Jupyter sur Ubuntu 18.04 sur l'un de nos services d'hébergement Linux VPS.
Certaines des principales fonctionnalités de l'application Web Jupyter Notebook sont :
- Édition de code dans le navigateur avec mise en évidence automatique de la syntaxe, indentation et complétion/introspection des tabulations.
- Exécutez facilement du code à partir de votre navigateur Web préféré
- Affichage du résultat du calcul à l'aide de représentations rich media, telles que HTML, LaTeX, PNG, SVG, etc. Par exemple, des chiffres de qualité publication rendus par la bibliothèque matplotlib peuvent être inclus en ligne.
- La modification dans le navigateur du texte enrichi à l'aide du langage de balisage Markdown, qui peut fournir des commentaires pour le code, n'est pas limitée au texte brut.
- La possibilité d'inclure facilement une notation mathématique dans les cellules de démarquage à l'aide de LaTeX et rendue nativement par MathJax.
Prérequis :
- Ubuntu 18.04 avec 2 Go de mémoire ou plus
- Python 3
- Nginx
- Accès SSH avec privilèges root
1. Connectez-vous via SSH et mettez à jour le système
Connectez-vous à votre VPS Ubuntu 18.04 avec SSH en tant qu'utilisateur root :
# ssh root@IP_Address -p Port_number
Vous pouvez vérifier si vous avez la bonne version d'Ubuntu installée sur votre serveur avec la commande suivante :
lsb_release -a
Vous devriez obtenir ce résultat :
Distributor ID: Ubuntu Description: Ubuntu 18.04.1 LTS Release: 18.04 Codename: bionic
Ensuite, exécutez la commande suivante pour vous assurer que tous les packages installés sur le serveur sont mis à jour vers la dernière version disponible :
# apt update && apt upgrade
Créons un sudoer pour installer le notebook Jupyter, suivez les invites et utilisez un mot de passe fort pour l'utilisateur.
# adduser jupyter
Ajoutons maintenant le nouvel utilisateur au groupe sudo :
# usermod -aG sudo jupyter
Une fois ajouté, nous pouvons nous connecter en tant que jupyter et procéder à l'installation :
su - jupyter
$ sudo apt install python3-pip python3-dev
2. Créer un environnement virtuel Python pour Jupyter
$ virtualenv jnotebook
$ source jnotebook/bin/activate
Vous êtes maintenant dans l'environnement virtuel Python et vous êtes prêt à installer Jupyter Notebook.
3. Installer le bloc-notes Jupyter
(jnotebook) jupyter@ubuntu-jan2019:~$ pip instal jupyter
REMARQUE : Faites attention à la commande, même si nous utilisons Python 3, dans l'environnement virtuel Python, veuillez utiliser la commande 'pip' au lieu de 'pip3'. En effet, l'outil d'environnement virtuel est toujours nommé pip, quelle que soit la version de Python que nous utilisons.
4. Exécutez le bloc-notes Jupyter
C'est fait! Vous pouvez maintenant exécuter le Jupyter Notebook. Pour le démarrer (l'exécuter) réellement, entrez la commande suivante :
(jnotebook) jupyter@ubuntu-jan2019:~$ jupyter notebook
Par défaut, Jupyter Notebook est configuré pour s'exécuter sur localhost et le port 8888. Pour le démarrer sur une adresse IP spécifique, vous pouvez exécuter cette commande :
(jnotebook) jupyter@ubuntu-jan2019:~$ jupyter notebook --ip='1.2.3.4'
Remplacez 1.2.3.4 par l'adresse IP de votre serveur.
À l'aide de votre navigateur Web préféré, vous pouvez accéder au lien fourni lors de l'exécution de Jupyter.
À ce stade, vous accédez à Jupyter Notebook à l'aide du jeton. À partir de la version 5.3 de Notebook, nous pouvons créer un mot de passe via l'interface Web ou la ligne de commande.
Avant de créer un mot de passe, nous devons d'abord générer le fichier de configuration, nous pouvons exécuter cette commande :
(jnotebook) jupyter@ubuntu-jan2019:~$ jupyter notebook --generage-config
La commande ci-dessus créera un fichier jupyter_notebook_config.py. Dans ce tutoriel, le fichier est enregistré sous /home/jupyter/.jupyter/jupyter_notebook_config.py
La possibilité de créer un mot de passe lors de la première connexion peut être désactivée, vous devez l'activer en modifiant /home/jupyter/ .jupyter/jupyter_notebook_config.py. Allez à la ligne 68 et modifiez "NotebookApp.allow_password_change". Changez la valeur de False à True, et n'oubliez pas de décommenter la ligne. Ensuite, enregistrez le fichier.
Maintenant, nous pouvons exécuter la commande suivante pour créer un mot de passe, puis réexécuter Jupyter Notebook.
(jnotebook) jupyter@ubuntu-jan2019:~$ jupyter notebook password
(jnotebook) jupyter@ubuntu-jan2019:~$ jupyter notebook --ip='1.2.3.4'
5. Configurer Jupyter Notebook pour qu'il s'exécute en tant que service
Si nous exécutons la commande "Jupyter notebook" en SSH, l'application sera fermée lorsque nous serons déconnectés de la session SSH.
Pour éviter cela, nous pouvons exécuter la commande dans une session screen ou créer un fichier systemd. Dans ce didacticiel, nous allons créer un fichier systemd afin de pouvoir exécuter le bloc-notes Jupyter en tant que service.
$ sudo nano /etc/systemd/system/jupyter.service
Collez-y ensuite les lignes suivantes, puis enregistrez le fichier :
[Unit] Description=Jupyter Notebook [Service] Type=simple PIDFile=/run/jupyter.pid ExecStart=/home/jupyter/jupyter/bin/jupyter-notebook --config=/home/jupyter/.jupyter/jupyter_notebook_config.py User=jupyter Group=jupyter WorkingDirectory=/home/jupyter/jnotebook Restart=always RestartSec=10 [Install] WantedBy=multi-user.target
Une fois enregistré, nous devons activer et démarrer le service.
$ sudo systemctl daemon-reload $ sudo systemctl enable jupyter $ sudo systemctl start jupyter
6. Installez le serveur Web Nginx et configurez le proxy inverse
Désormais, Jupyter Notebook écoute uniquement sur localhost. Pour pouvoir y accéder en utilisant votre domaine ou sous-domaine, et sans saisir le numéro de port dans votre navigateur Web, nous devons configurer Nginx en tant que proxy inverse.
$ sudo nano /etc/nginx/sites-enabled/yourdomain.com.conf
Insérez les lignes suivantes dans le fichier. Remplacez "votredomaine.com" par le nom de domaine que vous souhaitez utiliser pour accéder à Jupyter Notebook :
upstream jupyter {
server 127.0.0.1:8888;
}
server {
listen 80 default;
server_name yourdomain.com;
access_log /var/log/nginx/yourdomain.com.access.log;
error_log /var/log/nginx/yourdomain.com.error.log;
location / {
proxy_pass http://localhost: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;
}
} N'oubliez pas de sauvegarder le fichier de configuration nouvellement créé.
Vérifiez la configuration de Nginx et si tout va bien, redémarrez-le.
$ sudo nginx -t $ sudo systemctl restart nginx
Maintenant, nous devons éditer le fichier de configuration Jupyter pour nous permettre d'y accéder en utilisant Nginx comme proxy inverse.
$ sudo nano /home/jupyter/.jupyter/jupyter_notebook_config.py
Allez trouver "NotebookApp.allow_remote_access" et changez la valeur de False à True. N'oubliez pas de décommenter la ligne.
Ensuite, redémarrez Jupyter :
$ sudo systemctl restart jupyter
À ce stade, vous devriez pouvoir accéder à Jupyter avec votre nom de domaine à l'adresse http://votredomaine.com. Pour plus d'informations sur Jupyter, ses fonctionnalités et sa configuration, veuillez consulter leur documentation officielle.
Bien sûr, vous n'avez pas besoin de savoir comment installer Jupyter sur Ubuntu 18.04 si vous avez un hébergement VPS Ubuntu géré avec nous. Vous pouvez simplement demander à notre équipe d'assistance d'installer Jupyter 10 sur Ubuntu 18.04 pour vous. Ils sont disponibles 24h/24 et 7j/7 et pourront vous aider à installer Jupyter 10 sur Ubuntu 18.04.
Si vous êtes déjà passé à Ubuntu 20.04, nous avons le tutoriel parfait pour installer Jupyter Notebook sur Ubuntu 20.04.
PS . Si vous aimez lire cet article de blog sur comment installer Jupyter sur Ubuntu 18.04 , n'hésitez pas à la partager sur les réseaux sociaux en utilisant les raccourcis ci-dessous, ou simplement laisser un commentaire.