Emplacement et structure de fichiers du Outil HCL Commerce Build
Dans l'environnement de développement HCL Commerce, l'Outil HCL Commerce Build (outil WCB) se trouve dans le répertoire WCDE_installdir/wcbd/. Dans l'environnement d'exécution de HCL Commerce, le Outil HCL Commerce Build se trouve dans le Utility server Docker container au niveau de /opt/WebSphere/CommerceServer90/wcbd.
Important:
A partir de HCL Commerce 9.1.14.0, les images de conteneurs d'applications sont conçues pour être exécutées par défaut en tant qu'utilisateur non root. Cette modification peut potentiellement faire échouer votre déploiement personnalisé. Vous devez donc passer ce changement et ses impacts potentiels en revue. Pour plus d'informations, voir HCL Commerce utilisateurs et privilèges liés aux conteneurs.
Description de la structure de fichiers du répertoire d'installation Outil HCL Commerce Build
La table suivante décrit la structure de fichiers du répertoire d'installation Outil HCL Commerce Build :
| Chemin | Type | Description |
|---|---|---|
| dist/server | Répertoire | Contient les packages de déploiement du serveur générés par le processus de génération. Créée lorsque le processus de génération est exécuté. |
| extract | Répertoire | Contient des modèles et des exemples de fichiers pour le script Ant d'extraction source. |
| lib | Répertoire | Contient les bibliothèques Java requises par les processus de génération et de déploiement. |
| logs | Répertoire | Contient les journaux de génération. Créée lorsque le processus de génération est exécuté. |
| project-templates | Répertoire | Contient les modèles de projet pour le projet StaticWeb. |
| properties | Répertoire | Contient le fichier de propriétés de message traduit utilisé par le processus de génération. |
| source | Répertoire | Contient le code source copié ou extrait du SCM par le processus de génération. Créée lorsque le processus de génération est exécuté. |
| working | Répertoire | Contient les ressources intermédiaires ou temporaires générées par le processus de génération. Créée lorsque le processus de génération est exécuté. |
| wcbd-ant | Fichier | Script shell qui lance Ant pour démarrer le processus de génération. |
| wcbd-ant.bat | Fichier | Fichier de lots qui lance Ant pour démarrer le processus de génération. |
| wcbd-build.private.properties.template | Fichier | Modèle du fichier de propriétés de configuration qui contient les informations sensibles en termes de sécurité du processus de génération (par exemple, mots de passe). Les propriétés de ce fichier sont codées par le processus de génération. |
| wcbd-build.properties.template | Fichier | Modèle du fichier de propriétés de configuration principal du processus de génération. |
| wcbd-build.xml | Fichier | Fichier de génération Ant par défaut qui contrôle le processus de génération global. |
| wcbd-build-common.xml | Fichier | Fichier de génération Ant qui contient des cibles réutilisables pour le processus de génération. |
| wcbd-encode-properties | Fichier | Script shell qui lance Ant pour coder un fichier de propriétés. |
| wcbd-encode-properties.bat | Fichier | Fichier de lots qui lance Ant pour coder un fichier de propriétés. |
| wcbd-encode-properties.xml | Fichier | Fichier de génération Ant qui code un fichier de propriétés. |
| wcbd-setenv*.template | Fichier | Modèles pour le fichier de lots ou script shell qui définit les variables d'environnement requises par le processus de génération. |
| wcbd-version-info.properties | Fichier | Fichier de propriétés qui fournit les informations de version du Outil HCL Commerce Build. |
| wcbd-build-search-classpath.xml | Fichier | Fichier de génération Ant qui définit le chemin de classe de recherche de HCL Commerce. |
| wcbd-build-crs-definition.properties | Fichier | Fichier de propriétés qui fournit le type d'application et la cible Ant à utiliser pour le déploiement dans le CRS. |
| wcbd-build-shared-classpath.xml | Fichier | Fichier de génération Ant qui définit les chemins d'accès de classe de recherche partagés HCL Commerce et HCL Commerce. |
| wcbd-build-wc-ts-definition.properties | Fichier | Fichier de propriétés qui fournit le type d'application et la cible Ant à utiliser pour le déploiement dans l'EAR du serveur de transactions. |
| wcbd-build-crs-definition.properties | Fichier | Fichier de propriétés qui fournit le type d'application et la cible Ant à utiliser pour le déploiement dans l'EAR du serveur de magasin à distance. |
| wcbd-build-search-definition.properties | Fichier | Fichier de propriétés qui fournit le type d'application et la cible Ant à utiliser pour le déploiement dans l'EAR du serveur de recherche. |
| wcbd-build-xc-definition.properties | Fichier | Fichier de propriétés qui fournit le type d'application et la cible Ant à utiliser pour le déploiement dans l'EAR du serveur de personnalisation externe. |
| wcbd-build-data-definition.properties | Fichier | Fichier de propriétés qui fournit le type d'application et la cible Ant à utiliser pour les données de combinaison et les modifications de schéma. |
Répertoire de travail dans le conteneur Utility server Docker container
Si vous exécutez le Outil HCL Commerce Build à partir du Utility server Docker container, mettez tous les fichiers qui pourraient être modifiés dans un volume distinct monté sur le conteneur en tant que répertoire inscriptible. Placez tous les fichiers de propriétés de configuration utilisés pour exécuter le Outil HCL Commerce Build dans ce répertoire.
Définissez le répertoire de sortie de la génération dans un sous-répertoire de ce volume. La clé de configuration est dist.dir et peut être trouvée dans wcbd-build-type-app-type.properties. L'avantage de procéder ainsi réside dans le fait que, lorsque vous mettez à niveau l'image Docker du serveur d'utilitaire, les fichiers de configuration de l'autre volume ne sont pas perdus. Vous n'avez qu'à monter le volume une nouvelle fois vers le nouveau conteneur Docker.
Lorsque vous exécutez la commande de génération, utilisez le paramètre Java work.dir pour spécifier le support de volume, par exemple :
./wcbd-ant -buildfile wcbd-build.xml -Dbuild.type=local -Dapp.type=ts -Dbuild.label=testrun -Dwork.dir=mounted_dir