syncope-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ilgro...@apache.org
Subject svn commit: r1332253 - /incubator/syncope/trunk/parent/src/site/xdoc/release-process.xml
Date Mon, 30 Apr 2012 15:42:29 GMT
Author: ilgrosso
Date: Mon Apr 30 15:42:29 2012
New Revision: 1332253

URL: http://svn.apache.org/viewvc?rev=1332253&view=rev
Log:
Adding pre-requisites

Modified:
    incubator/syncope/trunk/parent/src/site/xdoc/release-process.xml

Modified: incubator/syncope/trunk/parent/src/site/xdoc/release-process.xml
URL: http://svn.apache.org/viewvc/incubator/syncope/trunk/parent/src/site/xdoc/release-process.xml?rev=1332253&r1=1332252&r2=1332253&view=diff
==============================================================================
--- incubator/syncope/trunk/parent/src/site/xdoc/release-process.xml (original)
+++ incubator/syncope/trunk/parent/src/site/xdoc/release-process.xml Mon Apr 30 15:42:29 2012
@@ -33,6 +33,70 @@ under the License.
       <a href="http://maven.apache.org/developers/release/apache-release.html">http://maven.apache.org/developers/release/apache-release.html</a>.
     </p>
     
+    <section name="Prerequisites">
+      <subsection name="GPG">
+        Install/Configure 
+        <code>GPG</code> - The artifacts that are deployed to the ASF central
repository need to
+        be signed. To do this you will need to have a public and private keypair. There is
a very good
+        <a href="http://www.sonatype.com/people/2010/01/how-to-generate-pgp-signatures-with-maven/">guide</a>
that 
+        will walk you though this.
+      </subsection>
+
+      <subsection name="Apache Maven">
+        <p>Install Apache Maven 3.0.3 or higher; we strongly
+          encourage our committers to install 
+          <a href="http://maven.apache.org/download.html">Apache Maven 3.0.4</a>.
+        </p>
+      
+        <p>As of Maven 2.1.0 you can now encrypt your servers passwords. We highly
recommend that you follow this
+          <a href="http://maven.apache.org/guides/mini/guide-encryption.html">guide</a>
to set your master password and
+          use it to encrypt your ASF password in the next section.
+        </p>
+      </subsection>
+
+      <subsection name="ASF settings">
+        <p>Using the instructions from the previous step encrypt your Sonatype password
and add the following servers to
+          your 
+          <code>~/.m2/settings.xml</code> file. You may already have other servers
in this file. If not just create
+          the file.
+        </p>
+
+        <source><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
+<settings>
+  ...
+  <servers>
+    <server>
+      <id>apache.snapshots.https</id>
+      <username>{put your ASF username here}</username>
+      <password>{put your encrypted password here}</password>
+    </server>
+    <server>
+      <id>apache.releases.https</id>
+      <username>{put your ASF username here}</username>
+      <password>{put your encrypted password here}</password>
+    </server>
+  </servers>
+  ...
+  <profiles>
+    <profile>
+      <id>apache</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <properties>
+        <mavenExecutorId>forked-path</mavenExecutorId>
+        <gpg.keyname>19FEA27D</gpg.keyname>\
+        <!-- optional -->
+        <gpg.passphrase>your-gpg-passphrase</gpg.passphrase>
+      </properties>
+    </profile>
+  </profiles>
+  ...
+</settings>]]>
+        </source>
+      </subsection>
+    </section>
+    
     <section name="Release steps">
       
       <subsection name="Prepare the source for release">
@@ -60,7 +124,7 @@ under the License.
           </li>
           <li>
             Perform a full build and deploy the SNAPSHOT artifacts:
-            <source>mvn -P apache-release clean deploy</source>
+            <source>mvn -P all clean deploy</source>
           </li>
         </ol>
       </subsection>
@@ -93,7 +157,7 @@ under the License.
           <li>
             Do a dry run of the 
             <tt>release:prepare</tt> step.
-            <source>mvn -P apache-release release:prepare -DdryRun=true</source>
+            <source>mvn release:prepare -DdryRun=true</source>
 
             The dry run will not commit any changes back to SVN and gives you the opportunity
to verify that the 
             release process will complete as expected.
@@ -142,7 +206,7 @@ gpg: Signature made ...</source>
               </li>
               <li>
                 Once any failures or required updates have been committed to svn, rollback
the release prepare files:
-                <source>mvn -P apache-release release:rollback</source>
+                <source>mvn release:rollback</source>
               </li>
             </ol>
           </li>
@@ -150,7 +214,7 @@ gpg: Signature made ...</source>
             Run the 
             <tt>release:prepare</tt> step for real this time. You'll be prompted
for the same version information and 
             optionally your GPG passphrase again.
-            <source>mvn -P apache-release release:prepare</source>
+            <source>mvn release:prepare</source>
           </li>
           <li>
             Backup (zip or tar) your local release candidate directory in case you need to
rollback the release after 
@@ -164,7 +228,7 @@ cd 1.0-rc1</source>
       
       <subsection name="Perform the release">
         This step will create a maven staging repository
-        <source>mvn -P apache-release release:perform</source>
+        <source>mvn release:perform</source>
         
         <ol>
           <li>Verify the staged artifacts in the Nexus repository:
@@ -353,7 +417,7 @@ Some of the things to check before votin
           <ol>
             <li>
               Restore the 0.1-rc1.tar.gz and run
-              <source>mvn -P apache-release release:rollback</source> 
+              <source>mvn release:rollback</source> 
               <em>or</em>:
               manually revert the versions in trunk to the prior version and commit
             </li>
@@ -390,4 +454,4 @@ Some of the things to check before votin
       </ol>
     </section>
   </body>
-</document>
\ No newline at end of file
+</document>



Mime
View raw message