Although I am using Maven for quite some time now over the last years I have never had the need to create my own archetype. Untill my current project. And luckily this is greatly simplified in Maven2.2.
The first thing to do is to create your 'base' module that you want to use as template for your other modules. When this is in place you simply go to the root of your base module and enter:
mvn archetype:create-from-project
After this has successfully completed you go to the directory 'target/generated-sources/archetype' and enter the command:
mvn install
And after that you can add the archetype to the catalog in your local repository with the command:
mvn deploy

In our project we are working with Artifactory as repository manager, so the next step is to add the archetype catalog to this repository so the rest of the team can use it too. Unfortunately this isn't a standard feature (yet) in Artifactory so you will need to perform the following steps to achieve this:

  • Go to the directory in which the local archetype catalog can be found (something like /Users/name/.m2/ on the Mac)
  • Perform the command

    curl -u username:password -f -d @archetype-catalog.xml -X PUT "http://artifactory-server:8888/artifactory/libs-releases-local/archetype-catalog.xml"

    Here username and password are the credentials you use to login to your Artifactory instance

Now the archetype is ready to be used. To make use of it you can either:

  • Add the catalog to use as parameter in the command:
    mvn archetype:generate -DarchetypeCatalog=http://artifactory-server:8888/artifactory/libs-releases-local/

    • or

  • Define it in the plugin of the parent pom:

    PLAIN TEXT
    XML:
    1. <plugin>
    2.   <groupId>org.apache.maven.plugins</groupId>
    3.   <artifactId>maven-archetype-plugin</artifactId>
    4.   <version>2.0-alpha-4</version>
    5.   <configuration>
    6.     <archetypeCatalog>http://artifactory-server:8888/artifactory/libs-releases-local/</archetypeCatalog>
    7.   </configuration>
    8. </plugin>

    and then simply use:
    mvn archetype:generate