Home

Release checklist

Releasing promscale consists of the following steps:

Prepare and merge release PR

• Update helm-chart/Chart.yml
• Update Promscale, PromMigrator, and supported promscale_extension versions in pkg/version/version.go
• Update prom-migrator version in .goreleaser (2 places)
• Run bash generate-deploy-script.sh
• Commit: git commit -a -m "Prepare for the 0.1.0-alpha.4 release"
• PR & Merge

Prepare git tag

• tag: git tag -a 0.1.0-alpha.1 -m "Release 0.1.0-alpha.1" && git push origin 0.1.0-alpha.1

Export helm charts

Note: Currently only @cevian can upload the charts to the s3 bucket below.

• Run helm package helm-chart/
• Copy helm package into charts dir
• in charts dir run
  • /usr/local/bin/aws --profile <profile> s3 sync s3://charts.timescale.com .
  • helm repo index .
  • /usr/local/bin/aws --profile <profile> s3 sync --acl public-read . s3://charts.timescale.com

Set GitHub release message

The goreleaser GitHub Action should automatically create a new release, but the release notes need to be updated.

Changelog

Determine the most recent release <PREV_RELEASE> and the current release <CURRENT_RELEASE>, and then run the following git command:

git log --oneline --no-merges --decorate=no <PREV_RELEASE>..<CURRENT_RELEASE>

Thanks

It's nice to shout out to community members who've contributed some changes. Use the following to find all authors (and then figure out who are internal and external on your own):

git shortlog --summary --numbered --email <PREV_RELEASE>..<CURRENT_RELEASE>

Post-release

• Update Version and PrevReleaseVersion in pkg/version/version.go to next devel version
• Commit: git commit -a -m "Prepare for the next development cycle"
• PR & Merge

(Optional) Update tobs

• Update chart/Chart.yaml: change version, app-version and dependencies.timescale-prometheus.version
• Update chart/values.yml: change promscale.image to the appropriate tag.
• Update version.go
• Update version in install-cli.sh
• Run helm dependency update chart/
• Run bash generate-deploy-script.sh
• Run cd cli && go mod tidy && cd ..
• Commit: git commit -a -m "Release 0.1.0-alpha.4"
• PR, test locally, merge
• git tag -a 0.1.0-alpha.1 -m "Release 0.1.0-alpha.1" && git push origin 0.1.0-alpha.1
• make sure goreleaser action runs (manual run: cd cli && GITHUB_TOKEN=??? goreleaser && cd ..)
• run helm package chart
• Copy helm package into charts dir
• in charts dir run
  • /usr/local/bin/aws --profile <profile> s3 sync s3://charts.timescale.com .
  • helm repo index .
  • /usr/local/bin/aws --profile <profile> s3 sync --acl public-read . s3://charts.timescale.com