Steps to release a new version of the OpenTelemetry Operator:
- Change the
versions.txt
, so that it lists the target version of the OpenTelemetry Collector (operand), and the desired version for the operator. Themajor.minor
should typically match, with the patch portion being possibly different. - Run
make bundle VERSION=0.29.0
, using the version that will be released. - Change the compatibility matrix in the readme file, using the OpenTelemetry Operator version to be released and the current latest Kubernetes version as the latest supported version, with N-2 being the lower bound. Make sure that the CI is currently testing the latest Kubernetes version!
- Add the changes to the changelog
- Check the OpenTelemetry Collector's changelog and ensure migration steps are present in
pkg/collector/upgrade
- Once the changes above are merged and available in
main
, tag it with the desired version, prefixed withv
:v0.3.0
- The GitHub Workflow will take it from here, creating a GitHub release with the generated artifacts (manifests) and publishing the images
- After the release, generate a new OLM bundle (
make bundle
) and create two PRs against the Operator Hub Community Operators repository:- one for the
upstream-community-operators
, used by OLM on Kubernetes. Example:operator-framework/community-operators#2880
- one for the
community-operators
directory, used by OpenShift. Example:operator-framework/community-operators#2878
- one for the
Run this generator:
$ docker run --rm -v "${PWD}:/app" pavolloffay/gch:latest --oauth-token ${GH_WRITE_TOKEN} --owner open-telemetry --repo opentelemetry-operator --branch main
Remove the commits that are not relevant to users, like:
- CI or testing-specific commits (e2e, unit test, ...)
- bug fixes for problems that are not part of a release yet
- version bumps for internal dependencies