Gerenciamento de configuração de armazenamento

As configurações padrão da loja são armazenadas em um config.xml para o módulo apropriado. Quando você altera as configurações no Commerce Admin ou no comando bin/magento config:set da CLI, as alterações são refletidas no banco de dados principal, especificamente na tabela core_config_data. Essas configurações substituem as configurações padrão armazenadas no arquivo config.xml.

As configurações de armazenamento, que se referem às configurações na seção Admin Lojas > Configurações > Configuração, são armazenadas nos arquivos de configuração de implantação com base no tipo de configuração:

O gerenciamento de configurações fornece uma maneira de implantar configurações de armazenamento consistentes em seus ambientes com tempo de inatividade mínimo usando a implantação de pipeline. O projeto de infraestrutura do Adobe Commerce na nuvem inclui o servidor de compilação, scripts de compilação e implantação e ambientes de implantação criados com a estratégia de implantação de pipeline em mente.

Esquema de substituição de configuração

Todas as configurações do sistema são definidas durante as fases de criação e implantação de acordo com o seguinte esquema de substituição:

Em resumo, as variáveis de ambiente substituem todos os outros valores.

Se a mesma configuração for definida em vários locais, a aplicação dependerá da seguinte hierarquia de configuração para determinar qual valor aplicar ao ambiente:

Despejo de configuração

Você pode usar o seguinte comando ece-tools para gerar um arquivo config.php que contenha todas as configurações de armazenamento atuais:

./vendor/bin/ece-tools config:dump

Os dados "despejados" para o arquivo app/etc/config.php ficam bloqueados, o que significa que o campo correspondente no Administrador do Commerce torna-se somente leitura. O arquivo config.php inclui apenas as configurações que você define. Ela não bloqueia os valores padrão. Bloquear apenas os valores atualizados também garante que todas as extensões usadas nos ambientes de Preparo e Produção não sejam interrompidas devido a configurações somente leitura, especialmente o Fastly.

Dados sensíveis

Todas as configurações confidenciais são exportadas para o arquivo app/etc/env.php quando você usa o comando bin/magento app:config:dump. Você pode definir valores confidenciais usando o comando da CLI: bin/magento config:sensitive:set. Consulte Configurações sensíveis e específicas do ambiente no guia Commerce PHP Extensions para saber como designar configurações sensíveis ou específicas do sistema.

Consulte uma lista de Configurações sensíveis ou específicas do sistema no Guia de Configuração.

Desempenho do SCD

Dependendo do tamanho do armazenamento, você pode ter um grande número de arquivos de conteúdo estático para implantar. Normalmente, o conteúdo estático é implantado durante a fase de implantação, quando o aplicativo está no modo de manutenção. A configuração mais ideal é gerar conteúdo estático durante a fase de criação. Consulte Escolha de uma estratégia de implantação.

Se você tiver ativado o Gerenciamento de configurações após despejar as configurações, mova as variáveis SCD_* do estágio de implantação para o estágio de criação para ativar adequadamente a geração de conteúdo estático durante a fase de criação. Consulte Variáveis de ambiente.

Antes do Gerenciamento de Configuração:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...
    REDIS_USE_SLAVE_CONNECTION: 1

Depois de habilitar o Gerenciamento de Configuração:

Mova as variáveis SCD_* para o estágio de criação:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    REDIS_USE_SLAVE_CONNECTION: 1
  build:
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...

Procedimento para gerenciar suas configurações

A seguir, uma visão geral de alto nível desse processo:

Para configurar seu armazenamento e gerar um arquivo de configuração:

Depois que a implantação for concluída, faça logon no Admin do ambiente atualizado para verificar as configurações. Continue a mesclar todas as configurações adicionais com os ambientes de preparo e produção, conforme necessário.

Atualizar configurações

Quando você modifica seu ambiente por meio do Administrador e executa o comando novamente, novas configurações são anexadas ao código no arquivo config.php.

Restaurar arquivos de configuração

Cópias dos arquivos app/etc/env.php e app/etc/config.php originais foram criadas durante o processo de implantação e armazenadas na mesma pasta. O código a seguir mostra o BAK (arquivos de backup) e o PHP (arquivos originais) na mesma pasta app/etc:

...
config.php.bak
di.xml
env.php.bak
vendor_path.php
config.php
db_schema.xml
env.php
...

Configurações mais antigas usaram o arquivo app/etc/config.local.php. Consulte Migrar configurações mais antigas.

Para restaurar os arquivos de configuração:

Migrar configurações mais antigas

Se você atualizar para o Adobe Commerce na infraestrutura na nuvem 2.2 ou posterior, talvez queira migrar as configurações do arquivo config.local.php para o novo arquivo config.php. Se as configurações no Administrador corresponderem ao conteúdo do arquivo, siga as instruções para gerar e adicionar o arquivo config.php.

Se forem diferentes, você poderá anexar o conteúdo do arquivo config.local.php ao novo arquivo config.php:

Você só conclui essa migração uma vez. Após a migração, use o arquivo config.php.

Alterar localidades

Você pode alterar as localidades de armazenamento sem seguir um processo complexo de importação e exportação de configuração, se você tiver o SCD_ON_DEMAND habilitado. Você pode atualizar as localidades usando o Administrador.

Você pode adicionar outra localidade ao ambiente de preparo ou produção habilitando SCD_ON_DEMAND em uma ramificação de integração, gerar um arquivo config.php atualizado com as novas informações de localidade e copiar o arquivo de configuração para o ambiente de destino.