Feature previewHCL Commerce Version 9.1.13.0 or later

Démarrage du Nextjs (Ruby) store Docker container via l'extraction des paramètres à partir de Vault

Découvrez comment démarrer le conteneur Nextjs (Ruby) store Docker container en spécifiant CONFIGURE_MODE=Vault.

Variables d'environnement obligatoires

Il s'agit des variables d'environnement obligatoires que vous devez spécifier pour configurer le Nextjs (Ruby) store Docker container afin de récupérer des paramètres supplémentaires de Vault.

Nom de variable d'environnement Description Commentaires
TENANT Nom du groupe contenant votre ensemble d'environnements. Par exemple, MonEntreprise. Variable d'environnement du conteneur. Elle peut être spécifiée dans le fichier de configuration values.yaml sous common.tenant.
ENVIRONMENT Nom de l'environnement. Par exemple, Non-production. Variable d'environnement du conteneur. Elle peut être spécifiée dans le fichier de configuration values.yaml sous common.environmentName.
ENVTYPE Le type d'environnement. Les valeurs acceptées sont auth et live. Variable d'environnement du conteneur. Elle peut être spécifiée dans le fichier de configuration values.yaml sous common.environmentType.
VAULT_TOKEN Jeton Vault à utiliser pour se connecter à Vault et demander une certification à partir de l'infrastructure à clé publique Vault. Variable d'environnement du conteneur. Elle peut être spécifiée dans le fichier de configuration values.yaml sous common.vaultToken.
VAULT_URL URL de Vault à utiliser pour se connecter à Vault et demander la certification à Vault PKI. Variable d'environnement du conteneur. Elle peut être spécifiée dans le fichier de configuration values.yaml sous common.vaultUrl.
CONFIGURE_MODE Mode configuration.
Les valeurs acceptées sont :
  • Vault pour la configuration de Vault.
  • EnvVariables pour la configuration des variables d'environnement.
Définissez cette valeur sur Vault pour utiliser la configuration Vault et les configurations présentes dans cette référence.
 Variable d'environnement du conteneur. Elle peut être spécifiée dans le fichier de configuration values.yaml sous common.configureMode.

Variables d'environnement facultatives

Il s'agit des variables d'environnement facultatives que vous pouvez spécifier pour configurer le Nextjs (Ruby) store Docker container.

Nom de variable d'environnement Description Commentaires
HCL Commerce Version 9.1.14.0 or laterNODE_INSTANCE_NUMBER Définit le nombre maximal de processus Node simultanés pouvant être exécutés par l'API du cluster Node.js.
Note: La valeur spécifiée dans Vault est prioritaire sur les autres méthodes de configuration.
 Variable d'environnement du conteneur. Elle peut être spécifiée dans le fichier de configuration values.yaml sous nextjsApp.resources.limits.cpu.
Il est possible également de la spécifier dans Vault.
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/nodeInstanceNumber/nextjs-app

Variables de configuration Vault obligatoires

Il s'agit des valeurs de clé Vault obligatoires que vous devez spécifier dans Vault pour configurer le Nextjs (Ruby) store Docker container de manière à utiliser le mode de configuration Vault.

Chemin Vault Description Variable d'environnement de référence
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/reactStoreMapApiKey Clé d'API Google Maps utilisée par le magasin React.
Note: Il est possible de démarrer le conteneur à l'aide d'une valeur d'espace réservé. Par exemple, google-api-key.
 MAP_API_KEY

Variables de configuration Vault facultatives

Il s'agit des valeurs de clé Vault facultatives que vous pouvez spécifier dans Vault pour configurer le Nextjs (Ruby) store Docker container lors d'une utilisation avec le mode de configuration Vault.

Chemin Vault Description Variable d'environnement de référence
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/domainName 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 alors être .svc.cluster.local. DOMAIN_NAME
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/txHost Nom d'hôte du Transaction server.

La valeur par défaut est ${TENANT}${ENVIRONMENT}${ENVTYPE}ts-app.${DOMAIN_NAME}.

 TX_HOST
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/queryHost Nom d'hôte Search server, qui fait référence au service de requête pour la solution de recherche basée sur Elasticsearch.

La valeur par défaut est ${TENANT}${ENVIRONMENT}${ENVTYPE}query-app.${DOMAIN_NAME}.

 SEARCH_HOST
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/logLevel/nextjs-app Niveau de journalisation utilisé à des fins d'identification et de résolution des incidents.
Les niveaux de journalisation disponibles sont les suivants :
  • trace
  • debug
  • info
  • warn
  • error
  • fatal
Note:
  • Lorsqu'il est configuré en tant que trace, tous les messages s'affichent.
  • Lorsqu'il est configuré en tant que debug, tous les messages sont affichés, à l'exception de ceux étiquetés comme trace.
  • Lorsqu'il est configuré en tant que info, tous les messages de niveau info à fatal sont affichés.
Par défaut, les messages du journal du client API côté serveur s'affichent au niveau :
  • HCL Commerce Version 9.1.14.0info
  • HCL Commerce Version 9.1.13.0trace
.
 LOG_LEVEL
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/traceSpecification/nextjs-app Définit les méthodes d'API qui sont consignées.
Les fonctions peuvent être filtrées à l'aide d'une liste séparée par des virgules.
TRACE_DETAILS=findProducts,getV2CategoryResources
Cette spécification affiche uniquement les messages de journal provenant des fonctions findProducts et getV2CategoryResources.
Par défaut, cette valeur reste vide. Cela implique que toutes les fonctions sont consignées.
TRACE_DETAILS=
TRACE_DETAIL
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/logSensorString/nextjs-app Définit la chaîne de masquage utilisée dans les journaux pour masquer des informations sensibles, par exemple des messages avec du contenu lié au RGPD. L'ensemble de valeurs à masquer est identifié par leurs clés dans le fichier de configuration logging/core/redactionKeys.ts. Pour plus d'informations, voir https://getpino.io/#/docs/redaction.

La valeur par défaut indiquée dans le modèle est **GDPR COMPLIANT**. Si la valeur est vide ou non définie, la chaîne de censure utilisée est ****.

 LOG_SENSOR_STRING
HCL Commerce Version 9.1.14.0 or later${VAULT_URL}/${TENANT}/${ENVIRONMENT}/nodeInstanceNumber/nextjs-app Définit le nombre maximal de processus Node simultanés pouvant être exécutés par l'API du cluster Node.js.
Note: La valeur spécifiée dans Vault est prioritaire sur les autres méthodes de configuration.
 NODE_INSTANCE_NUMBER