Fluxo de trabalho do projeto inicial

A infraestrutura do Adobe Commerce na nuvem inclui um único repositório Git com uma ramificação master para o ambiente de produção que pode ser ramificada para criar um ambiente de preparo e vários ambientes de integração para trabalho de teste e desenvolvimento. Você pode ter até quatro ambientes ativos, incluindo um ambiente master para seu servidor de produção. Consulte Arquitetura inicial para obter uma visão geral.

Para seus ambientes, siga o fluxo de trabalho do Development > Staging > Production para desenvolver e implantar seu site.

Para suas filiais, você pode seguir qualquer metodologia de desenvolvimento. Por exemplo, você pode seguir uma metodologia Agile, como scrum, para criar ramificações para cada sprint.

Em cada sprint, é possível criar ramificações para cada história de usuário. Todas as histórias se tornam testáveis. Você pode mesclar continuamente para a ramificação sprint e validar essa ramificação continuamente. Quando o sprint terminar, você poderá mesclar a ramificação do sprint com master para implantar todas as alterações do sprint na produção sem precisar lidar com um afunilamento de teste.

Fluxo de trabalho de desenvolvimento

O desenvolvimento e a implantação nos planos iniciais começam com seu projeto inicial. Você cria seu projeto com o "site em branco", que é um repositório de código de modelo do Adobe Commerce na infraestrutura em nuvem com uma loja totalmente preparada. Isso cria uma ramificação master com uma cópia do código do seu ambiente de produção.

O fluxo de trabalho de desenvolvimento inclui o seguinte:

Você também tem algumas etapas opcionais para ajudar a desenvolver e testar seu código e seus dados de loja:

Este processo pressupõe que você tenha configurado seu espaço de trabalho de desenvolvedor local.

Clonar e ramificar

Para um novo projeto do Plano Inicial, uma ramificação master foi clonada do repositório Git da infraestrutura em nuvem do Adobe Commerce. Para começar a ramificar e trabalhar com código, clone a ramificação master no ambiente local.

O formato do comando clone do Git é:

git fetch origin

git pull origin <environment-ID>

Na primeira vez que você começar a trabalhar em ramificações para o seu projeto inicial, crie uma ramificação staging. Isso cria uma ramificação de código correspondente à ramificação master que é implantada em um ambiente de preparo para testar a configuração e as alterações de código antes da implantação no ambiente de produção.

Em seguida, crie ramificações a partir do staging para desenvolver código, adicionar extensões e configurar integrações de terceiros. Sempre que você desenvolver um código personalizado, adicionar extensões, integrar a um serviço de terceiros, trabalhar em uma ramificação de desenvolvimento criada a partir da ramificação staging. Você tem quatro ambientes de integração ativos disponíveis. Ao enviar uma ramificação ativa, um desses ambientes de integração implanta automaticamente seu código para teste.

O formato do comando da ramificação Git é:

git checkout <branch-name>

O formato do comando branch da CLI da Nuvem é:

magento-cloud environment:branch <environment-name> <parent-environment-ID>

Desenvolver código

Usando a ramificação base do Adobe Commerce no código de infraestrutura em nuvem, você pode começar a instalar extensões, desenvolver código personalizado, adicionar temas e muito mais.

Use uma estratégia de ramificação com seu trabalho de desenvolvimento. Usar uma ramificação para fazer todo o seu trabalho de uma só vez pode dificultar os testes. Por exemplo, você pode seguir as metodologias de integração contínua e sprint para funcionar:

Até que sua loja esteja totalmente criada, configurada e pronta para ser iniciada. Mas continue lendo: há muitas opções para sua loja e configuração de código.

Configurar loja

Quando estiver pronto para configurar o armazenamento, envie todo o código para o ambiente integration. Defina as configurações de armazenamento do Administrador para o ambiente de integração, não em seu ambiente local. Você pode encontrar a URL clicando em Acessar site no Cloud Console

Para obter as melhores informações sobre configurações, consulte a documentação do Adobe Commerce e as extensões instaladas. Estes são alguns links e ideias que ajudam você a começar:

Além das configurações de loja, você pode configurar vários sites e lojas, serviços configurados e muito mais. Consulte Configurar armazenamento.

Gerar arquivos de gerenciamento de configuração

Se você estiver familiarizado com o Adobe Commerce, poderá se preocupar com a forma de fazer com que as definições de configuração do banco de dados em desenvolvimento cheguem aos ambientes de preparo e produção. Anteriormente, você tinha que copiar todas as suas configurações no papel ou em um arquivo e aplicar manualmente as configurações a outros ambientes. Ou você pode ter descarregado seu banco de dados e enviado esses dados para outro ambiente.

O Adobe Commerce na infraestrutura em nuvem fornece um conjunto de dois comandos do Gerenciamento de Configuração que exportam as definições de configuração do seu ambiente para um arquivo. Estes comandos só estão disponíveis para o Adobe Commerce na infraestrutura de nuvem 2.2 e posterior.

Arquivo gerado app/etc/config.php.

Gere o arquivo no ambiente de integração em que você configurou o Adobe Commerce. Percorra o processo de geração do arquivo, adicionando-o à ramificação e implantando-o.

Observações importantes sobre o Gerenciamento de Configurações:

Se você estiver usando o Adobe Commerce versão 2.2 ou posterior, os comandos de gerenciamento de configuração fornecerão um recurso adicional para proteger dados confidenciais, como credenciais de sandbox para um módulo do PayPal. Durante o processo de exportação, todos os valores que contêm dados confidenciais são exportados para um arquivo de configuração separado—env.php no diretório app/etc/. Esse arquivo permanece no ambiente local e não é copiado quando você envia seu código para outra ramificação. Você também pode criar variáveis de ambiente com comandos CLI em todas as versões do Adobe Commerce na infraestrutura em nuvem.

Consulte Gerenciamento de Configuração.

Enviar código e testar

Neste ponto, você deve ter uma ramificação de código desenvolvida com um arquivo de configuração (config.local.php ou config.php) pronto para teste.

Toda vez que você envia código de seu ambiente local, uma série de scripts de criação e implantação é executada. Esses scripts geram novo código e o implantam no ambiente remoto. Por exemplo, se você estiver enviando uma ramificação de desenvolvimento do seu ambiente local para a ramificação remota, um ambiente correspondente atualizará serviços, código e conteúdo estático.

Você pode acessar diretamente esse ambiente com um URL de armazenamento, URL de administração e SSH. Esses ambientes incluem um servidor Web, um banco de dados e serviços configurados. Quando estiver pronto, você poderá começar a implantar e testar no ambiente de preparo.

Para obter mais informações, consulte Fluxo de trabalho de implantação.

Opcional: instalar dados de amostra

Se você precisar de alguns dados de exemplo ao desenvolver sua loja, poderá instalar dados de amostra. Esses dados simulam uma loja ativa, incluindo clientes, produtos e outros dados. Esses dados de amostra funcionam melhor com um Adobe Commerce de "site em branco" na instalação do modelo de infraestrutura na nuvem ao criar seu projeto. Como prática recomendada, remova os dados de amostra antes de entrar em funcionamento. Consulte Instalar dados de amostra opcionais.

Opcional: Extrair dados de produção

Adicione todos os seus produtos, catálogos, conteúdo do site e assim por diante, diretamente ao ambiente production. Ao adicionar esses dados ao ambiente de produção, você pode fornecer preços atualizados, cupons, estoque de estoque, anúncios de vendas, informações sobre ofertas futuras e muito mais para seus clientes. Esses dados não incluem configurações de extensão, que você configura na ramificação de desenvolvimento local.

À medida que você desenvolve recursos, adiciona extensões e temas de design, ter dados reais para trabalhar é útil. A qualquer momento, você pode criar um despejo do banco de dados a partir do ambiente de produção e enviá-lo por push para seus ambientes de Preparo e integração, conforme necessário.

Para ajudar a exportar dados de produção como dados de teste para uso em ambientes de preparo e integração:

Para migrar esses dados, consulte Migrar e implantar arquivos e dados estáticos.

Fluxo de trabalho de implantação

Conforme detalhado nas informações da arquitetura, a infraestrutura do Adobe Commerce na nuvem é orientada pelo Git. A implantação do Adobe Commerce na infraestrutura em nuvem faz parte dos processos de push do Git para ramificações.

Ao enviar o código ramificado do ambiente local para a ramificação remota, uma série de scripts de criação e implantação é iniciada.

Criar scripts:

Implantar scripts:

Quando estiver totalmente concluída, sua loja volta a ficar online, ao vivo, com todos os seus códigos e configurações atualizados.

Consulte Processo de implantação.

Encaminhar para Preparo e testar

Sempre envie seu código em iterações para o ambiente staging para testes completos. Na primeira vez que você usar este ambiente, deverá configurar alguns serviços, incluindo o Fastly e o New Relic. Além disso, configure gateways de pagamento, envio, notificações e outros serviços vitais com sandbox ou credenciais de teste.

O armazenamento temporário é um ambiente de pré-produção que fornece todos os serviços e configurações o mais próximo possível da produção. Teste minuciosamente cada serviço, verifique suas ferramentas de teste de desempenho, execute o teste de UAT como administrador e como cliente, até sentir que sua loja está pronta para produção.

Consulte Implantar seu armazenamento.

Encaminhar para produção

Ao enviar para a ramificação master, você está enviando para o ambiente production. Conclua as atividades de configuração e teste no ambiente de produção da mesma forma que fazia no ambiente de preparo, com uma diferença importante. No ambiente de produção, use credenciais ativas para configuração e teste. No momento em que você inicia o site, os clientes podem concluir as compras e os administradores podem gerenciar a loja ao vivo.

Consulte Implantar seu armazenamento.

Lançamento do site

Há uma apresentação clara para colocar seu site no ar. Depois de concluir essas etapas, sua loja pode entregar produtos em seu tema personalizado para venda imediatamente.

Consulte Inicialização do site.

Integração contínua

Seguindo suas metodologias de ramificação e desenvolvimento, você pode desenvolver facilmente novos recursos, configurar alterações e adicionar extensões para desenvolver e implantar atualizações continuamente.

Todos os ambientes de infraestrutura em nuvem oferecem suporte à integração contínua para atualizações constantes. Esse fluxo de trabalho suporta versões várias vezes por dia ou em uma programação definida de acordo com suas necessidades comerciais.