Pular para o conteúdo
Skillpedia
Deploy e nuvem (DevOps)48 mil · #2760

deployment-procedures

Ajuda seu agente a pensar nas melhores formas de lançar software em produção. Ensina a tomar decisões sobre como fazer isso de forma segura e como reverter se algo der errado.

O que ela faz

Este guia ensina os princípios para colocar um novo programa de computador em funcionamento (produção) de forma segura. Ele foca em como pensar sobre o processo, não em comandos específicos.

Quando usar

  • ✓Ao lançar uma nova versão do seu site ou aplicativo.
  • ✓Quando você precisa garantir que a volta para uma versão anterior seja rápida e segura.
  • ✓Para entender as etapas necessárias antes e depois de uma atualização.

Exemplo do que pedir para a IA

“Como posso garantir que minha atualização de site não cause problemas para os usuários?”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/deployment-procedures/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/deployment-procedures/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A IA explica as etapas gerais e os pontos de decisão para lançamentos seguros, como verificar o código, fazer backup e ter um plano para reverter mudanças se algo der errado.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add sickn33/agentic-awesome-skills --skill deployment-procedures

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/deployment-procedures/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Procedimentos de Implantação

Princípios de implantação e tomada de decisão para lançamentos seguros em produção. Aprenda a PENSAR, não a memorizar scripts.


⚠️ Como Usar Esta Habilidade

Esta habilidade ensina princípios de implantação, não scripts bash para copiar.

  • Toda implantação é única
  • Entenda o PORQUÊ por trás de cada etapa
  • Adapte os procedimentos à sua plataforma

1. Seleção de Plataforma

Árvore de Decisão

What are you deploying?
│
├── Static site / JAMstack
│   └── Vercel, Netlify, Cloudflare Pages
│
├── Simple web app
│   ├── Managed → Railway, Render, Fly.io
│   └── Control → VPS + PM2/Docker
│
├── Microservices
│   └── Container orchestration
│
└── Serverless
    └── Edge functions, Lambda

Cada Plataforma Tem Procedimentos Diferentes

Plataforma Método de Implantação
Vercel/Netlify Git push, auto-implantação
Railway/Render Git push ou CLI
VPS + PM2 SSH + etapas manuais
Docker Push de imagem + orquestração
Kubernetes kubectl apply

2. Princípios de Pré-Implantação

As 4 Categorias de Verificação

Categoria O Que Verificar
Qualidade do Código Testes passando, linting limpo, revisado
Build Build de produção funciona, sem avisos
Ambiente Variáveis de ambiente configuradas, segredos atualizados
Segurança Backup feito, plano de rollback pronto

Checklist de Pré-Implantação

  • Todos os testes passando
  • Código revisado e aprovado
  • Build de produção bem-sucedido
  • Variáveis de ambiente verificadas
  • Migrações de banco de dados prontas (se houver)
  • Plano de rollback documentado
  • Equipe notificada
  • Monitoramento pronto

3. Princípios do Fluxo de Trabalho de Implantação

O Processo de 5 Fases

1. PREPARE
   └── Verify code, build, env vars

2. BACKUP
   └── Save current state before changing

3. DEPLOY
   └── Execute with monitoring open

4. VERIFY
   └── Health check, logs, key flows

5. CONFIRM or ROLLBACK
   └── All good? Confirm. Issues? Rollback.

Princípios das Fases

Fase Princípio
Preparar Nunca implante código não testado
Backup Não é possível reverter sem backup
Implantar Observe acontecer, não se afaste
Verificar Confie, mas verifique
Confirmar Tenha o gatilho de rollback pronto

4. Verificação Pós-Implantação

O Que Verificar

Verificação Por Quê
Endpoint de saúde Serviço está em execução
Logs de erro Sem novos erros
Fluxos de usuário chave Funcionalidades críticas funcionam
Desempenho Tempos de resposta aceitáveis

Janela de Verificação

  • Primeiros 5 minutos: Monitoramento ativo
  • 15 minutos: Confirmar estabilidade
  • 1 hora: Verificação final
  • No dia seguinte: Revisar métricas

5. Princípios de Rollback

Quando Fazer Rollback

Sintoma Ação
Serviço fora do ar Fazer rollback imediatamente
Erros críticos Fazer rollback
Desempenho degradado em >50% Considerar rollback
Problemas menores Corrigir para frente se for rápido

Estratégia de Rollback por Plataforma

Plataforma Método de Rollback
Vercel/Netlify Reimplantação do commit anterior
Railway/Render Rollback no painel
VPS + PM2 Restaurar backup, reiniciar
Docker Tag da imagem anterior
K8s kubectl rollout undo

Princípios de Rollback

  1. Velocidade acima da perfeição: Faça o rollback primeiro, depure depois
  2. Não acumule erros: Um rollback, não várias alterações
  3. Comunique-se: Informe a equipe sobre o que aconteceu
  4. Pós-mortem: Entenda o porquê após a estabilização

6. Implantação Sem Interrupção (Zero-Downtime)

Estratégias

Estratégia Como Funciona
Rolling Substitui instâncias uma a uma
Blue-Green Alterna o tráfego entre ambientes
Canary Mudança gradual de tráfego

Princípios de Seleção

Cenário Estratégia
Lançamento padrão Rolling
Mudança de alto risco Blue-green (rollback fácil)
Necessidade de validação Canary (teste com tráfego real)

7. Procedimentos de Emergência

Prioridade de Serviço Fora do Ar

  1. Avaliar: Qual é o sintoma?
  2. Correção rápida: Reiniciar se não estiver claro
  3. Rollback: Se a reinicialização não ajudar
  4. Investigar: Após a estabilização

Ordem de Investigação

Verificação Problemas Comuns
Logs Erros, exceções
Recursos Disco cheio, memória
Rede DNS, firewall
Dependências Banco de dados, APIs

8. Anti-Padrões

❌ Não Fazer ✅ Fazer

…

Perguntas frequentes

O que é 'rollback'?

Rollback é o processo de voltar para a versão anterior de um programa se a nova versão apresentar problemas.

Por que não devo fazer atualizações na sexta-feira?

Atualizar no final da semana pode ser arriscado, pois se algo der errado, pode ser difícil conseguir ajuda rápida durante o fim de semana.

O que são 'feature flags'?

Feature flags são como interruptores que permitem ativar ou desativar novas funcionalidades em um programa sem precisar fazer uma nova atualização completa.

Detalhes

Descrição original do autor

Production deployment principles and decision-making. Safe deployment workflows, rollback strategies, and verification. Teaches thinking, not scripts.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#2760
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas