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

Saiba como configurar pipelines de não produção para 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.

Pipelines de não produção non-production-pipelines

Além de pipelines de produção, que são implantados em ambientes de preparo e produção, também é possível configurar pipelines de não produção para validar seu código.

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 compilação e qualidade do código como os pipelines de qualidade do código, esses pipelines implantam o código em um ambiente de não produção.
NOTE
Você poderá editar as configurações do pipeline após a configuração inicial.

Adicionar um novo pipeline de não produção adding-non-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 não produção seguindo essas etapas.

  1. Entre no Cloud Manager em experience.adobe.com.

  2. Na seção Acesso rápido, clique em Experience Manager.

  3. No painel lateral esquerdo, clique em Cloud Manager.

  4. Selecione a organização desejada.

  5. No console Meus Programas, clique em um programa.

  6. Acesse o cartão Pipelines na tela inicial do Cloud Manager. Clique em +Adicionar e selecione Adicionar pipeline de não produção.

    Adicionar pipeline de não produção

  7. Na guia Configuração da caixa de diálogo Adicionar pipeline de não produção, selecione o tipo de pipeline de não produção que você deseja adicionar.

    • Pipeline de qualidade do código: cria um pipeline que gera o seu código, executa testes de unidade e avalia a qualidade do código; porém, ele NÃO realiza implantações.
    • Pipeline de implantação: cria um pipeline que gera o seu código, executa testes de unidade, avalia a qualidade do código e implanta em um ambiente.

    Caixa de diálogo Adicionar pipeline de não produção

  8. Forneça um Nome do pipeline de não produção para identificar o pipeline junto com as informações adicionais a seguir.

    • Acionador da implantação - Você tem as seguintes opções ao definir os acionadores de implantação para iniciar o pipeline.

      • Manual - Use essa opção para iniciar o pipeline manualmente.
      • Sobre alterações do Git - Essa opção 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.
  9. Se optar por criar um pipeline de implantação, você também precisará definir o comportamento de falha para métricas importantes.

    • 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. É como emular 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. É como emular um usuário que aprova manualmente cada falha.
  10. Clique em Continuar.

  11. Na guia Código fonte da caixa de diálogo Adicionar pipeline de não produção, você deve selecionar 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 não 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.

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.

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

Para concluir a configuração do pipeline de não produção do código de pilha completa, siga estas etapas.

  1. Na guia Código-fonte, você deve definir as opções a seguir.

    • Ambientes de implantação qualificados - Se o pipeline for um pipeline de implantação, você deve selecionar em quais ambientes ele deve ser implantado.
    • 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. Ela ajuda a encontrar as ramificações correspondentes que você pode selecionar.
    • 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.

    • Pipeline: se um pipeline de implantação for utilizado, você pode 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.

    Pipeline de pilha completa

  2. 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.

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 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
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.

As etapas para concluir a criação do pipeline de implantação de destino e não produção são as mesmas depois de escolher um tipo de implantação.

  1. Escolha o tipo de implantação necessário.

Opções de implantação direcionada

  1. 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.
  2. 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.
    • Pipeline - Para pipelines de não produção de front-end, você tem a opção de habilitar a Auditoria de experiência.

    Configurar pipeline

  3. 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.
  4. 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.

Ignorar pacotes do Dispatcher skip-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.

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. 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>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab