Skip to content

Release Procedure

Joris Roovers edited this page Mar 7, 2023 · 18 revisions

Pre-release work

  • Check that you've included the latest CLI output in the documentation homepage
  • Update the CHANGELOG.md

Release

Push new docs

mkdocs gh-deploy

Commit and push release commit to github

Template commit message:

0.1.0 release

[copy release notes here]

Full Release details in CHANGELOG.md.

WAIT FOR CI TO FINISH TESTING

Tag git commit

git tag v0.19.0rc1
git tag --list
git push --tags

Create a new release on github

Go to the releases page and create a new release. Copy in changes from the raw CHANGELOG.md

Manual sanity checks

PyPI

GITLINT_VERSION="$(hatch version)"
virtualenv "/tmp/gitlint-release-$GITLINT_VERSION" &&  source "/tmp/gitlint-release-$GITLINT_VERSION/bin/activate"
pip install gitlint
gitlint --version
gitlint --debug

Docker

# Remove local copies
docker image rm -f jorisroovers/gitlint:$GITLINT_VERSION
docker image rm -f jorisroovers/gitlint:latest
docker image rm -f jorisroovers/gitlint


# Pull image from dockerhub and test again
docker run -v $(pwd):/repo jorisroovers/gitlint:$GITLINT_VERSION --version
docker run -v $(pwd):/repo jorisroovers/gitlint:$GITLINT_VERSION --debug
docker run -v $(pwd):/repo jorisroovers/gitlint:latest --version
docker run -v $(pwd):/repo jorisroovers/gitlint:latest --debug
docker run -v $(pwd):/repo jorisroovers/gitlint --version
docker run -v $(pwd):/repo jorisroovers/gitlint --debug

Post Release Steps

Bump version to dev

Bump the version number in gitlint/__init__.py

# From host system
export NEW_VERSION="0.9.0dev"
echo -e "Version bump to $NEW_VERSION\n\nBumped version to $NEW_VERSION." > /tmp/gitlint-$NEW_VERSION-version-bump-commitmsg
git commit -F /tmp/gitlint-$NEW_VERSION-version-bump-commitmsg
git tag $NEW_VERSION
git tag --list
git show # Tag should show up
git push

Make sure to shutdown any AWS Windows testing VMs

Ask harens in associated Release Plan issue to push builds for homebrew and macports

Create Release Plan issue and milestone for next release on github

Announce new release

Clone this wiki locally