Lançamentos canário com Actions

Imagine lançar um novo recurso ou atualização. E se houver um erro que afete todos os seus usuários? Assustador, não é?

As versões canário ajudam a reduzir esse risco, disponibilizando as alterações gradualmente primeiro para um pequeno subconjunto de usuários. É como enviar um "canário para uma mina de carvão" para testar o ar antes que todos entrem.

As versões canário oferecem vários benefícios importantes:

• Risco reduzido: limite o impacto dos problemas a um pequeno grupo de usuários.
• Feedback do mundo real: obtenha dados de produção sobre desempenho e estabilidade.
• Reversão rápida: se surgirem problemas, reverta rapidamente apenas o pequeno grupo canário ou todo o serviço.
• Exposição controlada: aumente gradualmente a exposição dos usuários à medida que a confiança cresce.

Talvez você se lembre das implantações azul/verde, nas quais o tráfego é alternado instantaneamente entre dois ambientes idênticos.

As versões canário são diferentes. Em vez de uma troca instantânea, elas envolvem uma mudança gradual do tráfego. Uma nova versão é executada paralelamente à antiga, e inicialmente apenas uma pequena porcentagem dos usuários vê a nova versão. Isso permite um monitoramento detalhado antes da disponibilização completa.

Este é o fluxo básico de uma versão canário:

1. Implantar a nova versão: uma nova versão do aplicativo é implantada em um pequeno conjunto de servidores ou instâncias, paralelamente à versão estável existente.
2. Direcionar uma pequena parcela do tráfego: um balanceador de carga ou uma malha de serviços é configurado para enviar uma pequena porcentagem (por exemplo, 5–10%) do tráfego dos usuários para a nova versão.
3. Monitorar: o desempenho, as taxas de erros e o feedback dos usuários são monitorados atentamente no grupo canário.
4. Promover ou reverter: se tudo parecer correto, o tráfego será aumentado gradualmente ou a nova versão será promovida para 100%. Se ocorrerem problemas, a versão canário será revertida e o tráfego será redirecionado para a versão estável.

GitHub Actions pode orquestrar todo o processo de lançamento canário. Ele não gerencia o tráfego diretamente (essa é uma tarefa da sua infraestrutura), mas aciona as etapas:

• Compilar e testar sua aplicação.
• Implantar a nova versão em um ambiente canário.
• Iniciar mudanças de tráfego por meio de chamadas de API ao seu balanceador de carga ou à sua malha de serviços.
• Aguardar os resultados do monitoramento ou aprovações manuais.
• Promover o canário ou acionar uma reversão.

Um fluxo de trabalho típico do GitHub Actions para um lançamento canário poderia ser assim:

name: Canary Deployment

on: push

jobs:
  build:
    # ... build and test steps ...

  deploy-canary:
    needs: build
    steps:
      - name: Deploy to Canary Group
        # ... call script/tool to deploy and shift 10% traffic ...

  monitor-canary:
    needs: deploy-canary
    # ... wait for monitoring/approval ...

  promote-or-rollback:
    needs: monitor-canary
    # ... conditionally promote to 100% or rollback ...

Cada etapa interagiria com suas ferramentas de implantação.

Embora o GitHub Actions faça a orquestração, as decisões efetivas e os comandos de implantação geralmente acontecem em scripts. Veja um exemplo em Python que simula a lógica de uma distribuição canária. Imagine uma Action executando este script:

Um monitoramento eficaz é fundamental. Seu fluxo de trabalho do GitHub Actions pode ser integrado a sistemas de monitoramento de várias maneiras:

• Chamadas de API: Consultar ferramentas de monitoramento (por exemplo, Datadog e Prometheus) em busca de métricas importantes.
• Verificações de integridade: Consultar periodicamente os endpoints de integridade da aplicação.
• Barreiras manuais: Pausar o fluxo de trabalho para análise e aprovação humanas.
• Esperas baseadas em tempo: Aguardar um período definido para que as métricas se estabilizem.

Em seguida, o fluxo de trabalho usa esses sinais para decidir se deve promover ou reverter.

Após a fase de monitoramento, o GitHub Actions usa uma lógica condicional para decidir a próxima etapa. Você pode usar instruções if nas definições do seu trabalho ou da sua etapa.

  promote-or-rollback:
    needs: monitor-canary
    if: success() && needs.monitor-canary.outputs.canary_ok == 'true'
    steps:
      - name: Promote Full Rollout
        # ... command to shift 100% traffic to new version ...

  rollback:
    needs: monitor-canary
    if: failure() || needs.monitor-canary.outputs.canary_ok == 'false'
    steps:
      - name: Rollback to Stable
        # ... command to shift 100% traffic to old version ...

Isso garante uma reação automática ao desempenho do canário.

Nesta lição, você aprendeu sobre lançamentos canários, uma estratégia poderosa de implantação para disponibilizar gradualmente novas versões de software a um subconjunto de usuários.

• Os lançamentos canários minimizam os riscos e fornecem feedback do mundo real.
• O GitHub Actions orquestra a compilação, a implantação no ambiente canário, o monitoramento e as etapas condicionais de promoção ou reversão.
• O monitoramento eficaz e a lógica condicional são fundamentais para pipelines canários bem-sucedidos.

Ao usar canários, você pode implantar com mais confiança e controle!