Changes between Initial Version and Version 1 of ReleaseProcedure


Ignore:
Timestamp:
Sep 14, 2014, 2:05:41 AM (10 years ago)
Author:
djay
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ReleaseProcedure

    v1 v1  
     1ZOO-Project Release Procedure
     2
     3
     4 * If not already created, create /releases/M.m.r.txt, summarizing changes from the previous release, review the revision log.
     5 * That file should include new features, changed features, and depreciated features. Changes to the mapbook should be specifically noted along with other items that will cause breaking changes during upgrades. A MapServer and MS4W version (and implicitly PHP, etc) recommendation should be included too.
     6 * Update VERSIONS.rst to explicitly define the versions of PHP and MapServer used during development. Recommendations on Apache and MS4W versions should also be present.
     7 * Read the documentation and remove outdated parts.
     8 * Update FAQ (remove no longer relevant questions, add new questions).
     9 * Create beta and release candidate .zip and .tar.gz (transfer to webmasters – Jim/Dan )
     10 * Release betas and get feedback until there is no feedback about directly relevant items.
     11 * Cut a release candidate once you think that everything is in order. Announce the release candidate for review for at least 2 weeks. In this period of time, it is also appropriate for you to deploy in production since you are asserting that it is stable and (significant) bug free. Publish a specific revision with this.
     12 * If significant bugs are reported, fix and cut a new release candidate. If no major bugs, then announce that the release candidate has officially been promoted to the official release (if you want, you can do this with a motion and support of the PSC).
     13 * Ensure that release exactly matches something in SVN. Tag and branch appropriately.
     14 * Update documentation as needed keeping in mind that the versioned documentation on the website pulls from different SVN branches.
     15 * Update downloads.rst with new links
     16 * Update the news in index.rst (link to /releases/M.m.r.txt), move some of the existing stuff to previous Older News if needed
     17 * Open an OSGeo SAC Trac ticket to update downloads (unless we just have a redirect there to our website)
     18 * Put the word out on email list and other locations (news_item@osgeo.org, SlashGeo?, etc)
     19
     20Creating an Official Release
     21
     22Official releases differ from Betas. Beta testers are advised to download nightly builds and test against them. Release versions lead to an update in documentation and standard tarballs. This is to help future administrators repeatably create releases.
     23
     24 * Double check that geomoose.html and geomoose_dev.html match the current version. (Title and footer).
     25
     26 * Double check that the latest build file matches the current revisions number.
     27
     28{{{
     29    cd htdocs/libs/dojo*/util/buildscripts
     30    ./build_geomoose2.sh
     31}}}
     32
     33 * Create a commit point for the code.
     34
     35{{{
     36    # cd to the trunk directory.
     37    svn commit -m 'Updated build to ensure completeness before 2.X.Y release.'
     38}}}
     39
     40 * If this is a new major release create a branch and a tag. (e.g. 2.6, 2.8)
     41
     42{{{
     43    cd geomoose2/
     44    svn cp trunk branches/geomoose-2.6
     45    svn cp trunk tags/geomoose-2.6.0
     46}}}
     47
     48 * If this is a major or minor relase, create a tag.
     49
     50{{{
     51    svn cp branches/geomoose-2.6 tags/geomoose-2.6.1
     52}}}
     53
     54 * Commit the tags or branches with the version numbers.
     55
     56{{{
     57    svn commit -m 'Created branch/tags for the 2.X.Y release'
     58}}}
     59
     60 * Login to the webserver and ...
     61
     62{{{
     63    # get the latest changes from svn
     64    cd /srv/svn
     65    svn up
     66}}}
     67
     68{{{
     69    # tag a version
     70    cd /srv/geomoose
     71    # update the nightly builds to the latest revision, from which we'll make a
     72    # version.  This doesn't work for branched versions.
     73    ./update_nightly_builds.sh
     74
     75    # now take the nightly and call it a version number
     76    ./tag_nightly.sh 2.6.0
     77
     78    # Now let's build the docs.
     79    cd /srv/svn/geomoose2/tags/geomoose-2.6.0/sphinx-docs
     80    make html
     81
     82    # And now for the API.
     83    cd /srv/svn/geomoose2/tags/geomoose-2.6.0/
     84    mkdir apidocs
     85    /srv/geomoose/naturaldocs/naturaldocs -i htdocs/geomoose -o html ./apidocs -p ./ntdocs
     86}}}
     87
     88 * Phew, that was fun. Next we need to add a line to /srv/geomoose/httpd.confd/geomoose_2.6.0.conf
     89
     90{{{
     91    Alias /2.6.0/api /srv/svn/geomoose2/tags/geomoose-2.6.0/apidocs/
     92    Alias /2.6.0 /srv/svn/geomoose2/tags/geomoose-2.6.0/sphinx-docs/build/html/
     93
     94    <Location /2.6.0/>
     95            Allow from all
     96            Order allow,deny
     97            Options Indexes FollowSymLinks
     98    </Location>
     99}}}
     100
     101 * Now we’ll point “Current” at the branch so that we can update docs without making an absolute release.
     102
     103{{{
     104    rm /srv/geomoose/current
     105    ln -s /srv/svn/geomoose2/branches/geomoose-2.6 /srv/geomoose/current
     106}}}
     107
     108 * And restart the web server. The release should now be happening.

Search

Context Navigation

ZOO Sponsors

http://www.zoo-project.org/trac/chrome/site/img/geolabs-logo.pnghttp://www.zoo-project.org/trac/chrome/site/img/neogeo-logo.png http://www.zoo-project.org/trac/chrome/site/img/apptech-logo.png http://www.zoo-project.org/trac/chrome/site/img/3liz-logo.png http://www.zoo-project.org/trac/chrome/site/img/gateway-logo.png

Become a sponsor !

Knowledge partners

http://www.zoo-project.org/trac/chrome/site/img/ocu-logo.png http://www.zoo-project.org/trac/chrome/site/img/gucas-logo.png http://www.zoo-project.org/trac/chrome/site/img/polimi-logo.png http://www.zoo-project.org/trac/chrome/site/img/fem-logo.png http://www.zoo-project.org/trac/chrome/site/img/supsi-logo.png http://www.zoo-project.org/trac/chrome/site/img/cumtb-logo.png

Become a knowledge partner

Related links

http://zoo-project.org/img/ogclogo.png http://zoo-project.org/img/osgeologo.png