Structure de référentiel pour la création de packages de magasins distants (crs)

Pour configurer les propriétés de génération d'un package de serveur Magasin, 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.

Dossiers et contenu de package d'un package de serveur de 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:/
  • Point d'extension par défaut du magasin distant basé sur l'image Docker du magasin par défaut.
  • Fichiers de contenu Web du module Web de la boutique distante.
crs-extensions-logic Code/crs-app/lib/crs-extensions-logic.jar
  • Point d'extension par défaut du magasin distant basé sur l'image Docker du magasin par défaut.
  • 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.
  • Ce projet peut contenir des ressources personnalisées de manière similaire au serveur de transactions et au serveur de recherche.
crs-alias-proxy-web.war Code/crs-app/crs-alias-proxy-web.war
  • (Facultatif) Pas de modification nécessaire par défaut. Stockez le servlet de fichiers proxy d'alias et la configuration qui sert aux fichiers statiques tels que les images et les fichiers css, etc.
crs-preview-web.war Code/crs-app/crs-preview-web.war
  • (Facultatif) Ce dossier inclut le servlet d'aperçu du magasin et les fichiers de configuration qui servent à l'aperçu du magasin à partir de Management Center. Par défaut, vous n'avez pas besoin de modifier ces fichiers.
Jar files Code/crs-app/lib/*.jar
  • (Facultatif) Ce dossier inclut tous les fichiers JAR dépendants. Par défaut, vous n'avez pas besoin de modifier ces fichiers.
META-INF Code/crs-app/META-INF
  • Facultatif Application.xml. Ce dossier contient tous les modules Web et la racine de contexte.
  • Problèmes connus : Le fichier n'est pas combiné par l'outil HCL Commerce Build. Vous devez placer manuellement des fichiers dans ce dossier si vous devez modifier des fichiers dans le dossier.
properties Code/crs-app/properties
  • (Facultatif) Les messages d'erreur d'application et les messages d'erreur du serveur de magasin sont stockés dans ces fichiers.
xml Code/crs-app/xml
  • (Facultatif) Les fichiers de configuration de stratégie de masquage de configuration de magasin à distance et d'attribut sont stockés ici.
crs-web/src/ Code/crs-app/crs-web.war:/WEB-INF/classes/
  • Classes Java personnalisées du 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.
Certs/crs-app
  • Ce dossier n'existe pas dans le package de magasin HCL Commerce Build par défaut. Le processus de génération et de déploiement est conçu pour prendre en charge l'utilisation du dossier comme interface pour vos extensions.
  • Si vous souhaitez importer vos propres certificats, vous devez implémenter la logique HCL Commerce Build pour créer ce dossier et inclure votre fichier JSON de certificat dans ce dossier dans un package de magasin WebSphere Commerce Build. Pour plus d'informations, voir Gestion manuelle des certificats.
DeployScripts/crs-app
  • Semblable au dossier Certs, le dossier DeployScripts n'existe pas dans le package de magasin HCL Commerce Build par défaut. Le processus de génération et de déploiement est conçu pour prendre en charge l'utilisation du dossier comme point d'extension potentiel pour personnaliser le processus de déploiement.
  • Si vous souhaitez étendre le processus de déploiement par défaut avec votre propre logique de code personnalisée, vous devez implémenter la logique HCL Commerce Build pour créer le dossier et placer vos scripts shell personnalisés dans le dossier. Vos scripts shell personnalisés dans le dossier doivent être nommés applyDeployScripts.sh
  • La logique par défaut pour appliquer les modifications détecte s'il y a des scripts applyDeployScripts.sh dans le dossier. S'ils sont trouvés, les scripts sont exécutés pour traiter l'une de vos logiques de déploiement personnalisées. La logique par défaut pour appliquer les modifications est définie dans le fichier /SETUP/bin/applyCustomization.sh pour référence.

Structure du package de déploiement du serveur de magasin

La structure de fichier suivante affiche la structure de package générée pour un package de magasin distant (crs) après que l'outil HCL Commerce Build a terminé la génération du package.

¦
+---Code
¦   +---crs-app The default deployment process handles the following three types of WAR files within the crs-app folder.)
¦       ¦   crs-alias-proxy-web.war
¦       ¦   crs-preview-web.war
¦       ¦   crs-web.war  
¦       ¦
¦       +---lib (The default deployment process copies all files under the lib folder to the crs.ear/lib directory.) 
¦       ¦   ¦   aopalliance-1.0.jar
¦       ¦   ¦   cf-wcf.jar
¦       ¦   ¦   commons-codec-1.6.jar
¦       ¦   ¦   commons-configuration-1.8.jar
¦       ¦   ¦   commons-io-2.1.jar
¦       ¦   ¦   commons-lang-2.6.jar
¦       ¦   ¦   commons-lang3-3.3.2.jar
¦       ¦   ¦   commons-logging-1.2.jar
¦       ¦   ¦   crs-extensions-logic.jar
¦       ¦   ¦   crs-store-publish-jianing.jar
¦       ¦   ¦   crs-store-publish.jar
¦       ¦   ¦   crs-web-taglibs.jar
¦       ¦   ¦   .....
¦       ¦   ¦   zookeeper-3.4.12.jar
¦       ¦
¦       +---META-INF (The default deployment process copies all files under the META-INF folder to the crs.ear/META-INF directory.)  
¦       ¦       MANIFEST.MF
¦       ¦       application.xml
¦       ¦
¦       +---properties (The default deployment process copies all files under the properties folder to the crs.ear/properties directory.) 
¦       ¦   ¦   GenericApplicationError.properties
¦       ¦   ¦   GenericApplicationError_ar_EG.properties
¦       ¦   ¦   GenericApplicationError_de_DE.properties
¦       ¦   ¦   ......properties
¦       ¦   ¦   GenericApplicationError_ru_RU.properties
¦       ¦   ¦   GenericApplicationError_tr_TR.properties
¦       ¦   ¦   GenericApplicationError_zh_CN.properties
¦       ¦   ¦   GenericApplicationError_zh_TW.properties
¦       ¦   ¦   GenericSystemError.properties
¦       ¦   ¦   GenericSystemError_ar_EG.properties
¦       ¦   ¦   ......properties
¦       ¦   ¦   GenericSystemError_zh_CN.properties
¦       ¦   ¦   GenericSystemError_zh_TW.properties
¦       ¦   ¦   log4j.properties
¦       ¦   ¦
¦       ¦   +---com
¦       ¦       +---ibm
¦       ¦           +---commerce
¦       ¦               +---ras
¦       ¦                   +---properties
¦       ¦                           ecServerMessages.properties
¦       ¦                           ecServerMessages_ar_EG.properties
¦       ¦                           ......properties
¦       ¦                           ecServerMessages_zh_TW.properties
¦       ¦
¦       +---xml (The default deployment process copies all files under the xml folder to the crs.ear/xml directory.)
¦           +---config
¦           ¦   ¦   denyList.xml
¦           ¦   ¦   wc-attribute-masking.xml
¦           ¦   ¦   wc-store.xml
¦           ¦   ¦
¦           ¦   +---com.ibm.commerce.store
¦           ¦   ¦       store-rest-group.xml
¦           ¦   ¦
¦           ¦   +---xsd
¦           ¦           wc-alias-config.xsd
¦           ¦           wc-seo-url-pattern.xsd
¦           ¦
¦           +---mapper
¦                   SEOUrlMapper.xml
¦
+---Certs (You can add this folder on demand.)
¦   +---crs-app

+---DeployScripts (You can add this folder on demand.)
    +---crs-app
            applyDeployScripts.sh

HCL Commerce prend désormais en charge le traitement des fichiers personnalisés dans tous les dossiers par défaut d'un package de magasin distant (crs), comme indiqué dans la structure de référentiel précédente. Cette prise en charge vous offre plus de capacité pour appliquer une logique personnalisée à votre serveur de magasin.

Pour vos dossiers Certs et DeployScripts , les deux dossiers sont réservés dans le code par défaut à l'application d'une logique de personnalisation que vous pouvez utiliser pour les extensions. Le code par défaut pour l'application de la logique est inclus dans le fichier /SETUP/bin/applyCustomization.sh. Les scripts d'outil HCL Commerce ne génèrent pas ces dossiers par défaut. Vous devez personnaliser les scripts pour configurer l'outil afin de générer et de combiner ces deux dossiers.

Si vos environnements ne sont pas mis à jour au niveau du package de mise à jour 9.0.1.3 ou 9.0.0.12, la logique fournie par défaut gère un point d'extension, l'archive crs-web.war. Si vous devez appliquer des fichiers de personnalisation, vous devez personnaliser le dossier DeployScripts pour ajouter votre logique personnalisée pour l'application de vos fichiers.