ansible jupyterhub

Эта роль установит zero-to-jupyterhub.

На данный момент протестированы и работают Ubuntu 20 и 18. Пока она не работает должным образом на системах redhat, мы над этим работаем.

Требования

Для работы требуется docker и k3s.

Переменные роли

• JH_AUTH_CLASS можно установить на github, dummy или оставить пустым, что будет использовать pam-аутентификацию.

• JH_DUMMY_PASS - пароль для использования класса dummy. Если не установлен, аутентификация dummy не может быть использована.

• JH_OAUTH2_CLIENT_ID - идентификатор клиента для следующих аутентификаций: github.

• JH_OAUTH2_CLIENT_SECRET - секретный код клиента для следующих аутентификаций: github.

• JH_OAUTH2_CALLBACK_URL - URL обратного вызова для следующих аутентификаций: github.

• JH_SINGLEUSER_EXCLUDE_MASTER - если true, это предотвратит запуск одно-пользовательских ноутбуков на главном узле.

• JH_SINGLEUSER_IMAGE - образ для использования с jupyter; по умолчанию jupyter/datascience-notebook.

• JH_SINGLEUSER_IMAGE_TAG - тег образа для использования с jupyter; по умолчанию latest.

• JH_SINGLEUSER_DEFAULT_URL - URL по умолчанию для jupyter; по умолчанию "/lab".

• JH_SINGLEUSER_GPU_ENABLE - по умолчанию нет gpu.

• JH_SINGLEUSER_START_TIMEOUT - время ожидания для запуска одно-пользовательских контейнеров; по умолчанию 600.

• JH_SINGLEUSER_HTTP_TIMEOUT - время ожидания для связи контейнера с хабом; по умолчанию 600.

• JH_SINGLEUSER_MEMORY_GUARANTEE - минимальная память для одно-пользовательских контейнеров; по умолчанию 1G.

• JH_SINGLEUSER_MEMORY_LIMIT - максимальная память для одно-пользовательских контейнеров; без значения по умолчанию (без ограничений).

• JH_SINGLEUSER_CPU_GUARANTEE - минимальный процессор для одно-пользовательских контейнеров; по умолчанию 0.5.

• JH_SINGLEUSER_CPU_LIMIT - максимальный процессор для одно-пользовательских контейнеров; без значения по умолчанию (1 процессор?).

• JH_ALLOWED_USERS - список пользователей, которым разрешен вход в приложение.

• JH_ADMINS - список пользователей-администраторов.

• JH_SHARED_STORAGE_ENABLE - установите в true, если включаете общий storage.

• JH_SHARED_STORAGE_PV_NAME - укажите имя постоянного тома.

• JH_SHARED_STORAGE_PVC_NAME - укажите имя заявки на постоянный том.

• JH_SHARED_STORAGE_MOUNT_DIR - укажите каталог монтирования в контейнере; по умолчанию = /home/jovyan/shared.

• JH_RESOURCES_REQUEST_CPU - если установлено, это настройки процессора для контейнера хаба; от 0m до 1000m.

• JH_RESOURCES_REQUEST_MEMORY - если установлено, это настройки памяти для контейнера хаба; от 200Mi до 4Gi.

• JH_INGRESS_ENABLED - если установлено, это включит ingress.

• JH_INGRESS_CLASS - по умолчанию nginx.

• JH_INGRESS_BODY_SIZE - устанавливает максимальный размер тела прокси. По умолчанию "4096m".

• JH_INGRESS_HOSTNAME - если установлен, установит имя хоста для ingress.

• JH_DB_PVC_STORAGE_CLASS_NAME - если установлен, будет название класса хранения.

• JH_PREPULL_IMAGES - если установлено, хаб предварительно загрузит образы на все узлы до их доступности. Установите в false, если образы слишком большие или слишком много узлов. По умолчанию true.

Зависимости

• Эта роль требует kubernetes, обычно устанавливается с помощью k3s. Если helm не установлен, то он будет установлен.

Пример плейбука

Включение примера того, как использовать вашу роль (например, с переданными в качестве параметров переменными) всегда полезно для пользователей:

• name: Этот плейбук установит jupyterhub hosts: jupyterhub roles:
  • ansible-docker
  • ansible-jupyterhub

Лицензия

BSD

Информация об авторе

Для получения дополнительной информации, пожалуйста, свяжитесь с Эдвином Скидмором (edwin@cyverse.org)