JupyterHubLab

Для того, чтобы развернуть Hub:

Собрать образы

docker-compose build

Запустить следующую команду в директории с docker-compose.yml

docker-compose up -d

Завершать работу JupyterHub следует через веб-интерфейс admin панели. (Shutdown Hub)

Не рекомендуется использовать docker-compose down для завершения работы. Если вы все же воспользовались этой командой и испытываете трудности с повторным запуском, исправьте это, корректно остановив все контейнеры командой:

docker-compose down --remove-orphans

Об организации Hub

Docker-compose соберёт два образа: один для контейнера самого hub и proxy, контролирующего отдельных пользователей; второй - для контейнеров отдельных пользователей.

Данные каждого пользователя хранятся в отдельном volume jupyterhub-user-{username}. Также есть volume jupyterhub-shared, где хранятся ноутбуки, которыми пользователи делятся с другими участниками Hub. (в корневой директории пользователя совершён mount на этот volume в качестве папки /shared)

Структура папок

./
├── docker-compose.yml
│
├── jupiterlab
│   └── Dockerfile
│
└── jupyterhub
    ├── Dockerfile
    └── jupyterhub_config.py

Аунтификация

Для контроля аунтификации был выбран FirstUseAuthenticator. При первом вводе логина и пароля будет создан аккаунт с такими данными. При этом права администратора есть только у пользователя c именем admin.

Дополнительные возможности

Можно загрузить ноутбуки в Hub при его сборке из определённой папки. По умолчанию это папка /notebooks Изменить эту папку можно аргументом NOTEBOOKS_FROM в docker-compose.yml, учтите, что путь должен быть прописан относительно папки, в которой лежит docker-compose.yml. Можно также изменить целевую папку загрузки аргументом HUB_PATH.