Configuração de pipelines de produção

Saiba como usar o Cloud Manager para criar e configurar pipelines de produção para implantar seu código. Se desejar ter uma visão geral mais conceitual de como os pipelines funcionam no Cloud Manager, consulte o documento Pipelines de CI/CD.

Visão geral

Você pode criar dois tipos diferentes de pipelines usando o bloco Configurações de pipeline no Cloud Manager.

• 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 do seu repositório Git até a produção.
• Pipelines de não produção - Um pipeline de não produção é utilizado principalmente para executar verificações de qualidade de código ou implantar o código-fonte em um ambiente de desenvolvimento.

Este documento é voltado para pipelines de produção. Para obter detalhes sobre como configurar pipelines de não produção, consulte o documento Configuração de pipelines de não produção.

O Gerenciador de implantação é responsável pela configuração do pipeline. A configuração do pipeline consiste em:

1. Definir o acionador que iniciará o pipeline.
2. Definir os parâmetros que controlam a implantação de produção.
3. Configurar os parâmetros de teste de desempenho.

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

Depois de usar a interface do Cloud Manager para configurar seu programa e definir pelo menos um ambiente, você estará pronto para adicionar um pipeline de produção.

1. Faça logon no Cloud Manager, em my.cloudmanager.adobe.com, e selecione a organização e o programa apropriados.

2. Navegue até o cartão Pipelines da página Visão geral do programa, clique em +Adicionar e selecione Adicionar pipeline de produção.

   

3. A caixa de diálogo Adicionar pipeline de produção é aberta na guia Configuração, onde várias opções do pipeline devem ser definidas. Essas opções são agrupadas em seções que podem ser recolhidas e são descritas nas etapas a seguir.

   1. Forneça um nome descritivo para o pipeline no campo Nome do pipeline.

   2. Na seção Código-fonte, você define de onde o pipeline recuperará o código que será processado.

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

      Consulte o documento Configuração do programa 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.
      • Localização do código - Essa opção define o caminho na ramificação do repositório selecionado a partir do qual o pipeline deve recuperar o código.

      

   3. Na seção Ambientes, você define o que aciona uma implantação e como ela deve ser realizada em cada ambiente.

      1. Na seção PREPARO, é possível definir como o pipeline é implantado em seu ambiente de preparo.

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

           • Manual - Use essa opção para iniciar manualmente o pipeline usando a interface do Cloud Manager.
           • Sobre alterações do Git - Essas opções iniciam o pipeline de CI/CD sempre que as 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 de métricas importantes - Durante a configuração ou edição do pipeline, o Gerenciador de implantação tem a opção de definir o comportamento do pipeline quando uma falha importante é encontrada em qualquer uma das portas 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. É basicamente semelhante a um usuário que aprova manualmente cada falha.

         

         • Opções de implantação - Você pode acelerar determinadas tarefas de implantação.

           • Aprovar após a implantação de preparo - Essa aprovação ocorre após a implantação no ambiente de preparo, antes da realização de qualquer teste. Caso contrário, a aprovação ocorre antes da implantação de produção, que é feita após a conclusão de todos os testes.

           • Ignorar alterações do balanceador de carga - Não são efetuadas alterações no balanceador de carga.

         

         • Configuração do Dispatcher - O Gerenciador de implantação pode configurar um conjunto de caminhos de conteúdo que serão invalidados ou removidos do cache do Dispatcher do AEM quando um pipeline for executado. Essas ações de cache serão executadas 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:

           1. Em CAMINHO, forneça um caminho de conteúdo.

           2. Em TIPO, selecione a ação a ser tomada nesse caminho.

              • Limpeza - Executa uma exclusão do cache.
              • 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.

           3. Clique em Adicionar caminho para adicionar o caminho especificado. É possível adicionar até 100 caminhos por ambiente.

         

         DICA

         Em geral, o uso da ação de invalidação é preferível, mas pode haver casos em que a limpeza será necessária, especialmente ao usar bibliotecas de clientes em HTML do AEM.

      2. Na seção PRODUÇÃO, é possível definir como o pipeline é implantado em seu ambiente de produção.

         • Opções de implantação - Você pode definir os parâmetros que controlam a implantação de produção.

           • Usar aprovação GoLive - Uma implantação deve ser aprovada manualmente por um usuário com a função Proprietário da empresa, Gerente de projetos ou Gerente de implantação, por meio da interface do Cloud Manager.
           • Programado - Essa opção interrompe o pipeline antes da implantação de produção para permitir que ele seja programado. Se essa opção estiver selecionada, o pipeline será interrompido após a implantação no ambiente de preparo e solicitará que o usuário execute a ação.
             • Agora - Essa opção realiza a implantação na produção imediatamente, concluindo efetivamente o pipeline.
             • Data - Essa opção permite que o usuário programe o horário em que a implantação deverá ser concluída.
             • Parar execução - Essa opção interrompe a implantação na produção.
           DICA

           Consulte o documento Implantação do código para saber como programar a implantação ou executar o pipeline imediatamente.

           • Usar a supervisão do CSE - Se essa opção for selecionada, será solicitado o auxílio de um CSE para iniciar a implantação. Ao criar ou editar um pipeline quando essa opção estiver habilitada, a função Gerente de implantação terá as seguintes opções.

             • Qualquer CSE - Essa opção permite que qualquer CSE disponível inicie a implantação.
             • Meu CSE - Essa opção permite que somente o CSE específico atribuído ao cliente inicie a implantação. Isso também se aplica ao CSE designado como substituto se o CSE atribuído não estiver disponível.

           

         • Configuração do Dispatcher - Define a configuração do Dispatcher para o ambiente de produção. As opções são as mesmas do ambiente de preparo.

4. Clique em Continuar para avançar para a guia Teste de preparo, onde é possível configurar o teste de desempenho do AEM Sites e do AEM Assets, dependendo das licenças de produto que você possui.

   DICA

   Consulte o documento Teste de qualidade do código para obter mais detalhes sobre as opções disponíveis na guia Teste de preparo.

   1. Na seção Entrega de conteúdo de sites/Peso de carga distribuído, você define como o teste de desempenho de sites é configurado com base na ponderação de solicitações de página entre os três conjuntos de páginas, que pode ser habilitada ou desabilitada.

      • Páginas populares ativas
      • Outras páginas ativas
      • Novas páginas

      

   2. Na seção Distribuição de teste de desempenho do Assets, você define a distribuição de testes de imagens e PDFs, bem como de seus próprios ativos de teste.

      • Imagens - Use o controle deslizante para ajustar a divisão do teste entre imagens e PDFs.

      • PDF - Use o controle deslizante para ajustar a divisão do teste entre imagens e PDFs.

      • Defina seus próprios ativos personalizados fazendo upload deles.

        1. FORMATO - Escolha se o ativo personalizado é um PDF de uma imagem.
        2. NOME DE ARQUIVO - Use o botão do navegador de arquivos para selecionar uma imagem de sua máquina local.
        3. Adicionar arquivo de teste - Clique para fazer upload do ativo selecionado.

      

5. Clique em Salvar para concluir a adição do pipeline de produção.

Próximas etapas

Depois de configurar o pipeline, é necessário implantar o código. Consulte o documento Implantação do código para obter mais detalhes.

Tutorial em vídeo

Este vídeo fornece uma visão geral do processo de criação de pipeline, que é detalhado neste documento.