Design de Pipeline de Implantação

Padrões de arquitetura para pipelines de CI/CD multiestágio com portões de aprovação e estratégias de implantação.

Não use esta habilidade quando

• A tarefa não estiver relacionada ao design de pipeline de implantação
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique as melhores práticas relevantes e valide os resultados.
• Forneça etapas acionáveis e verificação.

Propósito

Projetar pipelines de implantação robustos e seguros que equilibrem velocidade com segurança por meio da organização adequada de estágios e fluxos de trabalho de aprovação.

Use esta habilidade quando

• Projetar arquitetura de CI/CD
• Implementar portões de implantação
• Configurar pipelines multiambiente
• Estabelecer melhores práticas de implantação
• Implementar entrega progressiva

Estágios do Pipeline

Fluxo Padrão do Pipeline

┌─────────┐   ┌──────┐   ┌─────────┐   ┌────────┐   ┌──────────┐
│  Build  │ → │ Test │ → │ Staging │ → │ Approve│ → │Production│
└─────────┘   └──────┘   └─────────┘   └────────┘   └──────────┘

Detalhamento dos Estágios

1. Origem - Checkout do código
2. Build - Compilar, empacotar, containerizar
3. Testes - Unitários, de integração, varreduras de segurança
4. Implantação em Staging - Implantar no ambiente de staging
5. Testes de Integração - E2E, testes de fumaça
6. Portão de Aprovação - Aprovação manual necessária
7. Implantação em Produção - Canary, blue-green, rolling
8. Verificação - Verificações de saúde, monitoramento
9. Rollback - Rollback automatizado em caso de falha

Padrões de Portão de Aprovação

Padrão 1: Aprovação Manual

# GitHub Actions
production-deploy:
  needs: staging-deploy
  environment:
    name: production
    url: https://app.example.com
  runs-on: ubuntu-latest
  steps:
    - name: Deploy to production
      run: |
        # Deployment commands

Padrão 2: Implantação Atrasada

# GitLab CI
deploy:production:
  stage: deploy
  script:
    - deploy.sh production
  environment:
    name: production
  when: delayed
  start_in: 30 minutes
  only:
    - main

Padrão 3: Múltiplos Aprovadores

Configure a política de aprovação real do ambiente protegido da plataforma e verifique quem pode aprová-la ou ignorá-la. Para o Azure, vincule a validação manual à versão da tarefa instalada e ao seu trabalho sem agente suportado, em vez de colocá-la em um hook de implantação arbitrário. Registre os aprovadores necessários e as evidências; notificações sozinhas não são aprovação.

Estratégias de Implantação

1. Implantação Rolling (Contínua)

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 10
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 2
      maxUnavailable: 1

Características:

• Lançamento gradual
• A disponibilidade depende da prontidão, capacidade e alterações compatíveis
• Rollback fácil
• Melhor para a maioria das aplicações

2. Implantação Blue-Green

# Blue (current)
kubectl apply -f blue-deployment.yaml
kubectl patch service my-app --type merge -p '{"spec":{"selector":{"app":"my-app","version":"blue"}}}'

# Green (new)
kubectl apply -f green-deployment.yaml
# Test green environment
kubectl patch service my-app --type merge -p '{"spec":{"selector":{"app":"my-app","version":"green"}}}'

# Rollback if needed
kubectl patch service my-app --type merge -p '{"spec":{"selector":{"app":"my-app","version":"blue"}}}'

Características:

• Troca instantânea
• Rollback fácil
• Dobra o custo da infraestrutura temporariamente
• Bom para implantações de alto risco

3. Implantação Canary

apiVersion: argoproj.io/v1alpha1
kind: Rollout
metadata:
  name: my-app
spec:
  replicas: 10
  strategy:
    canary:
      steps:
      - setWeight: 10
      - pause: {duration: 5m}
      - setWeight: 25
      - pause: {duration: 5m}
      - setWeight: 50
      - pause: {duration: 5m}
      - setWeight: 100

Características:

• Desvio gradual de tráfego
• Mitigação de risco
• Teste com usuários reais
• Requer service mesh ou similar

4. Feature Flags (Bandeiras de Funcionalidade)

from flagsmith import Flagsmith

flagsmith = Flagsmith(environment_key="API_KEY")

if flagsmith.has_feature("new_checkout_flow"):
    # New code path
    process_checkout_v2()
else:
    # Existing code path
    process_checkout_v1()

Características:

• Implantar sem liberar
• Testes A/B
• Rollback instantâneo
• Controle granular

Orquestração de Pipeline

Contrato de implementação multiestágio

…