Mavenpom-commits

Download

mavenpom-commits@list.nuiton.org

April 2012

2 participants
27 discussions

r1243 - in trunk: . mavenpomdoc/src/site
by tchemit＠users.nuiton.org 21 Apr '12

21 Apr '12

Author: tchemit Date: 2012-04-21 20:47:42 +0200 (Sat, 21 Apr 2012) New Revision: 1243 Url: http://nuiton.org/repositories/revision/mavenpom/1243 Log: refs #2060: Introduce new module (mavenpomdoc) for documentation of mavenpom (remove breadcrumbs to messy) Modified: trunk/mavenpomdoc/src/site/site.xml trunk/pom.xml Modified: trunk/mavenpomdoc/src/site/site.xml =================================================================== --- trunk/mavenpomdoc/src/site/site.xml 2012-04-20 08:59:10 UTC (rev 1242) +++ trunk/mavenpomdoc/src/site/site.xml 2012-04-21 18:47:42 UTC (rev 1243) @@ -53,9 +53,9 @@ <body> - <breadcrumbs> +  <links> <item name="chorem.org" href="http://www.chorem.org"/> Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-04-20 08:59:10 UTC (rev 1242) +++ trunk/pom.xml 2012-04-21 18:47:42 UTC (rev 1243) @@ -268,7 +268,7 @@ <licensePluginVersion>1.0</licensePluginVersion> <tomcatPluginVersion>2.0-beta-1</tomcatPluginVersion> <versionsPluginVersion>1.3.1</versionsPluginVersion> - <wagonPluginVersion>1.0-beta-3</wagonPluginVersion> + <wagonPluginVersion>1.0-beta-4</wagonPluginVersion> <webstartPluginVersion>1.0-beta-3</webstartPluginVersion>  @@ -277,7 +277,7 @@  <androidPluginVersion>2.8.4</androidPluginVersion> - <jettyPluginVersion>8.1.2.v20120308</jettyPluginVersion> + <jettyPluginVersion>8.1.3.v20120416</jettyPluginVersion> <statScmPluginVersion>1.2.0</statScmPluginVersion>  @@ -292,7 +292,7 @@ <commonsCollectionsVersion>3.2.1</commonsCollectionsVersion> <commonsEmailVersion>1.2</commonsEmailVersion> <commonsHttpclientVersion>3.1</commonsHttpclientVersion> - <commonsIoVersion>2.2</commonsIoVersion> + <commonsIoVersion>2.3</commonsIoVersion> <commonsJxpathVersion>1.3</commonsJxpathVersion> <commonsLangVersion>2.6</commonsLangVersion> <commonsLang3Version>3.1</commonsLang3Version>

1 0

r1242 - in trunk: . mavenpom4labs mavenpom4redmine mavenpom4redmine/mavenpom4redmineAndCentral mavenpomdoc/src/site mavenpomdoc/src/site/apt mavenpomdoc/src/site/apt/mavenpom mavenpomdoc/src/site/resources src/site/resources
by tchemit＠users.nuiton.org 20 Apr '12

20 Apr '12

Author: tchemit Date: 2012-04-20 10:59:10 +0200 (Fri, 20 Apr 2012) New Revision: 1242 Url: http://nuiton.org/repositories/revision/mavenpom/1242 Log: fixes #2058: Remove mavenpom site descriptors refs #2060: Introduce new module (mavenpomdoc) for documentation of mavenpom Added: trunk/mavenpomdoc/src/site/apt/index.apt.vm trunk/mavenpomdoc/src/site/apt/mavenpom/ trunk/mavenpomdoc/src/site/apt/mavenpom/index.apt trunk/mavenpomdoc/src/site/apt/mavenpom/profiles.apt trunk/mavenpomdoc/src/site/apt/mavenpom/properties.apt.vm trunk/mavenpomdoc/src/site/apt/mavenpom/release.apt trunk/mavenpomdoc/src/site/apt/mavenpom/repositories.apt trunk/mavenpomdoc/src/site/resources/announcement/ Removed: trunk/mavenpom4labs/src/ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/ trunk/mavenpom4redmine/src/ trunk/mavenpomdoc/src/site/apt/index.apt trunk/mavenpomdoc/src/site/apt/profiles.apt trunk/mavenpomdoc/src/site/apt/properties.apt.vm trunk/mavenpomdoc/src/site/apt/release.apt trunk/mavenpomdoc/src/site/apt/repositories.apt trunk/src/site/resources/announcement/ Modified: trunk/mavenpomdoc/src/site/site.xml trunk/pom.xml Deleted: trunk/mavenpomdoc/src/site/apt/index.apt =================================================================== --- trunk/mavenpomdoc/src/site/apt/index.apt 2012-04-19 16:39:07 UTC (rev 1241) +++ trunk/mavenpomdoc/src/site/apt/index.apt 2012-04-20 08:59:10 UTC (rev 1242) @@ -1,345 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2009 - 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Maven nuiton pom ------- ------- -2009-08-22 ------- - -Présentation - - Le projet <mavenpom> est un pom de type <Corporate> dont héritent tous les - projets {{{http://www.codelutin.com}code Lutin}}. - - -* Nouveautés de la version 3.1 - -** Changement du maven-helper-plugin - - Depuis la version 1.4, maven-helper-plugin devien helper-maven-plugin (tout du - moins son GAV). Le site du projet reste bien (pour le moment) - {{http://maven-site.nuiton.org/maven-helper-plugin}}. - -* Nouveautés de la version 3.0.3 - -** Correction des déployements de site - - La version 3.0.3 corrige les problèmes suite au passage sur le - maven-site-plugin 3.0. - - L'héritage des définitions de site ne fonctionne plus, on ne peut donc plus - gérer cela au niveau de mavenpom et ses fils. - - Il faut donc dans chaque projet client ajouter ceci : - --------------------------------------------------------------------------------- - <distributionManagement> - <site> - <id>${platform}</id> - <url>${our.site.repository}/${projectId}</url> - </site> - </distributionManagement> --------------------------------------------------------------------------------- - - Les variables *site.repository* et *site.server* ne sont donc plus utiliséees et - sont supprimées sauf pour les projets héritants du mavenpom4labs. - -** Déployements via nexus (plutôt que par ssh) - - On utilise désormais le déployement en http via nexus. - - Il faut donc avoir un nouveau server dans son settings.xml - --------------------------------------------------------------------------------- -  - <server> - <id>nuiton-nexus-deploy</id> - <username>deployment</username> - <password>{le mot de passe qui va bien :)}</password> - </server> --------------------------------------------------------------------------------- - -* Nouveautés de la version 3.0 - - La version 3.0 survient avec une nouvelle forge http://forge.codelutin.com - - Cette forge est basée sur redmine et cela a nécessité du coup de revoir - légèrement l'utilisation de la variable <<platform>> et des serveurs dans le - <<settings.xml>>. - -** Modification du settings.xml - - Il faut donc ajouter les serveurs suivants (dans le <<settings.xml>>) : - -------------------------------------------------------------------------------- -  - <server> - <id>nuiton.org</id> - <username>publish</username> - <filePermissions>664</filePermissions> - <directoryPermissions>775</directoryPermissions> - </server> - - -  - <server> - <id>chorem.org</id> - <username>publish</username> - <filePermissions>664</filePermissions> - <directoryPermissions>775</directoryPermissions> - </server> - -  - <server> - <id>forge.codelutin.com</id> - <username>publish</username> - <filePermissions>664</filePermissions> - <directoryPermissions>775</directoryPermissions> - </server> - -  - <server> - <id>labs.libre-entreprise.org</id> - <username>votre login sur le labs</username> - <filePermissions>664</filePermissions> - <directoryPermissions>775</directoryPermissions> - </server> - -  - <server> - <id>redmine-forge.codelutin.com</id> - <username>votre login sur le redmine forge.codelutin.com </username> - <password>{votre password encodé sur forge.codelutin.com}</password> - </server> - -------------------------------------------------------------------------------- - -** Migration des projets - - En théorie, rien à faire tout reste compatible sauf pour les projets - utilisant mavenpom4labs. - - Il faut désormais rajouter la section de définition du server de site car - cela ne fonctionne plus très bien depuis le passage sur le maven-site-plugin 3. - -* Nouveautés de la version 2.5 - - Depuis la version <<2.5>>, chaque librairie ou plugin utilisé dans le mavenpom - ou un de ses fils est configurable via une propriété, il s'agit d'une - généralisation de ce qui était déjà fait sur nos propres plugins et les - librairies. - - Cela permet de pouvoir dans un projet utilisant un des mavenpom de pouvoir - changer les versions de librairies ou plugins sans avoir à redéfinir les - dépendances. - - -** Mise à jour plugins - - * {{{http://maven-site.nuiton.org/maven-helper-plugin}maven-helper-plugin 1.2.11}} - - * {{{http://maven-site.nuiton.org/jrst}jrst 1.2}} - - * {{{http://maven.apache.org/plugins/maven-plugin-plugin/}maven-plugin-plugin 2.7}} - - * {{{http://maven.apache.org/plugins/maven-changes-plugin/}maven-changes-plugin 2.4}} - -* Nouveautés de la version 2.4 - - Depuis la version <<2.4>>, on introduit on gère les librairies les plus souvent - utilisées dans nos projets et ceci pour éviter de repasser dans les poms : c'est - plus facile de changer de mavenpom que de changer les versions dans chaque projet. - - Voir la page des propriétés pour connaitre toutes les librairies connues au - niveau du mavenpom. - - On a aussi renommer toutes les propriétés de versin en utilisant le <camelStyle> - pour faire comme les petits copains de chez Maven. Par exemple <maven.version> - devient <mavenVersion>. - - On a ajouté un profile <analyze-dependencies> qui est automatiquement déclanché - lors d'une release pour vérifier la consistance des dépendances d'un projet. - - Pour le reste, c'est {{{http://nuiton.org/versions/show/198}ici}}. - -* Nouveautés de la version 2.3 - - Depuis la version <<2.3>>, un nouveau type de pom nommé - du <<mavenpom4redmineAndCentral>> pour tous les projets déployés sur redmine - et synchronisés sur Maven central. - - Il hérite du <mavenpom4redmine> et rajoute la configuration pour que cela soit - déployé sur maven central. - - Pour plus d'informations, voir la page de - {{{./mavenpom4redmineAndCentral/index.html} de mavenpom4redmineAndCentral}}. - -* Nouveautés de la version 2.2.2 - -** Simplification des noms de dépôts - - On a supprimé <<nuiton->> de tous les noms de dépôts de release - -** Configuration central-safe améliorée - - La configuration <<central-safe>> a été améliorée, il s'agit désormais d'un - {{{./profiles.html#central_safe}profile central-safe}} qui n'est pas activé - lors d'une release. - - Les projets <<central-safe>> modifie la configuration du <<plugin release>> - pour inclure explicitement ce profile et en <<prepare>> et en <<perform>>. - -** Mise à jour plugins - - * {{{http://maven-site.nuiton.org/maven-helper-plugin}maven-helper-plugin 1.2.6}} - - * {{{http://maven-site.nuiton.org/maven-license-plugin/fr}maven-license-plugin 2.3.1}} - -* Nouveautés de la version 2.2.1 - - Depuis la version <<2.2.1>> on utilise - {{{http://maven-site.nuiton.org/maven-license-plugin/fr}maven-license-plugin 2.3}}. - - Cela permet d'améliorer la qualité des fichiers THIRD-PARTY générés - (dépendances sans license, licenses dupliquées,...). - - On a aussi dans cette version de <mavenpom> ajouté une configuration pour permettre - en phase de préparation de release (<release:prepare>) d'activer les profiles - de releases afin de pouvoir détecter d'éventuelles problèmes avant le tag svn. - -* Nouveautés de la version 2.2 - - Depuis la version <<2.2>> on a amélioré la configuration des serveurs de - déployement et introduit la notion de projet <<central-safe>>. - - Un tel projet répond aux pré-requis d'un projet synchronisable sur {{{http://repo1.maven.org/maven2}central}} : - - * avoir un pom de bonne qualité (informations scm, url, license, ...) - - * être auto-conteneur (pas besoin d'autre dépôts que central) - - * être signé via gpg - - * javadoc et sources disponibles - - [] - - Pour plus d'informations, voir la page de {{{./repositories.html}configuration des serveurs}}. - -Les propriétés - - Voir la page des {{{./properties.html}propriétés}}. - -Les profiles - - Mavenpom définit un certain nombre de profiles. Certains sont dédiés - exclusivement à la préparation de releases, tandis que d'autres permettent de - réaliser certaines tâches pendant le développement (mise à jour des entêtes - des fichiers sources par exemple). - - La page des {{{./profiles.html}profiles}} décrit l'ensemble des profiles. - -Vérification de conformité - - On effectue sur le pom des contrôles de conformités via le plugin - <maven-enforcer-plugin>. - -* propriétés obligatoires - - Aucune à l'heure actuelle - -* Fichiers obligatoires - --------------------------------------------------------------------------------- -README.txt -changelog.txt -LICENSE.txt --------------------------------------------------------------------------------- - -Configuration des plugins - - Mavenpom fixe les versions d'un certain nombre de plugins et ceci pour - plusieurs raisons : - - * la <reproductibilité> : en effet, si on ne fixe pas les versions des plugins - on s'expose d'un build à l'autre à ne pas utiliser la même version des - plugins, et donc dans le temps on ne peut pas garantir que le build d'un - projet sera exactement le même. Ceci est une préconisation de <<maven>>. - - * l'<uniformisation> : le fait de fixer le plus grand nombre de versions de - plugin permet aussi de faire profiter à tous les projets héritant de - <<mavenpom>> d'une certaine stabilité et de faire profiter à tous des - dernières versions des plugins testées. - - * un dernier point intéressant est le fait que si on utilise correctement - <<mavenpom>>, on ne doit pas à avoir à gérer les versions des plugins hormis - les exceptions citées dans la section suivante. - -* Les plugins configurés dans mavenpom - - On distingue deux types de plugins : - - * les plugins <<internes>> que nous produisont - (et donc qui dépendent de <<mavenpom>>). - - * les plugins <<externes>> (ceux d'apache, codehaus, plexus,...) qui ne - dépendent pas de <<mavenpom>> - -** Plugins internes - - Nos plugins ne doivent pas être décrit dans <<mavenpom>> et ceci pour la - simple raison que nos propres plugins utilisent <<mavenpom>>, 3 exceptions - existent cependant : - - * <<maven-helper-plugin>> : il est utilisé pour construire les releases - - * <<maven-jredmine-plugin>> : aussi utilisé pour construire les releases - - * <<maven-license-plugin>> : utilisé dans les profiles de mises à jour des - entêtes de licenses. - - [] - - Tous nos autres plugins ne sont pas référencés ici et doivent donc être - entièrement définies (version + configuration) dans vos pom. - -** Plugin externes - - Pour tout plugin dit externe, il peut être référencé dans <<mavenpom>>. - -** Bonnes pratiques sur l'utilisant d'un plugin externe dans votre pom - - Avant de vouloir utiliser un nouveau plugin dans votre pom, consulter en - premier la page des {{{./plugin-management.html}plugins}} connus par <<mavenpom>>. - - Si le plugin est connu, alors pas de question à se poser, on peut l'utiliser - sans spécifier sa version utilisant celle définit dans <<mavenpom>>. - - Si le plugin n'existe pas, faites une demande d'évolution sur le projet - <<mavenpom>>, il sera rapidemment ajouté et vous pourrez l'utiliser en vous - plaçant sur la dernière snapshot de <<mavenpom>>. - Copied: trunk/mavenpomdoc/src/site/apt/index.apt.vm (from rev 1241, trunk/mavenpomdoc/src/site/apt/index.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/index.apt.vm (rev 0) +++ trunk/mavenpomdoc/src/site/apt/index.apt.vm 2012-04-20 08:59:10 UTC (rev 1242) @@ -0,0 +1,262 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Maven nuiton pom +------ +------ +2009-08-22 +------ + +Présentation + + Le projet mavenpomdoc regroupe la documentation du projet mavenpom et de tous + ses petits copains. + + Voir la documentation du + + - {{{./mavenpom/index.html}mavenpom ${project.version}}} + + - {{{./mavenpom4redmine/index.html}mavenpom4redmine ${project.version}}} + + - {{{./mavenpom4redmineAndCentral/index.html}mavenpom4redmineAndCentral ${project.version}}} + + - {{{./mavenpom4labs/index.html}mavenpom4labs ${project.version}}} + +Nouveautés + +* Nouveautés de la version 3.1 + +** Changement du maven-helper-plugin + + Depuis la version 1.4, maven-helper-plugin devien helper-maven-plugin (tout du + moins son GAV). Le site du projet reste bien (pour le moment) + {{http://maven-site.nuiton.org/maven-helper-plugin}}. + +* Nouveautés de la version 3.0.3 + +** Correction des déployements de site + + La version 3.0.3 corrige les problèmes suite au passage sur le + maven-site-plugin 3.0. + + L'héritage des définitions de site ne fonctionne plus, on ne peut donc plus + gérer cela au niveau de mavenpom et ses fils. + + Il faut donc dans chaque projet client ajouter ceci : + +-------------------------------------------------------------------------------- + <distributionManagement> + <site> + <id>\${platform}</id> + <url>\${our.site.repository}/\${projectId}</url> + </site> + </distributionManagement> +-------------------------------------------------------------------------------- + + Les variables *site.repository* et *site.server* ne sont donc plus utiliséees et + sont supprimées sauf pour les projets héritants du mavenpom4labs. + +** Déployements via nexus (plutôt que par ssh) + + On utilise désormais le déployement en http via nexus. + + Il faut donc avoir un nouveau server dans son settings.xml + +-------------------------------------------------------------------------------- +  + <server> + <id>nuiton-nexus-deploy</id> + <username>deployment</username> + <password>{le mot de passe qui va bien :)}</password> + </server> +-------------------------------------------------------------------------------- + +* Nouveautés de la version 3.0 + + La version 3.0 survient avec une nouvelle forge http://forge.codelutin.com + + Cette forge est basée sur redmine et cela a nécessité du coup de revoir + légèrement l'utilisation de la variable <<platform>> et des serveurs dans le + <<settings.xml>>. + +** Modification du settings.xml + + Il faut donc ajouter les serveurs suivants (dans le <<settings.xml>>) : + +------------------------------------------------------------------------------- +  + <server> + <id>nuiton.org</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + + +  + <server> + <id>chorem.org</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>forge.codelutin.com</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>labs.libre-entreprise.org</id> + <username>votre login sur le labs</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>redmine-forge.codelutin.com</id> + <username>votre login sur le redmine forge.codelutin.com </username> + <password>{votre password encodé sur forge.codelutin.com}</password> + </server> + +------------------------------------------------------------------------------- + +** Migration des projets + + En théorie, rien à faire tout reste compatible sauf pour les projets + utilisant mavenpom4labs. + + Il faut désormais rajouter la section de définition du server de site car + cela ne fonctionne plus très bien depuis le passage sur le maven-site-plugin 3. + +* Nouveautés de la version 2.5 + + Depuis la version <<2.5>>, chaque librairie ou plugin utilisé dans le mavenpom + ou un de ses fils est configurable via une propriété, il s'agit d'une + généralisation de ce qui était déjà fait sur nos propres plugins et les + librairies. + + Cela permet de pouvoir dans un projet utilisant un des mavenpom de pouvoir + changer les versions de librairies ou plugins sans avoir à redéfinir les + dépendances. + + +** Mise à jour plugins + + * {{{http://maven-site.nuiton.org/maven-helper-plugin}maven-helper-plugin 1.2.11}} + + * {{{http://maven-site.nuiton.org/jrst}jrst 1.2}} + + * {{{http://maven.apache.org/plugins/maven-plugin-plugin/}maven-plugin-plugin 2.7}} + + * {{{http://maven.apache.org/plugins/maven-changes-plugin/}maven-changes-plugin 2.4}} + +* Nouveautés de la version 2.4 + + Depuis la version <<2.4>>, on introduit on gère les librairies les plus souvent + utilisées dans nos projets et ceci pour éviter de repasser dans les poms : c'est + plus facile de changer de mavenpom que de changer les versions dans chaque projet. + + Voir la page des propriétés pour connaitre toutes les librairies connues au + niveau du mavenpom. + + On a aussi renommer toutes les propriétés de versin en utilisant le <camelStyle> + pour faire comme les petits copains de chez Maven. Par exemple <maven.version> + devient <mavenVersion>. + + On a ajouté un profile <analyze-dependencies> qui est automatiquement déclanché + lors d'une release pour vérifier la consistance des dépendances d'un projet. + + Pour le reste, c'est {{{http://nuiton.org/versions/show/198}ici}}. + +* Nouveautés de la version 2.3 + + Depuis la version <<2.3>>, un nouveau type de pom nommé + du <<mavenpom4redmineAndCentral>> pour tous les projets déployés sur redmine + et synchronisés sur Maven central. + + Il hérite du <mavenpom4redmine> et rajoute la configuration pour que cela soit + déployé sur maven central. + + Pour plus d'informations, voir la page de + {{{./mavenpom4redmineAndCentral/index.html} de mavenpom4redmineAndCentral}}. + +* Nouveautés de la version 2.2.2 + +** Simplification des noms de dépôts + + On a supprimé <<nuiton->> de tous les noms de dépôts de release + +** Configuration central-safe améliorée + + La configuration <<central-safe>> a été améliorée, il s'agit désormais d'un + {{{./profiles.html#central_safe}profile central-safe}} qui n'est pas activé + lors d'une release. + + Les projets <<central-safe>> modifie la configuration du <<plugin release>> + pour inclure explicitement ce profile et en <<prepare>> et en <<perform>>. + +** Mise à jour plugins + + * {{{http://maven-site.nuiton.org/maven-helper-plugin}maven-helper-plugin 1.2.6}} + + * {{{http://maven-site.nuiton.org/maven-license-plugin/fr}maven-license-plugin 2.3.1}} + +* Nouveautés de la version 2.2.1 + + Depuis la version <<2.2.1>> on utilise + {{{http://maven-site.nuiton.org/maven-license-plugin/fr}maven-license-plugin 2.3}}. + + Cela permet d'améliorer la qualité des fichiers THIRD-PARTY générés + (dépendances sans license, licenses dupliquées,...). + + On a aussi dans cette version de <mavenpom> ajouté une configuration pour permettre + en phase de préparation de release (<release:prepare>) d'activer les profiles + de releases afin de pouvoir détecter d'éventuelles problèmes avant le tag svn. + +* Nouveautés de la version 2.2 + + Depuis la version <<2.2>> on a amélioré la configuration des serveurs de + déployement et introduit la notion de projet <<central-safe>>. + + Un tel projet répond aux pré-requis d'un projet synchronisable sur {{{http://repo1.maven.org/maven2}central}} : + + * avoir un pom de bonne qualité (informations scm, url, license, ...) + + * être auto-conteneur (pas besoin d'autre dépôts que central) + + * être signé via gpg + + * javadoc et sources disponibles + + [] + + Pour plus d'informations, voir la page de {{{./mavenpom/repositories.html}configuration des serveurs}}. Property changes on: trunk/mavenpomdoc/src/site/apt/index.apt.vm ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom/index.apt (from rev 1241, trunk/mavenpomdoc/src/site/apt/index.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom/index.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom/index.apt 2012-04-20 08:59:10 UTC (rev 1242) @@ -0,0 +1,345 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Maven nuiton pom +------ +------ +2009-08-22 +------ + +Présentation + + Le projet <mavenpom> est un pom de type <Corporate> dont héritent tous les + projets {{{http://www.codelutin.com}code Lutin}}. + + +* Nouveautés de la version 3.1 + +** Changement du maven-helper-plugin + + Depuis la version 1.4, maven-helper-plugin devien helper-maven-plugin (tout du + moins son GAV). Le site du projet reste bien (pour le moment) + {{http://maven-site.nuiton.org/maven-helper-plugin}}. + +* Nouveautés de la version 3.0.3 + +** Correction des déployements de site + + La version 3.0.3 corrige les problèmes suite au passage sur le + maven-site-plugin 3.0. + + L'héritage des définitions de site ne fonctionne plus, on ne peut donc plus + gérer cela au niveau de mavenpom et ses fils. + + Il faut donc dans chaque projet client ajouter ceci : + +-------------------------------------------------------------------------------- + <distributionManagement> + <site> + <id>${platform}</id> + <url>${our.site.repository}/${projectId}</url> + </site> + </distributionManagement> +-------------------------------------------------------------------------------- + + Les variables *site.repository* et *site.server* ne sont donc plus utiliséees et + sont supprimées sauf pour les projets héritants du mavenpom4labs. + +** Déployements via nexus (plutôt que par ssh) + + On utilise désormais le déployement en http via nexus. + + Il faut donc avoir un nouveau server dans son settings.xml + +-------------------------------------------------------------------------------- +  + <server> + <id>nuiton-nexus-deploy</id> + <username>deployment</username> + <password>{le mot de passe qui va bien :)}</password> + </server> +-------------------------------------------------------------------------------- + +* Nouveautés de la version 3.0 + + La version 3.0 survient avec une nouvelle forge http://forge.codelutin.com + + Cette forge est basée sur redmine et cela a nécessité du coup de revoir + légèrement l'utilisation de la variable <<platform>> et des serveurs dans le + <<settings.xml>>. + +** Modification du settings.xml + + Il faut donc ajouter les serveurs suivants (dans le <<settings.xml>>) : + +------------------------------------------------------------------------------- +  + <server> + <id>nuiton.org</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + + +  + <server> + <id>chorem.org</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>forge.codelutin.com</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>labs.libre-entreprise.org</id> + <username>votre login sur le labs</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>redmine-forge.codelutin.com</id> + <username>votre login sur le redmine forge.codelutin.com </username> + <password>{votre password encodé sur forge.codelutin.com}</password> + </server> + +------------------------------------------------------------------------------- + +** Migration des projets + + En théorie, rien à faire tout reste compatible sauf pour les projets + utilisant mavenpom4labs. + + Il faut désormais rajouter la section de définition du server de site car + cela ne fonctionne plus très bien depuis le passage sur le maven-site-plugin 3. + +* Nouveautés de la version 2.5 + + Depuis la version <<2.5>>, chaque librairie ou plugin utilisé dans le mavenpom + ou un de ses fils est configurable via une propriété, il s'agit d'une + généralisation de ce qui était déjà fait sur nos propres plugins et les + librairies. + + Cela permet de pouvoir dans un projet utilisant un des mavenpom de pouvoir + changer les versions de librairies ou plugins sans avoir à redéfinir les + dépendances. + + +** Mise à jour plugins + + * {{{http://maven-site.nuiton.org/maven-helper-plugin}maven-helper-plugin 1.2.11}} + + * {{{http://maven-site.nuiton.org/jrst}jrst 1.2}} + + * {{{http://maven.apache.org/plugins/maven-plugin-plugin/}maven-plugin-plugin 2.7}} + + * {{{http://maven.apache.org/plugins/maven-changes-plugin/}maven-changes-plugin 2.4}} + +* Nouveautés de la version 2.4 + + Depuis la version <<2.4>>, on introduit on gère les librairies les plus souvent + utilisées dans nos projets et ceci pour éviter de repasser dans les poms : c'est + plus facile de changer de mavenpom que de changer les versions dans chaque projet. + + Voir la page des propriétés pour connaitre toutes les librairies connues au + niveau du mavenpom. + + On a aussi renommer toutes les propriétés de versin en utilisant le <camelStyle> + pour faire comme les petits copains de chez Maven. Par exemple <maven.version> + devient <mavenVersion>. + + On a ajouté un profile <analyze-dependencies> qui est automatiquement déclanché + lors d'une release pour vérifier la consistance des dépendances d'un projet. + + Pour le reste, c'est {{{http://nuiton.org/versions/show/198}ici}}. + +* Nouveautés de la version 2.3 + + Depuis la version <<2.3>>, un nouveau type de pom nommé + du <<mavenpom4redmineAndCentral>> pour tous les projets déployés sur redmine + et synchronisés sur Maven central. + + Il hérite du <mavenpom4redmine> et rajoute la configuration pour que cela soit + déployé sur maven central. + + Pour plus d'informations, voir la page de + {{{./mavenpom4redmineAndCentral/index.html} de mavenpom4redmineAndCentral}}. + +* Nouveautés de la version 2.2.2 + +** Simplification des noms de dépôts + + On a supprimé <<nuiton->> de tous les noms de dépôts de release + +** Configuration central-safe améliorée + + La configuration <<central-safe>> a été améliorée, il s'agit désormais d'un + {{{./profiles.html#central_safe}profile central-safe}} qui n'est pas activé + lors d'une release. + + Les projets <<central-safe>> modifie la configuration du <<plugin release>> + pour inclure explicitement ce profile et en <<prepare>> et en <<perform>>. + +** Mise à jour plugins + + * {{{http://maven-site.nuiton.org/maven-helper-plugin}maven-helper-plugin 1.2.6}} + + * {{{http://maven-site.nuiton.org/maven-license-plugin/fr}maven-license-plugin 2.3.1}} + +* Nouveautés de la version 2.2.1 + + Depuis la version <<2.2.1>> on utilise + {{{http://maven-site.nuiton.org/maven-license-plugin/fr}maven-license-plugin 2.3}}. + + Cela permet d'améliorer la qualité des fichiers THIRD-PARTY générés + (dépendances sans license, licenses dupliquées,...). + + On a aussi dans cette version de <mavenpom> ajouté une configuration pour permettre + en phase de préparation de release (<release:prepare>) d'activer les profiles + de releases afin de pouvoir détecter d'éventuelles problèmes avant le tag svn. + +* Nouveautés de la version 2.2 + + Depuis la version <<2.2>> on a amélioré la configuration des serveurs de + déployement et introduit la notion de projet <<central-safe>>. + + Un tel projet répond aux pré-requis d'un projet synchronisable sur {{{http://repo1.maven.org/maven2}central}} : + + * avoir un pom de bonne qualité (informations scm, url, license, ...) + + * être auto-conteneur (pas besoin d'autre dépôts que central) + + * être signé via gpg + + * javadoc et sources disponibles + + [] + + Pour plus d'informations, voir la page de {{{./repositories.html}configuration des serveurs}}. + +Les propriétés + + Voir la page des {{{./properties.html}propriétés}}. + +Les profiles + + Mavenpom définit un certain nombre de profiles. Certains sont dédiés + exclusivement à la préparation de releases, tandis que d'autres permettent de + réaliser certaines tâches pendant le développement (mise à jour des entêtes + des fichiers sources par exemple). + + La page des {{{./profiles.html}profiles}} décrit l'ensemble des profiles. + +Vérification de conformité + + On effectue sur le pom des contrôles de conformités via le plugin + <maven-enforcer-plugin>. + +* propriétés obligatoires + + Aucune à l'heure actuelle + +* Fichiers obligatoires + +-------------------------------------------------------------------------------- +README.txt +changelog.txt +LICENSE.txt +-------------------------------------------------------------------------------- + +Configuration des plugins + + Mavenpom fixe les versions d'un certain nombre de plugins et ceci pour + plusieurs raisons : + + * la <reproductibilité> : en effet, si on ne fixe pas les versions des plugins + on s'expose d'un build à l'autre à ne pas utiliser la même version des + plugins, et donc dans le temps on ne peut pas garantir que le build d'un + projet sera exactement le même. Ceci est une préconisation de <<maven>>. + + * l'<uniformisation> : le fait de fixer le plus grand nombre de versions de + plugin permet aussi de faire profiter à tous les projets héritant de + <<mavenpom>> d'une certaine stabilité et de faire profiter à tous des + dernières versions des plugins testées. + + * un dernier point intéressant est le fait que si on utilise correctement + <<mavenpom>>, on ne doit pas à avoir à gérer les versions des plugins hormis + les exceptions citées dans la section suivante. + +* Les plugins configurés dans mavenpom + + On distingue deux types de plugins : + + * les plugins <<internes>> que nous produisont + (et donc qui dépendent de <<mavenpom>>). + + * les plugins <<externes>> (ceux d'apache, codehaus, plexus,...) qui ne + dépendent pas de <<mavenpom>> + +** Plugins internes + + Nos plugins ne doivent pas être décrit dans <<mavenpom>> et ceci pour la + simple raison que nos propres plugins utilisent <<mavenpom>>, 3 exceptions + existent cependant : + + * <<maven-helper-plugin>> : il est utilisé pour construire les releases + + * <<maven-jredmine-plugin>> : aussi utilisé pour construire les releases + + * <<maven-license-plugin>> : utilisé dans les profiles de mises à jour des + entêtes de licenses. + + [] + + Tous nos autres plugins ne sont pas référencés ici et doivent donc être + entièrement définies (version + configuration) dans vos pom. + +** Plugin externes + + Pour tout plugin dit externe, il peut être référencé dans <<mavenpom>>. + +** Bonnes pratiques sur l'utilisant d'un plugin externe dans votre pom + + Avant de vouloir utiliser un nouveau plugin dans votre pom, consulter en + premier la page des {{{./plugin-management.html}plugins}} connus par <<mavenpom>>. + + Si le plugin est connu, alors pas de question à se poser, on peut l'utiliser + sans spécifier sa version utilisant celle définit dans <<mavenpom>>. + + Si le plugin n'existe pas, faites une demande d'évolution sur le projet + <<mavenpom>>, il sera rapidemment ajouté et vous pourrez l'utiliser en vous + plaçant sur la dernière snapshot de <<mavenpom>>. + Copied: trunk/mavenpomdoc/src/site/apt/mavenpom/profiles.apt (from rev 1241, trunk/mavenpomdoc/src/site/apt/profiles.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom/profiles.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom/profiles.apt 2012-04-20 08:59:10 UTC (rev 1242) @@ -0,0 +1,408 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Profiles disponibles dans mavenpom +------ +------ +2009-10-11 +------ + +Abstract + + Cette page décrit l'ensemble des profiles ajoutés (ou surchargés) dans mavenpom + et disponibles pour tous les projets qui en héritent. + + <<Notation:>> Pour définir l'utilisation d'un propriété du projet, on écrit : + +-------------------------------------------------------------------------------- +(propriété) +-------------------------------------------------------------------------------- + +Vue d'ensemble + +* Profiles autonomes + + Il s'agit de profiles qui peuvent être inclus lors d'un build pour effectuer + des tâches diverses. + +*----------------------------------+------------------------------+ +| <<Nom du profile>> | <<Propriété d'activation>> | +*----------------------------------+------------------------------+ +| {{no-tests}} | <<->> | +*----------------------------------+------------------------------+ +| {{no-reports}} | <<->> | +*----------------------------------+------------------------------+ +| {{no-dep-details}} | <<->> | +*----------------------------------+------------------------------+ +| {{no-dep-locations}} | <<->> | +*----------------------------------+------------------------------+ +| {{webstart-profile}} | <<doWebstart>> | +*----------------------------------+------------------------------+ +| {{local-webstart-profile}} | <<doLocalWebstart>> | +*----------------------------------+------------------------------+ +| {{run}} | <<->> | +*----------------------------------+------------------------------+ +| {{staging-site-profile}} | <<stagingSite>> | +*----------------------------------+------------------------------+ + +* Profiles inclus dans le cycle de release + + L'ensemble des profiles inclus lors d'un cycle de release. + +*----------------------------------+------------------------------+ +| <<Nom du profile>> | <<Propriété d'activation>> | +*----------------------------------+------------------------------+ +| {{reporting}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{release-profile}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{license-profile}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{update-file-header}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{release-sign-artifacts}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{central-safe}} | - | +*----------------------------------+------------------------------+ + +* Profiles inclus dans le cycle de release de mavenpom + + L'ensemble des profiles inclus lors d'un cycle de release de mavenpom. + +*----------------------------------+------------------------------+ +| <<Nom du profile>> | <<Propriété d'activation>> | +*----------------------------------+------------------------------+ +| {{internal}} | <<internal>> | +*----------------------------------+------------------------------+ +| {{internal-redmine-pre-release}} | <<internalRedminePreRelease>>| +*----------------------------------+------------------------------+ +| {{internal-redmine-release}} | <<internalRedmineRelease>> | +*----------------------------------+------------------------------+ + +Détails + +* Profiles autonomes + +** {no-tests} + + Ce profile permet de ne pas lancer les tests. + {{{Profiles autonomes}[remonter]}} + +-------------------------------------------------------------------------------- +mvn install -Pno-tests +-------------------------------------------------------------------------------- + +** {no-reports} + + Ce profile permet de ne pas lancer la génération des rapports sur le cycle + <site>. + +-------------------------------------------------------------------------------- +mvn site -Pno-reports +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +* {run} + + Ce profile permet de lancer une classe java depuis maven. Il faut définir une + propriété <maven.jar.main.class> qui exprime le nom qualifié de la classe à + lancer. + +-------------------------------------------------------------------------------- +mvn -Prun -Dmaven.jar.main.class=org.nuiton.MyMainClass +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {no-dep-details} + + Ce profile permet de désactiver la génération du détail des dépendances + lors du rapport des dépendances (accélère beaucoup les temps de génération du + site en phase de développement). + +-------------------------------------------------------------------------------- +mvn site -Pno-dep-details +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {no-dep-locations} + + Ce profile permet de désactiver la génération de la localisation des + dépendances lors du rapport des dépendances (accélère beaucoup les temps de + génération du site en phase de développement). + +-------------------------------------------------------------------------------- +mvn site -Pno-dep-locations +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {webstart-profile} + + Ce profile est utilisé pour construire l'application webstart associé à un + module de type <<jar>>. + + Ce profile est utilisable en activant la propriété <<doWebstart>> : + +-------------------------------------------------------------------------------- +mvn package -Pwebstart-profile +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn package -PdoWebstart +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {local-webstart-profile} + + Ce profile est utilisé pour construire l'application webstart associé à un + module de type <<jar>>. + + Le codebase du webstart généré pointe sur target/jnlp, ainsi on peut tester + en local le webstart avant tout déployement. + + Ce profile est utilisable en activant la propriété <<doLocalWebstart>> : + +-------------------------------------------------------------------------------- +mvn package -Plocal-webstart-profile +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn package -PdoLocalWebstart +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {staging-site-profile} + + Ce profile permet de deployer un site en local, pratique pour tester les + sites multi-modules sans avoir à deployer sur un serveur distant. + + Le profile utilise un server <<staging-site>> à définir dans votre + <settings.xml>. + + Il est possible de définir en ligne de commande l'url où deployer via la + propriété <<stagingUrl>>. + +-------------------------------------------------------------------------------- + mvn -Pstaging-site-profile -DstagingUrl=scpexe://myServer/myPath +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- + mvn -DstagingSite -DstagingUrl=scpexe://myServer/myPath +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +* Profiles inclus dans le cycle de release + +** {reporting} + + Ce profile regroupe tous les reports utilisés pour la génération du site. + L'intérêt de les mettre dans un profile est de pouvoir générer simplement + uniquement la documentation du site sans aucun raport. + + Ce profile est utilisable en activant la propriété <performRelease> : + +-------------------------------------------------------------------------------- +mvn site -Preporting +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn site -DperformRelease +-------------------------------------------------------------------------------- + {{{Profiles inclus dans le cycle de release}[remonter]}} + +** {release-profile} + + Ce profile (défini par maven) est utilisé lors d'un <mvn release:perform>. + On y indique qu'il faut toujours inclure les sources et la javadoc. + + Ce profile est utilisable en activant la propriété <performRelease> : + +-------------------------------------------------------------------------------- +mvn deploy -Prelease-profile +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn deploy -DperformRelease +-------------------------------------------------------------------------------- + + A noter que lors d'un deploy (par exemple d'une snapshot), on <<doit>> + l'utiliser afin que les utilisateurs puissent récupérer les sources et la + javadoc dans leur IDE favori.\ + {{{Profiles inclus dans le cycle de release}[remonter]}} + +** {license-profile} + + Ce profile est utilisé lors des release. + On y indique qu'il faut toujours générer le fichier THIRD-PARTY et synchroniser les licenses. + + Ce profile est utilisable en activant la propriété <performRelease> : + +-------------------------------------------------------------------------------- +mvn -Plicense-profile +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn deploy -DperformRelease +-------------------------------------------------------------------------------- + +** {release-sign-artifacts} + + Ce profile est utilisé pour signé avec gpg les artifacts à installer ou + déployer. + + Pour pouvoir l'utiliser il faut que : + + * avoir une clef gpg de nom <<Code Lutin>> + + * avoir dans son <settings.xml> un server de nom <<gpg-signer>> qui contient : + + * username : <<Code Lutin>> + + * password : la passephrase de la clef gpg (encodé bien sûr...) + + [] + + [] + + Le clef gpg utilisé est visible {{{http://pgp.mit.edu:11371/pks/lookup?search=Code+Lutin&op=index&fingerprint=on&exact=on}ici}}. + + Pour la récupérer, executer la commande + +-------------------------------------------------------------------------------- +gpg --keyserver hkp://pgp.mit.edu --recv-keys 014A6ED2 +-------------------------------------------------------------------------------- + + + {{{Profiles inclus dans le cycle de release}[remonter]}} + +** {update-file-header} + + Ce profile permet la mise à jour des entêtes de tous les fichiers d'un + projet en utilisant le nouveau goal <update-file-header> + (depuis maven-license-plugin 2.1). + + Il faut avoir définit un fichier + +-------------------------------------------------------------------------------- +license.descriptor +-------------------------------------------------------------------------------- + + qui est par défaut <<src/license/project.xml>>. + + Ce fichier décrit les en-têtes à inspecter. + +-------------------------------------------------------------------------------- +mvn -Pupdate-file-header +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn -DperformRelease +-------------------------------------------------------------------------------- + {{{Profiles inclus dans le cycle de release}[remonter]}} + +** {central-safe} + + Ce profile permet de vérifier que toutes les dépendances du projets sont sur + central et central-release. + + Il n'est pas inclus directement dans le cycle de release (car seul les projets + central-safe doivent l'utiliser). + + Pour l'utiliser lors d'une release ajouter ceci dans la section <<properties>> + de votre pom : + +-------------------------------------------------------------------------------- +  + +  + <arguments>-DperformRelease -Dcentral-safe</arguments> + +  + <releaseProfiles>central-safe</releaseProfiles> +-------------------------------------------------------------------------------- + + Pour le lancer manuellement : + +-------------------------------------------------------------------------------- +mvn -Pcentral-safe +-------------------------------------------------------------------------------- + {{{Profiles inclus dans le cycle de release}[remonter]}} + +* Profiles inclus dans le cycle de release de mavenpom + +** {internal} + + Ce profile permet de corriger l'url de deployement du site de <mavenpom> + et il <<DOIT>> être toujours utilisé lors d'une installation déployement + ou d'une release. + + Il est activable via la propriété <<internal>>. + + Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. + + Pour plus d'information sur ce profile voir la page des + {{{./release.html}release}}.\ + {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} + +** {internal-redmine-pre-release} + + Ce profile permet de préparer la finalisation de la release en générant + les annonces de release. + + Il est activable via la propriété <<internalRedminePreRelease>>. + + Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. + + Pour plus d'information sur ce profile voir la page des + {{{./release.html}release}}.\ + {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} + +** {internal-redmine-release} + + Ce profile permet de finaliser la release de <<mavenpom>> en publiant + les annonces de release. + + + Il est activable via la propriété <<internalRedmineRelease>>. + + Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. + + Pour plus d'information sur ce profile voir la page des + {{{./release.html}release}}.\ + {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom/profiles.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom/properties.apt.vm (from rev 1241, trunk/mavenpomdoc/src/site/apt/properties.apt.vm) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom/properties.apt.vm (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom/properties.apt.vm 2012-04-20 08:59:10 UTC (rev 1242) @@ -0,0 +1,620 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Propriétés disponibles dans mavenpom +------ +------ +2009-10-11 +------ + +Abstract + + Cette page décrit l'ensemble des propriétés ajoutés dans mavenpom et disponibles + pour tous les projets qui héritent de mavenpom. + + <<Notation:>> Pour définir l'utilisation d'un propriété du projet, on écrit : + +-------------------------------------------------------------------------------- +(propriété) +-------------------------------------------------------------------------------- + +Vue d'ensemble + +* Propriétés générales du projet + +*--------------------------------------+------------------------------------------------------+ +| <<Propriété>> | <<Valeur par défaut>> | +*--------------------------------------+------------------------------------------------------+ +| {{platform}} | <<nuiton.org>> | +*--------------------------------------+------------------------------------------------------+ +| {{projectId}} | <<(project.artifactId)>> | +*--------------------------------------+------------------------------------------------------+ +| {{listId}} | <<(projectId)>> | +*--------------------------------------+------------------------------------------------------+ +| {{maven.src.dir}} | <<(project.basedir)/src>> | +*--------------------------------------+------------------------------------------------------+ +| {{maven.gen.dir}} | <<(project.build.directory)/generated-sources>> | +*--------------------------------------+------------------------------------------------------+ +| {{maven.license.file}} | <<(project.basedir)/LICENSE.txt>> | +*--------------------------------------+------------------------------------------------------+ + +* Propriétés de versions + +*--------------------------------------+--------------------------------------+ +| <<Propriété>> | <<Valeur par défaut>> | +*--------------------------------------+--------------------------------------+ +| {{mavenVersion}} | <<${mavenVersion}>> | +*--------------------------------------+--------------------------------------+ +| {{antVersion}} | <<${antVersion}>> | +*--------------------------------------+--------------------------------------+ +| {{nuitonSkinVersion}} | <<${nuitonSkinVersion}>> | +*--------------------------------------+--------------------------------------+ + + Pour avoir la liste de toutes les dépendances mutualisées dans le projet, + aller sur la page {{{./dependency-management.html}des versions supportées}}. + + Chaque dépendance possède une propriété pour définir sa version, afin de vous + permettre dans vos poms de pouvoir facilement surcharger la version d'une telle + dépendances sans avoir à changer de version de mavenpom. + +*-------------------------------+--------------------------------------------------------------------------+ +| <<Propriété>> | <<librarie>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsBeanutilsVersion}} | <<commons-beanutils:commons-beanutils:${commonsBeanutilsVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsCollectionsVersion}} | <<commons-collections:commons-collections:${commonsCollectionsVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsEmailVersion}} | <<org.apache.commons:commons-email:${commonsEmailVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsHttpclientVersion}} | <<commons-httpclient:commons-httpclient:${commonsHttpclientVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsIoVersion}} | <<commons-io:commons-io:${commonsIoVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsJxpathVersion}} | <<commons-jxpath:commons-jxpath:${commonsJxpathVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsLangVersion}} | <<commons-lang:commons-lang:${commonsLangVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsLang3Version}} | <<org.apache.commons:commons-lang3:${commonsLang3Version}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsLoggingVersion}} | <<commons-logging:commons-logging:${commonsLoggingVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsPrimitivesVersion}} | <<commons-primitives:commons-primitives:${commonsPrimitivesVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsMathVersion}} | <<org.apache.commons:commons-math:${commonsMathVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{guavaVersion}} | <<com.google.guava:guava:${guavaVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{junitVersion}} | <<junit:junit:${junitVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{log4jVersion}} | <<log4j:log4j:${log4jVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ + +* Propriétés de versions de plugins + + On définit dans le mavenpom beaucoup de versions de plugins. En consultant la + page {{{./plugin-management.html}des versions de plugins supportés}}. + + Comme pour les librairies, on définit une propriété pour chaque plugin définit + et ceci pour les même raisons. + + A noter que si un plugin est aussi un report il est nécessaire dans la partie report + de refournir la version du plugin (merci d'utiliser la propriété et non pas une + version en dure). + +** Plugins nuiton + +*-------------------------------+--------------------------------------------------------------------------+ +| <<Propriété (plugins nuton)>> | <<GAV>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{helperPluginVersion}} | {{{http://maven-site.nuiton.org/maven-helper-plugin} <<org.nuiton:helper-maven-plugin:${helperPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{jredminePluginVersion}} | {{{http://maven-site.nuiton.org/jredmine/maven-jredmine-plugin} <<org.nuiton.jredmine:maven-jredmine-plugin:${jredminePluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{jrstPluginVersion}} | {{{http://maven-site.nuiton.org/jrst/doxia-module-jrst} <<org.nuiton.jrst:doxia-module-jrst:${jrstPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ + +** Plugins maven + +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{Propriété (plugins maven)}} | <<GAV>> | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{antRunPluginVersion}} | {{{http://maven.apache.org/plugins/maven-antrun-plugin}<<org.apache.maven.plugins:maven-antrun-plugin:${antRunPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{assemblyPluginVersion}} | {{{http://maven.apache.org/plugins/maven-assembly-plugin}<<org.apache.maven.plugins:maven-assembly-plugin:${assemblyPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{cleanPluginVersion}} | {{{http://maven.apache.org/plugins/maven-clean-plugin}<<org.apache.maven.plugins:maven-clean-plugin:${cleanPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{compilerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-compiler-plugin}<<org.apache.maven.plugins:maven-compiler-plugin:${compilerPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{dependencyPluginVersion}} | {{{http://maven.apache.org/plugins/maven-dependency-plugin}<<org.apache.maven.plugins:maven-dependency-plugin:${dependencyPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{deployPluginVersion}} | {{{http://maven.apache.org/plugins/maven-deploy-plugin}<<org.apache.maven.plugins:maven-deploy-plugin:${deployPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{earPluginVersion}} | {{{http://maven.apache.org/plugins/maven-ear-plugin}<<org.apache.maven.plugins:maven-ear-plugin:${earPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{ejbPluginVersion}} | {{{http://maven.apache.org/plugins/maven-ejb-plugin}<<org.apache.maven.plugins:maven-ejb-plugin:${ejbPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{enforcerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-enforcer-plugin}<<org.apache.maven.plugins:maven-enforcer-plugin:${enforcerPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{gpgPluginVersion}} | {{{http://maven.apache.org/plugins/maven-gpg-plugin}<<org.apache.maven.plugins:maven-gpg-plugin:${gpgPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{installPluginVersion}} | {{{http://maven.apache.org/plugins/maven-install-plugin}<<org.apache.maven.plugins:maven-install-plugin:${installPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{invokerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-invoker-plugin}<<org.apache.maven.plugins:maven-invoker-plugin:${invokerPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{jarPluginVersion}} | {{{http://maven.apache.org/plugins/maven-jar-plugin}<<org.apache.maven.plugins:maven-jar-plugin:${jarPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{javadocPluginVersion}} | {{{http://maven.apache.org/plugins/maven-javadoc-plugin}<<org.apache.maven.plugins:maven-javadoc-plugin:${javadocPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{pluginPluginVersion}} | {{{http://maven.apache.org/plugins/maven-plugin-plugin}<<org.apache.maven.plugins:maven-plugin-plugin:${pluginPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{pmdPluginVersion}} | {{{http://maven.apache.org/plugins/maven-pmd-plugin}<<org.apache.maven.plugins:maven-pmd-plugin:${pmdPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{releasePluginVersion}} | {{{http://maven.apache.org/plugins/maven-release-plugin}<<org.apache.maven.plugins:maven-release-plugin:${releasePluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{remoteResourcesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-remote-resources-plugin}<<org.apache.maven.plugins:maven-remote-resources-plugin:${remoteResourcesPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{resourcesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-resources-plugin}<<org.apache.maven.plugins:maven-resources-plugin:${resourcesPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{site2PluginVersion}} | {{{http://maven.apache.org/plugins/maven-site-plugin}<<org.apache.maven.plugins:maven-site-plugin:${site2PluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{site3PluginVersion}} | {{{http://maven.apache.org/plugins/maven-site-plugin-3.0-beta-3}<<org.apache.maven.plugins:maven-site-plugin:${site3PluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{sourcePluginVersion}} | {{{http://maven.apache.org/plugins/maven-source-plugin}<<org.apache.maven.plugins:maven-source-plugin:${sourcePluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{surefirePluginVersion}} | {{{http://maven.apache.org/plugins/maven-surefire-plugin}<<org.apache.maven.plugins:maven-surefire-plugin:${surefirePluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{warPluginVersion}} | {{{http://maven.apache.org/plugins/maven-war-plugin}<<org.apache.maven.plugins:maven-war-plugin:${warPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ + +** Plugins mojo (codehaus) + +*-------------------------------+--------------------------------------------------------------------------+ +| {{Propriété (plugins mojo)}} | <<GAV>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{coberturaPluginVersion}} | {{{http://mojo.codehaus.org/cobertura-maven-plugin}<<org.codehaus.mojo:cobertura-maven-plugin:${coberturaPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{execPluginVersion}} | {{{http://mojo.codehaus.org/exec-maven-plugin}<<org.codehaus.mojo:exec-maven-plugin:${execPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{findbugsPluginVersion}} | {{{http://mojo.codehaus.org/findbugs-maven-plugin}<<org.codehaus.mojo:findbugs-maven-plugin:${findbugsPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{gwtPluginVersion}} | {{{http://mojo.codehaus.org/gwt-maven-plugin}<<org.codehaus.mojo:gwt-maven-plugin:${gwtPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{licensePluginVersion}} | {{{http://mojo.codehaus.org/license-maven-plugin}<<codehaus.mojo:license-maven-plugin:${licensePluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{versionsPluginVersion}} | {{{http://mojo.codehaus.org/versions-maven-plugin}<<org.codehaus.mojo:versions-maven-plugin:${versionsPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{wagonPluginVersion}} | {{{http://mojo.codehaus.org/wagon-maven-plugin}<<org.codehaus.mojo:wagon-maven-plugin:${wagonPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{webstartPluginVersion}} | {{{http://mojo.codehaus.org/webstart/webstart-maven-plugin}<<org.codehaus.mojo.webstart:webstart-maven-plugin:${webstartPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ + +** Plugins plexus (mojo) + +*-------------------------------+------------------------------------------------------------------------------------------------------+ +| {{Propriété (plugins plexus)}} | <<GAV>> | +*------------------------------------------+-------------------------------------------------------------------------------------------+ +| {{plexusPluginVersion}} | {{{http://plexus.codehaus.org/plexus-maven-plugin}<<org.codehaus.plexus:plexus-maven-plugin:${plexusPluginVersion}>>}} | +*------------------------------------------+-------------------------------------------------------------------------------------------+ +| {{plexusComponentMetadataPluginVersion}} | {{{http://plexus.codehaus.org/plexus-containers/plexus-component-metadata}<<org.codehaus.plexus:plexus-component-metadata:${plexusComponentMetadataPluginVersion}>>}} | +*------------------------------------------+-------------------------------------------------------------------------------------------+ + +** Autres plugins + +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{Propriété (autre plugins)}} | <<GAV>> | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{androidPluginVersion}} | <<com.jayway.maven.plugins.android.generation2:maven-android-plugin:${androidPluginVersion}>> | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{jettyPluginVersion}} | {{{http://mojo.codehaus.org/jetty-maven-plugin}<<org.mortbay.jetty:jetty-maven-plugin:${jettyPluginVersion}>>}} | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{tomcatPluginVersion}} | {{{http://tomcat.apache.org/maven-plugin-${tomcatPluginVersion}/}<<org.apache.tomcat.maven:tomcat6-maven-plugin:${tomcatPluginVersion}>>}} | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{tomcatPluginVersion}} | {{{http://tomcat.apache.org/maven-plugin-${tomcatPluginVersion}/}<<org.apache.tomcat.maven:tomcat7-maven-plugin:${tomcatPluginVersion}>>}} | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{statScmPluginVersion}} | {{{http://stat-scm.sourceforge.net}<<net.sf:stat-scm:${statScmPluginVersion}>>}} | +*-------------------------------------+------------------------------------------------------------------------------------------------+ + +** Plugins de report + +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{Propriété (reports)}} | <<GAV>> | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{changesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-changes-plugin}<<org.apache.maven.plugins:maven-changes-plugin:${changesPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{projectInfoReportsPluginVersion}} | {{{http://maven.apache.org/plugins/maven-project-info-reports-plugin}<<org.apache.maven.plugins:maven-project-info-reports-plugin:${projectInfoReportsPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{changelogPluginVersion}} | {{{http://maven.apache.org/plugins/maven-changelog-plugin}<<org.apache.maven.plugins:maven-changelog-plugin:${changelogPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{jrxPluginVersion}} | {{{http://maven.apache.org/plugins/maven-jxr-plugin}<<org.apache.maven.plugins:maven-jxr-plugin:${jrxPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{sonarReportPluginVersion}} | {{{http://docs.codehaus.org/display/SONAR/Sonar+Maven+report}<<org.codehaus.sonar-plugins:maven-report:${sonarReportPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ + + +* Propriétés de génération de site et reports + +*--------------------------------------+--------------------------------------------------------+ +| <<Propriété>> | <<Valeur par défaut>> | +*--------------------------------------+--------------------------------------------------------+ +| {{siteSourcesType}} | <<rst>> | +*--------------------------------------+--------------------------------------------------------+ +| {{scmwebeditorEnabled}} | <<true>> | +*--------------------------------------+--------------------------------------------------------+ +| {{piwikEnabled}} | <<true>> | +*--------------------------------------+--------------------------------------------------------+ +| {{piwikId}} | << - >> | +*--------------------------------------+--------------------------------------------------------+ +| {{central.release.home.url}} | <<http://maven.nuiton.org/central-releases>> | +*--------------------------------------+--------------------------------------------------------+ +| {{other.release.home.url}} | <<http://maven.nuiton.org/other-releases>> | +*--------------------------------------+--------------------------------------------------------+ +| {{repository.home.url}} | <<(other.release.home.url)>> | +*--------------------------------------+--------------------------------------------------------+ +| {{scmwebeditorUrl}} | <<http://scmwebeditor.nuiton.org/nuiton-scmwebeditor/scmwebeditor>>| +*--------------------------------------+--------------------------------------------------------+ +| {{maven.javadoc.skip}} | <<false>> | +*--------------------------------------+--------------------------------------------------------+ +| {{maven.javadoc.quiet}} | <<true>> | +*--------------------------------------+--------------------------------------------------------+ +| {{ci.host.url}} | <<http://ci.(platform)/sonar>> | +*--------------------------------------+--------------------------------------------------------+ +| {{qa.host.url}} | <<http://qa.(platform)/jenkins>> | +*--------------------------------------+--------------------------------------------------------+ + +* Propriétés pour les déployements + +*--------------------------------------+--------------------------------------------------------+ +| <<Propriété>> | <<Valeur par défaut>> | +*--------------------------------------+--------------------------------------------------------+ +| {{snapshot.repository}} | <<(our.snapshot.repository)>> | +*--------------------------------------+--------------------------------------------------------+ +| {{snapshot.server}} | <<nuiton-nexus-deploy>> | +*--------------------------------------+--------------------------------------------------------+ +| {{our.snapshot.repository}} | <<http://nexus.nuiton.org/nexus/content/repositories/snapshots>>| +*--------------------------------------+--------------------------------------------------------+ +| {{release.repository}} | <<(other.release.repository)>> | +*--------------------------------------+--------------------------------------------------------+ +| {{release.server}} | <<nuiton-nexus-deploy>> | +*--------------------------------------+--------------------------------------------------------+ +| {{other.release.repository}} | <<http://nexus.nuiton.org/nexus/content/repositories/others-releases>> | +*--------------------------------------+--------------------------------------------------------+ +| {{central.release.repository}}| <<http://nexus.nuiton.org/nexus/content/repositories/central-releases>>| +*--------------------------------------+--------------------------------------------------------+ +| {{our.site.repository}} | <<scpexe://(platform)/var/lib/redmine-(platform)/project-site/(projectId)>> | +*--------------------------------------+--------------------------------------------------------+ + +Détails + +* Détail des propriétés générales du projet + +** {platform} + + Le host de la plateforme utilisée. + +-------------------------------------------------------------------------------- +nuiton.org +chorem.org +forge.codelutin.com +labs.libre-entreprise.org +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +** {projectId} + + L'identifiant unique du projet associé. + +-------------------------------------------------------------------------------- +(project.artifactId) +-------------------------------------------------------------------------------- + + <Note :> Sur un multi-module, la propriété doit être surchargé, sinon on + se retrouve avec des valeurs héritiés sur les modules fils, ce qui n'est pas + correct.\ + {{{Propriétés générales du projet}[remonter]}} + +** {listId} + + Le préfixe utilisé pour les listes de diffusion. + +-------------------------------------------------------------------------------- +(projectId) +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +** {maven.compile.source} + + Le niveau de java utilisé dans les sources (par défaut <<1.6>>)\ + {{{Propriétés générales du projet}[remonter]}} + +** {maven.compile.target} + + Le niveau de java utilisé dans le code compilé (par défaut <<1.6>>)\ + {{{Propriétés générales du projet}[remonter]}} + +** {maven.compile.encoding} + + Encoding à utiliser dans les sources (par défaut <<UTF-8>>)\ + {{{Propriétés générales du projet}[remonter]}} + +** {project.reporting.outputEncoding} + + Encoding à utiliser dans le site (par défaut <<UTF-8>>)\ + {{{Propriétés générales du projet}[remonter]}} + +** {maven.src.dir} + + Répertoire des sources + +-------------------------------------------------------------------------------- +(project.basedir)/src +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +** {maven.gen.dir} + + Répertoire de génération + +-------------------------------------------------------------------------------- +(project.basedir)/target/generated-sources +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +** {maven.license.file} + + Chemin vers la license utilisée dans le projet. + +-------------------------------------------------------------------------------- +(project.basedir)/LICENSE.txt +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +* Détail des propriétés de versions + +** {mavenVersion} + + La version de l'api de maven utilisée (principalement dans les plugins maven) + : <<${mavenVersion}>>\ + {{{Propriétés de versions}[remonter]}} + +** {antVersion} + + La version de l'api de ant utilisée (principalement dans les modules de tâches ant).\ + {{{Propriétés de versions}[remonter]}} + +** {nuitonSkinVersion} + + La version de notre skin + {{{http://maven-site.nuiton.org/maven-nuiton-skin}maven-nuiton-skin}} + utilisé pour la génération des sites maven.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsBeanutilsVersion} + + La version de la librairie + {{{http://commons.apache.org/beanutils}commons-beanutils}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsCollectionsVersion} + + La version de la librairie + {{{http://commons.apache.org/collections}commons-collections}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsEmailVersion} + + La version de la librairie + {{{http://commons.apache.org/email}commons-email}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsHttpclientVersion} + + La version de la librairie + {{{http://hc.apache.org/httpclient-3.x}commons-http-client}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsIoVersion} + + La version de la librairie + {{{http://commons.apache.org/io}commons-io}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsJxpathVersion} + + La version de la librairie + {{{http://commons.apache.org/jxpath}commons-jxpath}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsLangVersion} + + La version de la librairie (en version 2) + {{{http://commons.apache.org/lang}commons-lang}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsLang3Version} + + La version de la librairie + {{{http://commons.apache.org/lang}commons-lang}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsLoggingVersion} + + La version de la librairie + {{{http://commons.apache.org/logging}commons-logging}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsPrimitivesVersion} + + La version de la librairie + {{{http://commons.apache.org/primitives}commons-primitives}}.\ + {{{Propriétés de versions}[remonter]}} + +** {junitVersion} + + La version de la librairie + {{{http://www.junit.org}junit}}.\ + {{{Propriétés de versions}[remonter]}} + +** {log4jVersion} + + La version de la librairie + {{{http://logging.apache.org/log4j/1.2}log4j}}.\ + {{{Propriétés de versions}[remonter]}} + +* Détail des propriétés de génération de site et reports + +** {siteSourcesType} + + Le type de fichiers utilisé pour écrire la documentation du site + (<<apt>> ou <<rst>>) (par défaut <<rst>>).\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {central.release.home.url} + + L'url du dépôt des releases dite central-safe.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {other.release.home.url} + + L'url du dépôt des releases dite none central-safe.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {repository.home.url} + + L'url du dépôt maven de release du projet. Par défault on utilise + le {{{http://maven.nuiton.org/other-releases}dépôt non central safe }}. + + En utilisant le profile <<central-safe>>, cette propriété passe à : + {{{http://maven.nuiton.org/central-releases}dépôt central safe}}\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {scmwebeditorEnabled} + + Pour activer (ou déasactiver) la génération des liens scmwebeditors dans les sites + générés. (Par exemple, on ne peut pas gérer ces liens sur un svn ssh...).\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {scmwebeditorUrl} + + L'url de l'application scmwebeditor qui permet d'éditer le site en ligne.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {piwikEnabled} + Pour activer (ou déasactiver) la génération de l'analyze du site généré via + Piwik.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {piwikId} + Pour utiliser un id de site Piwik particulier pour le site générer. Par défaut + non renseigné, on utilisera celui de la forge qui héberge le projet.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {sonar.host.url} + + L'url du serveur sonar.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {jenkins.host.url} + + L'url du serveur jenkins.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {repository.home.url} + + L'url de dépôt maven de type release de Code Lutin. Cette propriété est + utilisée dans les sites pour les liens de téléchargement.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +* Détail des propriétés pour les déployements + +** {snapshot.repository} + + Url du dépôt maven où deployer les snapshots, par défaut : <<(snapshot.repository)>>.\ + {{{Propriétés pour les déployements}[remonter]}} + +** {snapshot.server} + + Id du serveur à utiliser pour déployer les snapshots, par défault : <<nuiton-nexus-deploy>>.\ + + <<Note:>> le serveur doit être défini dans le <<settings.xml>>.\ + {{{Propriétés pour les déployements}[remonter]}} + +** {our.snapshot.repository} + + Url du dépôt maven Nuiton où deployer les snapshots. + + Valeur par défaut (<<ne devrait pas être modifiée>>) : + +-------------------------------------------------------------------------------- +scpexe://nuiton.org/var/lib/nexus/storage/snapshots +-------------------------------------------------------------------------------- + {{{Propriétés pour les déployements}[remonter]}} + +** {release.repository} + + Url du dépôt maven où deployer les releases, par défaut : <<(other.release.repository)>>.\ + {{{Propriétés pour les déployements}[remonter]}} + +** {release.server} + + Id du serveur à utiliser pour déployer les releases, par défaut : <<nuiton-nexus-deploy>>. + + <<Note:>> le serveur doit être défini dans le <<settings.xml>>.\ + {{{Propriétés pour les déployements}[remonter]}} + +** {other.release.repository} + + Url du dépôt maven de Nuiton où deployer les releases <<central-unsafe>>. + + Valeur par défaut (<<ne devrait pas être modifiée>>) : + +-------------------------------------------------------------------------------- +scpexe://nuiton.org/var/lib/nexus/storage/other-releases +-------------------------------------------------------------------------------- + {{{Propriétés pour les déployements}[remonter]}} + +** {central.release.repository} + + Url du dépôt maven de Nuiton où deployer les releases <<central-safe>>. + + Valeur par défaut (<<ne devrait pas être modifiée>>) : + +-------------------------------------------------------------------------------- +scpexe://nuiton.org/var/lib/nexus/storage/central-releases +-------------------------------------------------------------------------------- + {{{Propriétés pour les déployements}[remonter]}} + +** {our.site.repository} + + Url du dépôt maven de Nuiton où deployer les sites. + + Valeur par défaut (<<ne devrait pas être modifiée>>) : + +-------------------------------------------------------------------------------- +scpexe://nuiton.org/var/lib/redmine-(platform)/project-site/(projectId) +-------------------------------------------------------------------------------- + {{{Propriétés pour les déployements}[remonter]}} + Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom/properties.apt.vm ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom/release.apt (from rev 1241, trunk/mavenpomdoc/src/site/apt/release.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom/release.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom/release.apt 2012-04-20 08:59:10 UTC (rev 1242) @@ -0,0 +1,107 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Effectuer une release +------ +------ +2010-01-10 +------ + +Abstract + + Cette page décrit la méthode pour effectuer une release de mavenpom. Mavenpom devant être neutre + par rapport à un quelconque environnement, on utilise des profiles uniquement réservés à <<mavenpom>>. + + + L'opération se déroule en 3 étapes. + +Etape 1 + + Effectuer une release normal + +-------------------------------------------------------------------------------- +mvn release:prepare -Dinternal +mvn release:perform -Dinternal +-------------------------------------------------------------------------------- + +Etape 2 + + Dans cette phase, on va : + + * Deployement des fichiers vers redmine + + * Créer les announces de release + + [] + + On travaille sur la version utilisée pour faire la release. + +-------------------------------------------------------------------------------- +cd target/checkout +-------------------------------------------------------------------------------- + + La commande suivante simule (sans rien déployer) + +-------------------------------------------------------------------------------- +mvn -Dinternal -DinternalRedminePreRelease -N +-------------------------------------------------------------------------------- + + Si aucune erreur lors de l'execution, on lance la commande suivante + +-------------------------------------------------------------------------------- +mvn -Dinternal -DinternalRedminePreRelease -DdryRun=false -N +-------------------------------------------------------------------------------- + + A ce stade, les annonces ont été créées ici + +-------------------------------------------------------------------------------- +target/generated-sources/announcement/release-news-announcement.vm +target/generated-sources/announcement/release-email-announcement.vm +-------------------------------------------------------------------------------- + +Etape 3 + + On finalise la release après avoir finaliser les annonces (si nécessaire) : + + * Mise à jour de la version sur redmine (on la clôture) + + * Envoie de l'email d'annonce de release + + * Publication de l'annonce de release sur redmine + + [] + + La commande suivante simule (sans rien publier) : + +-------------------------------------------------------------------------------- +mvn -Dinternal -DinternalRedmineRelease -N +-------------------------------------------------------------------------------- + + Si aucune erreur, on peut lancer la commande réelle + +-------------------------------------------------------------------------------- +mvn -Dinternal -DinternalRedmineRelease -DdryRun=false -N +-------------------------------------------------------------------------------- Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom/release.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom/repositories.apt (from rev 1241, trunk/mavenpomdoc/src/site/apt/repositories.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom/repositories.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom/repositories.apt 2012-04-20 08:59:10 UTC (rev 1242) @@ -0,0 +1,156 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Utilisation des dépôts maven +------ +------ +2010-06-17 +------ + +Présentation + + Cette page explique comment configurer mavenpom pour déployer des artifacts. + + On distingue trois types de serveur : + + * dépôt maven de snapshots (voir {{{Déployer une snapshot}section snapshot}}). + + * dépôt maven de releases (voir {{{Déployer une release}section release}}). + + * dépôt de sites (voir {{{Déployer un site}section site}}). + +Déployer une snapshot + + Mavenpom définit grâce à deux propriétés : + + * {{{./properties.html#snapshot.repository}snapshot.repository}} + + * {{{./properties.html#snapshot.server}snapshot.server}} + + [] + + En résumé, voici la définition du serveur où déployer les snapshots : + +-------------------------------------------------------------------------------- +<snapshotRepository> + <id>${snapshot.server}</id> + <url>${snapshot.repository}</url> +</snapshotRepository> +-------------------------------------------------------------------------------- + + Par défaut, on utilise les valeurs suivantes pour le paramétrage : + + * <repository> : {{{./properties.html#our.snapshot.repository}our.snapshot.repository}} + + * <server> : <<nuiton>> + + Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> + une nouvelle valeur pour l'un des deux paramètres.\ + {{{Présentation}[remonter]}} + +Déployer une release + + Mavenpom définit grâce à deux propriétés : + + * {{{./properties.html#release.repository}release.repository}} + + * {{{./properties.html#release.server}release.server}} + + [] + + En résumé, voici la définition du serveur où déployer les releases : + +-------------------------------------------------------------------------------- +<repository> + <id>${release.server}</id> + <url>${release.repository}</url> +</repository> +-------------------------------------------------------------------------------- + + Par défaut, on utilise les valeurs suivantes pour le paramétrage : + + * <repository> : {{{./properties.html#other.release.repository}other.release.repository}} + + * <server> : <<nuiton>> + + Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> + une nouvelle valeur pour l'un des deux paramètres.\ + {{{Présentation}[remonter]}} + +* Paramétrage pour un projet <<central-unsafe>> + + Il suffit d'utiliser la configuration par défaut. + {{{Présentation}[remonter]}} + +* Paramétrage pour un projet <<central-safe>> + + Pour rendre un projet central-safe, il faut utiliser le bon dépôt de release : + {{{./properties.html#central.release.repository}central.release.repository}}. + + Pour assurer que le projet est bien compatible, on inclut le profile + <<central-safe>> dans le cycle de release. + + Pour ce faire ajouter dans la section <<properties>> du projet ceci : + +-------------------------------------------------------------------------------- +  + +  + <arguments>-DperformRelease -Pcentral-safe</arguments> + +  + <releaseProfiles>central-safe</releaseProfiles> +-------------------------------------------------------------------------------- + {{{Présentation}[remonter]}} + +Déployer un site + + Mavenpom définit grâce à deux propriétés : + + * {{{./properties.html#site.repository}site.repository}} + + * {{{./properties.html#site.server}site.server}} + + [] + + En résumé, voici la définition du serveur où déployer les sites : + +-------------------------------------------------------------------------------- +<site> + <id>${site.server}</id> + <url>${site.repository}</url> +</site> +-------------------------------------------------------------------------------- + + Par défaut, on utilise les valeurs suivantes pour le paramétrage : + + * <repository> : {{{./properties.html#our.site.repository}our.site.repository}} + + * <server> : <<nuiton>> + + Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> + une nouvelle valeur pour l'un des deux paramètres.\ + {{{Présentation}[remonter]}} \ No newline at end of file Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom/repositories.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Deleted: trunk/mavenpomdoc/src/site/apt/profiles.apt =================================================================== --- trunk/mavenpomdoc/src/site/apt/profiles.apt 2012-04-19 16:39:07 UTC (rev 1241) +++ trunk/mavenpomdoc/src/site/apt/profiles.apt 2012-04-20 08:59:10 UTC (rev 1242) @@ -1,408 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2009 - 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Profiles disponibles dans mavenpom ------- ------- -2009-10-11 ------- - -Abstract - - Cette page décrit l'ensemble des profiles ajoutés (ou surchargés) dans mavenpom - et disponibles pour tous les projets qui en héritent. - - <<Notation:>> Pour définir l'utilisation d'un propriété du projet, on écrit : - --------------------------------------------------------------------------------- -(propriété) --------------------------------------------------------------------------------- - -Vue d'ensemble - -* Profiles autonomes - - Il s'agit de profiles qui peuvent être inclus lors d'un build pour effectuer - des tâches diverses. - -*----------------------------------+------------------------------+ -| <<Nom du profile>> | <<Propriété d'activation>> | -*----------------------------------+------------------------------+ -| {{no-tests}} | <<->> | -*----------------------------------+------------------------------+ -| {{no-reports}} | <<->> | -*----------------------------------+------------------------------+ -| {{no-dep-details}} | <<->> | -*----------------------------------+------------------------------+ -| {{no-dep-locations}} | <<->> | -*----------------------------------+------------------------------+ -| {{webstart-profile}} | <<doWebstart>> | -*----------------------------------+------------------------------+ -| {{local-webstart-profile}} | <<doLocalWebstart>> | -*----------------------------------+------------------------------+ -| {{run}} | <<->> | -*----------------------------------+------------------------------+ -| {{staging-site-profile}} | <<stagingSite>> | -*----------------------------------+------------------------------+ - -* Profiles inclus dans le cycle de release - - L'ensemble des profiles inclus lors d'un cycle de release. - -*----------------------------------+------------------------------+ -| <<Nom du profile>> | <<Propriété d'activation>> | -*----------------------------------+------------------------------+ -| {{reporting}} | <<performRelease>> | -*----------------------------------+------------------------------+ -| {{release-profile}} | <<performRelease>> | -*----------------------------------+------------------------------+ -| {{license-profile}} | <<performRelease>> | -*----------------------------------+------------------------------+ -| {{update-file-header}} | <<performRelease>> | -*----------------------------------+------------------------------+ -| {{release-sign-artifacts}} | <<performRelease>> | -*----------------------------------+------------------------------+ -| {{central-safe}} | - | -*----------------------------------+------------------------------+ - -* Profiles inclus dans le cycle de release de mavenpom - - L'ensemble des profiles inclus lors d'un cycle de release de mavenpom. - -*----------------------------------+------------------------------+ -| <<Nom du profile>> | <<Propriété d'activation>> | -*----------------------------------+------------------------------+ -| {{internal}} | <<internal>> | -*----------------------------------+------------------------------+ -| {{internal-redmine-pre-release}} | <<internalRedminePreRelease>>| -*----------------------------------+------------------------------+ -| {{internal-redmine-release}} | <<internalRedmineRelease>> | -*----------------------------------+------------------------------+ - -Détails - -* Profiles autonomes - -** {no-tests} - - Ce profile permet de ne pas lancer les tests. - {{{Profiles autonomes}[remonter]}} - --------------------------------------------------------------------------------- -mvn install -Pno-tests --------------------------------------------------------------------------------- - -** {no-reports} - - Ce profile permet de ne pas lancer la génération des rapports sur le cycle - <site>. - --------------------------------------------------------------------------------- -mvn site -Pno-reports --------------------------------------------------------------------------------- - {{{Profiles autonomes}[remonter]}} - -* {run} - - Ce profile permet de lancer une classe java depuis maven. Il faut définir une - propriété <maven.jar.main.class> qui exprime le nom qualifié de la classe à - lancer. - --------------------------------------------------------------------------------- -mvn -Prun -Dmaven.jar.main.class=org.nuiton.MyMainClass --------------------------------------------------------------------------------- - {{{Profiles autonomes}[remonter]}} - -** {no-dep-details} - - Ce profile permet de désactiver la génération du détail des dépendances - lors du rapport des dépendances (accélère beaucoup les temps de génération du - site en phase de développement). - --------------------------------------------------------------------------------- -mvn site -Pno-dep-details --------------------------------------------------------------------------------- - {{{Profiles autonomes}[remonter]}} - -** {no-dep-locations} - - Ce profile permet de désactiver la génération de la localisation des - dépendances lors du rapport des dépendances (accélère beaucoup les temps de - génération du site en phase de développement). - --------------------------------------------------------------------------------- -mvn site -Pno-dep-locations --------------------------------------------------------------------------------- - {{{Profiles autonomes}[remonter]}} - -** {webstart-profile} - - Ce profile est utilisé pour construire l'application webstart associé à un - module de type <<jar>>. - - Ce profile est utilisable en activant la propriété <<doWebstart>> : - --------------------------------------------------------------------------------- -mvn package -Pwebstart-profile --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- -mvn package -PdoWebstart --------------------------------------------------------------------------------- - {{{Profiles autonomes}[remonter]}} - -** {local-webstart-profile} - - Ce profile est utilisé pour construire l'application webstart associé à un - module de type <<jar>>. - - Le codebase du webstart généré pointe sur target/jnlp, ainsi on peut tester - en local le webstart avant tout déployement. - - Ce profile est utilisable en activant la propriété <<doLocalWebstart>> : - --------------------------------------------------------------------------------- -mvn package -Plocal-webstart-profile --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- -mvn package -PdoLocalWebstart --------------------------------------------------------------------------------- - {{{Profiles autonomes}[remonter]}} - -** {staging-site-profile} - - Ce profile permet de deployer un site en local, pratique pour tester les - sites multi-modules sans avoir à deployer sur un serveur distant. - - Le profile utilise un server <<staging-site>> à définir dans votre - <settings.xml>. - - Il est possible de définir en ligne de commande l'url où deployer via la - propriété <<stagingUrl>>. - --------------------------------------------------------------------------------- - mvn -Pstaging-site-profile -DstagingUrl=scpexe://myServer/myPath --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- - mvn -DstagingSite -DstagingUrl=scpexe://myServer/myPath --------------------------------------------------------------------------------- - {{{Profiles autonomes}[remonter]}} - -* Profiles inclus dans le cycle de release - -** {reporting} - - Ce profile regroupe tous les reports utilisés pour la génération du site. - L'intérêt de les mettre dans un profile est de pouvoir générer simplement - uniquement la documentation du site sans aucun raport. - - Ce profile est utilisable en activant la propriété <performRelease> : - --------------------------------------------------------------------------------- -mvn site -Preporting --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- -mvn site -DperformRelease --------------------------------------------------------------------------------- - {{{Profiles inclus dans le cycle de release}[remonter]}} - -** {release-profile} - - Ce profile (défini par maven) est utilisé lors d'un <mvn release:perform>. - On y indique qu'il faut toujours inclure les sources et la javadoc. - - Ce profile est utilisable en activant la propriété <performRelease> : - --------------------------------------------------------------------------------- -mvn deploy -Prelease-profile --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- -mvn deploy -DperformRelease --------------------------------------------------------------------------------- - - A noter que lors d'un deploy (par exemple d'une snapshot), on <<doit>> - l'utiliser afin que les utilisateurs puissent récupérer les sources et la - javadoc dans leur IDE favori.\ - {{{Profiles inclus dans le cycle de release}[remonter]}} - -** {license-profile} - - Ce profile est utilisé lors des release. - On y indique qu'il faut toujours générer le fichier THIRD-PARTY et synchroniser les licenses. - - Ce profile est utilisable en activant la propriété <performRelease> : - --------------------------------------------------------------------------------- -mvn -Plicense-profile --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- -mvn deploy -DperformRelease --------------------------------------------------------------------------------- - -** {release-sign-artifacts} - - Ce profile est utilisé pour signé avec gpg les artifacts à installer ou - déployer. - - Pour pouvoir l'utiliser il faut que : - - * avoir une clef gpg de nom <<Code Lutin>> - - * avoir dans son <settings.xml> un server de nom <<gpg-signer>> qui contient : - - * username : <<Code Lutin>> - - * password : la passephrase de la clef gpg (encodé bien sûr...) - - [] - - [] - - Le clef gpg utilisé est visible {{{http://pgp.mit.edu:11371/pks/lookup?search=Code+Lutin&op=index&fingerprint=on&exact=on}ici}}. - - Pour la récupérer, executer la commande - --------------------------------------------------------------------------------- -gpg --keyserver hkp://pgp.mit.edu --recv-keys 014A6ED2 --------------------------------------------------------------------------------- - - - {{{Profiles inclus dans le cycle de release}[remonter]}} - -** {update-file-header} - - Ce profile permet la mise à jour des entêtes de tous les fichiers d'un - projet en utilisant le nouveau goal <update-file-header> - (depuis maven-license-plugin 2.1). - - Il faut avoir définit un fichier - --------------------------------------------------------------------------------- -license.descriptor --------------------------------------------------------------------------------- - - qui est par défaut <<src/license/project.xml>>. - - Ce fichier décrit les en-têtes à inspecter. - --------------------------------------------------------------------------------- -mvn -Pupdate-file-header --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- -mvn -DperformRelease --------------------------------------------------------------------------------- - {{{Profiles inclus dans le cycle de release}[remonter]}} - -** {central-safe} - - Ce profile permet de vérifier que toutes les dépendances du projets sont sur - central et central-release. - - Il n'est pas inclus directement dans le cycle de release (car seul les projets - central-safe doivent l'utiliser). - - Pour l'utiliser lors d'une release ajouter ceci dans la section <<properties>> - de votre pom : - --------------------------------------------------------------------------------- -  - -  - <arguments>-DperformRelease -Dcentral-safe</arguments> - -  - <releaseProfiles>central-safe</releaseProfiles> --------------------------------------------------------------------------------- - - Pour le lancer manuellement : - --------------------------------------------------------------------------------- -mvn -Pcentral-safe --------------------------------------------------------------------------------- - {{{Profiles inclus dans le cycle de release}[remonter]}} - -* Profiles inclus dans le cycle de release de mavenpom - -** {internal} - - Ce profile permet de corriger l'url de deployement du site de <mavenpom> - et il <<DOIT>> être toujours utilisé lors d'une installation déployement - ou d'une release. - - Il est activable via la propriété <<internal>>. - - Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. - - Pour plus d'information sur ce profile voir la page des - {{{./release.html}release}}.\ - {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} - -** {internal-redmine-pre-release} - - Ce profile permet de préparer la finalisation de la release en générant - les annonces de release. - - Il est activable via la propriété <<internalRedminePreRelease>>. - - Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. - - Pour plus d'information sur ce profile voir la page des - {{{./release.html}release}}.\ - {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} - -** {internal-redmine-release} - - Ce profile permet de finaliser la release de <<mavenpom>> en publiant - les annonces de release. - - - Il est activable via la propriété <<internalRedmineRelease>>. - - Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. - - Pour plus d'information sur ce profile voir la page des - {{{./release.html}release}}.\ - {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} Deleted: trunk/mavenpomdoc/src/site/apt/properties.apt.vm =================================================================== --- trunk/mavenpomdoc/src/site/apt/properties.apt.vm 2012-04-19 16:39:07 UTC (rev 1241) +++ trunk/mavenpomdoc/src/site/apt/properties.apt.vm 2012-04-20 08:59:10 UTC (rev 1242) @@ -1,620 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2009 - 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Propriétés disponibles dans mavenpom ------- ------- -2009-10-11 ------- - -Abstract - - Cette page décrit l'ensemble des propriétés ajoutés dans mavenpom et disponibles - pour tous les projets qui héritent de mavenpom. - - <<Notation:>> Pour définir l'utilisation d'un propriété du projet, on écrit : - --------------------------------------------------------------------------------- -(propriété) --------------------------------------------------------------------------------- - -Vue d'ensemble - -* Propriétés générales du projet - -*--------------------------------------+------------------------------------------------------+ -| <<Propriété>> | <<Valeur par défaut>> | -*--------------------------------------+------------------------------------------------------+ -| {{platform}} | <<nuiton.org>> | -*--------------------------------------+------------------------------------------------------+ -| {{projectId}} | <<(project.artifactId)>> | -*--------------------------------------+------------------------------------------------------+ -| {{listId}} | <<(projectId)>> | -*--------------------------------------+------------------------------------------------------+ -| {{maven.src.dir}} | <<(project.basedir)/src>> | -*--------------------------------------+------------------------------------------------------+ -| {{maven.gen.dir}} | <<(project.build.directory)/generated-sources>> | -*--------------------------------------+------------------------------------------------------+ -| {{maven.license.file}} | <<(project.basedir)/LICENSE.txt>> | -*--------------------------------------+------------------------------------------------------+ - -* Propriétés de versions - -*--------------------------------------+--------------------------------------+ -| <<Propriété>> | <<Valeur par défaut>> | -*--------------------------------------+--------------------------------------+ -| {{mavenVersion}} | <<${mavenVersion}>> | -*--------------------------------------+--------------------------------------+ -| {{antVersion}} | <<${antVersion}>> | -*--------------------------------------+--------------------------------------+ -| {{nuitonSkinVersion}} | <<${nuitonSkinVersion}>> | -*--------------------------------------+--------------------------------------+ - - Pour avoir la liste de toutes les dépendances mutualisées dans le projet, - aller sur la page {{{./dependency-management.html}des versions supportées}}. - - Chaque dépendance possède une propriété pour définir sa version, afin de vous - permettre dans vos poms de pouvoir facilement surcharger la version d'une telle - dépendances sans avoir à changer de version de mavenpom. - -*-------------------------------+--------------------------------------------------------------------------+ -| <<Propriété>> | <<librarie>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsBeanutilsVersion}} | <<commons-beanutils:commons-beanutils:${commonsBeanutilsVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsCollectionsVersion}} | <<commons-collections:commons-collections:${commonsCollectionsVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsEmailVersion}} | <<org.apache.commons:commons-email:${commonsEmailVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsHttpclientVersion}} | <<commons-httpclient:commons-httpclient:${commonsHttpclientVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsIoVersion}} | <<commons-io:commons-io:${commonsIoVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsJxpathVersion}} | <<commons-jxpath:commons-jxpath:${commonsJxpathVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsLangVersion}} | <<commons-lang:commons-lang:${commonsLangVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsLang3Version}} | <<org.apache.commons:commons-lang3:${commonsLang3Version}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsLoggingVersion}} | <<commons-logging:commons-logging:${commonsLoggingVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsPrimitivesVersion}} | <<commons-primitives:commons-primitives:${commonsPrimitivesVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{commonsMathVersion}} | <<org.apache.commons:commons-math:${commonsMathVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{guavaVersion}} | <<com.google.guava:guava:${guavaVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{junitVersion}} | <<junit:junit:${junitVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{log4jVersion}} | <<log4j:log4j:${log4jVersion}>> | -*-------------------------------+--------------------------------------------------------------------------+ - -* Propriétés de versions de plugins - - On définit dans le mavenpom beaucoup de versions de plugins. En consultant la - page {{{./plugin-management.html}des versions de plugins supportés}}. - - Comme pour les librairies, on définit une propriété pour chaque plugin définit - et ceci pour les même raisons. - - A noter que si un plugin est aussi un report il est nécessaire dans la partie report - de refournir la version du plugin (merci d'utiliser la propriété et non pas une - version en dure). - -** Plugins nuiton - -*-------------------------------+--------------------------------------------------------------------------+ -| <<Propriété (plugins nuton)>> | <<GAV>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{helperPluginVersion}} | {{{http://maven-site.nuiton.org/maven-helper-plugin} <<org.nuiton:helper-maven-plugin:${helperPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{jredminePluginVersion}} | {{{http://maven-site.nuiton.org/jredmine/maven-jredmine-plugin} <<org.nuiton.jredmine:maven-jredmine-plugin:${jredminePluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{jrstPluginVersion}} | {{{http://maven-site.nuiton.org/jrst/doxia-module-jrst} <<org.nuiton.jrst:doxia-module-jrst:${jrstPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ - -** Plugins maven - -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{Propriété (plugins maven)}} | <<GAV>> | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{antRunPluginVersion}} | {{{http://maven.apache.org/plugins/maven-antrun-plugin}<<org.apache.maven.plugins:maven-antrun-plugin:${antRunPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{assemblyPluginVersion}} | {{{http://maven.apache.org/plugins/maven-assembly-plugin}<<org.apache.maven.plugins:maven-assembly-plugin:${assemblyPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{cleanPluginVersion}} | {{{http://maven.apache.org/plugins/maven-clean-plugin}<<org.apache.maven.plugins:maven-clean-plugin:${cleanPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{compilerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-compiler-plugin}<<org.apache.maven.plugins:maven-compiler-plugin:${compilerPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{dependencyPluginVersion}} | {{{http://maven.apache.org/plugins/maven-dependency-plugin}<<org.apache.maven.plugins:maven-dependency-plugin:${dependencyPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{deployPluginVersion}} | {{{http://maven.apache.org/plugins/maven-deploy-plugin}<<org.apache.maven.plugins:maven-deploy-plugin:${deployPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{earPluginVersion}} | {{{http://maven.apache.org/plugins/maven-ear-plugin}<<org.apache.maven.plugins:maven-ear-plugin:${earPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{ejbPluginVersion}} | {{{http://maven.apache.org/plugins/maven-ejb-plugin}<<org.apache.maven.plugins:maven-ejb-plugin:${ejbPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{enforcerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-enforcer-plugin}<<org.apache.maven.plugins:maven-enforcer-plugin:${enforcerPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{gpgPluginVersion}} | {{{http://maven.apache.org/plugins/maven-gpg-plugin}<<org.apache.maven.plugins:maven-gpg-plugin:${gpgPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{installPluginVersion}} | {{{http://maven.apache.org/plugins/maven-install-plugin}<<org.apache.maven.plugins:maven-install-plugin:${installPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{invokerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-invoker-plugin}<<org.apache.maven.plugins:maven-invoker-plugin:${invokerPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{jarPluginVersion}} | {{{http://maven.apache.org/plugins/maven-jar-plugin}<<org.apache.maven.plugins:maven-jar-plugin:${jarPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{javadocPluginVersion}} | {{{http://maven.apache.org/plugins/maven-javadoc-plugin}<<org.apache.maven.plugins:maven-javadoc-plugin:${javadocPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{pluginPluginVersion}} | {{{http://maven.apache.org/plugins/maven-plugin-plugin}<<org.apache.maven.plugins:maven-plugin-plugin:${pluginPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{pmdPluginVersion}} | {{{http://maven.apache.org/plugins/maven-pmd-plugin}<<org.apache.maven.plugins:maven-pmd-plugin:${pmdPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{releasePluginVersion}} | {{{http://maven.apache.org/plugins/maven-release-plugin}<<org.apache.maven.plugins:maven-release-plugin:${releasePluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{remoteResourcesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-remote-resources-plugin}<<org.apache.maven.plugins:maven-remote-resources-plugin:${remoteResourcesPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{resourcesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-resources-plugin}<<org.apache.maven.plugins:maven-resources-plugin:${resourcesPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{site2PluginVersion}} | {{{http://maven.apache.org/plugins/maven-site-plugin}<<org.apache.maven.plugins:maven-site-plugin:${site2PluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{site3PluginVersion}} | {{{http://maven.apache.org/plugins/maven-site-plugin-3.0-beta-3}<<org.apache.maven.plugins:maven-site-plugin:${site3PluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{sourcePluginVersion}} | {{{http://maven.apache.org/plugins/maven-source-plugin}<<org.apache.maven.plugins:maven-source-plugin:${sourcePluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{surefirePluginVersion}} | {{{http://maven.apache.org/plugins/maven-surefire-plugin}<<org.apache.maven.plugins:maven-surefire-plugin:${surefirePluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ -| {{warPluginVersion}} | {{{http://maven.apache.org/plugins/maven-war-plugin}<<org.apache.maven.plugins:maven-war-plugin:${warPluginVersion}>>}} | -*----------------------------------+---------------------------------------------------------------------------------------------+ - -** Plugins mojo (codehaus) - -*-------------------------------+--------------------------------------------------------------------------+ -| {{Propriété (plugins mojo)}} | <<GAV>> | -*-------------------------------+--------------------------------------------------------------------------+ -| {{coberturaPluginVersion}} | {{{http://mojo.codehaus.org/cobertura-maven-plugin}<<org.codehaus.mojo:cobertura-maven-plugin:${coberturaPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{execPluginVersion}} | {{{http://mojo.codehaus.org/exec-maven-plugin}<<org.codehaus.mojo:exec-maven-plugin:${execPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{findbugsPluginVersion}} | {{{http://mojo.codehaus.org/findbugs-maven-plugin}<<org.codehaus.mojo:findbugs-maven-plugin:${findbugsPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{gwtPluginVersion}} | {{{http://mojo.codehaus.org/gwt-maven-plugin}<<org.codehaus.mojo:gwt-maven-plugin:${gwtPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{licensePluginVersion}} | {{{http://mojo.codehaus.org/license-maven-plugin}<<codehaus.mojo:license-maven-plugin:${licensePluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{versionsPluginVersion}} | {{{http://mojo.codehaus.org/versions-maven-plugin}<<org.codehaus.mojo:versions-maven-plugin:${versionsPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{wagonPluginVersion}} | {{{http://mojo.codehaus.org/wagon-maven-plugin}<<org.codehaus.mojo:wagon-maven-plugin:${wagonPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ -| {{webstartPluginVersion}} | {{{http://mojo.codehaus.org/webstart/webstart-maven-plugin}<<org.codehaus.mojo.webstart:webstart-maven-plugin:${webstartPluginVersion}>>}} | -*-------------------------------+--------------------------------------------------------------------------+ - -** Plugins plexus (mojo) - -*-------------------------------+------------------------------------------------------------------------------------------------------+ -| {{Propriété (plugins plexus)}} | <<GAV>> | -*------------------------------------------+-------------------------------------------------------------------------------------------+ -| {{plexusPluginVersion}} | {{{http://plexus.codehaus.org/plexus-maven-plugin}<<org.codehaus.plexus:plexus-maven-plugin:${plexusPluginVersion}>>}} | -*------------------------------------------+-------------------------------------------------------------------------------------------+ -| {{plexusComponentMetadataPluginVersion}} | {{{http://plexus.codehaus.org/plexus-containers/plexus-component-metadata}<<org.codehaus.plexus:plexus-component-metadata:${plexusComponentMetadataPluginVersion}>>}} | -*------------------------------------------+-------------------------------------------------------------------------------------------+ - -** Autres plugins - -*-------------------------------------+------------------------------------------------------------------------------------------------+ -| {{Propriété (autre plugins)}} | <<GAV>> | -*-------------------------------------+------------------------------------------------------------------------------------------------+ -| {{androidPluginVersion}} | <<com.jayway.maven.plugins.android.generation2:maven-android-plugin:${androidPluginVersion}>> | -*-------------------------------------+------------------------------------------------------------------------------------------------+ -| {{jettyPluginVersion}} | {{{http://mojo.codehaus.org/jetty-maven-plugin}<<org.mortbay.jetty:jetty-maven-plugin:${jettyPluginVersion}>>}} | -*-------------------------------------+------------------------------------------------------------------------------------------------+ -| {{tomcatPluginVersion}} | {{{http://tomcat.apache.org/maven-plugin-${tomcatPluginVersion}/}<<org.apache.tomcat.maven:tomcat6-maven-plugin:${tomcatPluginVersion}>>}} | -*-------------------------------------+------------------------------------------------------------------------------------------------+ -| {{tomcatPluginVersion}} | {{{http://tomcat.apache.org/maven-plugin-${tomcatPluginVersion}/}<<org.apache.tomcat.maven:tomcat7-maven-plugin:${tomcatPluginVersion}>>}} | -*-------------------------------------+------------------------------------------------------------------------------------------------+ -| {{statScmPluginVersion}} | {{{http://stat-scm.sourceforge.net}<<net.sf:stat-scm:${statScmPluginVersion}>>}} | -*-------------------------------------+------------------------------------------------------------------------------------------------+ - -** Plugins de report - -*-------------------------------------+----------------------------------------------------------------------------------------------------+ -| {{Propriété (reports)}} | <<GAV>> | -*-------------------------------------+----------------------------------------------------------------------------------------------------+ -| {{changesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-changes-plugin}<<org.apache.maven.plugins:maven-changes-plugin:${changesPluginVersion}>>}} | -*-------------------------------------+----------------------------------------------------------------------------------------------------+ -| {{projectInfoReportsPluginVersion}} | {{{http://maven.apache.org/plugins/maven-project-info-reports-plugin}<<org.apache.maven.plugins:maven-project-info-reports-plugin:${projectInfoReportsPluginVersion}>>}} | -*-------------------------------------+----------------------------------------------------------------------------------------------------+ -| {{changelogPluginVersion}} | {{{http://maven.apache.org/plugins/maven-changelog-plugin}<<org.apache.maven.plugins:maven-changelog-plugin:${changelogPluginVersion}>>}} | -*-------------------------------------+----------------------------------------------------------------------------------------------------+ -| {{jrxPluginVersion}} | {{{http://maven.apache.org/plugins/maven-jxr-plugin}<<org.apache.maven.plugins:maven-jxr-plugin:${jrxPluginVersion}>>}} | -*-------------------------------------+----------------------------------------------------------------------------------------------------+ -| {{sonarReportPluginVersion}} | {{{http://docs.codehaus.org/display/SONAR/Sonar+Maven+report}<<org.codehaus.sonar-plugins:maven-report:${sonarReportPluginVersion}>>}} | -*-------------------------------------+----------------------------------------------------------------------------------------------------+ - - -* Propriétés de génération de site et reports - -*--------------------------------------+--------------------------------------------------------+ -| <<Propriété>> | <<Valeur par défaut>> | -*--------------------------------------+--------------------------------------------------------+ -| {{siteSourcesType}} | <<rst>> | -*--------------------------------------+--------------------------------------------------------+ -| {{scmwebeditorEnabled}} | <<true>> | -*--------------------------------------+--------------------------------------------------------+ -| {{piwikEnabled}} | <<true>> | -*--------------------------------------+--------------------------------------------------------+ -| {{piwikId}} | << - >> | -*--------------------------------------+--------------------------------------------------------+ -| {{central.release.home.url}} | <<http://maven.nuiton.org/central-releases>> | -*--------------------------------------+--------------------------------------------------------+ -| {{other.release.home.url}} | <<http://maven.nuiton.org/other-releases>> | -*--------------------------------------+--------------------------------------------------------+ -| {{repository.home.url}} | <<(other.release.home.url)>> | -*--------------------------------------+--------------------------------------------------------+ -| {{scmwebeditorUrl}} | <<http://scmwebeditor.nuiton.org/nuiton-scmwebeditor/scmwebeditor>>| -*--------------------------------------+--------------------------------------------------------+ -| {{maven.javadoc.skip}} | <<false>> | -*--------------------------------------+--------------------------------------------------------+ -| {{maven.javadoc.quiet}} | <<true>> | -*--------------------------------------+--------------------------------------------------------+ -| {{ci.host.url}} | <<http://ci.(platform)/sonar>> | -*--------------------------------------+--------------------------------------------------------+ -| {{qa.host.url}} | <<http://qa.(platform)/jenkins>> | -*--------------------------------------+--------------------------------------------------------+ - -* Propriétés pour les déployements - -*--------------------------------------+--------------------------------------------------------+ -| <<Propriété>> | <<Valeur par défaut>> | -*--------------------------------------+--------------------------------------------------------+ -| {{snapshot.repository}} | <<(our.snapshot.repository)>> | -*--------------------------------------+--------------------------------------------------------+ -| {{snapshot.server}} | <<nuiton-nexus-deploy>> | -*--------------------------------------+--------------------------------------------------------+ -| {{our.snapshot.repository}} | <<http://nexus.nuiton.org/nexus/content/repositories/snapshots>>| -*--------------------------------------+--------------------------------------------------------+ -| {{release.repository}} | <<(other.release.repository)>> | -*--------------------------------------+--------------------------------------------------------+ -| {{release.server}} | <<nuiton-nexus-deploy>> | -*--------------------------------------+--------------------------------------------------------+ -| {{other.release.repository}} | <<http://nexus.nuiton.org/nexus/content/repositories/others-releases>> | -*--------------------------------------+--------------------------------------------------------+ -| {{central.release.repository}}| <<http://nexus.nuiton.org/nexus/content/repositories/central-releases>>| -*--------------------------------------+--------------------------------------------------------+ -| {{our.site.repository}} | <<scpexe://(platform)/var/lib/redmine-(platform)/project-site/(projectId)>> | -*--------------------------------------+--------------------------------------------------------+ - -Détails - -* Détail des propriétés générales du projet - -** {platform} - - Le host de la plateforme utilisée. - --------------------------------------------------------------------------------- -nuiton.org -chorem.org -forge.codelutin.com -labs.libre-entreprise.org --------------------------------------------------------------------------------- - {{{Propriétés générales du projet}[remonter]}} - -** {projectId} - - L'identifiant unique du projet associé. - --------------------------------------------------------------------------------- -(project.artifactId) --------------------------------------------------------------------------------- - - <Note :> Sur un multi-module, la propriété doit être surchargé, sinon on - se retrouve avec des valeurs héritiés sur les modules fils, ce qui n'est pas - correct.\ - {{{Propriétés générales du projet}[remonter]}} - -** {listId} - - Le préfixe utilisé pour les listes de diffusion. - --------------------------------------------------------------------------------- -(projectId) --------------------------------------------------------------------------------- - {{{Propriétés générales du projet}[remonter]}} - -** {maven.compile.source} - - Le niveau de java utilisé dans les sources (par défaut <<1.6>>)\ - {{{Propriétés générales du projet}[remonter]}} - -** {maven.compile.target} - - Le niveau de java utilisé dans le code compilé (par défaut <<1.6>>)\ - {{{Propriétés générales du projet}[remonter]}} - -** {maven.compile.encoding} - - Encoding à utiliser dans les sources (par défaut <<UTF-8>>)\ - {{{Propriétés générales du projet}[remonter]}} - -** {project.reporting.outputEncoding} - - Encoding à utiliser dans le site (par défaut <<UTF-8>>)\ - {{{Propriétés générales du projet}[remonter]}} - -** {maven.src.dir} - - Répertoire des sources - --------------------------------------------------------------------------------- -(project.basedir)/src --------------------------------------------------------------------------------- - {{{Propriétés générales du projet}[remonter]}} - -** {maven.gen.dir} - - Répertoire de génération - --------------------------------------------------------------------------------- -(project.basedir)/target/generated-sources --------------------------------------------------------------------------------- - {{{Propriétés générales du projet}[remonter]}} - -** {maven.license.file} - - Chemin vers la license utilisée dans le projet. - --------------------------------------------------------------------------------- -(project.basedir)/LICENSE.txt --------------------------------------------------------------------------------- - {{{Propriétés générales du projet}[remonter]}} - -* Détail des propriétés de versions - -** {mavenVersion} - - La version de l'api de maven utilisée (principalement dans les plugins maven) - : <<${mavenVersion}>>\ - {{{Propriétés de versions}[remonter]}} - -** {antVersion} - - La version de l'api de ant utilisée (principalement dans les modules de tâches ant).\ - {{{Propriétés de versions}[remonter]}} - -** {nuitonSkinVersion} - - La version de notre skin - {{{http://maven-site.nuiton.org/maven-nuiton-skin}maven-nuiton-skin}} - utilisé pour la génération des sites maven.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsBeanutilsVersion} - - La version de la librairie - {{{http://commons.apache.org/beanutils}commons-beanutils}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsCollectionsVersion} - - La version de la librairie - {{{http://commons.apache.org/collections}commons-collections}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsEmailVersion} - - La version de la librairie - {{{http://commons.apache.org/email}commons-email}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsHttpclientVersion} - - La version de la librairie - {{{http://hc.apache.org/httpclient-3.x}commons-http-client}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsIoVersion} - - La version de la librairie - {{{http://commons.apache.org/io}commons-io}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsJxpathVersion} - - La version de la librairie - {{{http://commons.apache.org/jxpath}commons-jxpath}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsLangVersion} - - La version de la librairie (en version 2) - {{{http://commons.apache.org/lang}commons-lang}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsLang3Version} - - La version de la librairie - {{{http://commons.apache.org/lang}commons-lang}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsLoggingVersion} - - La version de la librairie - {{{http://commons.apache.org/logging}commons-logging}}.\ - {{{Propriétés de versions}[remonter]}} - -** {commonsPrimitivesVersion} - - La version de la librairie - {{{http://commons.apache.org/primitives}commons-primitives}}.\ - {{{Propriétés de versions}[remonter]}} - -** {junitVersion} - - La version de la librairie - {{{http://www.junit.org}junit}}.\ - {{{Propriétés de versions}[remonter]}} - -** {log4jVersion} - - La version de la librairie - {{{http://logging.apache.org/log4j/1.2}log4j}}.\ - {{{Propriétés de versions}[remonter]}} - -* Détail des propriétés de génération de site et reports - -** {siteSourcesType} - - Le type de fichiers utilisé pour écrire la documentation du site - (<<apt>> ou <<rst>>) (par défaut <<rst>>).\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {central.release.home.url} - - L'url du dépôt des releases dite central-safe.\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {other.release.home.url} - - L'url du dépôt des releases dite none central-safe.\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {repository.home.url} - - L'url du dépôt maven de release du projet. Par défault on utilise - le {{{http://maven.nuiton.org/other-releases}dépôt non central safe }}. - - En utilisant le profile <<central-safe>>, cette propriété passe à : - {{{http://maven.nuiton.org/central-releases}dépôt central safe}}\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {scmwebeditorEnabled} - - Pour activer (ou déasactiver) la génération des liens scmwebeditors dans les sites - générés. (Par exemple, on ne peut pas gérer ces liens sur un svn ssh...).\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {scmwebeditorUrl} - - L'url de l'application scmwebeditor qui permet d'éditer le site en ligne.\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {piwikEnabled} - Pour activer (ou déasactiver) la génération de l'analyze du site généré via - Piwik.\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {piwikId} - Pour utiliser un id de site Piwik particulier pour le site générer. Par défaut - non renseigné, on utilisera celui de la forge qui héberge le projet.\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {sonar.host.url} - - L'url du serveur sonar.\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {jenkins.host.url} - - L'url du serveur jenkins.\ - {{{Propriétés de génération de site et reports}[remonter]}} - -** {repository.home.url} - - L'url de dépôt maven de type release de Code Lutin. Cette propriété est - utilisée dans les sites pour les liens de téléchargement.\ - {{{Propriétés de génération de site et reports}[remonter]}} - -* Détail des propriétés pour les déployements - -** {snapshot.repository} - - Url du dépôt maven où deployer les snapshots, par défaut : <<(snapshot.repository)>>.\ - {{{Propriétés pour les déployements}[remonter]}} - -** {snapshot.server} - - Id du serveur à utiliser pour déployer les snapshots, par défault : <<nuiton-nexus-deploy>>.\ - - <<Note:>> le serveur doit être défini dans le <<settings.xml>>.\ - {{{Propriétés pour les déployements}[remonter]}} - -** {our.snapshot.repository} - - Url du dépôt maven Nuiton où deployer les snapshots. - - Valeur par défaut (<<ne devrait pas être modifiée>>) : - --------------------------------------------------------------------------------- -scpexe://nuiton.org/var/lib/nexus/storage/snapshots --------------------------------------------------------------------------------- - {{{Propriétés pour les déployements}[remonter]}} - -** {release.repository} - - Url du dépôt maven où deployer les releases, par défaut : <<(other.release.repository)>>.\ - {{{Propriétés pour les déployements}[remonter]}} - -** {release.server} - - Id du serveur à utiliser pour déployer les releases, par défaut : <<nuiton-nexus-deploy>>. - - <<Note:>> le serveur doit être défini dans le <<settings.xml>>.\ - {{{Propriétés pour les déployements}[remonter]}} - -** {other.release.repository} - - Url du dépôt maven de Nuiton où deployer les releases <<central-unsafe>>. - - Valeur par défaut (<<ne devrait pas être modifiée>>) : - --------------------------------------------------------------------------------- -scpexe://nuiton.org/var/lib/nexus/storage/other-releases --------------------------------------------------------------------------------- - {{{Propriétés pour les déployements}[remonter]}} - -** {central.release.repository} - - Url du dépôt maven de Nuiton où deployer les releases <<central-safe>>. - - Valeur par défaut (<<ne devrait pas être modifiée>>) : - --------------------------------------------------------------------------------- -scpexe://nuiton.org/var/lib/nexus/storage/central-releases --------------------------------------------------------------------------------- - {{{Propriétés pour les déployements}[remonter]}} - -** {our.site.repository} - - Url du dépôt maven de Nuiton où deployer les sites. - - Valeur par défaut (<<ne devrait pas être modifiée>>) : - --------------------------------------------------------------------------------- -scpexe://nuiton.org/var/lib/redmine-(platform)/project-site/(projectId) --------------------------------------------------------------------------------- - {{{Propriétés pour les déployements}[remonter]}} - Deleted: trunk/mavenpomdoc/src/site/apt/release.apt =================================================================== --- trunk/mavenpomdoc/src/site/apt/release.apt 2012-04-19 16:39:07 UTC (rev 1241) +++ trunk/mavenpomdoc/src/site/apt/release.apt 2012-04-20 08:59:10 UTC (rev 1242) @@ -1,107 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2009 - 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Effectuer une release ------- ------- -2010-01-10 ------- - -Abstract - - Cette page décrit la méthode pour effectuer une release de mavenpom. Mavenpom devant être neutre - par rapport à un quelconque environnement, on utilise des profiles uniquement réservés à <<mavenpom>>. - - - L'opération se déroule en 3 étapes. - -Etape 1 - - Effectuer une release normal - --------------------------------------------------------------------------------- -mvn release:prepare -Dinternal -mvn release:perform -Dinternal --------------------------------------------------------------------------------- - -Etape 2 - - Dans cette phase, on va : - - * Deployement des fichiers vers redmine - - * Créer les announces de release - - [] - - On travaille sur la version utilisée pour faire la release. - --------------------------------------------------------------------------------- -cd target/checkout --------------------------------------------------------------------------------- - - La commande suivante simule (sans rien déployer) - --------------------------------------------------------------------------------- -mvn -Dinternal -DinternalRedminePreRelease -N --------------------------------------------------------------------------------- - - Si aucune erreur lors de l'execution, on lance la commande suivante - --------------------------------------------------------------------------------- -mvn -Dinternal -DinternalRedminePreRelease -DdryRun=false -N --------------------------------------------------------------------------------- - - A ce stade, les annonces ont été créées ici - --------------------------------------------------------------------------------- -target/generated-sources/announcement/release-news-announcement.vm -target/generated-sources/announcement/release-email-announcement.vm --------------------------------------------------------------------------------- - -Etape 3 - - On finalise la release après avoir finaliser les annonces (si nécessaire) : - - * Mise à jour de la version sur redmine (on la clôture) - - * Envoie de l'email d'annonce de release - - * Publication de l'annonce de release sur redmine - - [] - - La commande suivante simule (sans rien publier) : - --------------------------------------------------------------------------------- -mvn -Dinternal -DinternalRedmineRelease -N --------------------------------------------------------------------------------- - - Si aucune erreur, on peut lancer la commande réelle - --------------------------------------------------------------------------------- -mvn -Dinternal -DinternalRedmineRelease -DdryRun=false -N --------------------------------------------------------------------------------- Deleted: trunk/mavenpomdoc/src/site/apt/repositories.apt =================================================================== --- trunk/mavenpomdoc/src/site/apt/repositories.apt 2012-04-19 16:39:07 UTC (rev 1241) +++ trunk/mavenpomdoc/src/site/apt/repositories.apt 2012-04-20 08:59:10 UTC (rev 1242) @@ -1,156 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2009 - 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Utilisation des dépôts maven ------- ------- -2010-06-17 ------- - -Présentation - - Cette page explique comment configurer mavenpom pour déployer des artifacts. - - On distingue trois types de serveur : - - * dépôt maven de snapshots (voir {{{Déployer une snapshot}section snapshot}}). - - * dépôt maven de releases (voir {{{Déployer une release}section release}}). - - * dépôt de sites (voir {{{Déployer un site}section site}}). - -Déployer une snapshot - - Mavenpom définit grâce à deux propriétés : - - * {{{./properties.html#snapshot.repository}snapshot.repository}} - - * {{{./properties.html#snapshot.server}snapshot.server}} - - [] - - En résumé, voici la définition du serveur où déployer les snapshots : - --------------------------------------------------------------------------------- -<snapshotRepository> - <id>${snapshot.server}</id> - <url>${snapshot.repository}</url> -</snapshotRepository> --------------------------------------------------------------------------------- - - Par défaut, on utilise les valeurs suivantes pour le paramétrage : - - * <repository> : {{{./properties.html#our.snapshot.repository}our.snapshot.repository}} - - * <server> : <<nuiton>> - - Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> - une nouvelle valeur pour l'un des deux paramètres.\ - {{{Présentation}[remonter]}} - -Déployer une release - - Mavenpom définit grâce à deux propriétés : - - * {{{./properties.html#release.repository}release.repository}} - - * {{{./properties.html#release.server}release.server}} - - [] - - En résumé, voici la définition du serveur où déployer les releases : - --------------------------------------------------------------------------------- -<repository> - <id>${release.server}</id> - <url>${release.repository}</url> -</repository> --------------------------------------------------------------------------------- - - Par défaut, on utilise les valeurs suivantes pour le paramétrage : - - * <repository> : {{{./properties.html#other.release.repository}other.release.repository}} - - * <server> : <<nuiton>> - - Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> - une nouvelle valeur pour l'un des deux paramètres.\ - {{{Présentation}[remonter]}} - -* Paramétrage pour un projet <<central-unsafe>> - - Il suffit d'utiliser la configuration par défaut. - {{{Présentation}[remonter]}} - -* Paramétrage pour un projet <<central-safe>> - - Pour rendre un projet central-safe, il faut utiliser le bon dépôt de release : - {{{./properties.html#central.release.repository}central.release.repository}}. - - Pour assurer que le projet est bien compatible, on inclut le profile - <<central-safe>> dans le cycle de release. - - Pour ce faire ajouter dans la section <<properties>> du projet ceci : - --------------------------------------------------------------------------------- -  - -  - <arguments>-DperformRelease -Pcentral-safe</arguments> - -  - <releaseProfiles>central-safe</releaseProfiles> --------------------------------------------------------------------------------- - {{{Présentation}[remonter]}} - -Déployer un site - - Mavenpom définit grâce à deux propriétés : - - * {{{./properties.html#site.repository}site.repository}} - - * {{{./properties.html#site.server}site.server}} - - [] - - En résumé, voici la définition du serveur où déployer les sites : - --------------------------------------------------------------------------------- -<site> - <id>${site.server}</id> - <url>${site.repository}</url> -</site> --------------------------------------------------------------------------------- - - Par défaut, on utilise les valeurs suivantes pour le paramétrage : - - * <repository> : {{{./properties.html#our.site.repository}our.site.repository}} - - * <server> : <<nuiton>> - - Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> - une nouvelle valeur pour l'un des deux paramètres.\ - {{{Présentation}[remonter]}} \ No newline at end of file Modified: trunk/mavenpomdoc/src/site/site.xml =================================================================== --- trunk/mavenpomdoc/src/site/site.xml 2012-04-19 16:39:07 UTC (rev 1241) +++ trunk/mavenpomdoc/src/site/site.xml 2012-04-20 08:59:10 UTC (rev 1242) @@ -42,53 +42,69 @@ </custom> <bannerLeft> - <name>Mavenpom</name> + <name>${project.name}</name> <href>index.html</href> </bannerLeft> <bannerRight> <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> - <href>${project.organization.url}</href> + <href>http://codelutin.com</href> </bannerRight> <body> <breadcrumbs> - <item name="Mavenpom" href="./index.html"/> + <item name="${project.name}" href="./index.html"/> </breadcrumbs> <links> - <item name="Chorem" href="http://www.chorem.org"/> - <item name="Nuiton" href="http://www.nuiton.org"/> - <item name="Forge Codelutin" href="http://www.forge.codelutin.com"/> - <item name="${project.organization.name}" - href="${project.organization.url}"/> + <item name="chorem.org" href="http://www.chorem.org"/> + <item name="nuiton.org" href="http://www.nuiton.org"/> + <item name="forge.codelutin.com" href="http://www.forge.codelutin.com"/> + <item name="CodeLutin" href="http://codelutin.com"/> </links> <menu ref="modules"/> - <menu name="Utiliser mavenpom"> - <item name="Accueil" href="index.html"/> - <item name="Propriétés" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - <item name="Configuration des serveurs" href="repositories.html"/> + <menu name="mavenpom"> + <item name="Accueil" href="mavenpom/index.html"/> + <item name="Propriétés" href="mavenpom/properties.html"/> + <item name="Profiles" href="mavenpom/profiles.html"/> + <item name="Configuration des serveurs" href="mavenpom/repositories.html"/> + <item name="Faire une release de mavenpom" href="mavenpom/release.html"/> + <item name="Maven best pratices" href="mavenpom/MavenProjectBestPratices.html"/> </menu> - <menu name="Développeur"> - <item name="Faire une release de mavenpom" href="release.html"/> - <item name="Maven best pratices" href="MavenProjectBestPratices.html"/> + <menu name="mavenpom4redmine"> + <item name="Accueil" href="mavenpom4redmine/index.html"/> + <item name="Pom minimal" href="mavenpom4redmine/minimalpom.html"/> + <item name="Profiles" href="mavenpom4redmine/profiles.html"/> + <item name="Propriétés" href="mavenpom4redmine/properties.html"/> + <item name="Configuration des serveurs" href="mavenpom4redmine/repositories.html"/> + <item name="Faire une release" href="mavenpom4redmine/release.html"/> </menu> + <menu name="mavenpom4redmineAndCentral"> + <item name="Accueil" href="mavenpom4redmineAndCentral/index.html"/> + <item name="Pom minimal" href="mavenpom4redmineAndCentral/minimalpom.html"/> + <item name="Faire une release" href="mavenpom4redmineAndCentral/release.html"/> + </menu> + + <menu name="mavenpom4labs"> + <item name="Accueil" href="mavenpom4labs/index.html"/> + <item name="Pom minimal" href="mavenpom4labs/minimalpom.html"/> + <item name="Profiles" href="mavenpom4labs/profiles.html"/> + <item name="Propriétés" href="mavenpom4labs/properties.html"/> + <item name="Faire une release" href="mavenpom4labs/release.html"/> + </menu> + <menu name="Liens"> - <item name="maven-nuiton-skin" - href="http://maven-site.nuiton.org/maven-nuiton-skin"/> <item name="helper-maven-plugin" href="http://maven-site.nuiton.org/helper-maven-plugin"/> <item name="jredmine-maven-plugin" href="http://maven-site.nuiton.org/jredmine/jredmine-maven-plugin"/> <item name="license-maven-plugin" href="http://mojo.codehaus.org/license-maven-plugin/"/> - </menu> <menu ref="reports"/> Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-04-19 16:39:07 UTC (rev 1241) +++ trunk/pom.xml 2012-04-20 08:59:10 UTC (rev 1242) @@ -1563,12 +1563,14 @@ </properties> - <distributionManagement> +  +  <build> <plugins> @@ -1639,7 +1641,7 @@ </plugins> </build> - <reporting> +  </profile>

1 0

r1241 - in trunk: mavenpom4labs/src/site/apt mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt mavenpom4redmine/src/site/apt mavenpomdoc/src/site mavenpomdoc/src/site/apt mavenpomdoc/src/site/apt/mavenpom4labs mavenpomdoc/src/site/apt/mavenpom4redmine mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral
by tchemit＠users.nuiton.org 19 Apr '12

19 Apr '12

Author: tchemit Date: 2012-04-19 18:39:07 +0200 (Thu, 19 Apr 2012) New Revision: 1241 Url: http://nuiton.org/repositories/revision/mavenpom/1241 Log: refs #2058: Remove mavenpom site descriptors refs #2060: Introduce new module (mavenpomdoc) for documentation of mavenpom Added: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/ trunk/mavenpomdoc/src/site/apt/mavenpom4labs/index.apt trunk/mavenpomdoc/src/site/apt/mavenpom4labs/minimalpom.apt trunk/mavenpomdoc/src/site/apt/mavenpom4labs/profiles.apt trunk/mavenpomdoc/src/site/apt/mavenpom4labs/properties.apt trunk/mavenpomdoc/src/site/apt/mavenpom4labs/release.apt trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/index.apt trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/minimalpom.apt trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/profiles.apt trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/properties.apt trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/release.apt trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/ trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/index.apt trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/minimalpom.apt trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/release.apt Removed: trunk/mavenpom4labs/src/site/apt/index.apt trunk/mavenpom4labs/src/site/apt/minimalpom.apt trunk/mavenpom4labs/src/site/apt/profiles.apt trunk/mavenpom4labs/src/site/apt/properties.apt trunk/mavenpom4labs/src/site/apt/release.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt trunk/mavenpom4redmine/src/site/apt/index.apt trunk/mavenpom4redmine/src/site/apt/minimalpom.apt trunk/mavenpom4redmine/src/site/apt/profiles.apt trunk/mavenpom4redmine/src/site/apt/properties.apt trunk/mavenpom4redmine/src/site/apt/release.apt Modified: trunk/mavenpomdoc/src/site/site.xml Deleted: trunk/mavenpom4labs/src/site/apt/index.apt =================================================================== --- trunk/mavenpom4labs/src/site/apt/index.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4labs/src/site/apt/index.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,119 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4labs -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Mavenpom4labs ------- ------- -2010-01-19 ------- - -Présentation - - Le projet <mavenpom4labs> est un pom de type <Corporate> dont héritent tous - les projets hébergés sur le {{{http://labs.libre-entreprise.org}labs}}. - - Il étend <<mavenpom>> et ajoute les profiles de release pour le labs. - -* Ce qui est géré par mavenpom4labs - - Ce pom définit tout ce qui concerne l'environnement, il vous est donc - inutile de les définir dans vos poms, à savoir : - - * intégration continue (hudson) - - * environnement de distribution (deploiement des artifacts et site) - - * les profiles de release - - * la license GPL v3 - - * les version des plugins externes - - * la configuration des rapports du site - -* Ce que vous devez définir dans votre pom - - * l'url de votre projet - - * les développeurs et contributeurs du projet (sinon tous ceux de <mavenpom> - seront utilisés) - - * les listes de diffusion du projet (section <<mailingLists>>) - - * la définition du dépôt svn (section <<scm>>) - - * les dépendances de votre projet - - * gestion des 'issues' (sur le labs) (section <<issueManagement>>) - - * le 'build' - - [] - -* Le pom minimal - - Un exemple de pom minimal est donnée à la - {{{./minimalpom.html}page suivante}}, en vous basant dessus, tout devrait - bien se dérouler. - -Les propriétés dans mavenpom4labs - - Voir la page des {{{./properties.html}propriétés}}. - - Voir la page des {{{../../properties.html}propriétés}} de <mavenpom>. - - -Les profiles - - Voir la page des {{{./profiles.html}profiles}} du pom. - - Voir la page des {{{../../profiles.html}profiles}} de <mavenpom>. - -Vérification de conformité - - On effectue sur le pom des contrôles de conformités via le plugin - maven-enforcer-plugin. - -* propriétés obligatoires - - <<labs.id>> - -* Fichiers obligatoires - --------------------------------------------------------------------------------- -README.txt -changelog.txt -LICENSE.txt --------------------------------------------------------------------------------- - -Configuration des plugins - - Pour connaître la liste des plugins gérés par <mavenpom4labs>, veuillez vous - rendre sur la page de {{{./plugin-management.html}configuration des plugins}}. - - Pour mieux comprendre comment utiliser les plugins (et gérer les versions des - plugins) une explication est donnée dans <mavenpom> sur la - {{{../index.html#Configuration des plugins}page suivante}}. Deleted: trunk/mavenpom4labs/src/site/apt/minimalpom.apt =================================================================== --- trunk/mavenpom4labs/src/site/apt/minimalpom.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4labs/src/site/apt/minimalpom.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,242 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4labs -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ ------- -Mavenpom4labs usage ------- ------- -2010-01-22 ------- - -Préambule - - Cette page décrit un pom minimal qui utilise correctement <<mavenpom4labs>>. - -Le pom - --------------------------------------------------------------------------------- - -<?xml version="1.0" encoding="UTF-8"?> -<project xmlns="http://maven.apache.org/POM/4.0.0" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> - - <modelVersion>4.0.0</modelVersion> - -  -  -  - - <parent> - <groupId>org.nuiton</groupId> - <artifactId>mavenpom4labs</artifactId> - <version>3.0</version> - </parent> - - <groupId>com.myorganisation</groupId> - <artifactId>myproject</artifactId> - <version>0.1-SNAPSHOT</version> - -  -  -  - - <name>TODO</name> - - <description>TODO</description> - <inceptionYear>2009</inceptionYear> - <url>http://myproject.${platform}/myproject</url> - - <organization> - <name>mycompany</name> - <url>http://www.mycompany.com/</url> - </organization> - - <developers> - -  - - </developers> - -  -  -  - <packaging>your packaging (pom, jar, war, ear, plugin, ...)</packaging> - - <properties> - -  - <projectId>myProject</projectId> - -  - <labs.id>146</labs.id> - - </properties> - - <dependencies> - -  - - </<dependencies> - - -  - - <dependencyManagement> - <dependencies> - - </dependencies> - </dependencyManagement> - - <build> - - <plugins> - -  - - </plugins> - - <pluginManagement> - <plugins> - -  - - <plugin> -  - <artifactId>maven-site-plugin</artifactId> - <dependencies> - <dependency> - <groupId>org.nuiton.jrst</groupId> - <artifactId>doxia-module-jrst</artifactId> - <version>${jrstPluginVersion}</version> - </dependency> - </dependencies> - </plugin> - - </plugins> - </pluginManagement> - - </build> - -  -  -  - -  - <mailingLists> - -  - <mailingList> - <name>${projectId}-devel</name> - <subscribe>http://${labs.list.host}/mailman/listinfo/${projectId}-devel</subscribe> - <unsubscribe>http://${labs.list.host}/mailman/listinfo/${projectId}-devel</unsubscribe> - <post>${projectId}-devel(a)${labs.list.host}</post> - <archive>http://${labs.list.host}/pipermail/${projectId}-devel/</archive> - </mailingList> - - </mailingLists> - - <issueManagement> - <system>gforge</system> - <url>https://${platform}/tracker?group_id=${labs.id}</url> - </issueManagement> - - <scm> - <connection>scm:svn:svn://anonymous@${platform}/svnroot/myproject/myproject/trunk</connection> - <developerConnection>scm:svn:svn+ssh://${username}@${platform}/svnroot/myproject/myproject/trunk</developerConnection> - <url>http://${platform}/plugins/scmsvn/viewcvs.php/myproject/trunk/?root=myproject</url> - </scm> - - <repositories> - -  - - <repository> - <id>nuiton.release</id> - <name>NuitonReleaseRepository</name> - <url>http://maven.nuiton.org/release</url> - <snapshots> - <enabled>false</enabled> - </snapshots> - <releases> - <enabled>true</enabled> - <checksumPolicy>warn</checksumPolicy> - </releases> - </repository> - -  - - <repository> - <id>nuiton.snapshot</id> - <name>NuitonSnapshotRepository</name> - <url>http://maven.nuiton.org/snapshot</url> - <snapshots> - <enabled>true</enabled> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - <releases> - <enabled>false</enabled> - </releases> - </repository> - - </repositories> - - <pluginRepositories> - -  - - <pluginRepository> - - <id>nuiton.release</id> - <name>NuitonReleaseRepository</name> - <url>http://maven.nuiton.org/release</url> - <snapshots> - <enabled>false</enabled> - </snapshots> - <releases> - <enabled>true</enabled> - <checksumPolicy>warn</checksumPolicy> - </releases> - </pluginRepository> - -  - - <pluginRepository> - <id>nuiton.snapshot</id> - <name>NuitonSnapshotRepository</name> - <url>http://maven.nuiton.org/snapshot</url> - <snapshots> - <enabled>true</enabled> - <checksumPolicy>fail</checksumPolicy> - </snapshots> - <releases> - <enabled>false</enabled> - </releases> - </pluginRepository> - - </pluginRepositories> - -</project> - --------------------------------------------------------------------------------- Deleted: trunk/mavenpom4labs/src/site/apt/profiles.apt =================================================================== --- trunk/mavenpom4labs/src/site/apt/profiles.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4labs/src/site/apt/profiles.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,86 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4labs -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ ------- -Profiles disponibles dans mavenpom4labs ------- ------- -2010-01-19 ------- - -Abstract - - Cette page décrit l'ensemble des profiles ajoutés (ou surchargés) dans - <mavenpom4labs> et disponibles pour tous les projets qui en héritent. - - <mavenpom4labs> héritant de <mavenpom>, tous les profiles de <mavenpom> sont - aussi disponibles pour les enfants de <mavenpom4labs>. - - Reportez vous a cette page pour avoir la liste des profiles de - {{{../profiles.html} mavenpom}}. - -Vue d'ensemble - -*-------------------------------+---------------------------+ -| <<nom du profile>> | <<propriété d'activation>>| -*-------------------------------+---------------------------+ -| {{labs-build-release-profile}}| <<performRelease>> | -*-------------------------------+---------------------------+ -| {{labs-pre-release-profile}} | <<performLabsPreRelease>> | -*-------------------------------+---------------------------+ -| {{labs-release-profile}} | <<performLabsRelease>> | -*-------------------------------+---------------------------+ -| {{labs-next-version-profile}} | <<labsNextVersion>> | -*-------------------------------+---------------------------+ - - -Détails - -* {labs-build-release-profile} - - Ce profile est activé automatiquement lors d'une release (ou par le - déclancheur <<performRelease>>). - - Actuellement, permet de copier le fichier <<changelog.txt>> dans le site. Ce - fichier devient sur le site généré la page <<release-note.html>>. - - A noter, que le changelog doit être au format rst. - -* {labs-pre-release-profile} - - Ne fait rien actuellement, en prévision de pouvoir communiquer avec le labs - pour préparer une release. - -* {labs-release-profile} - - Envoie un email de release à partir du fichier - - src/announcement/release-email-${project.version}.txt - - aux listes users et devel du projet (+ nuiton annonces) - -* {labs-next-version-profile} - - Ne fait rien actuellement, en prévision de pouvoir communiquer avec le labs - pour préparer la version suivant suite à une release. Deleted: trunk/mavenpom4labs/src/site/apt/properties.apt =================================================================== --- trunk/mavenpom4labs/src/site/apt/properties.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4labs/src/site/apt/properties.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,95 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4labs -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ ------- -Propriétés disponibles dans mavenpom4labs ------- ------- -2010-01-19 ------- - -Abstract - - Cette décrit l'ensemble des propriétés ajoutés dans <mavenpom4labs>. - - <mavenpom4labs> héritant de <mavenpom>, tous les propriétés de <mavenpom> sont - aussi disponibles pour les enfants de <mavenpom4labs>. - - Les propriétés définies dans <mavenpom> sont accéssibles - {{{../properties.html}ici}}. - -Vue d'ensemble - -*-------------------------+----------------------------------------------------+ -| <<propriété>> | <<valeur par défaut>> | -*-------------------------+----------------------------------------------------+ -| {{platform}} | <<labs.libre-entreprise.org>> | -*-------------------------+----------------------------------------------------+ -| {{labs.id}} | - | -*-------------------------+----------------------------------------------------+ -| {{labs.list.host}} | lists.${platform} | -*-------------------------+----------------------------------------------------+ -| {{scmwebeditorEnabled}} | <<false>> | -*-------------------------+----------------------------------------------------+ - -Détails - -* {platform} - - La plateforme labs utilisée, par défaut : <<labs.libre-entreprise.org>>. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {labs.id} - - L'id du projet sur le labs. - - Cet indentifiant peut-être retrouver par exemple en allant sur un tracker du - projet sur le labs (il s'agit du paramètre group_id). - - Exemple pour isis-fish (<<labs.id=8>>): - --------------------------------------------------------------------------------- -https://labs.libre-entreprise.org/tracker/?atid=113&group_id=8&func=browse --------------------------------------------------------------------------------- - -* {labs.list.host} - - Le nom du serveur des listes de diffusion (sur la labs) du projet. - - Cette propriété est calculé <<list.${platform}>> - - Exemple pour isis-fish : - --------------------------------------------------------------------------------- -lists.labs.libre-entreprise.org --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - - -* {scmwebeditorEnabled} - - On désactive toujours la génération des liens vers scmwebeditor pour les - sites maven car tous les projets hébergés sur le labs utilisent un svn + ssh. Deleted: trunk/mavenpom4labs/src/site/apt/release.apt =================================================================== --- trunk/mavenpom4labs/src/site/apt/release.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4labs/src/site/apt/release.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,124 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4labs -~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ ------- -Effectuer une release ------- ------- -2010-01-19 ------- - -Abstract - - Cette page décrit la méthode pour effectuer une release d'un projet - héritant de <<mavenpom4labs>>. - -A savoir avant de faire une release d'un projet de type labs - - Contrairement aux projets sur redmine, les releases sont beaucoups moins - abouties (pas de gestion de trackers, pas de déployement de fichiers, ...) - - Il y a quand même 2 choses qui peuvent être faites : - - * Ecrire un fichier changelog.txt à la racine du projet au format <<rst>>, - il sera incorporé au site généré sur la page <release-note.html>. - - Par exemple : {{http://observe.labs.libre-entreprise.org/observe/release-note.html}} - - * Ecrire les email d'annonces, dans le répertoire <src/announcement> sous la - forme <release-email-XXX.txt> où XXX est le numéro de version. - - Par exemple : {{https://svn.mpl.ird.fr/osiris/observe/trunk/src/announcement/}} - -Etape 1 - - Effectuer une release normal (enfin prèsque...) (voir les deux sections suivantes). - --------------------------------------------------------------------------------- -mvn release:prepare -mvn release:perform --------------------------------------------------------------------------------- - -* Conseil avant de lancer le prepare (pour l'utilisation d'un svn+ssh) - - Dans les pom on a un scm de la forme : - --------------------------------------------------------------------------------- -<developerConnection> - scm:svn:svn+ssh://${username}@labs.libre-entreprise.org/svnroot/vradi/vradi/trunk -</developerConnection> --------------------------------------------------------------------------------- - - Le mieux c'est de le laisser tel quel dans le pom et de faire la manipulation suivante : - --------------------------------------------------------------------------------- -mvn release:prepare --------------------------------------------------------------------------------- - - Cela va casse quand il veut commiter le tag, mais c'est pas grave, on va - ensuite modifier la propriété <scm.url> du fichier <release.properties> en - remplaçant le <username> par votre username. - - Puis en relançant le prepare tout va mieux... le tag est bien crée. A noter - que lorsque l'on relance le second prepare il ne fait que le dernière partie - des commits svn donc c'est très rapide. - - Cette procédure (en peu tordu certes) permet de toujours laisser le <username> - dans le pom. - -* Conseil avant de lancer le perform - - On connait un problème sur le labs lors du déployement des sites, il faut donc - avant de faire le perform, aller sur le labs et déplacer le site actuel. Je - préconise d'utiliser comme convention <nomDuprojet-version> (exemple <nada-0.3.2>). - - exemple pour le projet nada déjà release en version 0.0 : - --------------------------------------------------------------------------------- -ssh nadaUser(a)labs.libre-entreprise.org -(cd /home/groups/nana/htdocs ; mv nana nada-0.0) --------------------------------------------------------------------------------- - - -Etape 2 - - Si vous avez un répertoire src/announcement/ avec des fichiers release-meail-XXX.txt - l'envoie de l'email peut être fait tout seul : - --------------------------------------------------------------------------------- -cd target/checkout -mvn -N -DdryRun=false -DperformLabsRelease --------------------------------------------------------------------------------- - - Pour le moment, il n'y rien d'autre de disponible mais à terme on aura les - mêmes fonctionnalités que pour les releases de <mavenpom4redmine> à savoir: - - - deploiement des fichiers sur le labs - - - récupération des 'issues' depuis le labs (et génération des rapports) - - - envoie du courriel d'annonce de release - - - publication de l'annonce de release sur le labs. - Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,79 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Mavenpom4redmineAndCentral ------- ------- -2010-10-03 ------- - -Présentation - - Le projet <mavenpom4redmine> est un pom de type <Corporate> dont héritent - tous les projets {{{http://www.nuiton.org}nuiton}} qui sont synchronisés sur - - Il étend <<mavenpom4redmine>> et ajoute la configuration pour synchroniser - sur central. - -* Ce qui est géré par mavenpom4redmine4Central - - Tout ce qui est définit par le <<mavenpom4redmine>>. - -* Ce que vous devez définir dans votre pom - - * l'url de votre projet - - * la définition du dépôt svn (section <<scm>>). - - * les dépendances de votre projet - - * le build - -* Le pom minimal - - Un exemple de pom minimal est donnée à la - {{{./minimalpom.html}page suivante}}, en vous basant dessus, tout devrait - bien se dérouler. - -Les propriétés - - Voir la page des {{{../properties.html}propriétés}} de <mavenpom4redmine>. - - Voir la page des {{{../../properties.html}propriétés}} de <mavenpom>. - -Les profiles - - Voir la page des {{{../../en/profiles.html}profiles}} de <mavenpom4redmine>. - - Voir la page des {{{../../../en/profiles.html}profiles}} de <mavenpom>. - -Vérification de conformité - - On effectue sur le pom les même contrôles de conformités que - <mavenpom4redmine>. - - On vérifie aussi que tous les artifacts sont bien dans le dépôt central en - activant le profile <central-safe> lors d'un release. Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,149 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Pom minimale avec Mavenpom4redmineAndCentral ------- ------- -2010-10-03 ------- - -Préambule - - Cette page décrit un pom minimal qui utilise correctement <<mavenpom4redmineAndCentral>>. - -Le pom - --------------------------------------------------------------------------------- - -<?xml version="1.0" encoding="UTF-8"?> -<project xmlns="http://maven.apache.org/POM/4.0.0" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> - - <modelVersion>4.0.0</modelVersion> - -  -  -  - - <parent> - <groupId>org.nuiton</groupId> - <artifactId>mavenpom4redmineAndCentral</artifactId> - <version>3.0</version> - </parent> - - <artifactId>myProject</artifactId> - <version>0.1-SNAPSHOT</version> - - <dependencies> - -  - - </dependencies> - -  -  -  - <name>Maven License Plugin</name> - - <description>myProject description</description> - <inceptionYear>2010</inceptionYear> - <url>projectUrl</url> - - <developers> - -  - - </developers> - -  -  -  - -  - <scm> - <connection>scm:svn:http://svn.${platform}/svn/myProject/trunk</connection> - <developerConnection>scm:svn:http://svn.${platform}/svn/myProject/trunk</developerConnection> - <url>http://www.${platform}/repositories/browse/myProject/trunk</url> - </scm> - -  -  -  - - <packaging>your packaging (pom, jar, war, ear, plugin, ...)</packaging> - - <properties> - -  - <projectId>myProject</projectId> - -  - <siteLocales>fr,en</siteLocales> - -  - <siteSourcesType>rst</siteSourcesType> - </properties> - - <distributionManagement> - <site> - <id>${platform}</id> - <url>${our.site.repository}/${projectId}</url> - </site> - </distributionManagement> - - <build> - - <plugins> - -  - - </plugins> - - <pluginManagement> - <plugins> - -  - <plugin> -  - <artifactId>maven-site-plugin</artifactId> - <dependencies> - <dependency> - <groupId>org.nuiton.jrst</groupId> - <artifactId>doxia-module-jrst</artifactId> - <version>${jrstPluginVersion}</version> - </dependency> - </dependencies> - </plugin> - - </plugins> - </pluginManagement> - - </build> - -</project> - --------------------------------------------------------------------------------- Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,40 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Effectuer une release ------- ------- -2010-10-03 ------- - -Abstract - - Cette page décrit la méthode pour effectuer une release d'un projet héritant - de <<mavenpom4redmineAndCentral>>. - - La procédure est identique à celle de <<mavenpom4redmine>>. - - Reportez vous à la {{{../release.html}page de release de mavenpom4redmine}}. \ No newline at end of file Deleted: trunk/mavenpom4redmine/src/site/apt/index.apt =================================================================== --- trunk/mavenpom4redmine/src/site/apt/index.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4redmine/src/site/apt/index.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,115 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Mavenpom4redmine ------- ------- -2009-08-22 ------- - -Présentation - - Le projet <mavenpom4redmine> est un pom de type <Corporate> dont héritent - tous les projets {{{http://www.nuiton.org}nuiton}} et - {{{http://www.chorem.org}chorem}}. - - Il étend <<mavenpom>> et ajoute les profiles de release pour redmine. - -* Ce qui est géré par mavenpom4redmine - - Ce pom définit tout ce qui concerne l'environnement, il vous est donc - inutile de les définir dans vos poms, à savoir : - - * intégration continue (hudson) - - * environnement de distribution (deploiement des artifacts et site) - - * gestion des 'issues' (sur redmine) - - * les profiles de release - - * la license LGPL v3 - - * les listes de diffusion <commits>, <devel> et <users> - - * les version des plugins externes - - * la configuration des rapports du site - -* Ce que vous devez définir dans votre pom - - * l'url de votre projet - - * la définition du dépôt svn (section <<scm>>). - - * les dépendances de votre projet - - * le build - -* Le pom minimal - - Un exemple de pom minimal est donnée à la - {{{./minimalpom.html}page suivante}}, en vous basant dessus, tout devrait - bien se dérouler. - -Les propriétés - - Voir la page des {{{./properties.html}propriétés}} du pom. - - Voir la page des {{{../properties.html}propriétés}} de <mavenpom>. - -Les profiles - - Voir la page des {{{./profiles.html}profiles}} du pom. - - Voir la page des {{{../../profiles.html}profiles}} de <mavenpom>. - -Vérification de conformité - - On effectue sur le pom des contrôles de conformités via le plugin - maven-enforcer-plugin. - -* propriétés obligatoires - - Aucune a l'heure actuelle - -* Fichiers obligatoires - --------------------------------------------------------------------------------- -README.txt -changelog.txt -LICENSE.txt --------------------------------------------------------------------------------- - -Configuration des plugins - - Pour connaître la liste des plugins gérés par <mavenpom4redmine>, veuillez - vous rendre sur la page de - {{{./plugin-management.html}configuration des plugins}}. - - Pour mieux comprendre comment utiliser les plugins (et gérer les versions des - plugins) une explication est donnée dans <mavenpom> sur la - {{{../index.html#Configuration des plugins}page suivante}}. Deleted: trunk/mavenpom4redmine/src/site/apt/minimalpom.apt =================================================================== --- trunk/mavenpom4redmine/src/site/apt/minimalpom.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4redmine/src/site/apt/minimalpom.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,149 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Mavenpom4redmine usage ------- ------- -2010-01-22 ------- - -Préambule - - Cette page décrit un pom minimal qui utilise correctement <<mavenpom4redmine>>. - -Le pom - --------------------------------------------------------------------------------- - -<?xml version="1.0" encoding="UTF-8"?> -<project xmlns="http://maven.apache.org/POM/4.0.0" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> - - <modelVersion>4.0.0</modelVersion> - -  -  -  - - <parent> - <groupId>org.nuiton</groupId> - <artifactId>mavenpom4redmine</artifactId> - <version>3.0</version> - </parent> - - <artifactId>myProject</artifactId> - <version>0.1-SNAPSHOT</version> - - <dependencies> - -  - - </dependencies> - -  -  -  - <name>Maven License Plugin</name> - - <description>myProject description</description> - <inceptionYear>2010</inceptionYear> - <url>projectUrl</url> - - <developers> - -  - - </developers> - -  -  -  - -  - <scm> - <connection>scm:svn:http://svn.${platform}/svn/myProject/trunk</connection> - <developerConnection>scm:svn:http://svn.${platform}/svn/myProject/trunk</developerConnection> - <url>http://www.${platform}/repositories/browse/myProject/trunk</url> - </scm> - -  -  -  - - <packaging>your packaging (pom, jar, war, ear, plugin, ...)</packaging> - - <properties> - -  - <projectId>myProject</projectId> - -  - <siteLocales>fr,en</siteLocales> - -  - <siteSourcesType>apt</siteSourcesType> - </properties> - - <distributionManagement> - <site> - <id>${platform}</id> - <url>${our.site.repository}/${projectId}</url> - </site> - </distributionManagement> - - <build> - - <plugins> - -  - - </plugins> - - <pluginManagement> - <plugins> - -  - <plugin> -  - <artifactId>maven-site-plugin</artifactId> - <dependencies> - <dependency> - <groupId>org.nuiton.jrst</groupId> - <artifactId>doxia-module-jrst</artifactId> - <version>${jrstPluginVersion}</version> - </dependency> - </dependencies> - </plugin> - - </plugins> - </pluginManagement> - - </build> - -</project> - --------------------------------------------------------------------------------- Deleted: trunk/mavenpom4redmine/src/site/apt/profiles.apt =================================================================== --- trunk/mavenpom4redmine/src/site/apt/profiles.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4redmine/src/site/apt/profiles.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,143 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Profiles disponibles dans mavenpom4redmine ------- ------- -2009-10-11 ------- - -Abstract - - Cette page décrit l'ensemble des profiles ajoutés (ou surchargés) dans - mavenpom4redmine et disponibles pour tous les projets qui héritent de - mavenpom. - - Reportez vous a cette page pour avoir la liste des profiles de - {{{../profiles.html} mavenpom}}. - -Vue d'ensemble - -*----------------------------------+------------------------------+ -| <<property>> | <<Activation property>> | -*----------------------------------+------------------------------+ -| {{redmine-publish-attachments-profile}}| <<publishAttachments>> | -*----------------------------------+------------------------------+ -| {{redmine-build-release-profile}}| <<performRelease>> | -*----------------------------------+------------------------------+ -| {{redmine-pre-release-profile}} | <<performRedminePreRelease>> | -*----------------------------------+------------------------------+ -| {{redmine-release-profile}} | <<performRedmineRelease>> | -*----------------------------------+------------------------------+ -| {{redmine-next-version-profile}} | <<redmineNextVersion>> | -*----------------------------------+------------------------------+ - -Détails - -* {redmine-publish-attachments-profile} - - Ce profile permet de déployer des fichiers sur le redmine. Il est activable - via la propriété <<publishAttachments>>. - -* {redmine-build-release-profile} - - Ce profile permet pendant la release classique de collecter les fichiers à - publier et de générer le changelog. Il est activable via la propriété - <<performRelease>>. - - Dans ce profile, on lance la collecte des artifacts qui seront déployés - sur le dépôt maven. La liste de ces artifacts sont conservés dans le fichier - défini par la propriété <<redmine.collectedArtifacts>>. - - A noter, que dans le cadre des projets multi-modules, on ne conserve qu'un - seul fichier situé dans le module du pom. - - Dans ce profile, on lance la collecte des fichiers qui seront déployés sur - le serveur redmine. La liste de ces fichiers sont conservés dans le fichier - défini par la propriété <<redmine.collectedAttachments>>. - - A noter, que dans le cadre des projets multi-modules, on ne conserve qu'un - seul fichier situé dans le module du pom. - -* {redmine-pre-release-profile} - - Ce profile permet suite à une release de publier la release sur redmine et est - activable via la propriété <<performRedminePreRelease>>. - - Il faut l'utiliser sur le projet releasé, cela déployera les fichiers attachés - à la release sur redmine et génèrera les contenus d'annonces ici : - --------------------------------------------------------------------------------- -target/generate-sources/announcement/release-news-announcement.vm -target/generate-sources/announcement/release-email-announcement.vm --------------------------------------------------------------------------------- - - Un paramètre supplémentaire <<-DdryRun=false>> est à passer pour confirmer - l'exécution des commandes sur le serveur redmine. - --------------------------------------------------------------------------------- -cd target/checkout; mvn -DperformRedminePreRelease -N --------------------------------------------------------------------------------- - - Une fois que tout à l'air ok : - --------------------------------------------------------------------------------- -cd target/checkout; mvn -DperformRedminePreRelease -N -DdryRun=false --------------------------------------------------------------------------------- - - -* {redmine-release-profile} - - Ce profile permet suite à une release de publier la release sur redmine et est - activable via la propriété <<performRedmineRelease>>. - - Il faut l'utiliser sur le projet releasé (et pas le projet en SNAPSHOT). - --------------------------------------------------------------------------------- -cd target/checkout; mvn -DperformRedmineRelease -N --------------------------------------------------------------------------------- - - Une fois que tout à l'air ok : - --------------------------------------------------------------------------------- -cd target/checkout; mvn -DperformRedmineRelease -N -DdryRun=false --------------------------------------------------------------------------------- - -* {redmine-next-version-profile} - - Ce profile permet de créer la version sur le serveur redmine correspondant à - la version (non snapshot) du pom, est activable par la propriété - <<redmineNextVersion>>. - --------------------------------------------------------------------------------- -mvn -Predmine-next-version-profile -N -Dredmine.previousVersionName=XX --------------------------------------------------------------------------------- - - ou - --------------------------------------------------------------------------------- -mvn -DredmineNextVersion -N -Dredmine.previousVersionName=XX --------------------------------------------------------------------------------- Deleted: trunk/mavenpom4redmine/src/site/apt/properties.apt =================================================================== --- trunk/mavenpom4redmine/src/site/apt/properties.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4redmine/src/site/apt/properties.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,224 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Propriétés disponibles dans mavenpom4redmine ------- ------- -2009-10-11 ------- - -Abstract - - Cette décrit l'ensemble des propriétés ajoutés dans mavenpom et disponibles - pour tous les projets qui héritent de <mavenpom4redmine>. - - Les propriétés définies dans <mavenpom> sont accéssibles {{{../properties.html}ici}} - -Vue d'ensemble - -*----------------------------------------------+--------------------------------------------------------+ -| <<property>> | <<Default- value>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{platform}} | <<nuiton.org>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{publicProject}} | <<true>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.url}} | <<http://www.${platform}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.serverId}} | <<redmine-${platform}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.projectId}} | <<${projectId}>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.xmlPath}} | <<${maven.gen.dir}/changes/changes.xml>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.issueLinkTemplate}} | <<${redmine.url}/issues/show/%ISSUE%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.versionLinkTemplate}} | <<${redmine.url}/versions/show/%VERSION%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.attachmentLinkTemplate}} | <<${redmine.url}/attachments/download/%FILE%>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.collectedAttachments}} | <<target/collect-attachments.txt>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.collectedArtifacts}} | <<target/collect-artifacts.txt>> | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.releaseFiles}} | - | -*----------------------------------------------+--------------------------------------------------------+ -| {{redmine.libReleaseFiles}} | target/${project.artifactId}-${project.version}-deps.zip,target/${project.artifactId}-${project.version}-full.zip| -*----------------------------------------------+--------------------------------------------------------+ - -Détails - -* {platform} - - La plateforme redmine utilisée parmi : - --------------------------------------------------------------------------------- -nuiton.org -chorem.org --------------------------------------------------------------------------------- - -* {publicProject} - - Pour savoir si un project est public. Si le projet est privé dans redmine, il - faut alors mettre comme valeur <<false>>. - -* {redmine.url} - - L'url du serveur redmine. - --------------------------------------------------------------------------------- -http://www.${platform} --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.serverId} - - L'id du serveur (dans votre <<settings.xml>>) pour se logguer sur redmine. - --------------------------------------------------------------------------------- -redmine-${platform} --------------------------------------------------------------------------------- - - Vous devez donc avoir deux serveurs définis : - --------------------------------------------------------------------------------- -redmine-nuiton.org -redmine-chorem.org --------------------------------------------------------------------------------- - - afin de pouvoir faire des releases sur <<nuiton.org>> et <<chorem.org>>. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.projectId} - - L'id du projet redmine. Par défaut, il s'agit de la propriété <<projectId>>. - --------------------------------------------------------------------------------- -${projectId} --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.xmlPath} - - Le chemin du fichier des 'issues' généré. - --------------------------------------------------------------------------------- -${maven.gen.dir}/changes/changes.xml --------------------------------------------------------------------------------- - - Le contenu de ce fichier xml, sera utilisé par le plugin - <<maven-change-plugin>> pour générer le rapport des changements. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.issueLinkTemplate} - - L'url des issues sur le serveur redmine. Le pattern <<%ISSUE%>> sera remplacé - dans les rapports par l'id de l'issue. - --------------------------------------------------------------------------------- -${redmine.url}/issues/show/%ISSUE% --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.versionLinkTemplate} - - L'url des version sur le serveur redmine. Le pattern <<%VERSION%>> sera - remplacé dans les rapport par l'id de la version. - --------------------------------------------------------------------------------- -${redmine.url}/versions/show/%VERSION% --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.attachmentLinkTemplate} - - L'url des fichiers sur le serveur redmine. Le pattern <<%FILE%>> sera - remplacé dans les rapport par l'id du fichier. - --------------------------------------------------------------------------------- -${redmine.url}/attachments/download/%FILE% --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.collectedAttachments} - - Le fichier qui contient la liste des fichiers à envoyer sur redmine lors d'une - nouvelle release. - --------------------------------------------------------------------------------- -target/collect-attachments.txt --------------------------------------------------------------------------------- - - Le contenu de ce fichier contient une ligne par fichier et est rempli pendant - la réalisation de la release (<mvn release:perform>) et ceci grâce au profile - <redmine-build-release-profile>. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.collectedArtifacts} - - Le fichier qui contient la liste des fichiers à deployer sur le dépôt maven. - --------------------------------------------------------------------------------- -target/collect-artifacts.txt --------------------------------------------------------------------------------- - - Le contenu de ce fichier contient une ligne par fichier et est rempli pendant - la réalisation de la release (<mvn release:perform>) et ceci grâce au profile - <redmine-build-release-profile>. - - <Note:> en théorie, cette propriété ne doit pas être modifiée. - -* {redmine.releaseFiles} - - La liste des fichiers à envoyer sur redmine lors d'une nouvelle release - (séparés par des virgules). - - Mettez dans cette propriété la liste des fichiers que vous voulez déployer - sur redmine lors d'une release. - - Par défaut, vide (i.e rien à deployer sur redmine pour le module courant). - -* {redmine.libReleaseFiles} - - La définition des fichiers à ajouter à une release pour un module de type - <<jar>> qui générè les deux zip deps et full. - - On remplit dans ce cas la propriété <<redmine.releaseFiles>> avec cette - propriété : - --------------------------------------------------------------------------------- -<redmine.releaseFiles>${redmine.libReleaseFiles}</redmine.releaseFiles> --------------------------------------------------------------------------------- - - <Note:> en théorie, cette propriété ne doit pas être modifiée. Deleted: trunk/mavenpom4redmine/src/site/apt/release.apt =================================================================== --- trunk/mavenpom4redmine/src/site/apt/release.apt 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpom4redmine/src/site/apt/release.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -1,122 +0,0 @@ -~~~ -~~ #%L -~~ Mavenpom4redmine -~~ ~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - ------- -Effectuer une release ------- ------- -2010-01-10 ------- - -Abstract - - Cette page décrit la méthode pour effectuer une release d'un projet héritant - de <<mavenpom4redmine>>. - - L'opération se déroule en 4 étapes. - -Etape 1 - - Effectuer une release normal - --------------------------------------------------------------------------------- -mvn release:prepare -mvn release:perform --------------------------------------------------------------------------------- - -Etape 2 - - Dans cette phase, on va : - - * Deployement des fichiers vers redmine - - * Créer les annonces de release - - [] - - On travaille sur la version utilisée pour faire la release. - --------------------------------------------------------------------------------- -cd target/checkout --------------------------------------------------------------------------------- - - La commande suivante simule (sans rien déployer) - --------------------------------------------------------------------------------- -mvn -DperformRedminePreRelease -N [-Pcentral-safe] --------------------------------------------------------------------------------- - - Si aucune erreur lors de l'execution, on lance la commande suivante - --------------------------------------------------------------------------------- -mvn -DperformRedminePreRelease -DdryRun=false -N --------------------------------------------------------------------------------- - - A ce stade, les annonces ont été créées ici : - --------------------------------------------------------------------------------- -target/generated-sources/announcement/release-news-announcement.vm -target/generated-sources/announcement/release-email-announcement.vm --------------------------------------------------------------------------------- - -Etape 3 - - On finalise la release après avoir modifié les annonces (si nécessaire) : - - * Mise à jour de la version sur redmine (on la clôture) - - * Envoie de l'email d'annonce de release - - * Publication de l'annonce de release sur redmine - - [] - - La commande suivante simule (sans rien publier) : - --------------------------------------------------------------------------------- -mvn -DperformRedmineRelease -N --------------------------------------------------------------------------------- - - Si aucune erreur, on peut lancer la commande réelle - --------------------------------------------------------------------------------- -mvn -DperformRedmineRelease -DdryRun=false -N --------------------------------------------------------------------------------- - -Etape 4 - - On revient sur le projet du trunk - --------------------------------------------------------------------------------- -cd ../../ --------------------------------------------------------------------------------- - - On crée la nouvelle version sur redmine (où <XXX> est la version qui vient - d'être releasée) et on déplace les demandes non fermées vers la nouvelle - version. - --------------------------------------------------------------------------------- -mvn -DredmineNextVersion -Dredmine.previousVersionName=XXX -N --------------------------------------------------------------------------------- Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/index.apt (from rev 1240, trunk/mavenpom4labs/src/site/apt/index.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4labs/index.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4labs/index.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,119 @@ +~~~ +~~ #%L +~~ Mavenpom4labs +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Mavenpom4labs +------ +------ +2010-01-19 +------ + +Présentation + + Le projet <mavenpom4labs> est un pom de type <Corporate> dont héritent tous + les projets hébergés sur le {{{http://labs.libre-entreprise.org}labs}}. + + Il étend <<mavenpom>> et ajoute les profiles de release pour le labs. + +* Ce qui est géré par mavenpom4labs + + Ce pom définit tout ce qui concerne l'environnement, il vous est donc + inutile de les définir dans vos poms, à savoir : + + * intégration continue (hudson) + + * environnement de distribution (deploiement des artifacts et site) + + * les profiles de release + + * la license GPL v3 + + * les version des plugins externes + + * la configuration des rapports du site + +* Ce que vous devez définir dans votre pom + + * l'url de votre projet + + * les développeurs et contributeurs du projet (sinon tous ceux de <mavenpom> + seront utilisés) + + * les listes de diffusion du projet (section <<mailingLists>>) + + * la définition du dépôt svn (section <<scm>>) + + * les dépendances de votre projet + + * gestion des 'issues' (sur le labs) (section <<issueManagement>>) + + * le 'build' + + [] + +* Le pom minimal + + Un exemple de pom minimal est donnée à la + {{{./minimalpom.html}page suivante}}, en vous basant dessus, tout devrait + bien se dérouler. + +Les propriétés dans mavenpom4labs + + Voir la page des {{{./properties.html}propriétés}}. + + Voir la page des {{{../../properties.html}propriétés}} de <mavenpom>. + + +Les profiles + + Voir la page des {{{./profiles.html}profiles}} du pom. + + Voir la page des {{{../../profiles.html}profiles}} de <mavenpom>. + +Vérification de conformité + + On effectue sur le pom des contrôles de conformités via le plugin + maven-enforcer-plugin. + +* propriétés obligatoires + + <<labs.id>> + +* Fichiers obligatoires + +-------------------------------------------------------------------------------- +README.txt +changelog.txt +LICENSE.txt +-------------------------------------------------------------------------------- + +Configuration des plugins + + Pour connaître la liste des plugins gérés par <mavenpom4labs>, veuillez vous + rendre sur la page de {{{./plugin-management.html}configuration des plugins}}. + + Pour mieux comprendre comment utiliser les plugins (et gérer les versions des + plugins) une explication est donnée dans <mavenpom> sur la + {{{../index.html#Configuration des plugins}page suivante}}. Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/index.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/minimalpom.apt (from rev 1240, trunk/mavenpom4labs/src/site/apt/minimalpom.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4labs/minimalpom.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4labs/minimalpom.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,242 @@ +~~~ +~~ #%L +~~ Mavenpom4labs +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ +------ +Mavenpom4labs usage +------ +------ +2010-01-22 +------ + +Préambule + + Cette page décrit un pom minimal qui utilise correctement <<mavenpom4labs>>. + +Le pom + +-------------------------------------------------------------------------------- + +<?xml version="1.0" encoding="UTF-8"?> +<project xmlns="http://maven.apache.org/POM/4.0.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + + <modelVersion>4.0.0</modelVersion> + +  +  +  + + <parent> + <groupId>org.nuiton</groupId> + <artifactId>mavenpom4labs</artifactId> + <version>3.0</version> + </parent> + + <groupId>com.myorganisation</groupId> + <artifactId>myproject</artifactId> + <version>0.1-SNAPSHOT</version> + +  +  +  + + <name>TODO</name> + + <description>TODO</description> + <inceptionYear>2009</inceptionYear> + <url>http://myproject.${platform}/myproject</url> + + <organization> + <name>mycompany</name> + <url>http://www.mycompany.com/</url> + </organization> + + <developers> + +  + + </developers> + +  +  +  + <packaging>your packaging (pom, jar, war, ear, plugin, ...)</packaging> + + <properties> + +  + <projectId>myProject</projectId> + +  + <labs.id>146</labs.id> + + </properties> + + <dependencies> + +  + + </<dependencies> + + +  + + <dependencyManagement> + <dependencies> + + </dependencies> + </dependencyManagement> + + <build> + + <plugins> + +  + + </plugins> + + <pluginManagement> + <plugins> + +  + + <plugin> +  + <artifactId>maven-site-plugin</artifactId> + <dependencies> + <dependency> + <groupId>org.nuiton.jrst</groupId> + <artifactId>doxia-module-jrst</artifactId> + <version>${jrstPluginVersion}</version> + </dependency> + </dependencies> + </plugin> + + </plugins> + </pluginManagement> + + </build> + +  +  +  + +  + <mailingLists> + +  + <mailingList> + <name>${projectId}-devel</name> + <subscribe>http://${labs.list.host}/mailman/listinfo/${projectId}-devel</subscribe> + <unsubscribe>http://${labs.list.host}/mailman/listinfo/${projectId}-devel</unsubscribe> + <post>${projectId}-devel(a)${labs.list.host}</post> + <archive>http://${labs.list.host}/pipermail/${projectId}-devel/</archive> + </mailingList> + + </mailingLists> + + <issueManagement> + <system>gforge</system> + <url>https://${platform}/tracker?group_id=${labs.id}</url> + </issueManagement> + + <scm> + <connection>scm:svn:svn://anonymous@${platform}/svnroot/myproject/myproject/trunk</connection> + <developerConnection>scm:svn:svn+ssh://${username}@${platform}/svnroot/myproject/myproject/trunk</developerConnection> + <url>http://${platform}/plugins/scmsvn/viewcvs.php/myproject/trunk/?root=myproject</url> + </scm> + + <repositories> + +  + + <repository> + <id>nuiton.release</id> + <name>NuitonReleaseRepository</name> + <url>http://maven.nuiton.org/release</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + <releases> + <enabled>true</enabled> + <checksumPolicy>warn</checksumPolicy> + </releases> + </repository> + +  + + <repository> + <id>nuiton.snapshot</id> + <name>NuitonSnapshotRepository</name> + <url>http://maven.nuiton.org/snapshot</url> + <snapshots> + <enabled>true</enabled> + <checksumPolicy>fail</checksumPolicy> + </snapshots> + <releases> + <enabled>false</enabled> + </releases> + </repository> + + </repositories> + + <pluginRepositories> + +  + + <pluginRepository> + + <id>nuiton.release</id> + <name>NuitonReleaseRepository</name> + <url>http://maven.nuiton.org/release</url> + <snapshots> + <enabled>false</enabled> + </snapshots> + <releases> + <enabled>true</enabled> + <checksumPolicy>warn</checksumPolicy> + </releases> + </pluginRepository> + +  + + <pluginRepository> + <id>nuiton.snapshot</id> + <name>NuitonSnapshotRepository</name> + <url>http://maven.nuiton.org/snapshot</url> + <snapshots> + <enabled>true</enabled> + <checksumPolicy>fail</checksumPolicy> + </snapshots> + <releases> + <enabled>false</enabled> + </releases> + </pluginRepository> + + </pluginRepositories> + +</project> + +-------------------------------------------------------------------------------- Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/minimalpom.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/profiles.apt (from rev 1240, trunk/mavenpom4labs/src/site/apt/profiles.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4labs/profiles.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4labs/profiles.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,86 @@ +~~~ +~~ #%L +~~ Mavenpom4labs +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ +------ +Profiles disponibles dans mavenpom4labs +------ +------ +2010-01-19 +------ + +Abstract + + Cette page décrit l'ensemble des profiles ajoutés (ou surchargés) dans + <mavenpom4labs> et disponibles pour tous les projets qui en héritent. + + <mavenpom4labs> héritant de <mavenpom>, tous les profiles de <mavenpom> sont + aussi disponibles pour les enfants de <mavenpom4labs>. + + Reportez vous a cette page pour avoir la liste des profiles de + {{{../profiles.html} mavenpom}}. + +Vue d'ensemble + +*-------------------------------+---------------------------+ +| <<nom du profile>> | <<propriété d'activation>>| +*-------------------------------+---------------------------+ +| {{labs-build-release-profile}}| <<performRelease>> | +*-------------------------------+---------------------------+ +| {{labs-pre-release-profile}} | <<performLabsPreRelease>> | +*-------------------------------+---------------------------+ +| {{labs-release-profile}} | <<performLabsRelease>> | +*-------------------------------+---------------------------+ +| {{labs-next-version-profile}} | <<labsNextVersion>> | +*-------------------------------+---------------------------+ + + +Détails + +* {labs-build-release-profile} + + Ce profile est activé automatiquement lors d'une release (ou par le + déclancheur <<performRelease>>). + + Actuellement, permet de copier le fichier <<changelog.txt>> dans le site. Ce + fichier devient sur le site généré la page <<release-note.html>>. + + A noter, que le changelog doit être au format rst. + +* {labs-pre-release-profile} + + Ne fait rien actuellement, en prévision de pouvoir communiquer avec le labs + pour préparer une release. + +* {labs-release-profile} + + Envoie un email de release à partir du fichier + + src/announcement/release-email-${project.version}.txt + + aux listes users et devel du projet (+ nuiton annonces) + +* {labs-next-version-profile} + + Ne fait rien actuellement, en prévision de pouvoir communiquer avec le labs + pour préparer la version suivant suite à une release. Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/profiles.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/properties.apt (from rev 1240, trunk/mavenpom4labs/src/site/apt/properties.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4labs/properties.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4labs/properties.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,95 @@ +~~~ +~~ #%L +~~ Mavenpom4labs +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ +------ +Propriétés disponibles dans mavenpom4labs +------ +------ +2010-01-19 +------ + +Abstract + + Cette décrit l'ensemble des propriétés ajoutés dans <mavenpom4labs>. + + <mavenpom4labs> héritant de <mavenpom>, tous les propriétés de <mavenpom> sont + aussi disponibles pour les enfants de <mavenpom4labs>. + + Les propriétés définies dans <mavenpom> sont accéssibles + {{{../properties.html}ici}}. + +Vue d'ensemble + +*-------------------------+----------------------------------------------------+ +| <<propriété>> | <<valeur par défaut>> | +*-------------------------+----------------------------------------------------+ +| {{platform}} | <<labs.libre-entreprise.org>> | +*-------------------------+----------------------------------------------------+ +| {{labs.id}} | - | +*-------------------------+----------------------------------------------------+ +| {{labs.list.host}} | lists.${platform} | +*-------------------------+----------------------------------------------------+ +| {{scmwebeditorEnabled}} | <<false>> | +*-------------------------+----------------------------------------------------+ + +Détails + +* {platform} + + La plateforme labs utilisée, par défaut : <<labs.libre-entreprise.org>>. + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {labs.id} + + L'id du projet sur le labs. + + Cet indentifiant peut-être retrouver par exemple en allant sur un tracker du + projet sur le labs (il s'agit du paramètre group_id). + + Exemple pour isis-fish (<<labs.id=8>>): + +-------------------------------------------------------------------------------- +https://labs.libre-entreprise.org/tracker/?atid=113&group_id=8&func=browse +-------------------------------------------------------------------------------- + +* {labs.list.host} + + Le nom du serveur des listes de diffusion (sur la labs) du projet. + + Cette propriété est calculé <<list.${platform}>> + + Exemple pour isis-fish : + +-------------------------------------------------------------------------------- +lists.labs.libre-entreprise.org +-------------------------------------------------------------------------------- + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + + +* {scmwebeditorEnabled} + + On désactive toujours la génération des liens vers scmwebeditor pour les + sites maven car tous les projets hébergés sur le labs utilisent un svn + ssh. Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/properties.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/release.apt (from rev 1240, trunk/mavenpom4labs/src/site/apt/release.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4labs/release.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4labs/release.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,124 @@ +~~~ +~~ #%L +~~ Mavenpom4labs +~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ +------ +Effectuer une release +------ +------ +2010-01-19 +------ + +Abstract + + Cette page décrit la méthode pour effectuer une release d'un projet + héritant de <<mavenpom4labs>>. + +A savoir avant de faire une release d'un projet de type labs + + Contrairement aux projets sur redmine, les releases sont beaucoups moins + abouties (pas de gestion de trackers, pas de déployement de fichiers, ...) + + Il y a quand même 2 choses qui peuvent être faites : + + * Ecrire un fichier changelog.txt à la racine du projet au format <<rst>>, + il sera incorporé au site généré sur la page <release-note.html>. + + Par exemple : {{http://observe.labs.libre-entreprise.org/observe/release-note.html}} + + * Ecrire les email d'annonces, dans le répertoire <src/announcement> sous la + forme <release-email-XXX.txt> où XXX est le numéro de version. + + Par exemple : {{https://svn.mpl.ird.fr/osiris/observe/trunk/src/announcement/}} + +Etape 1 + + Effectuer une release normal (enfin prèsque...) (voir les deux sections suivantes). + +-------------------------------------------------------------------------------- +mvn release:prepare +mvn release:perform +-------------------------------------------------------------------------------- + +* Conseil avant de lancer le prepare (pour l'utilisation d'un svn+ssh) + + Dans les pom on a un scm de la forme : + +-------------------------------------------------------------------------------- +<developerConnection> + scm:svn:svn+ssh://${username}@labs.libre-entreprise.org/svnroot/vradi/vradi/trunk +</developerConnection> +-------------------------------------------------------------------------------- + + Le mieux c'est de le laisser tel quel dans le pom et de faire la manipulation suivante : + +-------------------------------------------------------------------------------- +mvn release:prepare +-------------------------------------------------------------------------------- + + Cela va casse quand il veut commiter le tag, mais c'est pas grave, on va + ensuite modifier la propriété <scm.url> du fichier <release.properties> en + remplaçant le <username> par votre username. + + Puis en relançant le prepare tout va mieux... le tag est bien crée. A noter + que lorsque l'on relance le second prepare il ne fait que le dernière partie + des commits svn donc c'est très rapide. + + Cette procédure (en peu tordu certes) permet de toujours laisser le <username> + dans le pom. + +* Conseil avant de lancer le perform + + On connait un problème sur le labs lors du déployement des sites, il faut donc + avant de faire le perform, aller sur le labs et déplacer le site actuel. Je + préconise d'utiliser comme convention <nomDuprojet-version> (exemple <nada-0.3.2>). + + exemple pour le projet nada déjà release en version 0.0 : + +-------------------------------------------------------------------------------- +ssh nadaUser(a)labs.libre-entreprise.org +(cd /home/groups/nana/htdocs ; mv nana nada-0.0) +-------------------------------------------------------------------------------- + + +Etape 2 + + Si vous avez un répertoire src/announcement/ avec des fichiers release-meail-XXX.txt + l'envoie de l'email peut être fait tout seul : + +-------------------------------------------------------------------------------- +cd target/checkout +mvn -N -DdryRun=false -DperformLabsRelease +-------------------------------------------------------------------------------- + + Pour le moment, il n'y rien d'autre de disponible mais à terme on aura les + mêmes fonctionnalités que pour les releases de <mavenpom4redmine> à savoir: + + - deploiement des fichiers sur le labs + + - récupération des 'issues' depuis le labs (et génération des rapports) + + - envoie du courriel d'annonce de release + + - publication de l'annonce de release sur le labs. + Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4labs/release.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/index.apt (from rev 1240, trunk/mavenpom4redmine/src/site/apt/index.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/index.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/index.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,115 @@ +~~~ +~~ #%L +~~ Mavenpom4redmine +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Mavenpom4redmine +------ +------ +2009-08-22 +------ + +Présentation + + Le projet <mavenpom4redmine> est un pom de type <Corporate> dont héritent + tous les projets {{{http://www.nuiton.org}nuiton}} et + {{{http://www.chorem.org}chorem}}. + + Il étend <<mavenpom>> et ajoute les profiles de release pour redmine. + +* Ce qui est géré par mavenpom4redmine + + Ce pom définit tout ce qui concerne l'environnement, il vous est donc + inutile de les définir dans vos poms, à savoir : + + * intégration continue (hudson) + + * environnement de distribution (deploiement des artifacts et site) + + * gestion des 'issues' (sur redmine) + + * les profiles de release + + * la license LGPL v3 + + * les listes de diffusion <commits>, <devel> et <users> + + * les version des plugins externes + + * la configuration des rapports du site + +* Ce que vous devez définir dans votre pom + + * l'url de votre projet + + * la définition du dépôt svn (section <<scm>>). + + * les dépendances de votre projet + + * le build + +* Le pom minimal + + Un exemple de pom minimal est donnée à la + {{{./minimalpom.html}page suivante}}, en vous basant dessus, tout devrait + bien se dérouler. + +Les propriétés + + Voir la page des {{{./properties.html}propriétés}} du pom. + + Voir la page des {{{../properties.html}propriétés}} de <mavenpom>. + +Les profiles + + Voir la page des {{{./profiles.html}profiles}} du pom. + + Voir la page des {{{../../profiles.html}profiles}} de <mavenpom>. + +Vérification de conformité + + On effectue sur le pom des contrôles de conformités via le plugin + maven-enforcer-plugin. + +* propriétés obligatoires + + Aucune a l'heure actuelle + +* Fichiers obligatoires + +-------------------------------------------------------------------------------- +README.txt +changelog.txt +LICENSE.txt +-------------------------------------------------------------------------------- + +Configuration des plugins + + Pour connaître la liste des plugins gérés par <mavenpom4redmine>, veuillez + vous rendre sur la page de + {{{./plugin-management.html}configuration des plugins}}. + + Pour mieux comprendre comment utiliser les plugins (et gérer les versions des + plugins) une explication est donnée dans <mavenpom> sur la + {{{../index.html#Configuration des plugins}page suivante}}. Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/index.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/minimalpom.apt (from rev 1240, trunk/mavenpom4redmine/src/site/apt/minimalpom.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/minimalpom.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/minimalpom.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,149 @@ +~~~ +~~ #%L +~~ Mavenpom4redmine +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Mavenpom4redmine usage +------ +------ +2010-01-22 +------ + +Préambule + + Cette page décrit un pom minimal qui utilise correctement <<mavenpom4redmine>>. + +Le pom + +-------------------------------------------------------------------------------- + +<?xml version="1.0" encoding="UTF-8"?> +<project xmlns="http://maven.apache.org/POM/4.0.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> + + <modelVersion>4.0.0</modelVersion> + +  +  +  + + <parent> + <groupId>org.nuiton</groupId> + <artifactId>mavenpom4redmine</artifactId> + <version>3.0</version> + </parent> + + <artifactId>myProject</artifactId> + <version>0.1-SNAPSHOT</version> + + <dependencies> + +  + + </dependencies> + +  +  +  + <name>Maven License Plugin</name> + + <description>myProject description</description> + <inceptionYear>2010</inceptionYear> + <url>projectUrl</url> + + <developers> + +  + + </developers> + +  +  +  + +  + <scm> + <connection>scm:svn:http://svn.${platform}/svn/myProject/trunk</connection> + <developerConnection>scm:svn:http://svn.${platform}/svn/myProject/trunk</developerConnection> + <url>http://www.${platform}/repositories/browse/myProject/trunk</url> + </scm> + +  +  +  + + <packaging>your packaging (pom, jar, war, ear, plugin, ...)</packaging> + + <properties> + +  + <projectId>myProject</projectId> + +  + <siteLocales>fr,en</siteLocales> + +  + <siteSourcesType>apt</siteSourcesType> + </properties> + + <distributionManagement> + <site> + <id>${platform}</id> + <url>${our.site.repository}/${projectId}</url> + </site> + </distributionManagement> + + <build> + + <plugins> + +  + + </plugins> + + <pluginManagement> + <plugins> + +  + <plugin> +  + <artifactId>maven-site-plugin</artifactId> + <dependencies> + <dependency> + <groupId>org.nuiton.jrst</groupId> + <artifactId>doxia-module-jrst</artifactId> + <version>${jrstPluginVersion}</version> + </dependency> + </dependencies> + </plugin> + + </plugins> + </pluginManagement> + + </build> + +</project> + +-------------------------------------------------------------------------------- Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/minimalpom.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/profiles.apt (from rev 1240, trunk/mavenpom4redmine/src/site/apt/profiles.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/profiles.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/profiles.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,143 @@ +~~~ +~~ #%L +~~ Mavenpom4redmine +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Profiles disponibles dans mavenpom4redmine +------ +------ +2009-10-11 +------ + +Abstract + + Cette page décrit l'ensemble des profiles ajoutés (ou surchargés) dans + mavenpom4redmine et disponibles pour tous les projets qui héritent de + mavenpom. + + Reportez vous a cette page pour avoir la liste des profiles de + {{{../profiles.html} mavenpom}}. + +Vue d'ensemble + +*----------------------------------+------------------------------+ +| <<property>> | <<Activation property>> | +*----------------------------------+------------------------------+ +| {{redmine-publish-attachments-profile}}| <<publishAttachments>> | +*----------------------------------+------------------------------+ +| {{redmine-build-release-profile}}| <<performRelease>> | +*----------------------------------+------------------------------+ +| {{redmine-pre-release-profile}} | <<performRedminePreRelease>> | +*----------------------------------+------------------------------+ +| {{redmine-release-profile}} | <<performRedmineRelease>> | +*----------------------------------+------------------------------+ +| {{redmine-next-version-profile}} | <<redmineNextVersion>> | +*----------------------------------+------------------------------+ + +Détails + +* {redmine-publish-attachments-profile} + + Ce profile permet de déployer des fichiers sur le redmine. Il est activable + via la propriété <<publishAttachments>>. + +* {redmine-build-release-profile} + + Ce profile permet pendant la release classique de collecter les fichiers à + publier et de générer le changelog. Il est activable via la propriété + <<performRelease>>. + + Dans ce profile, on lance la collecte des artifacts qui seront déployés + sur le dépôt maven. La liste de ces artifacts sont conservés dans le fichier + défini par la propriété <<redmine.collectedArtifacts>>. + + A noter, que dans le cadre des projets multi-modules, on ne conserve qu'un + seul fichier situé dans le module du pom. + + Dans ce profile, on lance la collecte des fichiers qui seront déployés sur + le serveur redmine. La liste de ces fichiers sont conservés dans le fichier + défini par la propriété <<redmine.collectedAttachments>>. + + A noter, que dans le cadre des projets multi-modules, on ne conserve qu'un + seul fichier situé dans le module du pom. + +* {redmine-pre-release-profile} + + Ce profile permet suite à une release de publier la release sur redmine et est + activable via la propriété <<performRedminePreRelease>>. + + Il faut l'utiliser sur le projet releasé, cela déployera les fichiers attachés + à la release sur redmine et génèrera les contenus d'annonces ici : + +-------------------------------------------------------------------------------- +target/generate-sources/announcement/release-news-announcement.vm +target/generate-sources/announcement/release-email-announcement.vm +-------------------------------------------------------------------------------- + + Un paramètre supplémentaire <<-DdryRun=false>> est à passer pour confirmer + l'exécution des commandes sur le serveur redmine. + +-------------------------------------------------------------------------------- +cd target/checkout; mvn -DperformRedminePreRelease -N +-------------------------------------------------------------------------------- + + Une fois que tout à l'air ok : + +-------------------------------------------------------------------------------- +cd target/checkout; mvn -DperformRedminePreRelease -N -DdryRun=false +-------------------------------------------------------------------------------- + + +* {redmine-release-profile} + + Ce profile permet suite à une release de publier la release sur redmine et est + activable via la propriété <<performRedmineRelease>>. + + Il faut l'utiliser sur le projet releasé (et pas le projet en SNAPSHOT). + +-------------------------------------------------------------------------------- +cd target/checkout; mvn -DperformRedmineRelease -N +-------------------------------------------------------------------------------- + + Une fois que tout à l'air ok : + +-------------------------------------------------------------------------------- +cd target/checkout; mvn -DperformRedmineRelease -N -DdryRun=false +-------------------------------------------------------------------------------- + +* {redmine-next-version-profile} + + Ce profile permet de créer la version sur le serveur redmine correspondant à + la version (non snapshot) du pom, est activable par la propriété + <<redmineNextVersion>>. + +-------------------------------------------------------------------------------- +mvn -Predmine-next-version-profile -N -Dredmine.previousVersionName=XX +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn -DredmineNextVersion -N -Dredmine.previousVersionName=XX +-------------------------------------------------------------------------------- Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/profiles.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/properties.apt (from rev 1240, trunk/mavenpom4redmine/src/site/apt/properties.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/properties.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/properties.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,224 @@ +~~~ +~~ #%L +~~ Mavenpom4redmine +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Propriétés disponibles dans mavenpom4redmine +------ +------ +2009-10-11 +------ + +Abstract + + Cette décrit l'ensemble des propriétés ajoutés dans mavenpom et disponibles + pour tous les projets qui héritent de <mavenpom4redmine>. + + Les propriétés définies dans <mavenpom> sont accéssibles {{{../properties.html}ici}} + +Vue d'ensemble + +*----------------------------------------------+--------------------------------------------------------+ +| <<property>> | <<Default- value>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{platform}} | <<nuiton.org>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{publicProject}} | <<true>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.url}} | <<http://www.${platform}>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.serverId}} | <<redmine-${platform}>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.projectId}} | <<${projectId}>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.xmlPath}} | <<${maven.gen.dir}/changes/changes.xml>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.issueLinkTemplate}} | <<${redmine.url}/issues/show/%ISSUE%>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.versionLinkTemplate}} | <<${redmine.url}/versions/show/%VERSION%>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.attachmentLinkTemplate}} | <<${redmine.url}/attachments/download/%FILE%>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.collectedAttachments}} | <<target/collect-attachments.txt>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.collectedArtifacts}} | <<target/collect-artifacts.txt>> | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.releaseFiles}} | - | +*----------------------------------------------+--------------------------------------------------------+ +| {{redmine.libReleaseFiles}} | target/${project.artifactId}-${project.version}-deps.zip,target/${project.artifactId}-${project.version}-full.zip| +*----------------------------------------------+--------------------------------------------------------+ + +Détails + +* {platform} + + La plateforme redmine utilisée parmi : + +-------------------------------------------------------------------------------- +nuiton.org +chorem.org +-------------------------------------------------------------------------------- + +* {publicProject} + + Pour savoir si un project est public. Si le projet est privé dans redmine, il + faut alors mettre comme valeur <<false>>. + +* {redmine.url} + + L'url du serveur redmine. + +-------------------------------------------------------------------------------- +http://www.${platform} +-------------------------------------------------------------------------------- + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.serverId} + + L'id du serveur (dans votre <<settings.xml>>) pour se logguer sur redmine. + +-------------------------------------------------------------------------------- +redmine-${platform} +-------------------------------------------------------------------------------- + + Vous devez donc avoir deux serveurs définis : + +-------------------------------------------------------------------------------- +redmine-nuiton.org +redmine-chorem.org +-------------------------------------------------------------------------------- + + afin de pouvoir faire des releases sur <<nuiton.org>> et <<chorem.org>>. + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.projectId} + + L'id du projet redmine. Par défaut, il s'agit de la propriété <<projectId>>. + +-------------------------------------------------------------------------------- +${projectId} +-------------------------------------------------------------------------------- + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.xmlPath} + + Le chemin du fichier des 'issues' généré. + +-------------------------------------------------------------------------------- +${maven.gen.dir}/changes/changes.xml +-------------------------------------------------------------------------------- + + Le contenu de ce fichier xml, sera utilisé par le plugin + <<maven-change-plugin>> pour générer le rapport des changements. + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.issueLinkTemplate} + + L'url des issues sur le serveur redmine. Le pattern <<%ISSUE%>> sera remplacé + dans les rapports par l'id de l'issue. + +-------------------------------------------------------------------------------- +${redmine.url}/issues/show/%ISSUE% +-------------------------------------------------------------------------------- + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.versionLinkTemplate} + + L'url des version sur le serveur redmine. Le pattern <<%VERSION%>> sera + remplacé dans les rapport par l'id de la version. + +-------------------------------------------------------------------------------- +${redmine.url}/versions/show/%VERSION% +-------------------------------------------------------------------------------- + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.attachmentLinkTemplate} + + L'url des fichiers sur le serveur redmine. Le pattern <<%FILE%>> sera + remplacé dans les rapport par l'id du fichier. + +-------------------------------------------------------------------------------- +${redmine.url}/attachments/download/%FILE% +-------------------------------------------------------------------------------- + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.collectedAttachments} + + Le fichier qui contient la liste des fichiers à envoyer sur redmine lors d'une + nouvelle release. + +-------------------------------------------------------------------------------- +target/collect-attachments.txt +-------------------------------------------------------------------------------- + + Le contenu de ce fichier contient une ligne par fichier et est rempli pendant + la réalisation de la release (<mvn release:perform>) et ceci grâce au profile + <redmine-build-release-profile>. + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.collectedArtifacts} + + Le fichier qui contient la liste des fichiers à deployer sur le dépôt maven. + +-------------------------------------------------------------------------------- +target/collect-artifacts.txt +-------------------------------------------------------------------------------- + + Le contenu de ce fichier contient une ligne par fichier et est rempli pendant + la réalisation de la release (<mvn release:perform>) et ceci grâce au profile + <redmine-build-release-profile>. + + <Note:> en théorie, cette propriété ne doit pas être modifiée. + +* {redmine.releaseFiles} + + La liste des fichiers à envoyer sur redmine lors d'une nouvelle release + (séparés par des virgules). + + Mettez dans cette propriété la liste des fichiers que vous voulez déployer + sur redmine lors d'une release. + + Par défaut, vide (i.e rien à deployer sur redmine pour le module courant). + +* {redmine.libReleaseFiles} + + La définition des fichiers à ajouter à une release pour un module de type + <<jar>> qui générè les deux zip deps et full. + + On remplit dans ce cas la propriété <<redmine.releaseFiles>> avec cette + propriété : + +-------------------------------------------------------------------------------- +<redmine.releaseFiles>${redmine.libReleaseFiles}</redmine.releaseFiles> +-------------------------------------------------------------------------------- + + <Note:> en théorie, cette propriété ne doit pas être modifiée. Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/properties.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/release.apt (from rev 1240, trunk/mavenpom4redmine/src/site/apt/release.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/release.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/release.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,122 @@ +~~~ +~~ #%L +~~ Mavenpom4redmine +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Effectuer une release +------ +------ +2010-01-10 +------ + +Abstract + + Cette page décrit la méthode pour effectuer une release d'un projet héritant + de <<mavenpom4redmine>>. + + L'opération se déroule en 4 étapes. + +Etape 1 + + Effectuer une release normal + +-------------------------------------------------------------------------------- +mvn release:prepare +mvn release:perform +-------------------------------------------------------------------------------- + +Etape 2 + + Dans cette phase, on va : + + * Deployement des fichiers vers redmine + + * Créer les annonces de release + + [] + + On travaille sur la version utilisée pour faire la release. + +-------------------------------------------------------------------------------- +cd target/checkout +-------------------------------------------------------------------------------- + + La commande suivante simule (sans rien déployer) + +-------------------------------------------------------------------------------- +mvn -DperformRedminePreRelease -N [-Pcentral-safe] +-------------------------------------------------------------------------------- + + Si aucune erreur lors de l'execution, on lance la commande suivante + +-------------------------------------------------------------------------------- +mvn -DperformRedminePreRelease -DdryRun=false -N +-------------------------------------------------------------------------------- + + A ce stade, les annonces ont été créées ici : + +-------------------------------------------------------------------------------- +target/generated-sources/announcement/release-news-announcement.vm +target/generated-sources/announcement/release-email-announcement.vm +-------------------------------------------------------------------------------- + +Etape 3 + + On finalise la release après avoir modifié les annonces (si nécessaire) : + + * Mise à jour de la version sur redmine (on la clôture) + + * Envoie de l'email d'annonce de release + + * Publication de l'annonce de release sur redmine + + [] + + La commande suivante simule (sans rien publier) : + +-------------------------------------------------------------------------------- +mvn -DperformRedmineRelease -N +-------------------------------------------------------------------------------- + + Si aucune erreur, on peut lancer la commande réelle + +-------------------------------------------------------------------------------- +mvn -DperformRedmineRelease -DdryRun=false -N +-------------------------------------------------------------------------------- + +Etape 4 + + On revient sur le projet du trunk + +-------------------------------------------------------------------------------- +cd ../../ +-------------------------------------------------------------------------------- + + On crée la nouvelle version sur redmine (où <XXX> est la version qui vient + d'être releasée) et on déplace les demandes non fermées vers la nouvelle + version. + +-------------------------------------------------------------------------------- +mvn -DredmineNextVersion -Dredmine.previousVersionName=XXX -N +-------------------------------------------------------------------------------- Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/release.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/index.apt (from rev 1240, trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/index.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/index.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/index.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,79 @@ +~~~ +~~ #%L +~~ Mavenpom4redmine +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Mavenpom4redmineAndCentral +------ +------ +2010-10-03 +------ + +Présentation + + Le projet <mavenpom4redmine> est un pom de type <Corporate> dont héritent + tous les projets {{{http://www.nuiton.org}nuiton}} qui sont synchronisés sur + + Il étend <<mavenpom4redmine>> et ajoute la configuration pour synchroniser + sur central. + +* Ce qui est géré par mavenpom4redmine4Central + + Tout ce qui est définit par le <<mavenpom4redmine>>. + +* Ce que vous devez définir dans votre pom + + * l'url de votre projet + + * la définition du dépôt svn (section <<scm>>). + + * les dépendances de votre projet + + * le build + +* Le pom minimal + + Un exemple de pom minimal est donnée à la + {{{./minimalpom.html}page suivante}}, en vous basant dessus, tout devrait + bien se dérouler. + +Les propriétés + + Voir la page des {{{../properties.html}propriétés}} de <mavenpom4redmine>. + + Voir la page des {{{../../properties.html}propriétés}} de <mavenpom>. + +Les profiles + + Voir la page des {{{../../en/profiles.html}profiles}} de <mavenpom4redmine>. + + Voir la page des {{{../../../en/profiles.html}profiles}} de <mavenpom>. + +Vérification de conformité + + On effectue sur le pom les même contrôles de conformités que + <mavenpom4redmine>. + + On vérifie aussi que tous les artifacts sont bien dans le dépôt central en + activant le profile <central-safe> lors d'un release. Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/index.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/minimalpom.apt (from rev 1240, trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/minimalpom.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/minimalpom.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/minimalpom.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,149 @@ +~~~ +~~ #%L +~~ Mavenpom4redmine +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Pom minimale avec Mavenpom4redmineAndCentral +------ +------ +2010-10-03 +------ + +Préambule + + Cette page décrit un pom minimal qui utilise correctement <<mavenpom4redmineAndCentral>>. + +Le pom + +-------------------------------------------------------------------------------- + +<?xml version="1.0" encoding="UTF-8"?> +<project xmlns="http://maven.apache.org/POM/4.0.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> + + <modelVersion>4.0.0</modelVersion> + +  +  +  + + <parent> + <groupId>org.nuiton</groupId> + <artifactId>mavenpom4redmineAndCentral</artifactId> + <version>3.0</version> + </parent> + + <artifactId>myProject</artifactId> + <version>0.1-SNAPSHOT</version> + + <dependencies> + +  + + </dependencies> + +  +  +  + <name>Maven License Plugin</name> + + <description>myProject description</description> + <inceptionYear>2010</inceptionYear> + <url>projectUrl</url> + + <developers> + +  + + </developers> + +  +  +  + +  + <scm> + <connection>scm:svn:http://svn.${platform}/svn/myProject/trunk</connection> + <developerConnection>scm:svn:http://svn.${platform}/svn/myProject/trunk</developerConnection> + <url>http://www.${platform}/repositories/browse/myProject/trunk</url> + </scm> + +  +  +  + + <packaging>your packaging (pom, jar, war, ear, plugin, ...)</packaging> + + <properties> + +  + <projectId>myProject</projectId> + +  + <siteLocales>fr,en</siteLocales> + +  + <siteSourcesType>rst</siteSourcesType> + </properties> + + <distributionManagement> + <site> + <id>${platform}</id> + <url>${our.site.repository}/${projectId}</url> + </site> + </distributionManagement> + + <build> + + <plugins> + +  + + </plugins> + + <pluginManagement> + <plugins> + +  + <plugin> +  + <artifactId>maven-site-plugin</artifactId> + <dependencies> + <dependency> + <groupId>org.nuiton.jrst</groupId> + <artifactId>doxia-module-jrst</artifactId> + <version>${jrstPluginVersion}</version> + </dependency> + </dependencies> + </plugin> + + </plugins> + </pluginManagement> + + </build> + +</project> + +-------------------------------------------------------------------------------- Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/minimalpom.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Copied: trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/release.apt (from rev 1240, trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/apt/release.apt) =================================================================== --- trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/release.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/release.apt 2012-04-19 16:39:07 UTC (rev 1241) @@ -0,0 +1,40 @@ +~~~ +~~ #%L +~~ Mavenpom4redmine +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Effectuer une release +------ +------ +2010-10-03 +------ + +Abstract + + Cette page décrit la méthode pour effectuer une release d'un projet héritant + de <<mavenpom4redmineAndCentral>>. + + La procédure est identique à celle de <<mavenpom4redmine>>. + + Reportez vous à la {{{../release.html}page de release de mavenpom4redmine}}. \ No newline at end of file Property changes on: trunk/mavenpomdoc/src/site/apt/mavenpom4redmineAndCentral/release.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/mavenpomdoc/src/site/site.xml =================================================================== --- trunk/mavenpomdoc/src/site/site.xml 2012-04-18 23:44:35 UTC (rev 1240) +++ trunk/mavenpomdoc/src/site/site.xml 2012-04-19 16:39:07 UTC (rev 1241) @@ -60,7 +60,7 @@ <links> <item name="Chorem" href="http://www.chorem.org"/> <item name="Nuiton" href="http://www.nuiton.org"/> - <item name="Nuiton" href="http://www.forge.codelutin.com"/> + <item name="Forge Codelutin" href="http://www.forge.codelutin.com"/> <item name="${project.organization.name}" href="${project.organization.url}"/> </links>

1 0

r1240 - in trunk: . mavenpom4redmine/mavenpom4redmineAndCentral/src/site mavenpom4redmine/src/site mavenpomdoc mavenpomdoc/src/site mavenpomdoc/src/site/apt src/site
by tchemit＠users.nuiton.org 18 Apr '12

18 Apr '12

Author: tchemit Date: 2012-04-19 01:44:35 +0200 (Thu, 19 Apr 2012) New Revision: 1240 Url: http://nuiton.org/repositories/revision/mavenpom/1240 Log: refs #2058: Remove mavenpom site descriptors Added: trunk/mavenpomdoc/src/site/apt/mavenpom4redmine/ Removed: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/en/ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_en.xml trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_fr.xml trunk/mavenpom4redmine/src/site/en/ trunk/mavenpom4redmine/src/site/site_en.xml trunk/mavenpom4redmine/src/site/site_fr.xml trunk/src/site/apt/ trunk/src/site/en/ trunk/src/site/site_en.xml trunk/src/site/site_fr.xml Modified: trunk/mavenpomdoc/pom.xml trunk/mavenpomdoc/src/site/site.xml trunk/pom.xml Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_en.xml =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_en.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_en.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -1,66 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - - -<project name="${project.name}"> - - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> - - <body> - - <breadcrumbs> - <item name="${project.name}" href="${project.url}"/> - </breadcrumbs> - -  -  - <menu name="Parent Projet"> - <item name="Mavenpom4redmine" href="../../en/index.html"/> - </menu> - - <menu name="Language"> - <item name="Version française" href="/../index.html"/> - </menu> - - <menu name="Inside mavenpom4redmineAndCentral"> - <item name="Home" href="/index.html"/> - </menu> - - <menu name="Using mavenpom4redmineAndCentral"> - <item name="Minimal pom" href="minimalpom.html"/> - <item name="Make a release" href="release.html"/> - </menu> - - <menu name="Divers"> - <item name="Version française" href="/../index.html"/> - </menu> - - <menu ref="reports"/> - - </body> -</project> Deleted: trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_fr.xml =================================================================== --- trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_fr.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/mavenpom4redmine/mavenpom4redmineAndCentral/src/site/site_fr.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -1,53 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - -<project name="${project.name}"> - - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> - - <body> - - <breadcrumbs> - <item name="${project.name}" href="${project.url}"/> - </breadcrumbs> - - <menu ref="parent"/> - - <menu name="Dissection de mavenpom4redmineAndCentral"> - <item name="Accueil" href="index.html"/> - </menu> - - <menu name="Utiliser mavenpom4redmineAndCentral"> - <item name="Pom minimal" href="minimalpom.html"/> - <item name="Faire une release" href="release.html"/> - </menu> - - <menu ref="reports"/> - - </body> -</project> Deleted: trunk/mavenpom4redmine/src/site/site_en.xml =================================================================== --- trunk/mavenpom4redmine/src/site/site_en.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/mavenpom4redmine/src/site/site_en.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -1,75 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - - -<project name="${project.name}"> - - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> - - <body> - - <breadcrumbs> - <item name="${project.name}" href="${project.url}"/> - </breadcrumbs> - -  -  - <menu name="Parent Projet"> - <item name="Mavenpom" href="../../en/index.html"/> - </menu> - -  -  - <menu name="Modules"> - <item name="Mavenpom4redmineAndCentral" - href="../mavenpom4redmineAndCentral/en/index.html"/> - </menu> - - <menu name="Language"> - <item name="Version française" href="/../index.html"/> - </menu> - - <menu name="Inside mavenpom4redmineAndCentral"> - <item name="Home" href="/index.html"/> - <item name="Properties" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - </menu> - - <menu name="Using mavenpom4redmineAndCentral"> - <item name="Minimal pom" href="minimalpom.html"/> - <item name="Make a release" href="release.html"/> - </menu> - - <menu name="Divers"> - <item name="Version française" href="/../index.html"/> - </menu> - - <menu ref="reports"/> - - </body> -</project> Deleted: trunk/mavenpom4redmine/src/site/site_fr.xml =================================================================== --- trunk/mavenpom4redmine/src/site/site_fr.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/mavenpom4redmine/src/site/site_fr.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -1,61 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - -<project name="${project.name}"> - - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> - - <body> - - <breadcrumbs> - <item name="${project.name}" href="${project.url}"/> - </breadcrumbs> - - <menu ref="parent"/> - - <menu ref="modules"/> - - <menu name="Dissection de mavenpom4redmine"> - <item name="Accueil" href="index.html"/> - <item name="Propriétés" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - </menu> - - <menu name="Utiliser mavenpom4redmine"> - <item name="Pom minimal" href="minimalpom.html"/> - <item name="Faire une release" href="release.html"/> - </menu> - -  - - <menu ref="reports"/> - - </body> -</project> Modified: trunk/mavenpomdoc/pom.xml =================================================================== --- trunk/mavenpomdoc/pom.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/mavenpomdoc/pom.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -90,11 +90,11 @@ </site> </distributionManagement> -  -  -  -  -  + <scm> + <connection>scm:svn:http://svn.nuiton.org/svn/mavenpom/trunk/mavenpomdoc</connection> + <developerConnection>scm:svn:http://svn.nuiton.org/svn/mavenpom/trunk/mavenpomdoc</developerConnection> + <url>http://www.nuiton.org/repositories/browse/mavenpom/trunk/mavenpomdoc</url> + </scm> <reporting> <plugins> Modified: trunk/mavenpomdoc/src/site/site.xml =================================================================== --- trunk/mavenpomdoc/src/site/site.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/mavenpomdoc/src/site/site.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -42,7 +42,7 @@ </custom> <bannerLeft> - <name>${project.name}</name> + <name>Mavenpom</name> <href>index.html</href> </bannerLeft> @@ -54,7 +54,7 @@ <body> <breadcrumbs> - <item name="${project.name}" href="${project.url}"/> + <item name="Mavenpom" href="./index.html"/> </breadcrumbs> <links> Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/pom.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -691,13 +691,13 @@ <plugin> <artifactId>maven-site-plugin</artifactId> <version>${sitePluginVersion}</version> - <dependencies> +  </plugin> <plugin> Deleted: trunk/src/site/site_en.xml =================================================================== --- trunk/src/site/site_en.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/src/site/site_en.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -1,101 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - -<project name="${project.name}"> - - <publishDate format="yyyy-MM-dd"/> - - <skin> - <groupId>org.nuiton</groupId> - <artifactId>maven-nuiton-skin</artifactId> - <version>${nuitonSkinVersion}</version> - </skin> - - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> - - <bannerRight> - <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> - <href>${project.organization.url}</href> - </bannerRight> - - <body> - - <breadcrumbs> - <item name="${project.name}" href="${project.url}"/> - </breadcrumbs> - <links> - <item name="Chorem" href="http://www.chorem.org"/> - <item name="Nuiton" href="http://www.nuiton.org"/> - <item name="Labs" href="http://labs.libre-entreprise.org/"/> - <item name="${project.organization.name}" - href="${project.organization.url}"/> - </links> - -  - -  -  - <menu name="Modules"> - <item name="Mavenpom4redmine" href="../mavenpom4redmine/en/index.html"/> - <item name="Mavenpom4labs" href="../mavenpom4labs/en/index.html"/> - </menu> - - <menu name="Inside mavenpom"> - <item name="Home" href="/index.html"/> - <item name="Properties" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - <item name="Deploy artifacts" href="repositories.html"/> - </menu> - - <menu name="Dev"> - <item name="Make a mavenpom release" href="release.html"/> - <item name="Maven best pratices" href="MavenProjectBestPratices.html"/> - </menu> - - <menu name="Links"> - <item name="maven-nuiton-skin" - href="../../maven-nuiton-skin"/> - <item name="helper-maven-plugin" - href="../../helper-maven-plugin"/> - <item name="jredmine-maven-plugin" - href="../../jredmine/jredmine-maven-plugin"/> - <item name="license-maven-plugin" - href="http://mojo.codehaus.org/license-maven-plugin/"/> - </menu> - - - <menu name="Divers"> - <item name="Version française" href="/../index.html"/> - </menu> - - <menu ref="reports"/> - - </body> -</project> Deleted: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2012-04-18 23:31:27 UTC (rev 1239) +++ trunk/src/site/site_fr.xml 2012-04-18 23:44:35 UTC (rev 1240) @@ -1,97 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - -<project name="${project.name}"> - - <publishDate format="dd/MM/yyyy"/> - - <skin> - <groupId>org.nuiton</groupId> - <artifactId>maven-nuiton-skin</artifactId> - <version>${nuitonSkinVersion}</version> - </skin> - - <bannerLeft> - <name>${project.name}</name> - <href>index.html</href> - </bannerLeft> - - <bannerRight> - <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> - <href>${project.organization.url}</href> - </bannerRight> - - <body> - - <breadcrumbs> - <item name="${project.name}" href="${project.url}"/> - </breadcrumbs> - - <links> - <item name="Chorem" href="http://www.chorem.org"/> - <item name="Nuiton" href="http://www.nuiton.org"/> - <item name="Labs" href="http://labs.libre-entreprise.org/"/> - <item name="${project.organization.name}" - href="${project.organization.url}"/> - </links> - -  - - <menu ref="modules"/> - - <menu name="Utiliser mavenpom"> - <item name="Accueil" href="index.html"/> - <item name="Propriétés" href="properties.html"/> - <item name="Profiles" href="profiles.html"/> - <item name="Configuration des serveurs" href="repositories.html"/> - </menu> - - <menu name="Développeur"> - <item name="Faire une release de mavenpom" href="release.html"/> - <item name="Maven best pratices" href="MavenProjectBestPratices.html"/> - </menu> - - <menu name="Liens"> - <item name="maven-nuiton-skin" - href="http://maven-site.nuiton.org/maven-nuiton-skin"/> - <item name="helper-maven-plugin" - href="http://maven-site.nuiton.org/helper-maven-plugin"/> - <item name="jredmine-maven-plugin" - href="http://maven-site.nuiton.org/jredmine/jredmine-maven-plugin"/> - <item name="license-maven-plugin" - href="http://mojo.codehaus.org/license-maven-plugin/"/> - - </menu> - -  - - <menu ref="reports"/> - - </body> -</project>

1 0

r1239 - in trunk: . mavenpomdoc mavenpomdoc/src mavenpomdoc/src/site mavenpomdoc/src/site/apt
by tchemit＠users.nuiton.org 18 Apr '12

18 Apr '12

Author: tchemit Date: 2012-04-19 01:31:27 +0200 (Thu, 19 Apr 2012) New Revision: 1239 Url: http://nuiton.org/repositories/revision/mavenpom/1239 Log: refs #2060: Introduce new module (mavenpomdoc) for documentation of mavenpom Added: trunk/mavenpomdoc/ trunk/mavenpomdoc/LICENSE.txt trunk/mavenpomdoc/README.txt trunk/mavenpomdoc/changelog.txt trunk/mavenpomdoc/pom.xml trunk/mavenpomdoc/src/ trunk/mavenpomdoc/src/site/ trunk/mavenpomdoc/src/site/apt/ trunk/mavenpomdoc/src/site/apt/index.apt trunk/mavenpomdoc/src/site/apt/profiles.apt trunk/mavenpomdoc/src/site/apt/properties.apt.vm trunk/mavenpomdoc/src/site/apt/release.apt trunk/mavenpomdoc/src/site/apt/repositories.apt trunk/mavenpomdoc/src/site/resources/ trunk/mavenpomdoc/src/site/site.xml Modified: trunk/pom.xml Property changes on: trunk/mavenpomdoc ___________________________________________________________________ Added: svn:ignore + target *.ipr *.iws *.iml .idea Added: trunk/mavenpomdoc/LICENSE.txt =================================================================== --- trunk/mavenpomdoc/LICENSE.txt (rev 0) +++ trunk/mavenpomdoc/LICENSE.txt 2012-04-18 23:31:27 UTC (rev 1239) @@ -0,0 +1,166 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + + This version of the GNU Lesser General Public License incorporates +the terms and conditions of version 3 of the GNU General Public +License, supplemented by the additional permissions listed below. + + 0. Additional Definitions. + + As used herein, "this License" refers to version 3 of the GNU Lesser +General Public License, and the "GNU GPL" refers to version 3 of the GNU +General Public License. + + "The Library" refers to a covered work governed by this License, +other than an Application or a Combined Work as defined below. + + An "Application" is any work that makes use of an interface provided +by the Library, but which is not otherwise based on the Library. +Defining a subclass of a class defined by the Library is deemed a mode +of using an interface provided by the Library. + + A "Combined Work" is a work produced by combining or linking an +Application with the Library. The particular version of the Library +with which the Combined Work was made is also called the "Linked +Version". + + The "Minimal Corresponding Source" for a Combined Work means the +Corresponding Source for the Combined Work, excluding any source code +for portions of the Combined Work that, considered in isolation, are +based on the Application, and not on the Linked Version. + + The "Corresponding Application Code" for a Combined Work means the +object code and/or source code for the Application, including any data +and utility programs needed for reproducing the Combined Work from the +Application, but excluding the System Libraries of the Combined Work. + + 1. Exception to Section 3 of the GNU GPL. + + You may convey a covered work under sections 3 and 4 of this License +without being bound by section 3 of the GNU GPL. + + 2. Conveying Modified Versions. + + If you modify a copy of the Library, and, in your modifications, a +facility refers to a function or data to be supplied by an Application +that uses the facility (other than as an argument passed when the +facility is invoked), then you may convey a copy of the modified +version: + + a) under this License, provided that you make a good faith effort to + ensure that, in the event an Application does not supply the + function or data, the facility still operates, and performs + whatever part of its purpose remains meaningful, or + + b) under the GNU GPL, with none of the additional permissions of + this License applicable to that copy. + + 3. Object Code Incorporating Material from Library Header Files. + + The object code form of an Application may incorporate material from +a header file that is part of the Library. You may convey such object +code under terms of your choice, provided that, if the incorporated +material is not limited to numerical parameters, data structure +layouts and accessors, or small macros, inline functions and templates +(ten or fewer lines in length), you do both of the following: + + a) Give prominent notice with each copy of the object code that the + Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the object code with a copy of the GNU GPL and this license + document. + + 4. Combined Works. + + You may convey a Combined Work under terms of your choice that, +taken together, effectively do not restrict modification of the +portions of the Library contained in the Combined Work and reverse +engineering for debugging such modifications, if you also do each of +the following: + + a) Give prominent notice with each copy of the Combined Work that + the Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the Combined Work with a copy of the GNU GPL and this license + document. + + c) For a Combined Work that displays copyright notices during + execution, include the copyright notice for the Library among + these notices, as well as a reference directing the user to the + copies of the GNU GPL and this license document. + + d) Do one of the following: + + 0) Convey the Minimal Corresponding Source under the terms of this + License, and the Corresponding Application Code in a form + suitable for, and under terms that permit, the user to + recombine or relink the Application with a modified version of + the Linked Version to produce a modified Combined Work, in the + manner specified by section 6 of the GNU GPL for conveying + Corresponding Source. + + 1) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (a) uses at run time + a copy of the Library already present on the user's computer + system, and (b) will operate properly with a modified version + of the Library that is interface-compatible with the Linked + Version. + + e) Provide Installation Information, but only if you would otherwise + be required to provide such information under section 6 of the + GNU GPL, and only to the extent that such information is + necessary to install and execute a modified version of the + Combined Work produced by recombining or relinking the + Application with a modified version of the Linked Version. (If + you use option 4d0, the Installation Information must accompany + the Minimal Corresponding Source and Corresponding Application + Code. If you use option 4d1, you must provide the Installation + Information in the manner specified by section 6 of the GNU GPL + for conveying Corresponding Source.) + + 5. Combined Libraries. + + You may place library facilities that are a work based on the +Library side by side in a single library together with other library +facilities that are not Applications and are not covered by this +License, and convey such a combined library under terms of your +choice, if you do both of the following: + + a) Accompany the combined library with a copy of the same work based + on the Library, uncombined with any other library facilities, + conveyed under the terms of this License. + + b) Give prominent notice with the combined library that part of it + is a work based on the Library, and explaining where to find the + accompanying uncombined form of the same work. + + 6. Revised Versions of the GNU Lesser General Public License. + + The Free Software Foundation may publish revised and/or new versions +of the GNU Lesser General Public License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. + + Each version is given a distinguishing version number. If the +Library as you received it specifies that a certain numbered version +of the GNU Lesser General Public License "or any later version" +applies to it, you have the option of following the terms and +conditions either of that published version or of any later version +published by the Free Software Foundation. If the Library as you +received it does not specify a version number of the GNU Lesser +General Public License, you may choose any version of the GNU Lesser +General Public License ever published by the Free Software Foundation. + + If the Library as you received it specifies that a proxy can decide +whether future versions of the GNU Lesser General Public License shall +apply, that proxy's public statement of acceptance of any version is +permanent authorization for you to choose that version for the +Library. + Property changes on: trunk/mavenpomdoc/LICENSE.txt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision Added: svn:eol-style + native Property changes on: trunk/mavenpomdoc/README.txt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision Added: svn:eol-style + native Property changes on: trunk/mavenpomdoc/changelog.txt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision Added: svn:eol-style + native Added: trunk/mavenpomdoc/pom.xml =================================================================== --- trunk/mavenpomdoc/pom.xml (rev 0) +++ trunk/mavenpomdoc/pom.xml 2012-04-18 23:31:27 UTC (rev 1239) @@ -0,0 +1,141 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<project xmlns="http://maven.apache.org/POM/4.0.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + + <modelVersion>4.0.0</modelVersion> + +  +  +  + + <parent> + <groupId>org.nuiton</groupId> + <artifactId>mavenpom4redmineAndCentral</artifactId> + <version>3.2.2-SNAPSHOT</version> + </parent> + + <artifactId>mavenpomdoc</artifactId> + <name>mavenpomdoc</name> + + <description>Documentation of the mavenpom project.</description> + + <inceptionYear>2012</inceptionYear> + + <url>http://maven-site.nuiton.org/mavenpom</url> + + <properties> + + <projectId>mavenpom</projectId> +  + <siteSourcesType>apt</siteSourcesType> + + <license.licenseName>lgpl_v3</license.licenseName> + +  + +  + <arguments>-DperformRelease -Pcentral-safe</arguments> +  + <releaseProfiles>central-safe</releaseProfiles> + +  + <release.repository>${central.release.repository}</release.repository> +  + <repository.home.url>${central.release.home.url}</repository.home.url> + +  + <redmine.safe>true</redmine.safe> + +  + <redmine.url>http://www.${platform}</redmine.url> + <redmine.projectId>${projectId}</redmine.projectId> + <redmine.xmlPath>${maven.gen.dir}/changes/changes.xml</redmine.xmlPath> + <redmine.collectedArtifacts>target/collect-artifacts.txt + </redmine.collectedArtifacts> + <redmine.deploymentUrl>${repository.home.url}</redmine.deploymentUrl> + + </properties> + + <packaging>pom</packaging> + + <distributionManagement> + <site> + <id>${platform}</id> + <url>${our.site.repository}/${projectId}</url> + </site> + </distributionManagement> + +  +  +  +  +  + + <reporting> + <plugins> + + <plugin> + <artifactId>maven-changes-plugin</artifactId> + <version>${changesPluginVersion}</version> + <configuration> + <issueLinkTemplatePerSystem> + <redmine>${redmine.issueLinkTemplate}</redmine> + </issueLinkTemplatePerSystem> + <xmlPath>${redmine.xmlPath}</xmlPath> + </configuration> + <reportSets> + <reportSet> + <reports> + <report>changes-report</report> + </reports> + </reportSet> + </reportSets> + </plugin> + + <plugin> + <groupId>org.nuiton.jredmine</groupId> + <artifactId>jredmine-maven-plugin</artifactId> + <version>${jredminePluginVersion}</version> + <configuration> + <columnNames> + key,summary,status,assignee,tracker,priority,version,category,createdOn + </columnNames> + </configuration> + <reportSets> + <reportSet> + <reports> + <report>issues-report</report> + </reports> + </reportSet> + </reportSets> + </plugin> + + </plugins> + </reporting> + +</project> Property changes on: trunk/mavenpomdoc/pom.xml ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Added: trunk/mavenpomdoc/src/site/apt/index.apt =================================================================== --- trunk/mavenpomdoc/src/site/apt/index.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/index.apt 2012-04-18 23:31:27 UTC (rev 1239) @@ -0,0 +1,345 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Maven nuiton pom +------ +------ +2009-08-22 +------ + +Présentation + + Le projet <mavenpom> est un pom de type <Corporate> dont héritent tous les + projets {{{http://www.codelutin.com}code Lutin}}. + + +* Nouveautés de la version 3.1 + +** Changement du maven-helper-plugin + + Depuis la version 1.4, maven-helper-plugin devien helper-maven-plugin (tout du + moins son GAV). Le site du projet reste bien (pour le moment) + {{http://maven-site.nuiton.org/maven-helper-plugin}}. + +* Nouveautés de la version 3.0.3 + +** Correction des déployements de site + + La version 3.0.3 corrige les problèmes suite au passage sur le + maven-site-plugin 3.0. + + L'héritage des définitions de site ne fonctionne plus, on ne peut donc plus + gérer cela au niveau de mavenpom et ses fils. + + Il faut donc dans chaque projet client ajouter ceci : + +-------------------------------------------------------------------------------- + <distributionManagement> + <site> + <id>${platform}</id> + <url>${our.site.repository}/${projectId}</url> + </site> + </distributionManagement> +-------------------------------------------------------------------------------- + + Les variables *site.repository* et *site.server* ne sont donc plus utiliséees et + sont supprimées sauf pour les projets héritants du mavenpom4labs. + +** Déployements via nexus (plutôt que par ssh) + + On utilise désormais le déployement en http via nexus. + + Il faut donc avoir un nouveau server dans son settings.xml + +-------------------------------------------------------------------------------- +  + <server> + <id>nuiton-nexus-deploy</id> + <username>deployment</username> + <password>{le mot de passe qui va bien :)}</password> + </server> +-------------------------------------------------------------------------------- + +* Nouveautés de la version 3.0 + + La version 3.0 survient avec une nouvelle forge http://forge.codelutin.com + + Cette forge est basée sur redmine et cela a nécessité du coup de revoir + légèrement l'utilisation de la variable <<platform>> et des serveurs dans le + <<settings.xml>>. + +** Modification du settings.xml + + Il faut donc ajouter les serveurs suivants (dans le <<settings.xml>>) : + +------------------------------------------------------------------------------- +  + <server> + <id>nuiton.org</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + + +  + <server> + <id>chorem.org</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>forge.codelutin.com</id> + <username>publish</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>labs.libre-entreprise.org</id> + <username>votre login sur le labs</username> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + </server> + +  + <server> + <id>redmine-forge.codelutin.com</id> + <username>votre login sur le redmine forge.codelutin.com </username> + <password>{votre password encodé sur forge.codelutin.com}</password> + </server> + +------------------------------------------------------------------------------- + +** Migration des projets + + En théorie, rien à faire tout reste compatible sauf pour les projets + utilisant mavenpom4labs. + + Il faut désormais rajouter la section de définition du server de site car + cela ne fonctionne plus très bien depuis le passage sur le maven-site-plugin 3. + +* Nouveautés de la version 2.5 + + Depuis la version <<2.5>>, chaque librairie ou plugin utilisé dans le mavenpom + ou un de ses fils est configurable via une propriété, il s'agit d'une + généralisation de ce qui était déjà fait sur nos propres plugins et les + librairies. + + Cela permet de pouvoir dans un projet utilisant un des mavenpom de pouvoir + changer les versions de librairies ou plugins sans avoir à redéfinir les + dépendances. + + +** Mise à jour plugins + + * {{{http://maven-site.nuiton.org/maven-helper-plugin}maven-helper-plugin 1.2.11}} + + * {{{http://maven-site.nuiton.org/jrst}jrst 1.2}} + + * {{{http://maven.apache.org/plugins/maven-plugin-plugin/}maven-plugin-plugin 2.7}} + + * {{{http://maven.apache.org/plugins/maven-changes-plugin/}maven-changes-plugin 2.4}} + +* Nouveautés de la version 2.4 + + Depuis la version <<2.4>>, on introduit on gère les librairies les plus souvent + utilisées dans nos projets et ceci pour éviter de repasser dans les poms : c'est + plus facile de changer de mavenpom que de changer les versions dans chaque projet. + + Voir la page des propriétés pour connaitre toutes les librairies connues au + niveau du mavenpom. + + On a aussi renommer toutes les propriétés de versin en utilisant le <camelStyle> + pour faire comme les petits copains de chez Maven. Par exemple <maven.version> + devient <mavenVersion>. + + On a ajouté un profile <analyze-dependencies> qui est automatiquement déclanché + lors d'une release pour vérifier la consistance des dépendances d'un projet. + + Pour le reste, c'est {{{http://nuiton.org/versions/show/198}ici}}. + +* Nouveautés de la version 2.3 + + Depuis la version <<2.3>>, un nouveau type de pom nommé + du <<mavenpom4redmineAndCentral>> pour tous les projets déployés sur redmine + et synchronisés sur Maven central. + + Il hérite du <mavenpom4redmine> et rajoute la configuration pour que cela soit + déployé sur maven central. + + Pour plus d'informations, voir la page de + {{{./mavenpom4redmineAndCentral/index.html} de mavenpom4redmineAndCentral}}. + +* Nouveautés de la version 2.2.2 + +** Simplification des noms de dépôts + + On a supprimé <<nuiton->> de tous les noms de dépôts de release + +** Configuration central-safe améliorée + + La configuration <<central-safe>> a été améliorée, il s'agit désormais d'un + {{{./profiles.html#central_safe}profile central-safe}} qui n'est pas activé + lors d'une release. + + Les projets <<central-safe>> modifie la configuration du <<plugin release>> + pour inclure explicitement ce profile et en <<prepare>> et en <<perform>>. + +** Mise à jour plugins + + * {{{http://maven-site.nuiton.org/maven-helper-plugin}maven-helper-plugin 1.2.6}} + + * {{{http://maven-site.nuiton.org/maven-license-plugin/fr}maven-license-plugin 2.3.1}} + +* Nouveautés de la version 2.2.1 + + Depuis la version <<2.2.1>> on utilise + {{{http://maven-site.nuiton.org/maven-license-plugin/fr}maven-license-plugin 2.3}}. + + Cela permet d'améliorer la qualité des fichiers THIRD-PARTY générés + (dépendances sans license, licenses dupliquées,...). + + On a aussi dans cette version de <mavenpom> ajouté une configuration pour permettre + en phase de préparation de release (<release:prepare>) d'activer les profiles + de releases afin de pouvoir détecter d'éventuelles problèmes avant le tag svn. + +* Nouveautés de la version 2.2 + + Depuis la version <<2.2>> on a amélioré la configuration des serveurs de + déployement et introduit la notion de projet <<central-safe>>. + + Un tel projet répond aux pré-requis d'un projet synchronisable sur {{{http://repo1.maven.org/maven2}central}} : + + * avoir un pom de bonne qualité (informations scm, url, license, ...) + + * être auto-conteneur (pas besoin d'autre dépôts que central) + + * être signé via gpg + + * javadoc et sources disponibles + + [] + + Pour plus d'informations, voir la page de {{{./repositories.html}configuration des serveurs}}. + +Les propriétés + + Voir la page des {{{./properties.html}propriétés}}. + +Les profiles + + Mavenpom définit un certain nombre de profiles. Certains sont dédiés + exclusivement à la préparation de releases, tandis que d'autres permettent de + réaliser certaines tâches pendant le développement (mise à jour des entêtes + des fichiers sources par exemple). + + La page des {{{./profiles.html}profiles}} décrit l'ensemble des profiles. + +Vérification de conformité + + On effectue sur le pom des contrôles de conformités via le plugin + <maven-enforcer-plugin>. + +* propriétés obligatoires + + Aucune à l'heure actuelle + +* Fichiers obligatoires + +-------------------------------------------------------------------------------- +README.txt +changelog.txt +LICENSE.txt +-------------------------------------------------------------------------------- + +Configuration des plugins + + Mavenpom fixe les versions d'un certain nombre de plugins et ceci pour + plusieurs raisons : + + * la <reproductibilité> : en effet, si on ne fixe pas les versions des plugins + on s'expose d'un build à l'autre à ne pas utiliser la même version des + plugins, et donc dans le temps on ne peut pas garantir que le build d'un + projet sera exactement le même. Ceci est une préconisation de <<maven>>. + + * l'<uniformisation> : le fait de fixer le plus grand nombre de versions de + plugin permet aussi de faire profiter à tous les projets héritant de + <<mavenpom>> d'une certaine stabilité et de faire profiter à tous des + dernières versions des plugins testées. + + * un dernier point intéressant est le fait que si on utilise correctement + <<mavenpom>>, on ne doit pas à avoir à gérer les versions des plugins hormis + les exceptions citées dans la section suivante. + +* Les plugins configurés dans mavenpom + + On distingue deux types de plugins : + + * les plugins <<internes>> que nous produisont + (et donc qui dépendent de <<mavenpom>>). + + * les plugins <<externes>> (ceux d'apache, codehaus, plexus,...) qui ne + dépendent pas de <<mavenpom>> + +** Plugins internes + + Nos plugins ne doivent pas être décrit dans <<mavenpom>> et ceci pour la + simple raison que nos propres plugins utilisent <<mavenpom>>, 3 exceptions + existent cependant : + + * <<maven-helper-plugin>> : il est utilisé pour construire les releases + + * <<maven-jredmine-plugin>> : aussi utilisé pour construire les releases + + * <<maven-license-plugin>> : utilisé dans les profiles de mises à jour des + entêtes de licenses. + + [] + + Tous nos autres plugins ne sont pas référencés ici et doivent donc être + entièrement définies (version + configuration) dans vos pom. + +** Plugin externes + + Pour tout plugin dit externe, il peut être référencé dans <<mavenpom>>. + +** Bonnes pratiques sur l'utilisant d'un plugin externe dans votre pom + + Avant de vouloir utiliser un nouveau plugin dans votre pom, consulter en + premier la page des {{{./plugin-management.html}plugins}} connus par <<mavenpom>>. + + Si le plugin est connu, alors pas de question à se poser, on peut l'utiliser + sans spécifier sa version utilisant celle définit dans <<mavenpom>>. + + Si le plugin n'existe pas, faites une demande d'évolution sur le projet + <<mavenpom>>, il sera rapidemment ajouté et vous pourrez l'utiliser en vous + plaçant sur la dernière snapshot de <<mavenpom>>. + Property changes on: trunk/mavenpomdoc/src/site/apt/index.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Added: trunk/mavenpomdoc/src/site/apt/profiles.apt =================================================================== --- trunk/mavenpomdoc/src/site/apt/profiles.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/profiles.apt 2012-04-18 23:31:27 UTC (rev 1239) @@ -0,0 +1,408 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Profiles disponibles dans mavenpom +------ +------ +2009-10-11 +------ + +Abstract + + Cette page décrit l'ensemble des profiles ajoutés (ou surchargés) dans mavenpom + et disponibles pour tous les projets qui en héritent. + + <<Notation:>> Pour définir l'utilisation d'un propriété du projet, on écrit : + +-------------------------------------------------------------------------------- +(propriété) +-------------------------------------------------------------------------------- + +Vue d'ensemble + +* Profiles autonomes + + Il s'agit de profiles qui peuvent être inclus lors d'un build pour effectuer + des tâches diverses. + +*----------------------------------+------------------------------+ +| <<Nom du profile>> | <<Propriété d'activation>> | +*----------------------------------+------------------------------+ +| {{no-tests}} | <<->> | +*----------------------------------+------------------------------+ +| {{no-reports}} | <<->> | +*----------------------------------+------------------------------+ +| {{no-dep-details}} | <<->> | +*----------------------------------+------------------------------+ +| {{no-dep-locations}} | <<->> | +*----------------------------------+------------------------------+ +| {{webstart-profile}} | <<doWebstart>> | +*----------------------------------+------------------------------+ +| {{local-webstart-profile}} | <<doLocalWebstart>> | +*----------------------------------+------------------------------+ +| {{run}} | <<->> | +*----------------------------------+------------------------------+ +| {{staging-site-profile}} | <<stagingSite>> | +*----------------------------------+------------------------------+ + +* Profiles inclus dans le cycle de release + + L'ensemble des profiles inclus lors d'un cycle de release. + +*----------------------------------+------------------------------+ +| <<Nom du profile>> | <<Propriété d'activation>> | +*----------------------------------+------------------------------+ +| {{reporting}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{release-profile}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{license-profile}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{update-file-header}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{release-sign-artifacts}} | <<performRelease>> | +*----------------------------------+------------------------------+ +| {{central-safe}} | - | +*----------------------------------+------------------------------+ + +* Profiles inclus dans le cycle de release de mavenpom + + L'ensemble des profiles inclus lors d'un cycle de release de mavenpom. + +*----------------------------------+------------------------------+ +| <<Nom du profile>> | <<Propriété d'activation>> | +*----------------------------------+------------------------------+ +| {{internal}} | <<internal>> | +*----------------------------------+------------------------------+ +| {{internal-redmine-pre-release}} | <<internalRedminePreRelease>>| +*----------------------------------+------------------------------+ +| {{internal-redmine-release}} | <<internalRedmineRelease>> | +*----------------------------------+------------------------------+ + +Détails + +* Profiles autonomes + +** {no-tests} + + Ce profile permet de ne pas lancer les tests. + {{{Profiles autonomes}[remonter]}} + +-------------------------------------------------------------------------------- +mvn install -Pno-tests +-------------------------------------------------------------------------------- + +** {no-reports} + + Ce profile permet de ne pas lancer la génération des rapports sur le cycle + <site>. + +-------------------------------------------------------------------------------- +mvn site -Pno-reports +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +* {run} + + Ce profile permet de lancer une classe java depuis maven. Il faut définir une + propriété <maven.jar.main.class> qui exprime le nom qualifié de la classe à + lancer. + +-------------------------------------------------------------------------------- +mvn -Prun -Dmaven.jar.main.class=org.nuiton.MyMainClass +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {no-dep-details} + + Ce profile permet de désactiver la génération du détail des dépendances + lors du rapport des dépendances (accélère beaucoup les temps de génération du + site en phase de développement). + +-------------------------------------------------------------------------------- +mvn site -Pno-dep-details +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {no-dep-locations} + + Ce profile permet de désactiver la génération de la localisation des + dépendances lors du rapport des dépendances (accélère beaucoup les temps de + génération du site en phase de développement). + +-------------------------------------------------------------------------------- +mvn site -Pno-dep-locations +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {webstart-profile} + + Ce profile est utilisé pour construire l'application webstart associé à un + module de type <<jar>>. + + Ce profile est utilisable en activant la propriété <<doWebstart>> : + +-------------------------------------------------------------------------------- +mvn package -Pwebstart-profile +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn package -PdoWebstart +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {local-webstart-profile} + + Ce profile est utilisé pour construire l'application webstart associé à un + module de type <<jar>>. + + Le codebase du webstart généré pointe sur target/jnlp, ainsi on peut tester + en local le webstart avant tout déployement. + + Ce profile est utilisable en activant la propriété <<doLocalWebstart>> : + +-------------------------------------------------------------------------------- +mvn package -Plocal-webstart-profile +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn package -PdoLocalWebstart +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +** {staging-site-profile} + + Ce profile permet de deployer un site en local, pratique pour tester les + sites multi-modules sans avoir à deployer sur un serveur distant. + + Le profile utilise un server <<staging-site>> à définir dans votre + <settings.xml>. + + Il est possible de définir en ligne de commande l'url où deployer via la + propriété <<stagingUrl>>. + +-------------------------------------------------------------------------------- + mvn -Pstaging-site-profile -DstagingUrl=scpexe://myServer/myPath +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- + mvn -DstagingSite -DstagingUrl=scpexe://myServer/myPath +-------------------------------------------------------------------------------- + {{{Profiles autonomes}[remonter]}} + +* Profiles inclus dans le cycle de release + +** {reporting} + + Ce profile regroupe tous les reports utilisés pour la génération du site. + L'intérêt de les mettre dans un profile est de pouvoir générer simplement + uniquement la documentation du site sans aucun raport. + + Ce profile est utilisable en activant la propriété <performRelease> : + +-------------------------------------------------------------------------------- +mvn site -Preporting +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn site -DperformRelease +-------------------------------------------------------------------------------- + {{{Profiles inclus dans le cycle de release}[remonter]}} + +** {release-profile} + + Ce profile (défini par maven) est utilisé lors d'un <mvn release:perform>. + On y indique qu'il faut toujours inclure les sources et la javadoc. + + Ce profile est utilisable en activant la propriété <performRelease> : + +-------------------------------------------------------------------------------- +mvn deploy -Prelease-profile +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn deploy -DperformRelease +-------------------------------------------------------------------------------- + + A noter que lors d'un deploy (par exemple d'une snapshot), on <<doit>> + l'utiliser afin que les utilisateurs puissent récupérer les sources et la + javadoc dans leur IDE favori.\ + {{{Profiles inclus dans le cycle de release}[remonter]}} + +** {license-profile} + + Ce profile est utilisé lors des release. + On y indique qu'il faut toujours générer le fichier THIRD-PARTY et synchroniser les licenses. + + Ce profile est utilisable en activant la propriété <performRelease> : + +-------------------------------------------------------------------------------- +mvn -Plicense-profile +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn deploy -DperformRelease +-------------------------------------------------------------------------------- + +** {release-sign-artifacts} + + Ce profile est utilisé pour signé avec gpg les artifacts à installer ou + déployer. + + Pour pouvoir l'utiliser il faut que : + + * avoir une clef gpg de nom <<Code Lutin>> + + * avoir dans son <settings.xml> un server de nom <<gpg-signer>> qui contient : + + * username : <<Code Lutin>> + + * password : la passephrase de la clef gpg (encodé bien sûr...) + + [] + + [] + + Le clef gpg utilisé est visible {{{http://pgp.mit.edu:11371/pks/lookup?search=Code+Lutin&op=index&fingerprint=on&exact=on}ici}}. + + Pour la récupérer, executer la commande + +-------------------------------------------------------------------------------- +gpg --keyserver hkp://pgp.mit.edu --recv-keys 014A6ED2 +-------------------------------------------------------------------------------- + + + {{{Profiles inclus dans le cycle de release}[remonter]}} + +** {update-file-header} + + Ce profile permet la mise à jour des entêtes de tous les fichiers d'un + projet en utilisant le nouveau goal <update-file-header> + (depuis maven-license-plugin 2.1). + + Il faut avoir définit un fichier + +-------------------------------------------------------------------------------- +license.descriptor +-------------------------------------------------------------------------------- + + qui est par défaut <<src/license/project.xml>>. + + Ce fichier décrit les en-têtes à inspecter. + +-------------------------------------------------------------------------------- +mvn -Pupdate-file-header +-------------------------------------------------------------------------------- + + ou + +-------------------------------------------------------------------------------- +mvn -DperformRelease +-------------------------------------------------------------------------------- + {{{Profiles inclus dans le cycle de release}[remonter]}} + +** {central-safe} + + Ce profile permet de vérifier que toutes les dépendances du projets sont sur + central et central-release. + + Il n'est pas inclus directement dans le cycle de release (car seul les projets + central-safe doivent l'utiliser). + + Pour l'utiliser lors d'une release ajouter ceci dans la section <<properties>> + de votre pom : + +-------------------------------------------------------------------------------- +  + +  + <arguments>-DperformRelease -Dcentral-safe</arguments> + +  + <releaseProfiles>central-safe</releaseProfiles> +-------------------------------------------------------------------------------- + + Pour le lancer manuellement : + +-------------------------------------------------------------------------------- +mvn -Pcentral-safe +-------------------------------------------------------------------------------- + {{{Profiles inclus dans le cycle de release}[remonter]}} + +* Profiles inclus dans le cycle de release de mavenpom + +** {internal} + + Ce profile permet de corriger l'url de deployement du site de <mavenpom> + et il <<DOIT>> être toujours utilisé lors d'une installation déployement + ou d'une release. + + Il est activable via la propriété <<internal>>. + + Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. + + Pour plus d'information sur ce profile voir la page des + {{{./release.html}release}}.\ + {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} + +** {internal-redmine-pre-release} + + Ce profile permet de préparer la finalisation de la release en générant + les annonces de release. + + Il est activable via la propriété <<internalRedminePreRelease>>. + + Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. + + Pour plus d'information sur ce profile voir la page des + {{{./release.html}release}}.\ + {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} + +** {internal-redmine-release} + + Ce profile permet de finaliser la release de <<mavenpom>> en publiant + les annonces de release. + + + Il est activable via la propriété <<internalRedmineRelease>>. + + Ce profile ne doit être utiliser uniquement que pour le projet <<mavenpom>>. + + Pour plus d'information sur ce profile voir la page des + {{{./release.html}release}}.\ + {{{Profiles inclus dans le cycle de release de mavenpom}[remonter]}} Property changes on: trunk/mavenpomdoc/src/site/apt/profiles.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Added: trunk/mavenpomdoc/src/site/apt/properties.apt.vm =================================================================== --- trunk/mavenpomdoc/src/site/apt/properties.apt.vm (rev 0) +++ trunk/mavenpomdoc/src/site/apt/properties.apt.vm 2012-04-18 23:31:27 UTC (rev 1239) @@ -0,0 +1,620 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Propriétés disponibles dans mavenpom +------ +------ +2009-10-11 +------ + +Abstract + + Cette page décrit l'ensemble des propriétés ajoutés dans mavenpom et disponibles + pour tous les projets qui héritent de mavenpom. + + <<Notation:>> Pour définir l'utilisation d'un propriété du projet, on écrit : + +-------------------------------------------------------------------------------- +(propriété) +-------------------------------------------------------------------------------- + +Vue d'ensemble + +* Propriétés générales du projet + +*--------------------------------------+------------------------------------------------------+ +| <<Propriété>> | <<Valeur par défaut>> | +*--------------------------------------+------------------------------------------------------+ +| {{platform}} | <<nuiton.org>> | +*--------------------------------------+------------------------------------------------------+ +| {{projectId}} | <<(project.artifactId)>> | +*--------------------------------------+------------------------------------------------------+ +| {{listId}} | <<(projectId)>> | +*--------------------------------------+------------------------------------------------------+ +| {{maven.src.dir}} | <<(project.basedir)/src>> | +*--------------------------------------+------------------------------------------------------+ +| {{maven.gen.dir}} | <<(project.build.directory)/generated-sources>> | +*--------------------------------------+------------------------------------------------------+ +| {{maven.license.file}} | <<(project.basedir)/LICENSE.txt>> | +*--------------------------------------+------------------------------------------------------+ + +* Propriétés de versions + +*--------------------------------------+--------------------------------------+ +| <<Propriété>> | <<Valeur par défaut>> | +*--------------------------------------+--------------------------------------+ +| {{mavenVersion}} | <<${mavenVersion}>> | +*--------------------------------------+--------------------------------------+ +| {{antVersion}} | <<${antVersion}>> | +*--------------------------------------+--------------------------------------+ +| {{nuitonSkinVersion}} | <<${nuitonSkinVersion}>> | +*--------------------------------------+--------------------------------------+ + + Pour avoir la liste de toutes les dépendances mutualisées dans le projet, + aller sur la page {{{./dependency-management.html}des versions supportées}}. + + Chaque dépendance possède une propriété pour définir sa version, afin de vous + permettre dans vos poms de pouvoir facilement surcharger la version d'une telle + dépendances sans avoir à changer de version de mavenpom. + +*-------------------------------+--------------------------------------------------------------------------+ +| <<Propriété>> | <<librarie>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsBeanutilsVersion}} | <<commons-beanutils:commons-beanutils:${commonsBeanutilsVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsCollectionsVersion}} | <<commons-collections:commons-collections:${commonsCollectionsVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsEmailVersion}} | <<org.apache.commons:commons-email:${commonsEmailVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsHttpclientVersion}} | <<commons-httpclient:commons-httpclient:${commonsHttpclientVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsIoVersion}} | <<commons-io:commons-io:${commonsIoVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsJxpathVersion}} | <<commons-jxpath:commons-jxpath:${commonsJxpathVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsLangVersion}} | <<commons-lang:commons-lang:${commonsLangVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsLang3Version}} | <<org.apache.commons:commons-lang3:${commonsLang3Version}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsLoggingVersion}} | <<commons-logging:commons-logging:${commonsLoggingVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsPrimitivesVersion}} | <<commons-primitives:commons-primitives:${commonsPrimitivesVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{commonsMathVersion}} | <<org.apache.commons:commons-math:${commonsMathVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{guavaVersion}} | <<com.google.guava:guava:${guavaVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{junitVersion}} | <<junit:junit:${junitVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{log4jVersion}} | <<log4j:log4j:${log4jVersion}>> | +*-------------------------------+--------------------------------------------------------------------------+ + +* Propriétés de versions de plugins + + On définit dans le mavenpom beaucoup de versions de plugins. En consultant la + page {{{./plugin-management.html}des versions de plugins supportés}}. + + Comme pour les librairies, on définit une propriété pour chaque plugin définit + et ceci pour les même raisons. + + A noter que si un plugin est aussi un report il est nécessaire dans la partie report + de refournir la version du plugin (merci d'utiliser la propriété et non pas une + version en dure). + +** Plugins nuiton + +*-------------------------------+--------------------------------------------------------------------------+ +| <<Propriété (plugins nuton)>> | <<GAV>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{helperPluginVersion}} | {{{http://maven-site.nuiton.org/maven-helper-plugin} <<org.nuiton:helper-maven-plugin:${helperPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{jredminePluginVersion}} | {{{http://maven-site.nuiton.org/jredmine/maven-jredmine-plugin} <<org.nuiton.jredmine:maven-jredmine-plugin:${jredminePluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{jrstPluginVersion}} | {{{http://maven-site.nuiton.org/jrst/doxia-module-jrst} <<org.nuiton.jrst:doxia-module-jrst:${jrstPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ + +** Plugins maven + +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{Propriété (plugins maven)}} | <<GAV>> | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{antRunPluginVersion}} | {{{http://maven.apache.org/plugins/maven-antrun-plugin}<<org.apache.maven.plugins:maven-antrun-plugin:${antRunPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{assemblyPluginVersion}} | {{{http://maven.apache.org/plugins/maven-assembly-plugin}<<org.apache.maven.plugins:maven-assembly-plugin:${assemblyPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{cleanPluginVersion}} | {{{http://maven.apache.org/plugins/maven-clean-plugin}<<org.apache.maven.plugins:maven-clean-plugin:${cleanPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{compilerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-compiler-plugin}<<org.apache.maven.plugins:maven-compiler-plugin:${compilerPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{dependencyPluginVersion}} | {{{http://maven.apache.org/plugins/maven-dependency-plugin}<<org.apache.maven.plugins:maven-dependency-plugin:${dependencyPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{deployPluginVersion}} | {{{http://maven.apache.org/plugins/maven-deploy-plugin}<<org.apache.maven.plugins:maven-deploy-plugin:${deployPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{earPluginVersion}} | {{{http://maven.apache.org/plugins/maven-ear-plugin}<<org.apache.maven.plugins:maven-ear-plugin:${earPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{ejbPluginVersion}} | {{{http://maven.apache.org/plugins/maven-ejb-plugin}<<org.apache.maven.plugins:maven-ejb-plugin:${ejbPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{enforcerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-enforcer-plugin}<<org.apache.maven.plugins:maven-enforcer-plugin:${enforcerPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{gpgPluginVersion}} | {{{http://maven.apache.org/plugins/maven-gpg-plugin}<<org.apache.maven.plugins:maven-gpg-plugin:${gpgPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{installPluginVersion}} | {{{http://maven.apache.org/plugins/maven-install-plugin}<<org.apache.maven.plugins:maven-install-plugin:${installPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{invokerPluginVersion}} | {{{http://maven.apache.org/plugins/maven-invoker-plugin}<<org.apache.maven.plugins:maven-invoker-plugin:${invokerPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{jarPluginVersion}} | {{{http://maven.apache.org/plugins/maven-jar-plugin}<<org.apache.maven.plugins:maven-jar-plugin:${jarPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{javadocPluginVersion}} | {{{http://maven.apache.org/plugins/maven-javadoc-plugin}<<org.apache.maven.plugins:maven-javadoc-plugin:${javadocPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{pluginPluginVersion}} | {{{http://maven.apache.org/plugins/maven-plugin-plugin}<<org.apache.maven.plugins:maven-plugin-plugin:${pluginPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{pmdPluginVersion}} | {{{http://maven.apache.org/plugins/maven-pmd-plugin}<<org.apache.maven.plugins:maven-pmd-plugin:${pmdPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{releasePluginVersion}} | {{{http://maven.apache.org/plugins/maven-release-plugin}<<org.apache.maven.plugins:maven-release-plugin:${releasePluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{remoteResourcesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-remote-resources-plugin}<<org.apache.maven.plugins:maven-remote-resources-plugin:${remoteResourcesPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{resourcesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-resources-plugin}<<org.apache.maven.plugins:maven-resources-plugin:${resourcesPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{site2PluginVersion}} | {{{http://maven.apache.org/plugins/maven-site-plugin}<<org.apache.maven.plugins:maven-site-plugin:${site2PluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{site3PluginVersion}} | {{{http://maven.apache.org/plugins/maven-site-plugin-3.0-beta-3}<<org.apache.maven.plugins:maven-site-plugin:${site3PluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{sourcePluginVersion}} | {{{http://maven.apache.org/plugins/maven-source-plugin}<<org.apache.maven.plugins:maven-source-plugin:${sourcePluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{surefirePluginVersion}} | {{{http://maven.apache.org/plugins/maven-surefire-plugin}<<org.apache.maven.plugins:maven-surefire-plugin:${surefirePluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ +| {{warPluginVersion}} | {{{http://maven.apache.org/plugins/maven-war-plugin}<<org.apache.maven.plugins:maven-war-plugin:${warPluginVersion}>>}} | +*----------------------------------+---------------------------------------------------------------------------------------------+ + +** Plugins mojo (codehaus) + +*-------------------------------+--------------------------------------------------------------------------+ +| {{Propriété (plugins mojo)}} | <<GAV>> | +*-------------------------------+--------------------------------------------------------------------------+ +| {{coberturaPluginVersion}} | {{{http://mojo.codehaus.org/cobertura-maven-plugin}<<org.codehaus.mojo:cobertura-maven-plugin:${coberturaPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{execPluginVersion}} | {{{http://mojo.codehaus.org/exec-maven-plugin}<<org.codehaus.mojo:exec-maven-plugin:${execPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{findbugsPluginVersion}} | {{{http://mojo.codehaus.org/findbugs-maven-plugin}<<org.codehaus.mojo:findbugs-maven-plugin:${findbugsPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{gwtPluginVersion}} | {{{http://mojo.codehaus.org/gwt-maven-plugin}<<org.codehaus.mojo:gwt-maven-plugin:${gwtPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{licensePluginVersion}} | {{{http://mojo.codehaus.org/license-maven-plugin}<<codehaus.mojo:license-maven-plugin:${licensePluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{versionsPluginVersion}} | {{{http://mojo.codehaus.org/versions-maven-plugin}<<org.codehaus.mojo:versions-maven-plugin:${versionsPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{wagonPluginVersion}} | {{{http://mojo.codehaus.org/wagon-maven-plugin}<<org.codehaus.mojo:wagon-maven-plugin:${wagonPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ +| {{webstartPluginVersion}} | {{{http://mojo.codehaus.org/webstart/webstart-maven-plugin}<<org.codehaus.mojo.webstart:webstart-maven-plugin:${webstartPluginVersion}>>}} | +*-------------------------------+--------------------------------------------------------------------------+ + +** Plugins plexus (mojo) + +*-------------------------------+------------------------------------------------------------------------------------------------------+ +| {{Propriété (plugins plexus)}} | <<GAV>> | +*------------------------------------------+-------------------------------------------------------------------------------------------+ +| {{plexusPluginVersion}} | {{{http://plexus.codehaus.org/plexus-maven-plugin}<<org.codehaus.plexus:plexus-maven-plugin:${plexusPluginVersion}>>}} | +*------------------------------------------+-------------------------------------------------------------------------------------------+ +| {{plexusComponentMetadataPluginVersion}} | {{{http://plexus.codehaus.org/plexus-containers/plexus-component-metadata}<<org.codehaus.plexus:plexus-component-metadata:${plexusComponentMetadataPluginVersion}>>}} | +*------------------------------------------+-------------------------------------------------------------------------------------------+ + +** Autres plugins + +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{Propriété (autre plugins)}} | <<GAV>> | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{androidPluginVersion}} | <<com.jayway.maven.plugins.android.generation2:maven-android-plugin:${androidPluginVersion}>> | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{jettyPluginVersion}} | {{{http://mojo.codehaus.org/jetty-maven-plugin}<<org.mortbay.jetty:jetty-maven-plugin:${jettyPluginVersion}>>}} | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{tomcatPluginVersion}} | {{{http://tomcat.apache.org/maven-plugin-${tomcatPluginVersion}/}<<org.apache.tomcat.maven:tomcat6-maven-plugin:${tomcatPluginVersion}>>}} | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{tomcatPluginVersion}} | {{{http://tomcat.apache.org/maven-plugin-${tomcatPluginVersion}/}<<org.apache.tomcat.maven:tomcat7-maven-plugin:${tomcatPluginVersion}>>}} | +*-------------------------------------+------------------------------------------------------------------------------------------------+ +| {{statScmPluginVersion}} | {{{http://stat-scm.sourceforge.net}<<net.sf:stat-scm:${statScmPluginVersion}>>}} | +*-------------------------------------+------------------------------------------------------------------------------------------------+ + +** Plugins de report + +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{Propriété (reports)}} | <<GAV>> | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{changesPluginVersion}} | {{{http://maven.apache.org/plugins/maven-changes-plugin}<<org.apache.maven.plugins:maven-changes-plugin:${changesPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{projectInfoReportsPluginVersion}} | {{{http://maven.apache.org/plugins/maven-project-info-reports-plugin}<<org.apache.maven.plugins:maven-project-info-reports-plugin:${projectInfoReportsPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{changelogPluginVersion}} | {{{http://maven.apache.org/plugins/maven-changelog-plugin}<<org.apache.maven.plugins:maven-changelog-plugin:${changelogPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{jrxPluginVersion}} | {{{http://maven.apache.org/plugins/maven-jxr-plugin}<<org.apache.maven.plugins:maven-jxr-plugin:${jrxPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ +| {{sonarReportPluginVersion}} | {{{http://docs.codehaus.org/display/SONAR/Sonar+Maven+report}<<org.codehaus.sonar-plugins:maven-report:${sonarReportPluginVersion}>>}} | +*-------------------------------------+----------------------------------------------------------------------------------------------------+ + + +* Propriétés de génération de site et reports + +*--------------------------------------+--------------------------------------------------------+ +| <<Propriété>> | <<Valeur par défaut>> | +*--------------------------------------+--------------------------------------------------------+ +| {{siteSourcesType}} | <<rst>> | +*--------------------------------------+--------------------------------------------------------+ +| {{scmwebeditorEnabled}} | <<true>> | +*--------------------------------------+--------------------------------------------------------+ +| {{piwikEnabled}} | <<true>> | +*--------------------------------------+--------------------------------------------------------+ +| {{piwikId}} | << - >> | +*--------------------------------------+--------------------------------------------------------+ +| {{central.release.home.url}} | <<http://maven.nuiton.org/central-releases>> | +*--------------------------------------+--------------------------------------------------------+ +| {{other.release.home.url}} | <<http://maven.nuiton.org/other-releases>> | +*--------------------------------------+--------------------------------------------------------+ +| {{repository.home.url}} | <<(other.release.home.url)>> | +*--------------------------------------+--------------------------------------------------------+ +| {{scmwebeditorUrl}} | <<http://scmwebeditor.nuiton.org/nuiton-scmwebeditor/scmwebeditor>>| +*--------------------------------------+--------------------------------------------------------+ +| {{maven.javadoc.skip}} | <<false>> | +*--------------------------------------+--------------------------------------------------------+ +| {{maven.javadoc.quiet}} | <<true>> | +*--------------------------------------+--------------------------------------------------------+ +| {{ci.host.url}} | <<http://ci.(platform)/sonar>> | +*--------------------------------------+--------------------------------------------------------+ +| {{qa.host.url}} | <<http://qa.(platform)/jenkins>> | +*--------------------------------------+--------------------------------------------------------+ + +* Propriétés pour les déployements + +*--------------------------------------+--------------------------------------------------------+ +| <<Propriété>> | <<Valeur par défaut>> | +*--------------------------------------+--------------------------------------------------------+ +| {{snapshot.repository}} | <<(our.snapshot.repository)>> | +*--------------------------------------+--------------------------------------------------------+ +| {{snapshot.server}} | <<nuiton-nexus-deploy>> | +*--------------------------------------+--------------------------------------------------------+ +| {{our.snapshot.repository}} | <<http://nexus.nuiton.org/nexus/content/repositories/snapshots>>| +*--------------------------------------+--------------------------------------------------------+ +| {{release.repository}} | <<(other.release.repository)>> | +*--------------------------------------+--------------------------------------------------------+ +| {{release.server}} | <<nuiton-nexus-deploy>> | +*--------------------------------------+--------------------------------------------------------+ +| {{other.release.repository}} | <<http://nexus.nuiton.org/nexus/content/repositories/others-releases>> | +*--------------------------------------+--------------------------------------------------------+ +| {{central.release.repository}}| <<http://nexus.nuiton.org/nexus/content/repositories/central-releases>>| +*--------------------------------------+--------------------------------------------------------+ +| {{our.site.repository}} | <<scpexe://(platform)/var/lib/redmine-(platform)/project-site/(projectId)>> | +*--------------------------------------+--------------------------------------------------------+ + +Détails + +* Détail des propriétés générales du projet + +** {platform} + + Le host de la plateforme utilisée. + +-------------------------------------------------------------------------------- +nuiton.org +chorem.org +forge.codelutin.com +labs.libre-entreprise.org +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +** {projectId} + + L'identifiant unique du projet associé. + +-------------------------------------------------------------------------------- +(project.artifactId) +-------------------------------------------------------------------------------- + + <Note :> Sur un multi-module, la propriété doit être surchargé, sinon on + se retrouve avec des valeurs héritiés sur les modules fils, ce qui n'est pas + correct.\ + {{{Propriétés générales du projet}[remonter]}} + +** {listId} + + Le préfixe utilisé pour les listes de diffusion. + +-------------------------------------------------------------------------------- +(projectId) +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +** {maven.compile.source} + + Le niveau de java utilisé dans les sources (par défaut <<1.6>>)\ + {{{Propriétés générales du projet}[remonter]}} + +** {maven.compile.target} + + Le niveau de java utilisé dans le code compilé (par défaut <<1.6>>)\ + {{{Propriétés générales du projet}[remonter]}} + +** {maven.compile.encoding} + + Encoding à utiliser dans les sources (par défaut <<UTF-8>>)\ + {{{Propriétés générales du projet}[remonter]}} + +** {project.reporting.outputEncoding} + + Encoding à utiliser dans le site (par défaut <<UTF-8>>)\ + {{{Propriétés générales du projet}[remonter]}} + +** {maven.src.dir} + + Répertoire des sources + +-------------------------------------------------------------------------------- +(project.basedir)/src +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +** {maven.gen.dir} + + Répertoire de génération + +-------------------------------------------------------------------------------- +(project.basedir)/target/generated-sources +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +** {maven.license.file} + + Chemin vers la license utilisée dans le projet. + +-------------------------------------------------------------------------------- +(project.basedir)/LICENSE.txt +-------------------------------------------------------------------------------- + {{{Propriétés générales du projet}[remonter]}} + +* Détail des propriétés de versions + +** {mavenVersion} + + La version de l'api de maven utilisée (principalement dans les plugins maven) + : <<${mavenVersion}>>\ + {{{Propriétés de versions}[remonter]}} + +** {antVersion} + + La version de l'api de ant utilisée (principalement dans les modules de tâches ant).\ + {{{Propriétés de versions}[remonter]}} + +** {nuitonSkinVersion} + + La version de notre skin + {{{http://maven-site.nuiton.org/maven-nuiton-skin}maven-nuiton-skin}} + utilisé pour la génération des sites maven.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsBeanutilsVersion} + + La version de la librairie + {{{http://commons.apache.org/beanutils}commons-beanutils}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsCollectionsVersion} + + La version de la librairie + {{{http://commons.apache.org/collections}commons-collections}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsEmailVersion} + + La version de la librairie + {{{http://commons.apache.org/email}commons-email}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsHttpclientVersion} + + La version de la librairie + {{{http://hc.apache.org/httpclient-3.x}commons-http-client}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsIoVersion} + + La version de la librairie + {{{http://commons.apache.org/io}commons-io}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsJxpathVersion} + + La version de la librairie + {{{http://commons.apache.org/jxpath}commons-jxpath}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsLangVersion} + + La version de la librairie (en version 2) + {{{http://commons.apache.org/lang}commons-lang}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsLang3Version} + + La version de la librairie + {{{http://commons.apache.org/lang}commons-lang}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsLoggingVersion} + + La version de la librairie + {{{http://commons.apache.org/logging}commons-logging}}.\ + {{{Propriétés de versions}[remonter]}} + +** {commonsPrimitivesVersion} + + La version de la librairie + {{{http://commons.apache.org/primitives}commons-primitives}}.\ + {{{Propriétés de versions}[remonter]}} + +** {junitVersion} + + La version de la librairie + {{{http://www.junit.org}junit}}.\ + {{{Propriétés de versions}[remonter]}} + +** {log4jVersion} + + La version de la librairie + {{{http://logging.apache.org/log4j/1.2}log4j}}.\ + {{{Propriétés de versions}[remonter]}} + +* Détail des propriétés de génération de site et reports + +** {siteSourcesType} + + Le type de fichiers utilisé pour écrire la documentation du site + (<<apt>> ou <<rst>>) (par défaut <<rst>>).\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {central.release.home.url} + + L'url du dépôt des releases dite central-safe.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {other.release.home.url} + + L'url du dépôt des releases dite none central-safe.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {repository.home.url} + + L'url du dépôt maven de release du projet. Par défault on utilise + le {{{http://maven.nuiton.org/other-releases}dépôt non central safe }}. + + En utilisant le profile <<central-safe>>, cette propriété passe à : + {{{http://maven.nuiton.org/central-releases}dépôt central safe}}\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {scmwebeditorEnabled} + + Pour activer (ou déasactiver) la génération des liens scmwebeditors dans les sites + générés. (Par exemple, on ne peut pas gérer ces liens sur un svn ssh...).\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {scmwebeditorUrl} + + L'url de l'application scmwebeditor qui permet d'éditer le site en ligne.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {piwikEnabled} + Pour activer (ou déasactiver) la génération de l'analyze du site généré via + Piwik.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {piwikId} + Pour utiliser un id de site Piwik particulier pour le site générer. Par défaut + non renseigné, on utilisera celui de la forge qui héberge le projet.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {sonar.host.url} + + L'url du serveur sonar.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {jenkins.host.url} + + L'url du serveur jenkins.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +** {repository.home.url} + + L'url de dépôt maven de type release de Code Lutin. Cette propriété est + utilisée dans les sites pour les liens de téléchargement.\ + {{{Propriétés de génération de site et reports}[remonter]}} + +* Détail des propriétés pour les déployements + +** {snapshot.repository} + + Url du dépôt maven où deployer les snapshots, par défaut : <<(snapshot.repository)>>.\ + {{{Propriétés pour les déployements}[remonter]}} + +** {snapshot.server} + + Id du serveur à utiliser pour déployer les snapshots, par défault : <<nuiton-nexus-deploy>>.\ + + <<Note:>> le serveur doit être défini dans le <<settings.xml>>.\ + {{{Propriétés pour les déployements}[remonter]}} + +** {our.snapshot.repository} + + Url du dépôt maven Nuiton où deployer les snapshots. + + Valeur par défaut (<<ne devrait pas être modifiée>>) : + +-------------------------------------------------------------------------------- +scpexe://nuiton.org/var/lib/nexus/storage/snapshots +-------------------------------------------------------------------------------- + {{{Propriétés pour les déployements}[remonter]}} + +** {release.repository} + + Url du dépôt maven où deployer les releases, par défaut : <<(other.release.repository)>>.\ + {{{Propriétés pour les déployements}[remonter]}} + +** {release.server} + + Id du serveur à utiliser pour déployer les releases, par défaut : <<nuiton-nexus-deploy>>. + + <<Note:>> le serveur doit être défini dans le <<settings.xml>>.\ + {{{Propriétés pour les déployements}[remonter]}} + +** {other.release.repository} + + Url du dépôt maven de Nuiton où deployer les releases <<central-unsafe>>. + + Valeur par défaut (<<ne devrait pas être modifiée>>) : + +-------------------------------------------------------------------------------- +scpexe://nuiton.org/var/lib/nexus/storage/other-releases +-------------------------------------------------------------------------------- + {{{Propriétés pour les déployements}[remonter]}} + +** {central.release.repository} + + Url du dépôt maven de Nuiton où deployer les releases <<central-safe>>. + + Valeur par défaut (<<ne devrait pas être modifiée>>) : + +-------------------------------------------------------------------------------- +scpexe://nuiton.org/var/lib/nexus/storage/central-releases +-------------------------------------------------------------------------------- + {{{Propriétés pour les déployements}[remonter]}} + +** {our.site.repository} + + Url du dépôt maven de Nuiton où deployer les sites. + + Valeur par défaut (<<ne devrait pas être modifiée>>) : + +-------------------------------------------------------------------------------- +scpexe://nuiton.org/var/lib/redmine-(platform)/project-site/(projectId) +-------------------------------------------------------------------------------- + {{{Propriétés pour les déployements}[remonter]}} + Property changes on: trunk/mavenpomdoc/src/site/apt/properties.apt.vm ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Added: trunk/mavenpomdoc/src/site/apt/release.apt =================================================================== --- trunk/mavenpomdoc/src/site/apt/release.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/release.apt 2012-04-18 23:31:27 UTC (rev 1239) @@ -0,0 +1,107 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Effectuer une release +------ +------ +2010-01-10 +------ + +Abstract + + Cette page décrit la méthode pour effectuer une release de mavenpom. Mavenpom devant être neutre + par rapport à un quelconque environnement, on utilise des profiles uniquement réservés à <<mavenpom>>. + + + L'opération se déroule en 3 étapes. + +Etape 1 + + Effectuer une release normal + +-------------------------------------------------------------------------------- +mvn release:prepare -Dinternal +mvn release:perform -Dinternal +-------------------------------------------------------------------------------- + +Etape 2 + + Dans cette phase, on va : + + * Deployement des fichiers vers redmine + + * Créer les announces de release + + [] + + On travaille sur la version utilisée pour faire la release. + +-------------------------------------------------------------------------------- +cd target/checkout +-------------------------------------------------------------------------------- + + La commande suivante simule (sans rien déployer) + +-------------------------------------------------------------------------------- +mvn -Dinternal -DinternalRedminePreRelease -N +-------------------------------------------------------------------------------- + + Si aucune erreur lors de l'execution, on lance la commande suivante + +-------------------------------------------------------------------------------- +mvn -Dinternal -DinternalRedminePreRelease -DdryRun=false -N +-------------------------------------------------------------------------------- + + A ce stade, les annonces ont été créées ici + +-------------------------------------------------------------------------------- +target/generated-sources/announcement/release-news-announcement.vm +target/generated-sources/announcement/release-email-announcement.vm +-------------------------------------------------------------------------------- + +Etape 3 + + On finalise la release après avoir finaliser les annonces (si nécessaire) : + + * Mise à jour de la version sur redmine (on la clôture) + + * Envoie de l'email d'annonce de release + + * Publication de l'annonce de release sur redmine + + [] + + La commande suivante simule (sans rien publier) : + +-------------------------------------------------------------------------------- +mvn -Dinternal -DinternalRedmineRelease -N +-------------------------------------------------------------------------------- + + Si aucune erreur, on peut lancer la commande réelle + +-------------------------------------------------------------------------------- +mvn -Dinternal -DinternalRedmineRelease -DdryRun=false -N +-------------------------------------------------------------------------------- Property changes on: trunk/mavenpomdoc/src/site/apt/release.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Added: trunk/mavenpomdoc/src/site/apt/repositories.apt =================================================================== --- trunk/mavenpomdoc/src/site/apt/repositories.apt (rev 0) +++ trunk/mavenpomdoc/src/site/apt/repositories.apt 2012-04-18 23:31:27 UTC (rev 1239) @@ -0,0 +1,156 @@ +~~~ +~~ #%L +~~ Mavenpom +~~ ~~ +~~ $Id$ +~~ $HeadURL$ +~~ %% +~~ Copyright (C) 2009 - 2010 CodeLutin +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ + +------ +Utilisation des dépôts maven +------ +------ +2010-06-17 +------ + +Présentation + + Cette page explique comment configurer mavenpom pour déployer des artifacts. + + On distingue trois types de serveur : + + * dépôt maven de snapshots (voir {{{Déployer une snapshot}section snapshot}}). + + * dépôt maven de releases (voir {{{Déployer une release}section release}}). + + * dépôt de sites (voir {{{Déployer un site}section site}}). + +Déployer une snapshot + + Mavenpom définit grâce à deux propriétés : + + * {{{./properties.html#snapshot.repository}snapshot.repository}} + + * {{{./properties.html#snapshot.server}snapshot.server}} + + [] + + En résumé, voici la définition du serveur où déployer les snapshots : + +-------------------------------------------------------------------------------- +<snapshotRepository> + <id>${snapshot.server}</id> + <url>${snapshot.repository}</url> +</snapshotRepository> +-------------------------------------------------------------------------------- + + Par défaut, on utilise les valeurs suivantes pour le paramétrage : + + * <repository> : {{{./properties.html#our.snapshot.repository}our.snapshot.repository}} + + * <server> : <<nuiton>> + + Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> + une nouvelle valeur pour l'un des deux paramètres.\ + {{{Présentation}[remonter]}} + +Déployer une release + + Mavenpom définit grâce à deux propriétés : + + * {{{./properties.html#release.repository}release.repository}} + + * {{{./properties.html#release.server}release.server}} + + [] + + En résumé, voici la définition du serveur où déployer les releases : + +-------------------------------------------------------------------------------- +<repository> + <id>${release.server}</id> + <url>${release.repository}</url> +</repository> +-------------------------------------------------------------------------------- + + Par défaut, on utilise les valeurs suivantes pour le paramétrage : + + * <repository> : {{{./properties.html#other.release.repository}other.release.repository}} + + * <server> : <<nuiton>> + + Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> + une nouvelle valeur pour l'un des deux paramètres.\ + {{{Présentation}[remonter]}} + +* Paramétrage pour un projet <<central-unsafe>> + + Il suffit d'utiliser la configuration par défaut. + {{{Présentation}[remonter]}} + +* Paramétrage pour un projet <<central-safe>> + + Pour rendre un projet central-safe, il faut utiliser le bon dépôt de release : + {{{./properties.html#central.release.repository}central.release.repository}}. + + Pour assurer que le projet est bien compatible, on inclut le profile + <<central-safe>> dans le cycle de release. + + Pour ce faire ajouter dans la section <<properties>> du projet ceci : + +-------------------------------------------------------------------------------- +  + +  + <arguments>-DperformRelease -Pcentral-safe</arguments> + +  + <releaseProfiles>central-safe</releaseProfiles> +-------------------------------------------------------------------------------- + {{{Présentation}[remonter]}} + +Déployer un site + + Mavenpom définit grâce à deux propriétés : + + * {{{./properties.html#site.repository}site.repository}} + + * {{{./properties.html#site.server}site.server}} + + [] + + En résumé, voici la définition du serveur où déployer les sites : + +-------------------------------------------------------------------------------- +<site> + <id>${site.server}</id> + <url>${site.repository}</url> +</site> +-------------------------------------------------------------------------------- + + Par défaut, on utilise les valeurs suivantes pour le paramétrage : + + * <repository> : {{{./properties.html#our.site.repository}our.site.repository}} + + * <server> : <<nuiton>> + + Pour modifier le dépôt il suffit donc de rajouter dans la section <properties> + une nouvelle valeur pour l'un des deux paramètres.\ + {{{Présentation}[remonter]}} \ No newline at end of file Property changes on: trunk/mavenpomdoc/src/site/apt/repositories.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Added: trunk/mavenpomdoc/src/site/site.xml =================================================================== --- trunk/mavenpomdoc/src/site/site.xml (rev 0) +++ trunk/mavenpomdoc/src/site/site.xml 2012-04-18 23:31:27 UTC (rev 1239) @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<project name="${project.name}"> + + <skin> + <groupId>org.apache.maven.skins</groupId> + <artifactId>maven-fluido-skin</artifactId> + <version>1.2.1</version> + </skin> + + <custom> + <fluidoSkin> + <topBarEnabled>true</topBarEnabled> + <googleSearch/> + <sideBarEnabled>false</sideBarEnabled> + <searchEnabled>true</searchEnabled> + <sourceLineNumbersEnabled>true</sourceLineNumbersEnabled> + </fluidoSkin> + </custom> + + <bannerLeft> + <name>${project.name}</name> + <href>index.html</href> + </bannerLeft> + + <bannerRight> + <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> + <href>${project.organization.url}</href> + </bannerRight> + + <body> + + <breadcrumbs> + <item name="${project.name}" href="${project.url}"/> + </breadcrumbs> + + <links> + <item name="Chorem" href="http://www.chorem.org"/> + <item name="Nuiton" href="http://www.nuiton.org"/> + <item name="Nuiton" href="http://www.forge.codelutin.com"/> + <item name="${project.organization.name}" + href="${project.organization.url}"/> + </links> + + <menu ref="modules"/> + + <menu name="Utiliser mavenpom"> + <item name="Accueil" href="index.html"/> + <item name="Propriétés" href="properties.html"/> + <item name="Profiles" href="profiles.html"/> + <item name="Configuration des serveurs" href="repositories.html"/> + </menu> + + <menu name="Développeur"> + <item name="Faire une release de mavenpom" href="release.html"/> + <item name="Maven best pratices" href="MavenProjectBestPratices.html"/> + </menu> + + <menu name="Liens"> + <item name="maven-nuiton-skin" + href="http://maven-site.nuiton.org/maven-nuiton-skin"/> + <item name="helper-maven-plugin" + href="http://maven-site.nuiton.org/helper-maven-plugin"/> + <item name="jredmine-maven-plugin" + href="http://maven-site.nuiton.org/jredmine/jredmine-maven-plugin"/> + <item name="license-maven-plugin" + href="http://mojo.codehaus.org/license-maven-plugin/"/> + + </menu> + + <menu ref="reports"/> + + </body> +</project> Property changes on: trunk/mavenpomdoc/src/site/site.xml ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-04-09 08:29:10 UTC (rev 1238) +++ trunk/pom.xml 2012-04-18 23:31:27 UTC (rev 1239) @@ -38,6 +38,7 @@ <modules> <module>mavenpom4redmine</module> <module>mavenpom4labs</module> + <module>mavenpomdoc</module> </modules>

1 0

r1238 - trunk
by tchemit＠users.nuiton.org 09 Apr '12

09 Apr '12

Author: tchemit Date: 2012-04-09 10:29:10 +0200 (Mon, 09 Apr 2012) New Revision: 1238 Url: http://nuiton.org/repositories/revision/mavenpom/1238 Log: fixes #2055: Add versions-m-p reports Modified: trunk/pom.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-04-03 14:08:24 UTC (rev 1237) +++ trunk/pom.xml 2012-04-09 08:29:10 UTC (rev 1238) @@ -1202,6 +1202,21 @@ <artifactId>maven-report</artifactId> <version>${sonarReportPluginVersion}</version> </plugin> + + <plugin> + <groupId>org.codehaus.mojo</groupId> + <artifactId>versions-maven-plugin</artifactId> + <version>${versionsPluginVersion}</version> + <reportSets> + <reportSet> + <reports> + <report>dependency-updates-report</report> + <report>plugin-updates-report</report> + <report>property-updates-report</report> + </reports> + </reportSet> + </reportSets> + </plugin> <!--plugin> <groupId>net.sf</groupId>

1 0

r1237 - trunk
by tchemit＠users.nuiton.org 03 Apr '12

03 Apr '12

Author: tchemit Date: 2012-04-03 16:08:24 +0200 (Tue, 03 Apr 2012) New Revision: 1237 Url: http://nuiton.org/repositories/revision/mavenpom/1237 Log: fixes #2049: Updates to commons-io 2.2 Modified: trunk/pom.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-03-29 12:00:28 UTC (rev 1236) +++ trunk/pom.xml 2012-04-03 14:08:24 UTC (rev 1237) @@ -291,7 +291,7 @@ <commonsCollectionsVersion>3.2.1</commonsCollectionsVersion> <commonsEmailVersion>1.2</commonsEmailVersion> <commonsHttpclientVersion>3.1</commonsHttpclientVersion> - <commonsIoVersion>2.1</commonsIoVersion> + <commonsIoVersion>2.2</commonsIoVersion> <commonsJxpathVersion>1.3</commonsJxpathVersion> <commonsLangVersion>2.6</commonsLangVersion> <commonsLang3Version>3.1</commonsLang3Version>

1 0