/helm-techlab

Primary LanguageHTMLGNU Affero General Public License v3.0AGPL-3.0

Helm Techlab

In this guided hands-on techlab, we show participants the Helm's basics.

For more see Helm Techlabs online.

Content Sections

The Techlab content resides within the content directory.

The main part are the labs, which can be found at content/labs.

Hugo

Helm Techlab is built using the static page generator Hugo and published at helm-techlab.k8s.puzzle.ch.

The page uses the dot theme which is included as a Git Submodule.

After cloning the main repo, you need to initialize the submodule like this:

git submodule update --init --recursive

Supported elements by the dot theme: rendered, source

How to test locally

Using Docker

Build the image:

docker build -t acend/helm-techlab:latest .

Run it locally:

docker run --rm --interactive --publish 8080:8080 acend/helm-techlab

Using Buildah and Podman

Build the image:

buildah build-using-dockerfile -t acend/helm-techlab:latest .

Run it locally with the following command. Beware that --rmi automatically removes the built image when the container stops, so you either have to rebuild it or remove the parameter from the command.

podman run --rm --rmi --interactive --publish 8080:8080 localhost/acend/helm-techlab

How to develop locally

To develop locally we don't want to rebuild the entire container image every time something changed, and it is also important to use the same hugo versions like in production. We simply mount the working directory into a running container, where hugo is started in the server mode.

$ docker run --rm --interactive --publish 8080:8080 -v $(pwd):/opt/app/src -w /opt/app/src acend/hugo:0.68.3 hugo server -p 8080 --bind 0.0.0.0

Contributions

If you find errors, bugs or missing information please help us improve our techlab and have a look at the Contribution Guide.