Skip to main content

JupyterHub proxy implementation with traefik

Project description

JupyterHub Traefik Proxy

Documentation build status GitHub Workflow Status Latest PyPI version GitHub Discourse Gitter

When JupyterHub starts a server for a user, it will dynamically configure a proxy server so that accessing jupyterhub.example.com/user/<user> routes to the individual Jupyter server. This project contains what JupyterHub need to dynamically configure the routes of a traefik proxy server! There are three implementations of the JupyterHub proxy API, depending on how traefik store its routing configuration.

For smaller, single-node deployments:

  • TraefikFileProviderProxy

For distributed setups:

  • TraefikEtcdProxy
  • TraefikConsulProxy

Installation

The documentation contains a complete installation guide with examples for the three different implementations.

Running tests

There are some tests that use etcdctl command line client for etcd. Make sure to set environment variable ETCDCTL_API=3 before running the tests, so that the v3 API to be used, e.g.:

$ export ETCDCTL_API=3

You can then run the all the test suite from the traefik-proxy directory with:

$ pytest -v ./tests

Or you can run a specific test file with:

$ pytest -v ./tests/<test-file-name>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jupyterhub-traefik-proxy-1.0.0.tar.gz (34.0 kB view details)

Uploaded Source

Built Distribution

jupyterhub_traefik_proxy-1.0.0-py3-none-any.whl (32.2 kB view details)

Uploaded Python 3

File details

Details for the file jupyterhub-traefik-proxy-1.0.0.tar.gz.

File metadata

File hashes

Hashes for jupyterhub-traefik-proxy-1.0.0.tar.gz
Algorithm Hash digest
SHA256 7161fb4c9dda4407e53ec8d3c631b7e26c23fe691dd241d4e0af483b51c64191
MD5 23594984f662c56cbb377e06dc8593fc
BLAKE2b-256 a4058a44f168c5a2aac2522380554d4e5726b7eefe1f6edb9ddad2628f328803

See more details on using hashes here.

Provenance

File details

Details for the file jupyterhub_traefik_proxy-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for jupyterhub_traefik_proxy-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cdbbe226c874270d10066f168fefc2295193b4f99356d3f5c341541ddb6462bc
MD5 47ad33f5c4f588b79eb5bb12df2ec02a
BLAKE2b-256 494bdcb1242ea708f729248889a3cff30f733fbdf79b8724c2edb10c3c35ce68

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page