Propriétés de configuration de packaging
Ces propriétés fournissent des paramètres généraux relatifs au processus de packaging.
Résumé des propriétés
Le fichier de modèle d'origine de ces propriétés est WCB_installdir/wcbd-build.properties.template.
| Propriété | Récapitulatif |
|---|---|
| Répertoire dans lequel les bibliothèques de test unitaire (telles que JUnit) dont le processus de génération a besoin pour compiler le code de test unitaire sont conservées. | |
| source.dir | Répertoire dans lequel le code source est extrait. |
| module.dir | Répertoire de ${source.dir} dans lequel se trouvent les modules. |
| dist.dir | Répertoire de distribution dans lequel les packages de déploiement sont créés. |
| dist.server.dir | Répertoire de distribution dans lequel les packages de déploiement de serveur sont créés. |
| dist.toolkit.dir | Répertoire de distribution dans lequel les packages de déploiement de boîtes à outils sont créés. |
| log.dir | Répertoire de journaux de génération. |
| log.file | Fichier journal de génération. |
| log.zip.file | Fichier compressé qui contient des journaux de génération associés pour générer des notifications d'échec. |
| working.dir | Répertoire de travail utilisé pour stocker les fichiers temporaires générés par le processus de génération. |
| working.compile.dir | Répertoire de travail pour la compilation. |
| working.archive.dir | Répertoire de travail pour l'archivage des fichiers binaires du module. |
| working.package.server.dir | Répertoire de travail pour la création de packages de déploiement de serveur. |
| working.package.toolkit.dir | Répertoire de travail pour la création de packages de déploiement de boîtes à outils. |
| imported.classes.dir | Répertoire qui contient des fichiers de classe combinés dans les modules. |
| connector.module.list | Liste des modules de connecteur à créer séparés par une virgule. |
| connector.src.dir | Répertoire source Java des modules de connecteur. |
| connector.bin.dir | Répertoire binaire Java des modules de connecteur. |
| ejb.module.list | Liste des modules EJB à créer séparés par une virgule. |
| ejb.src.dir | Répertoire source Java des modules EJB. |
| ejb.bin.dir | Répertoire binaire Java des modules EJB. |
| java.module.list | Liste des modules d'utilitaire Java à créer séparés par une virgule. |
| java.src.dir | Répertoire source Java des modules d'utilitaire Java. |
| java.bin.dir | Répertoire binaire Java des modules d'utilitaire Java. |
| web.module.list | Liste de modules Web à créer séparés par une virgule. |
| web.src.dir | Répertoire source Java des modules Web. |
| web.resource.dir | Répertoire de ressources Java des modules Web. |
| web.bin.dir | Répertoire binaire Java des modules Web. |
| web.content.dir | Répertoire de contenu web des modules Web. |
| data.module.name | Nom du module qui contient des ressources de données. |
| static.web.module.name | Nom du module qui contient des ressources de serveur Web statiques. |
| ext.compile.class.path | Chemin d'accès de classe qui contient plus de fichiers requis pour la compilation. Les dossiers peuvent contenir des classes Java libres (fichiers .class). Les archives Java (fichiers .JAR) doivent être répertoriées individuellement. Les fichiers et les dossiers doivent être délimités par un tiret. |
| wc.home | Répertoire HCL Commerce d'installation de HCL Commerce Developer. |
| was.home | Répertoire d'installation de WebSphere Application Server. |
| db.type | Nom du fournisseur de base de données utilisé par les processus de génération pour configurer les chemins de compilation et de classe ejbdeploy. |
| ejbdeploy.dbvendor | Nom du fournisseur de base de données utilisé par l'utilitaire ejbdeploy pour déterminer les types de colonnes de base de données, les informations de mappage, le DDL et d'autres informations. |
| ejbdeploy.codegen | Si les fichiers Java générés par l'utilitaire ejbdeploy sont conservés. |
| ejbdeploy.keep.generated | Si le répertoire de travail est conservé une fois l'utilitaire ejbdeploy terminé. |
| ejbdeploy.quiet | Si tous les messages d'erreur à l'exception des messages signalés par l'utilitaire ejbdeploy sont supprimés. |
| ejbdeploy.no.validate | Si les messages de validation signalés par l'utilitaire ejbdeploy sont supprimés. |
| ejbdeploy.trace | Si le traçage interne pour l'utilitaire ejbdeploy est activé. |
| ejbdeploy.jvm.max.memory | Taille de mémoire maximale à utiliser par l'utilitaire ejbdeploy. |
| run.extract | Si l'extraction du code source est effectuée. |
| extract.ant.file | Fichier de génération Ant utilisé pour extraire le code source. |
| extract.update.mode | SI l'extraction de code source est effectuée en tant que mise à jour du code source précédemment extrait ou en tant qu'extraction complète après la suppression du code source précédemment extrait. |
| ear.dir.includes | Liste des fichiers séparés par une virgule dans ${module.dir}/WC à inclure dans les packages de déploiement. |
| ear.dir.excludes | Liste des fichiers séparés par une virgule dans ${module.dir}/WC à exclure des packages de déploiement. |
| deploy.server.dir | Répertoire qui contient des scripts de déploiement à inclure dans le package de déploiement du serveur. |
| deploy.toolkit.dir | Répertoire qui contient des scripts de déploiement à inclure dans le package de déploiement de la boîte à outils. |
| run.package.server | Si un package de déploiement de serveur est créé. |
| run.package.toolkit | Si un package de déploiement de boîte à outils est créé. |
| run.dos2unix | S'il faut convertir les caractères de nouvelle ligne contenus dans les fichiers du package de déploiement du serveur du format DOS (CRLF) au format UNIX (CR). |
| dos2unix.includes | Liste des fichiers séparés par une virgule dans ${working.package.dir}/server à inclure pour la conversion dos2unix. |
| dos2unix.excludes | Liste des fichiers séparés par une virgule ${working.package.dir}/server à exclure de la conversion dos2unix. |
| run.deploy.server | Si le déploiement centralisé du serveur s'exécute. |
| deploy.server.workspace.dir | Répertoire dans lequel les packages de déploiement de serveur sont installés pour le déploiement centralisé du serveur. |
| deploy.server.target.env.list | Liste d'identificateurs séparés par une virgule pour les environnements cibles par rapport auxquels le déploiement centralisé du serveur est exécuté. |
| deploy.server.command | Commande qui appelle le processus de déploiement du serveur. |
| deploy.server.command.args | Les arguments de ligne de commande à passer dans ${deploy.server.command}. |
| run.clean.working.dir | Si le répertoire de travail est nettoyé à la fin du processus de génération. |
| run.mail.success | Si les notifications d'aboutissement de génération sont envoyées. |
| run.mail.failure | Si les notifications d'échec de génération sont envoyées. |
| mail.from | Adresse e-mail de l'expéditeur des notifications de statut de génération. |
| mail.success.tolist | Liste des adresses e-mail qui reçoivent des notifications d'aboutissement de génération séparées par une virgule. |
| mail.failure.tolist | Liste d'adresses e-mail qui reçoivent des notifications d'échec de génération séparées par une virgule. |
| mail.mailhost | Nom d'hôte du serveur SMTP. |
| mail.mailport | Port TCP du serveur SMTP. |
| mail.ssl | Si le serveur SMTP utilise TLS/SSL pour le chiffrement. |
| mail.success.subject | Objet des notifications d'aboutissement de génération. |
| mail.failure.subject | Objet des notifications d'échec de génération. |
| mail.success.message | Corps de message des notifications d'aboutissement de génération. |
| mail.failure.message | Corps de message des notifications d'échec de génération. |
Détails de la propriété
- app.type
- L'application dans laquelle le processus de génération WCBD doit déployer des ressources. L'application de recherche HCL Commerce (Solr) est séparée dans une application différente de celle de l'EAR de HCL Commerce. Les utilisateurs doivent spécifier le type d'application avant que le processus de génération WCBD ne s'exécute. Chaque type d'application fournit un ensemble différent de classes lorsque les utilisateurs exécutent le processus de génération WCBD. Lorsque le processus de génération s'exécute, un nouveau fichier wcbd-build-classpath-application_type.xml est créé. Le type d'application sélectionné détermine les chemins de classe utilisés par le processus de génération pour compiler et combiner les ressources en vue du déploiement. Vous pouvez spécifier les types d'application suivants comme valeurs valides pour cette propriété :
- wc
- Application HCL Commerce WC.ear. WC est la valeur par défaut.
- recherche
- Application de HCL CommercerechercheSearch.ear.
- xc
- Créer des packages pour le serveur de personnalisation HCL Commerce.
- crs
- Créer des packages pour le serveur de magasin de HCL Commerce.
- source.dir
- Répertoire dans lequel le code source est extrait. Par défaut, le chemin d'accès du répertoire source est associé à une génération particulière spécifiée par ${build.label}. Si vous avez l'intention d'utiliser la fonctionnalité de mise à jour du référentiel que certains SCM tels que CVS et Subversion fournissent, vous devez définir cette propriété sur une valeur statique sans référence à ${build.label}.
- Par défaut
- ${basedir}/source/${build.label}
- module.dir
- Répertoire de ${source.dir} dans lequel se trouvent les modules. La structure de ce répertoire correspond à l'espace de travail HCL Commerce Developer, comme expliqué dans la rubrique "structure de référentiel Outil HCL Commerce Build" du Centre d'information HCL Commerce.
- Par défaut
- ${source.dir}/workspace
- dist.dir
- Répertoire de distribution dans lequel les packages de déploiement sont créés.
- Par défaut
- ${basedir}/dist
- dist.server.dir
- Répertoire de distribution dans lequel les packages de déploiement de serveur sont créés.
- Par défaut
- ${dist.dir}/server
- dist.toolkit.dir
- Répertoire de distribution dans lequel les packages de déploiement de boîtes à outils sont créés.
- Par défaut
- ${dist.dir}/toolkit
- log.dir
- Répertoire de journaux de génération.
- Par défaut
- ${basedir}/logs/${build.type.prefix}${build.label}-${tstamp}
- log.file
- Fichier journal de génération.
- Par défaut
- ${log.dir}/wcbd-build.log
- log.zip.file
- Fichier compressé qui contient des journaux de génération associés pour générer des notifications d'échec.
- Par défaut
- ${log.dir}/wcbd-build-log-${build.label}.zip
- working.dir
- Répertoire de travail utilisé pour stocker les fichiers temporaires générés par le processus de génération.
- Par défaut
- ${basedir}/working
- working.compile.dir
- Répertoire de travail pour la compilation.
- Par défaut
- ${working.dir}/compile
- working.archive.dir
- Répertoire de travail pour l'archivage des fichiers binaires du module.
- Par défaut
- ${working.dir}/archive
- working.package.server.dir
- Répertoire de travail pour la création de packages de déploiement de serveur.
- Par défaut
- ${working.dir}/package/server
- working.package.toolkit.dir
- Répertoire de travail pour la création de packages de déploiement de boîtes à outils.
- Par défaut
- ${working.dir}/package/toolkit
- imported.classes.dir
- Répertoire qui contient des fichiers de classe combinés dans les modules. Cette propriété est utilisée pour les modules Java EE importés d'archives binaires.
- Par défaut
- ImportedClasses
- connector.module.list
- Liste des modules de connecteur à créer séparés par une virgule. Laissez la valeur de cette propriété vide si aucun de ces modules n'a besoin de génération.
- Exemple
- TestConnector1,TestConnector2
- connector.src.dir
- Répertoire source Java des modules de connecteur.
- Par défaut
-
connectorModule
- connector.bin.dir
- Répertoire binaire Java des modules de connecteur.
- Par défaut
- connectorModule
- ejb.module.list
- Liste des modules EJB à créer séparés par une virgule. Laissez la valeur de cette propriété vide si aucun de ces modules n'a besoin de génération.
- Exemple
- WebSphereCommerceServerExtensionsData,TestEJB1
- ejb.src.dir
- Répertoire source Java des modules EJB.
- Par défaut
- ejbModule
- ejb.bin.dir
- Répertoire binaire Java des modules EJB.
- Par défaut
- ejbModule
- java.module.list
- Liste des modules utilitaires Java à créer séparés par une virgule. Laissez la valeur de cette propriété vide si aucun de ces modules n'a besoin d'être généré.
- Exemple
- WebSphereCommerceServerExtensionsLogic,TestJava1
- java.src.dir
- Répertoire source Java des modules d'utilitaire Java.
- Par défaut
- src
- java.bin.dir
- Répertoire binaire Java des modules d'utilitaire Java.
- Par défaut
- bin
- web.module.list
- Liste de modules Web à créer séparés par une virgule. Laissez la valeur de cette propriété vide si aucun de ces modules n'a besoin de génération.
- Exemple
- SiteAdministration,Stores,TestWeb1
- web.src.dir
- Répertoire source Java des modules Web.
- Par défaut
- src
- web.resource.dir
-
Répertoire de ressources Java des modules Web.
- web.bin.dir
- Répertoire binaire Java des modules Web.
- Par défaut
- ${web.content.dir}/WEB-INF/classes
- web.content.dir
- Répertoire de contenu web des modules Web.
- Par défaut
- WebContent
- data.module.name
- Nom du module qui contient des ressources de données.
- Par défaut
- DataLoad
- static.web.module.name
- Nom du module qui contient des ressources de serveur Web statiques.
- Par défaut
- StaticWeb
- ext.compile.class.path
- Chemin d'accès de classe qui contient plus de fichiers requis pour la compilation. Les dossiers peuvent contenir des classes Java libres (fichiers .class). Les archives Java (fichiers .JAR) doivent être répertoriées individuellement. Les fichiers et les dossiers doivent être délimités par un tiret. Les utilisateurs doivent s'assurer que toutes les entrées de chemin d'accès de classe qui sont également requises dans l'exécution sont disponibles pour l'application d'entreprise HCL Commerce. En général, rendez ces ressources disponibles dans le cadre de l'application HCL Commerce, et incluses uniquement comme entrées de chemin d'accès de classe externe.
- wc.home
- Répertoire HCL Commerce d'installation de HCL Commerce Developer.
- was.home
- Répertoire d'installation de WebSphere Application Server.
- db.type
- Nom du fournisseur de base de données utilisé par les processus de génération pour configurer les chemins de compilation et de classe ejbdeploy. Définissez la valeur comme valeur correspondante pour le type de fournisseur de base de données.
- Par défaut
- db2
- Valeurs valides
-
- db2
oracle
os400
- ejbdeploy.dbvendor
- Facultatif : Nom du fournisseur de base de données utilisé par l'utilitaire ejbdeploy pour déterminer les types de colonnes de base de données, les informations de mappage, le DDL et d'autres informations. Assurez-vous que la valeur correspond à l'ID d'arrière-plan de la base de données que les projets EJB utilisent dans votre personnalisation. Dans le cas contraire, l'utilitaire ejbdeploy génère un mappage descendant basé sur les métadonnées EJB, qui peuvent ne pas correspondre au schéma de base de données réel. Dans la mesure du possible, utilisez l'une des valeurs suivantes prises en charge par défaut. Si vous devez utiliser une valeur qui n'est pas fournie par défaut, assurez-vous qu'elle est valide conformément à l'utilisation de l'utilitaire ejbdeploy dans la documentation WebSphere Application Server ou l'interface de ligne de commande.
- Par défaut
- DB2UDB_V95
- ejbdeploy.codegen
- Si les fichiers Java générés par l'utilitaire ejbdeploy sont conservés.
- Par défaut
- false
- Valeurs valides
- true
- false
- ejbdeploy.keep.generated
- Si le répertoire de travail est conservé une fois l'utilitaire ejbdeploy terminé.
- Par défaut
- false
- Valeurs valides
- true
- false
- ejbdeploy.quiet
- Si tous les messages d'erreur à l'exception des messages signalés par l'utilitaire ejbdeploy sont supprimés. Cette propriété ne supprime pas les messages de validation, qui sont contrôlés par ${ejbdeploy.no.validate}.
- Par défaut
- true
- Valeurs valides
- true
- false
- ejbdeploy.no.validate
- Si les messages de validation signalés par l'utilitaire ejbdeploy sont supprimés.
- Par défaut
- true
- Valeurs valides
-
- true
- false
- ejbdeploy.trace
- Si le traçage interne pour l'utilitaire ejbdeploy est activé.
- Par défaut
- false
- Valeurs valides
- true
- false
- ejbdeploy.jvm.max.memory
- Taille de mémoire maximale à utiliser par l'utilitaire ejbdeploy.
- Par défaut
- 256M
- run.extract
- Si l'extraction du code source est effectuée.
- Par défaut
-
true
- Valeurs valides
- true
- false
- extract.ant.file
- Fichier de génération Ant utilisé pour extraire le code source. Reportez-vous à la documentation pour plus de détails sur la création d'un extrait de fichier Ant personnalisé avec le modèle fourni.
- extract.update.mode
- SI l'extraction de code source est effectuée en tant que mise à jour du code source précédemment extrait ou en tant qu'extraction complète après la suppression du code source précédemment extrait. En plus de définir la valeur de cette propriété, les conditions suivantes doivent également être remplies pour utiliser ce mode de mise à jour du code source :
- ${source.dir} doit être défini sur un chemin statique, par exemple, ${basedir}/source.
- Par défaut
- false
- Valeurs valides
-
- true
- false
- ear.dir.includes
- Liste des fichiers séparés par virgule dans ${module.dir}/WC à inclure dans les packages de déploiement. Laissez la valeur de cette propriété vide pour inclure tous les fichiers.
- ear.dir.excludes
- Liste de fichiers séparés par une virgule dans ${module.dir}/WC à exclure des packages de déploiement. Laissez la valeur de cette propriété vide pour n'exclure aucun fichier.
- deploy.server.dir
- Répertoire qui contient des scripts de déploiement à inclure dans le package de déploiement du serveur.
- Par défaut
- ${basedir}/deploy/server
- deploy.toolkit.dir
- Répertoire qui contient des scripts de déploiement à inclure dans le package de déploiement de la boîte à outils.
- Par défaut
- ${basedir}/deploy/toolkit
- run.package.server
- Si un package de déploiement de serveur est créé.
- Par défaut
- true
- Valeurs valides
- true
- false
- run.package.toolkit
- Si un package de déploiement de boîte à outils est créé.
- Par défaut
- true
- Valeurs valides
- true
- false
- run.dos2unix
- S'il faut convertir les caractères newline contenus dans les fichiers du package de déploiement du serveur du format DOS (CRLF) au format UNIX (CR). Définissez cette propriété sur true lorsque le déploiement du serveur est exécuté sur un système UNIX. Certains shells UNIX ne peuvent pas traiter le caractère LF étranger qui fait partie du caractère de nouvelle ligne du format DOS, ce qui entraîne des erreurs de syntaxe.
- Par défaut
- false
- Valeurs valides
- true
- false
- dos2unix.includes
- Liste des fichiers séparés par une virgule dans ${working.package.dir}/server à inclure pour la conversion dos2unix. Incluez tous les scripts shell. N'incluez pas les fichiers binaires qui peuvent être endommagés lorsqu'ils sont inclus.
- Par défaut
- setenv,wcbd-ant,wcbd-encode-properties,wcbd-setenv.template
- dos2unix.excludes
- Liste des fichiers séparés par une virgule dans ${working.package.dir}/server à exclure de la conversion dos2unix. Laissez la valeur de cette propriété vide pour n'exclure aucun fichier.
- run.deploy.server
- Si le déploiement centralisé du serveur s'exécute.
- Par défaut
- false
- Valeurs valides
-
- true
- false
- deploy.server.workspace.dir
- Répertoire dans lequel les packages de déploiement de serveur sont installés pour le déploiement centralisé du serveur.
- Par défaut
- ${basedir}/deploy-server-workspace
- deploy.server.target.env.list
- Liste d'identificateurs séparés par une virgule pour les environnements cibles par rapport auxquels le déploiement centralisé du serveur est exécuté.
- deploy.server.command
- Commande qui appelle le processus de déploiement du serveur. A moins qu'elle ne soit personnalisée, la commande est généralement wcbd-ant.bat pour Windows, ou wcbd-ant pour toutes les autres plateformes.
- Par défaut
- wcbd-ant
- deploy.server.command.args
- Arguments de ligne de commande à passer dans ${deploy.server.command}. Par défaut, l'argument
-Dtarget.env=target-env est automatiquement transmis en fonction des valeurs dans ${deploy.server.target.env.list}, de sorte qu'il n'est pas inclus dans cette propriété.- Par défaut
- -buildfile wcbd-deploy.xml
- run.clean.working.dir
- Si le répertoire de travail est nettoyé à la fin du processus de génération.
- Par défaut
- false
- Valeurs valides
-
- true
- false
- run.mail.success
- Si les notifications de génération réussie sont envoyées.
- Par défaut
- false
- Valeurs valides
-
- true
- false
- run.mail.failure
- Si les notifications d'échec de génération sont envoyées.
- Par défaut
- false
- Valeurs valides
-
- true
- false
- mail.from
- Adresse e-mail de l'expéditeur des notifications de statut de génération.
- mail.success.tolist
- Liste des adresses e-mail qui reçoivent des notifications d'aboutissement de génération séparées par une virgule.
- mail.failure.tolist
- Liste d'adresses e-mail qui reçoivent des notifications d'échec de génération séparées par une virgule.
- mail.mailhost
- Nom d'hôte du serveur SMTP.
- mail.mailport
- Port TCP du serveur SMTP.
- Par défaut
- 25
- mail.ssl
- Si le serveur SMTP utilise TLS/SSL pour le chiffrement.
- Par défaut
- false
- Valeurs valides
- true
- false
- mail.success.subject
- Objet des notifications d'aboutissement de génération.
- Par défaut
- La génération WCBD a abouti : ${build.label}
- mail.failure.subject
- Objet des notifications d'échec de génération.
- Par défaut
- La génération WCBD a ECHOUE : ${build.label}
- mail.success.message
-
Corps de message des notifications d'aboutissement de génération.
- mail.failure.message
- Corps de message des notifications d'échec de génération.
- Par défaut
- Voir les journaux associés pour plus de détails.