build: use clusterctl version for examples

Changed to a consistent "quick-start" usage and fixed the README

Author: dkoshkin

README.md

@@ -26,33 +26,33 @@ make SKIP_BUILD=true dev.run-on-kind
 To create the ClusterClass and it's Templates with this runtime extension enabled, run:
 
 ```shell
-kubectl apply --server-side -f examples/capi-quickstart/cluster-class.yaml
+kubectl apply --server-side -f examples/capi-quick-start/capd-cluster-class.yaml
 ```
 
 To create a cluster, update `clusterConfig` variable and run:
 
 ```shell
-kubectl apply --server-side -f examples/capi-quickstart/cluster.yaml
+kubectl apply --server-side -f examples/capi-quick-start/capd-cluster.yaml
 ```
 
 Wait until control plane is ready:
 
 ```shell
-kubectl wait clusters/capi-quickstart --for=condition=ControlPlaneInitialized --timeout=5m
+kubectl wait clusters/capd-quick-start --for=condition=ControlPlaneInitialized --timeout=5m
 ```
 
 To get the kubeconfig for the new cluster, run:
 
 ```shell
-clusterctl get kubeconfig capi-quickstart > capd-kubeconfig
+clusterctl get kubeconfig capd-quick-start > capd-kubeconfig
 ```
 
 If you are not on Linux, you will also need to fix the generated kubeconfig's `server`, run:
 
 ```shell
-kubectl config set-cluster capi-quickstart \
+kubectl config set-cluster capd-quick-start \
   --kubeconfig capd-kubeconfig \
-  --server=https://$(docker port capi-quickstart-lb 6443/tcp)
+  --server=https://$(docker port capd-quick-start-lb 6443/tcp)
 ```
 
 Wait until all nodes are ready (this indicates that CNI has been deployed successfully):
@@ -117,7 +117,7 @@ watch -n 0.5 kubectl --kubeconfig capd-kubeconfig get service/traefik
 To delete the workload cluster, run:
 
 ```shell
-kubectl delete cluster capi-quickstart
+kubectl delete cluster capd-quick-start
 ```
 
 Notice that the traefik service is deleted before the cluster is actually finally deleted.

examples/capi-quickstart/capd-cluster-class.yaml renamed to examples/capi-quick-start/capd-cluster-class.yaml

@@ -8,8 +8,8 @@ configurations:
 - kustomizeconfig.yaml
 
 resources:
-- https://github.com/kubernetes-sigs/cluster-api/releases/download/v1.5.1/clusterclass-quick-start.yaml
-- https://github.com/kubernetes-sigs/cluster-api/releases/download/v1.5.1/cluster-template-development.yaml
+- https://github.com/kubernetes-sigs/cluster-api/releases/download/$CLUSTERCTL_VERSION/clusterclass-quick-start.yaml
+- https://github.com/kubernetes-sigs/cluster-api/releases/download/$CLUSTERCTL_VERSION/cluster-template-development.yaml
 
 namePrefix: capd-
 

examples/capi-quickstart/capd-cluster.yaml renamed to examples/capi-quick-start/capd-cluster.yaml

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+
+# Copyright 2023 D2iQ, Inc. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+set -euo pipefail
+IFS=$'\n\t'
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+readonly SCRIPT_DIR
+
+CAPD_KUSTOMIZATION_FILE="${SCRIPT_DIR}/bases/capd/kustomization.yaml"
+
+# download the quick-start files that match the clusterctl version
+trap 'rm -rf ${CAPD_KUSTOMIZATION_FILE}' EXIT
+CLUSTERCTL_VERSION=$(clusterctl version -o short 2>/dev/null) envsubst \
+  <"${SCRIPT_DIR}/bases/capd/kustomization.yaml.tmpl" >"${CAPD_KUSTOMIZATION_FILE}"
+
+mkdir -p examples/capi-quick-start
+# Sync ClusterClass and all Templates
+kustomize build ./hack/examples |
+  gojq --yaml-input --yaml-output '. | select(.kind != "Cluster")' >examples/capi-quick-start/capd-cluster-class.yaml
+# Sync Cluster
+kustomize build ./hack/examples |
+  gojq --yaml-input --yaml-output '. | select(.kind == "Cluster")' >examples/capi-quick-start/capd-cluster.yaml

hack/examples/bases/capd/kustomization.yaml renamed to hack/examples/bases/capd/kustomization.yaml.tmpl

@@ -1,19 +1,6 @@
 # Copyright 2023 D2iQ, Inc. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-KUBERNETES_VERSION ?= v1.27.5
-
-# gojq mutations:
-# - ClusterClass: 	Add cluster-config external patch
-#
-# - Cluster: 		Add CNI label
-# - Cluster: 		Add an empty clusterConfig variable
 .PHONY: examples.sync
-examples.sync: ## Syncs the examples by fetching upstream examples using clusterclt and applying gojq mutations
-	mkdir -p examples/capi-quickstart
-	# Sync ClusterClass and all Templates
-	kustomize build ./hack/examples | \
-	  gojq --yaml-input --yaml-output '. | select(.kind != "Cluster")' > examples/capi-quickstart/capd-cluster-class.yaml
-	# Sync Cluster
-	kustomize build ./hack/examples | \
-	  gojq --yaml-input --yaml-output '. | select(.kind == "Cluster")' > examples/capi-quickstart/capd-cluster.yaml
+examples.sync: ## Syncs the examples by fetching upstream examples and applying kustomize patches
+	hack/examples/sync.sh $(KUBERNETES_VERSION)