Hébergement D'un dépôt Maven sur github

la meilleure solution que j'ai pu trouver consiste en ces étapes:

1. créez une branche appelée mvn-repo pour héberger vos artefacts maven.
2. utilisez le github site-maven-plugin pour pousser vos artefacts à github.
3. Configurer maven pour utiliser votre télécommande mvn-repo comme un référentiel.

Il y a plusieurs avantages à utiliser ce approche:

• les artefacts Maven sont conservés séparément de votre source dans une branche distincte appelée mvn-repo , un peu comme les pages github sont conservées dans une branche distincte appelée gh-pages (si vous utilisez les pages GitHub)
• contrairement à d'autres solutions proposées, elle n'entre pas en conflit avec votre gh-pages si vous les utilisez.
• est naturellement lié à la cible de déploiement de sorte qu'il n'y a pas de nouvelles commandes maven à apprendre. Juste utilisez mvn deploy comme vous le feriez normalement

la façon typique de déployer des artéfacts dans un repo Maven distant est d'utiliser mvn deploy , donc nous allons Patcher dans ce mécanisme pour cette solution.

tout d'abord, dites à maven de déployer des artéfacts dans un emplacement temporaire à l'intérieur de votre répertoire cible. Ajoutez ceci à votre 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>

essayez maintenant de lancer mvn clean deploy . Vous verrez qu'il a déployé votre repository maven target/mvn-repo . La prochaine étape est de télécharger le répertoire de GitHub.

Ajoutez vos informations d'authentification à ~/.m2/settings.xml pour que le github site-maven-plugin puisse pousser à 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>

(comme noté, s'il vous plaît assurez-vous de chmod 700 settings.xml pour s'assurer que personne ne peut lire votre mot de passe dans le fichier. Si quelqu'un sait comment rendre site-maven-plugin prompt pour un mot de passe au lieu de l'exiger dans un fichier de configuration, laissez-moi savoir.)

alors dites au GitHub site-maven-plugin à propos du nouveau serveur que vous venez de configurer en ajoutant ce qui suit à votre pom:

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

enfin, configurez le site-maven-plugin pour télécharger à partir de votre compte d'arrêt temporaire vers votre mvn-repo branche sur 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 branche mvn-repo n'a pas besoin d'exister, elle sera créée pour vous.

recommencez mvn clean deploy . Vous devriez voir maven-deploy-plugin" Uploader " les fichiers vers votre dépôt de mise en scène locale dans le répertoire cible, puis site-maven-plugin en commettant ces fichiers et en les poussant vers le serveur.

[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] ------------------------------------------------------------------------

visite github.com dans votre navigateur, sélectionnez la branche mvn-repo et vérifiez que tous vos binaires y sont maintenant.

félicitations!

vous pouvez maintenant déployer vos artéfacts maven dans la réserve publique d'un pauvre homme simplement en lançant mvn clean deploy .

il y a une autre étape que vous voulez faire, qui est de configurer tous les pom qui dépendent de votre pom pour savoir où se trouve votre dépôt. Ajoutez l'extrait suivant à la mop de tout projet qui dépend de votre projet:

<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>

maintenant tout projet qui nécessite vos fichiers jar les téléchargera automatiquement à partir de votre GitHub maven référentiel.

Edit: pour éviter le problème mentionné dans les commentaires ("Erreur de création de commettre: demande non Valide. Pour les "propriétés/nom', le néant n'est pas une chaîne.'), assurez-vous de l'état un nom dans votre profil sur github.