DocumentaçãoCommerceGuia do Commerce na nuvem

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Variáveis específicas da nuvem

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

As variáveis de ambiente específicas do Adobe Commerce na infraestrutura em nuvem usam o prefixo MAGENTO_CLOUD_*:

Variável
Descrição
MAGENTO_CLOUD_APP_DIR
O caminho absoluto para o diretório do aplicativo.
MAGENTO_CLOUD_APPLICATION
Um objeto JSON codificado na base64 que descreve o aplicativo. Ele mapeia para o conteúdo do arquivo .magento.app.yaml e tem subchaves.
MAGENTO_CLOUD_APPLICATION_NAME
O nome do aplicativo configurado no arquivo .magento.app.yaml.
MAGENTO_CLOUD_DOCUMENT_ROOT
O caminho absoluto para a raiz do documento web, se aplicável.
MAGENTO_CLOUD_ENVIRONMENT
O nome da ramificação do ambiente.
MAGENTO_CLOUD_PROJECT
A ID do projeto.
MAGENTO_CLOUD_RELATIONSHIPS
Um objeto JSON codificado em base64 que representa a definição do ponto de extremidade da chave (nome do relacionamento) e do valor (matrizes de pares de relacionamento). Cada definição de endpoint de relacionamento é uma forma decomposta de um URL. Ele tem um scheme, um host, um port e opcionalmente um username, password, path, e algumas informações adicionais em query.
MAGENTO_CLOUD_ROUTES
Descreva as rotas definidas no arquivo de ambiente .magento/routes.yaml.
MAGENTO_CLOUD_TREE_ID
A ID da árvore do aplicativo, que corresponde ao SHA da árvore no Git.
MAGENTO_CLOUD_VARIABLES
Um objeto JSON codificado em base64 com pares de valores chave, como "key":"value".
MAGENTO_CLOUD_LOCKS_DIR
Fornece o caminho para o ponto de montagem do provedor de bloqueio na infraestrutura em nuvem. O provedor de bloqueio impede a inicialização de trabalhos cron duplicados e grupos cron.
WARNING
Para adicionar variáveis de ambiente a substituir definições de configuração usando Cloud Console, você deve anexar o nome da variável a env: como no exemplo a seguir:
Exemplo de variável de ambiente

Como os valores podem mudar com o tempo, é melhor inspecionar a variável no tempo de execução e usá-la para configurar seu aplicativo. Por exemplo, use a variável MAGENTO_CLOUD_RELATIONSHIPS para recuperar as relações relacionadas ao ambiente da seguinte maneira:

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

Exibição de variáveis de ambiente

Você pode usar o comando env:config:show do pacote ece-tools para mostrar uma lista de variáveis do ambiente atual.

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

Exemplo de saída para a opção variables:

Magento Cloud Environment Variables:
+-----------------------------------+----------------------------------+
| Variable name                     | Value                            |
+-----------------------------------+----------------------------------+
| ADMIN_EMAIL                       | commerceadmin@company.com        |
| ADMIN_PASSWORD                    | 123123q                          |
+-----------------------------------+----------------------------------+
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938