directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Directory Development > Releasing ApacheDS
Date Mon, 28 Jan 2013 14:57:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2042/9/1/_/styles/combined.css?spaceKey=DIRxDEV&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/DIRxDEV/Releasing+ApacheDS">Releasing
ApacheDS</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~pamarcelot">Pierre-Arnaud
Marcelot</a>
    </h4>
        <br/>
                         <h4>Changes (2)</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" >Go to [https://repository.apache.org/index.html#stagingRepositories]
and release the staging repository so all artifacts are published to Maven central. <br>
<br></td></tr>
            <tr><td class="diff-changed-lines" >Move the distribution packages
to the dist SVN repository: <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">https://dist.apache.org/repos/dist/release/directory/apacheds/dist/${version}</span>
<span class="diff-added-words"style="background-color: #dfd;">https://dist.apache.org/repos/dist/release/directory/apacheds/dist/$(version)</span>
<br></td></tr>
            <tr><td class="diff-changed-lines" >Move the sources releases to the
dist SVN repository: <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">https://dist.apache.org/repos/dist/release/directory/apacheds/${version}</span>
<span class="diff-added-words"style="background-color: #dfd;">https://dist.apache.org/repos/dist/release/directory/apacheds/$(version)</span>
<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <div>
<ul>
    <li><a href='#ReleasingApacheDS-Introduction'>Introduction</a></li>
    <li><a href='#ReleasingApacheDS-ManualStep'>Manual Step</a></li>
    <li><a href='#ReleasingApacheDS-Releaseprocess'>Release process</a></li>
</ul></div>

<h2><a name="ReleasingApacheDS-Introduction"></a>Introduction</h2>

<p>This will show you how to build and release the ApacheDS subproject.  Keep an eye
out for warning and note sections that show version specific differences in this process.
</p>

<h2><a name="ReleasingApacheDS-ManualStep"></a>Manual Step</h2>

<p>Some things have not yet been automated with maven and require users to manually
edit some files.  Below are the steps to follow.</p>

<h3><a name="ReleasingApacheDS-Updateservice%2Fapacheds.shandservice%2Fapacheds.bat"></a>Update
service/apacheds.sh and service/apacheds.bat</h3>

<p>Edit the apacheds.sh/bat files in the service project directory to update the revision
numbers used in that file to reference non-SNAPSHOT releases.  </p>

<h2><a name="ReleasingApacheDS-Releaseprocess"></a>Release process</h2>

<p>Since we are using Nexus for releases the release process is as follows (see also
<a href="http://www.apache.org/dev/publishing-maven-artifacts.html#staging-maven" class="external-link"
rel="nofollow">http://www.apache.org/dev/publishing-maven-artifacts.html#staging-maven</a>).</p>

<h3><a name="ReleasingApacheDS-1.TesttheProject"></a>1. Test the Project</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ mvn release:prepare -DdryRun=true
</pre>
</div></div>

<p>Replace the version by the new version. Be careful, and remove the 'apacheds-parent-'
which is proposed for the new tag. We should just use the version number.</p>

<h3><a name="ReleasingApacheDS-2.DeployaSnapshot"></a>2. Deploy a Snapshot</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ mvn deploy
</pre>
</div></div>

<p>This is useful to verify your settings in ~/.m2/settings.xml (Nexus password and
GPG key)</p>

<h3><a name="ReleasingApacheDS-3.PreparetheRelease"></a>3. Prepare the Release</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ mvn release:clean
$ mvn release:prepare
</pre>
</div></div>

<p>This creates a tag here: <a href="http://svn.apache.org/viewvc/directory/apacheds/tags/"
class="external-link" rel="nofollow">http://svn.apache.org/viewvc/directory/apacheds/tags/</a></p>

<h3><a name="ReleasingApacheDS-4.StagetheRelease"></a>4. Stage the Release</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ mvn release:perform
</pre>
</div></div>

<p>This deploys the release to a staging repository. Go to <a href="https://repository.apache.org/index.html#stagingRepositories"
class="external-link" rel="nofollow">https://repository.apache.org/index.html#stagingRepositories</a>
and close the staging repository.</p>

<h3><a name="ReleasingApacheDS-5.DeploytheSite"></a>5. Deploy the Site</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ cd target/checkout
$ mvn site-deploy
</pre>
</div></div>

<p>This creates and deploys the site via ssh to people.apache.org/www/directory.apache.org/apacheds/gen-docs.</p>

<p>Edit the people.apache.org/www/directory.apache.org/apacheds/gen-docs/index.html
file and add the deployed site to the list.</p>

<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/warning.gif" width="16" height="16"
align="absmiddle" alt="" border="0"></td><td>Now, you have to sign the binary
packages which are in apacheds/target/checkout/target.

<p>Use your PGP key ID (the pub key, 4096R/[XXXXXXX] where [XXXXXXX] is the key ID)</p></td></tr></table></div>

<h3><a name="ReleasingApacheDS-6.PublishSourceandBinaryDistributionPackages"></a>6.
Publish Source and Binary Distribution Packages</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ cd target/checkout/target
$ scp apacheds-parent-&lt;version&gt;-source-release.zip* people.apache.org:public_html/
</pre>
</div></div>

<h3><a name="ReleasingApacheDS-7.Testthenewversion"></a>7. Test the new
version</h3>
<p>The best way to do that is to download the sources, extract them, build the server
and the installers, and check if the installers are correctly working. Then check that the
server is correctly running.</p>

<h3><a name="ReleasingApacheDS-8.Createtheinstallers"></a>8. Create the
installers</h3>
<p>We now have to create the installers. Go into the target/checkout directory and run
:</p>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ cd target/checkout/
$ mvn clean install -Pinstallers
</pre>
</div></div>

<p>This will create the installers in the target/checkout/installers/target/installers
directory</p>

<p>Sign those installers using the sigh.sh script, and copy them in people.apache.org/public.html</p>


<h3><a name="ReleasingApacheDS-9.Vote"></a>9. Vote</h3>
<p>Start a 72h vote at the dev mailing list.</p>

<h3><a name="ReleasingApacheDS-10.Release"></a>10. Release</h3>
<p>If the vote succeeds Apacheds project can be released.</p>

<p>Go to <a href="https://repository.apache.org/index.html#stagingRepositories" class="external-link"
rel="nofollow">https://repository.apache.org/index.html#stagingRepositories</a> and
release the staging repository so all artifacts are published to Maven central.</p>

<p>Move the distribution packages to the dist SVN repository: <a href="https://dist.apache.org/repos/dist/release/directory/apacheds/dist/$(version"
class="external-link" rel="nofollow">https://dist.apache.org/repos/dist/release/directory/apacheds/dist/$(version</a>)<br/>
Move the sources releases to the dist SVN repository: <a href="https://dist.apache.org/repos/dist/release/directory/apacheds/$(version"
class="external-link" rel="nofollow">https://dist.apache.org/repos/dist/release/directory/apacheds/$(version</a>)</p>
    </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/DIRxDEV/Releasing+ApacheDS">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=55391&revisedVersion=21&originalVersion=20">View
Changes</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message