Adicionar um pipeline de produção configure-production-pipeline
Saiba como configurar pipelines de produção para compilar e implantar seu código em ambientes de produção. Um pipeline de produção primeiro implanta o código no ambiente de preparo. Na aprovação, ele implanta o mesmo código no ambiente de produção.
Um usuário deve ter a função Gerente de implantação para configurar pipelines de produção.
- O programa é criado.
- O repositório Git tem pelo menos uma ramificação.
- Os ambientes de produção e de preparo são criados.
Antes de começar a implantar seu código, defina as configurações de pipeline do Cloud Manager.
Adicionar um novo pipeline de produção adding-production-pipeline
Depois de configurar seu programa e ter pelo menos um ambiente usando a interface do usuário do Cloud Manager, você estará pronto para adicionar um pipeline de produção seguindo essas etapas.
-
Entre no Cloud Manager em experience.adobe.com.
-
Na seção Acesso rápido, clique em Experience Manager.
-
No painel lateral esquerdo, clique em Cloud Manager.
-
Selecione a organização desejada.
-
No console Meus Programas, clique em um programa.
-
No console Meus Programas, selecione o programa.
-
Navegue até o cartão Pipelines da página Visão geral do programa e clique em Adicionar para selecionar Adicionar pipeline de produção.
-
A caixa de diálogo Adicionar pipeline de produção será exibida. Forneça um Nome do pipeline para identificar o pipeline junto com as opções a seguir. Clique em Continuar.
Acionador da implantação - Você tem as seguintes opções ao definir os acionadores de implantação para iniciar o pipeline.
- Manual - Iniciar o pipeline manualmente.
- Sobre Alterações do Git - Inicia o pipeline de CI/CD sempre que confirmações são adicionadas à ramificação Git configurada. Com essa opção, ainda é possível iniciar o pipeline manualmente, conforme necessário.
Comportamento de falhas importantes da métrica - Durante a configuração ou edição do pipeline, o Gerente de implantação tem a opção de definir o comportamento do pipeline quando uma falha importante é encontrada em qualquer um dos quality gates (portais de qualidade). As opções disponíveis são:
- Perguntar sempre - Configuração padrão. Requer intervenção manual em qualquer falha importante.
- Falhar imediatamente: se selecionado, o pipeline será cancelado sempre que ocorrer uma falha importante. Esse processo é basicamente semelhante a um usuário que rejeita manualmente cada falha.
- Continuar imediatamente - Se selecionado, o pipeline continuará automaticamente sempre que ocorrer uma falha importante. Esse processo é basicamente semelhante a um usuário que aprova manualmente cada falha.
-
Na guia Código Source, selecione o tipo de código que o pipeline deve processar.
Consulte Pipelines de CI/CD para obter mais informações sobre os tipos de pipelines.
As etapas para concluir a criação do pipeline de produção variam de acordo com o tipo de código-fonte selecionado. Siga os links acima para acessar a próxima seção deste documento e concluir a configuração do pipeline.
Estou usando um código de pilha completa full-stack-code
Um pipeline de código de pilha completa implanta simultaneamente compilações de código de back-end e front-end contendo um ou mais aplicativos de servidor do AEM, juntamente com a configuração HTTPD/Dispatcher.
Para configurar um pipeline de código de pilha completa:
-
Na guia Código Source, defina as seguintes opções.
- Repositório - Define de qual repositório Git o pipeline deve recuperar o código.
note tip TIP Consulte Adicionar e gerenciar repositórios para saber como adicionar e gerenciar repositórios no Cloud Manager. -
Ramificação Git - Na lista suspensa, escolha de qual ramificação o pipeline deve compilar no repositório selecionado. O padrão é
main. O pipeline usa a ramificação escolhida como origem para a compilação e a implantação. Se necessário, clique em Atualizar para atualizar a lista de ramificações disponíveis para o repositório selecionado. Use esta opção se uma ramificação criada recentemente não aparecer na lista. -
Estratégia de compilação
-
Compilação Completa - Cria todos os módulos no repositório sempre
-
BETA Compilação Inteligente - Compila apenas módulos que foram alterados desde a última confirmação.
Saiba mais sobre como usar o Smart Build em um pipeline de não produção.note important IMPORTANT O Smart Build está disponível somente para pipelines de Qualidade do código e pipelines de implantação do Código de pilha completa de desenvolvimento. * **Ignorar configuração no nível da Web**: quando essa opção está marcada, o pipeline não implanta sua configuração no nível da Web.
-
-
Pausar antes de implantar na Produção - Pausa o pipeline antes de implantar na produção.
-
Agendado - Permite que o usuário habilite a implantação de produção agendada.
-
Clique em Continuar para avançar para a guia Auditoria de experiência, na qual é possível definir os caminhos que devem ser sempre incluídos na Auditoria de experiência.
-
Forneça caminhos a serem incluídos na Auditoria de experiência.
- Consulte Teste de auditoria de experiência para obter detalhes.
-
Clique em Salvar para salvar o pipeline.
Quando o pipeline é executado, os caminhos configurados para a Auditoria de experiência são enviados e avaliados com base em desempenho, acessibilidade, SEO, práticas recomendadas e testes do PWA. Para obter mais detalhes, consulte Noções básicas sobre os resultados da auditoria de experiência.
O pipeline é salvo e agora você pode gerenciar seus pipelines no cartão Pipelines na página Visão geral do programa.
Estou usando a implantação direcionada targeted-deployment
Uma implantação direcionada implanta o código somente para partes selecionadas do aplicativo AEM. Nessa implantação, você pode optar por Incluir um dos seguintes tipos de código:
-
Configuração - Defina as configurações de vários recursos no seu ambiente do AEM.
- Consulte Uso dos Pipelines de Configuração para obter uma lista de configurações com suporte, que incluem encaminhamento de logs, tarefas de manutenção relacionadas à limpeza e várias configurações de CDN, além de gerenciá-las no repositório para que sejam implantadas corretamente.
- Ao executar um pipeline de implantação direcionada, as configurações são implantadas, desde que sejam salvas no ambiente, repositório e ramificação definidos no pipeline.
- Em um dado momento, somente pode haver um pipeline de configuração por ambiente.
-
Configurar pipeline de configuração do Edge Delivery Services - Os Pipelines de Configuração do Edge Delivery não têm ambientes de desenvolvimento, preparo e produção separados. No AEM as a Cloud Service, as alterações percorrem níveis de desenvolvimento, preparo e produção. Por outro lado, um Pipeline de configuração do Edge Delivery aplica sua configuração diretamente a todos os domínios do Edge Delivery Sites registrados no Cloud Manager. Para saber mais, consulte Adicionar um pipeline de Edge Delivery.
-
Código de front-end - Configure o JavaScript e o CSS para o front-end do seu aplicativo AEM.
- Com os pipelines de front-end, é dada mais independência aos desenvolvedores de front-end e o processo de desenvolvimento pode ser acelerado.
- Consulte o documento Desenvolvimento de sites com o pipeline de front-end para saber como esse processo funciona, além de algumas considerações a serem feitas para aproveitar ao máximo o potencial desse processo.
-
Configuração da Camada da Web - Configure as propriedades do Dispatcher para armazenar, processar e entregar páginas da Web ao cliente.
- Consulte o documento Pipelines de CI/CD para obter mais detalhes.
- Se existir um pipeline de código da Web para o ambiente selecionado, essa seleção será desabilitada.
- Se você criar um pipeline de configuração no nível da Web para um ambiente com um pipeline de pilha completa existente, a configuração no pipeline de pilha completa será ignorada. Essa alteração afeta somente a configuração no nível da Web nesse ambiente.
Para configurar um pipeline de implantação direcionada:
- Escolha o tipo de implantação necessário.
-
Defina os Ambientes de implantação qualificados.
- Se o pipeline for um pipeline de implantação, você deverá selecionar em quais ambientes ele deve ser implantado.
-
Em Source Code, defina as seguintes opções:
- Repositório: essa opção define de qual repositório Git o pipeline deve recuperar o código.
note tip TIP Consulte Adição e gerenciamento de repositórios para saber como adicionar e gerenciar repositórios no Cloud Manager. - Ramificação Git: essa opção define de qual ramificação o pipeline selecionado deve recuperar o código.
- Insira os primeiros caracteres do nome da ramificação e utilize o preenchimento automático deste campo. O recurso encontra as ramificações correspondentes que você pode selecionar.
- Localização do código - Essa opção define o caminho na ramificação do repositório selecionado do qual o pipeline deve recuperar o código.
- Pausar antes de implantar na produção - Essa opção pausa o pipeline antes de implantar na produção.
- Agendado - Permite que o usuário habilite a implantação de produção agendada. Disponível somente para implantações direcionadas no nível da Web.
-
Clique em Salvar.
O pipeline é salvo e agora você pode gerenciar seus pipelines no cartão Pipelines na página Visão geral do programa.
BETA: sobre o uso do Smart Build em um pipeline de produção about-smart-build-production-pipeline
A Compilação Inteligente do Cloud Manager é uma estratégia de compilação otimizada para pipelines de produção. O Smart Build reduz os tempos de criação ao armazenar em cache módulos e recriar apenas os módulos que foram alterados desde a última execução bem-sucedida. Os módulos inalterados são reutilizados do cache, enquanto apenas os módulos modificados e suas dependências são recriados, melhorando a eficiência dos workflows de desenvolvimento iterativos.
O Smart Build é recomendado quando você tem o seguinte:
- Você está desenvolvendo e confirmando ativamente alterações incrementais frequentes.
- Seu projeto contém vários módulos Maven.
- As compilações completas estão demorando muito.
O Smart Build nem sempre é ideal quando você tem o seguinte:
- Sua build depende muito de plug-ins que executam operações fora do gráfico de dependência do Maven.
- Você precisa da validação completa de reconstrução em cada execução.
Entender o desempenho da build smart-build-performance
O ganho de desempenho com o uso do Smart Build depende de vários fatores, incluindo os seguintes:
- O número de módulos no projeto.
- A frequência e o escopo das alterações de código.
- A distribuição de dependências entre módulos.
Geralmente, projetos com muitos módulos independentes podem ver a maior melhoria.
Recusa de cache por módulo smart-build-cache-optout
O Smart Build fornece controle refinado que permite desativar o armazenamento em cache de módulos específicos. Essa capacidade é útil quando determinados módulos:
- Use plug-ins, como
exec-maven-pluginoumaven-antrun-plugin. - Executar operações de arquivo não rastreadas pelas dependências do Maven.
- O conteúdo em cache produz resultados inconsistentes.
Desativar armazenamento em cache para um módulo smart-build-disable-caching
Você pode adicionar a seguinte propriedade ao pom.xml do módulo afetado:
<properties>
<maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>
Essa sintaxe força o módulo a ser recriado em cada execução de pipeline, enquanto outros módulos continuam a se beneficiar do armazenamento em cache.
Limitações e considerações ao usar o Smart Build smart-build-limitations
Lembre-se do seguinte ao usar o Smart Build:
- O Smart Build depende da análise de dependência do Maven.
- As alterações fora do gráfico de dependência não podem acionar recriações.
- Alguns plug-ins podem não ser totalmente compatíveis com o armazenamento em cache.
- Você pode voltar para a Compilação completa a qualquer momento editando o pipeline de produção.
Se você encontrar um comportamento de compilação inesperado, considere desabilitar o cache de módulos específicos ou alternar temporariamente sua estratégia de compilação para Compilação Completa.
Solução de problemas do Smart Build smart-build-troubleshoot
· Verificar comportamento do plug-in (especialmente
exec/antrun plug-ins).· Verifique se a maioria dos módulos está mudando com frequência.
· Use Compilação Completa para verificação.
Consulte Adicionar um pipeline de produção para habilitar o Smart Build.
Ignorar pacotes do Dispatcher skip-dispatcher-packages
Para criar pacotes do Dispatcher no pipeline sem publicá-los para criar armazenamento, você pode desativar a opção de publicação. Isso pode ajudar a reduzir o tempo de execução do pipeline.
A configuração a seguir para desabilitar a publicação de pacotes do Dispatcher deve ser adicionada por meio do arquivo de projeto pom.xml. Uma variável de ambiente serve como um sinalizador definido no contêiner de criação do Cloud Manager para determinar quando ignorar os pacotes do Dispatcher.
<profile>
<id>only-include-dispatcher-when-it-isnt-ignored</id>
<activation>
<property>
<name>env.IGNORE_DISPATCHER_PACKAGES</name>
<value>[!NOTE]rue</value>
</property>
</activation>
<modules>
<module>dispatcher</module>
</modules>
</profile>