Créez un package de déploiement contenant votre magasin local à l'aide de l'outil WCB

Dans cette leçon, vous créerez le package de déploiement contenant votre magasin local à l'aide de l'outil WCB. Ce package peut ensuite être utilisé pour créer des images Docker personnalisées à utiliser dans un environnement opérationnel de production. Pour plus d'informations sur le packaging du code personnalisé pour le déploiement, voir Code personnalisé de combinaison pour le déploiement.

Avant de commencer

Créez une sauvegarde du répertoire WC_installdir/WCBD/ dans votre HCL Commerce development environment.
Assurez-vous que vous utilisez la barre oblique vers l'avant (/) comme séparateur de fichiers.
Si vos personnalisations dépendent de bibliothèques tierces, assurez-vous qu'elles sont incluses dans le répertoire WAS_HOME/lib/.

Remarque : Cette tâche utilise les conventions suivantes :

Les scripts ou fichiers de propriétés spécifiques à l'application se distinguent par le type d'application. Dans les étapes suivantes, apptype renvoie au type d'application en cours de création. Les valeurs admises peuvent être ts, crs, search, xc, ou data. Etant donné que nous créons le package du magasin local dans le Transaction server, le apptype pour cette tâche de tutoriel est ts.
Dans les étapes suivantes, scm renvoie à la méthode utilisée pour extraire le code source. Le scm peut être local, ou n'importe quel type de gestion de code source pris en charge. Les valeurs admises peuvent être cvs, svn, ou git. Pour les besoins de cette tâche de tutoriel, nous supposons que tout votre code source est disponible sur le système de fichiers local, à savoir que scm est local.

Procédure

Configurez votre environnement de création.
1. Créez un répertoire sur votre système de fichiers local qui sera utilisé comme répertoire de code source pour le processus de création WCB.
  Par exemple, créez C:\source\.
2. Créez un sous-répertoire contenant les projets HCL Commerce que vous souhaitez générer.
  Par exemple, créez C:\source\workspace\.
3. Copiez votre projet de magasin dans le sous-répertoire des projets.
  Par exemple, copiez le répertoire WCDE_installdir/workspace/Stores/ dans C:\source\workspace\.
4. Facultatif : Si vous disposez d'autres personnalisations que vous avez effectuées sur le Transaction server, vous devez également les copier dans le sous-répertoire des projets à créer avec le package de déploiement ts.
  Par exemple, cela peut inclure des personnalisations dans les projets WebSphereCommerceServerExtensionsData ou WebSphereCommerceServerExtensionsLogic.
Configurez l'outil WCB pour extraire votre magasin local de Transaction server et d'autres fichiers source de personnalisation.
1. Copiez l'exemple de fichier de configuration WCB wcbd-sample-extract-local.properties dans votre répertoire WCB.
  Par exemple, copiez WCB_installdir/extract/wcbd-sample-extract-local.properties dans WCB_installdir/extract-local-ts.properties.
  Remarque : La convention de dénomination de ce fichier de configuration est importante : local est le mot clé permettant d'indiquer que le code source se trouve sur le système de fichiers local, et ts est le mot clé permettant d'indiquer que le type d'application extrait est le Transaction server.
2. Modifiez le fichier de configuration d'extraction WCB pour qu'il pointe vers le répertoire que vous avez créé à l'étape n°1.
  1. Ouvrez le fichier de configuration WCB WCB_installdir/extract-local-ts.properties en vue de son édition.
  2. Définissez local.extract.dir pour qu'il soit votre répertoire de code source local. Par exemple, à l'aide du répertoire que nous avons utilisé à l'étape n°1.a :
```
local.extract.dir=C:/source
```
  3. Enregistrez et fermez le fichier.
3. Copiez l'exemple de fichier de configuration WCB wcbd-sample-extract-local.xml dans votre répertoire WCB.
  Par exemple, copiez WCB_installdir/extract/wcbd-sample-extract-local.xml dans WCB_installdir/extract-local.properties.
4. Modifiez le fichier de configuration d'extraction WCB extract-local.properties.
  1. Ouvrez le fichier de configuration d'extraction WCB extract-local.properties pour le modifier.
  2. Remplacez le nom du projet wcbd-sample-extract-local par extract-local.
```
<project name="extract-local" default="all">
```
  3. Enregistrez et fermez le fichier.
Configurez l'outil WCB pour créer et packager votre magasin local et vos personnalisations du Transaction server.
1. Copiez l'exemple de fichier de configuration WCB wcbd-build.properties.template dans votre répertoire WCB.
  Par exemple, copiez WCB_installdir/wcbd-build.properties.template dans WCB_installdir/wcbd-build-local-ts.properties.
  Remarque : La convention de dénomination de ce fichier de configuration est importante : local est le mot clé permettant d'indiquer que le code source se trouve sur le système de fichiers local, et ts est le mot clé permettant d'indiquer que le type d'application créé est le Transaction server.
2. Modifiez le fichier de configuration de création WCB wcbd-build-local-ts.properties.
  1. Assurez-vous que les propriétés de configuration suivantes sont mises à jour pour refléter votre environnement de création spécifique ainsi que les exigences de création de package de déploiement.
```
wc.home=<commerce developer install directory, e.g c:/WCDE_V9>
was.home=<WebSphere Application Server home, e.g c:/IBM/WebSphere/AppServer>
extract.ant.file=${basedir}/extract-local.xml
run.package.server=true
run.package.toolkit=false
web.module.list=Stores #add more web modules into this list if required, separated by commas
```
  2. Facultatif : Modifiez toutes les autres propriétés en fonction du code de personnalisation que vous avez inclus, de votre environnement de création et de votre base de données. Par exemple, si vous avez un code EJB dans WebSphereCommerceServerExtensionsData, vous devez définir la propriété suivante.
```
ejb.module.list=WebSphereCommerceServerExtensionsData
```
  3. Enregistrez et fermez le fichier.
3. Activez votre outil WCB pour gérer les données sensibles.
  
  Créez une copie de l'exemple de fichier de propriétés de données sensibles WCB wcbd-build.private.properties.template dans votre répertoire WCB. Par exemple, effectuez une copie du fichier WCB_installdir/wcbd-build.private.properties.template et renommez-le build-local-ts.private.properties.
  
  Remarque : La convention de dénomination de ce fichier de configuration est importante : local est le mot clé permettant d'indiquer que le code source se trouve sur le système de fichiers local, et ts est le mot clé permettant d'indiquer que le type d'application créé est le Transaction server.
  
  Aucune modification ne doit être apportée à ce fichier. L'outil WCB utilisera ce fichier pour stocker les données sensibles dans un format chiffré.
4. Configurez vos variables d'environnement de création d'outil WCB.
  1. Créez une copie de l'exemple de script d'utilitaire de configuration d'environnement wcbd-setenv.bat.template dans votre répertoire WCB. Par exemple, effectuez une copie du script d'utilitaire de configuration d'environnement WCB_installdir/wcbd-setenv.bat.template et renommez-le setenv.bat.
  2. Ouvrez le script de l'utilitaire de configuration d'environnement setenv.bat pour le modifier.
  3. Définissez les variables d'environnement suivantes pour votre environnement.
```
ANT_HOME=<Directory contains ant binary, e.g C:/WCDE_V9/wcbd/apache-ant-1.10.1>
WAS_HOME=<WebSphere Application Server home, e.g C:/IBM/WebSphere/AppServer>
WC_HOME=<Commerce Developer installation directory, e.g C:/WCDE_V9>
```
  4. Enregistrez et fermez le fichier.
Exécutez l'outil WCB pour créer votre package de déploiement contenant votre magasin local.
1. Dans une invite de commande, accédez à WCB_installdir directory.
2. Exécutez la commande suivante pour créer le package Transaction server.
```
wcbd-ant.bat -Dapp.type=ts -Dbuild.type=local -buildfile wcbd-build.xml -Dbuild.label=V9
```
  Le type d'application et le type de création correspondent au type de package que nous créons et à la source du code source que nous avons configurée pour cet environnement. Le libellé de création, V9, est utilisée pour identifier la création spécifique et peut être personnalisé à chaque fois que l'utilitaire est exécuté.

Résultats

Votre magasin local est intégré dans un package de déploiement HCL Commerce version 9.1 Transaction server. Le package, s'il est créé avec le libellé de création V9, peut se trouver dans WCB_installdir/dist/server/wcbd-deploy-server-local-ts-V9.zip.

Que faire ensuite

Ce package de déploiement Transaction server peut désormais être utilisé pour créer des images Docker de Transaction server et de serveur Web qui peuvent ensuite être déployées dans un environnement de production.

Pour poursuivre le tutoriel, passez à Créer des images Docker ts-app et ts-web personnalisées.