Skip to main content

JupyterHub proxy implementation with traefik

Project description

JupyterHub Traefik Proxy

Documentation build status GitHub Workflow Status CircleCI build 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:

  • TraefikTomlProxy

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-0.2.0.tar.gz (38.4 kB view details)

Uploaded Source

Built Distribution

jupyterhub_traefik_proxy-0.2.0-py3-none-any.whl (34.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: jupyterhub-traefik-proxy-0.2.0.tar.gz
  • Upload date:
  • Size: 38.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.8.8

File hashes

Hashes for jupyterhub-traefik-proxy-0.2.0.tar.gz
Algorithm Hash digest
SHA256 4692d3b80cadd3a69023cafdef63fb6cf85b225dbcd1d51c58b840eace23b613
MD5 53e6a4bba9e7ddd57ca9d6ef9efdcb9f
BLAKE2b-256 1a52ced8143f01f38409f46d8c25ad961de5334412a551e41dd0e3f1fd61b103

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: jupyterhub_traefik_proxy-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 34.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.8.8

File hashes

Hashes for jupyterhub_traefik_proxy-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 15a4e22cce3c392d7f52f68c7fc17d41f76fd69e02af13db11c0078f488fdaf9
MD5 625768df0f5def2835f38a2ce5c79b15
BLAKE2b-256 6ee9224c2ea4bd55c168d2052d5e857b6c428d50a6bd7144d4b18fa68345d9b3

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