Comment publier une lib sur les repo maven centraux a travers un exemple : swagger-ui-integration

4. Publier sur
un repo central

5. /**
* @author François Robert
*/
public class PtitbobAtToursJug {
public static void main(String... args) {
System.out.println("Hello everybody");
}
public Twitter getTwitter() {
return new Twitter("@ptitbob");
}
public URL getGithub() throws MalformedURLException {
return new URL("github.com/ptitbob");
}
}

6. Pourquoi ?
Lib qui n’existe pas
Idée du siècle
Plugin maven
complexe Iznogoud

7. Lib qui n’existe pas
Swagger UI+Swagger
= Swagger-UI-Integration
@SwaggerUIConfiguration
public class ApplicationConfiguration {
}

11. • Coordonnées
• Description du projet
• La signature
• La licence
• Le(s) développeur(s)
• Informations de repo de source

12. Ce qu’il ne faut pas faire
• Intégrer un repository (autres que défaut)
• Intégrer des lib non libre
• Lib ayant une licence moins permissive

13. • Coordonnées
• Description du projet
• La signature
• La licence
• Le(s) développeur(s)
• Informations de repo de source

14. <groupId>org.shipstone</groupId>
<artifactId>swagger-ui-integration</artifactId>
<version>1.0</version>
Coordonnées du projet
Sources Javadoc

15. Coordonnées == choix du nom de package de base
Nom de domaine
domain.fr
fr.domain……

16. Coordonnées == choix du nom de package de base
Repo github
com.github.ptitbob

17. • Coordonnées
• Description du projet
• La signature
• La licence
• Le(s) développeur(s)
• Informations de repo de source

18. Descriptif du projet
<url>https://github.com/ptitbob/swagger-ui-integration</url>
<name>swagger-ui-integration</name>
<description>Swagger core and UI integration effortless for JavaEE application</description>

19. • Coordonnées
• Description du projet
• La signature
• La licence
• Le(s) développeur(s)
• Informations de repo de source

20. Disposer d’une clé PGP
Installation de gnupg2
Générer une clé
Enregistrer la clé publique
http://pgp.mit.edu
gpg2 --gen-key

21. Signature des jars
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-gpg-plugin</artifactId>
<version>1.6</version>
<configuration>
</configuration>
<executions>
<execution>
<id>sign-artifacts</id>
<phase>verify</phase>
<goals>
<goal>sign</goal>
</goals>
</execution>
</executions>
</plugin>
-rw-r--r--+ 1 francois staff 885K 22 mar 00:24 swagger-ui-integration-1.0-javadoc.jar
-rw-r--r--+ 1 francois staff 885K 22 mar 00:24 swagger-ui-integration-1.0-javadoc.jar.asc
-rw-r--r--+ 1 francois staff 20K 22 mar 00:24 swagger-ui-integration-1.0-sources.jar
-rw-r--r--+ 1 francois staff 20K 22 mar 00:24 swagger-ui-integration-1.0-sources.jar.asc
-rw-r--r--+ 1 francois staff 805K 22 mar 00:24 swagger-ui-integration-1.0.jar
-rw-r--r--+ 1 francois staff 473B 22 mar 00:24 swagger-ui-integration-1.0.jar.asc
-rw-r--r--+ 1 francois staff 11K 22 mar 00:24 swagger-ui-integration-1.0.pom
-rw-r--r--+ 1 francois staff 473B 22 mar 00:24 swagger-ui-integration-1.0.pom.asc

22. Ne mettez pas votre
passphrase
dans le pom !!!

23. Préférez settings.xml
<profiles>
<profile>
<id>ossrh</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<gpg.executable>gpg2</gpg.executable>
<gpg.passphrase>MaSuperPhraseCodée</gpg.passphrase>
<gpg.keyname>Clé.Publique</gpg.keyname>
</properties>
</profile>
</profiles>

24. • Coordonnées
• Description du projet
• La signature
• La licence
• Le(s) développeur(s)
• Informations de repo de source

25. Licence ?
Laquelle ?!!!!

27. LGPL
Licence publique générale limitée GNU
<licenses>
<license>
<name>GNU LESSER GENERAL PUBLIC LICENSE version 3</name>
<url>http://www.gnu.org/licenses/lgpl-3.0.fr.html</url>
</license>
</licenses>

28. • Coordonnées
• Description du projet
• La signature
• La licence
• Le(s) développeur(s)
• Informations de repo de source

29. <developers>
<developer>
<name>Francois Robert</name>
<email>francois.robert@shipstone.org</email>
<url>http://www.shipstone.org</url>
<timezone>Europe/Paris</timezone>
<roles>
<role>Developer</role>
</roles>
</developer>
</developers>
Le(s) développeur(s)
Utilisé pour la signature

30. • Coordonnées
• Description du projet
• La signature
• La licence
• Le(s) développeur(s)
• Informations de repo de source

31. Repo de source….
<scm>
<url>https://github.com/ptitbob/swagger-ui-integration</url>
<connection>scm:git:git@github.com:ptitbob/swagger-ui-integration.git</connection>
<developerConnection>scm:git:git@github.com:ptitbob/swagger-ui-integration.git</developerConnection>
</scm>

32. Demande de publication
http://issues.sonatype.org
Open Source Software Repository Hosting (OSSRH)

33. Demande de publication
Il en existe d’autres
• Apache Software Foundation (for all Apache projects)
• FuseSource Forge (focused on FUSE related projects)
• nuiton.org
• …

34. Créez vous un compte
Création de demande
Demande de publication

35. Demande de publication
Community Support - Open Source Project Repository Hosting (OSSRH)
Nouveau projet
Le projet en une phrase
Courte description

36. Demande de publication
Le groupId choisi
Site de description ou lien vers le README
L’URL (github ou bitbucket)
Login Sonatype

37. Demande de publication
Demandedéposéele05/03

38. Demande de publication
… 2 jours plus tard :

39. Demande de publication
<distributionManagement>
<snapshotRepository>
<id>ossrh</id>
<url>https://oss.sonatype.org/content/repositories/snapshots</url>
</snapshotRepository>
<repository>
<id>ossrh</id>
<url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
</repository>
</distributionManagement>
Repo de vérification avant publication
Intégration des repository dédiés

40. Configuration de la release
Utilisation du plugin Release
Utilisation du plugin Nexus

41. Configuration de la release
Utilisation du plugin Release
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-release-plugin</artifactId>
<version>2.5.3</version>
<configuration>
<tagNameFormat>v@{project.version}</tagNameFormat>
<autoVersionSubmodules>true</autoVersionSubmodules>
<useReleaseProfile>false</useReleaseProfile>
<releaseProfiles>release</releaseProfiles>
<goals>deploy</goals>
</configuration>
</plugin>

42. Configuration de la release
Utilisation du plugin Release
mvn clean install release:clean release:prepare
Création d’un tag de version

43. Configuration de la release
Un petit plus…

44. Utilisation du plugin Nexus
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<version>1.6.3</version>
<extensions>true</extensions>
<configuration>
<serverId>ossrh</serverId>
<nexusUrl>https://oss.sonatype.org/</nexusUrl>
<autoReleaseAfterClose>true</autoReleaseAfterClose>
</configuration>
</plugin> <servers>
<server>
<id>ossrh</id>
<username>ptitbob</username>
<password>[password]</password>
</server>
</servers>
pom.xml
settings.xml
Configuration de la release

45. Publication de la release
En 2 temps
mvn clean install release:clean release:prepare1
mvn -Prelease clean install gpg:sign
nexus-staging:deploy
2
Se placer dans le tag généré

47. Publication de la release

48. Publication de la release

50. http://fr.slideshare.net/francoisrobert/toursjug-anniversaire-2016