Changes between Version 12 and Version 13 of DevNotes/Processeses/DeploymentProcess

Timestamp:

Jul 24, 2016 10:39:14 PM (8 years ago)

Author:

butler

Comment:

—

DevNotes/Processeses/DeploymentProcess

@@ -4 +4 @@
 == Reminders ==
 - The !SasView builds can be found here: [https://jenkins.esss.dk/sasview/view/Master-Builds/]. Note we are not releasing Unix versions at this time despite the Ubuntu build machine.
-- The released software is available for download on [https://github.com/SasView/sasview/releases GitHub].
+- The released software is available for download on [https://github.com/SasView/sasview/releases !GitHub].
 
 == Planning a new major release ==
@@ -10 +10 @@
 - Once the developers are completely done with their changes and have tested their own code, they should close their ticket and announce it to the rest of the team.
 - Once all developers are done with their work, the release will be discussed at the following conference call.
-- During that call, a "'''release manager'''" will be appointed for that release. That person is responsible for following the release process below and communicating progress to the team.  The release manager will need to have release priviledges on the repository.
+- During that call, a "'''release manager'''" will be appointed for that release. That person is responsible for following the release process below and communicating progress to the team.  The release manager will need to have release privileges on the repository.
 - After a release manager has been appointed, a code freeze is declared.
 
@@ -16 +16 @@
 - After the code freeze, developers and chosen users will test the release candidate.
 - All bugs and issues identified will be ticketed and either fixed or discussed on the conference call to ascertain if they must be fixed (blockers) or can remain known issues to be reported in release notes and fixed in a future release.
-- Once everyone agrees that the release candidate is ready, the release manager will start the actual release process.
+- Once everyone agrees that the release candidate is ready, the release manager will start the final release process.
 
-== Preparing a new major release ==
-manager announces the process is complete
-- The release manager will make sure that the version number is correctly placed in all the appropriate places.  That currently includes:
+== Penultimate release steps performed by the release manager ==
+- Make sure that the version number is correctly placed in all the appropriate places.  That currently includes:
  - sasview/_init_.py
  - sasview/README.txt
  - docs/sphinx-docs/source/conf.py (change both version and release numbers)
  - sasview.latestversion has now been superseded by the json file stored at the sasview site.
-- The release manager will then announce to the team the beginning of the release process. Developers should not push anything to the !GitHub repository until the release 
-- The release manager will download the mac and windows builds from the build site.
-- The release manager will then tag the current repo for release and execute the release process as described at [https://help.github.com/articles/creating-releases/]. Note that the mac and windows builds will need to be renamed appropriately and uploaded as binaries along. Current naming convention is:
- - Windows: !SasView-V.v.v.exe
+- Using instructions published at !GitHub [https://help.github.com/articles/creating-releases/] 
+ - If necessary tag appropriate sasmodels commit point to be used with this release of !SasView if not using HEAD.
+ - Tag the appropriate !SasView commit point for the release if not using HEAD.
+ - Note: if decision is made to make a release from an old enough commit point that it is not available on the !GitHub interface the tag can be generated using the local git interface
+- Log into the Jenkins server, navigate to the releases tab and for each platform use "configure" to edit the configuration to use the appropriate sasmodels and !SasView tags for the build. 
+- Next, manually launch the Jenkins build processes for each platform being supported. 
+- Download the mac and windows builds from the Jenkins build tab and upload the binaries to the releases page. Note that the mac and windows builds will need to be renamed appropriately. Current naming convention is:
+ - Windows: setupSasView-V.v.v.exe
  - mac: !SasView-V.v.v-MacOSX.dmg
+- An abbreviated version of the  release notes in the README.txt should be entered in the Release Description section.
 - The documentation folder contents needs to be moved to the sasview.github.io repo under docs (commit and push). Currently the release manager can either build the docs locally, but for consistency with the release docs it is strongly recommended that instead they install the release version and copy the docs from the install path. 
-- An abbreviated version of the  release notes in the README.txt should be entered in the Release Description section.
+
+== Final release steps ==
 - The release manager will email the team to announce the release process is complete.
-- The team will download the new release to make sure it installs.
+- The team should download the new release to make sure it installs.
 - Once final approval is given, the release number will be updated in latestversion.json on the !SasView website repo which will alert all !SasView users that a new version is available.
 
 == Patch releases ==
 - Currently patch releases follow the same process as major releases but the cycle is usually much abbreviated.
+
+== Pre releases (alpha and beta releases) ==
+- Pre-releases follow a much less formal acceptance process but otherwise follows the same technical process - make sure to click "This is a pre-release" check box when drafting a new release on !GitHub.
+