Dans cette leçon, vous packagez votre personnalisation pour la préparer au déploiement. Vous pouvez packagez et déployer vos fichiers de personnalisation liés à la marge bénéficiaire dans votre environnement de production avec l'outil Génération et déploiement HCL Commerce.
Pourquoi et quand exécuter cette tâche
L'outil de génération et de déploiement HCL Commerce est conçu pour faciliter le déploiement de ressources personnalisés de nature à être une source d'erreur et de longue durée. L'outil fournit un point de départ pour automatiser vos processus de génération et de déploiement de manière standardisée et contrôlée. Pour plus d'informations, voir Code personnalisé de combinaison pour le déploiement.
Important : Le processus de packaging et de déploiement remplace les fichiers du serveur cible de déploiement. Vérifiez qu'aucune personnalisation antérieure ne sera supprimée ou remplacée par les modifications de personnalisation que vous avez apportées dans ce tutoriel.
Procédure
Préparez le package source pour la personnalisation de l'EAR HCL Commerce et la personnalisation de l'EAR HCL Commerce Search.
-
HCL Commerce Package EAR :
-
Créez le référentiel de code source pour inclure les fichiers de l'utilitaire Chargement des données et les packages de code pour votre code de personnalisation de widget de recommandation de produits mis à jour.
- Copiez le dossier WCDE_installdir\wcbd dans un emplacement temporaire, comme sous C:\.
- Renommez le répertoire en wcbd-deploy-server-local-profit_margin_wc.
Dans cette tâche, ce répertoire est appelé le répertoire wcbd_wc.
- Créez la structure de répertoires suivante : wcbd_wc/source/workspace.
-
Ajoutez les fichiers de l'utilitaire Chargement des données, qui chargent des données personnalisées côté serveur, dans votre référentiel de code source pour l'outil Génération et déploiement HCL Commerce.
- Créez la structure de fichiers wcbd_wc/source/workspace/dataload/dataload/common pour vos fichiers de l'utilitaire Chargement des données.
- Ajoutez les fichiers de l'utilitaire Chargement des données pour votre widget personnalisé dans votre référentiel de code source pour l'outil Génération et déploiement. Le nouveau répertoire ressemble à la structure suivante dans le répertoire wcbd_wc/source/workspace/dataload/dataload/common :
- dataload_cost_price directory
- dataload_price_list directory
- wc-dataload-env.xml file
dataload_cost_price et dataload_price_list doivent inclure la liste de prix et les données des prix de revient que vous avez précédemment chargées. Pour plus d'informations sur la création des fichiers wc-dataload-env.xml, voir Configuration des paramètres d'environnement de chargement de données. Les paramètres d'environnement de ce fichier doivent correspondre aux paramètres d'environnement de votre environnement cible où vous déployez votre personnalisation.
-
Copiez tous les dossiers et fichiers de personnalisation dans le répertoire wcbd_wc/source/workspace.
- Créez l'arborescence de répertoires : wcbd_wc/source/workspace/Stores
- Copiez les fichiers suivants qui se trouvent dans le répertoire workspace_dir/Stores, dans le répertoire wcbd_wc/source/workspace/Stores :
- WebContent/widgetdir/com.ibm.commerce.store.widgets.CatalogEntryRecommendation/CatalogEntryRecommendation_Data.jspf
- WebContent/widgetdir/Common/PriceDisplay/PriceDisplay_Data.jspf
- WebContent/widgetdir/Common/PriceDisplay/PriceDisplay_UI.jspf
Le nouveau répertoire ressemble à la structure suivante dans le répertoire
wcbd_wc/source/workspace :
- dataload directory
- Stores directory
Le contenu de vos actifs
wcbd_wc packagés peut ressembler au contenu de l'exemple de fichier suivant.
-
Reportez-vous aux propriétés de l'extrait d'exemple suivantes et à la génération de propriétés dans l'exemple de fichier compressé du package :
- build-local-search.properties
- extract-local-search.properties
-
Copiez tous les projets de recherche personnalisés vers wcbd_wc\search\workspace
Remarque : Vous devez copier tous les fichiers sous search-config-ext et search-logic-ext dans ce dossier. Tous les fichiers sous ces deux projets sont inclus.
-
Copiez votre projet HCL Commerce personnalisé dans wcbd_wc\ts\workspace.
Copiez vos configurations prétraitées personnalisées sous WC\xml\search\dataImport\v3\db2. Dans l'exemple 1, copiez wc-dataimport-preprocess-custom.xml et wc-dataimport-preprocess-x-finalbuild.xml dans W:\Build_Local_Repository\ts\workspace\ WC\xml\search\dataImport\v3\db2. Copiez tous les fichiers sous le projet WebSphereCommerceServerExtensionsLogic pour inclure toutes vos personnalisations.
-
Compressez votre code de personnalisation de recherche :
run wcbd_wc\wcbd>wcbd-ant.bat -buildfile wcbd-build.xml -Dbuild.label=test -Dbuild.type=local -Dapp.type=search
-
Compressez votre code de personnalisation du serveur de transactions :
run wcbd_wc\wcbd>wcbd-ant.bat -buildfile wcbd-build.xml -Dbuild.label=test -Dbuild.type=local -Dapp.type=ts
Résultats
Les packages sont créés sous le répertoire
wcbd_wc\wcbd\dist comme suit :
- wcbd-deploy-server-local-search-search.zip
- wcbd-deploy-server-local-ts.zip
Le code de personnalisation de la recherche dans les exemples est intégré dans le package search-logic-ext.jar search-config-ext.jar
Le code de personnalisation du serveur de transactions dans les exemples est construit comme suit :
- xml
- ejb
- WebSphereCommerceServerExtensionsLogic.jar
Que faire ensuite
Utilisation de votre propre pipeline CI/CD pour générer votre package de personnalisation dans une image Docker et déployer dans votre environnement d'exécution.
Vérifiez votre code de personnalisation dans votre environnement Docker.
- Saisissez le conteneur de recherche :
- Exécutez docker ps pour vérifier que vos conteneurs sont en cours d'exécution.
- Localisez le nom de votre conteneur de recherche dans la colonne NAMES.
- Démarrez l'interpréteur de commandes bash en exécutant la commande
docker exec -it search_container_name bash.
Votre personnalisation apparaît dans le répertoire /opt/WebSphere/Liberty/usr/servers/default/apps/search-ear.ear.
- Saisissez le conteneur TS (transaction). Votre personnalisation apparaît dans le répertoire /opt/WebSphere/AppServer/profiles/default/installedApps/localhost/ts.ear.