DocumentationCommerceCommerce on Cloud Infrastructure Guide

Cloud-specific variables

Last update: Mon Feb 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

Environment variables that are specific to Adobe Commerce on cloud infrastructure use the MAGENTO_CLOUD_* prefix:

Variable
Description
MAGENTO_CLOUD_APP_DIR
The absolute path to the application directory.
MAGENTO_CLOUD_APPLICATION
A base64-encoded JSON object that describes the application. It maps to the .magento.app.yaml file content and has subkeys.
MAGENTO_CLOUD_APPLICATION_NAME
The name of the application configured in the .magento.app.yaml file.
MAGENTO_CLOUD_DOCUMENT_ROOT
The absolute path to the web document root, if applicable.
MAGENTO_CLOUD_ENVIRONMENT
The name of the environment branch.
MAGENTO_CLOUD_PROJECT
The project ID.
MAGENTO_CLOUD_RELATIONSHIPS
A base64-encoded JSON object that represents key (relationship name) and value (arrays of relationship pairs) endpoint definition. Each relationship endpoint definition is a decomposed form of a URL. It has a scheme, a host, a port, and optionally a username, password, path, and some additional information in query.
MAGENTO_CLOUD_ROUTES
Describe the routes defined in the environment .magento/routes.yaml file.
MAGENTO_CLOUD_TREE_ID
The tree ID for the application, which corresponds to the SHA of the tree in Git.
MAGENTO_CLOUD_VARIABLES
A base64-encoded JSON object with key-value pairs, such as "key":"value".
MAGENTO_CLOUD_LOCKS_DIR
Provides the path to the mount point for the lock provider on the Cloud infrastructure. The lock provider prevents the launch of duplicate cron jobs and cron groups.
WARNING
To add environment variables to override configuration settings using the Cloud Console, you must prepend the variable name with env: as in the following example:
Environment variable example

Since values can change over time, it is best to inspect the variable at runtime and use it to configure your application. For example, use the MAGENTO_CLOUD_RELATIONSHIPS variable to retrieve environment-related relationships as follows:

<?php
/**
  * Get relationships information from cloud environment variable.
  *
  * @return mixed
  */
    protected function getRelationships()
    {
        return json_decode(base64_decode($_ENV["MAGENTO_CLOUD_RELATIONSHIPS"]), true);
    }

Viewing environment variables

You can use the env:config:show command from the ece-tools package to show a list of variables for the current environment.

php ./vendor/bin/ece-tools env:config:show variables

Sample output for the variables option:

Magento Cloud Environment Variables:
+-----------------------------------+----------------------------------+
| Variable name                     | Value                            |
+-----------------------------------+----------------------------------+
| ADMIN_EMAIL                       | commerceadmin@company.com        |
| ADMIN_PASSWORD                    | 123123q                          |
+-----------------------------------+----------------------------------+
05f2f56e-ac5d-4931-8cdb-764e60e16f26