Clusterwise

Build Kubernetes knowledge from the machine upward. Learn to observe it, investigate it, explain it, and prove what you know.

Clusterwise is an original, open-source Kubernetes apprenticeship delivered as a visual, lab-driven static website. The website teaches; your terminal, virtual machines, and Kubernetes clusters are where labs happen. Clusterwise never needs access to your machine, credentials, cluster, or cloud account.

Read the curriculum

The complete learner site is committed under site/. Learners do not install dependencies or run a build.

# Clone this repository using the URL shown by your Git host, then:
cd clusterwise
python3 -m http.server -d site 8080

Open http://localhost:8080. After cloning or extracting a release, core reading, diagrams, navigation, and search work without an internet connection. JavaScript improves search, copying, narrow-screen navigation, and optional local progress; the curriculum remains readable and navigable without it.

The repository publishes all fifteen canonical capability sequences, from evidence and machine foundations through configuration, storage, access, observability, production change, and an integrated Field Notes incident. The lifecycle registry distinguishes technical review, executed labs, editorial review, learner testing, and stability; publication alone does not imply live validation or learner testing.

What Clusterwise is—and is not

Clusterwise provides explanations, original diagrams, command context, safety guidance, expected state, failure signals, investigation prompts, cleanup, professional vocabulary, communication practice, interview connections, and evidence guidance.

It is not a hosted lab, browser terminal, cluster provisioner, automated grader, AI tutor, LMS, certification cram tool, Kubernetes the Hard Way replacement, or generic documentation framework.

Contribute

Contributors need Python 3.11+ and make; there are no Python or JavaScript packages to install.

make setup
make validate
make build
make test
make serve
make release

Source lives in curriculum/, content/, lab-system/, templates/, styles/, and static/. site/ is generated, committed output. Never edit site/ by hand; change source, refresh the audit/lifecycle snapshot when content changed, run make build, and review both the source and generated diff.

Read CONTRIBUTING.md, curriculum architecture, the editorial standard, content contracts, and authoring guide before adding material.

Project standards

• Semantic multi-page HTML, modern CSS, minimal vanilla JavaScript, local SVG.
• No site framework, SPA, hydration, remote font, CDN, analytics, account, or hosted search.
• Core curriculum is offline-capable and usable without JavaScript.
• Accessibility targets WCAG 2.2 AA where practical.
• Commands are never presented without operational context and safety appropriate to their effect.
• Automation validates structure and relationships; dated human review establishes technical and instructional readiness.
• One excellent, evidence-backed slice is preferred over hundreds of shallow pages.

License and content boundaries

Clusterwise is available under the MIT License. See CONTENT_POLICY.md, ATTRIBUTION.md, and THIRD_PARTY_CONTENT.md for originality, source, and upstream boundaries.

Kubernetes and Kubernetes the Hard Way are external projects. Clusterwise uses original explanations and diagrams and links to primary/upstream material for technical traceability.