Project

General

Profile

Release checklist » History » Version 4

Mark Abraham, 06/12/2018 04:10 PM

1 1 Mark Abraham
h1. Release checklist
2 1 Mark Abraham
3 2 Mark Abraham
* add new redmine version targets
4 2 Mark Abraham
* bump bugs that won't get fixed in time to next version (or untag a version number)
5 2 Mark Abraham
* merge in appropriate branches from earlier releases
6 2 Mark Abraham
* announce release schedule - give devs a week or two to fix things they intended to fix, provide links to gerrit and redmine pages for that branch/version
7 3 Mark Abraham
* bump shared object minor version for point releases
8 3 Mark Abraham
* consider bumping shared object major version for point releases - see cmake/gmxVersionInfo.cmake for policy
9 2 Mark Abraham
* check for new GROMACS papers that should be mentioned in source and manual
10 3 Mark Abraham
* run release workflow a few days in advance to check things work - this also builds the tarball correctly, when the RELEASE checkbox is ticked, which we need for updating the REGRESSIONTEST_MD5SUM in cmake/gmxVersionInfo.cmake - TODO automate this along the lines of the regressiontests auto-builder
11 1 Mark Abraham
* Mark get that script out: upload source tarball to FTP site, give correct permissions, check link works.
12 4 Mark Abraham
13 4 Mark Abraham
<pre>
14 4 Mark Abraham
download="wget -N"
15 4 Mark Abraham
16 4 Mark Abraham
# Get the various tarballs
17 4 Mark Abraham
$download "http://jenkins.gromacs.org/job/Release_workflow_master/Website/*zip*/Website.zip"
18 4 Mark Abraham
cp Website.zip ${website_tarball}
19 4 Mark Abraham
$download http://jenkins.gromacs.org/job/Regressiontests_package_master/lastSuccessfulBuild/artifact/regressiontests/$regressiontests_tarball
20 4 Mark Abraham
$download http://jenkins.gromacs.org/job/Source_package_master/lastSuccessfulBuild/artifact/build/$source_tarball
21 4 Mark Abraham
</pre>
22 4 Mark Abraham
23 4 Mark Abraham
<pre>
24 4 Mark Abraham
upload="rsync -avP --chmod=u+rw,g+rw,o+r"
25 4 Mark Abraham
destination=mark@ftp.gromacs.org:/srv/ftp
26 4 Mark Abraham
$upload $source_tarball $destination/gromacs/
27 4 Mark Abraham
$upload manual-${version}.pdf $destination/manual/
28 4 Mark Abraham
$upload $regressiontests_tarball $destination/regressiontests/
29 4 Mark Abraham
30 4 Mark Abraham
md5sum $source_tarball
31 4 Mark Abraham
md5sum $regressiontests_tarball
32 4 Mark Abraham
</pre>
33 4 Mark Abraham
34 4 Mark Abraham
<pre>
35 4 Mark Abraham
upload="rsync -avP --chmod=u+rwX,g+rwX,o+rX"
36 4 Mark Abraham
deploymentlocation=mark@www.gromacs.org:/var/www/documentation
37 4 Mark Abraham
#mkdir -p $deploymentlocation/$version
38 4 Mark Abraham
39 4 Mark Abraham
# Unpack the website tarball
40 4 Mark Abraham
(
41 4 Mark Abraham
    #    cd $deploymentlocation;
42 4 Mark Abraham
    cd /tmp
43 4 Mark Abraham
    unzip -u $originalpwd/${website_tarball} >& /dev/null
44 4 Mark Abraham
    $upload Website/* Website/.[a-z]* $deploymentlocation/${version}/
45 4 Mark Abraham
    cp Website/manual*pdf $originalpwd
46 4 Mark Abraham
    #rm -rf Website
47 4 Mark Abraham
)
48 4 Mark Abraham
49 4 Mark Abraham
</pre>
50 4 Mark Abraham
51 1 Mark Abraham
* update News on front of GROMACS web page - http://www.gromacs.org/
52 3 Mark Abraham
* TODO make notes of what goes into this commit and the one that follows the tagged commit - tag the commit from which the tarball was made, and do explicit upload to gerrit.gromacs.org repo, also update REGRESSIONTEST_BRANCH if needed (major release), sometimes bump GMX_VERSION_* variables
53 3 Mark Abraham
* once the gerrit change is submitted and the release email sent, make tag of the correct form in local repo
54 3 Mark Abraham
* bump version in cmake/gmxVersionInfo.cmake in the commit following the tag.
55 3 Mark Abraham
* add new stub file for release notes for next version, and entry in index.rst
56 3 Mark Abraham
* git push --tags to gerrit repo
57 3 Mark Abraham
* later, check tags propagate to gromacs and github
58 2 Mark Abraham
* post on gmx-users and gmx-announce.
59 2 Mark Abraham
* post on Google+ and Facebook pages
60 3 Mark Abraham
* thank gmx-developers
61 2 Mark Abraham
* bump/close/update open redmine issues
62 2 Mark Abraham
* close completed redmine versions
63 2 Mark Abraham
* beer
64 2 Mark Abraham
65 2 Mark Abraham
66 2 Mark Abraham
TODO some recent examples of post-release emails