JupyterHub BaseSpawner class. Enables remote single-user server.
Project description
ForwardBaseSpawner
The ForwardBaseSpawner is a base class, which can be used by any Spawner that creats the singleuser notebook server on a remote system. The ForwardBaseSpawner itself cannot start anything. The actual logic of starting / stopping must be implemented in a subclass.
Overview
The JupyterHub ForwardBaseSpawner offers a variety of useful functions, to enable and manage the communication between JupyterHub and a singleuser notebook servers, which runs on a remote machine. It covers the following functionalities:
- Manage ssh port forwarding process from JupyterHub to singleuser notebook server
- Manage ssh port forwarding process from singleuser notebook server to JupyterHub
- Manage Kubernetes Service Resource to make singleuser notebook server reachable for JupyterHub
- Adds cancel function. Allows the user to cancel an ongoing spawn process
- Start process of remote singleuser notebook servers may send their current progress to SpawnEventsAPIHandler, which shows it to the user
- SetupTunnelAPIHandler allows to define the ssh jump node between JupyterHub and singleuser notebook server during the spawn process
- ListServersAPIHandler returns all running UserID-servername combinations. Gives remote systems the chance to compare their running servers with the JupyterHub ones
- SSHNodeRestartedAPIHandler enables a recreation of all port forwarding process to a specific jump node. Required when a jump node was restarted
For more information and the usage have a look at the JupyterHub OutpostSpawner documentation. It's a subclass of the ForwardBaseSpawner and enables a central JupyterHub to start singleuser notebook-server on multiple remote systems.
You can find a few examples and configurations over there.
Requirements
At least one JupyterHub running on a Kubernetes Cluster (recommended is the use of Zero2JupyterHub). A subclass of the ForwardBaseSpawner which implements the actual start/stop logic for singleuser notebook servers.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for jupyterhub_forwardbasespawner-1.0.6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d01889a36500bae670c6dd82afed82e2eadd46f5619c61ed7cbd0a6df11ca578 |
|
MD5 | fad44395962284c9edfca37f73a8a8c0 |
|
BLAKE2b-256 | e15baf0e12fe29d42c2c794341b12f70e8cf5ec50519e5336708f3485c007051 |
Hashes for jupyterhub_forwardbasespawner-1.0.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ea59bd15e9d14847e1dd4015875532472f9175c84cf4961fe3c8d5b9e61154bf |
|
MD5 | 94ad937e93f1d30db9eaec56cf997023 |
|
BLAKE2b-256 | b9b7bf89c201233578a76133fe7c2aeed54a76e562ec76ecf54f1018afbf6cce |