Cómo instalar JupyterLab en Rocky Linux 9

Jupyter es una aplicación web gratuita y de código abierto para la computación interactiva y la ciencia de datos.

Jupyter admite todos los lenguajes de programación y proporciona múltiples software, como JupyterLab, que ofrece un entorno de edición de múltiples cuadernos con muchas funciones y pestañas, Notebook como una herramienta de autoría de cuadernos ligera y simplificada, Qtconsole, y muchos más.

En esta guía, te mostraremos instrucciones paso a paso sobre cómo instalar JupyterLab en el servidor Rocky Linux 9. Instalarás JupyterLab, habilitarás la autenticación de JupyterLab y luego configurarás Nginx como un proxy inverso.

Requisitos previos

Para completar esta guía, asegúrate de tener lo siguiente:

• Un servidor Rocky Linux 9.
• Un usuario no root con privilegios sudo.
• Un SELinux con estado permisivo.

Instalar dependencias

Antes de instalar JupyterLab, debes instalar dependencias en tu servidor Rocky Linux. Esto incluye Pip, Node.js y herramientas de desarrollo. Además de eso, también instalarás Nginx para el proxy inverso.

Para comenzar, ejecuta el siguiente comando para instalar paquetes de desarrollo en tu sistema.

sudo dnf -y groupinstall development

Luego, instala Pip, Node.js y Nginx usando el siguiente comando.

sudo dnf install -y python3-pip nodejs nginx

Una vez que la instalación esté completa, pasa al siguiente paso.

Configurando el entorno virtual de Python

En este ejemplo, instalarás y ejecutarás JupyterLab con un usuario normal. Así que asegúrate de que tu usuario tenga privilegios sudo.

Inicia sesión en tu usuario usando el siguiente comando.

su - user

Crea un nuevo directorio ~/project y muévete a él. Luego, crea un nuevo entorno virtual de Python venv.

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

Una vez que se haya creado el entorno virtual venv, puedes activarlo usando el siguiente comando.

source venv/bin/activate

Aquí, tu indicador debería convertirse en (venv) alice@hostname, lo que significa que tu entorno virtual de Python está activo.

Instalando JupyterLab

Ahora que has creado un entorno virtual de Python, estás listo para instalar JupyterLab. En esta sección, instalarás JupyterLab, generarás la configuración de JupyterLab, configurarás la autenticación por contraseña y luego verificarás JupyterLab.

Para instalar JupyterLab, ejecuta el comando pip3 a continuación.

pip3 install jupyter

Una vez que comience la instalación, deberías obtener una salida como esta:

Después de que la instalación esté completa, ejecuta el siguiente comando para localizar el archivo binario de Jupyter y verificar la versión de JupyterLab.

which jupyter  
jupyter --version

Deberías obtener el archivo binario de JupyterLab ubicado en tu entorno virtual de Python. Y la versión de JupyterLab es 4.1.1.

A continuación, ejecuta el comando de Jupyter a continuación para generar la configuración del servidor Jupyter y configurar la autenticación por contraseña.

jupyter server --generate-config  
jupyter server password

Cuando se te pida la contraseña, ingresa tu nueva contraseña y repítela.

A continuación, ejecuta el siguiente comando para generar JupyterLab e ingresa y cuando se te pida sobrescribir. Luego, verifica tu configuración de JupyterLab.

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

Como puedes ver a continuación, la autenticación por contraseña está hashada y la ubicación de tu JupyterLab debería ser accesible.

Ahora puedes ejecutar el siguiente comando para abrir el puerto 8888 para JupyterLab. Luego, inicia tu JupyterLab en la IP local 192.168.5.120, y asegúrate de cambiar la dirección IP.

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

Una vez iniciado, deberías obtener una salida similar a esta:

Ahora abre tu navegador web y visita tu dirección IP local con el puerto 8888, http://192.168.5.120:8888/. Se te pedirá la página de inicio de sesión de JupyterLab.

Ingresa tu contraseña y presiona Iniciar sesión.

Si es exitoso, deberías obtener el panel de JupyterLab como el siguiente:

Por último, vuelve a tu terminal y presiona Ctrl+c para terminar el proceso de JupyterLab. En el siguiente paso, configurarás JupyterLab como un servicio systemd.

Ejecutando JupyterLab como servicio Systemd

Con JupyterLab instalado, ahora crearás un nuevo servicio systemd para JupyterLab. Esto te permite administrar JupyterLab fácilmente a través de la utilidad del sistema. Además, puedes iniciar JupyterLab al arrancar habilitando el servicio.

Ahora ejecuta el siguiente comando del editor nano para crear un nuevo servicio jupyterlab /etc/systemd/system/jupyterlab.service.

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

Agrega la configuración a continuación al archivo y asegúrate de cambiar el detalle del usuario con tu usuario. Esto incluye la ruta binaria del programa Jupyter y la configuración generada.

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

Cuando termines, guarda y sal del archivo.

A continuación, ejecuta el siguiente comando para recargar el administrador systemd y aplicar los cambios de systemd.

sudo systemctl daemon-reload

Luego, inicia y habilita el servicio jupyterlab con el siguiente comando.

sudo systemctl start jupyterlab  
sudo systemctl enable jupyterlab

Una vez que se inicie, ejecuta el siguiente comando para verificar tu servicio jupyterlab.

sudo systemctl status jupyterlab

Si el servicio jupyterlab está en ejecución, deberías obtener una salida como la siguiente:

Configurando el acceso remoto para JupyterLab

Para ejecutar JupyterLab detrás de un proxy inverso, debes habilitar el acceso remoto en tu instalación de JupyterLab. Necesitas modificar el script de configuración predeterminado de JupyterLab y habilitar el acceso remoto desde allí.

Ejecuta el siguiente comando del editor nano para abrir el script de configuración de JupyterLab ~/.jupyter/jupyter_lab_config.py.

nano ~/.jupyter/jupyter_lab_config.py

Descomenta el parámetro c.ServerApp.allow_remote_access y cambia el valor a True. Esto habilitará el acceso remoto para el proxy inverso en la instalación de JupyterLab.

c.ServerApp.allow_remote_access = True

Cuando termines, guarda y sal del archivo.

A continuación, ejecuta el siguiente comando para reiniciar el servicio JupyterLab y verificar el token generado. Este token se utilizará para iniciar sesión en JupyterLab bajo el proxy inverso.

sudo systemctl restart jupyterlab  
sudo systemctl status jupyterlab

En la parte inferior del registro del servicio, puedes ver el token de JupyterLab.

Configurando el proxy inverso de Nginx

Ahora que has permitido el acceso remoto en JupyterLab, estás listo para configurar Nginx como un proxy inverso para tu instalación de JupyterLab.

Primero, ejecuta el siguiente comando del editor nano para crear una nueva configuración de Nginx /etc/nginx/conf.d/jupyterlab.conf.

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

Inserta la configuración a continuación y asegúrate de cambiar el nombre de dominio con tu instalación local 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;  
}  
}

Guarda y sal del archivo cuando termines.

Ahora ejecuta el siguiente comando para verificar la sintaxis de Nginx. Si es exitoso, deberías obtener una salida ‘la sintaxis es correcta - la prueba es exitosa’.

sudo nginx -t

A continuación, inicia y habilita el servicio Nginx usando el siguiente comando.

sudo systemctl start nginx  
sudo systemctl enable nginx

Una vez que Nginx se inicie, verifica el servicio con el siguiente comando. Asegúrate de que el servicio Nginx esté en ejecución.

sudo systemctl status nginx

Por último, ejecuta el siguiente comando para abrir el puerto HTTP en tu sistema y permitir el tráfico a tu instalación de JupyterLab.

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

Con esto, tu instalación de JupyterLab debería ser accesible a través del proxy inverso.

Iniciando sesión en JupyterLab

Abre una nueva pestaña en tu navegador web y visita el nombre de dominio de tu instalación de JupyterLab, como http://jupyterlab.howtoforge.local/. Si tu instalación es exitosa, se te pedirá la página de inicio de sesión de JupyterLab.

Desplázate hasta la parte inferior de la página y pega tu token de JupyterLab. Luego, ingresa la nueva contraseña para tu instalación de JupyterLab y presiona Iniciar sesión y configurar la nueva contraseña.

Si tienes el token correcto, deberías obtener el panel de JupyterLab y tu contraseña también debería haber cambiado.

Conclusión

¡Felicidades! Has instalado con éxito JupyterLab en Rocky Linux 9. Has instalado JupyterLab, configurado la autenticación de JupyterLab y también configurado Nginx como un proxy inverso para tu instalación de JupyterLab.