Introduction

This document gives step-by-step instructions for deploying the Maven current references. The primary audience is Maven PMC.

Prerequisite

Be sure that:

  • you have all Maven servers defined in your settings.xml. For more information, please refer to Committer settings.
  • you have created your GPG keys. For more information, please refer to Making GPG Keys.

Deploy Maven Current References

  1. Do a fresh check out of a release tag of Maven, for example:
    $ svn checkout https://svn.apache.org/repos/asf/maven/maven-2/tags/maven-2.2.0 maven-2.2.0
    
  2. Execute the site goal for the maven-2.2.0 project
    maven-2.2.0$ mvn site -Preporting
    
  3. Verify the documentation before deploying

    You could also use the stage goal of the Maven Site Plugin to verify the site output. For instance:

    maven-2.2.0$ mvn site:stage -Preporting -DstagingDirectory=/tmp/maven-2.2.0
    
  4. Deploy to people.apache.org
    maven-2.2.0$ mvn site-deploy -Preporting
    

    It will create a new folder 2.2.0 in /www/maven.apache.org/ref/ on the Apache server.

    Note: It will take an hour or so to sync.

Information on /ref/current mechanism

The redirection from /ref/current to actual Maven version reference is done through .htaccess published in site.