Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

docs: update kubebuilder-quickstart #29

Merged
merged 6 commits into from
Nov 8, 2022
Merged

docs: update kubebuilder-quickstart #29

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
dea8b61
docs: update kubebuilder-quickstart
nakamasato Nov 8, 2022
3bc2116
kubebuilder: check v3.16.0, v3.17.0
nakamasato Nov 8, 2022
7c7a9f6
fix
nakamasato Nov 8, 2022
ef93ca9
fix version
nakamasato Nov 8, 2022
b39151b
fix version
nakamasato Nov 8, 2022
fa6c7c4
fix docker version
nakamasato Nov 8, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions 07-create-operator-with-kubebuilder/01-install/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/
```

<details><summary>Check Commands</summary>

```
Expand Down
45 changes: 45 additions & 0 deletions 07-create-operator-with-kubebuilder/02-quick-start/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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))

<details><summary>Results</summary>

```
Expand Down Expand Up @@ -425,6 +427,26 @@ We use local run for development.
make install
```

<details><summary>error</summary>

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
```

</details>

1. Run the operator **on the Kubernetes cluster**.
1. Set `IMG` variable.
```
Expand Down Expand Up @@ -453,6 +475,26 @@ We use local run for development.
make deploy IMG=$IMG
```

<details><summary>error</summary>

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
```

</details>

1. Check Pods in `guestbook-system` namespace.
```
kubectl get po -n guestbook-system
Expand Down Expand Up @@ -508,3 +550,6 @@ 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-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)|)