jspwiki-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r891290 - in /websites/staging/jspwiki/trunk/content: ./ ppmc/how_to_release.html
Date Fri, 20 Dec 2013 22:50:09 GMT
Author: buildbot
Date: Fri Dec 20 22:50:08 2013
New Revision: 891290

Log:
Staging update by buildbot for jspwiki

Modified:
    websites/staging/jspwiki/trunk/content/   (props changed)
    websites/staging/jspwiki/trunk/content/ppmc/how_to_release.html

Propchange: websites/staging/jspwiki/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Dec 20 22:50:08 2013
@@ -1 +1 @@
-1552194
+1552834

Modified: websites/staging/jspwiki/trunk/content/ppmc/how_to_release.html
==============================================================================
--- websites/staging/jspwiki/trunk/content/ppmc/how_to_release.html (original)
+++ websites/staging/jspwiki/trunk/content/ppmc/how_to_release.html Fri Dec 20 22:50:08 2013
@@ -87,6 +87,7 @@
 <div class="toc">
 <ul>
 <li><a href="#how-to-release">How to Release</a></li>
+<li><a href="#tldr">tl;dr</a></li>
 <li><a href="#first-time-release-managers">First time release managers</a></li>
 <li><a href="#create-a-release-candidate">Create a release candidate</a><ul>
 <li><a href="#generate-release-candidate-artifacts">Generate release candidate
artifacts</a></li>
@@ -96,11 +97,57 @@
 <li><a href="#run-a-vote">Run a vote</a></li>
 <li><a href="#roll-out">Roll Out</a></li>
 <li><a href="#announce-the-release">Announce the release</a></li>
-<li><a href="#add-the-next-release-to-jira">Add the next release to JIRA</a></li>
+<li><a href="#add-the-next-release-version-to-jira">Add the next release version
to JIRA</a></li>
 <li><a href="#troubleshooting">Troubleshooting</a></li>
 <li><a href="#other-links-of-interest">Other links of interest</a></li>
 </ul>
 </div>
+<h2 id="tldr">tl;dr</h2>
+<p>Once you've done your first release, you'd most probably be more comfortable with

+the quick guide to get the release out (nevertheless, all steps are explained below):</p>
+<ol>
+<li>
+<p>Prepare the release</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">clean</span> <span class="n">install</span> <span class="n">apache</span><span
class="o">-</span><span class="nb">rat</span><span class="p">:</span><span
class="nb">rat</span> <span class="o">-</span><span class="n">Papache</span><span
class="o">-</span><span class="n">release</span>               # <span
class="n">generates</span> <span class="n">artifacts</span><span class="p">,</span>
<span class="n">checks</span> <span class="k">for</span> <span
class="n">AL</span> <span class="n">headers</span>
+<span class="n">mvn</span> <span class="n">release</span><span
class="p">:</span><span class="n">prepare</span> <span class="o">-</span><span
class="n">DdryRun</span><span class="p">=</span><span class="n">true</span>
<span class="o">-</span><span class="n">DautoVersionSubmodules</span><span
class="p">=</span><span class="n">true</span>  # <span class="n">review</span>
<span class="n">pom</span><span class="p">.</span><span class="n">xml</span><span
class="p">,</span> <span class="n">confirm</span> <span class="n">only</span>
<span class="n">appropiate</span> <span class="n">sections</span>
<span class="n">have</span> <span class="n">been</span> <span class="n">changed</span>
+<span class="n">mvn</span> <span class="n">deploy</span>        
                                             # <span class="n">deploy</span> <span
class="n">a</span> <span class="n">snapshot</span>
+<span class="n">mvn</span> <span class="n">release</span><span
class="p">:</span><span class="n">clean</span>                      
                        # <span class="n">prepare</span> <span class="n">the</span>
<span class="n">release</span> 1<span class="o">/</span>3
+<span class="n">mvn</span> <span class="n">release</span><span
class="p">:</span><span class="n">prepare</span> <span class="o">-</span><span
class="n">DautoVersionSubmodules</span><span class="p">=</span><span
class="n">true</span>                # <span class="n">prepare</span>
<span class="n">the</span> <span class="n">release</span> 2<span
class="o">/</span>3
+<span class="n">mvn</span> <span class="n">release</span><span
class="p">:</span><span class="n">perform</span>                    
                        # <span class="n">prepare</span> <span class="n">the</span>
<span class="n">release</span> 3<span class="o">/</span>3
+</pre></div>
+
+
+</li>
+<li>
+<p>Close the staging repo</p>
+</li>
+<li>
+<p>Copy binaries and source to <code>people.apache.org</code></p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="n">target</span><span
class="o">/</span><span class="n">checkout</span>
+<span class="n">scp</span> <span class="n">target</span><span
class="o">/</span><span class="n">jspwiki</span><span class="o">-</span><span
class="n">builder</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="o">-</span><span class="n">source</span><span
class="o">-</span><span class="n">release</span><span class="p">.</span><span
class="n">zip</span><span class="o">*</span> <span class="n">username</span><span
class="p">@</span><span class="n">people</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span class="n">org</span><span
class="p">:</span><span class="o">~/</span><span class="n">public_html</span><span
class="o">/</span><span class="n">jspwiki</span><span class="o">-</span><span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span><span class="o">-</span><span
class="n"
 >rc</span>$<span class="n">RC</span><span class="o">/</span><span
class="n">source</span>
+<span class="n">scp</span> <span class="n">jspwiki</span><span
class="o">-</span><span class="n">war</span><span class="o">/</span><span
class="n">target</span><span class="o">/</span><span class="n">JSPWiki</span><span
class="o">-*</span> <span class="n">username</span><span class="p">@</span><span
class="n">people</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">org</span><span class="p">:</span><span
class="o">~/</span><span class="n">public_html</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="o">-</span><span class="n">rc</span>$<span
class="n">RC</span><span class="o">/</span><span class="n">binaries</span>
+<span class="n">scp</span> <span class="n">jspwiki</span><span
class="o">-</span><span class="n">war</span><span class="o">/</span><span
class="n">target</span><span class="o">/</span><span class="n">JSPWiki</span><span
class="p">.</span><span class="n">war</span><span class="o">*</span>
<span class="n">username</span><span class="p">@</span><span class="n">people</span><span
class="p">.</span><span class="n">apache</span><span class="p">.</span><span
class="n">org</span><span class="p">:</span><span class="o">~/</span><span
class="n">public_html</span><span class="o">/</span><span class="n">jspwiki</span><span
class="o">-</span><span class="n">X</span><span class="p">.</span><span
class="n">Y</span><span class="p">.</span><span class="n">Z</span><span
class="o">-</span><span class="n">rc</span>$<span class="n">RC</span><span
class="o">/</span><span class="n">binaries</span>
+<span class="nb">find</span> <span class="p">.</span> <span class="o">-</span><span
class="n">name</span> <span class="n">jspwiki</span><span class="o">-</span><span
class="n">wikipages</span><span class="o">-*</span><span class="n">zip</span><span
class="o">*</span> <span class="o">-</span><span class="n">exec</span>
<span class="n">scp</span> <span class="p">{}</span> <span class="n">username</span><span
class="p">@</span><span class="n">people</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span class="n">org</span><span
class="p">:</span><span class="o">~/</span><span class="n">public_html</span><span
class="o">/</span><span class="n">jspwiki</span><span class="o">-</span><span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span><span class="o">-</span><span
class="n">rc</span>$<span class="n">RC</span><span class="o">/</span><span
class="n">wikipages</span> <span class="o">\</span>
 <span class="p">;</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Run the vote and, if successful, continue with the items on the list</p>
+</li>
+<li>
+<p>Publish Nexus repository</p>
+</li>
+<li>
+<p>Publish binaries and source to the <a href="http://www.apache.org/dev/mirrors.html">mirrors</a></p>
+</li>
+<li>
+<p>Wait for 24 hours, then announce the release</p>
+</li>
+<li>
+<p>Add the next release version to JIRA</p>
+</li>
+</ol>
 <h2 id="first-time-release-managers">First time release managers</h2>
 <ol>
 <li>
@@ -151,7 +198,7 @@ on <code>people.apache.org</code>, other
 <ol>
 <li>
 <p><strong>Generate artifacts</strong></p>
-<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">clean</span> <span class="n">apache</span><span class="o">-</span><span
class="nb">rat</span><span class="p">:</span><span class="nb">rat</span>
<span class="n">install</span> <span class="o">-</span><span class="n">Papache</span><span
class="o">-</span><span class="n">release</span>
+<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">clean</span> <span class="n">install</span> <span class="n">apache</span><span
class="o">-</span><span class="nb">rat</span><span class="p">:</span><span
class="nb">rat</span> <span class="o">-</span><span class="n">Papache</span><span
class="o">-</span><span class="n">release</span>
 </pre></div>
 
 
@@ -207,10 +254,12 @@ to see the repository.</p>
 </ol>
 </li>
 <li>
-<p><strong>Copy the bin distribution files and checksums to people.apache.org</strong>,
-excluding the <code>asc.md5/asc.sha1</code> files:</p>
-<div class="codehilite"><pre><span class="nb">find</span> <span
class="p">.</span> <span class="o">-</span><span class="n">name</span>
<span class="n">target</span><span class="o">/*</span><span class="n">asc</span><span
class="o">.*</span> <span class="o">-</span><span class="n">exec</span>
<span class="n">rm</span> <span class="p">{}</span> <span class="o">\</span><span
class="p">;</span>
-<span class="n">scp</span> <span class="n">target</span><span
class="o">/*</span> <span class="n">username</span><span class="p">@</span><span
class="n">people</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">org</span><span class="p">:</span><span
class="o">~/</span><span class="n">public_html</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="o">-</span><span class="n">candidate</span><span
class="o">-</span>$<span class="n">RC</span>
+<p>*<em>Copy the bin distribution files and checksums to people.apache.org</em>:</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="n">target</span><span
class="o">/</span><span class="n">checkout</span>
+<span class="n">scp</span> <span class="n">target</span><span
class="o">/</span><span class="n">jspwiki</span><span class="o">-</span><span
class="n">builder</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="o">-</span><span class="n">source</span><span
class="o">-</span><span class="n">release</span><span class="p">.</span><span
class="n">zip</span><span class="o">*</span> <span class="n">username</span><span
class="p">@</span><span class="n">people</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span class="n">org</span><span
class="p">:</span><span class="o">~/</span><span class="n">public_html</span><span
class="o">/</span><span class="n">jspwiki</span><span class="o">-</span><span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span><span class="o">-</span><span
class="n"
 >rc</span>$<span class="n">RC</span><span class="o">/</span><span
class="n">source</span>
+<span class="n">scp</span> <span class="n">jspwiki</span><span
class="o">-</span><span class="n">war</span><span class="o">/</span><span
class="n">target</span><span class="o">/</span><span class="n">JSPWiki</span><span
class="o">-*</span> <span class="n">username</span><span class="p">@</span><span
class="n">people</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">org</span><span class="p">:</span><span
class="o">~/</span><span class="n">public_html</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="o">-</span><span class="n">rc</span>$<span
class="n">RC</span><span class="o">/</span><span class="n">binaries</span>
+<span class="n">scp</span> <span class="n">jspwiki</span><span
class="o">-</span><span class="n">war</span><span class="o">/</span><span
class="n">target</span><span class="o">/</span><span class="n">JSPWiki</span><span
class="p">.</span><span class="n">war</span><span class="o">*</span>
<span class="n">username</span><span class="p">@</span><span class="n">people</span><span
class="p">.</span><span class="n">apache</span><span class="p">.</span><span
class="n">org</span><span class="p">:</span><span class="o">~/</span><span
class="n">public_html</span><span class="o">/</span><span class="n">jspwiki</span><span
class="o">-</span><span class="n">X</span><span class="p">.</span><span
class="n">Y</span><span class="p">.</span><span class="n">Z</span><span
class="o">-</span><span class="n">rc</span>$<span class="n">RC</span><span
class="o">/</span><span class="n">binaries</span>
+<span class="nb">find</span> <span class="p">.</span> <span class="o">-</span><span
class="n">name</span> <span class="n">jspwiki</span><span class="o">-</span><span
class="n">wikipages</span><span class="o">-*</span><span class="n">zip</span><span
class="o">*</span> <span class="o">-</span><span class="n">exec</span>
<span class="n">scp</span> <span class="p">{}</span> <span class="n">username</span><span
class="p">@</span><span class="n">people</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span class="n">org</span><span
class="p">:</span><span class="o">~/</span><span class="n">public_html</span><span
class="o">/</span><span class="n">jspwiki</span><span class="o">-</span><span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span><span class="o">-</span><span
class="n">rc</span>$<span class="n">RC</span><span class="o">/</span><span
class="n">wikipages</span> <span class="o">\</span>
 <span class="p">;</span>
 </pre></div>
 
 
@@ -222,15 +271,15 @@ excluding the <code>asc.md5/asc.sha1</co
 <p>Send the following to <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;&#100;&#101;&#118;&#64;&#106;&#115;&#112;&#119;&#105;&#107;&#105;&#46;&#97;&#112;&#97;&#99;&#104;&#101;&#46;&#111;&#114;&#103;">&#100;&#101;&#118;&#64;&#106;&#115;&#112;&#119;&#105;&#107;&#105;&#46;&#97;&#112;&#97;&#99;&#104;&#101;&#46;&#111;&#114;&#103;</a>:</p>
 <div class="codehilite"><pre><span class="n">Subject</span><span
class="p">:</span> <span class="p">[</span><span class="n">VOTE</span><span
class="p">]</span> <span class="n">Release</span> <span class="n">JSPWiki</span>
<span class="n">version</span> <span class="n">X</span><span class="p">.</span><span
class="n">Y</span><span class="p">.</span><span class="n">Z</span>
 
-<span class="n">This</span> <span class="n">is</span> <span class="n">a</span>
<span class="n">release</span> <span class="k">for</span> <span
class="n">Apache</span> <span class="n">JSPWiki</span><span class="p">,</span>
<span class="n">version</span> <span class="n">X</span><span class="p">.</span><span
class="n">Y</span><span class="p">.</span><span class="n">Z</span><span
class="p">.</span>
+<span class="n">This</span> <span class="n">is</span> <span class="n">a</span>
<span class="n">release</span> <span class="n">vote</span> <span
class="k">for</span> <span class="n">Apache</span> <span class="n">JSPWiki</span><span
class="p">,</span> <span class="n">version</span> <span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="p">.</span> <span class="n">The</span>
<span class="n">vote</span> <span class="n">will</span> <span class="n">be</span>
<span class="n">open</span> <span class="k">for</span> <span class="n">at</span>
<span class="n">least</span> 72 <span class="n">hours</span> <span
class="n">from</span> <span class="n">now</span><span class="p">.</span>
 
 <span class="n">It</span> <span class="n">fixes</span> <span class="n">the</span>
<span class="n">following</span> <span class="n">issues</span><span
class="p">:</span>
 <span class="n">https</span><span class="p">:</span><span class="o">//</span><span
class="n">issues</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">org</span><span class="o">/</span><span
class="n">jira</span><span class="o">/</span><span class="n">secure</span><span
class="o">/</span><span class="n">ReleaseNote</span><span class="p">.</span><span
class="n">jspa</span>?<span class="n">projectId</span><span class="p">=</span>12310732<span
class="o">&amp;</span><span class="n">version</span><span class="p">=</span><span
class="o">&lt;</span><span class="n">REPLACE</span><span class="o">&gt;</span>
 
-<span class="o">***</span> <span class="n">Please</span> <span
class="n">download</span><span class="p">,</span> <span class="n">test</span>
<span class="n">and</span> <span class="n">vote</span> <span class="n">by</span>
<span class="p">[</span>3 <span class="n">working</span> <span
class="n">days</span> <span class="n">after</span> <span class="n">sending</span><span
class="p">].</span>
-
 <span class="n">Note</span> <span class="n">that</span> <span
class="n">we</span> <span class="n">are</span> <span class="n">voting</span>
<span class="n">upon</span> <span class="n">the</span> <span class="n">source</span>
<span class="p">(</span><span class="n">tag</span><span class="p">),</span>
<span class="n">binaries</span> <span class="n">are</span> <span
class="n">provided</span> <span class="k">for</span> <span class="n">convenience</span><span
class="p">.</span>
 
+<span class="n">Everybody</span> <span class="n">is</span> <span
class="n">encouraged</span> <span class="n">to</span> <span class="n">vote</span><span
class="p">.</span>
+
 <span class="n">Source</span> <span class="n">and</span> <span
class="n">binary</span> <span class="n">files</span><span class="p">:</span>
 <span class="n">http</span><span class="p">:</span><span class="o">//</span><span
class="n">people</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">org</span><span class="o">/~&lt;</span><span
class="n">REPLACE</span><span class="o">&gt;/</span><span class="n">jspwiki</span><span
class="o">-</span><span class="n">X</span><span class="p">.</span><span
class="n">Y</span><span class="p">.</span><span class="n">Z</span><span
class="o">-</span><span class="n">candidate</span><span class="o">-</span>$<span
class="n">RC</span>
 
@@ -239,6 +288,12 @@ excluding the <code>asc.md5/asc.sha1</co
 
 <span class="n">JSPWiki</span><span class="o">&#39;</span><span
class="n">s</span> <span class="n">KEYS</span> <span class="n">file</span>
<span class="n">containing</span> <span class="n">PGP</span> <span
class="n">keys</span> <span class="n">we</span> <span class="n">use</span>
<span class="n">to</span> <span class="nb">sign</span> <span class="n">the</span>
<span class="n">release</span><span class="p">:</span>
 <span class="n">http</span><span class="p">:</span><span class="o">//</span><span
class="n">www</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">org</span><span class="o">/</span><span
class="n">dist</span><span class="o">/</span><span class="n">jspwiki</span><span
class="o">/</span><span class="n">KEYS</span>
+
+<span class="o">***</span> <span class="n">Please</span> <span
class="n">download</span><span class="p">,</span> <span class="n">test</span>
<span class="n">and</span> <span class="n">vote</span><span class="p">:</span>
+
+<span class="p">[</span> <span class="p">]</span> <span class="o">+</span>1
<span class="n">Approve</span> <span class="n">the</span> <span
class="n">release</span>
+<span class="p">[</span> <span class="p">]</span>  0 <span class="n">Don</span><span
class="o">&#39;</span><span class="n">t</span> <span class="n">mind</span>
+<span class="p">[</span> <span class="p">]</span> <span class="o">-</span>1
<span class="n">Disapprove</span> <span class="n">the</span> <span
class="n">release</span> <span class="p">(</span><span class="n">please</span>
<span class="n">provide</span> <span class="n">specific</span> <span
class="n">comments</span><span class="p">)</span>
 </pre></div>
 
 
@@ -316,7 +371,7 @@ changes on the front page of the site</p
 
 </li>
 </ol>
-<h2 id="add-the-next-release-to-jira">Add the next release to JIRA</h2>
+<h2 id="add-the-next-release-version-to-jira">Add the next release version to JIRA</h2>
 <ol>
 <li>
 <p>Add the <a href="https://issues.apache.org/jira/plugins/servlet/project-config/jspwiki/versions">next
version number to JIRA</a></p>
@@ -356,8 +411,7 @@ changes on the front page of the site</p
 <li><a href="https://confluence.sakaiproject.org/display/REL/Maven+release+plugin+cheat+sheet">Maven
release plugin cheat sheet</a></li>
 <li><a href="http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env">Publishing
Maven Artifacts - setup your development environment</a></li>
 <li><a href="http://maven.apache.org/maven-release/maven-release-plugin/">Maven
release plugin</a></li>
-<li>Repository management with Nexus: <a href="http://books.sonatype.com/nexus-book/reference/staging-sect-intro.html">Chapter
11. Improved Releases with the Nexus Staging Suite
-</a></li>
+<li>Repository management with Nexus: <a href="http://books.sonatype.com/nexus-book/reference/staging-sect-intro.html">Chapter
11. Improved Releases with the Nexus Staging Suite</a></li>
 </ul>
         </div>
         <div style="clear:both;"></div>



Mime
View raw message