76 lines
3.3 KiB
Markdown
76 lines
3.3 KiB
Markdown
# 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](./architecture.md): Diagrama detalhado e descrição dos componentes
|
|
- [Inventário de Serviços](./services_inventory.md): Tabela completa de apps, bancos, portas e domínios
|
|
- [Guia de Deploy](./deployment_guide.md): Instruções passo a passo para deployment e manutenção
|
|
|
|
## Quick Start para Deploy
|
|
|
|
```bash
|
|
# 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](./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](./deployment_guide.md) - Seção de troubleshooting
|
|
2. [services_inventory.md](./services_inventory.md) - Verificar configuração atual
|
|
3. Architecture - Entender como os componentes interagem
|