svn commit: r936743 - in /websites/staging/nifi/trunk/content: ./ development/release-guide.html

[bu...@apache.org]

Author: buildbot
Date: Mon Jan 19 06:33:22 2015
New Revision: 936743

Log:
Staging update by buildbot for nifi

Modified:
    websites/staging/nifi/trunk/content/   (props changed)
    websites/staging/nifi/trunk/content/development/release-guide.html

Propchange: websites/staging/nifi/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Jan 19 06:33:22 2015
@@ -1 +1 @@
-1652919
+1652920

Modified: websites/staging/nifi/trunk/content/development/release-guide.html
==============================================================================
--- websites/staging/nifi/trunk/content/development/release-guide.html (original)
+++ websites/staging/nifi/trunk/content/development/release-guide.html Mon Jan 19 06:33:22 2015
@@ -96,7 +96,7 @@
 
       <div class="jumbotron">
         <div id="content">
-          <h1 id="wzxhzdk3-apache-nifi-release-guide"><img alt="NiFi logo" style="float: right" src="/images/niFi-logo-horizontal.png" /> Apache NiFi Release Guide</h1>
+          <h1 id="wzxhzdk5-apache-nifi-release-guide"><img alt="NiFi logo" style="float: right" src="/images/niFi-logo-horizontal.png" /> Apache NiFi Release Guide</h1>
 <p>The purpose of this document is to capture and describe the steps involved in producing 
 an official release of Apache NiFi.  It is written specifically to someone acting in the
 capacity of a <a href="http://www.apache.org/dev/release-publishing.html#release_manager">Release Manager</a> (RM).  </p>
@@ -227,14 +227,19 @@ Maven will then ask:</p>
 <li>Validate that the README is present and provides sufficient information to build and if necessary execute.</li>
 </ul>
 <p>If all looks good then push the branch to origin <code>git push origin NIFI-123</code></p>
+<p>If anything isn't correct about the staged artifacts you can drop the staged repo from repository.apache.org and delete the
+local tag in git.  If you also delete the local branch and clear your local maven repository under org/apache/nifi then it is
+as if the release never happened.  Before doing that though try to figure out what went wrong.  So as described here you see
+that you can pretty easily test the release process until you get it right.  The <code>mvn versions:set</code> and <code>mvn versions:commit</code>
+commands can come in handy to help do this so you can set versions to something clearly release test related.</p>
 <p>Now it's time to initiate a vote within the PPMC.  Send the vote request to <code>dev@nifi.incubator.apache.org</code>
-with a subject of <code>[VOTE] Release Apache NiFi nar-maven-plugin-0.0.2-incubating RC1</code>. The following template can be used:</p>
+with a subject of <code>[VOTE] Release Apache NiFi nar-maven-plugin-0.0.2-incubating</code>. The following template can be used:</p>
 <blockquote>
 <div class="codehilite"><pre><span class="n">Hello</span>
 <span class="n">I</span> <span class="n">am</span> <span class="n">pleased</span> <span class="n">to</span> <span class="n">be</span> <span class="n">calling</span> <span class="n">this</span> <span class="n">vote</span> <span class="k">for</span> <span class="n">the</span> <span class="n">source</span> <span class="n">release</span> <span class="n">of</span> <span class="n">Apache</span> <span class="n">NiFi</span>
 <span class="n">nar</span><span class="o">-</span><span class="n">maven</span><span class="o">-</span><span class="n">plugin</span><span class="o">-</span>0<span class="p">.</span>0<span class="p">.</span>2<span class="o">-</span><span class="n">incubating</span><span class="p">.</span>
 
-<span class="n">The</span> <span class="n">source</span> <span class="n">zip</span><span class="p">,</span> <span class="n">including</span> <span class="n">signatures</span><span class="p">,</span> <span class="n">digests</span><span class="p">,</span> <span class="n">etc</span> <span class="n">can</span> <span class="n">be</span> <span class="n">found</span> <span class="n">at</span><span class="p">:</span>
+<span class="n">The</span> <span class="n">source</span> <span class="n">zip</span><span class="p">,</span> <span class="n">including</span> <span class="n">signatures</span><span class="p">,</span> <span class="n">digests</span><span class="p">,</span> <span class="n">etc</span><span class="p">.</span> <span class="n">can</span> <span class="n">be</span> <span class="n">found</span> <span class="n">at</span><span class="p">:</span>
 <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">repository</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">content</span><span class="o">/</span><span class="n">repositories</span><span class="o">/</span><span class="n">orgapachenifi</span><span class="o">-</span>1010
 
 <span class="n">The</span> <span class="n">Git</span> <span class="n">tag</span> <span class="n">is</span> <span class="n">nar</span><span class="o">-</span><span class="n">maven</span><span class="o">-</span><span class="n">plugin</span><span class="o">-</span>0<span class="p">.</span>0<span class="p">.</span>2<span class="o">-</span><span class="n">incubating</span><span class="o">-</span><span class="n">RC1</span>
@@ -251,10 +256,51 @@ with a subject of <code>[VOTE] Release A
 <span class="n">KEYS</span> <span class="n">file</span> <span class="n">available</span> <span class="n">here</span><span class="p">:</span>
 <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">dist</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">repos</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">release</span><span class="o">/</span><span class="n">incubator</span><span class="o">/</span><span class="n">nifi</span><span class="o">/</span><span class="n">KEYS</span>
 
-<span class="n">Binaries</span> <span class="n">have</span> <span class="n">been</span> <span class="n">published</span> <span class="n">to</span> <span class="n">Maven</span><span class="o">&#39;</span><span class="n">s</span> <span class="n">staging</span> <span class="n">repository</span><span class="p">,</span> <span class="n">and</span>
-<span class="n">are</span> <span class="n">available</span> <span class="n">here</span><span class="p">:</span>
+8 <span class="n">issues</span> <span class="n">were</span> <span class="n">closed</span><span class="o">/</span><span class="n">resolved</span> <span class="k">for</span> <span class="n">this</span> <span class="n">release</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>12316020<span class="o">&amp;</span><span class="n">version</span><span class="p">=</span>12329307
+
+<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> 72 <span class="n">hours</span><span class="p">.</span> 
+<span class="n">Please</span> <span class="n">download</span> <span class="n">the</span> <span class="n">release</span> <span class="n">candidate</span> <span class="n">and</span> <span class="n">evaluate</span> <span class="n">the</span> <span class="n">necessary</span> <span class="n">items</span> <span class="n">including</span> <span class="n">checking</span> <span class="n">hashes</span><span class="p">,</span> <span class="n">signatures</span><span class="p">,</span> <span class="n">build</span> <span class="n">from</span> <span class="n">source</span><span class="p">,</span> <span class="n">and</span> <span class="n">test</span><span class="p">.</span>  <span class="n">The</span> <span class="n">please</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">Release</span> <span class="n">this</span> <span class="n">package</span> <span class="n">as</span> <span class="n">nar</span><span class="o">-</span><span class="n">maven</span><span class="o">-</span><span class="n">plugin</span><span class="o">-</span>0<span class="p">.</span>0<span class="p">.</span>2<span class="o">-</span><span class="n">incubating</span>
+<span class="p">[</span> <span class="p">]</span> <span class="o">+</span>0 <span class="n">no</span> <span class="n">opinion</span>
+<span class="p">[</span> <span class="p">]</span> <span class="o">-</span>1 <span class="n">Do</span> <span class="n">not</span> <span class="n">release</span> <span class="n">this</span> <span class="n">package</span> <span class="n">because</span> <span class="n">because</span><span class="p">...</span>
+</pre></div>
+
 
-<span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">repository</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">content</span><span class="o">/</span><span class="n">repositories</span><span class="o">/</span><span class="n">orgapachenifi</span><span class="o">-</span>1000
+</blockquote>
+<p>A release vote is majority rule.  So wait 72 hours and see if there are at least 3 binding +1 votes and no more negative votes than positive.
+If so forward the vote to the IPMC.  Send the vote request to <code>general@incubator.apache.org</code> with a subject of
+<code>[VOTE] Release Apache NiFi nar-maven-plugin-0.0.2-incubating</code>.  The following template can be used:</p>
+<blockquote>
+<div class="codehilite"><pre><span class="n">Hello</span>
+
+<span class="n">The</span> <span class="n">Apache</span> <span class="n">NiFi</span> <span class="n">PPMC</span> <span class="n">has</span> <span class="n">voted</span> <span class="n">to</span> <span class="n">release</span> <span class="n">Apache</span> <span class="n">NiFi</span> <span class="n">nar</span><span class="o">-</span><span class="n">maven</span><span class="o">-</span><span class="n">plugin</span><span class="o">-</span>0<span class="p">.</span>0<span class="p">.</span>2<span class="o">-</span><span class="n">incubating</span><span class="p">.</span>
+<span class="n">The</span> <span class="n">vote</span> <span class="n">was</span> <span class="n">based</span> <span class="n">on</span> <span class="n">the</span> <span class="n">release</span> <span class="n">candidate</span> <span class="n">and</span> <span class="n">thread</span> <span class="n">described</span> <span class="n">below</span><span class="p">.</span>
+<span class="n">We</span> <span class="n">now</span> <span class="n">request</span> <span class="n">the</span> <span class="n">IPMC</span> <span class="n">to</span> <span class="n">vote</span> <span class="n">on</span> <span class="n">this</span> <span class="n">release</span><span class="p">.</span>
+
+<span class="n">Here</span> <span class="n">is</span> <span class="n">the</span> <span class="n">PPMC</span> <span class="n">voting</span> <span class="n">result</span><span class="p">:</span>
+<span class="n">X</span> <span class="o">+</span>1 <span class="p">(</span><span class="n">binding</span><span class="p">)</span>
+<span class="n">Y</span> <span class="o">-</span>1 <span class="p">(</span><span class="n">binding</span><span class="p">)</span>
+
+<span class="n">Here</span> <span class="n">is</span> <span class="n">the</span> <span class="n">PPMC</span> <span class="n">vote</span> <span class="n">thread</span><span class="p">:</span> <span class="p">[</span><span class="n">URL</span> <span class="n">TO</span> <span class="n">PPMC</span> <span class="n">Vote</span> <span class="n">Thread</span><span class="p">]</span>
+
+<span class="n">The</span> <span class="n">source</span> <span class="n">zip</span><span class="p">,</span> <span class="n">including</span> <span class="n">signatures</span><span class="p">,</span> <span class="n">digests</span><span class="p">,</span> <span class="n">etc</span><span class="p">.</span> <span class="n">can</span> <span class="n">be</span> <span class="n">found</span> <span class="n">at</span><span class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">repository</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">content</span><span class="o">/</span><span class="n">repositories</span><span class="o">/</span><span class="n">orgapachenifi</span><span class="o">-</span>1010
+
+<span class="n">The</span> <span class="n">Git</span> <span class="n">tag</span> <span class="n">is</span> <span class="n">nar</span><span class="o">-</span><span class="n">maven</span><span class="o">-</span><span class="n">plugin</span><span class="o">-</span>0<span class="p">.</span>0<span class="p">.</span>2<span class="o">-</span><span class="n">incubating</span><span class="o">-</span><span class="n">RC1</span>
+<span class="n">The</span> <span class="n">Git</span> <span class="n">commit</span> <span class="n">ID</span> <span class="n">is</span> 3<span class="n">e264c97449c921c7e0cbdec7eb94cb1d6868452</span>
+<span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">git</span><span class="o">-</span><span class="n">wip</span><span class="o">-</span><span class="n">us</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">repos</span><span class="o">/</span><span class="n">asf</span>?<span class="n">p</span><span class="p">=</span><span class="n">incubator</span><span class="o">-</span><span class="n">nifi</span><span class="p">.</span><span class="n">git</span><span class="p">;</span><span class="n">a</span><span class="p">=</span><span class="n">commit</span><span class="p">;</span><span class="n">h</span><span class="p">=</span>3<span class="n">e264c97449c921c7e0cbdec7eb94cb1d6868452</span>
+
+<span class="n">Checksums</span> <span class="n">of</span> <span class="n">nar</span><span class="o">-</span><span class="n">maven</span><span class="o">-</span><span class="n">plugin</span><span class="o">-</span>0<span class="p">.</span>0<span class="p">.</span>2<span class="o">-</span><span class="n">incubating</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="p">:</span>
+<span class="n">MD5</span><span class="p">:</span> 2728931<span class="n">f69fbb4503c689bd5b3f250b3</span>
+<span class="n">SHA1</span><span class="p">:</span> <span class="n">b32c55ad608d26987b49f6fd11fda1e1214c64fe</span>
+
+<span class="n">Release</span> <span class="n">artifacts</span> <span class="n">are</span> <span class="n">signed</span> <span class="n">with</span> <span class="n">the</span> <span class="n">following</span> <span class="n">key</span><span class="p">:</span>
+<span class="n">https</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">/</span><span class="n">keys</span><span class="o">/</span><span class="n">committer</span><span class="o">/</span><span class="n">joewitt</span><span class="p">.</span><span class="n">asc</span>
+
+<span class="n">KEYS</span> <span class="n">file</span> <span class="n">available</span> <span class="n">here</span><span class="p">:</span>
+<span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">dist</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">repos</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">release</span><span class="o">/</span><span class="n">incubator</span><span class="o">/</span><span class="n">nifi</span><span class="o">/</span><span class="n">KEYS</span>
 
 8 <span class="n">issues</span> <span class="n">were</span> <span class="n">closed</span><span class="o">/</span><span class="n">resolved</span> <span class="k">for</span> <span class="n">this</span> <span class="n">release</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>12316020<span class="o">&amp;</span><span class="n">version</span><span class="p">=</span>12329307
@@ -269,6 +315,26 @@ with a subject of <code>[VOTE] Release A
 
 
 </blockquote>
+<p>Wait 72 hours.  If the vote passes then send a vote result email.  Send the email to <code>general@incubator.apache.org, dev@nifi.incubator.apache.org</code>
+with a subject of <code>[RESULT][VOTE] Release Apache NiFi nar-maven-plugin-0.0.2-incubating</code>.  Use a template such as:</p>
+<blockquote>
+<div class="codehilite"><pre><span class="n">Hello</span>
+
+<span class="n">The</span> <span class="n">release</span> <span class="n">passes</span> <span class="n">with</span>
+
+<span class="n">X</span> <span class="o">+</span>1 <span class="p">(</span><span class="n">binding</span><span class="p">)</span> <span class="n">votes</span>
+<span class="n">Y</span> <span class="o">-</span>1 <span class="p">(</span><span class="n">binding</span><span class="p">)</span> <span class="n">votes</span>
+
+<span class="n">Thanks</span> <span class="n">to</span> <span class="n">all</span> <span class="n">who</span> <span class="n">helped</span> <span class="n">make</span> <span class="n">this</span> <span class="n">release</span> <span class="n">possible</span><span class="p">.</span>
+
+<span class="n">Here</span> <span class="n">is</span> <span class="n">the</span> <span class="n">IPMC</span> <span class="n">vote</span> <span class="n">thread</span><span class="p">:</span> <span class="p">[</span><span class="n">INSERT</span> <span class="n">URL</span> <span class="n">OF</span> <span class="n">IPMC</span> <span class="n">Vote</span> <span class="n">Thread</span><span class="p">]</span>
+</pre></div>
+
+
+</blockquote>
+<p>Now all the voting is done and the release is good to go.  In repository.apache.org go to the staging repository
+and select <code>release</code>.  Then publish the source, hashes, and signatures to <code>https://dist.apache.org/repos/dist/release/incubator/nifi/</code>
+Then merge the release git tag to develop and to master.</p>
         </div>
       </div>
         <div id="footer">