Skip to content

Latest commit

 

History

History
58 lines (42 loc) · 4.33 KB

RELEASE.md

File metadata and controls

58 lines (42 loc) · 4.33 KB

Releasing

Output

Expected artifacts

  1. A container image of the cluster-api-provider-openstack controller manager

Artifact locations

  1. The container image is found in the registry us.gcr.io/k8s-artifacts-prod/capi-openstack/ with an image name of capi-openstack-controller and a tag that matches the release version. For example, in the v0.2.0 release, the container image location is us.gcr.io/k8s-artifacts-prod/capi-openstack/capi-openstack-controller:v0.2.0

Process

  1. Make sure your repo is clean by git's standards
  2. If this is a new minor release, create a new release branch and push to github, otherwise switch to it, for example release-0.2
  3. Run make release-notes to gather changes since the last revision. If you need to specify a specific tag to look for changes since, use make release-notes ARGS="--from <tag>" Pay close attention to the ## :question: Sort these by hand section, as it contains items that need to be manually sorted.
  4. Tag the repository and push the tag git tag -s -m $VERSION $VERSION; git push upstream $VERSION
  5. Create a draft release in github and associate it with the tag that was just created, copying the generated release notes into the draft.
  6. Checkout the tag you've just created and make sure git is in a clean state
  7. Run make release
  8. Attach the files to the drafted release:
    1. ./out/infrastructure-components.yaml
    2. ./templates/cluster-template.yaml
    3. ./templates/cluster-template-without-lb.yaml
    4. ./metadata.yaml (clusterctl >0.3.1 will include hardcoded metadata for CAPO. But let's keep the metadata.yaml file for our v0.3.* releases to be compatible with clusterctl <=0.3.1)
  9. Perform the image promotion process. The staging repository is at https://console.cloud.google.com/gcr/images/k8s-staging-capi-openstack/GLOBAL. Be sure to choose the top level capi-openstack-controller, which will provide the multi-arch manifest, rather than one for a specific architecture. Add the new sha=>tag mapping to the images.yaml (use the sha of the image with the corresponding tag)
  10. Finalise the release notes
  11. Publish release. Use the pre-release option for release candidate versions of Cluster API Provider OpenStack.
  12. Email [email protected] to announce the release

Permissions

Releasing requires a particular set of permissions.

Staging

There is a post-submit Prow job running after each commit on master which pushes a new image to the staging repo (gcr.io/k8s-staging-capi-openstack/capi-openstack-controller:latest). Following configuration is involved: