Como Instalar JupyterLab no Rocky Linux 9

Jupyter é um aplicativo web gratuito e de código aberto para computação interativa e ciência de dados.

Jupyter suporta todas as linguagens de programação e fornece múltiplos softwares, como JupyterLab, que oferece um ambiente de edição multi-notebook rico em recursos e com abas, Notebook como uma autoria de notebook leve e simplificada, Qtconsole, e muitos mais.

Neste guia, mostraremos instruções passo a passo sobre como instalar o JupyterLab no servidor Rocky Linux 9. Você instalará o JupyterLab, habilitará a autenticação do JupyterLab e, em seguida, configurará o Nginx como um proxy reverso.

Pré-requisitos

Para completar este guia, certifique-se de ter o seguinte:

• Um servidor Rocky Linux 9.
• Um usuário não-root com privilégios sudo.
• Um SELinux com status permissivo.

Instalar Dependências

Antes de instalar o JupyterLab, você deve instalar dependências no seu servidor Rocky Linux. Isso inclui Pip, Node.js e ferramentas de desenvolvimento. Além disso, você também instalará o Nginx para proxy reverso.

Para começar, execute o comando abaixo para instalar pacotes de desenvolvimento no seu sistema.

sudo dnf -y groupinstall development

Em seguida, instale o Pip, Node.js e Nginx usando o seguinte comando.

sudo dnf install -y python3-pip nodejs nginx

Uma vez que a instalação esteja completa, passe para o próximo passo.

Configurando o Ambiente Virtual Python

Neste exemplo, você instalará e executará o JupyterLab com um usuário normal. Portanto, certifique-se de que você preparou seu usuário com privilégios sudo.

Faça login no seu usuário usando o comando abaixo.

su - user

Crie um novo diretório ~/project e entre nele. Em seguida, crie um novo ambiente virtual Python venv.

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

Uma vez que o ambiente virtual venv é criado, você pode ativá-lo usando o comando abaixo.

source venv/bin/activate

Aqui, seu prompt deve se tornar como (venv) alice@hostname, o que significa que seu ambiente virtual Python está ativo.

Instalando JupyterLab

Agora que você criou um ambiente virtual Python, você está pronto para instalar o JupyterLab. Nesta seção, você instalará o JupyterLab, gerará a configuração do JupyterLab, configurará a autenticação por senha e, em seguida, verificará o JupyterLab.

Para instalar o JupyterLab, execute o comando pip3 abaixo.

pip3 install jupyter

Uma vez que a instalação comece, você deve obter uma saída como esta:

Após a instalação ser concluída, execute o comando abaixo para localizar o arquivo binário do Jupyter e verificar a versão do JupyterLab.

which jupyter  
jupyter --version

Você deve obter o arquivo binário do JupyterLab localizado no seu ambiente virtual Python. E a versão do JupyterLab é 4.1.1.

Em seguida, execute o comando Jupyter abaixo para gerar a configuração do servidor Jupyter e configurar a autenticação por senha.

jupyter server --generate-config  
jupyter server password

Quando solicitado a senha, insira sua nova senha e repita.

Em seguida, execute o comando abaixo para gerar o JupyterLab e insira y quando solicitado para sobrescrever. Depois, verifique sua configuração do JupyterLab.

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

Como você pode ver abaixo, a autenticação por senha está hash e o local do seu JupyterLab deve ser acessível.

Agora você pode executar o comando abaixo para abrir a porta 8888 para o JupyterLab. Em seguida, inicie seu JupyterLab no IP local 192.168.5.120 e certifique-se de alterar o endereço IP.

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

Uma vez iniciado, você deve obter uma saída semelhante a esta:

Agora abra seu navegador da web e visite seu endereço IP local com a porta 8888, http://192.168.5.120:8888/. Você será solicitado a página de login do JupyterLab.

Insira sua senha e pressione Log in.

Se bem-sucedido, você deve obter o painel do JupyterLab como o seguinte:

Por fim, volte ao seu terminal e pressione Ctrl+c para encerrar o processo do JupyterLab. No próximo passo, você configurará o JupyterLab como um serviço systemd.

Executando JupyterLab como Serviço Systemd

Com o JupyterLab instalado, você agora criará um novo serviço systemd para o JupyterLab. Isso permite que você gerencie o JupyterLab facilmente através de utilitários do sistema. Além disso, você pode iniciar o JupyterLab na inicialização ativando o serviço.

Agora execute o seguinte comando do editor nano para criar um novo serviço jupyterlab /etc/systemd/system/jupyterlab.service.

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

Adicione a configuração abaixo ao arquivo e certifique-se de alterar os detalhes do usuário para o seu usuário. Isso inclui o caminho binário do programa Jupyter e a configuração gerada.

[Unit]  
Description=Serviço 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 terminar, salve e saia do arquivo.

Em seguida, execute o comando abaixo para recarregar o gerenciador systemd e aplicar as alterações do systemd.

sudo systemctl daemon-reload

Depois, inicie e habilite o serviço jupyterlab com o seguinte comando.

sudo systemctl start jupyterlab  
sudo systemctl enable jupyterlab

Uma vez iniciado, execute o comando abaixo para verificar seu serviço jupyterlab.

sudo systemctl status jupyterlab

Se o serviço jupyterlab estiver em execução, você deve obter uma saída como a seguinte:

Configurando Acesso Remoto para JupyterLab

Para executar o JupyterLab atrás de um proxy reverso, você deve habilitar o acesso remoto na sua instalação do JupyterLab. Você precisa modificar o script de configuração padrão do JupyterLab e habilitar o acesso remoto a partir daí.

Execute o seguinte comando do editor nano para abrir o script de configuração do JupyterLab ~/.jupyter/jupyter_lab_config.py.

nano ~/.jupyter/jupyter_lab_config.py

Descomente o parâmetro c.ServerApp.allow_remote_access e altere o valor para True. Isso habilitará o acesso remoto para o proxy reverso na instalação do JupyterLab.

c.ServerApp.allow_remote_access = True

Quando terminar, salve e saia do arquivo.

Em seguida, execute o comando abaixo para reiniciar o serviço JupyterLab e verificar o token gerado. Este token será usado para fazer login no JupyterLab sob o proxy reverso.

sudo systemctl restart jupyterlab  
sudo systemctl status jupyterlab

Na parte inferior do log do serviço, você pode ver o token do JupyterLab.

Configurando o Proxy Reverso Nginx

Agora que você permitiu o acesso remoto no JupyterLab, está pronto para configurar o Nginx como um proxy reverso para sua instalação do JupyterLab.

Primeiro, execute o seguinte comando do editor nano para criar uma nova configuração do Nginx /etc/nginx/conf.d/jupyterlab.conf.

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

Insira a configuração abaixo e certifique-se de alterar o nome do domínio para sua instalação local do 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;  
}  
}

Salve e saia do arquivo quando terminar.

Agora execute o comando abaixo para verificar sua sintaxe do Nginx. Se bem-sucedido, você deve obter uma saída ‘syntax is ok - test is successful’.

sudo nginx -t

Em seguida, inicie e habilite o serviço Nginx usando o seguinte comando.

sudo systemctl start nginx  
sudo systemctl enable nginx

Uma vez que o Nginx inicie, verifique o serviço com o comando abaixo. Certifique-se de que o serviço Nginx esteja em execução.

sudo systemctl status nginx

Por fim, execute o comando abaixo para abrir a porta HTTP no seu sistema e permitir tráfego para sua instalação do JupyterLab.

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

Com isso, sua instalação do JupyterLab deve ser acessível via proxy reverso.

Fazendo Login no JupyterLab

Abra uma nova aba no seu navegador da web e visite o nome de domínio da sua instalação do JupyterLab, como http://jupyterlab.howtoforge.local/. Se sua instalação for bem-sucedida, você será solicitado a página de login do JupyterLab.

Role até a parte inferior da página e cole seu token do JupyterLab. Em seguida, insira a nova senha para sua instalação do JupyterLab e pressione Login e configure a nova senha.

Se você tiver o token correto, deve obter o painel do JupyterLab e sua senha também deve ter sido alterada.

Conclusão

Parabéns! Você instalou com sucesso o JupyterLab no Rocky Linux 9. Você instalou o JupyterLab, configurou a autenticação do JupyterLab e também configurou o Nginx como um proxy reverso para sua instalação do JupyterLab.