cloudxtreme/release

Release infrastructure for Kubernetes and related components

Table of Contents

• Intro
• Instructions (Quick Start)
• Other Tools
  • Tools
    • Release Notes Gathering

Kubernetes Release Process

This repo contains the release infrastructure for Kubernetes.

Intro

Kubernetes releases are done by the Kubernetes team at Google due to permissions and other restrictions. This may expand eventually to allow other Kubernetes contributors to generate releases.

The current process runs by default in mock mode and anyone should be able to run it in this mode to see exactly how the process works. In mock mode all the code paths are followed for a release, but nothing is pushed to repositories.

Sticking with the ancient Greek theme, the release script is called anago. Anago means, in the context of navigators and shipping: "to launch out, set sail, put to sea."

Tools in this repository includes a familiar *nix-style man page with usage, process and examples. The link shows how the self-contained doc/man page makes up the header of the script itself and the same info is available on the command-line (or get usage simply by calling the script with no options):

$ anago -man

The idea is that no external doc updates should be necessary and the tool itself contains all of the details and instructions and prerequisite checks needed for anyone to run the tool in at least mock mode.

There is a simple $USER check to ensure that noone but a certain few people can run the script with --nomock to perform a real release.

Instructions (Quick Start)

The tool was designed to require minimal inputs. The only information the tool needs is to know where you want to create a release with one optional flag [--official] (used on release-* branches only).

Try an alpha release:

$ anago master

Try a beta release on a branch:

$ anago release-1.2

Try an official release on a branch:

$ anago release-1.2 --official

Try a beta release on a new branch:

$ anago release-9.9

Try creating a new branch and beta for an emergency zero-day fix. See docs/branching.md for more details.

(The branch name should reflect the branch point/tag. So if branching at the v9.9.9 tag on the release-9.9 branch, create a release-9.9.9 branch):

$ anago release-9.9.9

Official Releases

Anago is currently locked down to only run for a specific set of individuals. when --nomock is specified.

Adding that flag to the command-line indicates the release will push tags and artifacts. The user is still prompted before a push occurs, however.

Other Tools

All standalone scripts have embedded man pages. Just use -man to view or your favorite editor.

Tools

• mailer : Generic mail interface (due to Google's deprecation of sendmail)
• find_green_build : Ask Jenkins for a good build to use
• script-template : Generate a script template in the kubernetes/release ecosystem
• relnotes : Scrape github for release notes (See below for more info)
• branchff : Fast-forward branching helper
• changelog-update : Update CHANGELOG.md version entries by rescanning github for text and label changes

Release Notes Gathering

# get details on how to use the tool
$ relnotes -man
$ cd /kubernetes

# Show release notes from the last release on a branch to HEAD
$ relnotes

# Show release notes from the last release on a specific branch to branch HEAD
$ relnotes --branch=release-1.2

# Show release notes between two specific releases
$ relnotes v1.2.0..v1.2.1 --branch=release-1.2

Please report any issues you encounter.