mirror of
https://github.com/felipegcoutinho/openmonetis.git
synced 2026-03-10 04:51:47 +00:00
4358bcfb10
- Implementado o workflow GitHub Actions para build e push da imagem do OpenSheets para o Docker Hub. - Criado guia de deploy no Coolify, detalhando opções de uso e configuração. - Atualizados arquivos de configuração do Docker Compose para produção, incluindo serviços e variáveis de ambiente. - Adicionadas instruções para gerenciamento de versões e troubleshooting.
131 lines
3.1 KiB
Markdown
131 lines
3.1 KiB
Markdown
# Guias de Deploy do OpenSheets
|
|
|
|
Escolha o guia apropriado para seu caso:
|
|
|
|
## 📚 Guias Disponíveis
|
|
|
|
### 1. [DEPLOY_COOLIFY.md](./DEPLOY_COOLIFY.md)
|
|
**Deploy no Coolify usando Docker**
|
|
|
|
**Use para:** Deploy em produção no Coolify
|
|
|
|
**Opções disponíveis:**
|
|
- ⚡ Com imagem do Docker Hub (deploy rápido)
|
|
- 🐢 Com build direto no Coolify (mais simples)
|
|
- 🔐 Com PostgreSQL separado (melhor gestão)
|
|
|
|
---
|
|
|
|
### 2. [DOCKER_HUB.md](./DOCKER_HUB.md)
|
|
**Publicação de imagens no Docker Hub**
|
|
|
|
**Use para:**
|
|
- Configurar CI/CD com GitHub Actions
|
|
- Publicar imagens automaticamente
|
|
- Deploy ultra-rápido (segundos vs minutos)
|
|
|
|
**Inclui:**
|
|
- Workflow GitHub Actions pronto
|
|
- Publicação automática e manual
|
|
- Gestão de versões e tags
|
|
|
|
---
|
|
|
|
## 🚀 Fluxo Recomendado para Produção
|
|
|
|
```
|
|
1. Configurar Docker Hub
|
|
└─> Seguir: DOCKER_HUB.md
|
|
├─ Criar access token no Docker Hub
|
|
├─ Configurar secrets no GitHub
|
|
└─ Push código → imagem publicada automaticamente
|
|
|
|
2. Deploy no Coolify
|
|
└─> Seguir: DEPLOY_COOLIFY.md → Opção 1
|
|
├─ Usar docker-compose.prod.yml
|
|
├─ Configurar variáveis de ambiente
|
|
└─ Deploy em segundos ⚡
|
|
```
|
|
|
|
---
|
|
|
|
## ⚡ Quick Start (Mais Rápido)
|
|
|
|
**Não quer configurar Docker Hub agora?**
|
|
|
|
```
|
|
└─> Seguir: DEPLOY_COOLIFY.md → Opção 2
|
|
├─ Usar docker-compose.yml original
|
|
├─ Configurar variáveis básicas
|
|
└─ Deploy em 2-5 minutos 🐢
|
|
```
|
|
|
|
---
|
|
|
|
## 📁 Arquivos de Configuração
|
|
|
|
| Arquivo | Uso |
|
|
|---------|-----|
|
|
| `docker-compose.yml` | Desenvolvimento local + Deploy simples no Coolify |
|
|
| `docker-compose.prod.yml` | Produção com imagem do Docker Hub |
|
|
| `docker-compose.coolify.yml` | Deploy no Coolify com PostgreSQL separado |
|
|
| `.env.production.example` | Template de variáveis de ambiente |
|
|
| `.github/workflows/docker-publish.yml` | CI/CD automático para Docker Hub |
|
|
|
|
---
|
|
|
|
## 🔧 Variáveis de Ambiente
|
|
|
|
Ver template completo: [.env.production.example](./.env.production.example)
|
|
|
|
### Mínimo necessário:
|
|
```bash
|
|
# PostgreSQL
|
|
POSTGRES_PASSWORD=...
|
|
DATABASE_URL=postgresql://opensheets:senha@db:5432/opensheets_db
|
|
|
|
# Better Auth
|
|
BETTER_AUTH_SECRET=...
|
|
BETTER_AUTH_URL=https://seu-dominio.com
|
|
```
|
|
|
|
### Gerar secrets:
|
|
```bash
|
|
openssl rand -base64 32
|
|
```
|
|
|
|
---
|
|
|
|
## 🆘 Troubleshooting
|
|
|
|
| Problema | Solução |
|
|
|----------|---------|
|
|
| Deploy muito lento | Use Docker Hub (DOCKER_HUB.md) |
|
|
| Erro de conexão com banco | Verificar DATABASE_URL |
|
|
| Imagem não encontrada | Configurar DOCKER_USERNAME no Coolify |
|
|
| Migrations não executam | Executar manualmente: `pnpm db:push` |
|
|
|
|
---
|
|
|
|
## 📖 Mais Recursos
|
|
|
|
- [Documentação Coolify](https://coolify.io/docs)
|
|
- [Docker Hub](https://hub.docker.com/)
|
|
- [GitHub Actions](https://docs.github.com/en/actions)
|
|
- [Next.js Deployment](https://nextjs.org/docs/deployment)
|
|
|
|
---
|
|
|
|
## 🎯 Resumo
|
|
|
|
**Para produção (recomendado):**
|
|
1. DOCKER_HUB.md → Configurar CI/CD
|
|
2. DEPLOY_COOLIFY.md → Opção 1 (Docker Hub)
|
|
|
|
**Para começar rápido:**
|
|
- DEPLOY_COOLIFY.md → Opção 2 (Build direto)
|
|
|
|
**Dúvidas?**
|
|
- Abra uma issue no GitHub
|
|
- Consulte os guias detalhados acima
|