Guides¶
These pages follow one project from start to end, across the roles of the other sections, and link to the how-to pages for the details of each step. Start with the cluster on real machines. The air-gapped cluster builds on it. The other two build on the homelab example, an advanced setup of a router and three Kubernetes nodes on an IPv6 fabric with BGP. Decisions before you install lists the choices that each guide makes for you, with what each one costs.
-
Build a cluster on real machines
Install three machines from the
cluster-metaltemplate as a Kubernetes cluster of three control planes, with static IPv4 addresses and a VIP for the Kubernetes API. -
Build an air-gapped cluster
Run the cluster without internet access: bring in the OS images, chalkctl and the container images from a connected machine, serve them from the control planes and keep time locally.
-
Write a BGP extension
Build a BIRD extension from an empty module: its kinds, the rendered config, the service, effects, rules, a validator, a diagnostic and their tests, and debug it on a node.
-
Build a home lab
An advanced setup: turn four machines and a switch into a router and three Kubernetes control planes on an IPv6 fabric with BGP, and test what happens when a cable or a node fails.