Documentação AEM Documentação do Cloud Manager para AEM 6.x

Adicionar um pipeline de não produção configuring-non-production-pipelines

Última atualização: 26 de março de 2026

Tópicos:
Cloud Manager

Criado para:

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

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.

NOTE

Você não pode configurar um pipeline até que seu repositório Git associado tenha pelo menos uma ramificação e a configuração do programa seja concluída. Consulte os Repositórios do Cloud Manager para saber como adicionar e gerenciar repositórios no Cloud Manager.

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.

Pipeline de qualidade de código - guia Configuração

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. A interface do usuário mostra as categorias de teste que o pipeline executa como parte da validação de qualidade do código. Teste de Código Estático - Analisa o código quanto a problemas de qualidade e correção. Teste de carga/desempenho - Avalia o comportamento relacionado ao desempenho como parte do teste de pipeline. Teste de segurança - Verifica o código e a saída do pipeline em busca de problemas relacionados à segurança.
Opções de implantação	Acionador da implantação	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.
	Comportamento de Falhas de Métricas Importantes	Perguntar sempre: esse comportamento é a configuração padrão e exige intervenção manual em qualquer falha importante. Falha imediata - 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 selecionado, o pipeline continuará automaticamente sempre que ocorrer uma falha importante. É basicamente semelhante a um usuário que aprova manualmente cada falha.
	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.

Pipeline de Implantação - Guia Configuração

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. A interface do usuário mostra as categorias de teste que o pipeline executa como parte da validação de qualidade do código. Teste de Código Estático - Analisa o código quanto a problemas de qualidade e correção. Teste de carga/desempenho - Avalia o comportamento relacionado ao desempenho como parte do teste de pipeline. Teste de segurança - Verifica o código e a saída do pipeline em busca de problemas relacionados à segurança.
Opções de implantação	Acionador da implantação	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.
	Comportamento de Falhas de Métricas Importantes	Perguntar sempre - A configuração padrão e solicita que o usuário decida como proceder quando uma métrica importante falhar. Falha imediata - O pipeline é cancelado sempre que uma métrica importante falha. É como emular um usuário que rejeita manualmente cada falha. Continuar imediatamente - O pipeline continua automaticamente sempre que uma métrica importante falha. É como emular um usuário que aprova manualmente cada falha.
	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 `Dispatcher`, faça o seguinte: Em PATH, forneça um caminho de conteúdo que você deseja que o pipeline limpe ou invalide. Em TIPO, selecione a ação a ser tomada nesse caminho. Liberar - Executa uma exclusão de cache no caminho especificado. Invalidar - Executa uma invalidação de cache, semelhante a quando o conteúdo é ativado de uma instância de criação para uma instância de publicação. Clique em Adicionar caminho para adicionar o caminho especificado. É possível adicionar até 100 caminhos por ambiente.
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.

Guia Código Source - Código de pilha completa

Implanta o aplicativo AEM completo, incluindo o código do aplicativo e, por padrão, a configuração no nível da Web.

note
NOTE
Se um pipeline de código de pilha completa já existir para o ambiente selecionado, essa seleção ficará desativada.

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	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. Importante : a Compilação Inteligente está disponível somente para pipelines de Qualidade de Código e pipelines de implantação de Código de Pilha Completa de Desenvolvimento.
	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.

Código Source - Configuração da Camada da Web

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.

note
NOTE
Se um pipeline de configuração no nível da Web já existir para o ambiente selecionado, essa seleção será desativada. Em um dado momento, somente pode haver um pipeline de configuração no nível da Web por ambiente.

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 (`/`).

note
NOTE
Se a Localização do código não apontar para a localização do código do Dispatcher, o código de aplicativo adicional pode ser extraído para o pacote de artefatos e implantado no Dispatcher, fazendo com que o Apache falhe na reinicialização e o pipeline falhe. Defina o caminho correto para os arquivos do dispatcher no 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.

NOTE

A primeira execução após a ativação da Compilação inteligente se comporta como uma Compilação completa porque o cache está vazio.

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-plugin ou maven-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

Problema

Soluções sugeridas

Os resultados da build são inconsistentes

· Desabilitar o cache para os módulos afetados.
· Verificar o comportamento do plug-in (especialmente exec/antrun plug-ins).

Sem melhoria de desempenho

· Verifique se várias execuções ocorreram (aquecimento de cache).
· Verifique se a maioria dos módulos está mudando com frequência.

Artefatos inesperados ou alterações ausentes

· Revise se se as alterações estão fora do rastreamento de dependência Maven.
· 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.

https://video.tv.adobe.com/v/327619?captions=por_br&learn=on

recommendation-more-help

experience-manager-cloud-manager-help-main-toc