jupyterhub-container

Добавляет службу Jupyter Hub в ваш проект Ansible Container. Выполните следующие команды для установки службы:

# Установите рабочий каталог на корень вашего проекта Ansible Container
$ cd myproject

# Установите службу
$ ansible-container install marcusianlevine.jupyterhub-container

Требования

• Ansible Container
• Существующий проект Ansible Container. Чтобы создать проект, просто выполните следующее:

  # Создайте пустую директорию проекта
  $ mkdir myproject
  
  # Установите рабочий каталог на новую директорию
  $ cd myproject
  
  # Инициализируйте проект
  $ ansible-container init
  

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

• vars_files
  • Дополнительный список путей относительных к /src на Кондукторе с YAML файлами переменных
• extra_pip_packages: [dockerspawner]
  • Список дополнительных пакетов pip для установки вместе с JupyterHub

Файлы и директории

• jupyterhub_config_dir: /etc/jupyterhub/
  • Абсолютный путь к директории, где будет размещен файл конфигурации JupyterHub
• jupyterhub_config_path: "{{ jupyterhub_config_dir }}/jupyterhub_config.py"
  • Абсолютный путь к файлу конфигурации JupyterHub
• jupyterhub_srv_dir: /srv/jupyterhub
• jupyterhub_pip_version: 0.8.1
• jupyter_config_dir: /etc/jupyter
  • Абсолютный путь к директории, где будет размещен файл конфигурации Jupyter notebook
• jupyter_share_dir: /usr/local/share/jupyter
• jupyter_templates_dir: "{{ jupyter_config_dir }}/templates"
• ipython_config_dir: /etc/ipython

Настройки спавнера

• use_helm: no
  • Нацеливайтесь на kubespawner через Zero-to-JupyterHub Helm Chart
• allow_sudo: no
  • Запускать блокноты для одного пользователя с правами sudo
  • ПРЕДУПРЕЖДЕНИЕ: использование этой опции с контейнеризированными спавнерами создаст риск безопасности
• mem_limit: yes
  • По умолчанию ограничения нет. Установите допустимый mem_limit Docker или Kubernetes, например, 10G

Аутентификация пользователей

• use_oauth: no
  • Используйте GitHub OAuth для аутентификации пользователей
• use_ldap: no
  • Используйте ldapauthenticator для аутентификации пользователей
  • См. документацию для получения информации о следующих настройках
• ldap_domain
• ldap_bind_dn_template
• ldap_allowed_group
• ldap_user_search_base
• ldap_search_user
• ldap_user_attribute
• user_list: []
  • Белый список пользователей, которым разрешено входить
• admin_users: []
  • Список пользователей, которым будут предоставлены административные привилегии

Настройки Miniconda

• miniconda_version
  • Укажите конкретную версию Miniconda для установки
• conda_checksum
  • ОБЯЗАТЕЛЬНО, ЕСЛИ miniconda_version ОТЛИЧАЕТСЯ ОТ УМОЛЧАНИЯ!
• conda_installer: Miniconda3-{{miniconda_version}}-Linux-x86_64.sh
  • Шаблонное имя скрипта установки. Нужно изменять только если сборка ведется на нестандартной архитектуре.
• conda_prefix: /opt/conda
  • Абсолютный путь к директории, в которую будет установлено Miniconda
• conda_config
  • Укажите произвольную конфигурацию conda, например, каналы conda по умолчанию для поиска
  • См. vars/main.yml для примера

Зависимости

Если используется стандартный dockerspawner, на хосте должна быть установлена Docker, например, через роль mongrelion.docker

Лицензия

BSD

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

Создано Маркусом Левином для CKM Advisors.