[x] Run make shell and run gcloud config configurations activate agones-images.
[x] Review merged PRs in the current milestone to ensure that they have appropriate tags.
[x] git checkout main && git pull --rebase upstream main
[x] Run make pre-build-release to ensure all example images exist on agones-images/examples repository and to deploy the 1.43.0-1 service on GCP/App Engine/Services.
[x] Run make sdk-update-version release_stage=before version=1.43.0 file. This command will update the version number in the sdks/install files to 1.43.0.
run make release-example-image-markdown to populate example images and append the output in Images available with this release section
[x] Draft a new release with release draft. Update the Tag version and Release title with the release version and click on Generate release notes to generate the release notes with Full Changelog info for 1.43.0. Make sure to add the description. Include the Images available with this release section from the previous step that will be present after the Full Changelog and save the draft.
[x] copy the 1.43.0 release details from the Full Changelog and paste it on top of the CHANGELOG.md file
[x] Site updated
[x] Create a new file named 1.43.0.md in /site/content/en/blog/releases. Copy the draft release content in this file (this will be what you send via email)[refer the previous release file].
run make site-server frequently to make sure everything looks fine for the release in your localhost
[x] In site/content/en/docs/Installation/_index.md #agones-and-kubernetes-supported-versions, for the current version, replace {{% k8s-version %}} with hardcoded Kubernetes versions supported by the current version. And add a row for the Agones release version with {{% k8s-version %}} as its supported Kubernetes versions.
[x] Run make del-data-proofer-ignore FILENAME=1.43.0-1.md to remove data-proofer-ignore attribute from previous release blog. Review all occurrences of the link_test and data-proofer-ignore attributes globally. Exclude html and release files.
[x] Run make feature-shortcode-update version=1.43.0 to remove all instances of the feature expiryVersion shortcode, including the associated content, while preserving the rest of the content within the .md files located in site/content/en/docs. Additionally, ensure that only the block of feature publishVersion is removed without affecting the content.
[x] Add a link to previous version's documentation to nav dropdown in site/layouts/partials/navbar.html on top and Run make update-navbar-version FILENAME=site/layouts/partials/navbar.html to remove the older version from the dropdown list.
[x] config.toml updates:
[x] Run make site-config-update-version to update the release version and sync data between dev and prod.
[x] Update documentation with updated example images tags.
[x] Create PR with these changes, and merge them with an approval.
[x] Run git remote update && git checkout main && git reset --hard upstream/main to ensure your code is in line
with upstream (unless this is a hotfix, then do the same, but for the release branch)
[x] Publish SDK packages
[x] Run make sdk-shell-node to get interactive shell to publish node package. Requires Google internal process
to publish.
[x] Run make sdk-publish-csharp to deploy to NuGet. Requires login credentials.
Will need NuGet API Key from Agones account.
[x] Run make post-build-release to build the artifacts in GCS(These files will be attached in the release notes) and to push the latest images in the release repository and push chart on agones-chart.
[x] Run make shell and run gcloud config configurations activate <your development project> to switch Agones
development tooling off of the agones-images project.
[x] Smoke Test: run make install-release to view helm releases, uninstall agones-system namesapce, fetch the latest version of Agones, verify the new version, installing agones-system namespace, and list all the pods of agones-system.
[x] Attach all assets found in the cloud storage with 1.43.0 to the draft GitHub Release.
[x] Copy any review changes from the release blog post into the draft GitHub release.
[x] Publish the draft GitHub Release.
[x] Run make release-branch to create a release branch and run gcloud config configurations activate <your development project> to switch Agones development tooling off of the agones-images project.
[x] Email mailing lists with the release details (copy-paste the release blog post). Refer to the Internal Mailing list posting guide for details.
[x] Paste the announcement blog post to the #users Slack group.
[x] Run make sdk-publish-rust. This command executes cargo login for authentication, performs a dry-run publish, and if that succeeds, does the actual publish. Will need crate's API TOKEN from your crate's account.
[x] Run make sdk-update-version release_stage=after version=1.43.0 file. This command will update the SDKs and install directories files with 1.43.0+1-dev and will also set 1.43.0+1 in build/Makefile.
[x] Create PR with these changes, and merge them with approval
[x] Close this issue. Congratulations! - the release is now complete! :tada: :clap: :smile: :+1:
Release 1.43.0
Prerequisites
Editor
level access toagones-images
project.git remote -v
and see:origin
remote that points to a personal fork of Agones, such asgit@github.com:yourname/agones.git
.upstream
remote that points togit@github.com:googleforgames/agones.git
.gcloud config configurations
configuration calledagones-images
that points to the same project.Steps
make shell
and rungcloud config configurations activate agones-images
.git checkout main && git pull --rebase upstream main
make pre-build-release
to ensure all example images exist on agones-images/examples repository and to deploy the 1.43.0-1 service on GCP/App Engine/Services.make sdk-update-version release_stage=before version=1.43.0
file. This command will update the version number in the sdks/install files to 1.43.0.make release-example-image-markdown
to populate example images and append the output inImages available with this release
sectionTag version
andRelease title
with the release version and click onGenerate release notes
to generate the release notes withFull Changelog
info for 1.43.0. Make sure to add the description. Include theImages available with this release
section from the previous step that will be present after theFull Changelog
and save the draft.Full Changelog
and paste it on top of the CHANGELOG.md file/site/content/en/blog/releases
. Copy the draft release content in this file (this will be what you send via email)[refer the previous release file].make site-server
frequently to make sure everything looks fine for the release in your localhostsite/content/en/docs/Installation/_index.md #agones-and-kubernetes-supported-versions
, for the current version, replace{{% k8s-version %}}
with hardcoded Kubernetes versions supported by the current version. And add a row for the Agones release version with{{% k8s-version %}}
as its supported Kubernetes versions.make del-data-proofer-ignore FILENAME=1.43.0-1.md
to removedata-proofer-ignore
attribute from previous release blog. Review all occurrences of the link_test and data-proofer-ignore attributes globally. Exclude html and release files.make feature-shortcode-update version=1.43.0
to remove all instances of thefeature expiryVersion
shortcode, including the associated content, while preserving the rest of the content within the .md files located in site/content/en/docs. Additionally, ensure that only the block offeature publishVersion
is removed without affecting the content.site/layouts/partials/navbar.html
on top and Runmake update-navbar-version FILENAME=site/layouts/partials/navbar.html
to remove the older version from the dropdown list.make site-config-update-version
to update the release version and sync data between dev and prod.git remote update && git checkout main && git reset --hard upstream/main
to ensure your code is in line with upstream (unless this is a hotfix, then do the same, but for the release branch)make sdk-shell-node
to get interactive shell to publish node package. Requires Google internal process to publish.make sdk-publish-csharp
to deploy to NuGet. Requires login credentials. Will need NuGet API Key from Agones account.make post-build-release
to build the artifacts in GCS(These files will be attached in the release notes) and to push the latest images in the release repository and push chart on agones-chart.make shell
and rungcloud config configurations activate <your development project>
to switch Agones development tooling off of theagones-images
project.make install-release
to view helm releases, uninstall agones-system namesapce, fetch the latest version of Agones, verify the new version, installing agones-system namespace, and list all the pods of agones-system.make release-branch
to create a release branch and rungcloud config configurations activate <your development project>
to switch Agones development tooling off of theagones-images
project.git checkout main
.make sdk-publish-rust
. This command executescargo login
for authentication, performs a dry-run publish, and if that succeeds, does the actual publish. Will need crate's API TOKEN from your crate's account.make sdk-update-version release_stage=after version=1.43.0
file. This command will update the SDKs and install directories files with1.43.0+1-dev
and will also set1.43.0+1
inbuild/Makefile
.