Skip to content

Latest commit

 

History

History
71 lines (53 loc) · 2.1 KB

RELEASE.md

File metadata and controls

71 lines (53 loc) · 2.1 KB
Raw

How to make a release

traefik-proxy is a package available on PyPI. The PyPI release is done automatically by TravisCI when a tag is pushed.

For you to follow along according to these instructions, you need to have push rights to the traefik-proxy GitHub repository.

Steps to make a release

  1. Checkout master and make sure it is up to date.

    ORIGIN=${ORIGIN:-origin} # set to the canonical remote, e.g. 'upstream' if 'origin' is not the official repo
git checkout master
git fetch $ORIGIN master
git reset --hard $ORIGIN/master
# WARNING! This next command deletes any untracked files in the repo
git clean -xfd

  2. Update changelog.rst and add it to the working tree.

    git add traefik-proxy/docs/source/changelog.rst

    Tip: Identifying the changes can be made easier with the help of the choldgraf/github-activity utility.

  3. Set a shell variable to be the new version you want to release. The actual project version will be detected automatically by versioneer from git tags inspection. The versioneer script will be run by setup.py when packaging is occurring.

    VERSION=...  # e.g. 1.2.3
git commit -m "release $VERSION"

    Tip: You can get the current project version by checking the latest tag on GitHub.

  4. Push your commit to master.

    # first push commits without a tags to ensure the
# commits comes through, because a tag can otherwise
# be pushed all alone without company of rejected
# commits, and we want have our tagged release coupled
# with a specific commit in master
git push $ORIGIN master

  5. Create a git tag for the pushed release commit and push it.

    git tag -a $VERSION -m "release $VERSION"

# then verify you tagged the right commit
git log

# then push it
git push $ORIGIN --follow-tags