IBM Cloud Native Bootcamp

Source for the Cloud Native Bootcamp site: concepts and hands-on labs for containers, Kubernetes/OpenShift, Tekton and Argo CD.

Technologies covered

• Cloud native fundamentals
• Containers: Podman/Docker, image registries (Quay.io, OpenShift internal registry)
• Orchestration: Kubernetes and Red Hat OpenShift
• CI/CD: Tekton (OpenShift Pipelines) and Argo CD (OpenShift GitOps)

Running the site locally

Requires Python 3.10 or later (3.14 recommended).

git clone https://github.com/ibm-cloud-architecture/cloud-native-bootcamp.git
cd cloud-native-bootcamp
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
mkdocs serve            # http://127.0.0.1:8000 with live reload
mkdocs build --strict   # the same check CI runs on every pull request

Using a container instead

The dev/ scripts use Docker, or Podman if Docker isn't installed:

npm run dev:build   # build the dev image
npm run dev         # serve on http://localhost:8000
npm run test        # strict build inside the container
npm run dev:stop

Checks

mkdocs build --strict   # broken links, missing nav entries, warnings
npm install && npm run spell   # spelling; add real terms to cspell.json

Acronym tooltips come from includes/abbreviations.md, which is appended to every page. Page tags live in each page's front matter and are listed on the "Browse by Tag" page.

Publishing

Pushing to main builds the site with mkdocs build --strict and deploys it to GitHub Pages (.github/workflows/docs.yml). Pull requests run the same build, plus non-blocking spelling and external link checks.