Перейти к содержанию

Обзор развертывания 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 выполняется в несколько этапов:

  1. Подготовка системы:

  2. Создается системная группа jupyter (GID 2841) и пользователь jupyter (UID 2841).

  3. Подготавливается директория /opt/data с правами доступа для пользователя jupyter.

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

  5. Устанавливаются системные пакеты: python3, python3-pip, jupyter, python3-virtualenv.

  6. Настройка окружения Python:

  7. Создается виртуальное окружение в директории /opt/data/jupyter.

  8. Внутри виртуального окружения устанавливаются пакеты: jupyterlab, jupyter-core, voila, jupyter-server.

  9. Конфигурация приложения:

  10. Генерируется конфигурационный файл Jupyter Lab.

  11. В конфиг вносится изменение для разрешения внешних подключений (c.ServerApp.allow_origin = '*').

  12. Устанавливается пароль доступа для входа в интерфейс.

  13. Настройка сервиса:

  14. Создается системный юнит 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 и модификация его параметров для обеспечения работы через прокси.

  • Установка пароля: Скрипт автоматически устанавливает пароль доступа, используя системные переменные окружения.

Инструкция по обновлению приложения

Для обновления основного приложения необходимо:

  1. Обновить пакеты системы через apt.

  2. Пересобрать виртуальное окружение или обновить пакеты внутри него с помощью pip install --upgrade.

  3. Перезапустить сервис командой:

    systemctl restart jupyterlab
    

Расположение конфигурационных файлов и данных

  • Конфигурация 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

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×