Author: liyang
Date: Tue Feb 9 14:15:00 2016
New Revision: 1729386
URL: http://svn.apache.org/viewvc?rev=1729386&view=rev
Log:
Enhance howto_release a bit
Modified:
kylin/site/development/howto_release.html
Modified: kylin/site/development/howto_release.html
URL:
http://svn.apache.org/viewvc/kylin/site/development/howto_release.html?rev=1729386&r1=1729385&r2=1729386&view=diff
==============================================================================
--- kylin/site/development/howto_release.html (original)
+++ kylin/site/development/howto_release.html Tue Feb 9 14:15:00 2016
@@ -470,20 +470,21 @@ Reference: <a href="https://www.gnupg.or
<p>Get the fingerprint of your key:<br />
<code class="highlighter-rouge">gpg --fingerprint YOUR_NAME</code></p>
-<p>It will display the fingerprint like âKey fingerprint = XXXX XXXX â¦â,
then add the fingerprint to your apache account at https://id.apache.org/ in
âOpenPGP Public Key Primary Fingerprintâ field; wait for a while the key
will added to https://people.apache.org/keys/, for example: <br />
-<a
href="https://people.apache.org/keys/committer/lukehan.asc";>https://people.apache.org/keys/committer/lukehan.asc</a>
<br />
-Generate ASCII Amromed Key: <br />
+<p>It will display the fingerprint like âKey fingerprint = XXXX XXXX â¦â,
then add the fingerprint to your apache account at <a
href="https://id.apache.org/";>https://id.apache.org/</a> in âOpenPGP Public
Key Primary Fingerprintâ field; wait for a few hours the key will added to <a
href="https://people.apache.org/keys/";>https://people.apache.org/keys/</a>, for
example:<br />
+<a
href="https://people.apache.org/keys/committer/lukehan.asc";>https://people.apache.org/keys/committer/lukehan.asc</a></p>
+
+<p>Generate ASCII Amromed Key: <br />
<code class="highlighter-rouge">gpg -a --export YOUR_MAIL_ADDRESS >
YOUR_NAME.asc &</code></p>
<p>Upload key to public server: <br />
<code class="highlighter-rouge">gpg --send-keys YOUR_KEY_HASH</code></p>
<p>or Submit key via web: <br />
-Open and Submit to <a
href="http://pool.sks-keyservers.net:11371";>http://pool.sks-keyservers.net:11371</a>
(you can pickup any avaliable public key server) <br />
-Once your key submitted to server, you can verify using following command:
<br />
-<code class="highlighter-rouge">gpg --recv-keys YOUR_KEY_HASH</code></p>
+Open and Submit to <a
href="http://pool.sks-keyservers.net:11371";>http://pool.sks-keyservers.net:11371</a>
(you can pickup any avaliable public key server)</p>
-<p>for example: <br />
+<p>Once your key submitted to server, you can verify using following command:
<br />
+<code class="highlighter-rouge">gpg --recv-keys YOUR_KEY_HASH</code><br />
+for example: <br />
<code class="highlighter-rouge">gpg --recv-keys 027DC364</code></p>
<p>Add your public key to the KEYS file by following instructions in the KEYS
file.: <br />
@@ -503,13 +504,6 @@ For example: <br />
<li>Make sure that every âresolvedâ JIRA case (including duplicates) has
a fix version assigned.</li>
</ul>
-<p><strong>Verify licenses</strong> <br />
-Run Apache RAT to check licenses issue:</p>
-
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">mvn
-Papache-release clean rat:rat</code></pre></div>
-
-<p>Fix license issue if any.</p>
-
<p><strong>Configure Apache repository server in Maven</strong><br />
If youâre the first time to do release, you need update the server
authentication information in ~/.m2/settings.xml; If this file doesnât exist,
copy a template from $M2_HOME/conf/settings.xml;</p>
@@ -555,7 +549,7 @@ If youâre the first time to do rele
</server>
</servers></code></pre></div>
-<p><strong>Making a snapshot</strong></p>
+<p><strong>Fix license issues and make a snapshot</strong></p>
<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span
class="c"># Set passphrase variable without putting it into shell history</span>
<span class="gp">$ </span><span class="nb">read</span> -s GPG_PASSPHRASE
@@ -564,9 +558,10 @@ If youâre the first time to do rele
<span class="gp">$ </span>git clean -xn
<span class="gp">$ </span>mvn clean
+<span class="c"># Fix any license issues as prompted</span>
<span class="gp">$ </span>mvn -Papache-release -Dgpg.passphrase<span
class="o">=</span><span class="k">${</span><span
class="nv">GPG_PASSPHRASE</span><span class="k">}</span>
install</code></pre></div>
-<p>When the dry-run has succeeded, change install to deploy:</p>
+<p>Optionally, when the dry-run has succeeded, change install to deploy:</p>
<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span
class="gp">$ </span>mvn -Papache-release -Dgpg.passphrase<span
class="o">=</span><span class="k">${</span><span
class="nv">GPG_PASSPHRASE</span><span class="k">}</span>
deploy</code></pre></div>
@@ -625,15 +620,17 @@ Now, run the release for real.</p>
<span class="c"># Perform checks out the tagged version, builds, and deploys
to the staging repository</span>
<span class="gp">$ </span>mvn -DskipTests -Papache-release -Darguments<span
class="o">=</span><span class="s2">"-Dgpg.passphrase=</span><span
class="k">${</span><span class="nv">GPG_PASSPHRASE</span><span
class="k">}</span><span class="s2"> -DskipTests"</span>
release:perform</code></pre></div>
-<p><strong>Verify the staged artifacts in the Nexus repository:</strong> <br
/>
-* Go to <a
href="https://repository.apache.org/";>https://repository.apache.org/</a> and
login<br />
-* Under <code class="highlighter-rouge">Build Promotion</code>, click <code
class="highlighter-rouge">Staging Repositories</code><br />
-* In the <code class="highlighter-rouge">Staging Repositories</code> tab there
should be a line with profile <code
class="highlighter-rouge">org.apache.kylin</code><br />
-* Navigate through the artifact tree and make sure the .jar, .pom, .asc files
are present<br />
-* Check the box on in the first column of the row,<br />
- and press the âCloseâ button to publish the repository at<br />
- https://repository.apache.org/content/repositories/orgapachekylin-1006<br />
- (or a similar URL)</p>
+<p><strong>Close the staged artifacts in the Nexus repository:</strong></p>
+
+<ul>
+ <li>Go to <a
href="https://repository.apache.org/";>https://repository.apache.org/</a> and
login</li>
+ <li>Under <code class="highlighter-rouge">Build Promotion</code>, click
<code class="highlighter-rouge">Staging Repositories</code></li>
+ <li>In the <code class="highlighter-rouge">Staging Repositories</code> tab
there should be a line with profile <code
class="highlighter-rouge">org.apache.kylin</code></li>
+ <li>Navigate through the artifact tree and make sure the .jar, .pom, .asc
files are present</li>
+ <li>Check the box on in the first column of the row, and press the
âCloseâ button to publish the repository at<br />
+<a
href="https://repository.apache.org/content/repositories/orgapachekylin-1006";>https://repository.apache.org/content/repositories/orgapachekylin-1006</a><br
/>
+(or a similar URL)</li>
+</ul>
<p><strong>Upload to staging area:</strong> <br />
Upload the artifacts via subversion to a staging area,
https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-X.Y.Z-rcN:</p>
