sistema-de-chamados/docs/DEPLOY-MANUAL.md

Deploy Manual via VPS

Acesso rápido

• Host: 154.12.253.40
• Usuário: root
• Caminho do projeto: /srv/apps/sistema
• Chave SSH (local): ./codex_ed25519 (chmod 600)
• Login: ssh -i ./codex_ed25519 root@154.12.253.40

Passo a passo resumido

1. Conectar na VPS usando o comando acima.
2. Dentro de /srv/apps/sistema, atualizar o código:

   cd /srv/apps/sistema
   git pull
   

3. Aplicar a stack Docker (web + Convex):

   docker stack deploy --with-registry-auth -c stack.yml sistema
   

4. (Opcional) Forçar o rollout do serviço web após o deploy:

   docker service update --force sistema_web
   

5. Verificar status dos serviços:

   docker stack services sistema
   docker service ps sistema_web
   

6. Consultar logs em tempo real quando necessário:

   docker service logs -f sistema_web
   docker service logs -f sistema_convex_backend
   

Quando o GitHub Actions travar

• Execute o fluxo acima manualmente para liberar o deploy.
• Se somente funções Convex mudaram:

  docker service update --force sistema_convex_backend
  

• Se precisar ajustar variáveis de ambiente, edite /srv/apps/sistema/.env e reexecute o passo 3.

Referências

• Runbook completo: docs/OPERATIONS.md
• Workflow automatizado: .github/workflows/ci-cd-web-desktop.yml