infra-vps-producao
Use when operating a production VPS: Docker, Traefik, DNS.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 10
- Forks
- 0
01 前言 Front Matter
- name
- infra-vps-producao
- author
- Agent Skills Community
- license
- MIT
- version
- 1.0.0
- metadata
- { "hermes": { "tags": [ "vps", "docker", "traefik", "dns", "tls", "upgrade", "rollback", "producao", "PT-BR" ], "category": "devops", "related_skills": [ "n8n-correcao-producao", "composio-apps", "incident-forensics" ] } }
- platforms
- [ "linux" ]
- description
- Use when operating a production VPS: Docker, Traefik, DNS.
02 资源文件 5
- 参考文档references/provedor-hospedagem-api.md2.7 KB
- 参考文档references/traefik-hostnames-tls.md2.7 KB
- 参考文档references/triagem-servico-fora-do-ar.md5.1 KB
- 参考文档references/upgrade-container-com-banco.md3.6 KB
- 脚本scripts/sqlite_wal_read.sh1.7 KB
03 SKILL.md 正文
Operar VPS de produção (Docker + Traefik)
O VPS hospeda serviços e sistemas críticos de produção junto com serviços internos, no mesmo Docker e atrás do mesmo Traefik. Derrubar o container errado, ou declarar "quebrou" a partir de um sinal fraco, interrompe a operação. Esta skill cobre inventário, roteamento, upgrade com rollback provado e — principalmente — como provar o estado em vez de inferir.
Responda em PT-BR. Quando o problema está no JSON do fluxo e não na instância, a skill é
n8n-correcao-producao.
Suporte: references/upgrade-container-com-banco.md (upgrade/rollback de app com banco embarcado) ·
references/traefik-hostnames-tls.md (roteamento e Let's Encrypt) ·
references/provedor-hospedagem-api.md (o que a API do provedor resolve e o que não) ·
scripts/sqlite_wal_read.sh (leitura WAL-aware de SQLite em volume Docker).
When to Use
- Auditar uma conta de hospedagem: o que se paga, o que roda, o que está pago e ocioso.
- Apontar domínio próprio para serviço que hoje só responde no hostname genérico do provedor.
- Atualizar, reiniciar ou migrar container que serve produção ou usuários externos.
- Investigar subdomínio que não responde, 404 de proxy reverso ou certificado errado.
Gates — antes de tocar em qualquer coisa que já roda
- Inventário primeiro, conclusão depois.
docker ps,docker compose ls,df -h, e a lista de DNS da zona. Só depois diga o que está quebrado. - Nenhum registro DNS é órfão até você achar o serviço que ele fronteia. Um CNAME que dá
timeout pode apontar para container vivo que simplesmente não tem rota no proxy. Mapeie
registro → serviço rodandoantes de propor remoção; deletar por aparência derruba integração. - Declare a classe de risco antes de executar, não depois. Upgrade de app com banco embarcado,
troca de
WEBHOOK_URLe mudança de DNS de produção não são rotina, mesmo quando o pedido veio curto ("atualiza aí"). Diga o que pode quebrar e ofereça a bancada isolada antes de rodar. Executar direto e reverter depois custa downtime em produção que não precisava existir. - Backup com o container parado. Banco embarcado (SQLite) tem
-walcom commits não consolidados;tardo volume com o processo vivo gera backup que pode não restaurar. - Anote o digest da imagem atual (
docker image inspect --format '{{.RepoDigests}}') antes de qualquerpull. Sem ele não existe rollback determinístico. - Ação destrutiva é sempre por escopo nomeado. Comando que varre "todos os containers" ou "volumes não usados" não entra em VPS compartilhado com produção.
Provar o estado: leia a fonte autoritativa, não o log
Ausência de uma linha de log não é prova de falha. Strings de log são renomeadas e removidas entre versões; um upgrade que muda o subsistema muda também o que ele imprime. Usar "a linha X sumiu" como evidência de quebra produz falso positivo — e um rollback de produção desnecessário.
Antes de concluir que um serviço quebrou após upgrade:
- Leia o estado persistido que o próprio app grava (tabelas de status, endpoint de health, API REST), não o texto do log.
- Se há coluna de erro (
status,errorMessage), leia-a.activatedcomerrorMessagevazio é sucesso, independente do que o log deixou de imprimir. - Só depois, se o estado confirmar falha, trate como quebra.
Mensagem de um subsistema não é veredito de outro: um índice que reporta Processed 0 ... pode ser
de construção de dependências, não do motor de ativação. Confirme qual componente emitiu a linha
antes de atribuir significado a ela.
Quando log e banco se contradizem, o banco decide — e a contradição é o achado, não um detalhe.
Leitura de SQLite: WAL ou conclusão invertida
Banco SQLite em modo WAL guarda os commits recentes no arquivo -wal. Ler com immutable=1, ou
copiar só database.sqlite, ignora o WAL e devolve tabela vazia onde há dados — invertendo o
diagnóstico.
Sempre: pare o container, copie database.sqlite, database.sqlite-wal e database.sqlite-shm
juntos, e consulte a cópia em leitura normal. scripts/sqlite_wal_read.sh faz isso.
Montar o volume como :ro e tentar abrir com WAL falha com unable to open database file (14) —
o SQLite precisa escrever para reproduzir o WAL. Por isso se consulta a cópia, nunca o volume.
Fixar imagem por digest
Compose de produção com tag flutuante (image: app:latest) significa que qualquer recriação de
container pode saltar de versão em silêncio — inclusive um up -d de rotina feito para outra coisa.
Depois de estabilizar uma versão, fixe:
image: registry/app@sha256:<digest>
Isso transforma "atualizar" em decisão explícita. Ao fixar, registre no relato — é mudança permanente de comportamento do deploy.
Subagente em infraestrutura
Delegar recon e reprodução funciona; delegar a conclusão, não.
- Briefing lista os containers e diretórios proibidos por nome, não "não mexa em produção".
- Resumo de filho é auto-relato. Um
producao_intacta: falsepode significar "fui bloqueado antes de verificar", não "quebrei". Confirme você mesmo antes de repassar qualquer veredito. - Revise o artefato que o filho criou antes de aceitar a conclusão dele. Bancada montada errada
invalida o achado: um compose com
networks.default.internal: trueimpede publicar porta (docker portvolta vazio, o serviço fica inalcançável) e ainda derruba o DNS de saída. Leia o compose gerado antes de tratar o teste como válido. - Trocar o modelo dos filhos é
hermes config set delegation.model <modelo>+delegation.provider <provider>; confirme que o provider está autenticado (hermes auth status <provider>) antes de setar, senão os filhos falham no primeiro turno.
Pitfalls
- Resposta JSON com formato de sucesso e campos vazios não é sucesso. Um
{"id": 0, "name": "", "state": ""}de API de provedor é rota que aceitou o POST e não fez nada. Prove pelo efeito (conexão SSH real, recurso listado), nunca pelo corpo da resposta. - Cadastrar chave SSH na conta ≠ instalar a chave no servidor. São dois passos e a API do
provedor costuma expor só o primeiro; o painel do VPS lista o que está anexado àquela máquina,
por isso mostra vazio mesmo com a chave existindo na conta. O caminho garantido é o console web do
provedor escrevendo em
authorized_keys. - Serviço exposto em porta alta com bind
0.0.0.0não está atrás do proxy. Ver o proxy rodando não prova que ele roteia aquele serviço; confira os labels do container. - Cert
TRAEFIK DEFAULT CERT= nenhum router casou com o hostname. É roteamento ausente, não falha de TLS — não reemita certificado tentando consertar. - O volume do
acme.jsonpode não ser o nomeado no compose. Projetos criados em momentos diferentes deixam volume órfão com nome parecido (traefik-letsencryptvstraefik_traefik-letsencrypt). Liste os dois e confira qual tem o arquivo antes de concluir que não há certificado emitido. - Let's Encrypt limita emissões por domínio por semana. Antes de subir hostname novo, leia os
domínios já emitidos no
acme.json; testar repetidamente queima a cota e trava o domínio. - Timezone do container decide a hora do cron.
TZherdado do template (ex.: fuso do datacenter) faz todo agendamento disparar fora do horário comercial local. Verifique ao auditar; corrigir muda o horário de tudo que já roda, então é decisão do dono. - Plano de hospedagem pago e ocioso é achado de auditoria. Site estático em plano de negócio, domínio expirado com WordPress ainda instalado, domínio grátis incluso nunca resgatado, serviço em trial prestes a virar cobrança. Reporte com valor anual e a data limite de cancelamento.
Formato do relato
Na ordem: o que foi feito e verificado (com o dado que prova: código HTTP, versão, contagem) · o que a verificação revelou de novo · onde travou e o que destrava.
Tabela para inventário e custo. Não narre chamada de ferramenta que o usuário já viu.
Erro seu vira parágrafo próprio, não nota de rodapé. Se um diagnóstico errado causou downtime, diga isso explicitamente, com o sinal fraco que você usou como prova — é o que impede a repetição.
Pendências se agrupam no fim, com a data limite quando existir (renovação, trial, expiração).
Verification
docker psmostra todos os containers de antes, com uptime preservado nos que você não tocou.- Endpoint externo de cada serviço público responde (código HTTP colado no relato).
- Hostname antigo continua respondendo depois de adicionar o novo.
- Backup do volume existe e contém os três arquivos do SQLite.
- Compose de produção fixa imagem por digest.
Referências adicionais
- references/triagem-servico-fora-do-ar.md: Triagem de serviço "fora do ar" — de fora para dentro
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: raw post search, posting, DM, media.
xlsx
Create, read, edit Excel .xlsx workbooks and CSVs.
whatsapp-baileys-local
Use when sending WhatsApp via the local Baileys bench.
weekly-review-planning
Weekly reset: commitments, stalled work, next-week plan.
teams-meeting-pipeline
Teams meeting summaries, job replay, Graph subscriptions.