Skip to content
Nick Satterly edited this page Mar 18, 2023 · 18 revisions

Release Checklist

Release steps for API...

  1. update CHANGELOG run...
$ cz ch --incremental --unreleased-version vX.Y.Z
  1. bump VERSION and alerta/version.py files

  2. git commit to master

$ git commit -m 'Bump version A.B.C -> X.Y.Z'
$ git push
  1. Check all tests pass

  2. tag commit with "vX.Y.Z" and push to trigger upload to PyPI

$ git tag -a vX.Y.Z -m 'version X.Y.Z'
$ git push --follow-tags
  1. Verify auto-deploy to fly.io

https://alerta-api.fly.dev/management/status

  1. cut github release

https://github.com/alerta/alerta/releases

Release steps for CLI...

  1. update CHANGELOG run...
$ cz ch --incremental --unreleased-version vX.Y.Z
  1. bump VERSION and alertaclient/version.py files

  2. git commit to master

$ git commit -m 'Bump version A.B.C -> X.Y.Z'
$ git push
  1. Check all tests pass

  2. tag commit with "vX.Y.Z" and push to trigger upload to PyPI

$ git tag -a vX.Y.Z -m 'version X.Y.Z'
$ git push --follow-tags
  1. cut github release

https://github.com/alerta/python-alerta-client/releases

Release steps for web UI

  1. bump version in package.json and package-lock.json

  2. git add and commit

  3. git tag alerta webui release

  4. git push --follow-tags (wait for build artifact to be uploaded)

  5. cut github release https://github.com/alerta/alerta-webui/releases

  6. check auto-deploy to https://beta.alerta.io

  7. deploy to heroku https://alerta.herokuapp.com

Release steps for Docker

  1. bump VERSION
  2. git commit, tag and push

Release steps for deployments

  1. deploy to Heroku public API
  2. bump docker-alerta repo VERSION file https://github.com/alerta/docker-alerta/releases
  3. trigger docker build for new VERSION https://cloud.docker.com/u/alerta/repository/docker/alerta/alerta-web

Documentation

  1. Release notes in each github repo
  2. release notes on docs.alerta.io
  3. update docs.alerta.io
  4. mention new release on Gitter
  5. update alerta.io landing page

Help

To tag a release run:

$ git tag -a v6.3.1 -m 'version 6.3.1'
$ git push --tags

or use the make shortcut:

$ make tag