Skip to content

releases.rst

Latest commit

 

History

History
97 lines (79 loc) · 3.13 KB

releases.rst

File metadata and controls

97 lines (79 loc) · 3.13 KB
title:Releases
description:Details the Deis release process. Deis releases.
keywords:deis, release, process, build, tag

Releases

When the maintainers create a new Deis release, here are the steps involved:

GitHub Issues

  • create next milestone
  • roll unfinished issues (if there are any) into next milestone
  • close current release milestone

Other Repos

  • tag the opdemand/buildstep repo
  • tag the opdemand/gitosis repo

Chef Repo

  • merge master into release branch locally
    • git checkout release
    • git merge master
  • change chef attributes to latest tags in deis-cookbook/attributes
    • default.deis.build.revision
    • default.deis.gitosis.revision
    • default.deis.controller.revision
  • knife cookbook metadata . to update metadata.json
  • commit and push the opdemand/deis-cookbook release and tag
    • git commit -a -m 'updated for vX.Y.Z release'
    • git push origin release
    • git tag vX.Y.Z
    • git push --tags origin vX.Y.Z
  • update opscode community cookbook
    • cd to parent dir of deis-cookbook
    • cp -pr deis-cookbook /tmp/deis && cd /tmp
    • tar cvfz deis-cookbook-vX.Y.Z.tar.gz --exclude='deis/.*' deis
    • log in to community.opscode.com and upload tarball
  • switch master to upcoming release
    • git checkout master
    • change cookbook revisions in metadata.rb to next version
    • git commit -a -m 'switch master to vX.Y.Z+1'
    • git push origin master

Deis Repo

  • merge master into release branch locally
    • git checkout release
    • git merge master
  • update berksfile with new release
    • ensure Berksfile is pointing to opscode community cookbook
    • berks update && berks install to update Berksfile.lock
  • commit and push the opdemand/deis release and tag
    • git commit -a -m 'updated for vX.Y.Z release'
    • git push origin release
    • git tag vX.Y.Z
    • git push --tags origin vX.Y.Z
  • publish CLI to pypi.python.org
    • cd client && python setup.py sdist upload
    • use testpypi.python.org first to ensure there aren't any problems
  • switch master to upcoming release
    • git checkout master
    • update __version__ fields in Python packages to next version
    • switch from opscode community cookbook back to github cookbook
    • berks update && berks install to update Berksfile.lock
    • git commit -a -m 'switch master to vX.Y.Z+1'
    • git push origin master

Docs

  • create release notes docs
    • follow format of previous release notes
    • summarize all work done
    • what's next and future directions
  • publish docs to http://docs.deis.io (deis.readthedocs.org)
  • visit readthedocs.org admin and add this release to published builds
  • publish docs to pythonhosted.org/deis