Как установить JupyterLab на Rocky Linux 9

Jupyter — это бесплатное и открытое веб-приложение для интерактивных вычислений и науки о данных.

Jupyter поддерживает все языки программирования и предоставляет несколько программных решений, таких как JupyterLab, который предлагает богатую функциональность и вкладки для редактирования нескольких блокнотов, Notebook как легкий и упрощенный инструмент для создания блокнотов, Qtconsole и многие другие.

В этом руководстве мы покажем вам пошаговые инструкции по установке JupyterLab на сервер Rocky Linux 9. Вы установите JupyterLab, включите аутентификацию JupyterLab, а затем настроите Nginx как обратный прокси.

Предварительные требования

Чтобы завершить это руководство, убедитесь, что у вас есть следующее:

Сервер Rocky Linux 9.
Пользователь без прав root с правами sudo.
SELinux со статусом permissive.

Установка зависимостей

Перед установкой JupyterLab вам необходимо установить зависимости на вашем сервере Rocky Linux. Это включает Pip, Node.js и инструменты разработки. Кроме того, вы также установите Nginx для обратного прокси.

Для начала выполните команду ниже, чтобы установить пакеты разработки в вашу систему.

sudo dnf -y groupinstall development

Затем установите Pip, Node.js и Nginx, используя следующую команду.

sudo dnf install -y python3-pip nodejs nginx

После завершения установки переходите к следующему шагу.

install deps

Настройка виртуальной среды Python

В этом примере вы установите и запустите JupyterLab с обычным пользователем. Убедитесь, что вы подготовили своего пользователя с правами sudo.

Войдите в свою учетную запись, используя команду ниже.

su - user

Создайте новый каталог ~/project и перейдите в него. Затем создайте новую виртуальную среду Python venv.

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

После создания виртуальной среды venv вы можете активировать ее, используя команду ниже.

source venv/bin/activate

Теперь ваш приглашение должно выглядеть как (venv) alice@hostname, что означает, что ваша виртуальная среда Python активна.

setup venv

Установка JupyterLab

Теперь, когда вы создали виртуальную среду Python, вы готовы установить JupyterLab. В этом разделе вы установите JupyterLab, сгенерируете конфигурацию JupyterLab, настроите аутентификацию по паролю, а затем проверите JupyterLab.

Чтобы установить JupyterLab, выполните команду pip3 ниже.

pip3 install jupyter

Когда начнется установка, вы должны получить вывод, похожий на этот:

install jupyterlab

После завершения установки выполните команду ниже, чтобы найти бинарный файл Jupyter и проверить версию JupyterLab.

which jupyter  
jupyter --version

Вы должны получить бинарный файл JupyterLab, расположенный в вашей виртуальной среде Python. Версия JupyterLab — 4.1.1.

verify jupyter

Далее выполните команду Jupyter ниже, чтобы сгенерировать конфигурацию сервера Jupyter и настроить аутентификацию по паролю.

jupyter server --generate-config  
jupyter server password

Когда вас попросят ввести пароль, введите новый пароль и повторите его.

generate password jupyter server

Затем выполните команду ниже, чтобы сгенерировать JupyterLab и введите y, когда вас попросят перезаписать. Затем проверьте конфигурацию JupyterLab.

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

Как вы можете видеть ниже, аутентификация по паролю хэширована, и путь к вашей JupyterLab должен быть доступен.

generate config file jupyter lab

Теперь вы можете выполнить команду ниже, чтобы открыть порт 8888 для JupyterLab. Затем запустите JupyterLab на локальном IP 192.168.5.120 и убедитесь, что вы изменили IP-адрес.

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

После запуска вы должны получить вывод, похожий на этот:

test jupyterlab install

Теперь откройте веб-браузер и перейдите по вашему локальному IP-адресу с портом 8888, http://192.168.5.120:8888/. Вам будет предложено ввести данные для входа в JupyterLab.

Введите свой пароль и нажмите Войти.

Если все прошло успешно, вы должны увидеть панель управления JupyterLab, как показано ниже:

jupyterlab dashboard

Наконец, вернитесь в терминал и нажмите Ctrl+c, чтобы завершить процесс JupyterLab. На следующем шаге вы настроите JupyterLab как службу systemd.

Запуск JupyterLab как службы Systemd

С установленным JupyterLab вы теперь создадите новую службу systemd для JupyterLab. Это позволит вам легко управлять JupyterLab через системные утилиты. Также вы можете запускать JupyterLab при загрузке, включив службу.

Теперь выполните следующую команду редактора nano, чтобы создать новую службу jupyterlab /etc/systemd/system/jupyterlab.service.

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

Добавьте конфигурацию ниже в файл и убедитесь, что вы изменили детали пользователя на своего пользователя. Это включает путь к бинарному файлу программы Jupyter и сгенерированную конфигурацию.

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

Когда закончите, сохраните и выйдите из файла.

Затем выполните команду ниже, чтобы перезагрузить менеджер systemd и применить изменения systemd.

sudo systemctl daemon-reload

Затем запустите и включите службу jupyterlab с помощью следующей команды.

sudo systemctl start jupyterlab  
sudo systemctl enable jupyterlab

jupyterlab systemd

После запуска выполните команду ниже, чтобы проверить вашу службу jupyterlab.

sudo systemctl status jupyterlab

Если служба jupyterlab работает, вы должны получить вывод, похожий на следующий:

check jupyterlab service

Настройка удаленного доступа для JupyterLab

Чтобы запустить JupyterLab за обратным прокси, вам необходимо включить удаленный доступ в вашей установке JupyterLab. Вам нужно изменить скрипт конфигурации JupyterLab по умолчанию и включить удаленный доступ оттуда.

Выполните следующую команду редактора nano, чтобы открыть скрипт конфигурации JupyterLab ~/.jupyter/jupyter_lab_config.py.

nano ~/.jupyter/jupyter_lab_config.py

Распакуйте параметр c.ServerApp.allow_remote_access и измените значение на True. Это позволит включить удаленный доступ для обратного прокси в установке JupyterLab.

c.ServerApp.allow_remote_access = True

Когда закончите, сохраните и выйдите из файла.

Затем выполните команду ниже, чтобы перезапустить службу JupyterLab и проверить сгенерированный токен. Этот токен будет использоваться для входа в JupyterLab под обратным прокси.

sudo systemctl restart jupyterlab  
sudo systemctl status jupyterlab

Внизу журнала службы вы можете увидеть токен JupyterLab.

Настройка обратного прокси Nginx

Теперь, когда вы разрешили удаленный доступ в JupyterLab, вы готовы настроить Nginx как обратный прокси для вашей установки JupyterLab.

Сначала выполните следующую команду редактора nano, чтобы создать новую конфигурацию Nginx /etc/nginx/conf.d/jupyterlab.conf.

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

Вставьте конфигурацию ниже и убедитесь, что вы изменили имя домена на вашу локальную установку 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;  
}  
}

Сохраните и выйдите из файла, когда закончите.

Теперь выполните команду ниже, чтобы проверить синтаксис Nginx. Если все успешно, вы должны получить вывод ‘синтаксис в порядке - тест успешен’.

sudo nginx -t

Затем запустите и включите службу Nginx с помощью следующей команды.

sudo systemctl start nginx  
sudo systemctl enable nginx

setup nginx

После запуска Nginx проверьте службу с помощью команды ниже. Убедитесь, что служба Nginx работает.

sudo systemctl status nginx

verify nginx

Наконец, выполните команду ниже, чтобы открыть HTTP-порт на вашей системе и разрешить трафик к вашей установке JupyterLab.

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

С этим ваша установка JupyterLab должна быть доступна через обратный прокси.

Вход в JupyterLab

Откройте новую вкладку в вашем веб-браузере и перейдите по имени домена вашей установки JupyterLab, например http://jupyterlab.howtoforge.local/. Если ваша установка успешна, вам будет предложено ввести данные для входа в JupyterLab.

Прокрутите вниз до нижней части страницы и вставьте свой токен JupyterLab. Затем введите новый пароль для вашей установки JupyterLab и нажмите Войти и установить новый пароль.

Если у вас правильный токен, вы должны увидеть панель управления JupyterLab, и ваш пароль также должен быть изменен.