Adds Documention for how to run an in-place Agones upgrade #3904

igooch · 2024-07-15T16:59:56Z

What type of PR is this?

/kind documentation

What this PR does / Why we need it:

User documentation for how to perform an Agones in-place upgrade.

Which issue(s) this PR fixes:

Working on #3766

Special notes for your reviewer:

agones-bot · 2024-07-15T18:24:29Z

Build Succeeded 👏

Build Id: bf13e86f-cb31-4dbf-bc9a-7a9eca971e6b

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

https://9d48f27-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.42.0-dev-9d48f27-amd64

agones-bot · 2024-07-16T19:51:10Z

Build Succeeded 👏

Build Id: 0f3adad3-ed2c-4494-ab0a-598c38feb4f9

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

https://b6ae796-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.42.0-dev-b6ae796-amd64

agones-bot · 2024-07-16T20:58:52Z

Build Succeeded 👏

Build Id: ee774e85-48d2-45cf-ae5d-0949b35edbee

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

https://891f503-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.42.0-dev-891f503-amd64

site/content/en/docs/Installation/upgrading.md

markmandel · 2024-07-19T01:03:52Z

site/content/en/docs/Installation/upgrading.md

+4. Run any other tests to ensure the Agones installation is working as expected.
+5. Congratulations - you have now upgraded to a new version of Agones! 👍
+
+##### Delay Upgrade to Existing Fleet (not recommended)


Why is one recommended over the other?

Do you mean compared to delaying the fleet upgrade, or compared to adding or not adding a label?

Compared to delaying the existing Fleet - we never specify why one is preferred over the other. We should be clear on that (I'm also curious 😆)

Totally legit question! I'll add in a more consise explanation somewhere on the "why".

It's because if the fleet is not ugpraded, none of the game servers are upgraded. Newly created game servers will be at the new configuraiton, but any existing ready game servers, or allocated game servers that return to the ready state will remain at the old configuraiton. This means that the fleet will remain at the old configuration for much longer. In and of itself that's not necessarily a bad thing, but if they do multiple Agones upgrades they could easily end up with several different versions of game servers in a fleet, and limited to no way of tracking which game server is at which version.

I did some rearranging / reordering. The wording or format could probably be clearer. Let me know if you have any additional suggestions!

site/content/en/docs/Installation/upgrading.md

agones-bot · 2024-07-19T19:42:40Z

Build Succeeded 👏

Build Id: fc512a2f-5ea9-4a23-98c5-7ae3a49ffa67

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

https://4081e5e-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.42.0-dev-4081e5e-amd64

agones-bot · 2024-07-25T17:36:31Z

Build Succeeded 👏

Build Id: 41fe7c03-3f06-4eeb-a6d2-736be22e4686

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

https://76b28c8-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.43.0-dev-76b28c8-amd64

agones-bot · 2024-08-05T19:27:11Z

Build Succeeded 🥳

Build Id: 9778b2fd-7db6-4b88-abec-2771a02438c7

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.43.0-dev-e05437f
image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.43.0-dev-e05437f
image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.43.0-dev-e05437f-linux
image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.43.0-dev-e05437f
image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.43.0-dev-e05437f
Linux C++ SDK (build): agonessdk-1.43.0-dev-e05437f-linux-arch_64.tar.gz
SDK Server: agonessdk-server-1.43.0-dev-e05437f.zip

A preview of the website (the last 30 builds are retained):

https://e05437f-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.43.0-dev-e05437f

agones-bot · 2024-08-26T22:16:03Z

Build Succeeded 🥳

Build Id: 1e293a75-e264-4184-bedd-8f27858ff0ac

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.43.0-dev-eb170ca
image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.43.0-dev-eb170ca
image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.43.0-dev-eb170ca-linux
image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.43.0-dev-eb170ca
image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.43.0-dev-eb170ca
Linux C++ SDK (build): agonessdk-1.43.0-dev-eb170ca-linux-arch_64.tar.gz
SDK Server: agonessdk-server-1.43.0-dev-eb170ca.zip

A preview of the website (the last 30 builds are retained):

https://eb170ca-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.43.0-dev-eb170ca

agones-bot · 2024-09-20T05:02:16Z

Build Succeeded 🥳

Build Id: 0f88e6b6-130e-47df-bb00-adecda7221d4

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.44.0-dev-0759344
image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.44.0-dev-0759344
image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.44.0-dev-0759344-linux
image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.44.0-dev-0759344
image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.44.0-dev-0759344
Linux C++ SDK (build): agonessdk-1.44.0-dev-0759344-linux-arch_64.tar.gz
SDK Server: agonessdk-server-1.44.0-dev-0759344.zip

A preview of the website (the last 30 builds are retained):

https://0759344-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.44.0-dev-0759344

agones-bot · 2024-10-10T22:32:04Z

Build Succeeded 🥳

Build Id: 4015b0a7-1a52-4308-9ab3-52680cc42a4e

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.45.0-dev-d3956c8
image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.45.0-dev-d3956c8
image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.45.0-dev-d3956c8-linux
image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.45.0-dev-d3956c8
image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.45.0-dev-d3956c8
Linux C++ SDK (build): agonessdk-1.45.0-dev-d3956c8-linux-arch_64.tar.gz
SDK Server: agonessdk-server-1.45.0-dev-d3956c8.zip

A preview of the website (the last 30 builds are retained):

https://d3956c8-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/3904/head:pr_3904 && git checkout pr_3904
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.45.0-dev-d3956c8

gongmax · 2024-10-11T16:24:09Z

site/content/en/docs/Installation/upgrading.md

+        configuration.
+        2. Any newly created Game Servers will be at the new configuration.
+        3. This make it difficult to track when the entire fleet is at a new configuration, and
+        increases the liklihood of having multiple Game Server configurations on the same Fleet.


liklihood -> likelihood

igooch requested a review from markmandel July 15, 2024 17:00

github-actions bot added the kind/documentation Documentation for Agones label Jul 15, 2024

igooch requested a review from zmerlynn July 15, 2024 17:00

github-actions bot added the size/S label Jul 15, 2024

igooch force-pushed the inPlaceUpgrades branch from a8ea960 to 9d48f27 Compare July 15, 2024 17:04

igooch force-pushed the inPlaceUpgrades branch from 9d48f27 to b6ae796 Compare July 16, 2024 18:47

igooch force-pushed the inPlaceUpgrades branch from b6ae796 to 891f503 Compare July 16, 2024 20:00

markmandel reviewed Jul 19, 2024

View reviewed changes

igooch force-pushed the inPlaceUpgrades branch 4 times, most recently from 356582b to e05437f Compare August 5, 2024 18:28

igooch force-pushed the inPlaceUpgrades branch 2 times, most recently from 1f73c25 to eb170ca Compare August 26, 2024 19:46

igooch added 4 commits September 19, 2024 20:58

Adds Documention for how to run an in-place Agones upgrade

a5f2609

Adds sample game server allocation

6b6a9d2

Minor updates to wording

79575e0

Add instructions for webhook error handling

0759344

igooch force-pushed the inPlaceUpgrades branch from 0bcca23 to 0759344 Compare September 20, 2024 03:58

Merge branch 'main' into inPlaceUpgrades

d3956c8

gongmax reviewed Oct 11, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Adds Documention for how to run an in-place Agones upgrade #3904

Adds Documention for how to run an in-place Agones upgrade #3904

igooch commented Jul 15, 2024

agones-bot commented Jul 15, 2024

agones-bot commented Jul 16, 2024

agones-bot commented Jul 16, 2024

markmandel Jul 19, 2024

igooch Jul 19, 2024 •

edited

Loading

markmandel Jul 30, 2024

igooch Aug 5, 2024

igooch Aug 5, 2024

agones-bot commented Jul 19, 2024

agones-bot commented Jul 25, 2024

agones-bot commented Aug 5, 2024

agones-bot commented Aug 26, 2024

agones-bot commented Sep 20, 2024

agones-bot commented Oct 10, 2024

gongmax Oct 11, 2024

Adds Documention for how to run an in-place Agones upgrade #3904

Are you sure you want to change the base?

Adds Documention for how to run an in-place Agones upgrade #3904

Conversation

igooch commented Jul 15, 2024

agones-bot commented Jul 15, 2024

agones-bot commented Jul 16, 2024

agones-bot commented Jul 16, 2024

markmandel Jul 19, 2024

Choose a reason for hiding this comment

igooch Jul 19, 2024 • edited Loading

Choose a reason for hiding this comment

markmandel Jul 30, 2024

Choose a reason for hiding this comment

igooch Aug 5, 2024

Choose a reason for hiding this comment

igooch Aug 5, 2024

Choose a reason for hiding this comment

agones-bot commented Jul 19, 2024

agones-bot commented Jul 25, 2024

agones-bot commented Aug 5, 2024

agones-bot commented Aug 26, 2024

agones-bot commented Sep 20, 2024

agones-bot commented Oct 10, 2024

gongmax Oct 11, 2024

Choose a reason for hiding this comment

igooch Jul 19, 2024 •

edited

Loading