Cut v1.17.0 on Aug 28, 2024

[jbw976]

This issue can be closed when we have completed the following steps (in order). Please ensure all artifacts (PRs, workflow runs, Tweets, etc) are linked from this issue for posterity. Refer to this prior release issue for examples of each step, assuming release vX.Y.0 is being cut.

Code Freeze

• [x] [In Crossplane Runtime]: Prepared the release branch release-X.Y:
  • [x] Confirm that all security/critical dependency update PRs from Renovate are merged into master
  • https://github.com/crossplane/crossplane-runtime/pulls?q=is%3Apr+is%3Aopen+label%3Aautomated
  • [x] Created the release branch using the GitHub UI.
  • [x] (On the Master Branch) Created and merged an empty commit with git commit --allow-empty -s -m "Empty commit after release-X.Y": https://github.com/crossplane/crossplane-runtime/pull/759
  • [x] (On the Master Branch) Run the Tag workflow with the release candidate tag for the next release vX.Y+1.0-rc.0. Message suggested, but not required: Release candidate vX.Y+1.0-rc.0..
  • [x] (On the Release Branch) Run the Tag workflow with the release candidate tag for the next release vX.Y.0-rc.1 (assuming the latest rc tag for vX.Y.0 is vX.Y.0-rc.0). Message suggested, but not required: Release candidate vX.Y.0-rc.1..
• [x] [In Core Crossplane]: Prepared the release branch release-X.Y:
  • [x] Confirm that all security/critical dependency update PRs from Renovate are merged into master
  • https://github.com/crossplane/crossplane/pulls?q=is%3Apr+is%3Aopen+label%3Aautomated
  • [x] Created the release branch using the GitHub UI.
  • [x] (On the Master Branch) created and merged a PR bumping the Crossplane Runtime dependency to the release candidate tag from master, vX.Y+1.0-rc.0.
  • [x] (On the Release Branch) created and merged a PR bumping the Crossplane Runtime dependency to the release candidate tag on the release branch, vX.Y.0-rc.1.
  • [x] (On the Master Branch) Run the Tag workflow with the release candidate tag for the next release, vX.Y+1.0-rc.0. Message suggested, but not required: Release candidate vX.Y+1.0-rc.0..
  • [x] (On the Master Branch) created and merged a PR to add the new release branch to the baseBranches list in .github/renovate.json5.
• [x] [In Core Crossplane]: Cut a Crossplane release candidate from the release branch release-X.Y:
  • [x] (On the Release Branch) Run the Tag workflow with the release candidate tag for the release vX.Y.0-rc.1 (assuming the latest rc tag for vX.Y.0 is vX.Y.0-rc.0). Message suggested but not required: Release candidate vX.Y.0-rc.1..
  • [x] (On the Release Branch) Run the CI workflow and verified that the tagged build version exists on the releases.crossplane.io build channel, e.g. build/release-X.Y/vX.Y.0-rc.1/... should contain all the relevant binaries.
  • [x] (On the Release Branch) Run the Promote workflow with channel stable, ticking the box for This is a pre-release and verify:
  • [x] The tagged build version exists on the releases.crossplane.io stable channel at stable/vX.Y.0-rc.1/....
  • [x] The tagged build is NOT marked as "current" in stable/current/version.
  • [x] Ensured that the release candidate is visible on the stable helm repo with: helm repo add crossplane-stable https://charts.crossplane.io/stable --force-update && helm search repo crossplane-stable --devel.
  • [x] Published a new release for the tagged version as pre-release, with the same name as the version, taking care of generating the changes list selecting as "Previous tag" vX.<Y-1>.0, so the first of the releases for the previous minor.
  • [x] Select the Set as a pre-release and Create a discussion for this release checkboxes.
  • [x] Do NOT select the Set as the latest release checkbox.
  • [x] Ensured that users have been notified about the release candidate on the #announcement channel of the Crossplane's Slack workspace.

Release

• [x] Opened a docs release issue
• [x] Checked that the GitHub milestone for this release only contains closed issues.
• [x] Cut a Crossplane Runtime version and consume it from Crossplane.
  • [x] [In Crossplane Runtime]: Run the Tag workflow on the release-X.Y branch with the proper release version, vX.Y.0. Message suggested, but not required: Release vX.Y.0.
  • [x] Published a new release for the tagged version, with the same name as the version, taking care of generating the changes list selecting as "Previous tag" vX.<Y-1>.0, so the first of the releases for the previous minor.
  • [x] [In Core Crossplane]: (On the Release Branch) Update the Crossplane Runtime dependency to vX.Y.0.
• [x] (On the Release Branch) Run the Tag workflow with the proper release version, vX.Y.0. Message suggested, but not required: Release vX.Y.0.
• [x] (On the Release Branch) Run the CI workflow and verified that the tagged build version exists on the releases.crossplane.io build channel, e.g. build/release-X.Y/vX.Y.0/... should contain all the relevant binaries.
• [x] (On the Release Branch) Run the Promote workflow with channel stable and verified that the tagged build version exists on the releases.crossplane.io stable channel at stable/vX.Y.0/....
• [x] Select a release MVP from the community that had significant impact on the release and include recognition of them in the release notes and blog post.
• [x] Published a new release for the tagged version, with the same name as the version and descriptive release notes
  • [x] generate the changes list by selecting the "Previous tag" as vX.<Y-1>.0, i.e., the first of the releases for the previous minor.
  • [x] Ensure the release MVP is recognized in the release notes.
  • [x] Before publishing the release notes, set them as Draft and ask the rest of the team to double check them.
• [x] Checked that the docs release issue created previously has been completed.
• [x] Updated, in a single PR, the following on master:
  • [x] The releases table in the README.md, removing the now old unsupported release and adding the new one.
  • [x] The baseBranches list in .github/renovate.json5, removing the now old unsupported release.
• [x] Closed the GitHub milestone for this release.
• [x] Request @jbw976 to perform a CloudFront cache invalidation on https://charts.upbound.io/stable/ and https://releases.crossplane.io/stable/
• [ ] ~Publish a blog post about the release to the crossplane blog~
  • [ ] ~Ensure the release MVP is recognized in the blog post~
  • [x] @jbw976: skipping the blog post this time for now due to resource constraints
• [x] Ensured that users have been notified of the release on all communication channels:
  • [x] Slack: #announcements channel on Crossplane's Slack workspace.
  • [x] Twitter: reach out to a Crossplane maintainer or steering committee member, see OWNERS.md.
  • [x] LinkedIn: same as Twitter
• [x] Request @jbw976 to remove all old docs versions from Google Search
• [x] Remove any extra permissions given to release team members for this release

[jbw976]

I think we are ready to start the Code Freeze section now. We can cut a RC build of crossplane-runtime and core crossplane and let that bake for 1 week until the actual v1.17 release.

[jbw976]

We've decided to go ahead with promoting Composition Functions to GA maturity in v1.17 :tada: - Functions have gained rapid adoption within the community and we feel quite good about the future of building platforms using Crossplane and Functions.

@negz has a PR open in core crossplane to promote to GA: https://github.com/crossplane/crossplane/pull/5885

We will start the code freeze period after this has been merged, then publish a release candidate (RC) that the community can test. After that bakes for 1 week, we will then cut the full v1.17 release.