From c7ed02121f7e5ea9d30fbd5e29a1fabb2d445c4b Mon Sep 17 00:00:00 2001 From: Oliver Gierke Date: Tue, 29 Jan 2013 19:11:47 +0100 Subject: [PATCH] Adapted assembly and Wagon plugin to automate distribution upload. Predefined necessary properties. Declared Wagon plugin to upload static resources and schemas. Declared additional ant run execution to upload distribution ZIP to S3. Disable standard deploy plugin. Updated read me accordingly. --- README.md | 24 +++- parent/pom.xml | 132 +++++++++++++++++- .../src/main/resources/ant/upload-dist.xml | 19 +++ 3 files changed, 166 insertions(+), 9 deletions(-) create mode 100644 resources/src/main/resources/ant/upload-dist.xml diff --git a/README.md b/README.md index 7254ba2e..afbbf6e2 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,9 @@ This repository contains common infrastructure to be used by Spring Data modules The parent project can be eased for either a single-module Maven project or a multi-module one. Each of the setups requires a slightly different setup of the project. -## General setup +## Project setup + +### General setup The parent project configures the following aspects of the project build: @@ -37,7 +39,9 @@ The following dependencies are pre-configured. - Test dependencies: JUnit / Hamcrest / Mockito - Dependency versions for commonly used dependencies -## Single project setup +The projects need to define a property `${schema.key}` to define the abbreviated key to be used for schema upload, e.g. `jpa` for `spring-data-jpa`. + +### Single project setup If the client project is a project consisting of a single project only all that needs to be done is declaring the parent project: @@ -49,25 +53,35 @@ If the client project is a project consisting of a single project only all that ``` -Be sure to adapt the version number to the latest release version. The second and already last step of the setup is to activate the assembly plugin in the build section: +Be sure to adapt the version number to the latest release version. The second and already last step of the setup is to activate the assembly and wagon plugin in the build section: ```xml org.apache.maven.plugins maven-assembly-plugin + + org.codehaus.mojo + wagon-maven-plugin + ``` As an example have a look at the build of [Spring Data JPA](http://github.com/SpringSource/spring-data-jpa). -## Multi project setup +### Multi project setup A multi module setup requires slightly more setup and some structure being set up. - The root `pom.xml` needs to configure the `project.type` property to `multi`. - Docbook documentation sources need to be in the root project. - The assembly needs to be build in a dedicated sub-module (e.g. `distribution`), declare the assembly plugin (see single project setup) in that submodule and reconfigure the `project.root` property in that module to `${basedir}/..`. +- Configure `${dist.id}` to the basic artifact id (e.g. `spring-data-mongodb`) as this will serve as file name for distribution artifacts, static resources etc. As an example have a look at the build of [Spring Data MongoDB](http://github.com/SpringSource/spring-data-mongodb). - +## Build configuration + +- Configure "Artifactory Maven 3" task +- Goals to execute `clean (dependency:tree) install` +- Configure "Alternative Maven Tasks and Options" to `clean (dependency:tree) install -Pdistribute` +- A nightly build can then use `clean (dependency:tree) deploy -Pdistribute` to publish \ No newline at end of file diff --git a/parent/pom.xml b/parent/pom.xml index f80830d1..dd24b756 100644 --- a/parent/pom.xml +++ b/parent/pom.xml @@ -85,7 +85,23 @@ single ${basedir} 1.5 - ${project.artifactId} + + ${project.artifactId} + ${project.name} + snapshot + dist.springframework.org + ${dist.id}-${project.version} + ${dist.assemblyName}.zip + ${project.build.directory}/${dist.assemblyName}-distribution.zip + ${project.version} + + + + + + + + 1.7.1 1.0 @@ -221,7 +237,7 @@ - + @@ -318,6 +334,18 @@ maven-antrun-plugin 1.7 + + + org.springframework.build + org.springframework.build.aws.ant + 3.0.6.RELEASE + + + org.jets3t + com.springsource.org.jets3t + 0.8.1 + + process-resources @@ -335,8 +363,24 @@ run + + upload-distribution + deploy + + run + + + + + + + + + + + @@ -359,12 +403,74 @@ ${shared.resources}/assemblies/distribution-${project.type}.xml - ${shared.resources}/assemblies/site.xml - + + ${dist.assemblyName} + + + + static + + single + + package + + + ${shared.resources}/assemblies/static-resources.xml + + static-resources + false + + + org.codehaus.mojo + wagon-maven-plugin + 1.0-beta-4 + + ${project.build.directory} + + + + + + + upload-schema + deploy + + upload + + + ${project.build.directory}/schemas + *.xsd + static-dot-s2 + scp://static.springsource.org + /var/www/domains/springsource.org/www/htdocs/autorepo/schema/${dist.id}/${project.version}/${schema.key} + true + + + + + + + upload-static-resources + deploy + + upload + + + ${project.build.directory}/static-resources + ** + static-dot-s2 + scp://static.springsource.org + /var/www/domains/springsource.org/www/htdocs/autorepo/docs/${dist.id}/${project.version} + true + + + + + @@ -446,6 +552,15 @@ + + + + org.apache.maven.wagon + wagon-ssh + 2.3 + + + @@ -509,6 +624,15 @@ + + org.apache.maven.plugins + maven-deploy-plugin + 2.7 + + true + + + diff --git a/resources/src/main/resources/ant/upload-dist.xml b/resources/src/main/resources/ant/upload-dist.xml new file mode 100644 index 00000000..e73f2d67 --- /dev/null +++ b/resources/src/main/resources/ant/upload-dist.xml @@ -0,0 +1,19 @@ + + + + + + + + + + + + + + + + +