infracloud/vps/vim

Vim - Servidor de Produção

Este repositório contém a documentação técnica e os guias de operação para o servidor Vim, uma VPS dedicada ao deployment de aplicações utilizando a plataforma Dokku.

Visão Geral

O servidor Vim é uma infraestrutura de produção que hospeda múltiplas aplicações web, seguindo uma arquitetura baseada em contêineres. A plataforma Dokku serve como camada de gerenciamento de aplicações, similar a um Heroku self-hosted, permitindo deploys rápidos através de Git pushes. O Nginx atua como proxy reverso, roteando o tráfego baseado em domínios para as aplicações corretas.

Este servidor complementa a infraestrutura existente do projeto Infracloud, que já inclui o servidor Apolo com Kubernetes (K3s). Enquanto o Apolo foi projetado para cargas de trabalho que se beneficiam de orquestração complexa e alta disponibilidade, o Vim foca em simplicidade e deploy rápido para aplicações que não necessitam de escala massiva.

Especificações do Servidor

Recurso	Especificação
Plataforma	VPS com Ubuntu/Debian
Orquestrador	Dokku (PaaS self-hosted)
Container Runtime	Docker
Proxy Reverso	Nginx
Bancos de Dados	PostgreSQL 17 e 18.1 (gerenciados)
Cache	Redis

Projetos Hospedados

O servidor Vim atualmente hospeda três projetos principais:

• GoHorse: Ecossistema completo com backend, frontend, backoffice, seeder e jobs processor
• Sextando: Plataforma com API e frontend separados
• Agno Orquestrador: Serviço de orquestração dedicado

Documentação

A documentação completa está organizada nos seguintes arquivos:

• Arquitetura do Sistema: Diagrama detalhado e descrição dos componentes
• Inventário de Serviços: Tabela completa de apps, bancos, portas e domínios
• Guia de Deploy: Instruções passo a passo para deployment e manutenção

Quick Start para Deploy

# Adicionar remote Dokku
git remote add dokku dokku@vim.rede5.com.br:nome-do-app

# Fazer deploy
git push dokku main:master

Consulte o deployment_guide.md para instruções detalhadas.

Estrutura de Diretórios

vim/
├── README.md                    # Este arquivo
├── architecture.md             # Arquitetura detalhada do sistema
├── services_inventory.md       # Inventário completo de serviços
└── deployment_guide.md          # Guia de deploy e manutenção

Boas Práticas

Sempre siga estas práticas ao fazer deploy no servidor Vim:

1. Variáveis de Ambiente: Configure todas as variáveis necessárias antes do deploy
2. Bancos de Dados: Utilize os bancos existentes (postgres-main ou agno-db) ou crie novos conforme necessidade
3. SSL: Para domínios de produção, habilite HTTPS
4. Logs: Monitore os logs após cada deploy
5. Testes: Teste a aplicação em staging antes de fazer deploy em produção

Suporte

Para dúvidas ou problemas com deployment, consulte:

1. deployment_guide.md - Seção de troubleshooting
2. services_inventory.md - Verificar configuração atual
3. Architecture - Entender como os componentes interagem