Najlepsze rozwiązanie, jakie udało mi się znaleźć, składa się z następujących kroków:
- Utwórz gałąź nazywaną
mvn-repo
do przechowywania artefaktów raju.
- Użyj wtyczki github site-maven-plug, aby wypchnąć swoje artefakty do github.
- Skonfiguruj maven, aby używał twojego pilota
mvn-repo
jako repozytorium maven.
Korzystanie z tego podejścia ma kilka zalet:
- Artefakty Maven są trzymane oddzielnie od źródła w oddzielnej gałęzi o nazwie
mvn-repo
, podobnie jak strony github są przechowywane w osobnej gałęzi o nazwie gh-pages
(jeśli używasz stron github)
- W przeciwieństwie do niektórych innych proponowanych rozwiązań, nie koliduje z twoim,
gh-pages
jeśli ich używasz.
- Naturalnie łączy się z celem rozmieszczania, więc nie ma nowych poleceń do nauki. Po prostu używaj
mvn deploy
jak zwykle
Typowym sposobem rozmieszczania artefaktów w zdalnym repozytorium maven jest użycie mvn deploy
, więc załatajmy ten mechanizm dla tego rozwiązania.
Najpierw powiedz maven, aby rozmieścił artefakty w tymczasowej lokalizacji przemieszczania w katalogu docelowym. Dodaj to do 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 wdrożył twoje repozytorium maven do target/mvn-repo
. Następnym krokiem jest pobranie tego katalogu do GitHub.
Dodaj informacje uwierzytelniające, aby ~/.m2/settings.xml
github site-maven-plugin
mógł przesyłać do 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, pamiętaj, aby upewnić się, chmod 700 settings.xml
że nikt nie może odczytać Twojego hasła w pliku. Jeśli ktoś wie, jak poprosić wtyczkę site-maven o podanie hasła 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>
Na koniec skonfiguruj site-maven-plugin
przesyłanie z tymczasowego repozytorium przemieszczania do swojego mvn-repo
oddziału w 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>
mvn-repo
Oddział nie musi istnieć, to zostanie utworzony dla Ciebie.
Teraz uruchom mvn clean deploy
ponownie. Powinieneś zobaczyć maven-deploy-plugin „upload” plików do lokalnego repozytorium przemieszczania w katalogu docelowym, a następnie wtyczkę site-maven zatwierdzającą te pliki i wypychającą 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] ------------------------------------------------------------------------
Wejdź na github.com w przeglądarce, wybierz mvn-repo
oddział i sprawdź, czy wszystkie Twoje pliki binarne już tam są.
Gratulacje!
Teraz możesz rozmieścić swoje artefakty z raju w publicznym repozytorium biedaka, po prostu biegając mvn clean deploy
.
Jest jeszcze jeden krok, który chcesz zrobić, a mianowicie skonfigurować wszystkie poms, które zależą od pom, aby wiedzieć, gdzie jest twoje repozytorium. Dodaj następujący fragment kodu do pom pom projektu zależnego od projektu:
<repositories>
<repository>
<id>YOUR-PROJECT-NAME-mvn-repo</id>
<url>https://github.com/YOUR-USERNAME/YOUR-PROJECT-NAME/raw/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.
Edytuj: aby uniknąć problemu wymienionego w komentarzach („Błąd podczas tworzenia zatwierdzenia: nieprawidłowe żądanie. W przypadku„ właściwości / nazwa ”zero nie jest łańcuchem.”), Upewnij się, że podałeś nazwę w swoim profilu na github.