Release/Procedure

Version 34 (modified by erilem, 3 years ago)

--

OpenLayers Release Procedure

Work In Progress

Let us say that for the release in question, x is the API Version and y the incremental release number.

  1. Push all remaining open tickets out of the current release's milestone. A Release procedure must be started with all the milestone's tickets closed.
    • Trac tickets
    • GitHub issues
  2. A vote must be passed by the SteeringCommittee to start a new release procedure.
  3. Create a new branch
      $ git clone git@github.com/openlayers/openlayers
      $ git checkout -b x.y
      $ git push origin x.y
    
    This is a temporary branch, which will be deleted after the final release.
  4. Make queries to see lists of tickets that were closed for this release's milestone. E.g.
     http://trac.openlayers.org/query?milestone=2.12+Release&resolution=fixed&order=component
    
     https://github.com/openlayers/openlayers/issues?sort=created&direction=desc&state=closed&page=1&milestone=1
    
  5. Based on the list from the previous step, create a new ReleaseNotes wiki for the new release. The wiki should be named Release/x.y/Notes.
    For a good example, see Release/2.2/Notes

  6. Release Candidate (RC) Cycle
    Let us say that for the RC in question, Z is the incremental release candidate number (starting with 1)

    1. Compile a Release Announcement. The announcement should be located at Release/x.y/Announce/RCZ and should include one of the following:
      • If this is the first RC (Z is 1): A link to the Release/x.y/Notes wiki, and a brief summary of its contents.
      • If this is not the first RC, then: A brief summary of all of the tickets that were fixed in the last RC.
        This should be a summary of the following trac query (where we let W be the previous RC number, i.e. Z-1):
        http://trac.openlayers.org/query?status=closed&version=x.y+RCW&milestone=x.y+Release&resolution=fixed&order=priority
        
    2. Set VERSION_NUMBER in  http://svn.openlayers.org/branches/openlayers/x.y/lib/OpenLayers.js and  http://svn.openlayers.org/branches/openlayers/x.y/lib/OpenLayers/SingleFile.js to "Release x.y-rcZ" and commit the change.
    3. Tag the release:
        svn copy -m "Tagging the x.y rcZ Release" http://svn.openlayers.org/branches/openlayers/x.y http://svn.openlayers.org/tags/openlayers/release-x.y-rcZ
      
  7. Export and Build the single file version:
      svn export http://svn.openlayers.org/tags/openlayers/release-x.y-rcZ OpenLayers-x.y-rcZ
      cd OpenLayers-x.y-rcZ/build
      ./build.py full
    
    1. Create a new API release directory on openlayers.org and install the build
        mkdir /www/openlayers/docs/api/x.y-rcZ
        cd ..
        cp build/OpenLayers.js /www/openlayers/docs/api/x.y-rcZ
        cp -a img/ /www/openlayers/docs/api/x.y-rcZ
        cp -a theme/ /www/openlayers/docs/api/x.y-rcZ
      
    2. Build the tarball and copy it up to openlayers.org
        # First remove all .pyc files from the directory.
        rm tools/*.pyc
        cd ..
        tar cvfz OpenLayers-x.y-rcZ.tar.gz OpenLayers-x.y-rcZ/
        cp OpenLayers-x.y-rcZ.tar.gz /www/openlayers/docs/download
      
    3. Build a zip archive to openlayers.org
        zip -9r OpenLayers-x.y-rcZ.zip OpenLayers-x.y-rcZ/
        cp OpenLayers-x.y-rcZ.zip /www/openlayers/docs/download
      
    4. Create a new Version entry in TRAC called "x.y RCZ" for bug tracking

    5. Email the Release Announcement to the dev list.

    6. Testing Cycle -- in which users and developers:
      • Report new tickets
        1. Milestone: x.y Release
        2. Version: x.y RCZ
      • Fix outstanding tickets:
        1. Commit only to trunk
        2. Set 'State' to 'Pullup' as they still need to be pulled up to the branch
        3. Do not mark as closed (i.e. leave them open)
      • Run all tests in both Firefox 1.5 and IE 6.
        • If any tests fail, return to Testing Cycle and report a new ticket.
        • If all tests pass, a committer may send a proposal email to the dev list calling for:
          • A new RC:
            1. The support of at least one other committer must be obtained.
            2. The committer chooses which patches to include in the the new RC or Final Release.
              These should be taken from the the results of the following trac query:
              http://trac.openlayers.org/query?milestone=x.y+Release&keywords=%7Epullup&order=priority
              
              1. Bring up each ticket's patch from trunk into the branch
              2. Change each ticket's 'State' field to 'Complete'
              3. Add brief summary of the change to the Release/x.y/Notes wiki
              4. Mark ticket closed
            3. Committer exits Testing Cycle, starts new Release Candidate Cycle
          • The Final Release:
            1. All tickets for the milestone must be closed in the previous RC and no new tickets opened in the current one.
            2. A successful voting round must pass the SteeringCommittee.
            3. SteeringCommittee member exits the Testing Cycle and Release Candidate Cycle and proceeds to the next step, Review the Release/x.y/Notes wiki...

  1. Review the Release/x.y/Notes wiki and make sure it contains important info from all the closed tickets for the Release x.y milestone:
    http://trac.openlayers.org/query?group=component&milestone=x.y+Release&resolution=fixed&order=priority
    
  2. Update news.txt: both in trunk and in the branch, update the /news.txt file to reflect this release. Note that you must be both tricky and quick here, as you must *predict* the correct revision number for the actual tagging of the release, which you will do in the next step. Essentially, this is current release +2 (one for the check-in of news.txt, one for the tag). It seems absurd, but it is good to make sure that no one else is checking in at the same time as this maneuver assumes a quiet wire.
    1. Set VERSION_NUMBER in  http://svn.openlayers.org/branches/openlayers/x.y/lib/OpenLayers.js and  http://svn.openlayers.org/branches/openlayers/x.y/lib/OpenLayers/SingleFile.js to "Release x.y-rcZ" and commit the change.
  3. Tag the release:
      export VERSION=2.7
      svn copy -m "Tagging the Final x.y Release" http://svn.openlayers.org/branches/openlayers/$VERSION http://svn.openlayers.org/tags/openlayers/release-$VERSION
    
  1. Export and Build the single file version:
      svn export http://svn.openlayers.org/tags/openlayers/release-$VERSION OpenLayers-$VERSION
      cd OpenLayers-$VERSION/build
      ./build.py
    
  2. Create a new API release directory on openlayers.org and install the build
      mkdir /www/openlayers/docs/api/$VERSION
      cd ..
      cp build/OpenLayers.js /www/openlayers/docs/api/$VERSION
      cp -a img/ /www/openlayers/docs/api/$VERSION
      cp -a theme/ /www/openlayers/docs/api/$VERSION
    
  3. Build the tarball and copy it up to openlayers.org
      # First remove all .pyc files from the directory.
      rm tools/*.pyc
      # move single file version
      cp build/OpenLayers.js OpenLayers.js
      rm build/OpenLayers.js
      
      cd ..
      mkdir OpenLayers-$VERSION/doc/devdocs
      perl ~crschmidt/NaturalDocs -i OpenLayers-$VERSION/lib -o HTML OpenLayers-$VERSION/doc/devdocs -p OpenLayers-$VERSION/doc_config -s Default OL
      mkdir OpenLayers-$VERSION/doc/apidocs
      perl ~crschmidt/NaturalDocs -i OpenLayers-$VERSION/lib -o HTML OpenLayers-$VERSION/doc/apidocs -p OpenLayers-$VERSION/apidoc_config -s Default OL
    
      tar cvfz OpenLayers-$VERSION.tar.gz OpenLayers-$VERSION/
      cp OpenLayers-$VERSION.tar.gz /www/openlayers/docs/download
    
  4. Build a zip archive to openlayers.org
      zip -9r OpenLayers-$VERSION.zip OpenLayers-$VERSION/
      cp OpenLayers-$VERSION.zip /www/openlayers/docs/download
    
  5. Install the new API code on openlayers.org
      export X=2
      ln -sf /www/openlayers/docs/api/$VERSION/OpenLayers.js /www/openlayers/docs/api
      ln -sf /www/openlayers/docs/api/$VERSION/img /www/openlayers/docs/api
      ln -sf /www/openlayers/docs/api/$VERSION/theme /www/openlayers/docs/api
      rm /www/openlayers/docs/api/$VERSION && ln -sf /www/openlayers/docs/api/$VERSION /www/openlayers/docs/api/$X
    
  6. Create a new Version entry in TRAC called "x.y" for bug tracking.

  7. Update HowToDownload wiki with new latest stable api release links.

  8. Email the dev and users lists and announce the release containing:
    • A link to the Release/x.y/Notes wiki
    • A summary of the major features and bug fixes for the release
  9. Write a 50 word summary of the release and send to news_item at osgeo dot org