From commits-return-32343-apmail-directory-commits-archive=directory.apache.org@directory.apache.org Sat Sep 3 16:10:26 2011 Return-Path: X-Original-To: apmail-directory-commits-archive@www.apache.org Delivered-To: apmail-directory-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id CDA9786A3 for ; Sat, 3 Sep 2011 16:10:26 +0000 (UTC) Received: (qmail 50385 invoked by uid 500); 3 Sep 2011 16:10:26 -0000 Delivered-To: apmail-directory-commits-archive@directory.apache.org Received: (qmail 50320 invoked by uid 500); 3 Sep 2011 16:10:25 -0000 Mailing-List: contact commits-help@directory.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@directory.apache.org Delivered-To: mailing list commits@directory.apache.org Received: (qmail 50313 invoked by uid 99); 3 Sep 2011 16:10:25 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 03 Sep 2011 16:10:25 +0000 X-ASF-Spam-Status: No, hits=-1994.3 required=5.0 tests=ALL_TRUSTED,HTML_MESSAGE,MIME_HTML_ONLY X-Spam-Check-By: apache.org Received: from [140.211.11.22] (HELO thor.apache.org) (140.211.11.22) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 03 Sep 2011 16:10:21 +0000 Received: from thor (localhost [127.0.0.1]) by thor.apache.org (8.13.8+Sun/8.13.8) with ESMTP id p83GA03j014231 for ; Sat, 3 Sep 2011 16:10:00 GMT Date: Sat, 3 Sep 2011 12:10:00 -0400 (EDT) From: confluence@apache.org To: commits@directory.apache.org Message-ID: <8900701.16225.1315066200051.JavaMail.confluence@thor> Subject: [CONF] Apache Directory Development > Releasing Shared MIME-Version: 1.0 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Auto-Submitted: auto-generated X-Virus-Checked: Checked by ClamAV on apache.org

Releasing Shared

Page edited by Emmanuel L=C3=A9charny


Changes (1)

=20 =20
=20 =20
...
{noformat}

Be aware that this phase will ask you about the next version, and mos= t important, for the next SCM tag :
{noformat}
...
[INFO] Check= ing dependencies and plugins for snapshots ...
What is the release vers= ion for "Apache Directory Shared"? (org.apache.directory.shared:s= hared-parent) 1.0.0-M8: :
What is the release version for "Apache= Directory Shared I18n"? (org.apache.directory.shared:shared-i18n) 1.0= .0-M8: :
What is the release version for "Apache Directory Shared= Utilities"? (org.apache.directory.shared:shared-util) 1.0.0-M8: : ...
What is SCM release tag or label for "Apache Directory Share= d"? (org.apache.directory.shared:shared-parent) shared-parent-1.0.0-M8= : : 1.0.0-M8
...
{noformat}

Do *not* hit enter, but remove= the "shared-parent-" prefix here.



h3. 2. Deploy a Snapshot
= {noformat}
...

Full Content

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).

1. Test the Project
$ mvn release:prepare -DdryRun=3Dtrue

Be aware that this phase will ask you about the next version, and most i= mportant, for the next SCM tag :

...
[INFO] Checking dependencies and plugins for snapshots ...
What is the release version for "Apache Directory Shared"? (org.apache.dire=
ctory.shared:shared-parent) 1.0.0-M8: :=20
What is the release version for "Apache Directory Shared I18n"? (org.apache=
.directory.shared:shared-i18n) 1.0.0-M8: :=20
What is the release version for "Apache Directory Shared Utilities"? (org.a=
pache.directory.shared:shared-util) 1.0.0-M8: :=20
...
What is SCM release tag or label for "Apache Directory Shared"? (org.apache=
.directory.shared:shared-parent) shared-parent-1.0.0-M8: : 1.0.0-M8
...

Do not hit enter, but remove the "shared-parent-" prefix here.

2. Deploy a Snapshot<= /h3>
$ mvn deploy

This is useful to verify your settings in ~/.m2/settings.xml (Nexus pass= word and GPG key)

3. Prepare the Rele= ase

$ mvn release:clean
$ mvn release:prepare
3D""When asked for the SCM release tag pleas= e remove the shared prefix, the version number is enough.

This creates a tag here: http://svn.apache= .org/viewvc/directory/shared/tags/

4. Stage the Release<= /h3>
$ mvn release:perform

This deploys the release to a staging repository. Go to https://repository.apache.org/index.html#stagingRepo= sitories and close the staging repository.

5. Deploy the Site

$ cd target/checkout
$ mvn site-deploy

This creates and deploys the site via ssh to people.apache.org/www/direc= tory.apache.org/shared/gen-docs.

Edit the people.apache.org/www/directory.apache.org/shared/gen-docs/inde= x.html file and add the deployed site to the list.

3D""Now, you have to sign the binary package= s which are in target/checkout/distribution/target.

Use your PGP key ID (the pub key, 4096R/[XXXXXXX] where [XXXXXXX] is the= key ID)

6. Publish Source and Binary Distribution Packages

$ cd distributions/target
$ scp apache-ldap-api-<version>-* people.apache.org:public_html/share=
d-<version>/

= 7. Test the New Version in ApacheDS and Studio

In apacheds/pom.xml change the <org.apache.directory.shared.versi= on> property, build ApacheDS, go into apacheds/service, and run ./apachds.sh to start the server.

In studio/pom.xml change the <org.apache.directory.shared.version= > and <org.apache.directory.shared.validversion> pro= perties, build Studio, and start Studio in applications/applications_<yo= ur platform>/target/ApacheDirectoryStudio-<your platform>/<exec= utable>. Connect to the started ApacheDS.

8. Vote

Start a 72h vote at the dev mailing list.

9. Release

If the vote succeeds Shared project can be released.

Go to https://repository.apache.o= rg/index.html#stagingRepositories and release the staging repository so= all artifacts are published to Maven central.

Move the distribution packages to people.apache.org/www/www.apache.org/d= ist/directory/api.