[type=“Positive” url=“/help/implementing/cloud-manager/release-notes/current.md”]{class="badge informative"}
Usar implantações canárias para validar o código canary-deployments
Para implementações do AEM Cloud Service, as implantações canárias no Cloud Manager permitem validar o novo código no nível de publicação da infraestrutura de produção ativa antes de direcionar o tráfego real de usuários para ele. Você implanta a nova versão junto com a versão estável atual e a alcança por meio de um cabeçalho de solicitação dedicado. Depois de confirmar que a nova versão funciona com êxito, você pode promovê-la para todo o tráfego (isso acontece automaticamente após uma janela de 3 horas) ou revertê-la.
Ambientes de desenvolvimento e preparo continuam sendo os locais principais para testar versões de código; implantações canárias servem como uma oportunidade adicional para verificar se uma versão funciona conforme o esperado. Por exemplo, é útil se a produção do AEM se integrar a um terminal de produção de serviço externo, que não é explicitamente validado em ambientes AEM inferiores.
As implantações canárias são para validação interna, não para transferir o tráfego real do usuário da versão antiga para a nova; o tráfego real do usuário nunca roteia para instâncias canárias automaticamente.
Você pode enviar um email para aemcs-canary-deployments-feedback@adobe.com com perguntas e comentários.
Processo de implantação do Canary how-canary-deployments-work
Quando você executa um pipeline de pilha completa com implantações canary ativadas, o Cloud Manager inicia um conjunto separado de instâncias canary para a nova build enquanto as instâncias estáveis continuam atendendo os usuários. O processo segue estas etapas:
- Você executa um pipeline, preparo ou produção de implantação de pilha completa com implantações canárias ativadas.
Consulte Executar um pipeline e Habilitar implantações canárias. - Durante a etapa de implantação, o Cloud Manager inicia instâncias canárias que executam a nova versão do código.
- Suas instâncias estáveis existentes continuam a VEICULAR o tráfego direto.
- Você alcança a nova versão seletivamente adicionando um cabeçalho de solicitação canary. Consulte Acessar a versão canária.
- Durante uma janela de validação, você promove a versão canary para todo o tráfego ou cancela-a. Consulte Validar e promover ou cancelar.
Habilitar implantações canárias enable-canary-deployments
Você habilita implantações canary no pipeline de pilha completa. Só há suporte para implantações canárias em ambientes de estágio e produção. Observe que um pipeline configurado para implantação em preparo e produção executa a implantação do canary somente em produção, como mostrado abaixo.
Comportamento de implantação canário por tipo de pipeline
A execução da implantação do canary depende do tipo de pipeline.
Para habilitar implantações canárias:
-
No Cloud Manager, adicione um novo pipeline ou edite um pipeline existente que implante o código de pilha completa em um ambiente de preparo ou produção.
-
Na caixa de diálogo Editar pipeline de produção, clique na guia Código Source.
-
Na seção Pipeline, no cabeçalho Opções de Implantação de Produção, clique em Implantação Canária (beta).
-
Clique em Atualizar para concluir a habilitação do pipeline.
Durante a janela de validação, somente as solicitações que incluem o cabeçalho canary atingem a versão recém-implantada. Todas as outras solicitações continuam atingindo a versão estável.
Acessar a versão canária access-the-canary-release
Depois que o Cloud Manager inicia as instâncias do canary, você alcança a nova versão adicionando um cabeçalho HTTP às solicitações. A versão estável continua a atender solicitações sem o cabeçalho.
Para enviar uma solicitação para a versão canária, inclua o seguinte cabeçalho:
X-Aem-Canary: true
Validar e promover ou cancelar validate-and-promote-or-cancel
Quando as instâncias canárias estiverem prontas, uma janela de validação será aberta para que você possa testar a nova versão. O Cloud Manager mostra as opções Promover para produção e Cancelar implantação na seção Implantar para produção.
Promover a versão canária promote-the-canary-release
Para rotear todo o tráfego ativo para a nova versão, clique em Promover para produção. Ao promover a versão canária:
- A versão canary se torna a nova versão estável.
- O Cloud Manager roteia todo o tráfego ativo para a nova versão.
- A reversão não está mais disponível.
Cancelar a implantação canary cancel-the-canary-deployment
Se você encontrar problemas durante a janela de validação, clique em Cancelar implantação. Ao cancelar a implantação do canary:
- O Cloud Manager interrompe a versão do canary e remove as instâncias do canary.
- A versão estável anterior continua a fornecer tráfego.
- O cancelamento está disponível somente durante a janela de validação.
Escopo e limitações scope-and-limitations
Considere o seguinte escopo e limitações ao usar implantações canárias:
- As implantações canárias se aplicam somente ao nível de publicação. O nível de criação permanece na versão estável durante a validação do canary.
- Suas alterações devem ser compatíveis com versões anteriores para que as instâncias de publicação personalizadas possam atender às estruturas de conteúdo existentes.
- As alterações de conteúdo mutáveis em uma versão se aplicam após a promoção da versão canary. Essas alterações não estão disponíveis nas instâncias canárias durante a validação.