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 Shared
Date Mon, 14 Feb 2011 08:40:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2036/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+Shared">Releasing
Shared</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~seelmann">Stefan
Seelmann</a>
    </h4>
        <br/>
                         <h4>Changes (13)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-unchanged" >Since we are using Nexus for releases
the release process is as follows (see also [http://www.apache.org/dev/publishing-maven-artifacts.html#staging-maven]).
<br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">1.
Prepare the Project <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
1. Test the Project <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br>$ mvn release:prepare
-DdryRun=true <br>{noformat} <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-added-words"style="background-color:
#dfd;">h3.</span> 2. Deploy a Snapshot <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br>$ mvn deploy
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >This is useful to verify your settings
in ~/.m2/settings.xml (Nexus password and GPG key) <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-added-words"style="background-color:
#dfd;">h3.</span> 3. Prepare the Release <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br>$ mvn release:clean
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >This creates a tag here: [http://svn.apache.org/viewvc/directory/shared/tags/]
<br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-added-words"style="background-color:
#dfd;">h3.</span> 4. Stage the Release <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br>$ mvn release:perform
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >This deploys the release to a staging
repository. Go to [https://repository.apache.org/index.html#stagingRepositories] and close
the staging repository. <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-added-words"style="background-color:
#dfd;">h3.</span> 5. Deploy the Site <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br>$ cd target/checkout
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >Edit the people.apache.org/www/directory.apache.org/shared/gen-docs/index.html
file and add the deployed site to the list. <br> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
6. Publish Source and Binary Distribution Packages <br>{noformat} <br>$ cd target/checkout/distributions/checkout
<br>$ scp apache-ldap-api-&lt;version&gt;-* people.apache.org:public_html/shared-&lt;version&gt;/
<br>{noformat} <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">6.</span>
<span class="diff-added-words"style="background-color: #dfd;">h3. 7.</span> Test
the New Version in ApacheDS and Studio <br></td></tr>
            <tr><td class="diff-unchanged" >In apacheds/pom.xml change the _&lt;org.apache.directory.shared.version&gt;_
property, build ApacheDS, go into apacheds/service, and run _./apachds.sh_ to start the server.
<br> <br>In studio/pom.xml change the _&lt;org.apache.directory.shared.version&gt;_
and _&lt;org.apache.directory.shared.validversion&gt;_ properties, build Studio, and
start Studio in applications/applications_&lt;your platform&gt;/target/ApacheDirectoryStudio-&lt;your
platform&gt;/&lt;executable&gt;. Connect to the started ApacheDS. <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">7.
Create the vote <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
8. Vote <br></td></tr>
            <tr><td class="diff-unchanged" >Start a 72h vote at the dev mailing
list. <br> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
9. Release <br></td></tr>
            <tr><td class="diff-changed-lines" >If the vote succeeds Shared project
can be <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">released,
therefor go to [https://repository.apache.org/index.html#stagingRepositories] and release
the staging repository.</span> <span class="diff-added-words"style="background-color:
#dfd;">released.</span> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">
<br>Go to [https://repository.apache.org/index.html#stagingRepositories] and release
the staging repository so all artifacts are published to Maven central. <br> <br>Move
the distribution packages to people.apache.org/www/www.apache.org/dist/directory/api. <br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <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="ReleasingShared-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>

<h3><a name="ReleasingShared-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="ReleasingShared-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>

<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>When asked for the SCM release
tag please <b>remove</b> the <em>shared</em> prefix, the version number
is enough.</td></tr></table></div>

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

<h3><a name="ReleasingShared-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="ReleasingShared-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/shared/gen-docs.</p>

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

<h3><a name="ReleasingShared-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/distributions/checkout
$ scp apache-ldap-api-&lt;version&gt;-* people.apache.org:public_html/shared-&lt;version&gt;/
</pre>
</div></div>

<h3><a name="ReleasingShared-7.TesttheNewVersioninApacheDSandStudio"></a>7.
Test the New Version in ApacheDS and Studio</h3>
<p>In apacheds/pom.xml change the <em>&lt;org.apache.directory.shared.version&gt;</em>
property, build ApacheDS, go into apacheds/service, and run <em>./apachds.sh</em>
to start the server.</p>

<p>In studio/pom.xml change the <em>&lt;org.apache.directory.shared.version&gt;</em>
and <em>&lt;org.apache.directory.shared.validversion&gt;</em> properties,
build Studio, and start Studio in applications/applications_&lt;your platform&gt;/target/ApacheDirectoryStudio-&lt;your
platform&gt;/&lt;executable&gt;. Connect to the started ApacheDS.</p>

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

<h3><a name="ReleasingShared-9.Release"></a>9. Release</h3>
<p>If the vote succeeds Shared 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 people.apache.org/www/www.apache.org/dist/directory/api.</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+Shared">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=55388&revisedVersion=10&originalVersion=9">View
Changes</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message