Exemple de configuration

L'outil peut créer des applications pour les quatre types de serveur : serveur de transactions, serveur de magasin, serveur de recherche et serveur de personnalisation. Un exemple montre comment vous pouvez créer vos propres extensions à l'aide de .

Ces exemples sont fournis à des fins de référence uniquement, et pour servir de point de départ afin de vous aider à configurer votre propre environnement de génération.

Le fichier WCB_sample.zip fournit des exemples de fichiers de propriétés que vous pouvez utiliser comme référence pour mieux comprendre ce que vous devez configurer. L'emballage WCB_sample.zip contient également l'échantillon xC.

Génération pour le serveur de transactions (ts)

Pour configurer les propriétés de génération d'un package de serveur de transactions, build-buildtype-ts.properties, tenez compte des configurations pertinentes suivantes que vous devez remplir. Les valeurs des paires nom-valeur suivantes sont les dossiers de votre espace de travail. Ces propriétés déterminent les ressources à combiner.

  • ejb.module.list=WebSphereCommerceServerExtensionsData
  • java.module.list=WebSphereCommerceServerExtensionsLogic
  • web.module.list=CommerceAccelerator
  • ear.dir.includes=lib/**,properties/**,xml/**
En fonction de ces propriétés, la table suivante illustre ce qui est combiné dans le fichier ZIP de sortie lors de la génération pour le serveur de transactions.
Le processus de génération prend ces dossiers dans l'espace de travail Packages vers ces dossiers dans le fichier ZIP de sortie Description
WC Code/ts-app/ Projet EAR
WC/lib Code/ts-app/lib/
  • Bibliothèques tierces Java
  • Tous les fichiers JAR sous ce chemin d'accès seront copiés vers ts.ear/lib dans l'image Docker du serveur de transactions.
WC/propriétés Code/ts-app/properties/
  • Tous les fichiers de propriétés sous ce chemin d'accès seront copiés vers ts.ear/properties dans l'image Docker du serveur de transactions.
WC/xml Code/ts-app/xml/
  • Tous les fichiers de configuration sous ce chemin d'accès seront copiés vers ts.ear/xml dans l'image Docker du serveur de transactions.
WebSphereCommerceServerExtensionsData Code/ts-app/ejb/WebSphereCommerceServerExtensionsData.jar
  • Projet d'extensions EJB
  • Invoquera des scripts wsadmin pour mettre à jour le modèle EJB de WebSphereCommerceExtensionData.jar
WebSphereCommerceServerExtensionsLogic Code/ts-app/WebSphereCommerceServerExtensionsLogic.jar
  • Fichiers de projet d'extensions Java, src et config.
  • Seront copiés vers le chemin relatif sous ts.ear dans l'image Docker du serveur de transactions.
CommerceAccelerator Code/ts-app/CommerceAccelerator.war
  • Ressources personnalisées pour  : seuls les fichiers modifiés doivent être présents.
  • Copiez et remplacez tous les fichiers existants sous le dossier WAR dans l'image Docker du serveur de transactions.
Vous devez définir la logique pour déterminer où retirer les certificats. Certs/ts-app
  • Ce dossier n'est pas combiné par défaut. Si vous souhaitez importer vos propres certificats, vous devez définir les certificats dans un fichier JSON et implémenter une logique WCB personnalisée pour combiner les fichiers JSON dans ce dossier. Pour plus d'informations sur l'implémentation de la logique WCB personnalisée, voir Personnalisation du processus de package. Si ce dossier Certs existe dans le package de génération, les fichiers JSON sont copiés dans le répertoire /SETUP/certs/custom de l'image Docker cible.
  • Pour plus d'informations sur la façon de stocker des certificats dans un fichier JSON, voir Importation de certificats à partir d'un fichier JSON local.
Vous devez définir la logique permettant de déterminer où se trouve ce dossier dans votre espace de travail. DeployScripts/ts-app
  • Ce dossier n'est pas combiné par défaut. Si vous souhaitez combiner des scripts de démarrage personnalisés, vous devez implémenter une logique WCB personnalisée pour combiner vos ressources dans ce dossier DeployScripts. Pour plus d'informations sur l'implémentation de la logique WCB personnalisée, voir Personnalisation du processus de package
DeployScripts/ts-app/custConfiguration.sh
  • Par défaut, ce fichier n'existe pas. Si vous souhaitez créer votre propre logique de démarrage de conteneur Docker personnalisée, vous devez utiliser ce nom de fichier. La logique IBM recherche ce script pour appeler votre logique de démarrage personnalisée. Pour plus d'informations, voir Logique de démarrage du conteneur Docker pour HCL Commerce Version 9.1.
  • Vous devez créer une logique dans le applyDeployScripts.sh pour copier custConfiguration.sh dans le répertoire /SETUP/bin de l'image Docker du serveur de transactions.
DeployScripts/ts-app/applyDeployScripts.sh
  • Par défaut, ce script n'existe pas. Créez ce script applyDeployScripts.sh et définissez la logique pour copier vos ressources personnalisées à partir du dossier DeployScripts aux emplacements souhaités dans l'image Docker cible.
DeployScripts/ts-app/***
  • Cela représente vos propres dossiers ou fichiers nécessaires à vos personnalisations uniques. Vous pouvez inclure toutes les ressources dont vous pourriez avoir besoin pour répondre à vos besoins spéciaux. Par exemple, pour déployer une logique de commande Run Engine personnalisée, vous pouvez placer vos scripts, classes ou fichiers JAR personnalisés ici, puis définir la logique dans le fichier applyDeployScripts.sh pour déterminer ce qu'il faut faire avec ces ressources personnalisées.

Génération pour le serveur de recherche (search)

Pour configurer les propriétés de génération d'un package de serveur de recherche, build-buildtype-search.properties, tenez compte des configurations pertinentes suivantes que vous devez remplir. Les valeurs des paires nom-valeur suivantes sont les dossiers de votre espace de travail.

  • java.module.list=search-config-ext, search-logic-ext
En fonction de ces propriétés, la table suivante illustre ce qui est combiné dans le fichier ZIP de sortie lors de la génération pour le serveur de recherche.
Le processus de génération prend ces dossiers dans l'espace de travail Packages vers ces dossiers dans le fichier ZIP de sortie Description
search-config-ext/ Code/search-app/search-config-ext.jar
  • Module Java contenant des fichiers de configuration personnalisés.
  • Tous les fichiers JAR sous le répertoire de l'application de recherche seront copiés dans le dossier search-ear.ear/libde l'image Docker du serveur de recherche.
search-logic-ext/ Code/search-app/search-logic-ext.jar
  • Module Java contenant des fichiers de configuration personnalisés.
  • Tous les fichiers JAR sous le répertoire de l'application de recherche seront copiés dans le dossier search-ear.ear/libde l'image Docker du serveur de recherche.
Vous devez définir la logique pour déterminer où retirer les certificats. Certs/search-app
  • Ce dossier n'est pas combiné par défaut. Si vous souhaitez importer vos propres certificats, vous devez définir les certificats dans un fichier JSON et implémenter une logique WCB personnalisée pour combiner les fichiers JSON dans ce dossier. Pour plus d'informations sur l'implémentation de la logique WCB personnalisée, voir Personnalisation du processus de package. Si ce dossier Certs existe dans le package de génération, les fichiers JSON sont copiés dans le répertoire /SETUP/certs/custom de l'image Docker cible.
  • Pour plus d'informations sur la façon de stocker des certificats dans un fichier JSON, voir Importation de certificats à partir d'un fichier JSON local.
Vous devez définir la logique permettant de déterminer où se trouve ce dossier dans votre espace de travail. DeployScripts/search-app
  • Ce dossier n'est pas combiné par défaut. Si vous souhaitez combiner des scripts de démarrage personnalisés, vous devez implémenter une logique WCB personnalisée pour combiner vos ressources dans ce dossier DeployScripts. Pour plus d'informations sur l'implémentation de la logique WCB personnalisée, voir Personnalisation du processus de package
DeployScripts/search-app/custConfiguration.sh
  • Par défaut, ce fichier n'existe pas. Si vous souhaitez créer votre propre logique de démarrage de conteneur Docker personnalisée, vous devez utiliser ce nom de fichier. La logique IBM recherche ce script pour appeler votre logique de démarrage personnalisée. Pour plus d'informations, voir Logique de démarrage du conteneur Docker pour HCL Commerce Version 9.1.
  • Vous devez créer une logique dans le applyDeployScripts.sh pour copier custConfiguration.sh dans le répertoire /SETUP/bin de l'image Docker du serveur de transactions.
DeployScripts/search-app/applyDeployScripts.sh
  • Par défaut, ce script n'existe pas. Créez ce script applyDeployScripts.sh et définissez la logique pour copier vos ressources personnalisées à partir du dossier DeployScripts aux emplacements souhaités dans l'image Docker cible.
DeployScripts/search-app/***
  • Cela représente vos propres dossiers ou fichiers nécessaires à vos personnalisations uniques. Vous pouvez inclure toutes les ressources dont vous pourriez avoir besoin pour répondre à vos besoins spéciaux. Par exemple, pour déployer une logique de commande Run Engine personnalisée, vous pouvez placer vos scripts, classes ou fichiers JAR personnalisés ici, puis définir la logique dans le fichier applyDeployScripts.sh pour déterminer ce qu'il faut faire avec ces ressources personnalisées.

Magasins à distance (crs)

Pour configurer les propriétés de génération d'un package de serveur Store, build-buildtype-crs.properties , tenez compte des configurations pertinentes suivantes que vous devez remplir. Les valeurs des paires nom-valeur suivantes sont les dossiers de votre espace de travail.

  • web.module.list=crs-web
  • java.module.list=crs-extensions-logic Ce projet est utilisé pour personnaliser le code java du magasin crs-web.
En fonction de ces propriétés, la table suivante illustre ce qui est combiné dans le fichier ZIP de sortie lors de la génération pour le serveur Magasin.
Le processus de génération prend ces dossiers dans l'espace de travail Packages vers ces dossiers dans le fichier ZIP de sortie Description
crs-web/ Code/crs-app/crs-web.war:/
  • Module Web pour les magasins à distance, seuls les fichiers personnalisés doivent être présents.
  • Dézippera crs.ear dans l'image Docker du serveur de magasin, remplacera le wc-web.war existant , puis recombinera crs.ear
crs-web/src/ Code/crs-app/crs-web.war:/WEB-INF/classes/
  • Classes Java personnalisées du module Web.
crs-web/WebContent/ Code/crs-app/crs-web.war:/ Fichiers de contenu Web pour le module Web.
crs-web/WebContent/META-INF/ Code/crs-app/crs-web.war:/META-INF/ Fichiers d'infos méta.
crs-web/WebContent/WEB-INF/ Code/crs-app/crs-web.war:/WEB-INF/ Fichiers d'infos Web.
crs-extensions-logic Code/crs-app/lib/crs-extensions-logic.jar Créez un projet d'utilitaire Java dans le serveur Magasin pour contenir le code de personnalisation Java (tel qu'une bibliothèque de balises JSTL, ServletFilter, Listener ou Spring MVC). Le projet peut également contenir des ressources personnalisées d'une manière similaire au serveur de transactions et au serveur de recherche.
Vous devez définir la logique pour déterminer où retirer les certificats. Certs/crs-app
  • Ce dossier n'est pas combiné par défaut. Si vous souhaitez importer vos propres certificats, vous devez définir les certificats dans un fichier JSON et implémenter une logique WCB personnalisée pour combiner les fichiers JSON dans ce dossier. Pour plus d'informations sur l'implémentation de la logique WCB personnalisée, voir Personnalisation du processus de package. Si ce dossier Certs existe dans le package de génération, les fichiers JSON sont copiés dans le répertoire /SETUP/certs/custom de l'image Docker cible.
  • Pour plus d'informations sur la façon de stocker des certificats dans un fichier JSON, voir Importation de certificats à partir d'un fichier JSON local.
Vous devez définir la logique permettant de déterminer où se trouve ce dossier dans votre espace de travail. DeployScripts/crs-app
  • Ce dossier n'est pas combiné par défaut. Si vous souhaitez combiner des scripts de démarrage personnalisés, vous devez implémenter une logique WCB personnalisée pour combiner vos ressources dans ce dossier DeployScripts. Pour plus d'informations sur l'implémentation de la logique WCB personnalisée, voir Personnalisation du processus de package
DeployScripts/crs-app/custConfiguration.sh
  • Par défaut, ce fichier n'existe pas. Si vous souhaitez créer votre propre logique de démarrage de conteneur Docker personnalisée, vous devez utiliser ce nom de fichier. La logique IBM recherche ce script pour appeler votre logique de démarrage personnalisée. Pour plus d'informations, voir Logique de démarrage du conteneur Docker pour HCL Commerce Version 9.1.
  • Vous devez créer une logique dans le applyDeployScripts.sh pour copier custConfiguration.sh dans le répertoire /SETUP/bin de l'image Docker du serveur de transactions.
DeployScripts/crs-app/applyDeployScripts.sh
  • Par défaut, ce script n'existe pas. Créez ce script applyDeployScripts.sh et définissez la logique pour copier vos ressources personnalisées à partir du dossier DeployScripts aux emplacements souhaités dans l'image Docker cible.
DeployScripts/crs-app/***
  • Cela représente vos propres dossiers ou fichiers nécessaires à vos personnalisations uniques. Vous pouvez inclure toutes les ressources dont vous pourriez avoir besoin pour répondre à vos besoins spéciaux. Par exemple, pour déployer une logique de commande Run Engine personnalisée, vous pouvez placer vos scripts, classes ou fichiers JAR personnalisés ici, puis définir la logique dans le fichier applyDeployScripts.sh pour déterminer ce qu'il faut faire avec ces ressources personnalisées.

Serveur Commerce UE (xc) (xc)

Pour configurer les propriétés de génération d'un package de serveur de personnalisation, build-buildtype-xc.properties , tenez compte des configurations pertinentes suivantes que vous devez remplir. Les valeurs des paires nom-valeur suivantes sont les dossiers de votre espace de travail.

  • web.module.list=commerceue-app
  • web.src.dir=src/main/java
  • web.resource.dir=src/main/resources
En fonction de ces propriétés, la table suivante illustre ce qui est combiné dans le fichier ZIP de sortie lors de la génération pour le serveur de personnalisation.
Le processus de génération prend ces dossiers dans l'espace de travail Packages vers ces dossiers dans le fichier ZIP de sortie Description
commerceue-ear/src/main/application/ Code/xc-app/
  • Fichiers de niveau EAR.
  • Tous les fichiers sous commerceue-ear seront copiés dans le répertoire relatif de l'image Docker du serveur de personnalisation commerceue-ear.ear.
commerceue-ear/src/main/application/lib Code/xc-app/lib Bibliothèques Java pour EAR
commerceue-ear/src/main/application/META-INF/ Code/xc-app/META-INF/ Infos méta pour EAR
commerceue-app/src/main/java/ Code/xc-app/commerceue-app.war:/WEB-INF/classes
  • Répertoire de fichiers source Java
  • Tous les fichiers sous commerceue-app seront copiés dans le répertoire relatif de l'image Docker du serveur de personnalisation commerceue-ear.ear/commerceue-ear.ear/commerceue-app.war.
commerceue-app/src/main/resources/ Code/xc-app/commerceue-app.war:/WEB-INF/classes Répertoire de fichiers de ressources Java, en particulier les fichiers de propriétés
commerceue-app/WebContent/ Code/xc-app/commerceue-app.war:/ Contenu Web
commerceue-app/WebContent/WEB-INF/ Code/xc-app/commerceue-app.war:/WEB-INF/ répertoire WEB-INF
commerceue-app/WebContent/swagger/ Code/xc-app/commerceue-app.war:/swagger/ Fichiers d'application Web Swagger
commerceue-app/WebContent/META-INF Code/xc-app/commerceue-app.war:/META-INF/ Répertoire d'informations Web méta
Vous devez définir la logique pour déterminer où retirer les certificats. Certs/xc-app
  • Ce dossier n'est pas combiné par défaut. Si vous souhaitez importer vos propres certificats, vous devez définir les certificats dans un fichier JSON et implémenter une logique WCB personnalisée pour combiner les fichiers JSON dans ce dossier. Pour plus d'informations sur l'implémentation de la logique WCB personnalisée, voir Personnalisation du processus de package. Si ce dossier Certs existe dans le package de génération, les fichiers JSON sont copiés dans le répertoire /SETUP/certs/custom de l'image Docker cible.
  • Pour plus d'informations sur la façon de stocker des certificats dans un fichier JSON, voir Importation de certificats à partir d'un fichier JSON local.
Vous devez définir la logique permettant de déterminer où se trouve ce dossier dans votre espace de travail. DeployScripts/xc-app
  • Ce dossier n'est pas combiné par défaut. Si vous souhaitez combiner des scripts de démarrage personnalisés, vous devez implémenter une logique WCB personnalisée pour combiner vos ressources dans ce dossier DeployScripts. Pour plus d'informations sur l'implémentation de la logique WCB personnalisée, voir Personnalisation du processus de package
DeployScripts/xc-app/custConfiguration.sh
  • Par défaut, ce fichier n'existe pas. Si vous souhaitez créer votre propre logique de démarrage de conteneur Docker personnalisée, vous devez utiliser ce nom de fichier. La logique IBM recherche ce script pour appeler votre logique de démarrage personnalisée. Pour plus d'informations, voir Logique de démarrage du conteneur Docker pour HCL Commerce Version 9.1.
  • Vous devez créer une logique dans le applyDeployScripts.sh pour copier custConfiguration.sh dans le répertoire /SETUP/bin de l'image Docker du serveur de transactions.
DeployScripts/xc-app/applyDeployScripts.sh
  • Par défaut, ce script n'existe pas. Créez ce script applyDeployScripts.sh et définissez la logique pour copier vos ressources personnalisées à partir du dossier DeployScripts aux emplacements souhaités dans l'image Docker cible.
DeployScripts/xc-app/***
  • Cela représente vos propres dossiers ou fichiers nécessaires à vos personnalisations uniques. Vous pouvez inclure toutes les ressources dont vous pourriez avoir besoin pour répondre à vos besoins spéciaux. Par exemple, pour déployer une logique de commande Run Engine personnalisée, vous pouvez placer vos scripts, classes ou fichiers JAR personnalisés ici, puis définir la logique dans le fichier applyDeployScripts.sh pour déterminer ce qu'il faut faire avec ces ressources personnalisées.

Données de génération

Pour les données, vous n'avez pas besoin de spécifier les ressources à créer. Vous n'avez qu'à placer vos fichiers de données dans des répertoires connexes (sql, xml, dataload, acug, acp, acpnls). Pour plus d'informations sur les structures de fichiers, voir Outil HCL Commerce Build structure de référentiel.