This technical lab is a hands-on workshop. You learn how to use and write Jenkins pipelines in a continuous delivery perspective.
The training content resides within the content directory.
The main part are the labs, which can be found at content/en/docs.
Slides under reveal-slides will be generated during the build process and be available under slides/intro
To generate the slides during the development use:
./generateslides.shThe slides will be generated in the public/slides/intro directory
This site is built using the static page generator Hugo.
The page uses the docsy theme which is included as a Git Submodule. Docsy is being enhanced using docsy-plus as well as docsy-puzzle for brand specific settings.
After cloning the main repo, you need to initialize the submodule like this:
git submodule update --init --recursiveThe default configuration uses the puzzle setup from config/_default.
Further, specialized environments can be added in the config directory.
Run the following command to update all submodules with their newest upstream version:
git submodule update --remoteBuild the image:
docker build -t puzzle/jenkins-techlab:latest .Run it locally:
docker run -i -p 8080:8080 puzzle/jenkins-techlabBuild the image:
buildah build-using-dockerfile -t puzzle/jenkins-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/puzzle/jenkins-techlabTo 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.
export HUGO_VERSION=$(grep "FROM klakegg/hugo" Dockerfile | sed 's/FROM klakegg\/hugo://g' | sed 's/ AS builder//g')
docker run \
--rm --interactive \
--publish 8081:8081 \
-v $(pwd):/src \
klakegg/hugo:${HUGO_VERSION} \
server -p 8081 --bind 0.0.0.0Access the local documentation: localhost:8081
Markdown files are linted with https://github.com/DavidAnson/markdownlint.
Custom rules are in .markdownlint.json.
There's a GitHub Action .github/workflows/markdownlint.yaml for CI.
For local checks, you can either use Visual Studio Code with the corresponding extension (markdownlint), or the command line like this:
npm install
npm run mdlintNpm not installed? no problem
export HUGO_VERSION=$(grep "FROM klakegg/hugo" Dockerfile | sed 's/FROM klakegg\/hugo://g' | sed 's/ AS builder//g')
docker run --rm --interactive -v $(pwd):/src klakegg/hugo:${HUGO_VERSION}-ci /bin/bash -c "set -euo pipefail;npm install; npm run mdlint;"The build action is fired on Pull Requests does the following
- builds all PR Versions (Linting and Docker build)
- deploys the built container images to the container registry
- Deploys a PR environment in a k8s test namespace with helm
- Triggers a redeployment
- Comments in the PR where the PR Environments can be found
The pr-cleanup action is fired when Pull Requests are closed and does the following
- Uninstalls PR Helm Release
The push main action is fired when a commit is pushed to the main branch (eg. a PR is merged) and does the following, it's very similar to the Build Action
- builds main Versions (Linting and Docker build)
- deploys the built container images to the container registry
- Deploys the main Version on k8s using helm
- Triggers a redeployment
Manually deploy the training Release using the following command:
helm install --repo https://acend.github.io/helm-charts/ <release> acend-training-chart --values helm-chart/values.yaml -n <namespace>For debugging purposes use the --dry-run parameter
helm install --dry-run --repo https://acend.github.io/helm-charts/ <release> acend-training-chart --values helm-chart/values.yaml -n <namespace>If you find errors, bugs or missing information please help us improve and have a look at the Contribution Guide.