Skills: Skills de Deploy e CI/CD

Última atualização: 2026-08-31

Deploy é a operação onde erros mais machucam — Skills solidificam cada etapa em um processo, tornando o deploy tão confiável quanto respirar.

1. Arquitetura do Skill de deploy

(1) Decomposição do processo de deploy

TEXT 📖 Somente leitura

Processo de deploy
├── Pré-verificações
│   ├── O código foi commitado?
│   ├── Os testes estão passando?
│   └── As variáveis de ambiente estão prontas?
├── Etapa de build
│   ├── Instalar dependências
│   ├── Compilar/empacotar
│   └── Gerar artefatos de build
├── Etapa de deploy
│   ├── Backup da versão atual
│   ├── Deploy da nova versão
│   └── Health check
└── Pós-verificação
    ├── Teste funcional smoke test
    ├── Verificação de métricas de monitoramento
    └── Notificar a equipe

(2) Gerenciamento de ambientes

Ambiente	Propósito	Nível de risco	Estratégia de deploy
Desenvolvimento	Desenvolvimento local	🟢	Deploy manual
Staging	Verificação pré-release	🟡	Deploy automático + verificação manual
Produção	Serviço em produção	🔴	Deploy automático + aprovação + rollback

2. Integração com CI/CD

(1) Detecção de arquivo de configuração

MARKDOWN

## Detectar automaticamente a plataforma CI/CD
- Detectar .github/workflows/ → GitHub Actions
- Detectar .gitlab-ci.yml → GitLab CI
- Detectar Jenkinsfile → Jenkins
- Detectar .circleci/ → CircleCI

(2) Design de pipeline

YAML

# Exemplo de GitHub Actions
name: Deploy
on:
  push:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test
  deploy:
    needs: test
    steps:
      - run: npm run build
      - run: npm run deploy

(3) Pontos de integração do Skill

TEXT 📖 Somente leitura

Papel do Skill no CI/CD:
├── Durante desenvolvimento local: Pré-verificações, verificação de build
├── Na criação de PR: Revisão automática, execução de testes
├── Antes do merge: Suíte completa de testes, varredura de segurança
└── Após deploy: Health check, verificação de monitoramento

3. Estratégia de rollback

(1) Condições de rollback automático

MARKDOWN

## Condições de trigger de rollback automático
- Health check falha 3 vezes consecutivas
- Taxa de erro excede 5%
- Tempo de resposta excede 2s (P99)
- Uso de memória excede 90%

(2) Processo de rollback

TEXT 📖 Somente leitura

Processo de rollback
1. Detectar métricas anormais
2. Notificar a equipe
3. Bash para executar comando de rollback
4. Verificar health check após rollback
5. Exibir relatório de rollback

(3) Gerenciamento de versões

BASH

# Registro de versão de deploy
git tag -a v1.2.3 -m "Deploy to production"
git push origin v1.2.3

# Rollback para versão anterior
git tag -a v1.2.2-rollback -m "Rollback from v1.2.3"

4. Skill de deploy na prática

▶ Exemplo: Skill de deploy seguro

Alice criou um Skill de deploy com aprovação e rollback:

YAML

---
name: safe-deploy
description: "Deploy seguro: pré-verificação + aprovação + deploy + verificação + rollback"
triggers:
  - keyword: "deploy|implantar|deployment"
tools:
  - Read
  - Bash
  - Grep
---

MARKDOWN

## Fluxo de deploy

1. Pré-verificações
   - Bash: git status (confirmar commitado)
   - Bash: npm test (confirmar testes passando)
   - Grep: Verificar TODO/FIXME
2. Build e deploy
   - Bash: npm run build
   - Bash: npm run deploy:staging
3. Health check
   - Bash: curl -f http://staging.example.com/health
4. Perguntar se deve fazer deploy para produção
5. Deploy de produção + health check

Bob comentou: "O maior medo no deploy não é falhar — é não saber como reverter quando falha. Skills escrevem o rollback no processo, para que cada deploy tenha uma saída de retirada."

❓ Perguntas Frequentes

P: Skills de deploy devem ter permissão de escrita no Bash? R: Use com cautela. Recomenda-se permitir apenas comandos específicos de deploy, proibindo rm, curl | bash e outras operações perigosas. Use listas de comandos permitidos para restringir. P: Como lidar com configuração de múltiplos ambientes? R: Use variáveis para distinguir ambientes, coloque arquivos de configuração em .env.staging/.env.production, e deixe o Skill selecionar a configuração com base nas variáveis de ambiente. P: Como diagnosticar falhas no pipeline de CI/CD? R: O Skill primeiro lê os logs de erro, localiza a etapa falha, analisa a causa. Causas comuns: falha na instalação de dependências, timeout de testes, permissões insuficientes.

📖 Resumo

Quatro etapas de deploy: pré-verificações → build → deploy → pós-verificação
Níveis de ambiente: desenvolvimento → staging → produção, risco crescente
Integração CI/CD: Skills atuam nas etapas local/PR/merge/deploy
Estratégia de rollback: detectar anomalias automaticamente → notificar → reverter → verificar

📝 Exercícios

Básico (dificuldade⭐): Crie um Skill de pré-verificação de deploy que verifique se o código está commitado e os testes estão passando.
Intermediário (dificuldade⭐⭐): Crie um Skill de deploy seguro completo com etapas de pré-verificação, build, deploy e health check.
Avançado (dificuldade⭐⭐⭐): Crie um Skill de assistente CI/CD que detecte automaticamente a plataforma CI do projeto, analise a configuração do pipeline e diagnostique falhas.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós