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
Mensagem pronta para colar
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-proceduresOu 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.mdConteú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
- Velocidade acima da perfeição: Faça o rollback primeiro, depure depois
- Não acumule erros: Um rollback, não várias alterações
- Comunique-se: Informe a equipe sobre o que aconteceu
- 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
- Avaliar: Qual é o sintoma?
- Correção rápida: Reiniciar se não estiver claro
- Rollback: Se a reinicialização não ajudar
- 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.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2760
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
bun-runtime
Faz seu agente usar o Bun para rodar, organizar e testar código. Ajuda a escolher o Bun em vez de outras ferramentas e a migrar projetos existentes.
affaan-m/ECC
database-migrations
Ajuda seu agente a fazer mudanças seguras em bancos de dados. Ele garante que as alterações possam ser desfeitas e minimiza o tempo de inatividade.
affaan-m/ECC
deployment-patterns
Configura fluxos de implantação e CI/CD, containerização e estratégias de rollback para garantir lançamentos seguros.
affaan-m/ECC