Práticas recomendadas de implantação

Planos iniciais — Para o ambiente de integração, cada ramificação ativa cria e implanta em um ambiente completo para acesso e teste. Teste todo o código depois de mesclar com a ramificação staging. Para iniciar seu site, envie staging por push para master para implantar no ambiente de Produção. Você tem acesso total a todas as ramificações por meio dos comandos Cloud Console e CLI.

Planos profissionais—Para o ambiente de integração, cada ramificação ativa cria e implanta em um ambiente completo para acesso e teste. Mescle o código na ramificação integration antes de mesclar com os ambientes de preparo e produção. Você pode mesclar com os ambientes de Preparo e Produção usando o Cloud Console ou usando comandos SSH e CLI do magento-cloud.

Verifique se você está executando a versão mais recente do pacote ece-tools

Consulte as Notas de versão para ECE-Tools.

Siga o processo de compilação e implantação

Verifique se você tem o código correto em cada ambiente para evitar a substituição de configurações ao mesclar código entre ambientes. Por exemplo, para aplicar alterações de configuração a todos os ambientes, modifique e teste as alterações no ambiente local antes de implantar no ambiente de integração remota. Em seguida, implante e teste as alterações no ambiente de preparo antes de implantar na produção. Quando você mescla de um ambiente para outro, a implantação substitui todo o código no ambiente, exceto as configurações específicas do ambiente.

Usar as mesmas variáveis entre ambientes

Os valores dessas variáveis podem diferir entre os ambientes; no entanto, normalmente são necessárias as mesmas variáveis em cada ambiente. Consulte Gerenciamento de configurações para configurações de armazenamento.

Manter valores e dados confidenciais de configuração em variáveis específicas do ambiente

Esses valores incluem variáveis especificadas usando a CLI da Nuvem, o Cloud Console ou adicionadas ao arquivo env.php. Consulte Níveis de variáveis.

Verifique se todo o código está disponível na ramificação do ambiente

Fazer referência ao código de outras ramificações, como uma ramificação privada, pode causar problemas durante o processo de compilação e implantação. Por exemplo, se você fizer referência a um tema de uma ramificação privada, ele não estará acessível e não poderá ser criado com o código do aplicativo.

Adicionar extensões, integrações e código em ramificações iteradas

Fazer e testar as alterações localmente, enviar para integration, depois para staging e production. Teste e resolva os problemas em cada ambiente antes de mesclar as atualizações com o próximo ambiente. Algumas extensões e integrações devem ser ativadas e configuradas em uma ordem específica devido às dependências. Adicionar e testar em grupos pode tornar o processo de criação e implantação muito mais fácil e ajudar a determinar onde ocorrem problemas.

Verifique as versões e relações do serviço e a capacidade de conexão

Verifique os serviços disponíveis para seu aplicativo e certifique-se de que você esteja usando a versão mais atual e compatível. Consulte Relacionamentos de serviço e Requisitos do sistema no Guia de instalação para obter as versões recomendadas.

Testar localmente e no ambiente de integração antes de implantar em Preparo e Produção

Identifique e corrija problemas em seus ambientes locais e de integração para evitar um tempo de inatividade prolongado ao implantar em ambientes de preparo e produção.

Após concluir o teste em ambientes locais e de integração, implante e teste no ambiente de preparo

Consulte Teste de preparo e produção.

Verificar configuração do ambiente de Produção

Antes de implantar na produção, conclua as seguintes tarefas:

• Verifique se você pode se conectar a todos os três nós no ambiente de Produção usando o SSH.

• Verifique se os Indexadores estão definidos como Atualizar na Agenda. Consulte Modos de indexação no Guia de Desenvolvedor de Extensão.

• Prepare o ambiente atualizando quaisquer variáveis específicas do ambiente no código de Produção, verificando a disponibilidade e a compatibilidade do serviço e fazendo quaisquer outras alterações de configuração necessárias.

Monitorar o processo de implantação

Revise as mensagens de status da implantação e reduza os problemas conforme necessário. Revise os logs da nuvem para obter mensagens de log detalhadas.

Se o Adobe Commerce estiver não instalado, ele será instalado com bin/magento setup:install, atualizará a configuração de implantação, app/etc/env.php, e o banco de dados para seu ambiente especificado, como Redis e URLs de sites. Importante: quando você concluiu a Primeira implantação durante a instalação, o Adobe Commerce foi instalado e implantado em todos os ambientes.

Se o Adobe Commerce estiver instalado, faça as atualizações necessárias. O script de implantação executa o bin/magento setup:upgrade para atualizar o esquema e os dados do banco de dados (o que é necessário após atualizações de extensão ou de código principal) e também atualiza a configuração de implantação, app/etc/env.php, e o banco de dados para o seu ambiente. Finalmente, o script de implantação limpa o cache do Adobe Commerce.

O script gera opcionalmente conteúdo estático da Web usando o comando magento setup:static-content:deploy.

Usa escopos (-s sinalizador em scripts de compilação) com uma configuração padrão de quick para estratégia de implantação de conteúdo estático. Você pode personalizar a estratégia usando a variável de ambiente SCD_STRATEGY. Para obter detalhes sobre essas opções e recursos, consulte Estratégias de implantação de arquivos estáticos e o sinalizador -s para Implantar arquivos de exibição estáticos.