release

README

• Kubernetes Release
  • Intro
  • Tools
  • Release Notes Gathering
  • Building Linux Packages
    • For Debian
    • For Fedora, CentOS, Red Hat Enterprise Linux
  • Contributing

Kubernetes Release

This repo contains the tooling and infrastructure to create Kubernetes releases from the kubernetes/kubernetes main repository.

Intro

There are several scripts and helpers in this repository a release manager will find useful when managing all kinds of releases (alpha, beta, official, rc) across branches.

Tools

Most tools in this repo run by default in mock mode to allow for ease in development and testing.

Tools	Description
gcbmgr	Google Cloud Builder Manager: This is the main entry point for release managers for producing releases. All release types can be staged and later released using this method.
anago	Release Tool: The main driver for creating staged builds and releases. This is what runs inside GCB after a job is submitted using gcbmgr.
branchff	Fast-forward branching helper: A tool used to pull new patches onto the release branch.
find_green_build	Asks Jenkins for a good build to use.
release-notes	Scrape GitHub for release notes. See Release Notes Gathering for more information.
prin	To show release tags of a particular PR or commit.
push-build.sh	Pushes a developer build or CI Jenkins build up to GCS.
script-template	Generates a script template in the kubernetes/release ecosystem.
testgridshot	Screenshots failing testgrid dashboards and creates a markdown stub that can be copied and pasted into a GitHub issue comment. This makes it easier to create comments like this as part of the release process.

For information on how to use gcbmgr, anago and branchff, see the Branch Manager Handbook

Release Notes Gathering

For more extensive build and usage documentation for the release-notes tool, see the documentation.

Once the tool is installed, use -h or --help to see the command usage:

$ release-notes -h
Usage of release-notes:
  -end-sha string
        The commit hash to end at
  -format string
        The format for notes output (options: markdown, json) (default "markdown")
  -github-token string
        A personal GitHub access token (required)
  -output string
        The path to the where the release notes will be printed
  -start-sha string
        The commit hash to start at

Building Linux Packages

For Debian

You can build the deb packages in a Docker container like this:

make build-debs

The build runs for a while, after it's done you will find the output in _output/debs.

For Fedora, CentOS, Red Hat Enterprise Linux

You can build the rpm packages in a Docker container with:

make build-rpms

Resulting rpms, and a pre-generated yum repository will be generated in _output/rpms.

Contributing

Please see CONTRIBUTING.md for instructions on how to contribute.