frx-challenges-helm-chart

Note

This README content is adapted from the JupyterHub/helm-chart repository.

This repository stores in its gh-pages branch packaged Helm charts for the frx-challenges project. 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 the FRX Challenges 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 frx-challenges.
helm repo add frx-challenges https://hub.jupyter.org/helm-chart/
helm repo update

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

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.

• GitHub Pages relies on Jekyll that in turn use the Liquid templating language (with some additions) to generate and host static web pages.
• Everything that is to be used to generate the GitHub Page is required to reside at the gh-pages branch.
• Templates get data from a Jekyll Data Folder that you can inspect here. This folder only contains a symlink file that in turn points to index.yaml which is a important file for a Helm chart repository.
• index.md file will be converted to index.html by Jekyll and act as a Human readable page.
• _config.yml is a Jekyll configuration file.
• Gemfile acts like a doc-requirements.txt but for Ruby, allowing us to work with Jekyll locally a bit easier.
• info.json is a way for us to provide easy access to information from the templates underlying data source, the index.yaml file. We are for example using the rendered info.json to create the badges you find in this readme about the latest stable/pre/dev release.

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.