DocumentaçãoCommerceGuia de configuração

[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."}

Exemplo usando uma configuração compartilhada

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor

Este exemplo mostra como alterar as seguintes configurações no sistema de desenvolvimento, atualizar o arquivo de configuração compartilhado, config.php, no sistema de compilação, e implementar as mesmas configurações no sistema de produção:

  • Fuso Horário
  • Unidade de peso

Estas configurações estão disponíveis no Administrador em Lojas > Configurações > Configuração > Geral > Geral.

Você pode usar o mesmo procedimento para definir configurações não confidenciais e não específicas do sistema nas seguintes referências:

Antes de começar

Antes de começar, configure as permissões e a propriedade do sistema de arquivos conforme discutido em Pré-requisitos para sistemas de desenvolvimento, compilação e produção.

Suposições

Este tópico fornece um exemplo de modificação da configuração do sistema de produção. Se desejar, você poderá escolher diferentes opções de configuração.

Para os fins deste exemplo, pressupomos o seguinte:

  • Você usa o controle de origem do Git
  • O sistema de desenvolvimento está disponível em um repositório remoto Git chamado mconfig
  • Sua ramificação de trabalho Git é chamada m2.2_deploy

Etapa 1: definir a configuração no sistema de desenvolvimento

Para definir o fuso horário e as unidades de peso no sistema de desenvolvimento:

  1. Faça logon no Administrador.

  2. Clique em Lojas > Configurações > Configuração > Geral > Geral.

  3. No painel direito, expanda Opções de Local.

    A figura a seguir mostra um exemplo.

    Definir opções de localidade no sistema de desenvolvimento

  4. Na lista Fuso horário, clique em GMT+00:00 (UTC).

  5. Desmarque a caixa de seleção Usar valor do sistema ao lado do campo Unidade de Peso.

  6. Na lista Unidade de Peso, clique em kg.

  7. Clique em Salvar configuração.

  8. Se solicitado, limpe o cache.

Etapa 2: atualizar a configuração compartilhada

Gere o arquivo de configuração compartilhado, app/etc/config.php, em seu sistema de desenvolvimento e transfira-o usando o controle do código-fonte para seu sistema de compilação conforme discutido nesta seção.

Para atualizar a configuração:

  1. Faça logon no sistema de desenvolvimento como ou alterne para o proprietário do sistema de arquivos.

  2. Altere para a raiz do aplicativo e execute o comando dump.

    code language-bash 
    cd <Magento root dir>
php bin/magento app:config:dump

    Por exemplo, se o Commerce estiver instalado em /var/www/html/magento2, digite:

    code language-bash 
    cd /var/www/html/magento2
php bin/magento app:config:dump

  3. Confirme se app/etc/config.php foi atualizado.

    code language-bash 
    git status

    Exemplo de resposta:

    code language-none 
    On branch m2.2_deploy
Changed but not updated:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)
       modified:   app/etc/config.php
    note warning
    WARNING
    não enviar alterações para os diretórios generated, pub/media ou pub/static para o controle do código-fonte. Você gera esses arquivos no sistema de build. O sistema de desenvolvimento deve ter código, temas e assim por diante que não estão prontos para uso no sistema de produção.

  4. Fazer check-in das alterações em app/etc/config.php somente no controle do código-fonte.

    code language-bash 
    git add app/etc/config.php && git commit -m "Updated shared configuration" && git push mconfig m2.2_deploy

Etapa 3: atualizar o sistema de compilação e gerar arquivos

Agora que você confirmou as alterações na configuração compartilhada para o controle de origem, é possível obter essas alterações no sistema de compilação, compilar o código e gerar arquivos estáticos. A última etapa é transferir essas alterações para o sistema de produção. Como resultado, a configuração do seu sistema de produção corresponderá ao seu sistema de desenvolvimento.

Para atualizar o sistema de compilação:

  1. Faça logon no sistema de compilação como proprietário do sistema de arquivos.

  2. Altere para o diretório raiz do aplicativo.

    code language-bash 
    cd <Magento root dir>

  3. Puxe as alterações para app/etc/config.php do controle do código-fonte.

    code language-bash 
    git pull mconfig m2.2_deploy

  4. Código de compilação.

    code language-bash 
    bin/magento setup:di:compile

  5. Depois que o código tiver sido compilado, gere arquivos de visualização estáticos.

    code language-bash 
    bin/magento setup:static-content:deploy -f

  6. Verifique as alterações no controle de origem.

    code language-bash 
    git add -A && git commit -m "Updated files on build system" && git push mconfig m2.2_deploy

Etapa 4: atualizar o sistema de produção

A última etapa do processo é atualizar o sistema de produção do controle do código-fonte. Isso extrai todas as alterações feitas em seus sistemas de desenvolvimento e compilação, o que significa que seu sistema de produção está completamente atualizado.

Para atualizar o sistema de produção:

  1. Faça logon no sistema de produção como proprietário do sistema de arquivos.

  2. Altere para a raiz do aplicativo e habilite o modo de manutenção.

    code language-bash 
    cd <Magento root dir>
    code language-bash 
    bin/magento maintenance:enable

    Para obter opções adicionais, como a capacidade de definir uma lista de permissões de endereço IP, consulte magento maintenance:enable.

  3. Interrompa todos os trabalhos em execução definindo de cron_run a false em app/etc/env.php da seguinte maneira:

    code language-php?start_inline=1 
    'cron_consumers_runner' => [
        'cron_run' => false
    ]

  4. Atualize a configuração.

    code language-bash 
    bin/magento app:config:import

  5. Finalmente, kill qualquer processo de consumidor ativo.

    code language-bash 
    kill <PID>

    Onde PID é a ID do processo a ser eliminada, por exemplo:

    code language-bash 
    kill 1234

  6. Extrair código do controle de origem.

    code language-bash 
    git pull mconfig m2.2_deploy

  7. Atualize a configuração.

    code language-bash 
    bin/magento app:config:import

  8. Limpe o cache.

    code language-bash 
    bin/magento cache:clean

  9. Encerrar modo de manutenção.

    code language-bash 
    bin/magento maintenance:disable

Verifique as alterações no Admin

Para verificar se estas configurações não são editáveis no Admin:

  1. Faça logon no Administrador.

  2. Clique em Lojas > Configurações > Configuração > Geral > Geral.

  3. No painel direito, expanda Opções de Local.

    As opções que você acabou de definir são exibidas da seguinte maneira:

    Opções de configuração não editáveis no Admin

INFO
Para alterar uma configuração bloqueada no Admin, use o comando magento config:set --lock ​.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c