agones
agones copied to clipboard
SDK proto compatibility guarantees and deprecation policies documentation
What type of PR is this?
/kind documentation
What this PR does / Why we need it:
As part of work on In-place Agones Upgrades #3766 we are going to explicitly guarantee certain proto versions during upgrade and this documents that contract.
Which issue(s) this PR fixes:
Working on #3767
Special notes for your reviewer:
Build Failed :scream:
Build Id: 6cdcdd1b-9e58-4226-8a75-feccde6144f1
To get permission to view the Cloud Build view, join the agones-discuss Google Group.
Build Succeeded :clap:
Build Id: e052afdd-79b3-401c-b5c3-1925005d2485
The following development artifacts have been built, and will exist for the next 30 days:
- image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.40.0-dev-35bb0ca-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.40.0-dev-35bb0ca-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.40.0-dev-35bb0ca-linux-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.40.0-dev-35bb0ca-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.40.0-dev-35bb0ca-amd64
- Linux C++ SDK (build): agonessdk-1.40.0-dev-35bb0ca-amd64-linux-arch_64.tar.gz
- SDK Server: agonessdk-server-1.40.0-dev-35bb0ca-amd64.zip
A preview of the website (the last 30 builds are retained):
- https://35bb0ca-dot-preview-dot-agones-images.appspot.com/
To install this version:
-
git fetch https://github.com/googleforgames/agones.git pull/3774/head:pr_3774 && git checkout pr_3774
-
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.40.0-dev-35bb0ca-amd64
Build Succeeded :clap:
Build Id: 4863b84b-6c79-4432-93b0-6afffc87c23f
The following development artifacts have been built, and will exist for the next 30 days:
- image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.40.0-dev-2397fe5-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.40.0-dev-2397fe5-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.40.0-dev-2397fe5-linux-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.40.0-dev-2397fe5-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.40.0-dev-2397fe5-amd64
- Linux C++ SDK (build): agonessdk-1.40.0-dev-2397fe5-amd64-linux-arch_64.tar.gz
- SDK Server: agonessdk-server-1.40.0-dev-2397fe5-amd64.zip
A preview of the website (the last 30 builds are retained):
- https://2397fe5-dot-preview-dot-agones-images.appspot.com/
To install this version:
-
git fetch https://github.com/googleforgames/agones.git pull/3774/head:pr_3774 && git checkout pr_3774
-
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.40.0-dev-2397fe5-amd64
Meta question -- I'm wondering if this (and all other details on in-place upgrades), should be in: https://agones.dev/site/docs/installation/upgrading/
We definitely want to have the in-place upgrades info there. Probably most of what's in this PR could also go in there. If we switch it over I would probably both feature-gate it to when in-place upgrades is released in Alpha, and make even more explicit from what number release the info applies.
Build Succeeded :clap:
Build Id: a99431d6-e184-4d18-861d-afe579815c29
The following development artifacts have been built, and will exist for the next 30 days:
- image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.41.0-dev-fa4833a-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.41.0-dev-fa4833a-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.41.0-dev-fa4833a-linux-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.41.0-dev-fa4833a-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.41.0-dev-fa4833a-amd64
- Linux C++ SDK (build): agonessdk-1.41.0-dev-fa4833a-amd64-linux-arch_64.tar.gz
- SDK Server: agonessdk-server-1.41.0-dev-fa4833a-amd64.zip
A preview of the website (the last 30 builds are retained):
- https://fa4833a-dot-preview-dot-agones-images.appspot.com/
To install this version:
-
git fetch https://github.com/googleforgames/agones.git pull/3774/head:pr_3774 && git checkout pr_3774
-
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.41.0-dev-fa4833a-amd64
Build Failed :scream:
Build Id: 56deae11-2729-4d89-9ab5-387fb2bd1c9f
To get permission to view the Cloud Build view, join the agones-discuss Google Group.
Build Succeeded :clap:
Build Id: 6efe511b-85d9-498a-b41d-e8d76594b1af
The following development artifacts have been built, and will exist for the next 30 days:
- image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.41.0-dev-af68e81-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.41.0-dev-af68e81-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.41.0-dev-af68e81-linux-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.41.0-dev-af68e81-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.41.0-dev-af68e81-amd64
- Linux C++ SDK (build): agonessdk-1.41.0-dev-af68e81-amd64-linux-arch_64.tar.gz
- SDK Server: agonessdk-server-1.41.0-dev-af68e81-amd64.zip
A preview of the website (the last 30 builds are retained):
- https://af68e81-dot-preview-dot-agones-images.appspot.com/
To install this version:
-
git fetch https://github.com/googleforgames/agones.git pull/3774/head:pr_3774 && git checkout pr_3774
-
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.41.0-dev-af68e81-amd64
Build Succeeded :clap:
Build Id: 46514077-3708-4c8c-b15d-e507e0ea4daf
The following development artifacts have been built, and will exist for the next 30 days:
- image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.41.0-dev-787587c-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.41.0-dev-787587c-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.41.0-dev-787587c-linux-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.41.0-dev-787587c-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.41.0-dev-787587c-amd64
- Linux C++ SDK (build): agonessdk-1.41.0-dev-787587c-amd64-linux-arch_64.tar.gz
- SDK Server: agonessdk-server-1.41.0-dev-787587c-amd64.zip
A preview of the website (the last 30 builds are retained):
- https://787587c-dot-preview-dot-agones-images.appspot.com/
To install this version:
-
git fetch https://github.com/googleforgames/agones.git pull/3774/head:pr_3774 && git checkout pr_3774
-
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.41.0-dev-787587c-amd64
Build Succeeded :clap:
Build Id: ce94f97e-57d7-4847-94e0-3413d8fc653a
The following development artifacts have been built, and will exist for the next 30 days:
- image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.41.0-dev-25a2709-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.41.0-dev-25a2709-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.41.0-dev-25a2709-linux-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.41.0-dev-25a2709-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.41.0-dev-25a2709-amd64
- Linux C++ SDK (build): agonessdk-1.41.0-dev-25a2709-amd64-linux-arch_64.tar.gz
- SDK Server: agonessdk-server-1.41.0-dev-25a2709-amd64.zip
A preview of the website (the last 30 builds are retained):
- https://25a2709-dot-preview-dot-agones-images.appspot.com/
To install this version:
-
git fetch https://github.com/googleforgames/agones.git pull/3774/head:pr_3774 && git checkout pr_3774
-
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.41.0-dev-25a2709-amd64
Build Failed :scream:
Build Id: 6d19b32c-6fb8-47f4-9090-18f46b472544
To get permission to view the Cloud Build view, join the agones-discuss Google Group.
Flaky 1.29 Autopilot. Cleared the cluster and trying again.
Build Succeeded :clap:
Build Id: dd5563ed-ad3b-4e5d-ad1b-a4c03749b990
The following development artifacts have been built, and will exist for the next 30 days:
- image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.41.0-dev-a234f32-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.41.0-dev-a234f32-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.41.0-dev-a234f32-linux-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.41.0-dev-a234f32-amd64
- image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.41.0-dev-a234f32-amd64
- Linux C++ SDK (build): agonessdk-1.41.0-dev-a234f32-amd64-linux-arch_64.tar.gz
- SDK Server: agonessdk-server-1.41.0-dev-a234f32-amd64.zip
A preview of the website (the last 30 builds are retained):
- https://a234f32-dot-preview-dot-agones-images.appspot.com/
To install this version:
-
git fetch https://github.com/googleforgames/agones.git pull/3774/head:pr_3774 && git checkout pr_3774
-
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.41.0-dev-a234f32-amd64
Looks great! Sent #3827 to fix a minor issue.