You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airavata.apache.org by bu...@apache.org on 2012/10/28 05:24:08 UTC
svn commit: r836376 - in /websites/staging/airavata/trunk/content: ./
development/release-discuss.txt development/release-management.html
development/release-vote.txt
Author: buildbot
Date: Sun Oct 28 04:24:08 2012
New Revision: 836376
Log:
Staging update by buildbot for airavata
Added:
websites/staging/airavata/trunk/content/development/release-discuss.txt
websites/staging/airavata/trunk/content/development/release-vote.txt
Modified:
websites/staging/airavata/trunk/content/ (props changed)
websites/staging/airavata/trunk/content/development/release-management.html
Propchange: websites/staging/airavata/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sun Oct 28 04:24:08 2012
@@ -1 +1 @@
-1401285
+1402927
Added: websites/staging/airavata/trunk/content/development/release-discuss.txt
==============================================================================
--- websites/staging/airavata/trunk/content/development/release-discuss.txt (added)
+++ websites/staging/airavata/trunk/content/development/release-discuss.txt Sun Oct 28 04:24:08 2012
@@ -0,0 +1,20 @@
+To: dev@airavata.apache.org
+Subject: [DISCUSS] Apache Airavata ${version} RC{number}
+
+Discussion thread for vote on Apache Airavata ${version} release candidate.
+
+If you have any questions or feedback or to post results of validating the release, please reply to this thread. Once you verify the release, please post your vote to the VOTE thread.
+
+For reference, the Apache release guide - http://www.apache.org/dev/release.html
+
+Some tips to validate the release before you vote:
+
+* Download the binary version and run the 5 minute or 10 minute tutorial as described in README and website.
+* Download the source files from compressed files and release tag and build (which includes tests).
+* Verify the distribution for the required LICENSE and NOTICE files
+* Verify if all the staged files are signed and the signature is verifiable.
+* Verify if the signing key in the project's KEYS file is hosted on a public server
+
+Thanks for your time in validating the release and voting,
+{Release Manger}
+(On Behalf of Airavata PMC)
\ No newline at end of file
Modified: websites/staging/airavata/trunk/content/development/release-management.html
==============================================================================
--- websites/staging/airavata/trunk/content/development/release-management.html (original)
+++ websites/staging/airavata/trunk/content/development/release-management.html Sun Oct 28 04:24:08 2012
@@ -117,9 +117,9 @@ The popular software used Open Pretty Go
<li>Airavata requires Maven 3 or later to build and release</li>
<li>It is encouraged to use maven's password encryption capabilities and set the gpg password in
~/.m2/settings.xml. Detailed instructions are at <a href="http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env">Publishing Maven Artifacts</a></li>
-<li>Performing release will require maven to run series of commands, the heapsize has to be increased
-to avoid out of memory exceptions. For bash shell: <code>export MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=256m"</code>.
-For c shell: <code>setenv MAVEN_OPTS "-Xmx1024m -XX:MaxPermSize=256m"</code>.</li>
+<li>Performing release will require maven to run series of commands, the heapsize has to be increased to avoid out of memory exceptions.</li>
+<li>Bash Shell: <code>export MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=256m"</code>. </li>
+<li>C Shell: <code>setenv MAVEN_OPTS "-Xmx1024m -XX:MaxPermSize=256m"</code>.</li>
</ul>
<p><a name="release-process"></a></p>
<h4 id="release-process">Release Process</h4>
@@ -143,13 +143,24 @@ For c shell: <code>setenv MAVEN_OPTS "-X
<li>
<p>Checkout a clean copy of the trunk to release using command line svn.
<em>Do not use Eclipse to do the checkout. The extra dot (.) files created by Eclipse throws off the rat:check processing.</em></p>
+<div class="codehilite"><pre><span class="sb">`svn co https://svn.apache.org/repos/asf/airavata/trunk airavata-trunk`</span>
+</pre></div>
+
+
</li>
<li>
-<p>Verify the source has the required license headers before trying to release: <code>mvn -P pedantic verify -DskipTests</code></p>
+<p>Verify the source has the required license headers before trying to release: </p>
+<div class="codehilite"><pre><span class="sb">`mvn -P pedantic verify -DskipTests=true`</span>
+</pre></div>
+
+
</li>
<li>
-<p>Do a dry run of the release:prepare step:
- <code>mvn -P apache-release release:prepare -DautoVersionSubmodules=true -DdryRun=true</code></p>
+<p>Do a dry run of the release:prepare step:</p>
+<div class="codehilite"><pre><span class="sb">`mvn -P apache-release release:prepare -DautoVersionSubmodules=true -DdryRun=true`</span>
+</pre></div>
+
+
<p>The dry run will not commit any changes back to SVN and gives you the opportunity to verify that the release process will complete as expected. You will be prompted for the following information :</p>
<ul>
<li>Release version</li>
@@ -171,26 +182,33 @@ For c shell: <code>setenv MAVEN_OPTS "-X
</ul>
</li>
<li>
-<p>Once any failures or required updates have been committed to svn, rollback the release prepare files: <code>mvn -P apache-release release:rollback</code></p>
+<p>Once any failures or required updates have been committed to svn, rollback the release prepare files:<br />
+</p>
+<div class="codehilite"><pre><span class="sb">`mvn -P apache-release release:rollback`</span>
+</pre></div>
+
+
</li>
<li>
-<p>Prepare the release</p>
-<ul>
-<li>Run the "release:prepare" step for real this time. You'll be prompted for the same version information.
-<code>mvn -P apache-release release:prepare -DautoVersionSubmodules=true</code></li>
-<li>Backup (zip or tar) your local release candidate directory in case you need to rollback the release after the next step is performed.</li>
-</ul>
+<p>Prepare the release: Run the "release:prepare" step for real this time. You'll be prompted for the same version information.</p>
+<div class="codehilite"><pre><span class="sb">`mvn -P apache-release release:prepare -DautoVersionSubmodules=true`</span>
+</pre></div>
+
+
+<p>Backup (zip or tar) your local release candidate directory in case you need to rollback the release after the next step is performed.</p>
</li>
<li>
<p>Perform the release</p>
<ul>
<li>
-<p>This step will create a maven staging repository and site for use in testing and voting.
- <code>mvn release:perform -Papache-release</code></p>
+<p>This step will create a maven staging repository and site for use in testing and voting. </p>
+<div class="codehilite"><pre><span class="sb">`mvn release:perform -Papache-release`</span>
+</pre></div>
+
+
</li>
<li>
-<p>If your local OS userid doesn't match your Apache userid, then you'll have to also override the value provided by the OS to Maven for the site-deploy step to work. This is known to work for Linux, but not for Mac and unknown for Windows.*
- -Duser.name=[your_apache_uid]</p>
+<p>If your local OS userid doesn't match your Apache userid, then you'll have to also override the value provided by the OS to Maven for the site-deploy step to work: -Duser.name=[your_apache_uid] --This is known to work for Linux, but not for Mac and unknown for Windows--.</p>
</li>
</ul>
</li>
@@ -222,26 +240,38 @@ For c shell: <code>setenv MAVEN_OPTS "-X
<li>
<p>Sign the binary artifacts</p>
<div class="codehilite"><pre>* $ `cd modules/distribution/target`
-* $ `gpg -ab apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.tar.gz`
-* $ `gpg -ab apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.zip`
-* $ `gpg --print-md SHA512 apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.tar.gz > apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.tar.gz.sha`
-* $ `gpg --print-md SHA512 apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.zip > apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.zip.sha`
-* $ `gpg --print-md MD5 apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.tar.gz > apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.tar.gz.md5`
-* $ `gpg --print-md MD5 apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.zip > apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-incubating-bin.zip.md5`
+* $ `gpg -ab apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.tar.gz`
+* $ `gpg -ab apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.zip`
+* $ `gpg --print-md SHA512 apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.tar.gz > apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.tar.gz.sha`
+* $ `gpg --print-md SHA512 apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.zip > apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.zip.sha`
+* $ `gpg --print-md MD5 apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.tar.gz > apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.tar.gz.md5`
+* $ `gpg --print-md MD5 apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.zip > apache-airavata-*<span class="cp">${</span><span class="n">project</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span>*-bin.zip.md5`
+</pre></div>
+
+
+</li>
+<li>
+<p>Stage the source and binary artifacts to the dist development repository</p>
+<ul>
+<li>
+<p>Checkout Airavata development dist area:</p>
+<div class="codehilite"><pre><span class="sb">`svn co https://dist.apache.org/repos/dist/dev/airavata airavata-dev-dist`</span>
</pre></div>
</li>
<li>
-<p>Stage the source and binary artifacts to a web staging area <br />
- * $ <code>ssh people.apache.org mkdir /www/people.apache.org/builds/airavata/${project.version}</code>
- * $ <code>scp .apache-airavata-*${project.version}*-incubating-bin.zip* ${user.name}@people.apache.org:/www/people.apache.org/builds/airavata/${project.version}/</code>
- * $ <code>ssh people.apache.org cd /www/people.apache.org/builds/airavata/${project.version}</code>
- * $ <code>wget https://repository.apache.org/content/repositories/releases/org/apache/airavata/${project.name}/${project.version}/${project.name}-${project.version}-source-release.zip</code> <br />
- * $ <code>wget https://repository.apache.org/content/repositories/releases/org/apache/airavata/${project.name}/${project.version}/${project.name}-${project.version}-source-release.zip.asc</code> <br />
- * $ <code>wget https://repository.apache.org/content/repositories/releases/org/apache/airavata/${project.name}/${project.version}/${project.name}-${project.version}-source-release.zip.md5</code><br />
- * $ <code>wget https://repository.apache.org/content/repositories/releases/org/apache/airavata/${project.name}/${project.version}/${project.name}-${project.version}-source-release.zip.sha1</code>
- * Verify they are downloadable from http://people.apache.org/builds/airavata/${project.version}/</p>
+<p>Create the directory for ${project.version} and RC{number} within it. The RC number corresponds to the current release attempt. </p>
+</li>
+<li>Copy the source and binaries into dist area.<ul>
+<li>Copy the source and binaries into the development dist RC area created above.</li>
+<li>Sources and signed artificats can be downloaded from staging repo https://repository.apache.org/content/groups/staging/org/apache/airavata/airavata/${project.version}.</li>
+<li>Source artifacts should include airavata-{project.version}-source-release.zip, airavata-{project.version}-source-release.zip.asc, airavata-{project.version}-source-release.zip.sha, airavata-{project.version}-source-release.zip.md5</li>
+<li>Binaries and gpg signed artificats from step 11.</li>
+<li>Verify they are downloadable from https://dist.apache.org/repos/dist/dev/airavata/${project.version}/RC{number}.</li>
+</ul>
+</li>
+</ul>
</li>
<li>
<p>Put the release candidate up for a vote</p>
@@ -249,7 +279,7 @@ For c shell: <code>setenv MAVEN_OPTS "-X
<li>Create a VOTE email thread on dev@ to record votes as replies, like <a href="release-vote.txt">this</a></li>
<li>Create a DISCUSS email thread on dev@ for any vote questions, <a href="release-discuss.txt">this</a></li>
<li>
-<p>Perform a review of the release and cast your vote. For elaborate instructions, please consult <a href="http://www.apache.org/dev/release.html">Apache Release FAQ</a> and [Incubator Release Management][inc-release-mgmt] Guides.</p>
+<p>Perform a review of the release and cast your vote. For elaborate instructions, please consult <a href="http://www.apache.org/dev/release.html">Apache Release FAQ</a>.</p>
</li>
<li>
<p>A -1 vote does not necessarily mean that the vote must be redone, however it is usually a good idea to rollback the release if a -1 vote is received. See - Recovering from a vetoed release</p>
@@ -277,7 +307,7 @@ For c shell: <code>setenv MAVEN_OPTS "-X
<p>Checkin the source and binary artifcats into distribution svn which will be pulled by all mirrors within 24 hours. <br />
</p>
<ul>
-<li>$ <code>svn co https://dist.apache.org/repos/dist/release/incubator/airavata ./airavata-releases</code> (KEEP this directory until after the release process has been completed)</li>
+<li>$ <code>svn co https://dist.apache.org/repos/dist/release/airavata ./airavata-releases</code> (KEEP this directory until after the release process has been completed)</li>
<li>$ <code>cd ./airavata-releases</code></li>
<li>$ <code>scp people.apache.org:/www/people.apache.org/builds/airavata/${project.version}/* ./</code></li>
<li>$ <code>svn add ${project.name}-*</code></li>
@@ -315,7 +345,7 @@ For c shell: <code>setenv MAVEN_OPTS "-X
<p>Announcing the release</p>
<ul>
<li>Make a news announcement on the Airavata homepage.</li>
-<li>Make an announcement about the release on the airavata-dev@incubator.apache.org, and announce@apache.org.</li>
+<li>Make an announcement about the release on the dev@airavata.apache.org, users@airavata.apache.org, and announce@apache.org.</li>
</ul>
</li>
</ol>
Added: websites/staging/airavata/trunk/content/development/release-vote.txt
==============================================================================
--- websites/staging/airavata/trunk/content/development/release-vote.txt (added)
+++ websites/staging/airavata/trunk/content/development/release-vote.txt Sun Oct 28 04:24:08 2012
@@ -0,0 +1,34 @@
+To: dev@airavata.apache.org
+Subject: [VOTE] Apache Airavata ${version} RC{number}
+
+Apache Airavata PMC is pleased to call for a vote on the following Apache Airavata ${version} release candidate artifacts:
+
+Detailed change log/release notes:
+https://svn.apache.org/repos/asf/airavata/tags/airavata-${version}/RELEASE_NOTES
+
+All Release Artifacts:
+https://dist.apache.org/repos/dist/dev/airavata/${version}/RC{number}/
+
+PGP release keys (signed using {ReleaseManagerKey}):
+https://svn.apache.org/repos/asf/airavata/KEYS
+
+Specific URL's:
+
+SVN source tag ($revision_number):
+https://svn.apache.org/repos/asf/airavata/tags/airavata-${version}/
+
+Source release:
+https://dist.apache.org/repos/dist/dev/airavata/${version}/RC{number}/airavata-{project.version}-source-release.zip
+
+Binary Artifacts:
+https://dist.apache.org/repos/dist/dev/airavata/${version}/RC{number}/apache-airavata-${project.version}-bin.tar.gz
+https://dist.apache.org/repos/dist/dev/airavata/${version}/RC{number}/apache-airavata-${project.version}-bin.zip
+
+Maven staging repo:
+https://repository.apache.org/content/repositories/orgapacheairavata-{XXX}/
+
+Please verify the artifacts and vote. The vote will be open for 72 hours.
+
+[ ] +1 approve
+[ ] +0 no opinion
+[ ] -1 disapprove (and reason why)