Skip to content

Creating an Educates Cluster

Once we got our prerequisites - Docker Desktop and Educates - installed we can proceed with creating our Educates environment by issuing a single bootstrapping command:

educates create-cluster

This will do the following, in sequence:

  1. Create a purposefully crafted KinD configuration and save it to your local system.
  2. Create a local Kubernetes cluster using KinD and the configuration created in step 1.
  3. Set the context of kubectl to the created cluster.
  4. Create a local image registry to publish workshop images and resources to on localhost:5001
  5. Configure KinD cluster nodes to use the created registry on a node and cluster level.
  6. Deploy the Educates framework to the cluster using kapp.

The output of this command will look like this - see the annotations for references to each of the outlined steps.

Installation progress
Cluster config used is saved to:
~/Library/Application Support/educates/educates-cluster-config.yaml # (1)!
Creating cluster "educates" ... # (2)!
✓ Ensuring node image (kindest/node:v1.30.0) đŸ–ŧ
✓ Preparing nodes đŸ“Ļ
 ✓ Writing configuration 📜
✓ Starting control-plane 🕹ī¸
✓ Installing CNI 🔌
✓ Installing StorageClass 💾
✓ Waiting ≤ 1m0s for control-plane = Ready âŗ
â€ĸ Ready after 14s 💚
Set kubectl context to "kind-educates" # (3)!
You can now use your cluster with:

kubectl cluster-info --context kind-educates --kubeconfig /Users/daniel/.kube/config

Have a question, bug, or feature request? Let us know! https://kind.sigs.k8s.io/#community 🙂
Deploying local image registry # (4)!
Linking local image registry to cluster
Adding local image registry config (localhost:5001) to Kind nodes # (5)!
Adding local image registry config (registry.default.svc.cluster.local) to Kind nodes # (6)!
9:15:15AM: ---- applying 7 changes [0/137 done] ---- # (7)!
[...]
9:17:41AM: ---- applying complete [137/137 done] ----
9:17:41AM: ---- waiting complete [137/137 done] ----
Educates cluster has been created succesfully
  1. Step 1
  2. Step 2
  3. Step 3
  4. Step 4
  5. Step 5
  6. Step 5
  7. Step 6

This command might take several minutes to spin up the cluster, download all the needed container images, and bootstrap the environment. Enough time to get some coffee! ☕