Release Engineering tooling

This directory contains tooling to generate Prow jobs. While some of this may be generically useful for other cases, the primary function of these tools is to generate release branch jobs after kubernetes/kubernetes releases which create new branches.

NOTE: The documentation here supersedes overlapping guidance from the Release Manager handbooks (which will be removed at a future date).

• Tools
• Release branch jobs
  • Generate jobs
  • Update release dashboards
  • Check/resolve configuration errors
  • Create a pull request
  • Validate
  • Announce

Tools

• generate_tests.py: Populates generated jobs based on the configurations specified in test_config.yaml
• prepare_release_branch.py: Generates release branch jobs using config-forker and config-rotator
• config-forker: Forks presubmit, periodic, and postsubmit job configs with the fork-per-release annotation
• config-rotator: Rotates forked presubmit, periodic, and postsubmit job configs created by config-forker

Release branch jobs

WARNING: Release branch jobs generation for 1.28+ requires special steps that are yet to be documented. See #29387 and "TODO(1.29)" comments for more details.

This task should be done after the release is complete and previous PRs are merged. The following steps should be run from the root of this repository.

Generate jobs

make -C releng prepare-release-branch

Update release dashboards

Update release dashboards in the Testgrid config (example commit).

• Remove the oldest release sig-release-<version>-{blocking,informing} dashboards
• Add dashboards for the current release e.g., sig-release-1.23-{blocking,informing}

Check/resolve configuration errors

make verify

Create a pull request

Issue a PR with the new release branch job configurations (example PR).

Validate

Once the PR has merged, verify that the new dashboards have been created and are populated with jobs.

Examples:

• sig-release-1.27-blocking
• sig-release-1.27-informing

Announce

Announce in #sig-release and #release-management that this work has been completed.