jupyterhub-container

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
  • 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.

О проекте

Build a custom JupyterHub container

Установить
ansible-galaxy install marcusianlevine/ansible-role-jupyterhub-container
Лицензия
bsd-3-clause
Загрузки
82
Владелец
Data Science + DevOps = DataEng