agones
agones copied to clipboard
Release 1.43.0
Release 1.43.0
Prerequisites
- [x] Have at least
Editor
level access toagones-images
project. - [x] Have permission to publish new versions of the App Engine application.
- [x] Have write access to Agones GitHub repository.
- [x] Run
git remote -v
and see:- [x] An
origin
remote that points to a personal fork of Agones, such as[email protected]:yourname/agones.git
. - [x] An
upstream
remote that points to[email protected]:googleforgames/agones.git
.
- [x] An
- [x] Have a
gcloud config configurations
configuration calledagones-images
that points to the same project. - [x] Edit access to the Agones Release Calendar
- [x] Get approval for Release Title and Description
Steps
- [x] Run
make shell
and rungcloud 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. - [x] Create a draft release with the release template.
- run
make release-example-image-markdown
to populate example images and append the output inImages available with this release
section - [x] Draft a new release with release draft. Update the
Tag 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. - [x] copy the 1.43.0 release details from the
Full Changelog
and paste it on top of the CHANGELOG.md file
- run
- [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 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. - [x] Run
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. - [x] Add a link to previous version's documentation to nav dropdown in
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. - [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] Run
- [x] Create a new file named 1.43.0.md in
- [x] Create PR with these changes, and merge them with an approval.
- [ ] 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) - [ ] Publish SDK packages
- [ ] Run
make sdk-shell-node
to get interactive shell to publish node package. Requires Google internal process to publish. - [ ] Run
make sdk-publish-csharp
to deploy to NuGet. Requires login credentials. Will need NuGet API Key from Agones account.
- [ ] Run
- [ ] 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. - [ ] Run
make shell
and rungcloud config configurations activate <your development project>
to switch Agones development tooling off of theagones-images
project. - [ ] 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. - [ ] Attach all assets found in the cloud storage with 1.43.0 to the draft GitHub Release.
- [ ] Copy any review changes from the release blog post into the draft GitHub release.
- [ ] Publish the draft GitHub Release.
- [ ] Run
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. - [ ] Email mailing lists with the release details (copy-paste the release blog post). Refer to the Internal Mailing list posting guide for details.
- [ ] Paste the announcement blog post to the #users Slack group.
- [ ] Post to the agonesdev Twitter account.
- [ ] Run
git checkout main
. - [ ] Run
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. - [ ] Run
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
. - [ ] Create PR with these changes, and merge them with approval
- [ ] Close this issue. Congratulations! - the release is now complete! :tada: :clap: :smile: :+1: