Skip to content

A store of Helm chart tarballs for deploying JupyterHub and BinderHub on a Kubernetes cluster

Notifications You must be signed in to change notification settings

jupyterhub/helm-chart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 

Repository files navigation

GitHub Discourse Gitter

This repository stores in its gh-pages branch packaged Helm charts for BinderHub and Zero to JupyterHub K8s. These packaged Helm charts are made available as a valid Helm chart repository on an automatically updated website thanks to GitHub Pages. We use chartpress to add package and add Helm charts to this Helm chart repository.

Usage

This Helm chart repository enables you to install a JupyterHub and BinderHub Helm chart directly from it into your Kubernetes cluster. Please refer to the JupyterHub Helm chart documentation or the BinderHub Helm chart documentation for all the additional details required.

# Let helm the command line tool know about a Helm chart repository
# that we decide to name jupyterhub.
helm repo add jupyterhub https://hub.jupyter.org/helm-chart/
helm repo update

# Simplified example on how to install a Helm chart from a Helm chart repository
# named jupyterhub. See the Helm chart's documentation for additional details
# required.
helm install jupyterhub/<helm chart name> --version <helm chart version>

Release notes

The JupyterHub Helm chart

Latest stable release of the Helm chart Latest pre-release of the Helm chart Latest development release of the Helm chart

For an extensive list of the released versions, click the badge above!

Each JupyterHub Helm chart release utilizes a specific version of JupyterHub and KubeSpawner and requires a minimum Kubernetes version as well as a minimum Helm version to function properly.

For detailed information about what Python libraries and other packages are available alongside JupyterHub, inspect files such as Dockerfile and requirements.txt within the images folder.

The BinderHub Helm chart

Latest development release of the Helm chart

For an extensive list of the released versions, click the badge above!

BinderHub's Helm chart use JupyterHub's Helm chart as a dependency. That means that each BinderHub use a specific version of JupyterHub's Helm chart, along with BinderHub specific components like the BinderHub Python package itself and repo2docker.

For detailed information about what Python libraries and other packages are available alongside BinderHub, inspect files such as Dockerfile and requirements.txt within the images folder.

Currently, the BinderHub Helm chart does not tag releases though, so making a similar comparison to the one above is hard.

Local development of GitHub page

Background knowledge

To locally development the GitHub page for this repostiory, some background understanding can be useful. A good start is to read Helm's documentation about Helm chart repositories. After that, keep this in mind.

Setting up for local development

There are probably different ways to go about this, but sometimes what matters is to have one at all. Doing the following was tested by @consideRatio 2019-10-19 on Ubuntu 19.04.

  1. Install Ruby, Gem, and Bundler.

    1. Install rbenv.
    2. Install the rbenv-build plugin to allows you to use rbenv install.
    3. Run rbenv install <version> with the latest stable version.
    4. Run rbenv global <version>.
    5. Verify you can run ruby -v and gem -v.
    6. Run gem install bundler to work with Gemfiles etc.
  2. Install Jekyll.

    1. Checkout the gh-pages branch with git checkout gh-pages.
    2. Run bundle install
  3. Start a local webserver.

    1. Run bundle exec jekyll serve.
    2. Visit http://localhost:4000.