Télécharger - Support et Communauté JCMS
Contents
1. etc Monolithic layout Single project or multiple projects layout Name MyJCMSPlugin Comment this is a new project structure for MyJCMSPlugin 4 gt MyICMSPlugin 599 ff trunk 599 a branches 599 tags 599 e Cliquez droit sur trunk puis s lectionnez Check Out Cette op ration cr e un projet Eclipse en utilisant le nom MyJCMSPlugin Pour v rifier que le checkout s est bien d roul passez dans la perspective Java Un projet vide avec un fichier de configuration project est pr sent aq gt MyJCMSPlugin 599 project e Ensuite 1l faut importer une structure de module JCMS dans ce projet qui sera un projet module JCMS Pour ce faire o Soit vous poss dez d j un module JCMS sous forme de zip Dans ce cas il suffit de le d compresser la racine de MyJCMSPlugin L arborescence ressemblera a la structure suivante gt fey plugins 1956 4 ey WEB INF 2009 4 ey classes 2009 gt fey com 2009 gt Gy data 1956 gt fey plugins 2009 o Soit vous d marrez le d veloppement il faut cr er ce module MyJCMSPlugin Dans ce cas il faut aller dans l interface web de JCMS puis cr er empaqueter un module MyJCMSPlugin JCMS va produire un module sous forme de zip D compressez ce zip la racine de MyJCMSPlugin o Au fur et mesure du d veloppement vous aurez besoin d impl menter des classes Java ou utiliser des librairies tiers dans votre modu2. 3 2 3 Gestion du fichier custom prop cccccessssccescessuscceeeuscessuueuuucussuseuuucusseueauucessursauuaussersaueaess 28 3 2 4 Synchronisation des donn es du StOre ccccceesseeeteeseeeneeeeneuseeeteaseneesaseeensageeeneagenensagens 28 33 ROCCO a aenuuseueyeusseesuueseeveueteanees 33 34 Mis e DOC ONE isnin aain airo ria EANAN 33 PATIOS EER 34 e a Eee 34 SZ Sage dU SOE MEOE osrin EEE eat at iii tion 34 1 Objectif du document L utilisation d un syst me de gestion de versions tel que SVN permet de centraliser la gestion des sources pour tous les d veloppeurs et de conserver une trace de toutes les modifications apport es lors des d veloppements Cet article pr sente l architecture recommand e et les processus appliquer pour d velopper des modules J MS avec un serveur SVN Pr requis Connaissance du m canisme de module dans JCMS Connaissance du processus de d ploiement d une webapp JCMS Notion de base sur la mise en uvre et l utilisation d un serveur SVN Installation et utilisation d Eclipse 2 Principes 2 1 Architecture L ensemble des composants n cessaires sont 1 un serveur SVN pour les d veloppements 2 un serveur J2EE e g Tomcat pour l environnement de recette et de pr production h bergeant la webapp JCMS Un script de d ploiement pr sent sur l environnement de recette et celui d exploitation pour les op rations de d ploiement 3 un serveur J2EE pour l envi
3. gt Basic eo Publishes and runs J2EE and Java EE Web projects and server configurations to a local Tomeat server Server s host name localhost Server name Tomcat v6 0 Server at localhost e Pour terminer la configuration Eclipse propose de configurer les projets web qu il reconna t Laissez vide pour l instant et cliquez sur Finish Add and Remove Modify the resources that are configured on the server Move resources to the right to configure them on the server Available Configured Add lt Remove Add All gt gt lt lt Remove All 3 Configuration d un lanceur de serveur d application e Ouvrez la vue Servers Faites Window gt Show View gt Other gt Chercher Servers i Problems i ie Call Hierarchy YY Search El His gt 22 Internal GlassFish 3 1 Stopped gt E Tomcat v5 5 Server at localhost Stopped Le Tomcat v6 0 Server at localhost Stopped Republish agram e Double cliquez sur Tomcat v6 0 Server at localhost Un r capitulatif des configurations va s afficher e Dans la zone Timeouts se trouve le param trage qui d clenche l arr t du d marrage Configurez le champ Start a 500s Si le temps de d marrage d passe 500s le serveur va s arr ter automatiquement Timeouts Specify the time limit to complete server operations Start in seconds Stop in seconds e La zone Servers Options Cochez la case Serve modules without publishing Cel
4. pertoire WebContent qui est consid r comme la racine The JCMS webapp root directory to sync root dir WebContent Excluded directories from sync separated by a comma By default svn directory will be ignored from sync settings is recommanded to be ignored too excluded dirs settings Excluded files from sync separated by a comma excluded files file1 jsp file2 txt file 3 2 2 3 Tester la synchronisation e Cliquez avec le bouton droit sur le projet module JCMS pour afficher un menu contextuel f Close Project gt Ley plugins 605 Close Unrelated Projects gt Ga WEB INF 604 P gt Leg gt MyProjectConfiguration 600 ht ca hu ciate gt leg gt MyProjectData 602 https Apo Validate gt leg gt MyProjectICMSRelease 603 htt LJ OrganigrammeFNCAPlugin iy PatchMaillssue2262 ones gt Servers Debug As gt leg gt SSLUrRewriterPlugin 2709 https Profile As LJ XitiFncaPlugin Record As Show in Remote Systems view Team Compare With Replace With Restore from Local History ily JCMS Tools e Cliquez sur JCMS Tools gt Sync Preview pour pr visualiser les actions que va effectuer la synchronisation e Cliquez sur JCMS Tools gt Run Sync pour lancer la synchronisation e Dans le log du console d Eclipse les traces d ex cutions sont o Plugin gt Webapp signifie qu il y a eu des copies partir du projet module JCMS vers la webapp Il s agit dans ce cas probablem
5. velopper 2 Il s agit de la maintenance d un projet existant pour lequel il n y a pas eu de gestionnaire de versions Le seul l ment disponible est la webapp JCMS de production Dans ce cas il faut d terminer e la version JCMS sur laquelle le d veloppement a t effectu Pour ce faire r cup rez la webapp la lancez et consultez la version JCMS indiqu e dans l tat du site e les modules standards JCMS a utilis es install es consulter la gestion des modules les modules sp cifiques d velopp s c est l op ration la plus d licate et co teuse Il est recommand de consulter accompagnement sur le sujet lancez la webapp et Jalios pour avoir un Dans la suite nous consid rons que le 2 me cas peut se ramener au ler cas et que vous avez tous les l ments n cessaires pour mettre sur SVN Le but est d arriver l arborescence c1 dessous 3 projetname conf branches tags trunk 3 1 4 1 Check in initial des modules e Sur SVN cr ez d abord un r pertoire plugins Cliquez droit sur le nom du projet gt New Folder e Cr ez ensuite les structures de projet Cliquez droit sur plugins gt New Project Structure New File Folder Check Out Find Check Out As Branch Eso Taq Cut p Project Structure Enter a project name and a comment The valid resource name should not contain wildcard characters or path separators like 7
6. CMS EJ Merge store T Tomcat 5 x Maen class ve fone com falos joms tools StoreMerge Jus Task Context Tst inchade system Sbraries when searching for main class inchade mperied mans when searching for main class Stop in main Ritter matched 6 of 6 tems e Allez ensuite dans l onglet Arguments o Sp cifiez le chemin du store fusionn avec le param tre output o Sp cifiez le chemin du store courant local o Sp cifiez le chemin du store r f rentiel ame Store Merge Main Arguments JRE Classpath Ee Source PS Environment Common Program arguments output C DCE o EB INF data store xml tusion C WorkspacesHelios WEB INF data store xml currrent C WorkspacesHelios WEB INF data store xml ref e Cliquez sur Run pour lancer la fusion Note Les options avanc es du Store Merge sont indiqu es l annexe S1 une fusion doit tre effectu e le Store Merge effectue les op rations suivantes 1 Une copie de sauvegarde du store local est effectu e 2 Le store de r f rence tant d j dans le SVN aucune sauvegarde n est effectu e pour ce fichier 3 Les op rations JStore des deux stores sont fusionn es dans un nouveau store via le param tre output Voici les sc narios possibles et les actions que vous pouvez devez effectuer par la suite a Les deux stores sont identiques Sortie de la console INFO current store WEB INF data store xml current INFO ref store
7. WEB INF data store xml ref INFO conflictResolution INFO ignoreConflicts false INFO strictUpdateConflicts false INFO useJStoreSyncOp false INFO useClassicIO false INFO gcs no gcs INFO ouput WEB INF data store xml fusion INFO prepareConflictResolution INFO Start merging INFO Compute store diff INFO Greatest Common Stamp tl_7046 INFO Load divergent suffixes INFO Current store suffix 0 operations on 0 data INFO Reference store suffix 0 operations on 0 data INFO Check conflicts WARN No diff Stop merge INFO The stores have not been changed status No Diff Les fichiers ne sont pas modifi s gt Vous pouvez commiter vos autres d veloppements b Le store local a t modifi le store de r f rence n a pas volu Sortie de la console INFO current store webapp WEB INF data store xml current INFO ref store webapp WEB INF data store xml ref INFO Start merging INFO Compute store diff INFO upgrade the store INFO compute the new suffix INFO Copy the newSuffix in refStore from deploy_5000 INFO Merge done INFO Override the ref store INFO Backup the current store webapp WEB INF data store xml 1234567890123 bak INFO Copy the new ref store as the current store INFO end merging Le store xml ref est remplac par le store xml local gt Si vous souhaitez envoyer vos donn es dans le SVN vous pouvez commiter
8. donn es C est le m me principe que le checkout initial des projets modules 1 Allez au repository SVN communiqu par le responsable de d veloppement Sous Eclipse ouvrez la perspective SVN Repository Exploring gt New gt Repository Location 2 Lancez le check out des projets de configurations et de donn es Renseignez aupres du responsable de d veloppement pour l endroit de ces projets 3 1 5 3 Cr ation d un projet web dynamique JCMS Objectif Configuration d un projet web dynamique permettant de lancer une webapp JCMS Contexte La plate forme WTP Web Tools Platform de Eclipse propose plusieurs supports pour le d veloppement d une webapp JEE Nous allons en profiter pour d velopper JCMS WTP est inclut dans le package Eclipse IDE for Java EE Developers qui est celui embarqu dans le DevPack fourni par Jalios Si vous n utilisez pas le DevPack il faut t l charger ce package Eclipse contenant WTP 1 Configuration de l environnement du serveur d application utiliser e Allez dans Windows gt Preferences gt Server gt Runtime Environnement Serer Runtime Environments co 7 Add remove or edit server runtime environments Server runtime environments A Apache Tomcat v3 5 Apache Tomcat v3 5 21 GlassFish 3 1 GlassFish 3 1 Edit Remove Search e Si le serveur d application cible n existe pas encore cliquez sur Add Ajoutez un serveur d application Apache Tomcat v6 0 Cl
9. le nouveau store xml ref et vos autres d veloppements c Le store de r f rence a t modifi le store local n a pas volu Sortie de la console INFO current store webapp WEB INF data store xml INFO ref store webapp WEB INF data store xml ref INFO Start merging INFO Compute store diff INFO upgrade the store INFO compute the new suffix INFO Copy the newSuffix in refStore from deploy_5000 INFO Merge done INFO Override the ref store INFO Backup the current store webapp WEB INF data store xml 1234567890123 bak INFO Copy the new ref store as the current store INFO end merging Le store xml local est remplac par le store xml ref gt D marrez votre webapp avec le nouveau store de r f rence pour valider que vos d veloppements fonctionnent avec ce nouveau store Vous pouvez commiter vos autres d veloppements d Les deux stores ont volu s et il n y aucune op ration conflictuelle Sortie de la console INFO current store webapp WEB INF data store xml INFO ref store webapp WEB INF data store xml ref INFO Start merging INFO Compute store diff INFO upgrade the store INFO compute the new suffix INFO Copy the newSuffix in refStore from deploy_5000 INFO Merge done INFO Override the ref store INFO Backup the current store webapp WEB INF data store xml 1234567890123 bak INFO Copy the new ref store as the current store INFO end merg
10. les On distingue quatre r les principaux dans le processus de d veloppement e Le mainteneur Responsable d veloppement C est l administrateur des d veloppements il est responsable de o la construction de la webapp livrer en se basant sur les d veloppements dans SVN o la mise jour de l environnement de recette partir du serveur SVN d ploiement e Les d veloppeurs Ils r cup rent leur environnement de d veloppement sur le serveur SVN checkout ou synchronisation et y committent leurs modifications e L quipe de recette Ils v rifient que l application est conforme aux attentes formul es e L quipe d exploitation Ils s occupent de la mise en pr production et production Les exploitants supervisent l tat de production d un parc d applications de mani re g n rique sans entrer dans le d tail de fonctionnement de chaque application Qui fait quoi Serveur SVN Checkin initial Checkoutinitit 2 D veloppement 3 Int gration 4 Recette 5 Mise en pr production ou production 3 Mise en place Cette section d taille le mode op ratoire pour configurer un environnement de travail d quipe pour un projet JCMS 3 1 Configuration initiale 3 1 1 Serveur de recette Objectifs Installation de la webapp JCMS en utilisant le script de d ploiement Installez sur le serveur de recette e La toute premi re version de la webapp e Le script de
11. ENA A AAEE N EIA AE 8 SL CCONH DEAUONINRAIOR o E ne death asile tin 8 3 1 1 Serveur de FORCER sis cismronteocnosntaneanenous on taeenetass sc ne net tes dem dtene esse ses osent ere d s 8 ON a de de a de ed de de 8 3 1 3 EOIS OTE 1 1s E eee eee 10 3 1 4 Checkin Mittal sareen ea E EEA NEEE Ea 11 3 1 4 1 Check in initial des MOCUIES cccceccessceccescusccesuucceecussuceeuesersacecussursuuecussersueeessersaueaes 12 3 1 4 2 Check in initial des configurations et des donn es 14 3 1 4 3 Check in initial des wars JCMS et modules associ es cceeeeeeeeeeeeeeeeeeeeeeeaeeenenevenaees 15 3 1 5 Configuration initiale de l environnement de d veloppement 16 3 Eo rel Checkout initial des projets modules sp cifiques JCMS ss 16 3 1 5 2 Checkout initial des configurations et des donn es 17 3 1 5 3 Cr ation d un projet web dynamique JCMS cccceecceceseeeeeeseceeeceeeeeeeeeeeneueeeneeeneneeenaess 17 32 DV Ope N a EE EEEE 25 3 2 1 Synchronisation entre le projet module JCMS et la webapp JCMS 29 22 SOS RU TOO ee ode secseereee te oct iat ntaeceeet aiateeas sceimcuiaccems 25 3 2 2 1 Configuration du projet module JCMS cccceecsecceeeceecceeceeecseceeecaeecaeesaeesaeeseeeseeseeeees 25 3 2 2 2 Configuration du projet webapp JCMS ins 26 3 2 2 3 Tester la SYNCNIONISAU ON wx iseviscwsstrencecccacawecstxenuetsneescabtedennedaugancekitdaanettuesauebiedae EERE RA SANAE 26 3 2 2 4 CUIO ETE EEE ETENEE EEE O E E 27
12. Mh JIALIOS JCMS D veloppement orient module avec Eclipse et SVN propos de ce document Historique 09 05 12 Xuan Tuong LE Cr ation et r daction du document 21 05 12 Olivier DEDIEU Relecture du document 08 06 12 Xuan Tuong LE Mise a jour du document 24 08 12 Olivier DEDIEU Relecture du document 19 09 12 Xuan Tuong LE Mise a jour du document 13 12 12 Xuan Tuong LE Mise a jour du document Document officiel diffusable Contacts Jalios SA 58 rue Pottier 78150 Le Chesnay Si vous avez des questions ou souhaitez des claircissements sur ce document vous pouvez nous contacter Service commercial Jean Fran ois Pellier T l 01 39 23 31 15 E mail jean francois pellier jalios com Service technique Xuan Tuong LE T l 06 14 97 44 44 E mail xuan tuong le jalios com Sommaire propos de ce document cscececscnenscnencnrcccenececucncnsersecescucusascucecececnencassrsecececneusarsesess 2 SOU ma a e nn Ge 2 CORSA N 2 Service commercial ere teen eee D D ee 2 Service COC GUS a ee a a T TANTEN 2 PONV IAN ek LE eet ese ba ee eewne Senet aeedaener eee eenieaovee 3 L ODIECUE CU COCUMIESNIL ea a ne a meneame 4 2 PACS nn ed a a 5 ZA o e AEE a PE ee aa anne aa E A ie 5 22 Mode Operate a AAEE ee ee 6 2 3 Les acteurs et leurs FOIES ccccceccecsecseceececcecceccecuecuecuecucceececeeueeuecuecuscesseeeesesseseesuesesseseaeaeeas T 2e MISEEN Da E anaE OR
13. S e Cr ez un projet SVN MyProjectConfiguration pour le projet de configuration e Faites de m me pour le projet SVN MyProjectData e Lancez le check out sur le trunk de ces projets 4 gt MyProjectConfiguration 601 gt T trunk 600 gt a branches 600 gt WF tags 600 a MyProjectData 602 trunk 607 gt x branches 602 Projet de configuration e Cr ez l arborescence de r pertoire WEB INF puis data contenant deux fichiers custom prop ref et webapp prop ref avec une extension ref r f rentiel e En dessous de WEB INF si votre projet JCMS n cessite de modifier le fichier web xml configuration NTLM etc il faut le nommer en web xml ref galement e Commitez ensuite ces fichiers a lof gt MyProjectConfiguration 600 4 le WEB INF 4 gt data E3 custom prop ref Es webapp prop ref Es web xml ref Projet de donn es Il y a trois zones de stockages les donn es dans JCMS e stockage dans le store Ce fichier se trouve dans WEB INF data sous le nom store xml Seul le store doit tre versionn dans SVN car il contient la structure des donn es e stockage dans la base de donn es JcmsDB Ce sont des donn es utilisateurs qui ne doivent pas tre reprises e stockage dans le r pertoire upload Ce sont des donn es utilisateurs qui ne doivent pas tre reprises Pour le projet de donn es a versionner dans SVN la structure est la suivante leg gt MyProjectDa
14. a permet a WIP de lire directement le r pertoire WebContent du projet Dynamic Web Project qui sera cr par la suite L avantage est d viter de tout compresser et de d ployer dans un r pertoire temporaire tr s lent Server Options Enter settings for the server Serve modules without publishing C Publish module contexts to separate XML files T Enable security Enable Tomcat debug logging not supported by this Tomcat version 4 Cr ation d un projet Dynamic Web Project e Dans la perspective Java cliquez droit gt New gt Other gt Cherchez Dynamic Web Project gt Next Select a wizard Create a Dynamic Web project Wizards type filter text gt amp Sailfin gt amp Sample Derby Database gt amp Server gt amp SQL Development gt amp SVN gt amp Tasks gt gt User Assistance a amp Web iS CSS File TS Dynamic Web Project 26 Filter amp HTML File e Donnez un nom au projet Par exemple myclientproject Cliquez sur Next pour continuer Dynamic Web Project Create a standalone Dynamic Web project or add it to a new or existing Enterprise Application Project name myclientproject Project location Use default location Location C WorkspacesHelios fnca myclientproject Browse Target runtime apache Tomes 60 Dynamic web module version Configuration Default Configuration for Apache Tomcat v6 0 z A good st
15. aitre un projet module JCMS cr ez un fichier vide jcmsPluginNature qui se situe au m me niveau que celui project standard d Eclipse Pour voir ces fichiers passez dans la vue Navigator Windows gt Show View gt Navigator e Ensuite liez le projet module JCMS a celui de la webapp JCMS en utilisant la notion de r f rence standard dans Eclipse Pour ce faire cliquez droit sur le projet module JCMS gt Properties gt Project References Cochez le projet webapp JCMS Properties for MyICMSPlugin type filter text Project References gt Resource ie Projects may refer to other projects Use this page to specify what other Project Facets Project References em references for MyJCMSPluc Refactoring History Run Debug Settings SVN Info gt Task Repository Task Tags gt Validation Wiki Text F ES myclientproject 3 2 2 2 Configuration du projet webapp JCMS e II s agit du projet dynamique web que nous avons cr la section pr c dente Dans ce projet cr ez un fichier sync conf la racine du projet 2 myclientproject G8 WebContent WEB INF classes mA JRE System Library jdk1 6 0_20 Apache Tomcat v6 0 Apache Tc gt WebContent sync conf e Remplissez ce fichier avec le contenu suivant Un exemple de ce fichier est fourni dans le DevPack Les lignes pr c d es par sont des commentaires Ici la propri t root dir indique a Jalos Plugin Tools de synchroniser a partir du r
16. ans les modules plugin prop 3 2 4 Synchronisation des donn es du store Deux options se pr sentent apr s une synchronisation avec le repository Option 1 Ecraser le store local en le rempla ant par le store de r f rence du SVN Optez pour cette option si vous ne souhaitez pas conserver les donn es contenus portlet cat gories que vous avez cr dans votre environnement de d veloppement Option 2 Fusionner le store local et le store de r f rence du SVN Optez pour cette option si vous avez cr des publications lors de vos d veloppements et que vous souhaitez conserver ces publications tout en r cup rant les ventuelles modifications disponibles dans le store de r f rence Les fusions des stores sont des options d licates Jalios fournit l outil Store Merge pour les r aliser Configuration du Store Merge e Ouvrez la perspective Java e Dans le menu Run choisissez Open Run Dialog 5 Q 1s Chi Run As b P Open Run Dialog Organize Fayorites rehy e Cr ez une nouvelle application Java e Dans l onglet Main sp cifiez o Votre projet principal e g JCMS dans le champ Project o Saisissez com jalios jcms tools StoreMerge dans le champ Main class Create manage and run configurations Run java application a Name Merge store type finer text O Man 9 Arguments mA RE Classpath amp Source B Environment java Appiet Prowect v T java Appacation
17. arting point for working with Apache Tomcat v6 0 runtime Additional farets can later he inctalled tn add new frnctinnality tn the nrniert e Dans le champ Default output folder mettez WebContent WEB INF classes e Editez le champ Source folders on build path et mettez la m me valeur Cliquez sur Next pour continuer Java Configure project for building a Java application Source folders on build path E8 WebContent WEB INF classes Edit Remove Default output folder WebContent WEB INF classes e D cochez la case Generate web xml deployment descriptor Ce fichier n est pas n cessaire car celui dans JCMS va l craser Cliquez sur Finish pour terminer Web Module Configure web module settings Context root mychentproyect Content directory WebContent e La structure d un projet web dynamique est donc celle ci a E myclientproject t gt settings 2 WebContent 4 META INF MANIFEST MF a WEB INF gt classes lib ix classpath ix project e Maintenant cliquez droit sur le r pertoire WebContent puis faites Import gt Archive File Choisissez le war de JCMS qui est stock dans le projet JaliosReleases pr c demment voqu dans la section 3 1 4 3 e La structure de la webapp JCMS en dessous du r pertoire WebContent apr s l import est la suivante lt gt WebContent b E admin b gt archives p E css b 2 cu
18. d ploiement consultez l article d di sur notre site de support http support jalios com howto deploy Pour tous les d tails d installation de JCMS consultez le manuel d installation et d exploitation de la version JCMS correspondante 3 1 2 Serveur SVN Objectif 1 Cr ation d un repository SVN vierge Cette t che est g n ralement effectu e par l exploitation g rant les serveurs Exemple sur un serveur Linux Pr requis effectuer par l administrateur de la machine e Pr sence d un compte utilisateur svn ainsi que d un groupe du m me nom Tous les utilisateurs du SVN mainteneur et d veloppeurs devront disposer de ce compte ou d un compte utilisateur appartenant au groupe svn e Cr ation d un dossier home svn repositories Ce dossier contiendra les repositories SVN e Lien symbolique de svn vers home svn repositories Ceci permettra de simplifier l acc s aux diff rents repositories avec les outils de ligne de commande mais galement depuis l environnement Eclipse Cr ation d un nouveau repository jems svn svn server svnadmin create home svn repositories jcms svn svn server svn mkdir file svn jcms trunk file svn jcms branches file svn jcms tags m creating initial repository layout Objectif 2 Cr ation d une arborescence pour g rer les composants de d veloppements L objectif est d organiser pour faciliter le travail des d veloppements et l
19. ed on 6 data Stop merge INFO The stores have not been changed status Conflicts Un ou plusieurs conflits ont t d tect s Proc dure de r solution des conflits e Lancez nouveau le Store Merge avec l option prepareConflictResolution en mentionnant le chemin du fichier de r solution g n rer Le fichier g n r aura la forme suivante Resolution options 1 currStore 2 refStore Conflict update update on data tl_6547 generated CollaborativeSpace for attribute childrenBindings tl_6547 1 Conflict update update on data j_2 member for attribute opAuthor j_2 j2 1 Par d faut c est le store courant local qui fait foi e Sic est le store de r f rentiel qui fait foi modifiez la valeur 2 e Une fois que les d cisions de r solution de conflits sont prises enlevez l option prepareConflictResolution et lancez le Store Merge avec l option conflictResolution en fournissant le fichier de r solution e D marrez la webapp avec le nouveau store e Lancez un contr le d int grit pour valider la fusion Pour les conflits de type update update v rifiez l tat des donn es concern es dans le nouveau store Vous pouvez consulter l historique pour avoir le d tail des changements Si vous souhaitez envoyer vos donn es dans le SVN vous pouvez commiter le nouveau store xml ref et vos autres d veloppements 3 3 Recette Objectif D ploiement des d velopp
20. ements sur le serveur de recette et validation Lorsqu un les d veloppements sont termin s en tant que mainteneur effectuez les op rations suivantes e Gelez les commits des d veloppeurs ventuellement via un lock sur le SVN e Synchronisez l environnement avec le SVN e Ouvrez le manuel d installation et d exploitation et suivre le chapitre 8 sur Mise jour et de d ploiement via le script de d ploiement e Demandez aux quipes de recette de valider les d veloppements e Attendez les retours de l quipe de recette et effectuez les correctifs demand s e Si la recette est valid e effectuez un tag sur SVN 3 4 Mise en production Objectif D ploiement de la webapp valid e par la recette sur le serveur de production en utilisant le script de d ploiement Consultez le chapitre 8 sur Mise a jour et de d ploiement via le script de d ploiement 3 5 Annexe 3 5 1 FAQ Pourquoi ne pas versionner toute la webapp JCMS Versionner toute la webapp JCMS est cotiteux pour un syst me de gestion de configuration Cette approche n est pas coh rente avec le m canisme de d veloppement orient module de JCMS Pourquoi ne pas versionner partiellement la webapp JCMS c est a dire versionner le delta de changement Cette approche n est pas coh rente avec le m canisme de d veloppement orient module de JCMS car elle ne permet pas de suivre l volution module par module Sur quel crit re Jalios Plug
21. ent d une mise a jour provenant de SVN par un autre d veloppeur o Webapp gt Plugin signifie le sens inverse Il s agit donc d une fin de d veloppement et que le d veloppeur d cide de committer sur SVN Problems 4b Servers 3 Call Hierarchy 4 Search El History Database Bookmarks WE x MS Preview Sync Status Plugin Dir C WorkspacesHelios fnca MyJCMSPlugin ebapp Dir C WorkspacesHelios fnca myclientproject WebContent bub Dirs C WorkspacesHelios fnca MyJCMSPlugin svn C WorkspacesHelios fnca MyJCMSPlugin pluc Plugin gt Webapp copy plugins MyJCMSPlugin css plugin less Plugin gt Webapp copy plugins MyJCMSPlugin docs changelog txt gt Webapp copy plugins MyJCMSPlugin docs images icon gif gt Webapp copy plugins MyJCMSPlugin docs images preview jpg gt Webapp copy plugins MyJCMSPlugin docs index html gt Webapp copy plugins MyJCMSPlugin docs license txt gt Webapp copy plugins MyJCMSPlugin js plugin js gt Webapp copy WEB INF classes com orgname jcmsplugin function MyJCMSDataController java gt Webapp copy WEB INF lib another lib jar gt Webapp copy WEB INF plugins MyJCMSPlugin plugin xml gt Webapp copy WEB INF plugins MyJCMSPlugin properties languages en prop gt Webapp copy WEB INF plugins MyJCMSPlugin properties languages fr prop gt Webapp copy WEB INF plugins MyJCMSPlugin properties plugin prop 3 2 2 4 Limites La synchronisation du module Eclipse Jalios P
22. epository cliquez avec le bouton droit dans la vue et choisissez New gt Repository Location Donne Sn snore amp Refresh e Saisissez l adresse du serveur SVN e g svn ssh localhost svn jcms Entrez l utilisateur et le mot de passe pour acc der au serveur SVN e g dev dev Le New Repository Location lt SVN Define the SVN repostory loc afer informaton You Can specify ad tonal settings for proxy and swnessh MAPS conmections Enter Repository Location information General Advanced SSH Settings SSL Settings Proxy URL WHS ote Browse L amet o Use the repostory URL as tive label Use Custom label Auf eric ebon User dev Password Save password Saved secret Gata amp Stored on your computer ii a Me thats difficut but mot impossible for an intruder to read Show Credentials For Validate Repostory Loc ation on finish Reset Changes Fins Cancel 3 1 4 Check in initial Objectif R cup ration des modules des donn es et de la configuration puis check in initial de tous ces l ments sur le serveur SVN Cette t che est assur e par le mainteneur responsable de d veloppement En tant que responsable de d veloppement deux cas peuvent vous se pr senter 1 Il s agit d un nouveau projet Dans ce cas 1l faut conna tre o la version JCMS sur laquelle vous allez d velopper o les modules standards JCMS utiliser installer o les modules sp cifiques a d
23. in Tools se base t il pour effectuer la synchronisation Actuellement la synchronisation se base sur la date de la derni re modification qui d termine le sens de synchronisation Projet Webapp lt gt Projet module Comment viter les doublons dans la recherche Ctrl Shift R Cette approche de synchronisation entraine des doublons dans la recherche des fichiers Pour contourner dans Eclipse on peut d finir la notion de Working Set on peut donc limiter la recherche dans l arborescence webapp JCMS Pour ce faire o Ctrl Shift R pour lancer la recherche o Rep rer la fl che Menu en haut a droite de la pop up o S lectionner Select Working Set puis suivre les indications d Eclipse par exemple un type working set Resource 3 5 2 Usage du Store Merge Usage usage StoreMerge options store xml store xml ref Options classicIO use the classic IO slower but consume less memory conflictResolution lt arg gt a file that contains a resolution for each conflicting ID gcs lt arg gt provide the Greatest Common Stamp exclusive with useJStoreSyncOp option ignoreConflicts ignore the conflicts output lt arg gt the output file If this argument missing store xml ref will be used as output prepareConflictResolution a file that will be filled with each conflicting ID lt arg gt strictUpdateConflicts warn for each update update conflict whatever the attribute values are useJStoreS y
24. ing Les deux stores sont fusionn s dans un nouveau store sp cifi via le param tre output gt D marrez votre webapp avec le nouveau store pour valider la fusion et pour valider que vos d veloppements fonctionnent avec ce nouveau store Si vous souhaitez envoyer vos donn es dans le SVN vous pouvez commiter le nouveau store xml ref et vos autres d veloppements e Les deux stores ont volu s et certaines op rations sont conflictuelles Sortie de la console INFO current store WEB INF data store xml current INFO ref store WEB INF data store xml ref INFO conflictResolution INFO ignoreConflicts false INFO strictUpdateConflicts false INFO useJStoreSyncOp false INFO useClassicIO false INFO gcs no gcs INFO ouput WEB INF data store xml fusion INFO prepareConflictResolution INFO Start merging INFO Compute store diff INFO Greatest Common Stamp sa_5835 INFO Load divergent suffixes INFO Current store suffix 460 operations on 460 data INFO Reference store suffix 495 operations on 495 data INFO Check conflicts WARN Conflict update update on data sa_5173 generated PortletQueryForeach for attribute displayTitle WARN Conflict update update on data _2 member for attribute opAuthor j_2 WARN Conflict update update on data tl_6547 generated CollaborativeSpace for attribute childrenBindings WARN 13 conflicts detect
25. int gration e Sur un projet un nouveau d veloppeur doit configurer rapidement son environnement de d veloppement a partir de SVN afin de d marrer ses d veloppements e L organisation du r f rentiel SVN doit r pondre galement aux objectifs d int grations L quipe d int gration doit tre capable de monter un processus de construction ou build de livraison partir de SVN En pratique le processus de construction est un script Ant noter qu il est peut tre int gr dans une plate forme d int gration continue tel que Jenkins Le sujet d int gration continue n est pas abord dans ce document projetname cont data plugins a E plugini 9 branches J tags J trunk 4 J plugin2 4 branches Ca tags 9 trunk E releaseJCMS Cette organisation de SVN comprend e un r pertoire plugins pour les modules JCMS Tous les d veloppements JCMS doivent tre effectu s dans les modules Pour plus de d tails consultez l article d di ce sujet e un r pertoire conf contenant toutes les configurations n cessaires destin es chaque environnement d veloppement recette preprod prod La gestion des fichiers de configuration sera abord e dans la suite Les fichiers de configuration de JCMS sont typiquement ceux ci Oo custom prop o webapp prop o web xml e un r pertoire data qui contient le fichier store xml La gestion du store sera d taill e dans la suite e un r pertoire releaseJCMS
26. iquez sur Next a Apache Apache Tomcat v3 2 E Apache Tomcat v4 0 Apache Tomcat v4 1 Apache Tomcat v3 0 Apache Tomcat v5 5 E Apache Tomcat v6 0 F Apache Tomcat w7 0 e Choisissez le r pertoire d installation de Apache Tomcat par exemple v6 0 dans cet exemple Il est recommand d utiliser la version pr conis e par Jalios qui est pr cis e dans le manuel d installation et d exploitation e Associez galement la version JDK Nous recommandons de sp cifier toujours la version exacte et d viter l option Workbench default JRE Tomcat Server Specify the installation directory Name Apache Tomcat v6 0 Tomcat installation directory apache tomeat 6 0 26 Download and Install Installed JREs 2 Cr ation d un lanceur de serveur d application e Dans la perspective Java cliquez droit gt New gt Server gt Faire Next Select a wizard Define a new server Wizards ser 4 amp GlassFish lt a RESTful Web Service from Pattern Java EE 6 4 gt Sailfin ots SIP Servlet 4 gt Server EP Server e S lectionnez le type du serveur Dans notre exemple choisissez Tomcat v6 0 Server Cliquez sur Next pour continuer Define a New Server Choose the type of server to create Download additional server adapters Select the server type type filter text H Tomcat v5 0 Server Tomcat v5 5 Server Tomcat v6 0 Server Tomcat w7 0 Server b
27. le Lors de l empaquetage d un module JCMS produire un zip contenant des jars S il s agit des jars tiers dont vous ne poss dez pas de sources il suffit de les versionner tel quel dans SVN Cependant si c tait votre jar 11 faut versionner les sources Votre jar se trouvera sous le nom MyJCMSPlugin jar Pour mettre les sources dans la structure du projet Cr ez un r pertoire WEB INF classes en dessous du projet MyJCMSPlugin Extrayez les sources java dans MyJCMSPlugin jar et les mettez en dessous de WEB INF classes Attention versionnez seulement les java Il est inutile de le faire avec les class On retrouve g n ralement l arborescence suivante leg gt MyJCMSPlugin 599 https Apollon sun fnca Trun a ew WEB INF a es classes 4 es com 4 orgname 4 lex jomsplugin 4 gt function h MyJCMSDataControllerjava 4 es lib s another lib jar o Les fichiers peuvent tre committ s sur SVN pour la lere fois Cliquez droit sur MyJCMSPlugin gt Team gt Commit puis valider l op ration Note Dans la terminologie d Eclipse il s agit d un projet de type General gt Project c est un projet standard sans aucune nature suppl mentaire Eviter de cr er des projets de type Java Project par exemple 3 1 4 2 Check in initial des configurations et des donn es Objectif Cr er un r f rentiel pour les donn es C est le m me principe de cr ation des projets pour les modules JCM
28. lugin Tools conna t les limites suivantes e suppression de fichier siun d veloppeur s aper oit qu un fichier n est plus utile il le supprime puis teste dans la webapp Lors de la synchronisation le fichier ne sera pas supprim mais recopi depuis le projet module vers le projet webapp inversement si un fichier est supprim sur le serveur SVN Lors de son update le d veloppeur va s apercevoir qu il y a eu une suppression Dans ce cas lors de la synchronisation le fichier sera copi de la webapp vers le projet module o actuellement dans tous les cas quand il s agit d une suppression il faut proc der manuellement a la suppression du fichier dans les deux projets e d tection des nouveaux fichiers o seul le r pertoire plugins MyJCMS Plugin est scann pour tester s il y a des nouveaux fichiers cr s pour tous les autres fichiers cr s en dehors de ce r pertoire une classe java un type un workflow etc il faudrait proc der une copie manuelle vers le projet module 3 2 3 Gestion du fichier custom prop Si le fichier custom prop contient des modifications reporter dans le svn pour tous les d veloppeurs fusionnez manuellement le fichier custom prop et le fichier custom prop ref S lectionnez au cas par cas les propri t s r cup rer Attention le fichier custom prop n est pas d ploy par le script de d ploiement Il est recommand de mettre les propri t s sp cifiques d
29. ncOp use the lt JSTORE S YNC gt mark to find out the store divergence exclusive with gcs option Exit code 0 Merge done or no merge to perform 1 Bad parameter 2 Error during the merge 3 Conflicts have been detected
30. qui contient les releases JCMS jcms 7 0 war jcms 7 1 1 war etc Ce sont des nouvelles versions diffus es par Jalos Dans la terminologie de JCMS ces webapps sont souvent qualifi es sous les termes webapp de base ou webapp vierge En effet elles ne contiennent aucun d veloppement sp cifique Le stockage de ces versions sous forme compress e permet d conomiser l espace et le temps de transfert de SVN vers le poste de d veloppeur par rapport un stockage d compress En int grant les modules d velopp s sp cifiquement dans ces webapps de base le processus de construction pourra tre valid en recette en pr production puis en production 3 1 3 Eclipse et SVN Jalios recommande l utilisation de Eclipse pour d velopper avec JCMS Afin de faciliter les t ches d installation d un environnement Eclipse Jalios met disposition un DevPack qui est un environnement pr t l emploi Cet environnement regroupe les plugins Eclipse qui sont utiles comme e Subversive qui ajoute le support de SVN dans Eclipse e WTP Web Tools Platform qui facilite le d veloppement des applications web et notamment l am lioration de l auto compl tion de code e Jalios Plugin Tools fourni par Jalios qui ajoute le support de d veloppement orient module L utilisation de ce module sera d taill dans la suite Ajoutez un nouveau repository SVN dans Eclipse e Ouvrez la perspective SVN Repository Exploring e Dans la vue SVN R
31. ronnement de production h bergeant la webapp JCMS Un script de d ploiement est pr sent sur le syst me d exploitation pour les op rations de d ploiement D veloppement Recette Pr prod Serveur SVN Serveur J2EE Serveur J2EE Poste mainteneur Eclipse webapp Postes d veloppeurs Eclipse webapp 2 2 Mode op ratoire Le processus de d veloppement se d compose en 5 tapes 1 Configuration initiale o Serveur de recette Installation de la webapp JCMS et script de d ploiement o serveur SVN e Cr ation d un repository vierge e Cr ation d une arborescence pour g rer les composants de d veloppements les modules les configurations etc o Checkin initial Mettre a disposition des webapps cibles JCMS a d velopper sur SVN 2 D veloppement o Synchronisation avec le SVN puis commit des d veloppements 3 Int gration o Construction de la livraison pour l environnement cible recette pr production production suivant les pr conisations de Jalios d ploiement par war 4 Recette o D ploiement de la nouvelle webapp sur le serveur de recette et validation 5 Mise en production o D ploiement de la m me webapp valid e par la recette sur le serveur de production ES Exploitation juawalojdaq C Int gration Correction bug O D veloppement Recette Pr prod s O Mise en production Exploitation Configuration initiale 2 3 Les acteurs et leurs r
32. stom p G docs b feed t flash gt front gt images p E jcore gt js t E META INF b meteo gt amp plugins gt be types gt une t f upload gt foe WEB INF gt E work ix config xml display jsp edit jsp El index jsp 5 Lancement d un projet Dynamic Web Project Il existe plusieurs mani res pour lancer le projet myclientproject Une des fa ons est la suivante e Ouvrez la vue Servers et rep rez la configuration du lanceur Problems Gi Eda 20 Call Hierarchy 4 Search E His gt 22 Internal GlassFish 3 1 Stopped b a Tomcat v5 5 Server at localhost Stopped Le Tomcat v6 0 Server at localhost Stopped Republish agram e Cliquez droit sur Tomcat v6 0 gt Add and Remove e Choisir le projet myclientproject e Cliquer droit sur Tomcat v6 0 gt Start ou Debug Astuce Pour pouvor d velopper a chaud i e sans relancer le serveur chaque fois vous pouvez diter la configuration du lanceur Dans l onglet Modules gt Edit gt D cocher la case Auto reloading enabled Ne pas oublier d enregistrer votre manipulation fe Web Modules Web Modules Configure the Web Modules on this server Document Base Add Web Module Add External Web Mo Edit Remove Overview Modules Document base myclientproject Path myclientproject E Auto reloading enabled R sum Dans cette section nous a
33. ta 602 htt E gt WEB INF gt data store xmlref 3 1 4 3 Check in initial des wars JCMS et modules associ es Il s agit du r pertoire de stockage des releases Jalios permettant de g rer les constructions ou les builds de livraison La structure comporte un r pertoire par version Ce r pertoire contient le war de JCMS et les modules JCMS associ es a cette version gt JaliosReleases 4203 svn ssh svn 4 E gt joms 6 1 Es jems 6 1 1 war virtualdesktopplugin_1 1 1 z1p 4 ee joms 0 5 Es joms 7 0 3 war virtualdesktopplugin_1 2 zip 4 ex joms 12 Es joms 7 1 2 war virtualdesktopplugin_2 0 1 zip bS Cette structure permet un nouveau d veloppeur de retrouver facilement les l ments n cessaires pour configurer son environnement 3 1 5 Configuration initiale de l environnement de d veloppement Objectif Configuration l environnement de d veloppement JCMS sous Eclipse et r cup ration des composants n cessaires depuis le SVN Cette t che est r alis e par le d veloppeur Contexte G n ralement le mainteneur ou le responsable de d veloppement va mettre disposition une proc dure permettant un nouveau d veloppeur de configurer son environnement lors de son arriv e sur le projet Cette section va aborder cette proc dure qui comporte trois tapes 1 Checkout initial des projets de modules sp cifiques JCMS 2 Checkout initial des configurations et des donn es 3 Cr a
34. tion d un projet web dynamique JCMS 3 1 5 1 Checkout initial des projets modules sp cifiques JCMS e Allez au repository SVN du projet communiqu par le responsable de d veloppement Sous Eclipse ouvrez la perspective SVN Repository Exploring gt New gt Repository Location e Choisissez le projet SVN du module d velopper par exemple MyFooBarPlugin dans notre cas Cherchez ce projet sur SVN puis son trunk e Lancez le check out sur le projet La structure qui est un layout standard d un module JCMS ressemblera donc celle ci apr s le check out 4 es MyFooBarPlugin 4 lt 3 plugins 4 es MyFooBarPlugin gt lex CSS gt fee docs gt fee Img gt E gt Iphone gt Lee JSP a types gt E gt AbstractPortletskinable gt gt PortletQueryForeach gt E gt PortletQueryForeachDetail gt E gt PortletRSS gt E gt PortletWidget gt Ge types a E gt WEB INF 4 3 classes 4 E gt com 4 name 4 gt jomsplugin 4 ee util h MyUtil java gt E gt data gt Ee lib 4 lt gt plugins 4 E gt MyFooBarPlugin 4 lt 3 properties gt lee languages E plugin prop da plugin xml Note la configuration du projet est automatiquement r cup r e lors du checkout En effet le fichier project d Eclipse a t inclus volontairement dans le SVN lors de l import initial par le mainteneur Ainsi Eclipse ne propose pas de choisir le type de projet 3 1 5 2 Checkout initial des configurations et des
35. vons pu voir comment cr er un projet web dynamique support par WTP afin de lancer une webapp JCMS de base Pour les autres modules standards de JCMS proc dez l installation standard en utilisant l interface web de JCMS Ensuite rafra chissez le projet web dynamique puis red marrez 3 2 D veloppement 3 2 1 Synchronisation entre le projet module JCMS et la webapp JCMS Contexte A la fin de l tape de check out initial nous avons e unensemble des projets modules JCMS Ces projets modules repr sentent un module d velopp sp cifiquement e un ensemble des configurations et des donn es e une webapp JCMS configur e sous la forme d un projet Dynamic Web Objectif Versionner le d veloppement module par module et d velopper de mani re flexible Pour ce faire le principe sera de synchroniser le projet module JCMS et le projet webapp JCMS d o le besoin d avoir un outil Cette section d crit cet outil propos par Jalios 4 ExampleJCMSPlugin plugins n gt WEB INF _ Tie JemsPluginNature IX project JaliosTools a Le ea ap NP que P roj et M od ul e J C M 5 cii dai x rojet webapp JCMS 3 2 2 Jalios Plugin Tools Jalios Plugin Tools est un module Eclipse Il permet de synchroniser un projet module JCMS et un projet webapp JCMS Il est propos par d faut dans les DevPack JEE JCMS 3 2 2 1 Configuration du projet module JCMS e Pour que Jalios Plugin Tools puisse reconn
Download Pdf Manuals
Related Search