Come installare JupyterLab su Rocky Linux 9

Jupyter è un’applicazione web gratuita e open-source per il calcolo interattivo e la scienza dei dati.

Jupyter supporta tutti i linguaggi di programmazione e fornisce diversi software, come JupyterLab, che offre un ambiente di editing multi-notebook ricco di funzionalità e a schede, Notebook come un’autore semplificata e leggera, Qtconsole e molti altri.

In questa guida, ti mostreremo istruzioni passo-passo su come installare JupyterLab sul server Rocky Linux 9. Installerai JupyterLab, abiliterai l’autenticazione di JupyterLab e poi configurerai Nginx come reverse proxy.

Prerequisiti

Per completare questa guida, assicurati di avere quanto segue:

Un server Rocky Linux 9.
Un utente non root con privilegi sudo.
Un SELinux con stato permissivo.

Installare le dipendenze

Prima di installare JupyterLab, devi installare le dipendenze sul tuo server Rocky Linux. Questo include Pip, Node.js e strumenti di sviluppo. Inoltre, installerai anche Nginx per il reverse proxy.

Per iniziare, esegui il comando qui sotto per installare i pacchetti di sviluppo sul tuo sistema.

sudo dnf -y groupinstall development

Poi, installa Pip, Node.js e Nginx utilizzando il seguente comando.

sudo dnf install -y python3-pip nodejs nginx

Una volta completata l’installazione, passa al passaggio successivo.

install deps

Configurare l’ambiente virtuale Python

In questo esempio, installerai e eseguirai JupyterLab con un utente normale. Assicurati quindi di aver preparato il tuo utente con privilegi sudo.

Accedi al tuo utente utilizzando il comando qui sotto.

su - user

Crea una nuova directory ~/project e spostati al suo interno. Poi, crea un nuovo ambiente virtuale Python venv.

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

Una volta creato l’ambiente virtuale venv, puoi attivarlo utilizzando il comando qui sotto.

source venv/bin/activate

Qui, il tuo prompt dovrebbe diventare simile a (venv) alice@hostname, il che significa che il tuo ambiente virtuale Python è attivo.

setup venv

Installare JupyterLab

Ora che hai creato un ambiente virtuale Python, sei pronto per installare JupyterLab. In questa sezione, installerai JupyterLab, genererai la configurazione di JupyterLab, imposterai l’autenticazione con password e poi verificherai JupyterLab.

Per installare JupyterLab, esegui il comando pip3 qui sotto.

pip3 install jupyter

Una volta che l’installazione inizia, dovresti ottenere un output simile a questo:

install jupyterlab

Dopo che l’installazione è completa, esegui il comando qui sotto per localizzare il file binario di Jupyter e controllare la versione di JupyterLab.

which jupyter  
jupyter --version

Dovresti ottenere il file binario di JupyterLab situato nel tuo ambiente virtuale Python. E la versione di JupyterLab è 4.1.1.

verify jupyter

Successivamente, esegui il comando Jupyter qui sotto per generare la configurazione del server Jupyter e impostare l’autenticazione con password.

jupyter server --generate-config  
jupyter server password

Quando ti viene chiesta la password, inserisci la tua nuova password e ripetila.

generate password jupyter server

Successivamente, esegui il comando qui sotto per generare JupyterLab e inserisci y quando ti viene chiesto di sovrascrivere. Poi, verifica la tua configurazione di JupyterLab.

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

Come puoi vedere qui sotto, l’autenticazione con password è hashata e il percorso della tua JupyterLab dovrebbe essere accessibile.

generate config file jupyter lab

Puoi ora eseguire il comando qui sotto per aprire la porta 8888 per JupyterLab. Poi, avvia il tuo JupyterLab sull’IP locale 192.168.5.120 e assicurati di cambiare l’indirizzo IP.

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

Una volta avviato, dovresti ottenere un output simile a questo:

test jupyterlab install

Ora apri il tuo browser web e visita il tuo indirizzo IP locale con la porta 8888, http://192.168.5.120:8888/. Ti verrà presentata la pagina di accesso di JupyterLab.

Inserisci la tua password e premi Accedi.

Se hai successo, dovresti ottenere il dashboard di JupyterLab come il seguente:

jupyterlab dashboard

Infine, torna al tuo terminale e premi Ctrl+c per terminare il processo di JupyterLab. Nel passaggio successivo, configurerai JupyterLab come servizio systemd.

Eseguire JupyterLab come servizio Systemd

Con JupyterLab installato, ora creerai un nuovo servizio systemd per JupyterLab. Questo ti consente di gestire facilmente JupyterLab tramite l’utilità di sistema. Inoltre, puoi avviare JupyterLab all’avvio abilitando il servizio.

Ora esegui il seguente comando dell’editor nano per creare un nuovo servizio jupyterlab /etc/systemd/system/jupyterlab.service.

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

Aggiungi la configurazione qui sotto al file e assicurati di cambiare i dettagli dell’utente con il tuo utente. Questo include il percorso binario del programma Jupyter e la configurazione generata.

[Unit]  
Description=Servizio 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

Quando hai finito, salva ed esci dal file.

Successivamente, esegui il comando qui sotto per ricaricare il gestore systemd e applicare le modifiche di systemd.

sudo systemctl daemon-reload

Poi, avvia e abilita il servizio jupyterlab con il seguente comando.

sudo systemctl start jupyterlab  
sudo systemctl enable jupyterlab

jupyterlab systemd

Una volta avviato, esegui il comando qui sotto per verificare il tuo servizio jupyterlab.

sudo systemctl status jupyterlab

Se il servizio jupyterlab è in esecuzione, dovresti ottenere un output simile al seguente:

check jupyterlab service

Configurare l’accesso remoto per JupyterLab

Per eseguire JupyterLab dietro un reverse proxy, devi abilitare l’accesso remoto sulla tua installazione di JupyterLab. Devi modificare lo script di configurazione predefinito di JupyterLab e abilitare l’accesso remoto da lì.

Esegui il seguente comando dell’editor nano per aprire lo script di configurazione di JupyterLab ~/.jupyter/jupyter_lab_config.py.

nano ~/.jupyter/jupyter_lab_config.py

Decommenta il parametro c.ServerApp.allow_remote_access e cambia il valore in True. Questo abiliterà l’accesso remoto per il reverse proxy nell’installazione di JupyterLab.

c.ServerApp.allow_remote_access = True

Quando hai finito, salva ed esci dal file.

Successivamente, esegui il comando qui sotto per riavviare il servizio JupyterLab e verificare il token generato. Questo token sarà utilizzato per accedere a JupyterLab sotto il reverse proxy.

sudo systemctl restart jupyterlab  
sudo systemctl status jupyterlab

In fondo al log del servizio, puoi vedere il token di JupyterLab.

Configurare Nginx come reverse proxy

Ora che hai consentito l’accesso remoto in JupyterLab, sei pronto per configurare Nginx come reverse proxy per la tua installazione di JupyterLab.

Per prima cosa, esegui il seguente comando dell’editor nano per creare una nuova configurazione Nginx /etc/nginx/conf.d/jupyterlab.conf.

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

Inserisci la configurazione qui sotto e assicurati di cambiare il nome di dominio con la tua installazione locale di 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;  
}  
}

Salva ed esci dal file quando hai finito.

Ora esegui il comando qui sotto per verificare la sintassi di Nginx. Se hai successo, dovresti ottenere un output ‘syntax is ok - test is successful’.

sudo nginx -t

Successivamente, avvia e abilita il servizio Nginx utilizzando il seguente comando.

sudo systemctl start nginx  
sudo systemctl enable nginx

setup nginx

Una volta avviato Nginx, verifica il servizio con il comando qui sotto. Assicurati che il servizio Nginx sia in esecuzione.

sudo systemctl status nginx

verify nginx

Infine, esegui il comando qui sotto per aprire la porta HTTP sul tuo sistema e consentire il traffico alla tua installazione di JupyterLab.

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

Con questo, la tua installazione di JupyterLab dovrebbe essere accessibile tramite reverse proxy.

Accedere a JupyterLab

Apri una nuova scheda nel tuo browser web e visita il nome di dominio della tua installazione di JupyterLab, come http://jupyterlab.howtoforge.local/. Se la tua installazione ha avuto successo, ti verrà presentata la pagina di accesso di JupyterLab.

Scorri fino in fondo alla pagina e incolla il tuo token di JupyterLab. Poi, inserisci la nuova password per la tua installazione di JupyterLab e premi Accedi e imposta la nuova password.

Se hai il token corretto, dovresti ottenere il dashboard di JupyterLab e la tua password dovrebbe essere cambiata.