You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@cocoon.apache.org by da...@cocoon.zones.apache.org on 2006/08/03 12:48:22 UTC
[DAISY] Updated: Releasing Cocoon
A document has been updated:
http://cocoon.zones.apache.org/daisy/documentation/1199.html
Document ID: 1199
Branch: main
Language: default
Name: Releasing Cocoon (unchanged)
Document Type: Cocoon Document (unchanged)
Updated on: 8/3/06 10:48:08 AM
Updated by: Reinhard Pötz
A new version has been created, state: publish
Parts
=====
Content
-------
This part has been updated.
Mime type: text/xml (unchanged)
File name: (unchanged)
Size: 2666 bytes (previous version: 37 bytes)
Content diff:
--- <html><body><p>TODO</p></body></html>
+++ <html>
+++ <body>
+++
+++ <p>As Cocoon uses Maven 2 as build system, the release process is very simple
+++ and only requires a few steps.</p>
+++
+++ <h1>Prepare your workstation</h1>
+++
+++ <p>In order to get started, you have to make sure that your work station is
+++ configured correctly:</p>
+++
+++ <h2>Unix based systems</h2>
+++
+++ <ul>
+++ <li>make sure that you can login to people.apache.org using keys
+++ (<a href="http://hacks.oreilly.com/pub/h/66">http://hacks.oreilly.com/pub/h/66</a>)
+++ </li>
+++ <li>in the case that your local username is different from your username at
+++ people.apache.org, configure it at ~/.m2/settings.xml. Also note that setting a
+++ mirror is helpful.</li>
+++ </ul>
+++
+++ <pre><settings>
+++ <localRepository>/daten-nobackup/cocoon/maven2-repository</localRepository>
+++ <mirrors>
+++ <mirror>
+++ <id>dotsrc</id>
+++ <mirrorOf>central</mirrorOf>
+++ <name>Maven mirror @ dotsrc</name>
+++ <url>http://mirrors.dotsrc.org/maven2</url>
+++ </mirror>
+++ </mirrors>
+++ <settings>
+++ <servers>
+++ <server>
+++ <id>apache-maven</id>
+++ <username>[your username on people.apache.org]</username>
+++ <filePermissions>664</filePermissions>
+++ <directoryPermissions>775</directoryPermissions>
+++ </server>
+++ </servers>
+++ </settings>
+++ </settings></pre>
+++
+++ <h1>Releasing POM artifacts</h1>
+++
+++ <ol>
+++ <li>refer to an already released parent in pom.xml</li>
+++ <li><tt>mvn -Dusername=[svn-user-name] -Dpassword=******** release:prepare
+++ -Darguments="-N"</tt></li>
+++ <li><tt>mvn -Dusername=reinhard -Dpassword=******** release:perform
+++ -Darguments="-N"</tt></li>
+++ </ol>
+++
+++ <p>If the "-N" option doesn't work for you, you have to comment the modules
+++ section in the pom by hand and comment it out after the release.</p>
+++
+++ <h1>Releasing JAR artifacts</h1>
+++
+++ <ol>
+++ <li>refer to an already released parent in pom.xml</li>
+++ <li>replace all SNAPSHOT dependencies with already deployed artifacts</li>
+++ <li><tt>mvn -Dusername=[svn-user-name] -Dpassword=******** release:prepare</tt>
+++ </li>
+++ <li><tt>mvn -Dusername=[svn-user-name] -Dpassword=******** release:perform</tt>
+++ </li>
+++ <li>if SNAPSHOT dependencies have been replaced before, point again to them</li>
+++ </ol>
+++
+++ <h1>More readings</h1>
+++
+++ <ul>
+++ <li>
+++ <a href="http://maven.apache.org/plugins/maven-release-plugin/">Documentation of
+++ the Maven release plugin</a></li>
+++ <li><a href="http://maven.apache.org/guides/mini/guide-releasing.html">Guide to
+++ use the Maven 2 release plugin</a></li>
+++ </ul>
+++
+++ </body>
+++ </html>