jupyterhub-container

Ajoute un service Jupyter Hub à votre projet Ansible Container. Exécutez les commandes suivantes pour installer le service :

# Définir le répertoire de travail à la racine de votre projet Ansible Container
$ cd myproject

# Installer le service
$ ansible-container install marcusianlevine.jupyterhub-container

Exigences

• Ansible Container
• Un projet Ansible Container existant. Pour créer un projet, exécutez simplement ce qui suit :

  # Créer un répertoire de projet vide
  $ mkdir myproject
  
  # Définir le répertoire de travail au nouveau répertoire
  $ cd myproject
  
  # Initialiser le projet
  $ ansible-container init
  

Variables de rôle

• vars_files
  • Liste optionnelle de chemins relatifs à /src sur le Conductor avec des fichiers YAML de variables supplémentaires
• extra_pip_packages: [dockerspawner]
  • Liste de paquets pip supplémentaires à installer avec JupyterHub

Fichiers & Répertoires

• jupyterhub_config_dir: /etc/jupyterhub/
  • Chemin absolu vers le répertoire où le fichier de configuration de JupyterHub sera placé
• jupyterhub_config_path: "{{ jupyterhub_config_dir }}/jupyterhub_config.py"
  • Chemin absolu du fichier de configuration JupyterHub
• jupyterhub_srv_dir: /srv/jupyterhub
• jupyterhub_pip_version: 0.8.1
• jupyter_config_dir: /etc/jupyter
  • Chemin absolu vers le répertoire où le fichier de configuration de Jupyter notebook sera placé
• jupyter_share_dir: /usr/local/share/jupyter
• jupyter_templates_dir: "{{ jupyter_config_dir }}/templates"
• ipython_config_dir: /etc/ipython

Configuration du Spawner

• use_helm: non
  • Cible kubespawner via le Zero-to-JupyterHub Helm Chart
• allow_sudo: non
  • Crée des notebooks utilisateur uniques avec des permissions sudo
  • AVERTISSEMENT : utiliser cette option avec des Spawners conteneurisés introduira un risque de sécurité
• mem_limit: oui
  • Pas de limite par défaut. Définir à une valeur valide pour Docker ou Kubernetes mem_limit, par exemple 10G

Authentification des utilisateurs

• use_oauth: non
  • Utiliser GitHub OAuth pour l'authentification des utilisateurs
• use_ldap: non
  • Utiliser ldapauthenticator pour l'authentification des utilisateurs
  • Voir la documentation pour les détails sur les paramètres suivants
• ldap_domain
• ldap_bind_dn_template
• ldap_allowed_group
• ldap_user_search_base
• ldap_search_user
• ldap_user_attribute
• user_list: []
  • Liste blanche des utilisateurs autorisés
• admin_users: []
  • Liste des utilisateurs à qui des privilèges d'administrateur seront accordés

Paramètres Miniconda

• miniconda_version
  • Spécifier une version particulière de Miniconda à installer
• conda_checksum
  • REQUIS SI miniconda_version DIFFÉRENT DE LA VALEUR PAR DÉFAUT !
• conda_installer: Miniconda3-{{miniconda_version}}-Linux-x86_64.sh
  • Nom du script d'installation templatisé. Doit être changé seulement si la construction se fait sur une architecture non standard.
• conda_prefix: /opt/conda
  • Chemin absolu vers le répertoire dans lequel Miniconda sera installé
• conda_config
  • Spécifier une configuration conda arbitraire, par exemple, les canaux conda par défaut à rechercher
  • Voir vars/main.yml pour un exemple

Dépendances

Si vous ciblez le dockerspawner par défaut, le hôte doit avoir Docker installé, par exemple via le rôle mongrelion.docker

Licence

BSD

Informations sur l'auteur

Créé par Marcus Levine pour CKM Advisors.