Author: mck
Date: Tue Jun 4 10:49:01 2013
New Revision: 1489384
URL: http://svn.apache.org/r1489384
Log:
svn merge -c1489378 ^/tiles/request/branches/TREQ_1_0_X .
| upgrade to tiles-master-5.
| upgrade to svnpubsub system using maven-scm-publish-plugin.
| update the release and building pages for devs (svnpubsub, and referencing
existing apache docs).
Modified:
tiles/request/trunk/ (props changed)
tiles/request/trunk/pom.xml
tiles/request/trunk/src/site/apt/dev/release.apt
tiles/request/trunk/src/site/xdoc/dev/building.xml
Propchange: tiles/request/trunk/
------------------------------------------------------------------------------
svn:mergeinfo = /tiles/request/branches/TREQ_1_0_X:1489378
Modified: tiles/request/trunk/pom.xml
URL:
http://svn.apache.org/viewvc/tiles/request/trunk/pom.xml?rev=1489384&r1=1489383&r2=1489384&view=diff
==============================================================================
--- tiles/request/trunk/pom.xml (original)
+++ tiles/request/trunk/pom.xml Tue Jun 4 10:49:01 2013
@@ -24,7 +24,7 @@ under the License.
<parent>
<artifactId>tiles-master</artifactId>
<groupId>org.apache.tiles</groupId>
- <version>4</version>
+ <version>5</version>
<relativePath />
</parent>
<groupId>org.apache.tiles</groupId>
@@ -59,7 +59,7 @@ under the License.
<distributionManagement>
<site>
<id>apache-site</id>
-
<url>scp://people.apache.org/www/tiles.apache.org/tiles-request</url>
+
<url>scm:svn:https://svn.apache.org/repos/asf/tiles/site/staging/tiles-request</url>
</site>
</distributionManagement>
@@ -121,11 +121,11 @@ under the License.
</executions>
</plugin>
<plugin>
- <groupId>org.apache.maven.plugins</groupId>
- <artifactId>maven-release-plugin</artifactId>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-scm-publish-plugin</artifactId>
+ <extensions>true</extensions>
<configuration>
- <releaseProfiles>apache-release</releaseProfiles><!-- xxx
tiles still uses "release" instead of "apache-release" -->
- <goals>deploy site-deploy</goals>
+
<pubScmUrl>scm:svn:https://svn.apache.org/repos/asf/tiles/site/staging/tiles-request</pubScmUrl>
</configuration>
</plugin>
</plugins>
Modified: tiles/request/trunk/src/site/apt/dev/release.apt
URL:
http://svn.apache.org/viewvc/tiles/request/trunk/src/site/apt/dev/release.apt?rev=1489384&r1=1489383&r2=1489384&view=diff
==============================================================================
--- tiles/request/trunk/src/site/apt/dev/release.apt (original)
+++ tiles/request/trunk/src/site/apt/dev/release.apt Tue Jun 4 10:49:01 2013
@@ -25,15 +25,23 @@ Tiles Release Process
Here you will find the steps to create releases for Tiles.
+ Apache's existing documentation should be read
+
+ * {{{http://www.apache.org/dev/release-publishing}Publishing Releases}}
+
+ * {{{http://www.apache.org/dev/publishing-maven-artifacts.html}Publishing
Maven Artifacts}}
+
+ * {{{http://www.apache.org/dev/release}Releases Policy}}
+
Prerequisites
To create a release you have to install:
* {{{http://java.sun.com/javase/6}Java 6.0}}. If you are using a newer
- version of Java, it is suggested to <<change JAVA_HOME environment variable>>
+ version of Java <<change JAVA_HOME environment variable>>
when calling Maven, so it points to an instance of Java 6.0;
- * {{{http://maven.apache.org/}Maven 2.2 or 3}};
+ * {{{http://maven.apache.org/}Maven 2.2.1+ or 3}};
* {{{http://www.gnupg.org/}GnuPG}};
@@ -84,43 +92,7 @@ ssh [email protected]
Your <<<settings.xml>>> must be modified to allow deployment.
- This is the minimal configuration, obviously if you already have a
<<<settings.xml>>> file,
- you must edit it:
-
----------------------------
-<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>apache-site</id>
- <username>YOUR_APACHE_USERNAME</username>
- <filePermissions>664</filePermissions>
- <directoryPermissions>775</directoryPermissions>
- </server>
- <server>
- <id>apache.snapshots.https</id>
- <username>YOUR_APACHE_USERNAME</username>
- <password>YOUR_APACHE_PASSWORD</password>
- </server>
- <server>
- <id>apache.releases.https</id>
- <username>YOUR_APACHE_USERNAME</username>
- <password>YOUR_APACHE_PASSWORD</password>
- </server>
- </servers>
- <profiles>
- <profile>
- <id>release</id>
- <properties>
- <gpg.passphrase>YOUR_SECRET_PHRASE</gpg.passphrase>
- </properties>
- </profile>
- </profile>
- </profiles>
-</settings>
----------------------------
+ See
{{{http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env}Publishing
Maven Artifacts â Setup your development environment}}
Repeatable operations
@@ -132,6 +104,7 @@ Repeatable operations
you are preparing the release and type:
-----------------------------------
+mvn clean
mvn release:prepare -Dusername=YOUR_SVN_USER -Dpassword=YOUR_SVN_PASSWORD
-----------------------------------
@@ -151,14 +124,24 @@ mvn release:perform
It should compile and test everything, build and upload the artifacts and
the website for the project.
+ <<Troubleshooting>>: if upload of assemblies fails it can be done manually
with
+
+-----------------------------------
+cd target/checkout/assembly/target/assemblies/
+ssh [email protected] mkdir
/www/people.apache.org/builds/tiles/request/${version}/
+scp *
[email protected]:/www/people.apache.org/builds/tiles/request/${version}/
+-----------------------------------
+
* Close the staging repository
Login to {{{https://repository.apache.org} Nexus repository}} using your
Apache LDAP credentials.
Click on "Staging". Then click on "tiles" in the list of repositories.
+
In the panel below you should see an open repository that is linked to your
username and ip.
Right click on this repository and select "Close".
This will close the repository from future deployments and make it available
for others to view.
If you are staging multiple releases together, skip this step until you have
staged everything.
+
Enter the name and version of the artifact being released in the
"Description" field and then click "Close".
This will make it easier to identify it later.
@@ -258,33 +241,34 @@ three binding +1s and more +1s than -1s.
After a vote is finished, and it has been decided that is
<<at least of alpha quality>>, there is the need of a post-vote process.
-** Promote staged artifacts
+** Promote maven staged artifacts
- Once the release is deemed fit for public consumption it can be transfered
to a production repository where it will be available to all users.
+ Once the release is deemed fit for public consumption it can be transfered
to a
+ production repository where it will be available to all users.
Login to {{{https://repository.apache.org}Nexus repository}} again.
Click on "Staging" and then on the repository with id "tiles-staging".
- Find your closed staging repository, right click on it and choose "Promote".
- Select the "Releases" repository and click "Promote".
+ Find your closed staging repository, right click on it and choose "Release".
Next click on "Repositories", select the "Releases" repository
and validate that your artifacts exist as you expect them.
-** Move assemblies
+** Publish distribution artifacts
- * Move assemblies to the Apache distribution mirrors:
+ Move assemblies into the Apache
{{{http://www.apache.org/dev/release#when-to-archive}dist}} repository:
-------------------------------------------
-ssh [email protected]
-
-cd /www/people.apache.org/builds/tiles/request/${version}
-mkdir /www/www.apache.org/dist/tiles/request/v${version}/
-cp * /www/www.apache.org/dist/tiles/request/v${version}/
+svn co https://dist.apache.org/repos/dist/release/tiles
tiles-request-dist-releases
+mkdir tiles-request-dist-releases/v${version}
+cd tiles-request-dist-releases/v${version}
+scp
[email protected]:/www/people.apache.org/builds/tiles/request/${version}/*
.
+svn add .
+svn ci
-------------------------------------------
** Update the site
- * Wait 24 hours to let the mirror sync to the release and then update the
+ Wait 24 hours to let the mirror sync to the release and then update the
site. In particular you have to update the index and the download pages:
------------------------------------------------
@@ -295,8 +279,12 @@ https://svn.apache.org/repos/asf/tiles/s
Build and publish the site:
--------------------------------------
-mvn site
-mvn site:deploy
+mvn clean site site:stage
+mvn scm-publish:publish-scm
+# check staging website at target/scmpublish-checkout/index.html
+cd <tiles-site-checkout>/publish/tiles-request/
+svn merge ^/tiles/site/staging/tiles-request .
+svn ci
--------------------------------------
** Send announcement
@@ -310,7 +298,7 @@ Subject: [ANNOUNCE] Tiles Request ${vers
The Apache Request Tiles team is pleased to announce the release of Tiles
${version}
${quality}.
-Tiles Request ${version} is available in a binary and a source distribution.
+Available in binary and source distribution.
http://tiles.apache.org/download.html
Modified: tiles/request/trunk/src/site/xdoc/dev/building.xml
URL:
http://svn.apache.org/viewvc/tiles/request/trunk/src/site/xdoc/dev/building.xml?rev=1489384&r1=1489383&r2=1489384&view=diff
==============================================================================
--- tiles/request/trunk/src/site/xdoc/dev/building.xml (original)
+++ tiles/request/trunk/src/site/xdoc/dev/building.xml Tue Jun 4 10:49:01 2013
@@ -65,10 +65,10 @@
<li><p>checkout the site from the source repository:</p>
<p><source>svn co
http://svn.apache.org/repos/asf/tiles/site/</source></p></li>
<li><p>go into the site directory and type:</p>
- <p><source>mvn site</source></p></li>
+ <p><source>mvn clean site site:stage</source></p></li>
</ul>
<p>You will find the generated distribution under
- <code>{tiles-site-dir}/target/site</code>.</p>
+ <code>{tiles-site-dir}/target/staging</code>.</p>
</subsection>
<subsection name="Building the tiles-request website">
<p>To build a project's website:</p>
@@ -77,7 +77,7 @@
distribution, or checkout the latest version:</p>
<p><source>svn co
http://svn.apache.org/repos/asf/tiles/framework/trunk/tiles-request</source></p></li>
<li><p>go into the source directory and type:</p>
- <p><source>mvn site site:stage</source></p></li>
+ <p><source>mvn clean site site:stage</source></p></li>
</ul>
<p>You will find the generated website under:</p>
<ul>
