Author: norman
Date: Fri May 25 04:00:55 2007
New Revision: 541615
URL: http://svn.apache.org/viewvc?view=rev&rev=541615
Log:
Add HOWTO for using maven for releasing james-project/james-mime4j/james-jspf
Added:
james/project/trunk/HOWTO_RELEASE.txt (with props)
Added: james/project/trunk/HOWTO_RELEASE.txt
URL:
http://svn.apache.org/viewvc/james/project/trunk/HOWTO_RELEASE.txt?view=auto&rev=541615
==============================================================================
--- james/project/trunk/HOWTO_RELEASE.txt (added)
+++ james/project/trunk/HOWTO_RELEASE.txt Fri May 25 04:00:55 2007
@@ -0,0 +1,70 @@
+Howto release via maven release plugin:
+
+ 1 One time setup steps:
+ Windows:
+ 1 Create and install a SSH key
+ 1 Install PuTTY
+ 2 Use PuttyGen to create a SSH key and export the key as openssh key
+ 3 Use PuTTY to ssh to people.apache.org
+ 4 Create a ~/.ssh folder
+ 5 Use pscp your SSH public key to ~/authorized_keys
+ 6 Configure putty to use your private key and save the session
+ 7 Check you can login people.apache.org with your key
+
+ 2 Install cygwin
+ 1 Install CygWin
+ 2 Use ssh to login to people.apache.org . This is needed to get the
correct entry in your known_hosts file
+ 3 Copy the known_hosts file to your $(homedir)/.ssh/
+
+ Linux / Unix:
+ 1 Create and install a SSH key
+ 1 Install ssh ( this should be installed by default on must linux / unix
systems)
+ 2 Use "ssh-keygen -t dsa" to generate a new private/public key
+ 3 Use ssh to login people.apache.org and add the content of
"~/.ssh/id_dsa.pub" (local) to "~/.ssh/authorited_keys" (people.apache.org)
+ 4 Check you can login people.apache.org via your private key
+
+
+
+
+ General:
+ 1 Install Apache Maven 2.0.6 and make its binary 'mvn' available on your
PATH.
+
+ 2 Create a settings.xml in your .m2 directory with the following content:
+
+ <settings xmlns="http://maven.apache.org/POM/4.0.0";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd";>
+ <servers>
+ <server>
+ <id>people.apache.org</id>
+ <username>$(USERNAME)</username>
+ <privateKey>$(PRIVATE_KEY)</privateKey>
+ <passphrase>$(PASSPRASE)</passphrase>
+ <directoryPermissions>775</directoryPermissions>
+ <filePermissions>644</filePermissions>
+ </server>
+ </servers>
+ <profiles>
+ <profile>
+ <id>release</id>
+ <properties>
+
<deploy.altRepository>people.apache.org::default::scp://people.apache.org/home/$(USERNAME)/public_html/staging-repository</deploy.altRepository>
+ </properties>
+ </profile>
+ </profiles>
+ </settings>
+
+ Replace $(USERNAME) with the username you use to login
people.apache.org, $(PRIVATE_KEY) with the path to your private openssh key and
$(PASSPRASE) with your passphrase.
+ Just remoe the passphrase config option if your private key is not
encrypted with one.
+
+
+ 2 Do the release with maven:
+
+ This steps will build, sign and upload the releases
+
+ General:
+ 1 Move to the root folder of the project:
+ 2 Use ' mvn -Plocal,release release:prepare -Dgpg.keyname=$(YOURKEYNAME)
-Dgpg.passphrase=$(YOURPASSPHRASE) -Darguments="-Dgpg.keyname=$(YOURKEYNAME)
-Dgpg.passphrase=$(YOURPASSPHRASE) " ' to prepare the release
+ 3 Use ' mvn -Plocal,release release:perfom -Dgoals=deploy
-Darguments="-Dgoals=deploy" ' to finally perfom all needed steps to finish the
release stuff
+
+ Now all should be done the next time with only this two maven commands
\ No newline at end of file
Propchange: james/project/trunk/HOWTO_RELEASE.txt
------------------------------------------------------------------------------
svn:eol-style = native
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
