local-pv-provisioner: enhance documents

Author: ushitora-anqou

local-pv-provisioner/Makefile

@@ -5,6 +5,7 @@ IMAGE_VERSION = `cat ./TAG`
 IMAGE_TAG = ghcr.io/cybozu/local-pv-provisioner:$(IMAGE_VERSION)
 IMAGE_TAG_LATEST = ghcr.io/cybozu/local-pv-provisioner:latest
 
+# https://github.com/kubernetes-sigs/controller-tools/releases
 CONTROLLER_TOOLS_VERSION = 0.19.0
 ENVTEST_K8S_VERSION = 1.34.0
 export ENVTEST_K8S_VERSION

maintenance.md

@@ -774,7 +774,15 @@ Hubble image is no longer built by the upstream. If failing to build the image,
 ![CSA Update](./csa_update.svg)
 
 1. Update version variables in `Makefile` and `e2etest/Makefile`.
+   - `Makefile`: `CONTROLLER_TOOLS_VERSION` and `ENVTEST_K8S_VERSION`
+   - `e2etest/Makefile`: `KUBERNETES_VERSION` and `MINIKUBE_VERSION`
 2. Upgrade direct dependencies listed in `go.mod`. Use `go get` or your editor's function.
+   1. `go get -u`
+   1. `VERSION=0.x.y go get k8s.io/api@v${VERSION} k8s.io/apimachinery@v${VERSION} k8s.io/client-go@v${VERSION}`
+   1. `VERSION=0.x.y go get github.com/prometheus/client_golang@v${VERSION}`
+      - Use the same version as Kubernetes's go.mod (`https://github.com/kubernetes/kubernetes/blob/<upgrading Kubernetes release version>/go.mod`).
+   1. `VERSION=1.x.y go mod tidy -go=${VERSION}`
+      - Use the same version as Kubernetes's go.mod (`https://github.com/kubernetes/kubernetes/blob/<upgrading Kubernetes release version>/go.mod`).
 3. Generate code and manifests.
 
    ```bash