Jupyter portable est un open source, une application web interactive qui vous permet d’écrire et exécuter le code informatique dans plus de 40 langages de programmation, y compris les Python, R, Juliaet Scala. Un produit de Jupyter projet, Jupyter portable est utile pour codage itératif car elle permet d’écrire un petit extrait de code, exécutez-le et retourner le résultat.
Jupyter ordinateur portable offre la possibilité de créer des documents de notebook, appelées simplement « cahiers ». Ordinateurs portables créés à partir de l’ordinateur portable de Jupyter sont des documents de recherche partageables, reproductible incluent des éléments de texte enrichi, équations, code et leurs sorties (figures, tableaux, parcelles interactives). Ordinateurs portables peuvent également être exportées dans des fichiers de code brut, HTML ou PDF documents, ou utilisé pour créer des diaporamas interactifs ou des pages web.
Cet article vous guidera dans la façon d’installer et de configurer l’application Jupyter pour ordinateur portable sur un serveur web d’Ubuntu 18.04 et comment s’y connecter depuis votre ordinateur local. En outre, nous irons également sur la façon d’utiliser Jupyter pour ordinateur portable pour exécuter quelques exemples de code Python.
Conditions préalables
Pour compléter ce tutoriel, vous aurez besoin :
Une instance de serveur Ubuntu 18.04. Ce serveur doit disposer d’un utilisateur non-root avec sudo privilèges et un pare-feu configuré. Mettre en place en suivant notre guide de configuration initiale du serveur.
Python 3, pip et le module de venv Python installé sur le serveur. Faire ceci en suivant les étapes 1 et 2 de notre tutoriel sur Comment installer Python 3 et Set Up a programmation environnement Local sur Ubuntu 18.04.
Un navigateur web moderne en cours d’exécution sur votre ordinateur local que vous utiliserez pour accéder aux Jupyter portable.
En outre, si votre ordinateur exécute Windows, vous devrez installer PuTTY sur elle afin d’établir un tunnel SSH à votre serveur. Suivez notre guide sur comment créer SSH Keys avec PuTTY sous Windows pour télécharger et installer PuTTY.
Étape 1 : Installation de Jupyter Notebook
Étant donné que les ordinateurs portables sont utilisés pour écrire, courir et voir le résultat de petits extraits de code, vous devrez tout d’abord mettre en place la programmation prise en charge linguistique. Jupyter ordinateur portable utilise un spécifique au langage noyau, un programme d’ordinateur qui s’exécute et introspects code. Jupyter portable a de nombreux noyaux dans des langues différentes, la valeur par défaut étant IPython. Dans ce tutoriel, vous allez définir Jupyter ordinateur portable d’exécuter du code Python à travers le noyau IPython.
En supposant que vous avez suivi les tutoriels liés dans la section composants requis, vous devriez avoir 3 Python, pip et un environnement virtuel installé. Les exemples dans ce guide de suivent la convention utilisée dans le tutoriel configuration requis sur l’installation de Python 3, qui nomme l’environnement virtuel «my_env», mais vous devriez vous sentir libre de le renommer.
Commencez par activer l’environnement virtuel :
source my_env/bin/activate
Suite à cela, votre prompte sera précédé par le nom de votre environnement.
Maintenant que vous êtes dans votre environnement virtuel, allez-y et installer Jupyter pour ordinateur portable :
python3 -m pip install jupyter
Si l’installation a réussi, vous verrez une sortie semblable au suivant :
Output
. . .
Successfully installed MarkupSafe-1.0 Send2Trash-1.5.0 backcall-0.1.0 bleach-2.1.3 decorator-4.3.0 entrypoints-0.2.3 html5lib-1.0.1 ipykernel-4.8.2 ipython-6.4.0 ipython-genutils-0.2.0 ipywidgets-7.2.1 jedi-0.12.0 jinja2-2.10 jsonschema-2.6.0 jupyter-1.0.0 jupyter-client-5.2.3 jupyter-console-5.2.0 jupyter-core-4.4.0 mistune-0.8.3 nbconvert-5.3.1 nbformat-4.4.0 notebook-5.5.0 pandocfilters-1.4.2 parso-0.2.0 pexpect-4.5.0 pickleshare-0.7.4 prompt-toolkit-1.0.15 ptyprocess-0.5.2 pygments-2.2.0 python-dateutil-2.7.3 pyzmq-17.0.0 qtconsole-4.3.1 simplegeneric-0.8.1 six-1.11.0 terminado-0.8.1 testpath-0.3.1 tornado-5.0.2
Avec cela, Jupyter Notebook a été installé sur votre serveur. Ensuite, nous irons sur la façon d’exécuter l’application.
Étape 2 — Exécute le portable Jupyter
Jupyter ordinateur portable doit être exécuté depuis votre VPS afin que vous pouvez connecter à partir de votre ordinateur local en utilisant un Tunnel SSH et votre navigateur web préféré.
Pour exécuter le serveur Jupyter pour ordinateur portable, entrez la commande suivante :
jupyter notebook
Après avoir exécuté cette commande, vous obtenez une sortie semblable au suivant :
Output
[I 19:46:22.031 NotebookApp] Writing notebook server cookie secret to /home/sammy/.local/share/jupyter/runtime/notebook_cookie_secret
[I 19:46:22.365 NotebookApp] Serving notebooks from local directory: /home/sammy/environments
[I 19:46:22.365 NotebookApp] 0 active kernels
[I 19:46:22.366 NotebookApp] The Jupyter Notebook is running at:
[I 19:46:22.366 NotebookApp] http://localhost:8888/?token=Example_Jupyter_Token_3cadb8b8b7005d9a46ca4d6675
[I 19:46:22.366 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[W 19:46:22.366 NotebookApp] No web browser found: could not locate runnable browser.
[C 19:46:22.367 NotebookApp]
Copy/paste this URL into your browser when you connect for the first time,
to login with a token:
http://localhost:8888/?token=Example_Jupyter_Token_3cadb8b8b7005d9a46ca4d6675&tokenExample_Jupyter_Token_3cadb8b8b7005d9a46ca4d6675
Vous remarquerez dans la sortie qu’il y a un avertissement No web browser found . Cela doit être prévu, étant donné que l’application s’exécute sur un serveur et probablement vous n’avez pas installé un navigateur web sur elle. Ce guide ira sur comment se connecter à l’ordinateur portable sur le serveur en utilisant SSH tunneling dans la section suivante.
Pour l’instant, sortez le portable de Jupyter en appuyant sur CTRL+C , suivi de y, puis appuyez sur ENTER pour confirmer :
Output
Shutdown this notebook server (y/[n])? y
[C 20:05:47.654 NotebookApp] Shutdown confirmed
[I 20:05:47.654 NotebookApp] Shutting down 0 kernels
Puis ouvrez une session sur le serveur en utilisant la commande de exit :
exit
Vous avez juste lancer Jupyter pour ordinateur portable sur votre serveur. Toutefois, afin d’accéder à l’application et commencer à travailler avec les ordinateurs portables, vous aurez besoin pour vous connecter à l’application à l’aide de tunneling SSH ainsi qu’un navigateur web sur votre ordinateur local.
Etape 3 : Connexion à l’Application de Jupyter Notebook avec SSH Tunneling
Tunneling SSH est une façon simple et rapide pour se connecter à l’application Jupyter pour ordinateur portable en cours d’exécution sur votre serveur. Secure shell (plus communément appelée ” SSH”) est un protocole réseau qui permet de se connecter à un serveur distant en toute sécurité sur un réseau non sécurisé.
Le protocole SSH comprend un mécanisme qui permet à certaines applications qui s’exécutent sur un numéro de port spécifique sur un serveur à un numéro de port spécifique sur votre ordinateur local-tunnel de redirection de port. Nous apprendrons comment bien « avant » l’application Jupyter pour ordinateur portable en cours d’exécution sur votre serveur (sur le port 8888, par défaut) à un port sur votre ordinateur local.
La méthode utilisée pour établir un tunnel SSH dépendra du système d’exploitation de votre ordinateur local. Sauter à la sous-section ci-dessous qui est le plus pertinente pour votre machine.
Remarque : Il est possible de configurer et installer l’ordinateur portable de Jupyter à l’aide de la Console Web de DigitalOcean, mais se connecter à l’application via un tunnel SSH doit être fait par l’intermédiaire de la borne ou avec du mastic.
SSH Tunneling utilisant macOS ou Linux
Si votre ordinateur exécute Linux ou macOS, il est possible d’établir un tunnel SSH en exécutant une commande unique.
ssh est la commande standard pour ouvrir une connexion SSH, mais lorsqu’il est utilisé avec la directive -L , vous pouvez spécifier qu’un port donné sur l’hôte local (c’est-à-dire votre machine locale) est transmis à un hôte donné et le port sur l’hôte distant (dans ce cas votre serveur). Cela signifie que tout ce qui s’exécute sur le port spécifié sur le serveur distant (8888, port par défaut de l’ordinateur portable Jupyter) s’affiche sur le port spécifié sur votre ordinateur local (8000 à l’exemple de commande).
Pour établir votre propre tunnel SSH, exécutez la commande suivante. N’hésitez pas à changer le port 8000 à celle de votre choix si, par exemple, 8000 est utilisé par un autre processus. Il est recommandé que vous utilisez un port supérieur ou égal à 8000, que ces numéros de port sont peu susceptibles d’être utilisés par un autre processus. N’oubliez pas d’inscrire votre propre adresse IP du serveur et le nom d’utilisateur non-root de votre serveur :
ssh -L 8000:localhost:8888 sammy@your_server_ip
Si il n’y a aucune erreur de cette commande, il vous consignera dans votre serveur distant. A partir de là, activer l’environnement virtuel :
source ~/environments/my_env/bin/activate
Puis exécutez l’application Jupyter pour ordinateur portable :
jupyter notebook
Pour vous connecter à Jupyter pour ordinateur portable, utilisez votre navigateur web préféré pour naviguer sur le port local sur l’hôte local : http://localhost:8000. Maintenant que vous êtes connecté à l’ordinateur portable Jupyter, poursuivez étape 4 pour apprendre à l’utiliser.
SSH Tunneling utilisant Vitre et mastic
PuTTY est un client SSH libre pour Windows qui peut être utilisé pour se connecter à votre serveur. Après téléchargement et installation de PuTTY sur votre machine Windows (tel que décrit dans le tutoriel de configuration requis), ouvrez le programme et entrez votre adresse URL ou l’adresse IP du serveur, comme indiqué ici :
Enter server URL or IP into Putty
Ensuite, cliquez sur + SSH au bas du volet gauche, puis sur les Tunnels. Dans cette fenêtre, entrez le port que vous souhaitez utiliser pour accéder à Jupyter sur votre ordinateur local (8000 ). Il est recommandé d’utiliser un port supérieur ou égal à 8000 que ces numéros de port sont peu susceptibles d’être utilisés par un autre processus. Si 8000 est utilisé par un autre processus, cependant, sélectionnez un numéro de port différent, non utilisé. Ensuite, définissez la destination comme localhost:8888, puisque le port 8888 est celui qui Jupyter portable est en cours d’exécution sur. Puis cliquez sur le bouton Ajouter et les ports doivent apparaître dans le champ ports transmis :
Configure SSH tunnel in Putty
Enfin, cliquez sur le bouton ouvrir . Cela sera aussi bien connecter votre ordinateur au serveur via SSH et tunnel les ports souhaités. Si aucune erreur n’apparaît pas, aller de l’avant et activer votre environnement virtuel :
source ~/environments/my_env/bin/activate
Puis exécutez Jupyter pour ordinateur portable :
jupyter notebook
Ensuite, accédez à la voie locale dans votre navigateur web préféré, par exemple http://localhost:8000 (ou quel que soit le port numéro que vous avez choisi), pour vous connecter à l’instance de Jupyter pour ordinateur portable en cours d’exécution sur le serveur. Maintenant que vous êtes connecté à l’ordinateur portable Jupyter, poursuivez étape 4 pour apprendre à l’utiliser.
Étape 4 — Utilisation ordinateur portable Jupyter
Lorsque vous y accédez via un navigateur web, Jupyter Notebook fournit un tableau de bord portable qui agit comme un Explorateur de fichiers et vous donne une interface pour créer, éditer et Explorer portables. Pensez à ces cahiers sous forme de documents (enregistrés avec une extension de fichier .ipynb ) qui vous remplir avec n’importe quel nombre de cellules individuelles. Chaque cellule conserve un texte interactif éditeur qui peut être utilisé pour exécuter le code ou écriture texte rendu. En outre, les ordinateurs portables vous permettent d’écrire et exécuter des équations, inclure d’autres multimédias, comme des images ou des parcelles interactives, et ils peuvent être exportés et partagés dans différents formats (.ipyb, .pdf, .py). Pour illustrer certaines de ces fonctions, nous allons créer un fichier de bloc-notes du tableau de bord pour ordinateur portable, écrire une planche de texte simple avec une équation et exécuter du code Python 3 base.
À ce stade, vous devriez avoir connecté au serveur via un tunnel SSH et a commencé l’application Jupyter pour ordinateur portable de votre serveur. Après avoir navigué à http://localhost:8000, vous obtiendrez une page de connexion :
Jupyter Notebook login screen
Dans le champ mot de passe ou jeton en haut, entrez le jeton affiché dans la sortie, après que vous avez exécuté jupyter notebook depuis votre serveur :
Output
[I 20:35:17.004 NotebookApp] Writing notebook server cookie secret to /run/user/1000/jupyter/notebook_cookie_secret
[I 20:35:17.314 NotebookApp] Serving notebooks from local directory: /home/sammy
[I 20:35:17.314 NotebookApp] 0 active kernels
[I 20:35:17.315 NotebookApp] The Jupyter Notebook is running at:
[I 20:35:17.315 NotebookApp] http://localhost:8888/?token=Example_Jupyter_Token_3cadb8b8b7005d9a46ca4d6675
[I 20:35:17.315 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[W 20:35:17.315 NotebookApp] No web browser found: could not locate runnable browser.
[C 20:35:17.316 NotebookApp]
. . .
Alternativement, vous pouvez copier cette URL de votre sortie de terminal et collez-le dans la barre d’adresse de votre navigateur.
Jupyter portable affichera automatiquement, tous les fichiers et les dossiers stockés dans le répertoire à partir duquel il est exécuté. Créez un nouveau fichier de carnet en cliquant sur nouveau puis Python 3 en haut à droite du tableau de bord pour ordinateur portable :
Create a new Python3 notebook
Au sein de ce nouveau cahier, modifier la première cellule pour accepter la syntaxe markdown en cliquant sur les cellules > Cellule Type > démarques sur la barre de navigation en haut. En plus du format markdown, ce Type de cellule vous permet également d’écrire des équations en LaTeX. Par exemple, tapez ce qui suit dans la cellule après avoir changé de format markdown :
# Simple Equation
Let us now implement the following equation in Python:
$$ y = x^2$$
where $x = 2$
Pour transformer la démarque en texte enrichi, appuyez sur CTRL + ENTER et le texte suivant doit être le résultat :
Turn sample equation into rich text
Vous pouvez utiliser les cellules markdown pour prendre des notes et de documenter votre code.
Maintenant, nous allons mettre en place une équation simple et imprimer le résultat. Cliquez sur insertion > Insérer une cellule en dessous pour insérer une cellule. Dans cette nouvelle cellule, entrez le code suivant :
x = 2
y = x*x
print(y)
Pour exécuter le code, appuyez sur CTRL + ENTER, et la suite sera le résultat :
Solve sample equation
Voici quelques exemples relativement simples de ce que vous pouvez faire avec Jupyter portable. Cependant, c’est une application très puissante avec beaucoup de potentiel des cas d’usage. De là, vous pouvez ajouter quelques librairies Python et utiliser le portable comme vous le feriez avec n’importe quel autre environnement de développement Python.
Conclusion
Vous devriez maintenant être capable d’écrire le code de Python reproductible et texte à l’aide de l’ordinateur portable de Jupyter en cours d’exécution sur un serveur distant. Pour obtenir un tour rapide de Jupyter pour ordinateur portable, cliquez sur aide dans la barre de navigation supérieure et sélectionnez Tour d’Interface utilisateur , comme illustré ici :
Finding Jupyter Notebook help tour
Si vous êtes intéressé, nous vous encourageons à en savoir plus sur Jupyter pour ordinateur portable en passant par la documentation de projet Jupyter. En outre, vous pouvez construire ce que vous avez appris dans ce tutoriel en apprenant comment coder en Python 3.