Table of Contents
Module Description
This module installs, configures and managed Jupyterhub. The module has support for the sudospawner and systemdspawner. This module is a fork and has been rewritten to support hiera 5.
For different OAuthenticator setups, have a look at the jupyterhub oauthenticator page.
Setup
Beginning with jupyterhub
include ::jupyterhub should be enough to get it up and running.
Setup Requirements
The module needs Python and Nodejs, both modules are listed in the dependencies. On CentOS, EPEL is needed and comes as a dependency of the stankevich-python module. If you already have a local mirror or EPEL on the system, you can set the boolean to false. If there is no EPEL repo available, install will fail.
Usage
All parameters for the jupyterhub module are contained within the main ::jupyterhub class, so for any function of the module, set the options you want.
Reference
Classes
Public classes
jupyterhub: Main class, includes all other.
Private classes
- jupyterhub::install: Installs all packages (python pyvenv, nodejs,...) and dependencies
- jupyterhub::config: Sets the config and log file
- jupyterhub::service: Handles the sysvinit / systemd service
Parameters
Following parameters are available, and are the defaults:
jupyterhub::allowed_users: ~
jupyterhub::base_url: /
jupyterhub::cfhproxy_command: '/usr/lib/node_modules/configurable-http-proxy/bin/configurable-http-proxy'
jupyterhub::cfhproxy_should_start: true
jupyterhub::cfhproxy_auth_token: ~
jupyterhub::cookie_secret_file: ~
jupyterhub::config_dir: /etc/jupyter
jupyterhub::epel_enable: true
jupyterhub::debug_enable: false
jupyterhub::ip: "%{facts.networking.ip}"
jupyterhub::jupyterhub_dir: /opt/jupyterhub
jupyterhub::jupyterhub_group: 'jupyter'
jupyterhub::jupyterhub_username: 'jupyter'
jupyterhub::ldap_enable: false
jupyterhub::manage_config: true
jupyterhub::manage_git: true
jupyterhub::oauth_callback_url: ~
jupyterhub::oauth_client_id: ~
jupyterhub::oauth_client_secret: ~
jupyterhub::oauth_create_system_users: false
jupyterhub::oauth_name: 'MyOAuthenticator'
jupyterhub::oauth_full_name: 'oauthenticator.MyOAuthenticator'
jupyterhub::oauth_enable: false
jupyterhub::oauth_custom_enable: false
jupyterhub::oauth_github_client_id: ~
jupyterhub::oauth_github_client_secret: ~
jupyterhub::oauth_github_enable: false
jupyterhub::port: 7000
jupyterhub::hub_port: 7001
jupyterhub::hub_ip: "%{facts.networking.ip}"
jupyterhub::proxy_api_port: ~
jupyterhub::pyvenv: /opt/jupyterhub/pyvenv
jupyterhub::python_version: 'system'
jupyterhub::reverse_proxy_enable: false
jupyterhub::reverse_proxy_origin: []
jupyterhub::service_enable: true
jupyterhub::service_ensure: running
jupyterhub::service_manage: true
jupyterhub::service_name: 'jupyterhub'
jupyterhub::ssl_enable: false
jupyterhub::ssl_cert: ~
jupyterhub::ssl_key: ~
jupyterhub::sudospawner_allowed_users: []
jupyterhub::sudospawner_enable: false
jupyterhub::sudospawner_debug_enable: false
jupyterhub::systemdspawner_cpu_limit: 'None'
jupyterhub::systemdspawner_default_shell: ~
jupyterhub::systemdspawner_enable: false
jupyterhub::systemdspawner_isolate_devices: false
jupyterhub::systemdspawner_isolate_tmp: false
jupyterhub::systemdspawner_mem_limit: 'None'
jupyterhub::systemdspawner_user_workingdir: /home/{USERNAME}
jupyterhub::batchspawner_enable: false
jupyterhub::batchspawner_allowed_users: []
jupyterhub::batchspawner_commands_enable: false
jupyterhub::batchspawner_commands:
- '/usr/bin/qsub'
- '/usr/bin/qdel'
- '/usr/bin/qstat'
jupyterhub::batchspawner_torque_enable: false
jupyterhub::batchspawner_nprocs: ~
jupyterhub::batchspawner_queue: ~
jupyterhub::batchspawner_host: ~
jupyterhub::batchspawner_node: '1'
jupyterhub::batchspawner_partition: ~
jupyterhub::batchspawner_qos: '{qos}'
jupyterhub::batchspawner_runtime: ~
jupyterhub::batchspawner_command: ~
jupyterhub::batchspawner_memory: ~
jupyterhub::batchspawner_module_path: ~
jupyterhub::batchspawner_module_python: ~
jupyterhub::wrapspawner_enable: false
jupyterhub::custom_packages_enable: false
jupyterhub::custom_packages:
- numpy
- scipy
- matplotlib
- pycurl
jupyterhub::admin_access: false
jupyterhub::cleanup_proxy: false
jupyterhub::cleanup_servers: false
jupyterhub::spawner_cmd: ~
jupyterhub::spawner_default_url: ~
jupyterhub::spawner_notebook_dir: ~
jupyterhub::authenticator_admin_users: []
jupyterhub::kernelrestarter_restart_limit: ~
jupyterhub::kernelmanager_autorestart: true
jupyterhub::pip_version_jupyter: 1.0.0
jupyterhub::pip_version_jupyterhub: 1.4.1
jupyterhub::pip_version_sudospawner: 0.5.2
jupyterhub::pip_version_systemdspawner: 0.15.0
jupyterhub::pip_version_batchspawner: 1.1.0
jupyterhub::pip_version_wrapspawner: 1.0.0
jupyterhub::pip_version_oauthenticator: 14.0.0
jupyterhub::pip_version_requests_oauthlib: 1.3.0
jupyterhub::pip_version_jupyterhub_ldapauthenticator: 1.3.2
Limitations
To enable the different spawners, set the right boolean to true.
At the moment, only the sudospawner and systemdspawner are supported.
There is a lib for facter to detect the initsystem. Only systemd and sysvinit are supported. To disable the management of the service set following parameter in hiera. The module still copies the bash script to start up Jupyterhub, so you can start it throught the script.
jupyterhub::service_manage: false
The role has been tested on CentOS 7. It could be that the Debian OS family needs some work or debugging regarding the python pyvenv.