Starting the GraphQL Docker container by retrieving parameters from Vault

Learn about how to start the GraphQL Docker container by specifying CONFIGURE_MODE=Vault.

Mandatory environment variables

These are the mandatory environment variables that you must specify to configure the GraphQL Docker container to retrieve additional parameters from Vault.

Environment variable name Description Comments
TENANT The name of the group that contains your set of environments. For example, MyCompany. Container environment variable. This can be specified in the values.yaml configuration file under common.tenant.
ENVIRONMENT The name of the environment. For example, Non-production. Container environment variable. This can be specified in the values.yaml configuration file under common.environmentName.
ENVTYPE The environment type. Accepted values are auth and live. Container environment variable. This can be specified in the values.yaml configuration file under common.environmentType.
VAULT_TOKEN The Vault token to use to connect to Vault and request certification from Vault PKI. Container environment variable. This can be specified in the values.yaml configuration file under common.vaultToken.
VAULT_URL The Vault URL to use to connect to Vault and request certification from Vault PKI. Container environment variable. This can be specified in the values.yaml configuration file under common.vaultUrl.
CONFIGURE_MODE The configure mode.
Accepted values are:
  • Vault for Vault configuration.
  • EnvVariables for environment variables configuration.
Set this value to Vault to use Vault configuration, and the configurations present within this reference.
Container environment variable. This can be specified in the values.yaml configuration file under common.configureMode.

Optional Vault configuration variables

These are the optional Vault key values that you can specify within Vault to configure the GraphQL Docker container when used with the Vault configuration mode.

Vault path Description Reference Environment Variable
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/domainName Specify the internal service domain name. If the deployed environment is on a special namespace on Kubernetes, then the domain name should be .svc.cluster.local.

If no value is specified, then the default, default.svc.cluster.local, is used.

DOMAIN_NAME
HCL Commerce Version 9.1.12.0 or later${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/queryHost The Search server host name for the Elasticsearch-based search solution. Specify a value if you want to set queryHost, instead of using the default value. SEARCH_HOST
HCL Commerce Version 9.1.12.0 or later${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/queryPort The Search server port number for the Elasticsearch-based search solution. Specify a value if you want to set queryPort, instead of using the default value.

The default value is 30901.

SEARCH_PORT
HCL Commerce Version 9.1.12.0 or later${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/queryScheme The Search server scheme for the Elasticsearch-based search solution. Specify a value if you want to set queryScheme, instead of using the default value.

The default value is https.

SEARCH_SCHEME
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/queryHost The Data-query host name.
The default value is data-query.
Note: This parameter is only required if the Elasticsearch-based search solution is enabled.
DATA_QUERY_HOST
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/queryPort The Data-query port number.

The default value is 30901.

Note: This parameter is only required if the Elasticsearch-based search solution is enabled.
DATA_QUERY_PORT
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/queryScheme The Data-query scheme.

The default value is https.

Note: This parameter is only required if the Elasticsearch-based search solution is enabled.
DATA_QUERY_SCHEME
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/ingestHost The Ingest service host name.
Note: This parameter is only required if the Elasticsearch-based search solution is enabled.
INGEST_HOST
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/ingestPort The Ingest service port number.
Note: This parameter is only required if the Elasticsearch-based search solution is enabled.
INGEST_PORT
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/ingestScheme The Ingest service scheme.
Note: This parameter is only required if the Elasticsearch-based search solution is enabled.
INGEST_SCHEME
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/searchMasterHost The Solr search master host name.
Note: This parameter is only required for the Solr search solution authoring environment.

The default value is the Solr search master service name.

SEARCH_HOST
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/searchSlaveHost The Solr search slave host name.
Note: This parameter is only required for the Solr search solution live environment.

The default value is the Solr search slave service name.

SEARCH_HOST
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/searchPort The Solr search port number.
Note: This parameter is only required for the Solr search solution.

The default value is 3738.

SEARCH_PORT
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/searchScheme The Solr search scheme.
Note: This parameter is only required for the Solr search solution.

The default value is https.

SEARCH_SCHEME
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/xcHost Specify a value if you want to set a host name for the Customization server, instead of using the default value. XC_HOST
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/xcPort Specify a value if you want to set a port number for the Customization server, instead of using the default value. XC_PORT
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/txHost The Transaction server host name.

The default value is app.

TX_HOST
${VAULT_URL}/${TENANT}/${ENVIRONMENT}/${ENVTYPE}/txPort The Transaction server port number.

The default value is 5443.

TX_PORT