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.

NOTE
Um pipeline de produção não pode ser configurado até que o seguinte tenha acontecido:
  • 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.

NOTE
Você poderá editar as configurações do pipeline após a configuração inicial.

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 não produção seguindo essas etapas.

TIP
Antes de configurar um pipeline de front-end, consulte a Jornada de Criação rápida de sites para AEM para obter um guia completo sobre a ferramenta simples de Criação rápida de sites para AEM. Esta jornada pode ajudá-lo a simplificar o desenvolvimento de front-end do seu site AEM, permitindo que você personalize seu site rapidamente sem conhecimento de back-end com AEM.
  1. Faça logon no Cloud Manager em my.cloudmanager.adobe.com e selecione a organização apropriada

  2. No console Meus Programas, selecione o programa.

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

    O cartão Pipelines na visão geral do Gerenciador de programas

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

    Configuração do pipeline de produção

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

Configurar um pipeline de 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 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 ficará desativada.

Para configurar um pipeline de código de pilha completa:

  1. 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 - Define de qual ramificação o pipeline selecionado deve recuperar o código.
      Insira os primeiros caracteres do nome da ramificação e o recurso de preenchimento automático deste campo localiza as ramificações correspondentes para ajudá-lo a 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.
    • 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.

    Código de pilha completa

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

    Adicionar auditoria de experiência

  3. Forneça caminhos a serem incluídos na Auditoria de experiência.

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

Configurar um pipeline de implantação direcionada targeted-deployment

Uma implantação direcionada implanta o código somente em 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 AEM.

    • Consulte Uso dos Pipelines de Configuração para obter uma lista de configurações com suporte, que inclui 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 tenham sido 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.
  • Código de front-end - Configure o JavaScript e o CSS para o front-end do 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.
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.

Para configurar um pipeline de implantação direcionada:

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

    Configurar pipeline

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

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>!true</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab