Evo CRM — Documentação de Operação

Guia de deploy, runbooks e troubleshooting do stack enterprise-evo-crm-community em produção.

Introdução

• Visão geral
  • Ambiente de produção
  • Próximos passos

Deploy

• Infraestrutura e Traefik
  • Variantes de orquestração
  • Padrão de labels Traefik
  • Roteamento da API (evocrm-api.vya.digital)
  • Rede
• Variáveis de ambiente
  • Arquivo e symlink
  • Grupos de variáveis por serviço
  • Nota técnica — escape $$ em env_file

Runbooks

• Acesso ao servidor de produção
  • Fluxo
  • Caminho do projeto no servidor
  • Uso típico
• Verificação pós-deploy
  • 1. Status dos containers
  • 2. Dashboard do Traefik
  • 3. Verificação de dados no banco
  • 4. Registro da sessão
• Runbook — Exposição indevida de workers no Traefik
  • Sintoma
  • Causa raiz
  • Correção
  • Divergência adicional encontrada durante a correção
  • Validação
• Runbook — Crash loop por ausência de symlink .env
  • Sintoma
  • Causa raiz
  • Correção
  • Validação
  • Prevenção

Troubleshooting

• Divergências conhecidas
  • evo-crm fica unhealthy — db/schema.rb dessincronizado
  • evo-auth-sidekiq sempre unhealthy (falso alarme)
  • Boot do Rails falha com RAILS_SERVE_STATIC_FILES=false
  • Gateway nginx não documentado nos docs raiz
  • Provisionamento de Postgres externo
• Glossário