Variáveis específicas da nuvem

Última atualização: 31 de janeiro de 2025

Criado para:

  • Desenvolvedor

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

VariávelDescrição
MAGENTO_CLOUD_APP_DIRO caminho absoluto para o diretório do aplicativo.
MAGENTO_CLOUD_APPLICATIONUm 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_NAMEO nome do aplicativo configurado no arquivo .magento.app.yaml.
MAGENTO_CLOUD_DOCUMENT_ROOTO caminho absoluto para a raiz do documento web, se aplicável.
MAGENTO_CLOUD_ENVIRONMENTO nome da ramificação do ambiente.
MAGENTO_CLOUD_PROJECTA ID do projeto.
MAGENTO_CLOUD_RELATIONSHIPSUm 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_ROUTESDescreva as rotas definidas no arquivo de ambiente .magento/routes.yaml.
MAGENTO_CLOUD_TREE_IDA ID da árvore do aplicativo, que corresponde ao SHA da árvore no Git.
MAGENTO_CLOUD_VARIABLESUm objeto JSON codificado em base64 com pares de valores chave, como "key":"value".
MAGENTO_CLOUD_LOCKS_DIRFornece 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);
    }