Skip to content

releases.rst

Latest commit

 

History

History
96 lines (87 loc) · 4.49 KB

releases.rst

File metadata and controls

96 lines (87 loc) · 4.49 KB
title:Releases
description:The Deis software release process.

Release Checklist

These instructions are to assist the Deis maintainers with creating a new Deis product release.

Grace Hopper and UNIVAC, from the Wikimedia Commons

Please keep this document up-to-date with any changes in this process.

github.com/deis/deis Repo

  • Create the next deis milestone
  • Move any deis open issues from the current release to the next milestone
  • Close the current deis milestone
  • Recreate CHANGELOG.md in the root of the project using the changelog script
    • ./contrib/util/generate-changelog.sh vU.V.W vX.Y.Z | cat - CHANGELOG.md > tmp && mv tmp CHANGELOG.md substituting the previous release for vU.V.W and the current one for vX.Y.Z.
    • proofread the new CHANGELOG.md to ensure it was generated correctly
    • git add CHANGELOG.md && git commit -m "Updated CHANGELOG.md."
  • Merge git master into release branch locally
    • git checkout release && git merge master
  • Edit contrib/coreos/user-data and update DEIS_RELEASE to ":vX.Y.Z"
  • At the Docker Index, create a tagged image build ":vX.Y.Z" for every component
  • Commit and push the deis/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
  • Create CLI binaries for Windows, Mac OS X, Debian
    • pip install pyinstaller && make -C controller client
    • build deis-osx-X.Y.Z.tgz on Mac OS X 10.8 for all Macs (10.9 uses LLVM, which makes our binary crash on earlier OS versions)
    • build deis-win32-X.Y.Z.zip on Windows 7 32-bit
    • build deis-deb-wheezy-X.Y.Z.tgz on Debian Wheezy (see deis/deis#504)
    • upload all binaries to the aws-eng S3 bucket and set each as publically downloadable
  • Switch master to upcoming release
    • git checkout master
    • update __version__ fields in Python packages to next version
    • git commit -a -m 'Switch master to vA.B.C.' (next version)
    • git push origin master

Documentation

  • (CHANGELOG.md files were regenerated and committed above.)
  • Docs are automatically published to http://docs.deis.io (the preferred alias for deis.readthedocs.org)
  • Log in to the http://deis.readthedocs.org admin
    • add the current release to the list of published builds
    • remove the oldest release from the list of published builds
    • rebuild all published versions so their "Versions" index links are updated
  • Publish docs to pythonhosted.org/deis
    • from the project root, run make -C docs clean zipfile
    • the zipfile will be at docs/docs.zip
    • log in to http://pypi.python.org/ and use the web form at the Deis Pypi page to upload the zipfile
  • Check documentation for deis/* projects at the Docker Index
    • click "Settings" for each project (deis/controller, deis/cache, etc.)
    • paste the contents of each README.md into the "long description" field if there are discrepencies. (These don't automatically sync up after the Trusted Build is first created.)
  • Create release notes docs
    • follow the format of previous release notes
    • summarize all work done since the previous release
    • visit all opdemand/* and deis/* project issues to make sure we don't miss any contributors for the "Community Shout-Outs" section
    • include "what's next" and "future directions" sections
    • add Markdown version of release notes to deis/deis.io website project