Alojamiento de un repositorio Maven en github

La mejor solución que he podido encontrar consiste en estos pasos:

1. Crea una rama llamada mvn-repo para alojar tus artefactos maven.
2. Usa el github site-maven-plugin para enviar tus artefactos a github.
3. Configure maven para usar su mvn-repo remoto como repositorio maven.

Hay varios beneficios al usar este enfoque:

• Los artefactos Maven se mantienen separados de su fuente en una rama separada llamada mvn-repo, al igual que las páginas de github, se mantienen en una rama separada llamada gh-pages (si usas páginas de github)
• A diferencia de otras soluciones propuestas, no entra en conflicto con su gh-pages si las está usando.
• Se vincula naturalmente con el destino deploy, por lo que no hay nuevos comandos maven que aprender. Simplemente use mvn deploy como lo haría normalmente

La forma típica de implementar artefactos en un repositorio maven remoto es usar mvn deploy, así que vamos a parchear en ese mecanismo para esto solución.

Primero, dile a maven que despliegue artefactos en una ubicación temporal dentro del directorio de destino. Añade esto a tu pom.xml:

<distributionManagement>
    <repository>
        <id>internal.repo</id>
        <name>Temporary Staging Repository</name>
        <url>file://${project.build.directory}/mvn-repo</url>
    </repository>
</distributionManagement>

<plugins>
    <plugin>
        <artifactId>maven-deploy-plugin</artifactId>
        <version>2.8.1</version>
        <configuration>
            <altDeploymentRepository>internal.repo::default::file://${project.build.directory}/mvn-repo</altDeploymentRepository>
        </configuration>
    </plugin>
</plugins>

Ahora intenta ejecutar mvn clean deploy. Verá que desplegó su repositorio maven en target/mvn-repo. El siguiente paso es conseguir que suba ese directorio a GitHub.

Agregue su información de autenticación a ~/.m2/settings.xml para que github site-maven-plugin pueda enviar a GitHub:

<!-- NOTE: MAKE SURE THAT settings.xml IS NOT WORLD READABLE! -->
<settings>
  <servers>
    <server>
      <id>github</id>
      <username>YOUR-USERNAME</username>
      <password>YOUR-PASSWORD</password>
    </server>
  </servers>
</settings>

(Como se ha indicado, asegúrese de chmod 700 settings.xml para asegurarse de que nadie puede leer su contraseña en el archivo. Si alguien sabe cómo hacer que site-maven-plugin solicite una contraseña en lugar de requerirla en un archivo de configuración, házmelo saber.)

Luego dile al GitHub site-maven-plugin sobre el nuevo servidor que acabas de configurar agregando lo siguiente a tu pom:

<properties>
    <!-- github server corresponds to entry in ~/.m2/settings.xml -->
    <github.global.server>github</github.global.server>
</properties>

Finalmente, configura el site-maven-plugin para cargar desde tu repositorio provisional temporal a tu rama mvn-repo en Github:

<build>
    <plugins>
        <plugin>
            <groupId>com.github.github</groupId>
            <artifactId>site-maven-plugin</artifactId>
            <version>0.11</version>
            <configuration>
                <message>Maven artifacts for ${project.version}</message>  <!-- git commit message -->
                <noJekyll>true</noJekyll>                                  <!-- disable webpage processing -->
                <outputDirectory>${project.build.directory}/mvn-repo</outputDirectory> <!-- matches distribution management repository url above -->
                <branch>refs/heads/mvn-repo</branch>                       <!-- remote branch name -->
                <includes><include>**/*</include></includes>
                <repositoryName>YOUR-REPOSITORY-NAME</repositoryName>      <!-- github repo name -->
                <repositoryOwner>YOUR-GITHUB-USERNAME</repositoryOwner>    <!-- github username  -->
            </configuration>
            <executions>
              <!-- run site-maven-plugin's 'site' target as part of the build's normal 'deploy' phase -->
              <execution>
                <goals>
                  <goal>site</goal>
                </goals>
                <phase>deploy</phase>
              </execution>
            </executions>
        </plugin>
    </plugins>
</build>

La rama mvn-repo no necesita existir, se creará para usted.

Ahora ejecute mvn clean deploy de nuevo. Debería ver maven-deploy-plugin "subir" los archivos a su repositorio local en el directorio de destino, luego site-maven-plugin confirmando esos archivos y enviándolos al servidor.

[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building DaoCore 1.3-SNAPSHOT
[INFO] ------------------------------------------------------------------------
...
[INFO] --- maven-deploy-plugin:2.5:deploy (default-deploy) @ greendao ---
Uploaded: file:///Users/mike/Projects/greendao-emmby/DaoCore/target/mvn-repo/com/greendao-orm/greendao/1.3-SNAPSHOT/greendao-1.3-20121223.182256-3.jar (77 KB at 2936.9 KB/sec)
Uploaded: file:///Users/mike/Projects/greendao-emmby/DaoCore/target/mvn-repo/com/greendao-orm/greendao/1.3-SNAPSHOT/greendao-1.3-20121223.182256-3.pom (3 KB at 1402.3 KB/sec)
Uploaded: file:///Users/mike/Projects/greendao-emmby/DaoCore/target/mvn-repo/com/greendao-orm/greendao/1.3-SNAPSHOT/maven-metadata.xml (768 B at 150.0 KB/sec)
Uploaded: file:///Users/mike/Projects/greendao-emmby/DaoCore/target/mvn-repo/com/greendao-orm/greendao/maven-metadata.xml (282 B at 91.8 KB/sec)
[INFO] 
[INFO] --- site-maven-plugin:0.7:site (default) @ greendao ---
[INFO] Creating 24 blobs
[INFO] Creating tree with 25 blob entries
[INFO] Creating commit with SHA-1: 0b8444e487a8acf9caabe7ec18a4e9cff4964809
[INFO] Updating reference refs/heads/mvn-repo from ab7afb9a228bf33d9e04db39d178f96a7a225593 to 0b8444e487a8acf9caabe7ec18a4e9cff4964809
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 8.595s
[INFO] Finished at: Sun Dec 23 11:23:03 MST 2012
[INFO] Final Memory: 9M/81M
[INFO] ------------------------------------------------------------------------

Visita github.com en su navegador, seleccione la rama mvn-repo y verifique que todos sus binarios estén ahora allí.

Felicitaciones!

Ahora puede desplegar sus artefactos maven al público de un hombre pobre repo simplemente ejecutando mvn clean deploy.

Hay un paso más que querrá tomar, que es configurar cualquier poms que dependa de su pom para saber dónde está su repositorio. Agregue el siguiente fragmento de código al pom de cualquier proyecto que dependa de su proyecto:

<repositories>
    <repository>
        <id>YOUR-PROJECT-NAME-mvn-repo</id>
        <url>https://raw.github.com/YOUR-USERNAME/YOUR-PROJECT-NAME/mvn-repo/</url>
        <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
        </snapshots>
    </repository>
</repositories>

Ahora cualquier proyecto que requiera tus archivos jar los descargará automáticamente desde tu repositorio github maven.

Editar: para evitar el problema mencionado en los comentarios ('Error creating commit: Invalid request. Para 'properties / name', nil no es una cadena.'), asegúrate de indicar un nombre en tu perfil en github.