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 Wed, 09 Feb 2011 21:49: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 (18)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{warning:title=Outdated}{warning}
<br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">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></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">For
these examples we&#39;ll presume a release on the 0.9.5 branch of shared. For releases
on the trunk or on other branches change the svn checkout line to accomodate. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">1.
Prepare the Project <br>{noformat} <br>$ mvn release:prepare -DdryRun=true <br>{noformat}
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">2.
Deploy a Snapshot <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">$
svn co https://svn.apache.org/repos/asf/directory/shared/branches/0.9.5 shared <br>$
cd shared <br>$ mvn -Prelease -DdryRun=true release:prepare    # Dry-run first.   <br>...
 <br>... Make sure the change made by the release plugin is correct! <br>... <br>$
mvn release:clean      # Clean up the temporary files created by the dry-run. <br>$
mvn -Prelease release:prepare    # Copy to tags directory. <br>$ mvn -Prelease release:perform
   # Upload the released artifacts to the maven repository. <br>...  <br>... Make
sure the jars/poms and their signature files are properly deployed to the m2-ibiblio-sync
 <br>... repository on people.apache.org before running the clean goal or else you cannot
rollback the <br>... release. <br>... <br>$ mvn release:clean      # Clean
up the temporary files. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">$
mvn deploy <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{warning:Answering
Questions} <br>During the prepare goal&#39;s execution you&#39;ll be asked a
number of questions.  Please pay close attention to each question instead of hitting return
everytime.  In particular there is a question about what you want to call the tag.  If you
do not specify the correct tag which should be the release number 0.9.5.5 in this case, maven
will use build-0.9.5.5 instead without the *build-* prefix.  We don&#39;t want that so
pay attention.  Look here if you have any questins regarding what release tags should be for
the shared subproject:  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">This
is useful to verify your settings in ~/.m2/settings.xml (Nexus password and GPG key) <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">3.
Prepare the Release <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">http://svn.apache.org/viewvc/directory/shared/tags</span>
<span class="diff-added-words"style="background-color: #dfd;">{noformat}</span>
<br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">$
mvn release:clean <br>$ mvn release:prepare <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">
</span> <span class="diff-added-words"style="background-color: #dfd;">{noformat}</span>
<br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{warning}
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">These
commands will build, tag, sign, and deploy shared artifacts and their signature files to the
repository. Check the following URLs during different stages of the process to see Maven at
work: <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">{note}When
asked for the SCM release tag please *remove* the _shared_ prefix, the version number is enough.{note}
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">||Stage||URL||
<br>|after release:prepare| http://svn.apache.org/viewvc/directory/shared/tags | <br>|during
release:perform| http://people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/directory/shared/
| <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">This
creates a tag here: [http://svn.apache.org/viewvc/directory/shared/tags/] <br> <br>4.
Stage the Release <br>{noformat} <br>$ mvn release:perform <br>{noformat}
<br> <br>This deploys the release to a staging repository. Go to [https://repository.apache.org/index.html#stagingRepositories]
and close the staging repository. <br> <br>5. Deploy the Site <br>{noformat}
<br>$ cd target/checkout <br>$ mvn site-deploy <br>{noformat} <br>
<br>This creates and deploys the site via ssh to people.apache.org/www/directory.apache.org/shared/gen-docs.
<br> <br>6. Test the New Version in ApacheDS and Studio <br>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>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>7.
Create the vote <br>Start a 72h vote at the dev mailing list. <br> <br>If
the vote succeeds Shared project can be released, therefor go to [https://repository.apache.org/index.html#stagingRepositories]
and release the staging repository. <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>

<p>1. Prepare the Project</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ mvn release:prepare -DdryRun=true
</pre>
</div></div>

<p>2. Deploy a Snapshot</p>
<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>

<p>3. Prepare the Release</p>
<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>

<p>4. Stage the Release</p>
<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>

<p>5. Deploy the Site</p>
<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>6. Test the New Version in ApacheDS and Studio<br/>
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.<br/>
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>

<p>7. Create the vote<br/>
Start a 72h vote at the dev mailing list.</p>

<p>If the vote succeeds Shared project can be released, therefor 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.</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=8&originalVersion=7">View
Changes</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message