Hosting repozytorium Maven na GitHubie

Najlepsze rozwiązanie, jakie udało mi się znaleźć, składa się z następujących kroków:

1. Utwórz gałąź o nazwie mvn-repo do hostowania artefaktów Mavena.
2. użyj wtyczki github site-maven-plugin, aby wypchnąć swoje artefakty na github.
3. Skonfiguruj Mavena tak, aby używał zdalnego mvn-repo jako repozytorium Mavena.

Artefakty Mavena są przechowywane oddzielnie od Twojego źródła w oddzielnej gałęzi o nazwie]}, podobnie jak github pages są przechowywane w oddzielnej gałęzi o nazwie gh-pages (Jeśli używasz github pages)
• W przeciwieństwie do innych proponowanych rozwiązań, nie koliduje z Twoim gh-pages, jeśli ich używasz.
• łączy się naturalnie z celem wdrożenia, więc nie ma nowych poleceń Mavena do nauczenia się. Po prostu użyj mvn deploy tak, jak zwykle

Typowy sposób wdrażania artefaktów do zdalnego repo Mavena polega na użyciu mvn deploy, więc załączmy ten mechanizm w tym celu rozwiązanie.

Najpierw powiedz mavenowi, aby rozmieścił artefakty w tymczasowej lokalizacji wewnątrz katalogu docelowego. Dodaj to do swojego 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>

Teraz spróbuj uruchomić mvn clean deploy. Zobaczysz, że zainstalowało Twoje repozytorium maven do target/mvn-repo. Następnym krokiem jest wysłanie tego katalogu na GitHub.

Dodaj swoje informacje uwierzytelniające do ~/.m2/settings.xml, aby github site-maven-plugin mógł nacisnąć na 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>

(Jak wspomniano, upewnij się, że chmod 700 settings.xml aby upewnić się, że nikt może odczytać hasło w pliku. Jeśli ktoś wie, jak zrobić site-maven-plugin monit o hasło zamiast wymagać go w pliku konfiguracyjnym, daj mi znać.)

Następnie powiedz GitHub site-maven-plugin o nowym serwerze, który właśnie skonfigurowałeś, dodając do pom:

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

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

Gałąź mvn-repo nie musi istnieć, zostanie utworzona dla ty.

A teraz biegnij mvn clean deploy Jeszcze raz. Powinieneś zobaczyć maven-deploy-plugin "upload" pliki do lokalnego repozytorium w katalogu docelowym, a następnie site-maven-plugin zatwierdzający te pliki i pchający je na serwer.

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

Wizyta github.com w przeglądarce Wybierz gałąź mvn-repo i sprawdź, czy wszystkie pliki binarne już tam są.

Gratulacje!

Możesz teraz rozmieścić swoje artefakty maven dla biednego człowieka repo po prostu uruchamiając mvn clean deploy.

Jest jeszcze jeden krok, który musisz wykonać, to skonfigurować pomy, które zależą od Twojego pom, aby wiedzieć, gdzie znajduje się Twoje repozytorium. Dodaj następujący fragment do pom projektu, który zależy od Twojego projektu:

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

Teraz każdy projekt, który wymaga plików jar automatycznie pobierze je z repozytorium github maven.

Edit: aby uniknąć problemu wymienionego w komentarzach ('Error creating commit: Invalid request. Na 'properties / name', nil nie jest ciągiem znaków.'), upewnij się, że podałeś nazwę w swoim profilu na github.