You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by re...@apache.org on 2018/02/01 12:52:21 UTC
svn commit: r1822874 - /jackrabbit/site/live/jcr/creating-releases.html
Author: reschke
Date: Thu Feb 1 12:52:20 2018
New Revision: 1822874
URL: http://svn.apache.org/viewvc?rev=1822874&view=rev
Log:
@trivial: Site checkin for project Apache Jackrabbit Site-1.0-SNAPSHOT
Modified:
jackrabbit/site/live/jcr/creating-releases.html
Modified: jackrabbit/site/live/jcr/creating-releases.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/creating-releases.html?rev=1822874&r1=1822873&r2=1822874&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/creating-releases.html (original)
+++ jackrabbit/site/live/jcr/creating-releases.html Thu Feb 1 12:52:20 2018
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2018-01-30
+ | Generated by Apache Maven Doxia at 2018-02-01
| Rendered using Apache Maven Fluido Skin 1.3.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20180130" />
+ <meta name="Date-Revision-yyyymmdd" content="20180201" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Jackrabbit - Creating Releases</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
@@ -189,7 +189,7 @@
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2018-01-30
+ <li id="publishDate">Last Published: 2018-02-01
</li>
@@ -470,10 +470,12 @@
<p>You also need to tell Maven your Subversion credentials needed for deploying artifacts to the Nexus server at <a class="externalLink" href="https://repository.apache.org/">https://repository.apache.org/</a>. See <a href="#Appendix_B:_Maven_settings">Appendix B</a> for the required settings.</p></div>
<div class="section">
<h2>Release management tasks<a name="Release_management_tasks"></a></h2>
+<div class="section">
+<h3>Part I: up to the release vote<a name="Part_I:_up_to_the_release_vote"></a></h3>
<ol style="list-style-type: decimal">
-<li>When releasing from trunk, consider checking the CVE database for vulnerabilities in dependencies, using <tt>mvn org.owasp:dependency-check-maven:3.0.2:aggregate</tt> (first run will be slow because CVE databases are downloaded and parsed). If dependencies need action, open tickets and make sure they are marked as candidate backports where applicable.</li>
+<li>When releasing from trunk, consider checking the CVE database for vulnerabilities in dependencies, using <tt>mvn org.owasp:dependency-check-maven:3.0.2:aggregate</tt> (first run will be slow because CVE databases are downloaded and parsed). If dependencies need action, open tickets and make sure they are marked as candidate backports where applicable.</li>
<li>Make sure that an appropriate version for the release is entered in Jira (<a class="externalLink" href="https://issues.apache.org/jira/projects/JCR?selectedItem=com.atlassian.jira.jira-projects-plugin:release-page">Jackrabbit Jira</a>, <a class="externalLink" href="https://issues.apache.org/jira/projects/OAK?selectedItem=com.atlassian.jira.jira-projects-plugin:release-page">Oak Jira</a>) and that all the related issues have been resolved.</li>
@@ -518,10 +520,15 @@ svn commit -m "Apache Jackrabbit Oa
<li>Start the vote thread by emailing the applicable mailing list (<a class="externalLink" href="mailto:dev@jackrabbit.apache.org?subject=%5BVOTE%5D%20Release%20Apache%20Jackrabbit%20x.y.z">Jackrabbit</a>, <a class="externalLink" href="mailto:oak-dev@jackrabbit.apache.org?subject=%5BVOTE%5D%20Release%20Apache%20Jackrabbit%20Oak%20x.y.z">Oak</a>)</li>
-<li>Wait 72 hours (we usually allow three business days, so be careful when a weekend is ahead)</li>
-
<li>Mark the version as released in Jira: <a class="externalLink" href="https://issues.apache.org/jira/plugins/servlet/project-config/JCR/versions">Jackrabbit Jira</a>, <a class="externalLink" href="https://issues.apache.org/jira/plugins/servlet/project-config/OAK/versions">Oak Jira</a>. You’ll see all the defined project versions. From the settings menu, choose ‘Release’ on the version.</li>
+<li>Wait 72 hours (we usually allow three business days, so be careful when a weekend is ahead)</li>
+</ol></div>
+<div class="section">
+<h3>Part II: after the release vote<a name="Part_II:_after_the_release_vote"></a></h3>
+
+<ol style="list-style-type: decimal">
+
<li>If the vote fails (easy case first) remove the tag from svn, drop the staged repository and revert the version release in Jira - done</li>
<li>
@@ -551,8 +558,7 @@ https://dist.apache.org/repos/dist/relea
<li>close all the issues included in the release: <a class="externalLink" href="https://issues.apache.org/jira/projects/JCR?selectedItem=com.atlassian.jira.jira-projects-plugin:release-page&status=released">Jackrabbit Jira</a> or <a class="externalLink" href="https://issues.apache.org/jira/projects/OAK?selectedItem=com.atlassian.jira.jira-projects-plugin:release-page&status=released">Oak Jira</a> -> Choose the released version -> select “View in Issue Navigator”. From the issue list you have the option to bulk update all of the included issues. Just ‘Transition Issues’ from ‘Resolved’ to ‘Closed’ and you are done!</li>
</ul></li>
-<li>
-<p>Update the Jackrabbit web site to point to the new release (<a class="externalLink" href="https://svn.apache.org/repos/asf/jackrabbit/site/trunk/">SVN</a>).</p>
+<li>Update the Jackrabbit web site to point to the new release (<a class="externalLink" href="https://svn.apache.org/repos/asf/jackrabbit/site/trunk/">SVN</a>).
<ol style="list-style-type: decimal">
@@ -566,7 +572,7 @@ https://dist.apache.org/repos/dist/relea
<li>If the release was a Jackrabbit release used in Oak, make sure to also update the dependency in oak-parent/pom.xml (example: <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-4743">OAK-4743</a> - the current mapping is Jackrabbit 2.17 -> Oak trunk, Jackrabbit 2.16 -> Oak 1.8, Jackrabbit 2.14 -> Oak 1.6, Jackrabbit 2.12 -> Oak 1.4 and 1.2, Jackrabbit 2.8 -> Oak 1.0)</li>
<li>If the release was a stable release for which we publish API docs (such as Jackrabbit), consider updating the live site (<a class="externalLink" href="https://svn.apache.org/repos/asf/jackrabbit/site/live/">https://svn.apache.org/repos/asf/jackrabbit/site/live/</a> - when producing the API docs, use a checkout of the actual release, specify an English locale (-Dlocale=en) and try to pick the right JDK version to minimize changes over the previously checked in docs).</li>
-</ol></div>
+</ol></div></div>
<div class="section">
<h2>Steps to build the release artifacts<a name="Steps_to_build_the_release_artifacts"></a></h2>
<p>The release is built using the Maven release plugin (if your platform is Windows with Cygwin, see <a href="#Appendix_C:_Cygwin">Appendix C</a>). See the <a class="externalLink" href="https://maven.apache.org/developers/release/maven-project-release-procedure.html">Performing a Maven Project Release</a> guide for more details. Make sure you have added the pgp key information in you maven settings file, especially if you have more than one key installed locally. See <a href="#b">Appendix B</a> for the details.</p>