You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@phoenix.apache.org by mu...@apache.org on 2017/10/10 18:05:22 UTC

svn commit: r1811751 - in /phoenix/site: publish/release.html source/src/site/markdown/release.md

Author: mujtaba
Date: Tue Oct 10 18:05:21 2017
New Revision: 1811751

URL: http://svn.apache.org/viewvc?rev=1811751&view=rev
Log:
Update release docs

Modified:
    phoenix/site/publish/release.html
    phoenix/site/source/src/site/markdown/release.md

Modified: phoenix/site/publish/release.html
URL: http://svn.apache.org/viewvc/phoenix/site/publish/release.html?rev=1811751&r1=1811750&r2=1811751&view=diff
==============================================================================
--- phoenix/site/publish/release.html (original)
+++ phoenix/site/publish/release.html Tue Oct 10 18:05:21 2017
@@ -1,7 +1,7 @@
 
 <!DOCTYPE html>
 <!--
- Generated by Apache Maven Doxia at 2017-10-04
+ Generated by Apache Maven Doxia at 2017-10-10
  Rendered using Reflow Maven Skin 1.1.0 (http://andriusvelykis.github.io/reflow-maven-skin)
 -->
 <html  xml:lang="en" lang="en">
@@ -162,18 +162,21 @@
 <div class="page-header">
  <h1>How to do a release</h1>
 </div> 
+<p>Following instructions walks you through releasing Phoenix-4.11.0-HBase-0.98. These steps needs to be repeated for all HBase branches.</p> 
 <div class="section"> 
  <h2 id="Pre-Reqs">Pre-Reqs</h2> 
  <ol style="list-style-type: decimal"> 
   <li>Make sure you have setup your user for release signing. Details <a class="externalLink" href="http://www.apache.org/dev/release-signing.html">http://www.apache.org/dev/release-signing.html</a>.</li> 
   <li>Clone the branch locally from which you want to do a release.</li> 
-  <li>Set version to release and commit. Ex.: mvn versions:set -DnewVersion=4.2.0 -DgenerateBackupPoms=false</li> 
-  <li>Update CHANGES file</li> 
-  <li>Verify all pom.xml files in project have the correct release version (i.e. does not contain SNAPSHOT)</li> 
+  <li>Set version to release and commit.</li> 
  </ol> 
+ <div class="source"> 
+  <pre>mvn versions:set -DnewVersion=4.11.0-HBase-0.98 -DgenerateBackupPoms=false
+</pre> 
+ </div> 
 </div> 
 <div class="section"> 
- <h2 id="Command_for_building_binary_and_source_tars">Command for building binary and source tars</h2> 
+ <h2 id="Build_binary_and_source_tars">Build binary and source tars</h2> 
  <div class="source"> 
   <pre>$ cd dev; ./make_rc.sh
 </pre> 
@@ -181,13 +184,46 @@
  <p>Follow the instructions. Signed binary and source tars will be generated in <i>release</i> directory. As last part of this script, it will ask if you want to tag branch at this time. If all looks good then svn commit binary and source tars to <a class="externalLink" href="https://dist.apache.org/repos/dist/dev/phoenix">https://dist.apache.org/repos/dist/dev/phoenix</a> </p> 
 </div> 
 <div class="section"> 
- <h2 id="Final_steps">Final steps</h2> 
+ <h2 id="Voting">Voting</h2> 
  <ol style="list-style-type: decimal"> 
-  <li>Initiate vote email. See example <a class="externalLink" href="http://mail-archives.apache.org/mod_mbox/phoenix-dev/201408.mbox/%3cCAAF1JdgVOLLVVuymR6hzo9PxGeKOa_fz2ZAZX4C6R4TCSaiZcg@mail.gmail.com%3e">here</a></li> 
   <li>Svn commit binary and source tars to <a class="externalLink" href="https://dist.apache.org/repos/dist/dev/phoenix">https://dist.apache.org/repos/dist/dev/phoenix</a></li> 
-  <li>Once voting is successful, copy artifacts to <a class="externalLink" href="https://dist.apache.org/repos/dist/release/phoenix">https://dist.apache.org/repos/dist/release/phoenix</a> and set version back to SNAPSHOT and commit. Ex.: mvn versions:set -DnewVersion=4.3.0-SNAPSHOT -DgenerateBackupPoms=false</li> 
-  <li>Set git tag -a v4.2.0 release_sha -m “Phoenix v4.2.0”</li> 
+  <li>Initiate vote email. See example <a class="externalLink" href="https://www.mail-archive.com/dev@phoenix.apache.org/msg41202.html">here</a></li> 
+ </ol> 
+</div> 
+<div class="section"> 
+ <h2 id="Release">Release</h2> 
+ <ol style="list-style-type: decimal"> 
+  <li>Once voting is successful, copy artifacts to <a class="externalLink" href="https://dist.apache.org/repos/dist/release/phoenix">https://dist.apache.org/repos/dist/release/phoenix</a>:</li> 
+ </ol> 
+ <div class="source"> 
+  <pre>svn mv https://dist.apache.org/repos/dist/dev/phoenix/apache-phoenix-4.11.0-HBase-0.98-rc1 https://dist.apache.org/repos/dist/release/phoenix/apache-phoenix-4.11.0-HBase-0.98
+</pre> 
+ </div> 
+ <ol style="list-style-type: decimal"> 
+  <li>Step release tag:</li> 
+ </ol> 
+ <div class="source"> 
+  <pre>git tag -a v4.11.0-HBase-0.98 v4.11.0-HBase-0.98-rc0 -m &quot;Phoenix v4.11.0-HBase-0.98 release
+</pre> 
+ </div> 
+ <ol style="list-style-type: decimal"> 
   <li>Remove any obsolete releases on <a class="externalLink" href="https://dist.apache.org/repos/dist/release/phoenix">https://dist.apache.org/repos/dist/release/phoenix</a> given the current release</li> 
+  <li>Release to maven:</li> 
+ </ol> 
+ <div class="source"> 
+  <pre>mvn clean deploy gpg:sign -DperformRelease=true -Dgpg.passphrase=[your_pass_phrase_here] -Dgpg.keyname=[your_key_here] -DskipTests -P release -pl phoenix-core,phoenix-pig,phoenix-tracing-webapp,phoenix-queryserver,phoenix-spark,phoenix-flume,phoenix-pherf,phoenix-queryserver-client,phoenix-hive -am
+</pre> 
+ </div> 
+ <ol style="list-style-type: decimal"> 
+  <li>Go to <a class="externalLink" href="https://repository.apache.org/#stagingRepositories">https://repository.apache.org/#stagingRepositories</a> and press release button</li> 
+  <li>Set version back to upcoming SNAPSHOT and commit:</li> 
+ </ol> 
+ <div class="source"> 
+  <pre>mvn versions:set -DnewVersion=4.12.0-HBase-0.98-SNAPSHOT -DgenerateBackupPoms=false
+</pre> 
+ </div> 
+ <ol style="list-style-type: decimal"> 
+  <li>Create new branch based on current release if needed.</li> 
  </ol> 
 </div>
 			</div>

Modified: phoenix/site/source/src/site/markdown/release.md
URL: http://svn.apache.org/viewvc/phoenix/site/source/src/site/markdown/release.md?rev=1811751&r1=1811750&r2=1811751&view=diff
==============================================================================
--- phoenix/site/source/src/site/markdown/release.md (original)
+++ phoenix/site/source/src/site/markdown/release.md Tue Oct 10 18:05:21 2017
@@ -1,13 +1,16 @@
 # How to do a release
+Following instructions walks you through releasing Phoenix-4.11.0-HBase-0.98. These steps needs to be repeated for all HBase branches.
 
 ## Pre-Reqs
 1. Make sure you have setup your user for release signing. Details http://www.apache.org/dev/release-signing.html.
 2. Clone the branch locally from which you want to do a release.
-3. Set version to release and commit. Ex.: mvn versions:set -DnewVersion=4.2.0 -DgenerateBackupPoms=false
-4. Update CHANGES file
-5. Verify all pom.xml files in project have the correct release version (i.e. does not contain SNAPSHOT)
+3. Set version to release and commit. 
 
-## Command for building binary and source tars 
+```
+mvn versions:set -DnewVersion=4.11.0-HBase-0.98 -DgenerateBackupPoms=false
+```
+
+## Build binary and source tars 
 
 ```
 $ cd dev; ./make_rc.sh
@@ -15,10 +18,38 @@ $ cd dev; ./make_rc.sh
 
 Follow the instructions. Signed binary and source tars will be generated in _release_ directory. As last part of this script, it will ask if you want to tag branch at this time. If all looks good then svn commit binary and source tars to https://dist.apache.org/repos/dist/dev/phoenix 
 
-## Final steps
+## Voting
+
+1. Svn commit binary and source tars to https://dist.apache.org/repos/dist/dev/phoenix
+2. Initiate vote email. See example [here](https://www.mail-archive.com/dev@phoenix.apache.org/msg41202.html)
+
+
+## Release
+1. Once voting is successful, copy artifacts to https://dist.apache.org/repos/dist/release/phoenix: 
+
+```
+svn mv https://dist.apache.org/repos/dist/dev/phoenix/apache-phoenix-4.11.0-HBase-0.98-rc1 https://dist.apache.org/repos/dist/release/phoenix/apache-phoenix-4.11.0-HBase-0.98
+```
+
+2. Step release tag: 
+
+```
+git tag -a v4.11.0-HBase-0.98 v4.11.0-HBase-0.98-rc0 -m "Phoenix v4.11.0-HBase-0.98 release
+```
+
+3. Remove any obsolete releases on https://dist.apache.org/repos/dist/release/phoenix given the current release
+4. Release to maven: 
+
+```
+mvn clean deploy gpg:sign -DperformRelease=true -Dgpg.passphrase=[your_pass_phrase_here] -Dgpg.keyname=[your_key_here] -DskipTests -P release -pl phoenix-core,phoenix-pig,phoenix-tracing-webapp,phoenix-queryserver,phoenix-spark,phoenix-flume,phoenix-pherf,phoenix-queryserver-client,phoenix-hive -am
+```
+
+5. Go to https://repository.apache.org/#stagingRepositories and press release button
+6. Set version back to upcoming SNAPSHOT and commit: 
+
+```
+mvn versions:set -DnewVersion=4.12.0-HBase-0.98-SNAPSHOT -DgenerateBackupPoms=false
+```
+
+7. Create new branch based on current release if needed.
 
-1. Initiate vote email. See example [here](http://mail-archives.apache.org/mod_mbox/phoenix-dev/201408.mbox/%3cCAAF1JdgVOLLVVuymR6hzo9PxGeKOa_fz2ZAZX4C6R4TCSaiZcg@mail.gmail.com%3e)
-2. Svn commit binary and source tars to https://dist.apache.org/repos/dist/dev/phoenix
-3. Once voting is successful, copy artifacts to https://dist.apache.org/repos/dist/release/phoenix and set version back to SNAPSHOT and commit. Ex.: mvn versions:set -DnewVersion=4.3.0-SNAPSHOT -DgenerateBackupPoms=false
-4. Set git tag -a v4.2.0 release_sha -m "Phoenix v4.2.0"
-5. Remove any obsolete releases on https://dist.apache.org/repos/dist/release/phoenix given the current release