From dea8b6112f365a208b8e0356679f86e31f886d33 Mon Sep 17 00:00:00 2001 From: Naka Masato Date: Tue, 8 Nov 2022 09:31:46 +0900 Subject: [PATCH 1/6] docs: update kubebuilder-quickstart --- .../01-install/README.md | 8 ++++ .../02-quick-start/README.md | 41 +++++++++++++++++++ 2 files changed, 49 insertions(+) diff --git a/07-create-operator-with-kubebuilder/01-install/README.md b/07-create-operator-with-kubebuilder/01-install/README.md index 88b5d87..ffff30d 100644 --- a/07-create-operator-with-kubebuilder/01-install/README.md +++ b/07-create-operator-with-kubebuilder/01-install/README.md @@ -13,6 +13,14 @@ kubebuilder version Version: main.version{KubeBuilderVersion:"3.3.0", KubernetesVendor:"1.23.1", GitCommit:"47859bf2ebf96a64db69a2f7074ffdec7f15c1ec", BuildDate:"2022-01-18T17:03:29Z", GoOs:"darwin", GoArch:"amd64"} ``` +If you want to specify a kubebuilder version, you can use the following command: + +``` +KUBEBUILDER_VERSION=v3.5.0 +curl -L -o kubebuilder https://github.com/kubernetes-sigs/kubebuilder/releases/download/$KUBEBUILDER_VERSION/kubebuilder_$(go env GOOS)_$(go env GOARCH) +chmod +x kubebuilder && mv kubebuilder /usr/local/bin/ +``` +
Check Commands ``` diff --git a/07-create-operator-with-kubebuilder/02-quick-start/README.md b/07-create-operator-with-kubebuilder/02-quick-start/README.md index dcec461..c681248 100644 --- a/07-create-operator-with-kubebuilder/02-quick-start/README.md +++ b/07-create-operator-with-kubebuilder/02-quick-start/README.md @@ -425,6 +425,26 @@ We use local run for development. make install ``` +
error + + If you encounter the following error: + + ``` + make install + /Users/m.naka/projects/guestbook/bin/controller-gen rbac:roleName=manager-role crd webhook paths="./..." output:crd:artifacts:config=config/crd/bases + curl -s "https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/hack/install_kustomize.sh" | bash -s -- 3.8.7 /Users/m.naka/projects/guestbook/bin + Version v3.8.7 does not exist or is not available for darwin/arm64. + make: *** [/Users/m.naka/projects/guestbook/bin/kustomize] Error 1 + ``` + + You can specify kustomize version or you can update the default KUSTOMIZE_VERSION in Makefile. + + ``` + KUSTOMIZE_VERSION=4.5.5 make install + ``` + +
+ 1. Run the operator **on the Kubernetes cluster**. 1. Set `IMG` variable. ``` @@ -453,6 +473,26 @@ We use local run for development. make deploy IMG=$IMG ``` +
error + + If you encounter the following error: + + ``` + make install + /Users/m.naka/projects/guestbook/bin/controller-gen rbac:roleName=manager-role crd webhook paths="./..." output:crd:artifacts:config=config/crd/bases + curl -s "https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/hack/install_kustomize.sh" | bash -s -- 3.8.7 /Users/m.naka/projects/guestbook/bin + /Users/m.naka/projects/guestbook/bin/kustomize exists. Remove it first. + make: *** [/Users/m.naka/projects/guestbook/bin/kustomize] Error 1 + ``` + + Delete the kustomize by `rm bin/kustomize` and rerun the command + + ``` + KUSTOMIZE_VERSION=4.5.5 make deploy IMG=$IMG + ``` + +
+ 1. Check Pods in `guestbook-system` namespace. ``` kubectl get po -n guestbook-system @@ -508,3 +548,4 @@ Checked version pairs: |---|-----|---|---| |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.3.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.3.0)| |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.4.1](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.4.1)| +|[4.8.0 (78933)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)| From 3bc21162966b5652f0695fe251fae831d90bfe5d Mon Sep 17 00:00:00 2001 From: Naka Masato Date: Tue, 8 Nov 2022 11:07:24 +0900 Subject: [PATCH 2/6] kubebuilder: check v3.16.0, v3.17.0 --- 07-create-operator-with-kubebuilder/02-quick-start/README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/07-create-operator-with-kubebuilder/02-quick-start/README.md b/07-create-operator-with-kubebuilder/02-quick-start/README.md index c681248..cf81aed 100644 --- a/07-create-operator-with-kubebuilder/02-quick-start/README.md +++ b/07-create-operator-with-kubebuilder/02-quick-start/README.md @@ -14,6 +14,8 @@ cd ~/projects/guestbook kubebuilder init --domain my.domain --repo my.domain/guestbook ``` +If you are using [kubebuilder#v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0) on M1 Mac, you might need to use `kubebuilder init --domain my.domain --repo my.domain/guestbook --plugins=go/v4-alpha`. (ref: [create a project](https://book.kubebuilder.io/quick-start.html#create-a-project)) +
Results ``` @@ -549,3 +551,5 @@ Checked version pairs: |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.3.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.3.0)| |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.4.1](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.4.1)| |[4.8.0 (78933)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)| +|[4.13.1 (90346)]((https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)| +|[4.13.1 (90346)]((https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)| From 7c7a9f669c1247352933e917ea3ade47133811c3 Mon Sep 17 00:00:00 2001 From: Naka Masato Date: Tue, 8 Nov 2022 11:08:56 +0900 Subject: [PATCH 3/6] fix --- 07-create-operator-with-kubebuilder/02-quick-start/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/07-create-operator-with-kubebuilder/02-quick-start/README.md b/07-create-operator-with-kubebuilder/02-quick-start/README.md index cf81aed..a168844 100644 --- a/07-create-operator-with-kubebuilder/02-quick-start/README.md +++ b/07-create-operator-with-kubebuilder/02-quick-start/README.md @@ -551,5 +551,5 @@ Checked version pairs: |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.3.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.3.0)| |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.4.1](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.4.1)| |[4.8.0 (78933)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)| -|[4.13.1 (90346)]((https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)| -|[4.13.1 (90346)]((https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)| +|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)| +|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)| From ef93ca914e9d890295f00a84f826103618718f51 Mon Sep 17 00:00:00 2001 From: Naka Masato Date: Tue, 8 Nov 2022 11:09:45 +0900 Subject: [PATCH 4/6] fix version --- 07-create-operator-with-kubebuilder/02-quick-start/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/07-create-operator-with-kubebuilder/02-quick-start/README.md b/07-create-operator-with-kubebuilder/02-quick-start/README.md index a168844..2f4d8d4 100644 --- a/07-create-operator-with-kubebuilder/02-quick-start/README.md +++ b/07-create-operator-with-kubebuilder/02-quick-start/README.md @@ -551,5 +551,5 @@ Checked version pairs: |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.3.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.3.0)| |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.4.1](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.4.1)| |[4.8.0 (78933)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)| -|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)| -|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)| +|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)| +|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)| From b39151b1c327887490660b6592727ee9d64af960 Mon Sep 17 00:00:00 2001 From: Naka Masato Date: Tue, 8 Nov 2022 11:11:59 +0900 Subject: [PATCH 5/6] fix version --- 07-create-operator-with-kubebuilder/02-quick-start/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/07-create-operator-with-kubebuilder/02-quick-start/README.md b/07-create-operator-with-kubebuilder/02-quick-start/README.md index 2f4d8d4..f9944bf 100644 --- a/07-create-operator-with-kubebuilder/02-quick-start/README.md +++ b/07-create-operator-with-kubebuilder/02-quick-start/README.md @@ -551,5 +551,5 @@ Checked version pairs: |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.3.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.3.0)| |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.4.1](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.4.1)| |[4.8.0 (78933)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)| -|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)| -|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)|)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)| +|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)|) +|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)|) From fa6c7c45aa82e97edcf2cafd42675f8fbcc0ee8b Mon Sep 17 00:00:00 2001 From: Naka Masato Date: Tue, 8 Nov 2022 11:13:57 +0900 Subject: [PATCH 6/6] fix docker version --- 07-create-operator-with-kubebuilder/02-quick-start/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/07-create-operator-with-kubebuilder/02-quick-start/README.md b/07-create-operator-with-kubebuilder/02-quick-start/README.md index f9944bf..df0c573 100644 --- a/07-create-operator-with-kubebuilder/02-quick-start/README.md +++ b/07-create-operator-with-kubebuilder/02-quick-start/README.md @@ -551,5 +551,5 @@ Checked version pairs: |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.3.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.3.0)| |[4.7.0 (77141)](https://docs.docker.com/desktop/mac/release-notes/#docker-desktop-471)|[v0.12.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.12.0)|v1.23.4|[v3.4.1](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.4.1)| |[4.8.0 (78933)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.24.0|[v3.5.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.5.0)| -|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)|) -|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-480)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)|) +|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-4131)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.6.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.6.0)|) +|[4.13.1 (90346)](https://docs.docker.com/desktop/release-notes/#docker-desktop-4131)|[v0.17.0](https://github.com/kubernetes-sigs/kind/releases/tag/v0.17.0)|v1.25.3|[v3.7.0](https://github.com/kubernetes-sigs/kubebuilder/releases/tag/v3.7.0)|)