Kubernetes Practitioner Workshop

Free. Open source. No paywall. A vendor-neutral Kubernetes workshop you can run for yourself, for colleagues, or as a full multi-day delivery — with interactive slides, ready-to-run labs, a portable question bank, and downloadable PDFs.

Use it to learn, to explain Kubernetes concepts to your team, or to facilitate a room. Restyle it, reorder it, fork it, redistribute it, or sell it under the 0BSD License — no attribution required. No royalties, no accounts, and no telemetry.

Live decks (always-current GitHub Pages builds):

• Day 1 — Foundations
• Day 2 — Running workloads
• Day 3 — Security, delivery, operators
• Canonical 3-day cut · Full content (superset) · Docs home

Try it in sixty seconds

Docs home	https://platformrelay.github.io/Kubernetes-Workshop/
Live decks	Day 1 · Day 2 · Day 3 · 3-day cut · Superset
PDF handouts	GitHub Releases (day + full + 3-day PDFs on each v* tag)
Labs	labs/README.md · start at labs/day-1/00-setup.md
Quizzes	quiz/README.md (portable bank; FOSS live host still open)
Run slides locally	docs/run-slides.md (Node.js + pnpm)
Known limitations	docs/beta-limitations.md (S24 stub; add-on smoke backlog)
Roadmap	docs/roadmap.md (quizzes, OpenTelemetry — no dates)

_{Real deck, no hand-taken screenshots: CI re-renders this tour from the slide sources (pnpm showcase:gif). Static frame: docs/images/deck-preview.png.}

What you get

• ~50% slides / ~50% practice — Slidev decks paired with standalone Markdown labs.
• A clear red line — one app grown Pod → Deployment → Service → Ingress → Gateway API, then config, storage, probes, security, Helm, GitOps, and operators on the same workload.
• Two lab environments — assigned namespace on a shared cluster, or a local kind cluster via ./workshop up.
• Facilitator support — syllabus, pacing notes, and add-on checklists in docs/facilitator-guide.md.
• Offline PDFs — every release exports day decks plus full/3-day compatibility PDFs.

Audience

Beginner-to-intermediate. Comfortable in a shell, with basic Git, YAML, HTTP, and container vocabulary. Container on-ramp labs (S01/S02) need no cluster.

By the end, a learner can build and secure an image; explain the control plane; author and operate core workloads through Gateway API; inject config and storage; set resources and probes; harden with PSA, NetworkPolicy, and RBAC; deliver with Helm and GitOps; and read an operator in the wild — mapped to CKA/CKAD domains as a design check (cert prep is not the organizing principle).

Curriculum at a glance

The workshop is a superset of 28 sections (S00–S27), boiled down per delivery into a canonical 3-day cut. Spine: Pod → Deployment → Service → Ingress → Gateway API (S05–S09).

Day	Theme	Sections
Day 1	Foundations + red line	S00, S03–S08
Day 2	Running workloads well	S09–S14
Day 3	Security, delivery, operators	S17, S20–S23, S25–S27

Authored on-ramp / add-back sections (S01, S02, S15, S16, S18, S19) live in Optional / Appendix; S24 is a deferred stub (not schedulable). 26 of 28 sections are fully authored (S27 slides-only wrap-up). Full map: docs/syllabus.md — contract-checked against scripts/deck-manifest.mjs.

Why this, not X?

• vs. paid platforms (KodeKloud, A Cloud Guru, Linux Foundation courses) — this is free forever, 0BSD, no account, no subscription, no paywalled labs. git clone (or the live Pages site) gets you everything: slides, labs, and PDFs.
• vs. Kubernetes the Hard Way — KTHW teaches you to bootstrap a control plane from scratch by hand; deep, but narrow, and it stops before you ever run a workload. This workshop assumes a cluster exists (kind or shared) and teaches the practitioner path: workloads, config, storage, probes, security, delivery, and operators — where a working engineer actually spends their time.
• vs. single-video courses (YouTube walkthroughs, one-off Udemy/paid videos) — great as an intro, but usually one linear recording with no standalone labs to run yourself, no multi-day structure, and no facilitator materials. This is slides plus separate hands-on labs, a syllabus, and a facilitator guide — built to run as a real room, not just watched.
• vs. the official Kubernetes docs/tutorials — an excellent reference, but a reference isn't a curriculum. There's no red line, no pacing, no lab progression that grows one app end to end.
• Ownership — 0BSD means you can restyle it, cut your own agenda from the 28-section superset, teach it inside your company, or resell it. No attribution required, no royalties, ever.

Choose your path

• Preview — documentation site and live decks · PDF releases.
• Participate — labs/README.md, then Lab 00. For kind: docs/setup.md.
• Facilitate — docs/facilitator-guide.md.
• Contribute — authoring rules in AGENT.md.

Run the slides on your machine

Complete copy-paste path (Node 22 + pnpm — this repo does not ship an npm lockfile):

git clone https://github.com/PlatformRelay/Kubernetes-Workshop.git
cd Kubernetes-Workshop

corepack enable
corepack prepare pnpm@11.9.0 --activate
pnpm install --frozen-lockfile

pnpm dev:day1          # http://localhost:3030/ — or pnpm dev / dev:3day / dev:superset

More detail (build, preview, Pages tree): docs/run-slides.md.

Develop (maintainers)

pnpm install
pnpm dev                # gum menu when available
pnpm deck -- --list
pnpm build              # live day entries
pnpm export             # PDFs (playwright-chromium)
pnpm lint && pnpm link-check
pnpm test:pages         # Pages wiring contract
pnpm pages:build        # MkDocs + hash-routed decks → ./site (needs MkDocs)

Layout

Path	Purpose
docs/	MkDocs documentation (GitHub Pages landing)
scripts/deck-manifest.mjs	Section metadata + generated deck membership
slides-day-{1,2,3}.md	Live day entries
slides.md / slides-3day.md	Compatibility superset / three-day cut
pages/SNN-topic/	Section sources
labs/day-*/	Standalone labs
quiz/	Portable question bank
theme/	Local Slidev theme
docs/decisions/	ADRs

Continuous integration & publishing

Workflow	Trigger	Role
ci.yml	PR + main	Labs lint, deck builds, link-check, Pages contract tests, showcase GIF
pages.yml	main (+ manual)	MkDocs + Slidev → GitHub Pages
release.yml	v* tags	PDF + offline zip GitHub Release
lab-smoke.yml	schedule / dispatch / PR subset	Disposable kind Day-1 smoke
codeql.yml	main / schedule	Code scanning

Release policy (immutable tags, day-deck artifacts): docs/release.md.

License

0BSD — use, copy, modify, redistribute, and sell freely. No attribution required. Copyright (C) 2026 Platform Relay.