Personnalisation du Web server Docker container

Si vous devez personnaliser Web server Docker container, vous pouvez créer des fichiers de configuration personnalisés et créer une nouvelle image Docker de serveur Web.

Vous pouvez personnaliser les fichierd httpd.conf et plugin-cfg.xml.

Note:

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.
Le nouveau contenu Dockerfile est introduit pour les versions de HCL Commerce 9.1.14.0 et ultérieures en raison de l'introduction de l'utilisateur non root, comuser, ainsi que de la migration du système d'exploitation de conteneur de CentOS vers UBI8 effectuée dans la même version. Pour plus d'informations, voir HCL Commerce 9.1.14.0.

Procedure

Copiez les fichiers httpd.conf et plugin-cfg.xml sur la machine hôte Docker pour les modifier.
Par exemple,
```
docker cp web_container_name:/opt/WebSphere/Plugins/config/templates/plugin-cfg.xml .
```
et
```
docker cp web_container_name:/opt/WebSphere/HTTPServer/conf/httpd.conf .
```
Le point (.) à la fin de la commande copie les fichiers dans le répertoire de travail actuel. Modifiez la commande si vous souhaitez copier dans un autre répertoire.
Modifiez les fichiers httpd.conf et plugin-cfg.xml pour ajouter des demandes de transfert ou des limitations de demande.
Note: Assurez-vous d'adhérer aux recommandations de configuration suivantes lors de la modification des fichiers.
- Pour httpd.conf, ne supprimez pas la définition d'hôte virtuel existante. Vous pouvez ajouter de nouveaux enregistrements à la définition d'hôte virtuel existante ou ajouter une nouvelle définition d'hôte virtuel avec un nouveau port.
- Pour plugin-cfg.xml, ne supprimez pas les définitions Uri, Urigroup, VirtualHostGroup, Route et Servercluster existantes. Vous pouvez ajouter de nouveaux enregistrements aux définitions existantes ou créer de nouvelles définitions pour ces objets.

Créez un Dockerfile avec le contenu suivant.

FROM Docker_registry/commerce/ts-web:source_image_tag USER root RUN dnf install -y nc && dnf clean all USER comuser HEALTHCHECK --interval=10s CMD nc localhost 8000 < /dev/null #If you migrated from HCL Commerce V7 or V8, and are using the migrated local store, uncomment the next line. #COPY -chown=comuser:comuser localStoreStaticAsset/ /SETUP/Cus/ #For local store assets, there is a built-in request forward configuration in httpd.conf and plugin-cfg.xml. #The built-in store configuration is only needed for the migrated local store, not the Version 9 remote store. COPY -chown=comuser:comuser SETUP /SETUP

Pour les versions de HCL Commerce 9.1.0.0 à 9.1.13.0 :

FROM Docker_registry/commerce/ts-web:source_image_tag RUN yum install -y nc && yum clean all HEALTHCHECK --interval=10s CMD nc localhost 8000 < /dev/null #If you migrated from HCL Commerce V7 or V8, and are using the migrated local store, uncomment the next line. #COPY localStoreStaticAsset/ /SETUP/Cus/ #For local store assets, there is a built-in request forward configuration in httpd.conf and plugin-cfg.xml. #The built-in store configuration is only needed for the migrated local store, not the Version 9 remote store. COPY SETUP /SETUP

Docker_registry: URL du registre Docker où se trouve l'image source.
source_image_tag: Balise de l'image source que vous souhaitez utiliser.

Créez un dossier SETUP/config dans le même répertoire que le fichier Docker.
La structure de votre répertoire doit ressembler à l'arborescence suivante.
- Fichier Docker
- SETUP
  - Config
Déplacez les fichiers personnalisés httpd.conf et plugin-cfg.xml vers le dossier /SETUP/config.
Créez la nouvelle image Docker du serveur Web.

Pour plus d'informations sur la création, voir Dockerfile reference.

Si vous souhaitez utiliser Docker Compose, vous pouvez consulter la rubrique suivante qui montre comment mettre à jour votre fichier de composition, Création d'une image Docker personnalisée à partir d'un package déployable.