Обзор развертывания Jupyter Lab на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие условия:
-
Операционная система: Ubuntu.
-
Права доступа: Права суперпользователя (root) для установки системных пакетов и настройки сервисов.
-
Порты:
-
443(внешний порт HTTPS). -
8888(внутренний порт приложения).
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение |
|---|---|
| Префикс | lab |
| Домен | hostkey.in |
| Полный шаблон | lab{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные директории, используемые в системе:
-
/opt/data— основное хранилище данных приложения. -
/opt/data/jupyter— директория виртуального окружения Python. -
/root/nginx— конфигурационные файлы Docker Compose для прокси-сервера. -
/data/nginx/user_conf.d— пользовательские конфигурации Nginx. -
/data/nginx/nginx-certbot.env— файл переменных окружения для контейнера Nginx.
Процесс установки приложения¶
Развертывание Jupyter Lab выполняется в несколько этапов:
-
Подготовка системы:
-
Создается системная группа
jupyter(GID2841) и пользовательjupyter(UID2841). -
Подготавливается директория
/opt/dataс правами доступа для пользователяjupyter. -
Установка зависимостей:
-
Устанавливаются системные пакеты:
python3,python3-pip,jupyter,python3-virtualenv. -
Настройка окружения Python:
-
Создается виртуальное окружение в директории
/opt/data/jupyter. -
Внутри виртуального окружения устанавливаются пакеты:
jupyterlab,jupyter-core,voila,jupyter-server. -
Конфигурация приложения:
-
Генерируется конфигурационный файл Jupyter Lab.
-
В конфиг вносится изменение для разрешения внешних подключений (
c.ServerApp.allow_origin = '*'). -
Устанавливается пароль доступа для входа в интерфейс.
-
Настройка сервиса:
-
Создается системный юнит
jupyterlab.serviceдля автоматического запуска приложения при загрузке системы.
Права доступа и безопасность¶
-
Для работы с данными используется выделенный пользователь
jupyter. -
Приложение Jupyter Lab настроено на запуск от имени пользователя
rootчерез системный сервис для обеспечения корректной работы в специфических условиях окружения, но основные данные хранятся под пользователемjupyter. -
Доступ к интерфейсу защищен паролем.
Базы данных¶
В данной конфигурации внешние базы данных не используются; приложение использует локальную файловую систему для хранения рабочих файлов и настроек.
Контейнеры Docker и их запуск¶
Для обеспечения работы через HTTPS используется контейнер прокси-сервера:
| Параметр | Значение |
|---|---|
| Имя образа | jonasal/nginx-certbot:latest |
| Режим сети | host |
| Политика перезапуска | unless-stopped |
| Тома (volumes) | nginx_secrets:/etc/letsencrypt/data/nginx/user_conf.d:/etc/nginx/user_conf.d/home:/home |
| Переменные окружения | CERTBOT_EMAIL=hkadm@hostkey.com |
Кастомные скрипты и дополнительные настройки¶
-
Настройка конфигурации Jupyter: Выполняется автоматическая генерация файла
/root/.jupyter/jupyter_lab_config.pyи модификация его параметров для обеспечения работы через прокси. -
Установка пароля: Скрипт автоматически устанавливает пароль доступа, используя системные переменные окружения.
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо:
-
Обновить пакеты системы через
apt. -
Пересобрать виртуальное окружение или обновить пакеты внутри него с помощью
pip install --upgrade. -
Перезапустить сервис командой:
Расположение конфигурационных файлов и данных¶
-
Конфигурация Jupyter Lab:
/root/.jupyter/jupyter_server_config.json(или аналогичный файл в домашней директории пользователя). -
Данные пользователя:
/opt/data/jupyter/share/jupyter.
Доступные порты для подключения¶
-
443— через HTTPS (через прокси Nginx). -
8888— внутренний порт приложения.
Запуск, остановка приложения¶
Управление приложением осуществляется через системную службу:
-
Запуск:
systemctl start jupyterlab -
Остановка:
systemctl stop jupyterlab -
Статус:
systemctl status jupyterlab -
Перезагрузка:
systemctl restart jupyterlab