Adicionar um pipeline de não produção configuring-non-production-pipelines
Saiba como usar o Cloud Manager para criar e configurar pipelines de não produção para implantar seu código. Se desejar começar com uma visão geral mais conceitual de como funcionam os pipelines no Cloud Manager, consulte Pipelines de CI/CD.
Visão geral overview
Ao usar o bloco Pipelines no Cloud Manager, o Gerenciador de implantação pode criar dois tipos diferentes de pipelines.
- Pipelines de produção - Um pipeline de produção é composto por uma série de etapas orquestradas que têm o objetivo de levar o código-fonte até a produção.
- Pipelines de não produção - um pipeline não relacionado à produção serve principalmente para executar verificações de qualidade de código ou implantar o código-fonte em um ambiente de desenvolvimento.
Este documento se concentra em pipelines de não produção. Para mais detalhes sobre como configurar pipelines de produção, consulte o documento Configuração de pipelines de produção.
Existem dois tipos de pipelines de não produção:
- Pipelines de qualidade do código: executam verificações de qualidade de código em uma ramificação do Git e executam as etapas de qualidade de código e de criação.
- Pipelines de implantação: além de executar as etapas de qualidade de código de criação como os pipelines de qualidade do código, esses pipelines implantam o código em um ambiente de não produção.
Adicionar um novo pipeline de não produção add-non-production-pipeline
Depois de configurar um programa e pelo menos um ambiente na interface do usuário do Cloud Manager, você pode adicionar pipelines de não produção. Use esses pipelines para testar a qualidade do código antes de implantar em ambientes de produção.
-
Faça logon no Cloud Manager em my.cloudmanager.adobe.com e selecione a organização e o programa apropriados.
-
Na tela inicial do Cloud Manager, abra o cartão Pipelines e clique em Adicionar e selecione Adicionar pipeline de não produção.
-
Na guia Configuração da caixa de diálogo Adicionar pipeline de não produção, selecione o tipo de pipeline que deseja criar, uma das seguintes opções:
- Pipeline de Qualidade do Código - Cria um pipeline que compila o código, executa testes de unidade e avalia a qualidade do código sem implantar em um ambiente.
- Pipeline de Implantação - Cria um pipeline que compila o código, executa testes de unidade, avalia a qualidade do código e realiza a implantação em um ambiente.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Seção | Opção | Descrição |
| Configuração de pipeline | Nome do pipeline de não produção | Insira uma descrição para o pipeline no campo Nome do pipeline de não produção. |
| Testando |
Visível somente ao editar um pipeline de não produção.
|
|
| Opções de implantação | Acionador da implantação |
|
| Comportamento de Falhas de Métricas Importantes |
|
|
| Aprovar após a caixa de seleção Implantação de Preparo | Visível somente ao editar um pipeline de não produção. Selecione esta opção para exigir aprovação após a implantação no ambiente de preparo, antes que o pipeline possa continuar. Se essa opção não estiver selecionada, o pipeline continuará com base no comportamento configurado. |
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 | ||
|---|---|---|
| Seção | Opção | Descrição |
| Configuração de pipeline | Nome do pipeline de não produção | Insira uma descrição para o pipeline no campo Nome do pipeline de não produção. |
| Ambiente de Implantação Qualificado | Se o pipeline for um pipeline de implantação, você deverá selecionar quais ambientes o Cloud Manager implanta o código. | |
| Testando |
Visível somente ao editar um pipeline de não produção.
|
|
| Opções de implantação | Acionador da implantação |
|
| Comportamento de Falhas de Métricas Importantes |
|
|
| Aprovar após a caixa de seleção Implantação de Preparo | Visível somente ao editar um pipeline de não produção. Selecione esta opção para exigir aprovação após a implantação no ambiente de preparo, antes que o pipeline possa continuar. Se essa opção não estiver selecionada, o pipeline continuará com base no comportamento configurado. |
|
| Ignorar alterações no Balanceador de Carga | Selecione esta opção para impedir que o pipeline faça alterações no balanceador de carga durante a implantação. | |
| Configuração do Dispatcher |
O Gerenciador de Implantação pode configurar um conjunto de caminhos de conteúdo que são invalidados ou removidos do cache do AEM Dispatcher quando um pipeline é executado. O Cloud Manager executa essas ações de cache como parte da etapa do pipeline de implantação, logo após a implantação de qualquer pacote de conteúdo. Essas configurações usam o comportamento padrão do Dispatcher do AEM. Para configurar o
|
|
| Pipeline | Caixa de seleção Auditoria de experiência | Selecione essa opção para incluir uma etapa da Auditoria de experiência no pipeline. Quando ativado, o pipeline inclui a etapa Auditoria de experiência após a guia Código Source. |
- No canto inferior direito da caixa de diálogo Adicionar pipeline de não produção, clique em Continuar.
- Selecione o tipo de código que o pipeline está configurado para criar e implantar.
Implanta o aplicativo AEM completo, incluindo o código do aplicativo e, por padrão, a configuração no nível da Web.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Seção | Opção | Descrição |
| código Source | Repositório | Na lista suspensa, escolha o repositório Git que o pipeline usa como origem. O Cloud Manager cria código a partir do repositório escolhido aqui. |
| Ramificação Git | Na lista suspensa, escolha em qual ramificação o pipeline deve ser criado 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 |
|
|
| Ignorar a caixa de seleção Configuração da Camada da Web | Selecione esta opção para ignorar a implantação da configuração no nível da Web em um pipeline de código de Empilhamento completo. Deixe a opção desmarcada para implantar a configuração no nível da Web junto com o código do pipeline. | |
| Pipeline | Caixa de seleção Auditoria de experiência | Selecione essa opção para incluir uma etapa da Auditoria de experiência no pipeline. Quando ativado, o pipeline inclui a etapa Auditoria de experiência após a guia Código Source. |
Implanta apenas a configuração no nível da Web, como propriedades do Dispatcher usadas para armazenar, processar e entregar páginas da Web ao cliente. Ao selecionar Configuração da camada da Web, o Cloud Manager cria um pipeline dedicado à implantação da configuração da camada da Web.
Se um pipeline de pilha completa já existir, o Cloud Manager exibe um aviso de que a criação de um pipeline de configuração no nível da Web faz com que o pipeline de pilha completa existente ignore a configuração no nível da Web. Depois de criar o pipeline de configuração no nível da Web, o Cloud Manager gerencia as implantações de configuração no nível da Web por meio desse pipeline, em vez do pipeline de pilha completa.
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| Seção | Opção | Descrição |
| código Source | Repositório | Na lista suspensa, selecione o repositório Git que contém a configuração no nível da Web. |
| Ramificação Git | Selecione a ramificação no repositório escolhido que o Cloud Manager usa para 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. | |
| Localização do código | Insira o caminho no repositório selecionado que contém a configuração da camada da Web a ser implantada. O local padrão é a raiz do repositório (/). |
- Clique em Salvar.
Sobre o uso do Smart Build em um pipeline de não produção about-smart-build
A Compilação Inteligente do Cloud Manager é uma estratégia de compilação otimizada para pipelines de não 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.
No momento, o Smart Build está disponível apenas para o seguinte:
- Pipelines de qualidade do código.
- Desenvolva pipelines de implantação de pilha completa.
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.
- Produza resultados inconsistentes quando armazenados em cache.
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 não 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 o 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 não produção para habilitar o Smart Build.
Próximas etapas the-next-steps
Depois de configurar o pipeline, você pode implantar seu código. Consulte Implantação de código para obter mais detalhes.
Tutorial em vídeo video-tutorial
Este vídeo fornece uma visão geral do processo de criação de pipeline, que é detalhado neste documento.