Git repo for talk at KubeCon NA 2022. Scott Rigby, Somtochi Onyekwere, Niki Manoledaki & Soulé Ba, Weaveworks; Amine Hilaly, Amazon Web Services. https://sched.co/182Hg
This tutorial walks you through building your own controller using controller runtime, the set of common libraries on which core controllers are built. We'll use Kubebuilder, a framework for building APIs using custom resource definitions (CRDs). We'll also explain lesser-documented best practices and conventions for writing controllers that the community has developed through trial and error learning, through projects such as Flux and Cluster API.
Since we'll be building a controller with reconcilers, we'll need something to reconcile.
For this, we've built a simple API for submitting KubeCon CFP proposals, using CRDs.
Fork this repository, then clone it:
git clone git@github.com:<your username>/how-to-write-a-reconciler-using-k8s-controller-runtime.gitDependencies:
For the local dev setup, there are a few options:
-
GitPod. GitPod is the preferred method, to ensure all users are running in the same environment regardless of their local machine OS. Please click on the button "Open in Gitpod" at the top of this README. Click through the default settings until you arrive at a page that looks like VSCode. Then, wait while the dependencies load (approximately ~6 minutes).
-
Vagrant. As a backup, there is a Vagrantfile with instructions here.
-
DIY. If you have all the required dependencies, you can go ahead and spinup a dev environment:
cd cfp
make docker-build
make setup-kind
make dev-deploy
export KUBECONFIG=/tmp/cfp-api-test-kubeconfigOnce the dev env setup is ready, each step will use a git tag.
There are 7 steps, which match to 7 tags:
To move from one tag to another, checkout the tag and create a new branch from it.
For example, move to the first step:
git checkout tags/s1 -b s1Then, run the tests:
make testAnd so on for each step!