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.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | be739a2a3c0672af03383176e0b9754c10514e00ca3f344ab2350ffd0dfb8d6b |
|
MD5 | 3daedf5e8e9b65689549389e784ef6c7 |
|
BLAKE2b-256 | f74e8254c2bdee42dda9012dcb9630a050159b4bcd47d7a44ee1ebb93218a2bd |
Hashes for jupyterhub_forwardbasespawner-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 06e37b21327fcd5827bfb79871036740f5da4741bf901fc97401f73a96b77dec |
|
MD5 | 4e36ded760b7037c13681598fd89f489 |
|
BLAKE2b-256 | 2904884390cf0a74a9d295aaf81b33708ae4196a43d3a50a587eb23116bbe67e |