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 do administrador

Last update: Wed Mar 04 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

Os usuários que têm acesso administrativo ao projeto Adobe Commerce na infraestrutura em nuvem podem usar as seguintes variáveis de ambiente de projeto para substituir as definições de configuração da conta de usuário administrativo para acessar a interface do usuário administrador.

Credenciais de administrador

Você pode substituir as credenciais de usuário Admin durante a instalação do Commerce pelas variáveis ADMIN na tabela a seguir.

Se quiser alterar os valores após a instalação, conecte-se ao seu ambiente usando SSH e use o comando admin:user da Adobe Commerce CLI ​ para criar ou editar as credenciais de usuário do Administrador.

Variável
Padrão
Descrição
ADMIN_USERNAME
Endereço de email do proprietário da licença
Um nome de usuário para o usuário administrativo com a capacidade de criar outros usuários, incluindo usuários administrativos.
ADMIN_EMAIL
Endereço de email do usuário administrativo. Esse endereço é usado para enviar notificações de redefinição de senha.
ADMIN_PASSWORD
Senha do usuário administrativo. Quando o projeto é criado, uma senha aleatória é gerada e um email é enviado ao Proprietário da licença. Durante a criação do projeto, o Proprietário da licença já deve ter alterado a senha. Entre em contato com o Proprietário da licença para obter a senha atualizada.
ADMIN_LOCALE
en_US
A localidade padrão usada pelo Administrador.

URL do administrador

Use a variável de ambiente a seguir para proteger o acesso à interface do usuário do administrador. Se especificado, esse valor substitui o URL padrão durante a instalação. No Adobe Commerce na infraestrutura em nuvem, você deve definir ou alterar a URL do Administrador usando a variável ADMIN_URL no (Cloud Console ou Cloud CLI). A modificação da configuração de Admin é aplicável somente para instalações locais.

ADMIN_URL — O URL relativo para acessar a interface do usuário do Administrador. A URL padrão é /admin.

Alterar o URL do administrador

Por padrão, a URL do Commerce Admin está definida como <nome_do_domínio>/admin. Por motivos de segurança, a Adobe recomenda alterá-lo para um URL de administrador exclusivo e personalizado, o que não é fácil de adivinhar.

Em Adobe Commerce na infraestrutura de nuvem, você deve alterar a URL do Administrador usando a variável de ambiente ADMIN_URL em (Cloud Console ou Cloud CLI). A modificação da configuração de Admin é aplicável somente para instalações locais. Para instalações locais, siga usar uma URL de administrador personalizada.

A Adobe recomenda alterar a variável de nível de ambiente para o URL do administrador após a instalação. Defina esta configuração por motivos de segurança antes de ramificar a partir do ambiente master clonado. Todas as ramificações criadas a partir da ramificação master herdam as variáveis de nível de ambiente e seus valores, a menos que você defina a herança como false.

Use Cloud Console ou Cloud CLI para definir ou atualizar ADMIN_URL.

Opção A: Alterar a URL do Administrador usando o Cloud Console

Ambiente de integração

No Cloud Console, adicione uma nova variável com:

Definir a URL do Administrador no Cloud Console

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista All projects.

  3. Na visão geral do projeto, selecione o ambiente e clique no ícone de configuração.

  4. Selecione a guia Variables.

  5. Clique em Create Variable (ou edite a variável ADMIN_URL existente, se presente).

  6. Insira o seguinte:

    • Nome da variável: ADMIN_URL
    • Valor: seu novo caminho de Administrador (por exemplo, magento_A8v10).

    Por padrão, Available during runtime e Make inheritable estão selecionados. Para impedir que ambientes filhos herdem esse valor, desmarque Make inheritable para essa variável.

  7. Clique em Create variable (ou Save) e aguarde até que a implantação seja concluída. O botão só estará visível quando os campos obrigatórios contiverem valores.

Quando Preparo e Produção não estão disponíveis no Cloud Console

Envie um tíquete de suporte solicitando a adição da variável ADMIN_URL para o ambiente de preparo ou produção. Se o ambiente de Preparo e Produção estiver acessível no Cloud Console, adicione a variável conforme descrito em Ambiente de integração.

Opção B: Alterar a URL do Administrador usando o Cloud CLI

Use o comando magento-cloud variable:update para atualizar a variável. (O comando variable:set foi descontinuado e não está disponível.)

O exemplo a seguir atualiza o ambiente master ADMIN_URL para newAdmin_A8v10 e impede que ambientes filho herdem o valor:

magento-cloud variable:update ADMIN_URL --value newAdmin_A8v10 -e master --inheritable false
  • Reimplantação: alterar a variável ADMIN_URL em Cloud CLI aciona uma reimplantação do ambiente.
  • Herança: As variáveis são herdáveis por padrão. Para impedir que o valor seja herdado por ambientes filhos, use a opção --inheritable false como mostrado. Para obter mais detalhes, consulte visibilidade do nível de variável.
NOTE
O valor ADMIN_URL aceita letras (a-z, A-Z), números (0-9) e o caractere de sublinhado (_). Espaços ou outros caracteres não são aceitos.
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938