Skip to content

Latest commit

 

History

History
103 lines (56 loc) · 3.85 KB

RELEASE-PROCESS.MD

File metadata and controls

103 lines (56 loc) · 3.85 KB
Raw

Release Process

The release process of a new version of KEDA involves the following:

0. Prerequisites

Look at the last released version in the releases page: https://github.com/kedacore/keda/releases For example: currently it is 2.3.0 The next version will thus be 2.4.0

1. Changelog

Provide a new section in CHANGELOG.md for the new version that is being released along with the new features, patches and deprecations it introduces.

It should not include every single change but solely what matters to our customers, for example issue template that has changed is not important.

2. Add the new version to GitHub Bug report template

Add the new released version to the list in KEDA Version dropdown in 3_bug_report.yml.

3. Publish documentation for new version

Publish documentation for new version on https://keda.sh.

See docs.

4. Create KEDA release on GitHub

Creating a new release in the releases page (https://github.com/kedacore/keda/releases) will trigger a GitHub workflow which will create a new image with the latest code and tagged with the next version (in this example 2.4.0).

KEDA Deployment YAML file (eg. keda-2.4.0.yaml) is also automatically created and attached to the Release as part of the workflow.

Note: The container registry repo with all the different images can be seen here

Release template

Every release should use the provided template below to create the GitHub release and ensure that a new GitHub Discussion is created.

💡 Don't forget to update the version & new contributors in the template

Here's the template:

We are happy to release KEDA <INSERT-CORRECT-VERSION> 🎉

Here are some highlights:

- <list highlights>

Learn how to deploy KEDA by reading [our documentation](https://keda.sh/docs/INSERT-CORRECT-VERSION/deploy/).

### New

- <list items>

### Improvements

- <list items>

### Breaking Changes

- <list items>

### Other

- <list items>

### New Contributors

<generated new contributors info>

Generating new contributor's info

In order to generate a list of new contributors, use the Auto-generate release notes GitHub feature of the release.

Screenshot

image

5. Setup continous container scanning with Snyk

In order to continuously scan our new container image, they must be imported in our Snyk project for all newly introduced tags.

Learn more on how to do this through the Snyk documentation.

Note: Remember to enable the check Without issues in order to get the new version listed since probably it hasn't got any issue.

6. Prepare our Helm Chart

Before we can release our new Helm chart version, we need to prepare it:

  • Update the version and appVersion in our chart definition.
  • Update the CRDs & Kubernetes resources based on the release artifact (YAML)

7. Ship new Helm chart

Guidance on how to release it can be found in our contribution guide.

8. Prepare next release

Prepare next release by creating a new GitHub milestone called v{upcoming-semver-version} with a target date in 3 months as per our release governance.