geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Geronimo Project Management > Geronimo 2.1.7 Release Process
Date Tue, 30 Nov 2010 08:00:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1810/9/1/_/styles/combined.css?spaceKey=GMOxPMGT&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/GMOxPMGT/Geronimo+2.1.7+Release+Process">Geronimo
2.1.7 Release Process</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~rwonly">Rex
Wang</a>
    </h4>
        <br/>
                         <h4>Changes (1)</h4>
                                 
    
<div id="page-diffs">
            <table class="diff" cellpadding="0" cellspacing="0">
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >reference: <br>[http://maven.apache.org/developers/release/pmc-gpg-keys.html]
  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">
<br> <br>h2 Release Checklist <br> <br>h3. Better to use linux  <br>*
Dos line endings makes all unix shell scripts unexecutable <br>** https://issues.apache.org/jira/browse/GERONIMO-5440
 <br> <br>h3. mvn rat:check <br>* During deal with the 2.1.7 release, I
found the maven rat plugin(1.0-alpha-3, latest) seems have some bugs to me. <br>** incorrect
number of unapproved licenses reported by rat:check. This should be resolved in 1.0-alpha-4,
but it has not released yet..(http://incubator.apache.org/rat/apache-rat-plugin/changes-report.html)
<br>** If I designated the profile, for example -Pall-subprojects, rat:check won&#39;t
run in any of the subprojects. <br>   If I designated -Pno-it, rat:check will run only
in testsuite subproject. <br>   If I designated -Ptools, which does not contain any
subprojects, it will run in all subprojects. <br>   So, the program logic is inverted..
I have to use -Ptools to do rat:check.. <br> <br>h3. Manually update some files:
<br>* delete all pom.xml files, and then search &quot;SNAPSHOT&quot; <br>*
update ##VERSION## in README.txt and RELEASE-NOTES-2.1.7-SNAPSHOT.txt <br>* svn rename
RELEASE-NOTES-2.1.7-SNAPSHOT.txt to RELEASE-NOTES-2.1.7.txt <br>* list JIRAs in RELEASE-NOTES-2.1.7.txt
(bugs, improvement, new features, limitations) <br>* Check the year number in NOTICE
file <br>* commit them <br> <br>h3. mvn release:prepare -DdryRun=true -Pall-subprojects
<br>* Diff the original file pom.xml with the one called pom.xml.tag to see if the license
or any other info has been removed. This has been known to happen if the starting &lt;project&gt;
tag is not on a single line.  <br>* The only things that should be different between
these files are the &lt;version&gt; and &lt;scm&gt; elements. Any other changes
you must backport yourself to the original pom.xml file and commit before proceeding with
the release. <br>* compare the numbers of pom.xml, pom.xml.tag, pom.xml.releaseBackup
<br>** NOTE: the following 5 pom.xml files won&#39;t generate the pom.xml.tag and
pom.xml.releaseBackup files <br>\buildsupport\geronimo-assembly-archetype\src\main\resources\archetype-resources\pom.xml
<br>\buildsupport\geronimo-plugin-archetype\src\main\resources\archetype-resources\pom.xml
<br>\buildsupport\testsuite-archetype-plugin\src\main\resources\archetype-resources\pom.xml
<br>\buildsupport\testsuite-archetype-plugin\src\main\resources\archetype-resources\testset-1\pom.xml
<br>\testsuite\enterprise-testsuite\ejbcontainer-tests\pom.xml <br> <br>h3.
Release Prepare <br>* This will update the versions in branch 2.1 and create tag <br>**
mvn release:clean -Pall-subprojects <br>** mvn release:prepare -Pall-subprojects <br>
<br>h3. Release Perform <br>* This will stage the release artifacts, you must
&quot;close&quot; it in apache nexus <br>** mvn release:perform -Pall-subprojects
<br> <br>h3. Vote <br>* Vote in mailing list, meanwhile wait TCK results
<br> <br>h3. Release artifacts <br>* in apache nexus, click &quot;release&quot;
<br></td></tr>
        </table>
</div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <h1><a name="Geronimo2.1.7ReleaseProcess-Geronimo2.1.7ReleaseProcess"></a>Geronimo
2.1.7 Release Process</h1>
<p>Reference <a href="http://www.apache.org/dev/publishing-maven-artifacts.html"
class="external-link" rel="nofollow">http://www.apache.org/dev/publishing-maven-artifacts.html</a></p>

<h2><a name="Geronimo2.1.7ReleaseProcess-Prerequisite"></a>Prerequisite</h2>

<h3><a name="Geronimo2.1.7ReleaseProcess-1.UseGenesis2.0asaparentpom"></a>1.
Use Genesis 2.0 as a parent pom</h3>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">
<span class="code-tag">&lt;parent&gt;</span>
  <span class="code-tag">&lt;groupId&gt;</span>org.apache.geronimo.genesis<span
class="code-tag">&lt;/groupId&gt;</span>
  <span class="code-tag">&lt;artifactId&gt;</span>genesis-java5-flava<span
class="code-tag">&lt;/artifactId&gt;</span>
  <span class="code-tag">&lt;version&gt;</span>2.0<span class="code-tag">&lt;/version&gt;</span>
<span class="code-tag">&lt;/parent&gt;</span>
</pre>
</div></div>

<ul>
	<li>genesis-java5-flava-2.0.pom
	<ul>
		<li>genesis-default-flava-2.0.pom
		<ul>
			<li>genesis-2.0.pom
			<ul>
				<li>apache-6.pom</li>
			</ul>
			</li>
		</ul>
		</li>
	</ul>
	</li>
</ul>


<h3><a name="Geronimo2.1.7ReleaseProcess-2.UseMaven2.2.1"></a>2. Use Maven
2.2.1</h3>

<ul>
	<li>Enable Apache Servers (refer: <a href="http://maven.apache.org/developers/committer-settings.html"
class="external-link" rel="nofollow">http://maven.apache.org/developers/committer-settings.html</a>)</li>
</ul>


<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">
<span class="code-tag">&lt;settings&gt;</span>
...
  <span class="code-tag">&lt;servers&gt;</span>
    <span class="code-tag"><span class="code-comment">&lt;!-- To publish a
snapshot of some part of Maven --&gt;</span></span>
    <span class="code-tag">&lt;server&gt;</span>
      <span class="code-tag">&lt;id&gt;</span>apache.snapshots.https<span
class="code-tag">&lt;/id&gt;</span>
      <span class="code-tag">&lt;username&gt;</span> <span class="code-tag"><span
class="code-comment">&lt;!-- YOUR APACHE LDAP USERNAME --&gt;</span></span>
<span class="code-tag">&lt;/username&gt;</span>
      <span class="code-tag">&lt;password&gt;</span> <span class="code-tag"><span
class="code-comment">&lt;!-- YOUR APACHE LDAP PASSWORD --&gt;</span></span>
<span class="code-tag">&lt;/password&gt;</span>
    <span class="code-tag">&lt;/server&gt;</span>
    <span class="code-tag"><span class="code-comment">&lt;!-- To publish a
website of some part of Maven --&gt;</span></span>
    <span class="code-tag">&lt;server&gt;</span>
      <span class="code-tag">&lt;id&gt;</span>apache.website<span class="code-tag">&lt;/id&gt;</span>
      <span class="code-tag">&lt;username&gt;</span> <span class="code-tag"><span
class="code-comment">&lt;!-- YOUR APACHE LDAP USERNAME --&gt;</span></span>
<span class="code-tag">&lt;/username&gt;</span>
      <span class="code-tag">&lt;filePermissions&gt;</span>664<span
class="code-tag">&lt;/filePermissions&gt;</span>
      <span class="code-tag">&lt;directoryPermissions&gt;</span>775<span
class="code-tag">&lt;/directoryPermissions&gt;</span>
    <span class="code-tag">&lt;/server&gt;</span>
    <span class="code-tag"><span class="code-comment">&lt;!-- To stage a release
of some part of Maven --&gt;</span></span>
    <span class="code-tag">&lt;server&gt;</span>
      <span class="code-tag">&lt;id&gt;</span>apache.releases.https<span
class="code-tag">&lt;/id&gt;</span>
      <span class="code-tag">&lt;username&gt;</span> <span class="code-tag"><span
class="code-comment">&lt;!-- YOUR APACHE LDAP USERNAME --&gt;</span></span>
<span class="code-tag">&lt;/username&gt;</span>
      <span class="code-tag">&lt;password&gt;</span> <span class="code-tag"><span
class="code-comment">&lt;!-- YOUR APACHE LDAP PASSWORD --&gt;</span></span>
<span class="code-tag">&lt;/password&gt;</span>
    <span class="code-tag">&lt;/server&gt;</span>
    <span class="code-tag"><span class="code-comment">&lt;!-- To stage a website
of some part of Maven --&gt;</span></span>
    <span class="code-tag">&lt;server&gt;</span>
      <span class="code-tag">&lt;id&gt;</span>stagingSite<span class="code-tag">&lt;/id&gt;</span>
<span class="code-tag"><span class="code-comment">&lt;!-- must match hard-coded
repository identifier in site:stage-deploy --&gt;</span></span>
      <span class="code-tag">&lt;username&gt;</span> <span class="code-tag"><span
class="code-comment">&lt;!-- YOUR APACHE LDAP USERNAME --&gt;</span></span>
<span class="code-tag">&lt;/username&gt;</span>
      <span class="code-tag">&lt;filePermissions&gt;</span>664<span
class="code-tag">&lt;/filePermissions&gt;</span>
      <span class="code-tag">&lt;directoryPermissions&gt;</span>775<span
class="code-tag">&lt;/directoryPermissions&gt;</span>
    <span class="code-tag">&lt;/server&gt;</span>
    ...
  <span class="code-tag">&lt;/servers&gt;</span>
<span class="code-tag">&lt;/settings&gt;</span>
</pre>
</div></div>

<p>reference:<br/>
It is highly recommended to use Maven's password encryption capabilities for your passwords.
<a href="http://maven.apache.org/guides/mini/guide-encryption.html" class="external-link"
rel="nofollow">http://maven.apache.org/guides/mini/guide-encryption.html</a></p>

<h3><a name="Geronimo2.1.7ReleaseProcess-3.SetupPGPKeys%28fortheoneswhobethereleasemanagerthefirsttime%29"></a>3.
Setup PGP Keys (for the ones who be the release manager the first time)</h3>
<ul>
	<li>Download gnupg2</li>
	<li>Generate your PGP Key (refer: <a href="http://www.apache.org/dev/openpgp.html"
class="external-link" rel="nofollow">http://www.apache.org/dev/openpgp.html</a>)
so that maven-release-plugin can sign your built artifacts when do release:perform
	<ul>
		<li>How To Avoid SHA-1</li>
		<li>How To Generate a Strong Key</li>
	</ul>
	</li>
	<li>Update Maven's settings.xml with following:
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">
<span class="code-tag">&lt;settings&gt;</span>
  ...
  <span class="code-tag">&lt;profiles&gt;</span>
    <span class="code-tag">&lt;profile&gt;</span>
      <span class="code-tag">&lt;id&gt;</span>apache-release<span class="code-tag">&lt;/id&gt;</span>
      <span class="code-tag">&lt;properties&gt;</span>
        <span class="code-tag">&lt;gpg.passphrase&gt;</span> <span
class="code-tag"><span class="code-comment">&lt;!-- YOUR KEY PASSPHRASE --&gt;</span></span>
<span class="code-tag">&lt;/gpg.passphrase&gt;</span>
      <span class="code-tag">&lt;/properties&gt;</span>
    <span class="code-tag">&lt;/profile&gt;</span>
  <span class="code-tag">&lt;/profiles&gt;</span>
  ...
<span class="code-tag">&lt;/settings&gt;</span>
</pre>
</div></div></li>
	<li>Meanwhile, append your public key to <a href="https://svn.apache.org/repos/asf/geronimo/KEYS"
class="external-link" rel="nofollow">https://svn.apache.org/repos/asf/geronimo/KEYS</a>
and people.apache.org:/www/www.apache.org/dist/geronimo/KEYS so that user can verify the artifacts
you released.
	<ul>
		<li>gpg --gen-key
		<ul>
			<li>RSA and RSA (default), 4096</li>
		</ul>
		</li>
		<li>gpg --list-sigs "xxxxxx" &amp;&amp; gpg --armor --export "xxxxxx" &gt;
xxxxxx.key
		<ul>
			<li>"cat" your public key to above KEYS file</li>
		</ul>
		</li>
	</ul>
	</li>
</ul>



<p>reference:<br/>
<a href="http://maven.apache.org/developers/release/pmc-gpg-keys.html" class="external-link"
rel="nofollow">http://maven.apache.org/developers/release/pmc-gpg-keys.html</a> 
</p>


<p>h2 Release Checklist</p>

<h3><a name="Geronimo2.1.7ReleaseProcess-Bettertouselinux"></a>Better to
use linux </h3>
<ul>
	<li>Dos line endings makes all unix shell scripts unexecutable
	<ul>
		<li><a href="https://issues.apache.org/jira/browse/GERONIMO-5440" class="external-link"
rel="nofollow">https://issues.apache.org/jira/browse/GERONIMO-5440</a></li>
	</ul>
	</li>
</ul>


<h3><a name="Geronimo2.1.7ReleaseProcess-mvnrat%3Acheck"></a>mvn rat:check</h3>
<ul>
	<li>During deal with the 2.1.7 release, I found the maven rat plugin(1.0-alpha-3, latest)
seems have some bugs to me.
	<ul>
		<li>incorrect number of unapproved licenses reported by rat:check. This should be
resolved in 1.0-alpha-4, but it has not released yet..(<a href="http://incubator.apache.org/rat/apache-rat-plugin/changes-report.html"
class="external-link" rel="nofollow">http://incubator.apache.org/rat/apache-rat-plugin/changes-report.html</a>)</li>
		<li>If I designated the profile, for example -Pall-subprojects, rat:check won't run
in any of the subprojects.<br/>
   If I designated -Pno-it, rat:check will run only in testsuite subproject.<br/>
   If I designated -Ptools, which does not contain any subprojects, it will run in all subprojects.<br/>
   So, the program logic is inverted.. I have to use -Ptools to do rat:check..</li>
	</ul>
	</li>
</ul>


<h3><a name="Geronimo2.1.7ReleaseProcess-Manuallyupdatesomefiles%3A"></a>Manually
update some files:</h3>
<ul>
	<li>delete all pom.xml files, and then search "SNAPSHOT"</li>
	<li>update ##VERSION## in README.txt and RELEASE-NOTES-2.1.7-SNAPSHOT.txt</li>
	<li>svn rename RELEASE-NOTES-2.1.7-SNAPSHOT.txt to RELEASE-NOTES-2.1.7.txt</li>
	<li>list JIRAs in RELEASE-NOTES-2.1.7.txt (bugs, improvement, new features, limitations)</li>
	<li>Check the year number in NOTICE file</li>
	<li>commit them</li>
</ul>


<h3><a name="Geronimo2.1.7ReleaseProcess-mvnrelease%3AprepareDdryRun%3DtruePallsubprojects"></a>mvn
release:prepare -DdryRun=true -Pall-subprojects</h3>
<ul>
	<li>Diff the original file pom.xml with the one called pom.xml.tag to see if the license
or any other info has been removed. This has been known to happen if the starting &lt;project&gt;
tag is not on a single line.</li>
	<li>The only things that should be different between these files are the &lt;version&gt;
and &lt;scm&gt; elements. Any other changes you must backport yourself to the original
pom.xml file and commit before proceeding with the release.</li>
	<li>compare the numbers of pom.xml, pom.xml.tag, pom.xml.releaseBackup
	<ul>
		<li>NOTE: the following 5 pom.xml files won't generate the pom.xml.tag and pom.xml.releaseBackup
files<br/>
\buildsupport\geronimo-assembly-archetype\src\main\resources\archetype-resources\pom.xml<br/>
\buildsupport\geronimo-plugin-archetype\src\main\resources\archetype-resources\pom.xml<br/>
\buildsupport\testsuite-archetype-plugin\src\main\resources\archetype-resources\pom.xml<br/>
\buildsupport\testsuite-archetype-plugin\src\main\resources\archetype-resources\testset-1\pom.xml<br/>
\testsuite\enterprise-testsuite\ejbcontainer-tests\pom.xml</li>
	</ul>
	</li>
</ul>


<h3><a name="Geronimo2.1.7ReleaseProcess-ReleasePrepare"></a>Release Prepare</h3>
<ul>
	<li>This will update the versions in branch 2.1 and create tag
	<ul>
		<li>mvn release:clean -Pall-subprojects</li>
		<li>mvn release:prepare -Pall-subprojects</li>
	</ul>
	</li>
</ul>


<h3><a name="Geronimo2.1.7ReleaseProcess-ReleasePerform"></a>Release Perform</h3>
<ul>
	<li>This will stage the release artifacts, you must "close" it in apache nexus
	<ul>
		<li>mvn release:perform -Pall-subprojects</li>
	</ul>
	</li>
</ul>


<h3><a name="Geronimo2.1.7ReleaseProcess-Vote"></a>Vote</h3>
<ul>
	<li>Vote in mailing list, meanwhile wait TCK results</li>
</ul>


<h3><a name="Geronimo2.1.7ReleaseProcess-Releaseartifacts"></a>Release artifacts</h3>
<ul>
	<li>in apache nexus, click "release"</li>
</ul>

    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/GMOxPMGT/Geronimo+2.1.7+Release+Process">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=24188307&revisedVersion=5&originalVersion=4">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxPMGT/Geronimo+2.1.7+Release+Process?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message