Publicación de un plugin en un repositorio Maven

Para que los plugins desarrollados puedan ser reutilizados en otros desarrollos, ya sean propios o de terceras partes, es necesario subirlos a un repositorio Maven. Para ello modificaremos dos ficheros:

  • El pom.xml de nuestro plugin
  • El fichero de configuración settings.xml de Maven

Un repositorio Maven es una estructura de directorios que contiene los plugins y sus dependencias organizados por groupId y artifactId. El repositorio principal de Maven se encuentra en http://central.maven.org/maven2/ y contiene las librerías de uso general. Para los plugins y las librerías más específicas del portal REDD, FAO pone a disposición el servidor maven.nfms4redd.org. Es este servidor el que podemos utilizar para subir nuestro plugin a un sitio accesibile.

Si hemos desarrollado un plugin, seguro que tenemos Maven ya configurado para que se descargue las dependencias del portal del repositorio de FAO. Pero ahora habrá que configurarlo para que, además de descargar los plugins, pueda subirlos.

Para subir los plugins al repositorio de FAO hay que utilizar el servicio ftp://maven.nfms4redd.org/repo. Esto se configura en el pom.xml de nuestro plugin mediante dos elementos. El primero es un elemento dentro de <build> que dice a Maven que vamos a acceder por FTP:

<build>
        <extensions>
                <extension>
                        <groupId>org.apache.maven.wagon</groupId>
                        <artifactId>wagon-ftp</artifactId>
                        <version>2.3</version>
                </extension>
        </extensions>
</build>

El segundo le dice a Maven la URL del servidor:

<distributionManagement>
        <repository>
                <id>nfms4redd</id>
                <url>ftp://maven.nfms4redd.org/repo</url>
                <uniqueVersion>false</uniqueVersion>
        </repository>
</distributionManagement>

Como no queremos compartir el usuario y contraseña para acceder al FTP, lo que hacemos es especificar sólo un identificador, en este caso nfms4redd, al que haremos referencia desde el fichero de configuración de Maven settings.xml para asignar a ese id el usuario y contraseña. El fichero settings.xml se encuentra en el directorio .m2 del “HOME” del usuario:

../_images/settings.xml.png

En dicho fichero, crearemos un elemento server con el mismo identificador que el especificado en el pom.xml del plugin. Y en ese elemento pondremos el usuario y contraseña.

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                          http://maven.apache.org/xsd/settings-1.0.0.xsd">
        <servers>
                <server>
                        <id>nfms4redd</id>
                        <username>XXXXX</username>
                        <password>XXXXX</password>
                </server>
        </servers>

</settings>

Una vez la configuración está terminada, es necesario pedir a Maven que ejecute la tarea (goal) deploy.

Warning

Es posible que la ejecución de Maven falle si se ejecuta desde Eclipse y tenemos configurado sólo un JRE y no un JDK. En tal caso la solución es simple: instalar un JDK y utilizarlo por defecto.