Configuração de um pipeline de produção

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 e, após a aprovação, 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.

Antes de começar a implantar seu código, você deve definir as configurações de pipeline no Cloud Manager.

Adição de um novo pipeline de produção

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. Faça logon no Cloud Manager em my.cloudmanager.adobe.com e selecione a organização e o programa apropriado.

2. Navegue até o cartão Pipelines na página Visão geral do programa e clique em Adicionar para selecionar Adicionar pipeline de produção.

   

3. 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 - Use essa opção para iniciar manualmente o pipeline.
   • Quando o Git é alterado - Essas opções iniciam 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:

   • Sempre perguntar - Essa é a configuração padrão e requer 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 selecionado, o pipeline continuará automaticamente sempre que ocorrer uma falha importante. É como emular um usuário que aprova manualmente cada falha.

   

4. Na guia Código-fonte, é necessário definir de onde o pipeline deve recuperar o código e o tipo de código.

   • Código de front-end
   • Código de pilha completa
   • Configuração no nível da Web

As etapas para concluir a criação do pipeline de produção variam de acordo com a opção de Código-fonte que você selecionou. Siga os links acima para ir até a próxima seção deste documento para concluir a configuração do pipeline.

Código de front-end

Um pipeline de código front-end implanta compilações de código de front-end contendo um ou mais aplicativos de interface do usuário do lado do cliente. Consulte o documento Pipelines de CI/CD para obter mais informações sobre esse tipo de pipeline.

Para concluir a configuração do pipeline de produção de front-end, siga estas etapas.

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

   • Repositório - Essa opção define de qual repositório Git o pipeline deve recuperar o código.
   DICA

   Consulte o documento 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 o recurso de preenchimento automático do campo localizará as ramificações correspondentes para ajudá-lo em sua seleção.
   • 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.

   

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

Código de pilha completa

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. Consulte o documento Pipelines de CI/CD para obter mais informações sobre esse tipo de pipeline.

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

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

   • Repositório - Essa opção define de qual repositório Git o pipeline deve recuperar o código.
   DICA

   Consulte o documento 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 o recurso de preenchimento automático do campo localizará as ramificações correspondentes para ajudá-lo em sua seleção.
   • 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 - Essa opção permite que o usuário habilite a implantação de produção agendada.

   

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.

   

3. Forneça um caminho a ser incluído na Auditoria de experiência.

   • Os caminhos da página devem começar com /.
   • Por exemplo, se você deseja incluir https://wknd.site/us/en/about-us.html na Auditoria de experiência, insira o caminho /us/en/about-us.html.

   

4. Clique em Adicionar página e o caminho será preenchido automaticamente com o endereço do ambiente e adicionado à tabela de caminhos.

   

5. Continue a adicionar caminhos, conforme necessário, repetindo as duas etapas anteriores.

   • É possível adicionar no máximo 25 caminhos.
   • Se você não definir nenhum caminho, a página inicial do site será incluída na Auditoria de experiência por padrão.

6. Clique em Salvar para salvar o pipeline.

Os caminhos configurados para a Auditoria de experiência serão enviados ao serviço e avaliados de acordo com os testes de desempenho, acessibilidade, SEO (otimização do mecanismo de pesquisa), práticas recomendadas e PWA (Aplicativo Web Progressivo) quando o pipeline for executado. Consulte Noções básicas sobre os resultados da Auditoria de experiência para obter mais detalhes.

O pipeline é salvo e agora você pode gerenciar seus pipelines no cartão Pipelines na página Visão geral do programa.

Configuração no nível da Web

Um pipeline de configuração no nível da Web implanta configurações HTTPD/Dispatcher. Consulte o documento Pipelines de CI/CD para obter mais informações sobre esse tipo de pipeline.

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

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

   • Repositório - Essa opção define de qual repositório Git o pipeline deve recuperar o código.
   DICA

   Consulte o documento 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 o recurso de preenchimento automático do campo localizará as ramificações correspondentes para ajudá-lo em sua seleção.
   • 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.
     • Para pipelines de configuração no nível da Web, esse é geralmente o caminho que contém os diretórios conf.d, conf.dispatcher.d e opt-in.
     • Por exemplo, se a estrutura do projeto foi gerada a partir do Arquétipo de projeto AEM, o caminho seria /dispatcher/src.
   • Pausar antes de implantar na produção - Essa opção pausa o pipeline antes de implantar na produção.
   • Agendado - Essa opção permite que o usuário habilite a implantação de produção agendada.

   

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

Desenvolvimento de Sites com o pipeline front-end

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 a fim de aproveitar ao máximo o potencial desse processo.

Ignorar pacotes do Dispatcher

Se quiser que os pacotes do dispatcher sejam compilados como parte do pipeline, mas não quiser que eles sejam publicados para criar armazenamento, desative a publicação, o que pode reduzir a duração da execução do pipeline.

A configuração a seguir para desativar a publicação de pacotes do dispatcher deve ser adicionada por meio do arquivo de projeto pom.xml. Ela se baseia em uma variável de ambiente, que serve como um sinalizador que pode ser definido no contêiner de compilação do Cloud Manager para especificar quando os pacotes do dispatcher devem ser ignorados.

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

Recursos do Business.Adobe.com