Níveis variáveis

As variáveis de projeto se aplicam a todos os ambientes no projeto. As variáveis de ambiente se aplicam a um ambiente ou ramificação específica. Um ambiente herda definições de variável do ambiente pai.

É possível substituir um valor herdado definindo a variável especificamente para o ambiente. Por exemplo, para definir variáveis para desenvolvimento, defina os valores das variáveis no arquivo .magento.env.yaml no ambiente de integração. Todos os ambientes que se ramificam do ambiente de integração herdam esses valores. Consulte Configuração de implantação para obter detalhes sobre como configurar seu ambiente usando o arquivo .magento.env.yaml.

CLI

Para definir variáveis usando a CLI da Nuvem:

  • Variáveis específicas de projeto—Para definir o mesmo valor para todos ambientes em seu projeto. Essas variáveis estão disponíveis na build e no tempo de execução em todos os ambientes.

    code language-bash
    magento-cloud variable:create --level project --name <variable-name> --value <variable-value>
    
  • Variáveis específicas do ambiente—Para definir um valor único para um ambiente específico. Essas variáveis estão disponíveis no tempo de execução e são herdadas por ambientes secundários. Especifique o ambiente no comando usando a opção -e.

    code language-bash
    magento-cloud variable:create --level environment --name <variable-name> --value <variable-value>
    

Depois de definir variáveis específicas do projeto, você deve reimplantar manualmente o ambiente remoto para que a alteração entre em vigor. Encaminhe as novas confirmações para acionar uma reimplantação.

Console

Para definir variáveis usandoCloud Console:

  1. No Cloud Console, clique no ícone de configuração no lado direito da navegação do projeto.

    Configurar projeto {width="36"}

  2. Para definir uma variável de nível de projeto, em Configurações do Projeto, clique em Variáveis.

    Variáveis de projeto

  3. Para definir uma variável de nível de ambiente, na lista Ambientes, selecione um ambiente e clique na guia Variables.

    Guia de variáveis de ambiente

  4. Clique em Create variable.

  5. Forneça um nome e valor para a variável. Escolha entre as opções:

    • Disponível durante o tempo de execução
    • Disponível durante o tempo de compilação
    • Valor JSON
    • Variável sensível (valor oculto no console e respostas da CLI)
    • Tornar herdável (ambientes secundários podem herdar variáveis de nível de ambiente)
  6. Clique em Create variable.

note caution
CAUTION
Definir variáveis específicas do ambiente no Cloud Console reimplanta automaticamente o ambiente.

Visibilidade

É possível limitar a visibilidade de uma variável durante a compilação ou o tempo de execução usando o comando --visible-<build|runtime>. Além disso, há opções para definir a herança e a sensibilidade.

Use as seguintes opções para impedir que uma variável seja vista ou herdada:

  • --inheritable false — desabilita a herança de ambientes filhos. Isso é útil para definir valores somente de produção na ramificação master e permitir que todos os outros ambientes usem uma variável de nível de projeto com o mesmo nome.
  • --sensitive true — marca a variável como não legível em Cloud Console. Não é possível exibir a variável na interface do usuário; no entanto, é possível exibi-la no container do aplicativo, como qualquer outra variável.

A seguir, é mostrado um caso específico para impedir que uma variável seja vista ou herdada. Você só pode especificar essas opções na CLI. Esse caso não se refere a todas as variáveis de ambiente disponíveis.

magento-cloud variable:create --name <variable-name> --value <variable-value> --inheritable false --sensitive true

Verificar níveis e valores de variável

Você pode exibir uma lista de variáveis existentes usando a CLI da nuvem.

magento-cloud variables
Variables on the project Project-Name (<project-id>), environment <environment-name>:
+----------------------------+-------------+-------------------------------------------+
| Name                       | Level       | Value                                     |
+----------------------------+-------------+-------------------------------------------+
| env:COMPOSER_AUTH          | project     | {                                         |
|                            |             |    "http-basic": {                        |
|                            |             |       "repo.magento.com": {               |
|                            |             |       "username":                         |
|                            |             | "<public-key>",                           |
|                            |             |       "password":                         |
|                            |             | "<private-key>"                           |
|                            |             |     }                                     |
|                            |             |   }                                       |
|                            |             | }                                         |
| ADMIN_EMAIL                | project     | admin@123.com                             |
| ADMIN_EMAIL                | environment | admin@123.com                             |
| ADMIN_PASSWORD             | environment | password                                  |
| ADMIN_URL                  | environment | admin123                                  |
| ADMIN_USERNAME             | environment | admin                                     |
| php:newrelic.license       | environment | xxxx71fb030366182117f955a22e4baf8exxxxxx  |
+----------------------------+-------------+-------------------------------------------+
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26