Démarrage du Transaction server Docker container en récupérant des paramètres à partir de variables d'environnement de conteneurs

Découvrez comment commencer Transaction server Docker container en spécifiant CONFIGURE_MODE=EnvVariables.

Variables d'environnement obligatoires

Il s'agit des variables d'environnement obligatoires que vous devez spécifier pour configurer le Transaction server Docker container.

Note: Les paramètres de base de données sont obligatoires lorsque vous n'utilisez pas les configurations par défaut. Si vous pointez sur une autre base de données, vous devez spécifier tous les paramètres liés à la base de données.


Nom du paramètre	Valeur
DBHOST Note: Si vous devez pointer sur une autre base de données, vous devez spécifier tous les paramètres liés à la base de données.	Nom d'hôte de la base de données.
DBNAME	Nom de la base de données.
DBUSER	Nom d'utilisateur de la base de données.
DBPASS	Mot de passe utilisateur de la base de données, qui est utilisé pour connecter la base de données au serveur d'applications.
DBPORT	Port de la base de données.
DBAUSER	Nom d'utilisateur de l'administrateur de la base de données.
DBAPASSENCRYPT	Mot de passe chiffré de l'administrateur de la base de données.
DBPASSENCRYPT	Mot de passe chiffré de l'utilisateur de la base de données, qui est utilisé pour mettre à jour le fichier wc-server.xml.
MERCHANTKEY_ENCRYPT	Clé de marchand chiffrée créée lorsque vous ou un administrateur avez chargé le schéma de base de données WebSphere Commerce. Pour plus d'informations, voir Chargement du schéma de base de données HCL Commerce.
SPIUSER_NAME	Votre nom SPIUSER. La valeur par défaut est `spiuser`.
SPIUSER_PWD	Mot de passe chiffré pour le spiuser. Pour plus d'informations, voir Définition du mot de passe spiuser dans vos images Docker.
STOREWEB_HOST	Un nom d'hôte unique à utiliser avec la fonction Aperçu du magasin Management Center.
SEARCH_HOST	Le nom d'hôte Search server. Pour la recherche basée sur Solr, il s'agit du nom d'hôte maître de recherche. Pour la recherche basée sur Elasticsearch, il s'agit du nom d'hôte de la requête Commerce.
STORE_HOST	Store server nom d'hôte. Le port par défaut est le port `8443`.
XC_HOST	Customization server nom d'hôte. Le port par défaut est le port `9443`.
SEARCH_REPEATER_HOST	Nom d'hôte du répéteur de recherche pour les environnements opérationnels. Note: Cela n'est nécessaire que lorsque le type d'environnement est `live`.
SESSION_KEY_ENCRYPT	La clé de session chiffrée. Note: Ce paramètre était facultatif dans toutes les versions antérieures à HCL Commerce version 9.1.12.0.

Variables d'environnement facultatives

Il s'agit des variables d'environnement facultatives que vous pouvez spécifier pour configurer le Transaction server Docker container.


Nom du paramètre	Valeur
DOMAIN_NAME	Nom de domaine de service interne. La valeur par défaut est : default.svc.cluster.local. Si l'environnement déployé se trouve sur un espace de noms spécial sur Kubernetes, le nom de domaine doit être `.svc.cluster.local`.
DBHOST_LIVE	Nom d'hôte de la base de données dans l'environnement opérationnel.
DBNAME_LIVE	Nom de la base de données dans l'environnement opérationnel.
DBPASS_LIVE	Mot de passe de l'utilisateur de la base de données dans l'environnement opérationnel.
DBPORT_LIVE	Le port de base de données dans l'environnement opérationnel.
DBUSER_LIVE	Nom d'utilisateur de la base de données dans l'environnement opérationnel.
LOCALSTOREWEB	Le nom d'hôte du serveur Web d'un magasin local si vous êtes passé de la version 7 à la version 8 de HCL Commerce.
adminPassword	Mot de passe pour l'utilisateur configadmin, qui est utilisé pour accéder à WebSphere Application Server Administrative Console.
TRACE_SPEC	Définit la spécification de trace. Pour plus d'informations concernant la trace, voir Composants de trace.
KAFKA_SERVERS	Serveur Kafka. Fonctionne avec ZOOKEEPER_SERVERS, si vous souhaitez configurer le conteneur pour intercepter la validation. Note: Ces paramètres KAFKA_SERVERS, ZOOKEEPER_SERVERS et KAFKA_TOPIC_PREFIX doivent être fournis ensemble.
ZOOKEEPER_SERVERS	Fonctionne avec KAFKA_SERVERS, si vous souhaitez configurer le conteneur pour capturer la validation.
KAFKA_TOPIC_PREFIX	Ce paramètre est utilisé pour composer le nom de la file d'attente pour l'invalidation du cache.
HEALTH_CENTER_ENABLED	Spécifiez si le Centre de santé est activé. Les valeurs acceptées sont `true` et `false`. La valeur par défaut est `false`.
SESSION_KEY_ENCRYPT	La clé de session chiffrée. Note: Ce paramètre est obligatoire dans toutes les éditions de HCL Commerce 9.1.12.0 et ultérieures.
SEARCH_PORT	Port Search server autodéfini. Pour la recherche basée sur Solr, la valeur par défaut est `3738`. Pour la recherche basée sur Elasticsearch, la valeur par défaut est `30901`.
STORE_PORT	Port de serveur de magasin autodéfini. La valeur par défaut est `8443`.
STOREWEB_PORT	Port de serveur Web de magasin autodéfini. La valeur par défaut est `443`.
XC_PORT	Port de serveur de personnalisation autodéfini. La valeur par défaut est `9443`.
ENVTYPE	Le type d'environnement. Les valeurs acceptées sont `auth` et `live`. Note: Si vous définissez ce paramètre sur `live`, vous devez également passer le paramètre `SEARCH_REPEATER_HOST`.
EXPOSE_METRICS	Spécifiez si vous souhaitez activer les métriques pour l'environnement.
DB_SSLENABLE	Spécifie si un protocole SSL pour les connexions à la base de données est activé ou non. Les valeurs acceptées sont `true` et `false`. La valeur par défaut est `false`.
DB_XA	Spécifiez si la fonction XA a été activée pour la base de données. Les valeurs acceptées sont `true` et `false`. La valeur par défaut est `false`.
DBTYPE	Type de base de données. Les valeurs acceptées sont `db2` et `oracle`.
DB_XA_LIVE	Spécifiez si la fonction XA a été activée pour la base de données opérationnelle. Les valeurs acceptées sont `true` et `false`. La valeur par défaut est `false`.
DB_SSLENABLE_LIVE	Spécifie s'il convient d'activer le protocole SSL pour les connexions à la base de données opérationnelle. Les valeurs acceptées sont `true` et `false`. La valeur par défaut est `false`.
REACT_STORE_PORT	Le port du magasin React. La valeur par défaut est `6443`.
ELASTICSEARCH_PORT	Le port Elasticsearch. La valeur par défaut est `30200`.
REACT_STORE_SERVICE_PORT	Le port du service de magasin React. La valeur par défaut est `6443`.
DX_HOST	Nom d'hôte HCL Digital Experience (DX). Ils sont requis pour l'intégration de HCL Commerce à DX. Note: Cette intégration n'est prise en charge que sur un déploiement Kubernetes.
DX_PORT	Numéro de port HCL Digital Experience (DX). La valeur par défaut est définie sur `443` si le nom d'hôte DX a été spécifié et si aucune valeur personnalisée n'est spécifiée.
DX_SCHEME	Schéma HCL Digital Experience (DX). La valeur par défaut est définie sur `https` si le nom d'hôte DX a été spécifié et si aucune valeur personnalisée n'est spécifiée.
ENABLE_JSON_LOGGING	Indiquez s'il faut activer ou désactiver la journalisation JSON pour tous les serveurs d'applications. Définissez ce paramètre sur la valeur `true` si vous souhaitez activer la journalisation JSON pour tous les serveurs d'applications. La valeur par défaut est `false`. Note: JSON est un format de données structuré. Cela vous permet de rechercher, filtrer et analyser les journaux de tous les serveurs d'applications.
ALLOWED_DOMAIN	Indiquez un domaine entier vers lequel HCL Commerce autorise la redirection. Les noms de domaine sont délimités par une virgule, tandis que les modules sont délimités par un point-virgule. `Stores:domain1.com,domain2.com;LOBTools:domain3.com,domain4.com`
ALLOWED_HOST	Spécifiez des noms d'hôte exacts vers lesquels HCL Commerce autorise la redirection. Les noms d'hôte sont délimités par une virgule, tandis que les modules sont délimités par un point-virgule. `Stores:host1.domain1.com,host2.domain1.com;LOBTools:host3.domain2.com,host4.domain2.com`

Exemple de code

Pour un déploiement de recherche basée sur Solr :

docker run -it -e LICENSE=accept \ -e CONFIGURE_MODE=EnvVariables -e MERCHANTKEY_ENCRYPT=<encrypted merchantkey that you encrypted with wcs_encrypt.sh> \ -e SPIUSER_NAME=<your spiuser-name> \ -e SPIUSER_PWD=<your spiuser password that you encrypted with wcs_encrypt.sh> \ -e DBHOST=<db hostname> \ -e DBNAME=<db instance name> \ -e DBPASS=<db user password> \ -e DBPORT=<db port> \ -e DBUSER=<db user> \ -e STOREWEB_HOST=<Store server hostname for Store preview that can be accessed from your browser. Default port is 443> \ -e STORE_HOST=<store server hostname, default port is 8443> \ -e SEARCH_HOST=<search master server hostname, default port is 3738>\ -e XC_HOST=<search server hostname, default port is 3738>\ <Transaction Docker image>

Pour un déploiement de recherche basée sur Elasticsearch :

docker run -it -e LICENSE=accept \ -e CONFIGURE_MODE=EnvVariables -e MERCHANTKEY_ENCRYPT=<encrypted merchantkey that you encrypted with wcs_encrypt.sh> \ -e SPIUSER_NAME=<your spiuser-name> \ -e SPIUSER_PWD=<your spiuser password that you encrypted with wcs_encrypt.sh> \ -e DBHOST=<db hostname> \ -e DBNAME=<db instance name> \ -e DBPASS=<db user password> \ -e DBPORT=<db port> \ -e DBUSER=<db user> \ -e STOREWEB_HOST=<Store server hostname for Store preview that can be accessed from your browser. Default port is 443> \ -e STORE_HOST=<store server hostname, default port is 8443> \ -e SEARCH_HOST=<commerce query server hostname, default port is 3738>\ -e XC_HOST=<search server hostname, default port is 3738>\-e TOOLING_BASE_URL =< tooling web server base url>\ -e JWKS =<Json Web Key Set>\ -e JWKS_KEYID =<Json Web Key Set Key ID>\ -e REACT_STORE_HOST =< Hostname for react store host. (Only required when elasticsearch enabled)>\ -e REACT_STORE_SERVICE_HOST =< Hostname for react store service host. (Only required when elasticsearch enabled)>\ -e ELASTICSEARCH_ENABLED =< Specify if the env should use elastic search or solr search >\ -e INGEST_HOST =< Hostname for ingest service. Default value is ingest. (Only required when elasticsearch enabled)>\ -e ELASTICSEARCH_HOST =< Hostname for elasticsearch server. Default value is elasticsearch. (Only required when elasticsearch enabled)> <Transaction Docker image>