Adicionar um pipeline de não produção configuring-non-production-pipelines
Depois de configurar um programa e criar pelo menos um ambiente na interface do usuário do Cloud Manager, você pode adicionar pipelines de não produção. Esses pipelines permitem testar a qualidade do código antes de implantar em ambientes de produção.
Um usuário deve ter a função Gerente de Implantação para configurar pipelines de não produção.
Adicionar um novo pipeline de não produção adding-non-production-pipeline
Depois de configurar um programa e criar 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.
Para adicionar um novo pipeline de não produção:
-
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 painel lateral esquerdo, clique em Pipelines.
-
Na página Pipelines, próximo ao canto superior direito, clique em Adicionar pipeline > Adicionar pipeline de não produção.
-
Na guia Configuração da caixa de diálogo Adicionar pipeline de não produção, selecione um dos seguintes pipelines de não produção que deseja criar:
- Pipeline de Qualidade de Código - Cria um pipeline que cria o código em uma ramificação GIT, 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 de não produção.
-
Na seção Configuração de pipeline, no campo Nome do pipeline de não produção, digite uma descrição para o pipeline de não produção.
-
Na seção Opções de Implantação, selecione um dos seguintes disparadores de implantação que você deseja usar:
- Manual: permite iniciar manualmente o pipeline.
- Sobre alterações do Git: inicia o pipeline sempre que confirmações forem adicionadas à ramificação Git configurada. Com essa opção, ainda é possível iniciar o pipeline manualmente, conforme necessário.
-
Selecione o Comportamento de Falhas de Métricas Importantes que deseja usar.
- Perguntar sempre: esse comportamento é a configuração padrão e exige intervenção manual em qualquer falha importante.
- Falhar imediatamente: se selecionado, o pipeline será cancelado sempre que ocorrer uma falha importante. É basicamente semelhante a um usuário que rejeita manualmente cada falha.
- Continuar imediatamente: se essa opção for selecionada, o pipeline continuará automaticamente sempre que ocorrer uma falha importante. É basicamente semelhante a um usuário que aprova manualmente cada falha.
-
Clique em Continuar.
-
As etapas restantes que você usa para concluir a configuração do pipeline de não produção dependem do tipo de código-fonte que você escolher usar.
Na guia Código Source da caixa de diálogo Adicionar pipeline de não produção, selecione o tipo de código que o pipeline de não produção deve processar.Consulte Pipelines de CI/CD para obter mais informações sobre os tipos de pipelines.
Estou usando o 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 concluir a configuração do pipeline de não produção do código de pilha completa, faça o seguinte:
-
Na seção Código Source, defina as seguintes opções.
-
Ambientes de implantação qualificados - Disponível somente quando você edita um pipeline de não produção. Se o pipeline for um pipeline de implantação, você deverá selecionar em quais ambientes ele deve ser implantado.
-
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.
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 - 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 da Camada da Web caixa de seleção - Quando marcada, o pipeline não implanta sua configuração da camada da Web.
-
-
Na seção Pipeline, se o pipeline for um pipeline de implantação, você poderá optar por executar uma fase de teste. Marque as opções que deseja habilitar nesta fase. Se nenhuma das opções for selecionada, a fase de teste não será exibida durante a execução do pipeline.
- Teste funcional do produto - Execute testes funcionais do produto no ambiente de desenvolvimento.
- Teste funcional personalizado - Execute testes funcionais personalizados no ambiente de desenvolvimento.
- Teste de interface do usuário personalizada - Execute testes de interface do usuário personalizados para aplicativos personalizados.
- Auditoria de Experiência - Executar Auditoria de Experiência
-
Clique em Salvar.
O pipeline foi salvo e agora você pode [gerenciar seus pipelines](managing-pipe
lines.md) 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:
-
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 um pipeline de pilha completa já for implantado em um ambiente, você ainda poderá criar um pipeline de configuração no nível da Web para esse mesmo ambiente. Quando você faz isso, o Cloud Manager ignora a configuração no nível da Web no pipeline de pilha completa.
note note NOTE Os pipelines de nível da Web e de configuração não são compatíveis com repositórios privados. Consulte Adicionando repositórios privados no Cloud Manager para obter detalhes e a lista completa de limitações.
-
-
Na seção Código Source, defina as seguintes opções:
-
Repositório - Essa opção define de qual repositório GIT o pipeline de não produção 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.
-
-
Se você habilitou a Auditoria de Experiência, clique em Continuar para avançar para a guia Auditoria de Experiência, na qual será possível definir os caminhos que sempre devem ser incluídos na Auditoria de Experiência.
- Se você habilitou a Auditoria de experiência, consulte o documento Auditoria de experiência para obter detalhes sobre como configurar.
- Caso contrário, pule esta etapa.
-
Clique em Salvar para salvar o pipeline.
O pipeline é salvo e agora você pode gerenciar seus pipelines no cartão Pipelines na página Visão geral do programa.
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.
- 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 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 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.
Excluir pacotes do Dispatcher exclude-dispatcher-packages
Se quiser que os pacotes do Dispatcher sejam criados no pipeline, mas não forem carregados para criar armazenamento, desative a publicação. Isso pode reduzir o tempo de execução do pipeline.
Adicione a seguinte configuração ao arquivo pom.xml do projeto para desabilitar a publicação de pacotes do Dispatcher. Defina uma variável de ambiente no contêiner de compilação do Cloud Manager para sinalizar quando ignorar os pacotes do Dispatcher. O pipeline lê esse sinalizador e os ignora adequadamente.
<profile>
<id>only-include-dispatcher-when-it-isnt-ignored</id>
<activation>
<property>
<name>env.IGNORE_DISPATCHER_PACKAGES</name>
<value>!true</value>
</property>
</activation>
<modules>
<module>dispatcher</module>
</modules>
</profile>