Cédric Champmartin Sébastien Gaudin 
Université de Nancy 2

Nous proposons ici d'uniformiser le déploiement de nos canaux, dans le cadre de développements classiques. Par le terme classique, nous entendons 'canal' et pas 'librairies'. Pour cela, vous trouverez ici les fichiers types à utiliser dans le développement de vos canaux : build.properties, build.xml

1. Les conventions suivies

• Conventions de nommage de package : Règles de nommage des livrables ESUP
• Répertoires d'installation par défaut d'esup :

  Installation d'un environnement esup-portail de test

2. La démarche d'utilisation

2.1. Point de vue du développeur

2.1.1. Création des fichiers

• Copiez le build.properties et le build.xml dans un répertoire vide.
• Mettez à jour le build.properties avec les informations propres au channel. Il n'est plus nécessaire d'indiquer les librairies utilisées dans le canal, un classpath assez complet est défini dans le build.xml.
• Mettez à jour le nom du package dans le build.xml (première ligne de code du fichier). Ceci sert à reconnaitre ce fichier dans Eclipse.
• Avec Eclipse, créer un nouveau projet basé sur ce répertoire.

• Exécutez ant prepare.

• Avec Eclipse, régénérez le projet.
  Toute l'arborescence par défaut est créée. Il vous reste à mettre à jour les fichiers INSTALL, UPGRADE, ChangeLog et LICENCE (cliquez sur le lien pour avoir le contenu du fichier "LICENCE" officiel, que vous devrez copier dans votre fichier).

  2.1.2. Utilisation courante lors du développement

• Stoppez tomcat.
• Executez le ant all, qui va déployer correctement le canal. Pourquoi ant all et pas ant deploy ? La réponse est détaillée un peu plus loin dans ce document.
• Démarrez tomcat.

  2.2. Point de vue de l'administrateur d'UPortal

• Lisez le fichier INSTALL à la racine du package.
• Mettez à jour le build.properties avec les chemins locaux d'installation.
• Mettez à jour le fichier de configuration du canal
• S'il le canal contient des librairies vous pouvez les déployer grace à ant.
  MAIS si une librairie déjà déployée a le même nom que l'une dans le canal, cette dernière ne sera pas déployée! Pour cela utilisez la commande

  ant_deploylibs.

• Exécutez

  ant deploy

  .
• Déclarez le canal.
  

  Nous proposons désormais la target ant deploypubchan, qui permet de déposer les fichiers pubchan dans le répertoire d'uPortal. Executez ensuite la commande ant uportal.pubchan du build.xml fourni dans le package esupdev.

• Testez le canal.

  3. Détail du build.properties

Ce fichier se compose de 2 parties :

• Les répertoires utiles
• Les informations sur le projet

  3.1. Les répertoires

Normalement, sous windows, les trois chemins (Tomcat, uPortal et deploy) sont décrits dans la distribution esup standard , mais libre à chacun de s'organiser comme il veut, donc vous pouvez adapter ici l'installation à votre arborescence locale.

tomcat.home  = C:/esupdev/esupdev-2.4/uPortal_2-4-1-quick-start/Tomcat_5-0-28

uportal.home = C:/esupdev/esupdev-2.4/uPortal_2-4-1-quick-start/uPortal_rel-2-4-1

deploy.home  = C:/esupdev/esupdev-2.4/uPortal_2-4-1-quick-start/webapps/uPortal

Deux chemins d'installation doivent être précisés : Là où seront déployées les sources (depuis $

{deploy.home}/WEB-INF/classes/) deploy.tree  = org/esupportail/portal/channels
#deploy.tree  = fr/univ/portal/channelset

là ou seront déployés les fichiers de propriétés (depuis ${deploy.home}
/WEB-INF/classes/properties)

properties.tree = org_esup

#properties.tree  = fr_univ

3.2. Informations sur le projet

Le nom du canal va servir à nommer les répertoires spécifiques pour le déployement du canal (pour les feuilles de style, pour les properties ... etc).

app.name.home=CExemple

La variable app.version est utilisée à titre indicatif pour le javadoc et pour dans le nom des fichiers .tar.gz et .zip générés.

app.version=1.0.1-RC-1

Le nom du package va servir à nommer les fichiers .tar.gz et .zip générés.

app.name.deploy=esup-canal-exemple

Les fichiers sont déployés dans les répertoires suivants :

• pour les classes et les feuilles de styles : $deploy.home\WEB-INF\classes\$deploy.tree\$app.name.home
  Exemple : C:\esupdev\esupdev-2.2\uPortal_2-2-quick-start\webapps\uPortal\WEB-INF\classes\org\esupportail\portal\channels\CExemple
• pour les fichiers de config : $deploy.home\WEB-INF\classes\properties\channels\$properties.tree\$app.name.home
  Exemple : C:\esupdev\esupdev-2.2\uPortal_2-2-quick-start\webapps\uPortal\WEB-INF\classes\properties\channels\org_esup\CExemple
• pour les fichiers statiques : $deploy.home\media\$deploy.tree\$app.name.home
  Exemple : C:\esupdev\esupdev-2.2\uPortal_2-2-quick-start\webapps\uPortal\media\org\esupportail\portal\channels\CExemple
• pour les feuilles de style : $deploy.home\WEB-INF\classes\$deploy.tree\$app.name.home
  Exemple : C:\esupdev\esupdev-2.2\uPortal_2-2-quick-start\webapps\uPortal\org\esupportail\portal\channels\CExemple

  Les répertoires en italique dans les éxemples ci-dessus sont les répertoires par défaut. Si vous n'utilisez pas ces répertoires, vous pouvez les modifier dans le build.xml (les noms sont en début de fichiers).

4. Détail du build.xml

Les "sous-targets" n'ont pas de description. Ceci implique qu'il est possible, sous eclipse, de les masquer.

Voici le détail des targets que vous serez amené à utiliser :

allAppel des 3 targets :clean,undeploy(permet d'effacer de "vieux" fichiers dans l'arborescence),deploy. Très utile lors dudéveloppement d'un canal.

prepareCrée tous les répertoires par défaut dans le canal (docs,tests,source...), peut être utilisé pour obtenir unenvironnement type de développement.

cleanVide les répertoiresbuild,junitBuildetdist.

undeploySupprime tous les éléments (classes,media,properties,stylesheets) mis en place par la targerant_deploymaispas les librairies, ni le fichier correspondant au pubchan

deployCompile et déploie le canal (classes,media,properties,stylesheets) maispas les librairies, ni le fichier correspondant au pubchan

compilCompile le canal dans lebuild

javadocCrée la javadoc

distCrée le.jar du canal pour la distribution

buildtarCrée le package en.tar.gz

buildzipCrée le package en.zip(zip même si les noms complets des fichiers dépassent 100 caractères)

junit.initvide les répertoires nécessaires aux tests junits

junit.compilecompile les classes junit (par défault dans le répertoirebuildJunit)

junit.startlance le(s) test(s) junits.

deploylibsPermet de déployer les librairies du canal.MAIS si une librairie déjà déployée a le même nom que l'une dans le canal, cette dernière ne sera pas déployée! Pour cela utilisez la commandeant_deploylibs. Sous eclipse, cette target ne fonctionne pas, car le logiciel ne prend pas en compte l'intervention utilisateur dans la console.

undeploylibsPermet d'enlever les librairies propres au canal.MAIS si une librairie est utilisée pour un autre canal, elle sera tout de même supprimée.Sous eclipse, cette target ne fonctionne pas, car le logiciel ne prend pas en compte l'intervention utilisateur dans la console.

deploypubchanPermet de déposer les fichiers pubchan dans le répertoire d'uPortal. Executez ensuite la commandeant_uportal.pubchandubuild.xmlfournit dans le package esupdev.

undeploypubchanPermet d'enlever les fichiers pubchan relatifs au canal du répertoire d'uPortal.

docbook.to.htmlTransforme le docbook en HTML.

docbook.to.html.noindexTransforme le docbook en HTML sans générer de table des matières.

5. Ce que ce build ne fait pas

• Le déploiement automatique des librairies lors du déploiment du canal.
• La suppression automatique des librairies lors de la désinstallation du canal.
• La création de la base de données spécifique au canal, le chargement des données ainsi que la destruction de cette base.
• La publication du canal.