Mirroristas/bigchaindb
2
0
Fork 0
mirror of https://github.com/bigchaindb/bigchaindb.git synced 2024-10-13 13:34:05 +00:00
Code Issues Packages Projects Releases Wiki Activity
bigchaindb/Release_Process.md
Troy McConaghy 232ddc00a0 Two changes to Release_Process.md 
1. Merge the new version's branch into the master branch
2. Added a helper line about how to use twine to upload to PyPI
2017-02-06 19:54:53 +01:00

2.9 KiB
Raw Permalink Blame History

Our Release Process

The release process for BigchainDB server differs slightly depending on whether it's a minor or a patch release.

BigchainDB follows semantic versioning (i.e. MAJOR.MINOR.PATCH), taking into account that major version 0.x does not export a stable API.

Minor release

A minor release is preceeded by a feature freeze and created from the 'master' branch. This is a summary of the steps we go through to release a new minor version of BigchainDB Server.

  1. Update the CHANGELOG.md file in master
  2. Create and checkout a new branch for the release, named after the minor version, without a preceeding 'v', e.g. git checkout -b 0.9.4
  3. In bigchaindb/version.py, update __version__ and __short_version__, e.g. to 0.9 and 0.9.0 (with no .dev on the end)
  4. Commit changes, push new branch to Github, and merge it into master
  5. Follow steps outlined in Common Steps
  6. In 'master' branch, Edit bigchaindb/version.py, increment the minor version to the next planned release, e.g. `0.10.0.dev'. This is so people reading the latest docs will know that they're for the latest (master branch) version of BigchainDB Server, not the docs at the time of the most recent release (which are also available).

Congratulations, you have released BigchainDB!

Patch release

A patch release is similar to a minor release, but piggybacks on an existing minor release branch:

  1. Check out the minor release branch
  2. Apply the changes you want, ie using git cherry-pick.
  3. Update the CHANGELOG.md file
  4. Increment the patch version in bigchaindb/version.py, e.g. "0.9.1"
  5. Follow steps outlined in Common Steps

Common steps

These steps are common between minor and patch releases:

  1. Go to the bigchaindb/bigchaindb Releases page on GitHub and click the "Draft a new release" button
  2. Fill in the details:
    • Tag version: version number preceeded by 'v', e.g. "v0.9.1"
    • Target: the release branch that was just pushed
    • Title: Same as tag name
    • Description: The body of the changelog entry (Added, Changed etc)
  3. Publish the release on Github
  4. Generate the release tarball with python setup.py sdist. Upload the release to PyPI, e.g. twine upload dist/BigchainDB-0.9.0.tar.gz (requires you to have a ~/.pypirc file)
  5. Login to readthedocs.org as a maintainer of the BigchainDB Server docs. Go to Admin --> Versions and under Choose Active Versions, make sure that the new version's tag is "Active" and "Public", and make sure the new version's branch (without the 'v' in front) is not active
  6. Also in readthedocs.org, go to Admin --> Advanced Settings and make sure that "Default branch:" (i.e. what "latest" points to) is set to the new release's tag, e.g. v0.9.1. (Don't miss the 'v' in front.)