You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@rave.apache.org by bu...@apache.org on 2011/06/21 23:05:00 UTC
svn commit: r791350 -
/websites/staging/rave/trunk/content/rave/release-process.html
Author: buildbot
Date: Tue Jun 21 21:04:59 2011
New Revision: 791350
Log:
Staging update by buildbot
Modified:
websites/staging/rave/trunk/content/rave/release-process.html
Modified: websites/staging/rave/trunk/content/rave/release-process.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/release-process.html (original)
+++ websites/staging/rave/trunk/content/rave/release-process.html Tue Jun 21 21:04:59 2011
@@ -123,7 +123,7 @@
</p>
<ul>
<li>Release version - take the default </li>
-<li>SCM release tag - <em>DO NOT TAKE THE DEFAULT</em> -: : 0.1-incubating</li>
+<li>SCM release tag - <em>DO NOT TAKE THE DEFAULT</em> -: : ${project.version}-incubating</li>
<li>New development version - take the default</li>
<li>GPG Passprhase<br />
</li>
@@ -159,64 +159,72 @@
</li>
<li>
<p>Prepare the release</p>
-</li>
+<ol>
<li>
<p>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="nv">$</span> <span class="nv">mvn</span> <span class="o">-</span><span class="n">P</span> <span class="n">dist</span> <span class="n">release:prepare</span>
-</pre></div>
-
-
+<p>$ mvn -P apache-release release:prepare</p>
</li>
<li>
<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>
+</ol>
+</li>
<li>
<p>Perform the release</p>
-</li>
-</ol>
+<ul>
+<li>
<p>This step will create a maven staging repository and site for use in testing and voting. </p>
-<div class="codehilite"><pre> <span class="nv">$</span> <span class="nv">mvn</span> <span class="n">release:perform</span> <span class="o">-</span><span class="n">Papache</span><span class="o">-</span><span class="n">release</span> <span class="o">-</span><span class="n">Duser</span><span class="o">.</span><span class="n">name</span><span class="o">=</span><span class="sr"><your_apache_uid></span>
-
-<span class="o">*</span><span class="n">If</span> <span class="n">your</span> <span class="nb">local</span> <span class="n">OS</span> <span class="n">userid</span> <span class="n">doesn</span><span class="s">'t match your Apache userid, then you'</span><span class="n">ll</span> <span class="n">have</span> <span class="n">to</span> <span class="n">also</span> <span class="n">override</span> <span class="n">the</span> <span class="n">value</span> <span class="n">provided</span> <span class="n">by</span> <span class="n">the</span> <span class="n">OS</span> <span class="n">to</span> <span class="n">Maven</span> <span class="k">for</span> <span class="n">the</span> <span class="n">site</span><span class="o">-</span><span class="n">deploy</span> <span class="n">step</span> <span class="n">to</span> <span class="n">work</span><span class="o">.</span> <span class="n">This</span> <span class="n">is</span> <span class="n">known</span> <span class="n">to</span> <span class="n">
work</span> <span class="k">for</span> <span class="n">Linux</span><span class="p">,</span> <span class="n">but</span> <span class="ow">not</span> <span class="k">for</span> <span class="n">Mac</span> <span class="ow">and</span> <span class="n">unknown</span> <span class="k">for</span> <span class="n">Windows</span><span class="o">.*</span>
-<span class="o">*</span><span class="n">The</span> <span class="n">maven</span><span class="o">-</span><span class="n">release</span><span class="o">-</span><span class="n">plugin</span> <span class="n">is</span> <span class="n">configured</span> <span class="n">with</span> <span class="n">goals</span> <span class="s">"deploy site site:deploy"</span> <span class="ow">and</span> <span class="n">will</span> <span class="n">deploy</span> <span class="n">the</span> <span class="n">site</span> <span class="n">files</span> <span class="n">to</span> <span class="n">a</span> <span class="n">staging</span><span class="o">-</span><span class="n">site</span> <span class="n">directory</span> <span class="n">on</span> <span class="n">people</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="o">.*</span>
-</pre></div>
-
-
+<p>$ mvn release:perform -Papache-release -Duser.name=<your_apache_uid></p>
+</li>
+<li>
+<p><em>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.</em></p>
+</li>
+</ul>
+</li>
+<li>
+<p>Verify the release artifacts</p>
<ol>
-<li>Verify the release artifacts</li>
-<li>Verify the HTML links in site are correct</li>
-<li>Verify the staged artifacts in the nexus repo <br />
- 1. https://repository.apache.org/index.html
- 2. Enterprise --> Staging
- 3. Staging tab --> Name column --> org.apache.rave
- 4. Navigate through the artifact tree and make sure that all javadoc, sources, tests, jars, ... have .asc (GPG signature) and .md5 files. See http://people.apache.org/~henkp/repo/faq.html and http://www.apache.org/dev/release-signing.html#openpgp-ascii-detach-sig</li>
-<li>Close the nexus staging repo<ol>
+<li>
+<p>Verify the HTML links in site are correct</p>
+</li>
+<li>
+<p>Verify the staged artifacts in the nexus repo <br />
+</p>
+<ul>
+<li>https://repository.apache.org/index.html</li>
+<li>Enterprise --> Staging</li>
+<li>Staging tab --> Name column --> org.apache.rave</li>
+<li>Navigate through the artifact tree and make sure that all javadoc, sources, tests, jars, ... have .asc (GPG signature) and .md5 files. See http://people.apache.org/~henkp/repo/faq.html and http://www.apache.org/dev/release-signing.html#openpgp-ascii-detach-sig</li>
+</ul>
+</li>
+<li>
+<p>Close the nexus staging repo</p>
+<ul>
<li>https://repository.apache.org/index.html</li>
<li>Enterprise --> Staging</li>
<li>Staging tab --> Name column --> org.apache.rave</li>
<li>Right click on the open staging repo (org.apache.rave-XXX) and select Close.</li>
+</ul>
+</li>
</ol>
</li>
<li>
+<p>Put the release candidate up for a vote</p>
<ol>
<li>Create a VOTE email thread on rave-dev@ to record votes as replies, like <a href="release-vote.txt">this</a></li>
<li>Create a DISCUSS email thread on rave-dev@ for any vote questions, <a href="release-discuss.txt">this</a></li>
-<li>Perform a review of the release and cast your vote. See the following for more details on Apache releases </li>
-</ol>
-<p>Put the release candidate up for a vote</p>
+<li>
+<p>Perform a review of the release and cast your vote. See the following for more details on Apache releases </p>
<p><a href="http://www.apache.org/dev/release.html">http://www.apache.org/dev/release.html</a><br />
<a href="http://incubator.apache.org/guides/releasemanagement.html">http://incubator.apache.org/guides/releasemanagement.html</a></p>
-<ol>
-<li>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</li>
+</li>
<li>
-<ol>
-<li>reply to the initial email and prepend to the original subject -</li>
-</ol>
-<p>After the vote has been open for at least 72 hours, has at least three +1 PMC votes and no -1 votes, then post the results to the vote thread by -</p>
-<p>[RESULTS]</p>
-<ol>
+<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>
+</li>
+<li>After the vote has been open for at least 72 hours, has at least three +1 PMC votes and no -1 votes, then post the results to the vote thread by -<ul>
+<li>reply to the initial email and prepend to the original subject "[RESULTS]"</li>
<li>Include a list of everyone who voted +1, 0 or -1.</li>
-</ol>
+</ul>
</li>
</ol>
</li>
@@ -228,49 +236,72 @@
</li>
<li>
<p>After the vote has been open for at least 72 hours, has at least three +1 Incubator PMC votes and no -1 votes, then post the results to the vote thread by -</p>
-<ol>
-<li>replying to the initial email and prepend to the original subject -</li>
-</ol>
-<p>[RESULTS]</p>
-<ol>
+<ul>
+<li>replying to the initial email and prepend to the original subject "[RESULTS]"</li>
<li>Include a list of everyone who voted +1, 0 or -1.</li>
-</ol>
+</ul>
</li>
</ol>
</li>
<li>
<p>Finalizing a release</p>
-</li>
-<li>
<ol>
+<li>
+<p>Promote the staged nexus artifacts<br />
+</p>
+<ul>
<li>https://repository.apache.org/index.html</li>
<li>Enterprise --> Staging</li>
<li>Staging tab --> Name column --> org.apache.rave</li>
<li>Right click on the closed staging repo (org.apache.rave-XXX) and select Promote.</li>
-</ol>
-<p>Promote the staged nexus artifacts -</p>
-<ol>
+</ul>
+</li>
<li>
-<p>Copy the distribution artifacts over to the distribution area (for rave-project only)</p>
-<p>$ ssh ${user.name}@people.apache.org<br />
- $ mkdir /www/www.apache.org/dist/incubator/rave/${project.version} <br />
- $ cd /www/www.apache.org/dist/incubator/rave/${project.version} <br />
- $ wget https://repository.apache.org/content/repositories/releases/org/apache/rave/rave-parent/${project.version}/rave-parent-${project.version}-source-release.zip <br />
- $ wget https://repository.apache.org/content/repositories/releases/org/apache/rave/rave-parent/${project.version}/rave-parent-${project.version}-source-release.zip.asc <br />
- $ wget https://repository.apache.org/content/repositories/releases/org/apache/rave/rave-parent/${project.version}/rave-parent-${project.version}-source-release.zip.md5 <br />
- $ wget https://repository.apache.org/content/repositories/releases/org/apache/rave/rave-parent/${project.version}/rave-parent-${project.version}-source-release.zip.sha1 <br />
+<p>Build and sign the standalone demo (for rave-project releases only):<br />
+</p>
+<ul>
+<li>Checkout the tag from SVN </li>
+<li>$ mvn -P dist</li>
+<li>$ gpg -ab ./rave-portal/target/rave-<em>${project.version}</em>-incubating.bin.zip</li>
+<li>$ gpg -ab ./rave-portal/target/rave-<em>${project.version}</em>-incubating.bin.tar.gz</li>
+<li>$ gpg --print-md SHA512 rave-<em>${project.version}</em>-incubating.bin.zip > rave-<em>${project.version}</em>-incubating.bin.zip.sha</li>
+<li>$ gpg --print-md SHA512 rave-<em>${project.version}</em>-incubating.bin.tar.gz > rave-<em>${project.version}</em>-incubating.bin.zip.sha</li>
+<li>$ gpg --print-md MD5 rave-<em>${project.version}</em>-incubating.bin.zip > rave-<em>${project.version}</em>-incubating.bin.zip.md5</li>
+<li>$ gpg --print-md MD5 rave-<em>${project.version}</em>-incubating.bin.tar.gz > rave-<em>${project.version}</em>-incubating.bin.zip.md5</li>
+</ul>
+</li>
+<li>
+<p>Copy the distribution artifacts over to the distribution area (for rave-project only)<br />
+</p>
+<ul>
+<li>$ ssh ${user.name}@people.apache.org </li>
+<li>$ mkdir /www/www.apache.org/dist/incubator/rave/${project.version} <br />
+</li>
+<li>$ cd /www/www.apache.org/dist/incubator/rave/${project.version} <br />
+</li>
+<li>$ wget https://repository.apache.org/content/repositories/releases/org/apache/rave/rave-project/${project.version}/rave-parent-${project.version}-source-release.zip <br />
+</li>
+<li>$ wget https://repository.apache.org/content/repositories/releases/org/apache/rave/rave-project/${project.version}/rave-parent-${project.version}-source-release.zip.asc <br />
+</li>
+<li>$ wget https://repository.apache.org/content/repositories/releases/org/apache/rave/rave-project/${project.version}/rave-parent-${project.version}-source-release.zip.md5 <br />
+</li>
+<li>$ wget https://repository.apache.org/content/repositories/releases/org/apache/rave/rave-project/${project.version}/rave-parent-${project.version}-source-release.zip.sha1 <br />
+</li>
+<li>
+<p>Make sure all the copied files have g+rw set and only o+r set</p>
+<p>$ find . -user ${user.name} -type f | xargs chmod 664<br />
+ $ find . -user ${user.name} -type d | xargs chmod 775</p>
+</li>
+<li>
+<p>$ exit</p>
+</li>
+<li>$ scp ./rave-portal/target/rave-<em>${project.version}</em>-incubating.bin.* ${user.name}@people.apache.org:/www/www.apache.org/dist/incubator/rave/${project.version}/</li>
+</ul>
+</li>
+<li>
+<p>Publish the staged website <br />
</p>
</li>
-</ol>
-<p><strong>Make sure all the copied files have g+rw set and only o+r set</strong></p>
-<div class="codehilite"><pre> $ find . -user <span class="cp">${</span><span class="n">user</span><span class="o">.</span><span class="n">name</span><span class="cp">}</span> -type f | xargs chmod 664
- $ find . -user <span class="cp">${</span><span class="n">user</span><span class="o">.</span><span class="n">name</span><span class="cp">}</span> -type d | xargs chmod 775
-</pre></div>
-
-
-<p><em>Note: All of the artifacts are in the maven repos, but we may create an assembly to publish in future releases</em></p>
-<ol>
-<li>Publish the staged website </li>
</ol>
</li>
<li>