-
Notifications
You must be signed in to change notification settings - Fork 799
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Kubernetes Update template, Release template, and site content change…
… for multiple k8s version support (#2980) * Kubernets update template, release template, and site content change for multiple k8s version support * Reorder the steps * address comments
- Loading branch information
Showing
22 changed files
with
121 additions
and
73 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,38 +1,51 @@ | ||
--- | ||
name: Upgrade Kubernetes Version | ||
about: Issue for updating the Kubernetes version (usually decided in community meetings). | ||
title: 'Update Kubernetes to {version}' | ||
name: Upgrade Supported Kubernetes Versions | ||
about: Issue for updating the supported Kubernetes versions. | ||
title: 'Update Supported Kubernetes to {version_1} {version_2} {version_3}' | ||
labels: kind/operations, kind/breaking | ||
assignees: '' | ||
|
||
--- | ||
|
||
List of items to do for upgrading to {version}: | ||
Agones supports and is tested against 3 releases of Kubernetes, targeting the newest version as being the [default version in the GKE Rapid channel](https://cloud.google.com/kubernetes-engine/docs/release-notes#current_versions). The vendored version of client-go will be aligned with the middle of the three supported Kubernetes versions ({version_2}). All the example clusters will use the middle of the three supported Kubernetes versions ({version_2}). | ||
|
||
- [ ] Update terraform submodules | ||
- [ ] GKE | ||
- [ ] Azure | ||
- [ ] EKS | ||
- [ ] Update e2e cluster | ||
- [ ] Recreate cluster with new scripts: `cd build/terraform/e2e; terraform apply -var project=agones-images` | ||
- [ ] Update kubectl in dev tooling | ||
List of items to do for upgrading to {version_1} {version_2} {version_3} | ||
|
||
- [ ] Update the cluster version of terraform submodules in `install/terraform/modules` | ||
- [ ] Update Kubernetes version of GKE cluster to {version_2} | ||
- [ ] Update Kubernetes version of AKS to the newest supported version in {version_1} {version_2} {version_3} | ||
- [ ] Update Kubernetes version of EKS to the newest supported version in {version_1} {version_2} {version_3} | ||
- [ ] Update kubectl in dev tooling to {version_2} | ||
- [ ] Update kubectl in `build/build-image/Dockerfile` | ||
- [ ] Update kubectl in `build/e2e-image/Dockerfile` | ||
- [ ] Update documentation for creating clusters | ||
- [ ] Config.toml `supported_k8s` and related (do `dev_` before main) | ||
- [ ] Update the dev tooling to create clusters | ||
- [ ] Minikube | ||
- [ ] Kind | ||
- [ ] Update the k8s image used in the helm [pre-delete-hook](https://github.com/googleforgames/agones/blob/main/install/helm/agones/templates/hooks/pre_delete_hook.yaml) | ||
- [ ] Update client-go | ||
- [ ] Update CRD API reference | ||
- [ ] Update the Kubernetes version of the below test clusters to {version_2} | ||
- [ ] Minikube (Get the patch version [here](https://github.com/kubernetes/minikube/blob/master/CHANGELOG.md)) | ||
- [ ] Kind (Confirm {version_2} is supported and get the patch version [here](https://github.com/kubernetes-sigs/kind/releases)) | ||
- [ ] Update the k8s image used in the helm [pre-delete-hook](https://github.com/googleforgames/agones/blob/main/install/helm/agones/templates/hooks/pre_delete_hook.yaml) to {version_2} | ||
- [ ] Update client-go in `go.mod` and `test/terraform/go.mod` to {version_2} by running `go get -u k8s.io/client-go@{CORRESPONDING_VERSION}` and `go get -u k8s.io/apiextensions-apiserver@{CORRESPONDING_VERSION}`, then re-run `go mod tidy` and `go mod vendor` | ||
- [ ] Update CRD API reference to {version_2} | ||
- [ ] Update links to k8s documentation in `site/assets/templates/crd-doc-config.json` | ||
- [ ] Regenerate crd api reference docs - `make gen-api-docs` | ||
- [ ] Regenerate crd client libraries - `make gen-crd-client` | ||
- [ ] Regenerate Kubernetes resource includes (e.g. ObjectMeta, PodTemplateSpec) | ||
- [ ] Start a cluster with `make gcloud-test-cluster`, uninstall agones using `helm uninstall agones -n agones-system`, and then run `make gen-embedded-openapi` and `make gen-install` | ||
- [ ] Start a cluster with `make gcloud-test-cluster` (this cluster will use Kubernetes {version_2}), uninstall agones using `helm uninstall agones -n agones-system`, and then run `make gen-embedded-openapi` and `make gen-install` | ||
- [ ] Update documentation for creating clusters and k8s API references to align with the above clusters versions and the k8s API version | ||
- [ ] `site/config.toml` | ||
- [ ] `dev_supported_k8s`, which are {version_1} {version_2} {version_3} | ||
- [ ] `dev_k8s_api_version`, which is {version_2} | ||
- [ ] `dev_gke_example_cluster_version`, which is {version_2} | ||
- [ ] `dev_aks_example_cluster_version`, which is the newest AKS supported version in {version_1} {version_2} {version_3} | ||
- [ ] `dev_eks_example_cluster_version`, which is the newest EKS supported version in {version_1} {version_2} {version_3} | ||
- [ ] `dev_minikube_example_cluster_version`, which is {version_2} with the supported patch version | ||
- [ ] If client-go pulled in a new version of gRPC, then also | ||
- [ ] Update the SDK [base image grpc version](https://github.com/googleforgames/agones/blob/main/build/includes/sdk.mk#L30) and rebuild the image. Note that this can take a while and in the past we have had to manually push it to gcr because cloud build doesn't like how long it takes. | ||
- [ ] Regenerate allocated API endpoints: [make gen-allocation-grpc](https://github.com/googleforgames/agones/blob/main/build/includes/allocation.mk#L55) | ||
- [ ] Regenerate all client sdks: [make gen-all-sdk-grpc](https://github.com/googleforgames/agones/blob/main/build/README.md#make-gen-all-sdk-grpc) | ||
- [ ] Update the version number in C++ Cmake scripts [here](https://github.com/googleforgames/agones/blob/main/sdks/cpp/CMakeLists.txt#L100) and [here](https://github.com/googleforgames/agones/blob/main/sdks/cpp/cmake/prerequisites.cmake#L34) | ||
- [ ] Confirm the update works as expected by running e2e tests | ||
- [ ] Update the Kubernetes version of the e2e clusters | ||
- [ ] In `terraform/e2e/module.tf`, update variable `kubernetes_versions_standard` and `kubernetes_versions_autopilot` to the new versions to be supported | ||
- [ ] Recreate cluster with new scripts: `cd build; make GCP_PROJECT=agones-images gcloud-e2e-test-cluster` | ||
- [ ] Update the Cloud Build configuration to run e2e test on the new created clusters | ||
- [ ] Update the `versionsAndRegions` variable to reflect new versions in `cloudbuild.yaml` `submit-e2e-test-cloud-build` step | ||
- [ ] Submit a PR to trigger the e2e tests and verfiy they all pass |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
{{- if or (eq (getenv "HUGO_ENV") "production") (eq (getenv "HUGO_ENV") "snapshot")}} | ||
{{- $.Page.Site.Params.aks_example_cluster_version }} | ||
{{- else }} | ||
{{- $.Page.Site.Params.dev_aks_example_cluster_version }} | ||
{{- end -}} |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
{{- if or (eq (getenv "HUGO_ENV") "production") (eq (getenv "HUGO_ENV") "snapshot")}} | ||
{{- $.Page.Site.Params.eks_example_cluster_version }} | ||
{{- else }} | ||
{{- $.Page.Site.Params.dev_eks_example_cluster_version }} | ||
{{- end -}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
{{- if or (eq (getenv "HUGO_ENV") "production") (eq (getenv "HUGO_ENV") "snapshot")}} | ||
{{- $.Page.Site.Params.gke_example_cluster_version }} | ||
{{- else }} | ||
{{- $.Page.Site.Params.dev_gke_example_cluster_version }} | ||
{{- end -}} |
Oops, something went wrong.