feat: adição de workflows e documentação para publicação no Docker Hub
- 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.
This commit is contained in:
Felipe Coutinho
65
.github/workflows/docker-publish.yml
vendored
Normal file
65
.github/workflows/docker-publish.yml
vendored
Normal file
@@ -0,0 +1,65 @@
|
||||
name: Build and Push to Docker Hub
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
tags:
|
||||
- 'v*.*.*'
|
||||
pull_request:
|
||||
branches:
|
||||
- main
|
||||
workflow_dispatch:
|
||||
|
||||
env:
|
||||
DOCKER_IMAGE_NAME: opensheets
|
||||
|
||||
jobs:
|
||||
build-and-push:
|
||||
runs-on: ubuntu-latest
|
||||
permissions:
|
||||
contents: read
|
||||
packages: write
|
||||
|
||||
steps:
|
||||
- name: Checkout repository
|
||||
uses: actions/checkout@v4
|
||||
|
||||
- name: Set up Docker Buildx
|
||||
uses: docker/setup-buildx-action@v3
|
||||
|
||||
- name: Log in to Docker Hub
|
||||
if: github.event_name != 'pull_request'
|
||||
uses: docker/login-action@v3
|
||||
with:
|
||||
username: ${{ secrets.DOCKER_USERNAME }}
|
||||
password: ${{ secrets.DOCKER_PASSWORD }}
|
||||
|
||||
- name: Extract metadata (tags, labels)
|
||||
id: meta
|
||||
uses: docker/metadata-action@v5
|
||||
with:
|
||||
images: ${{ secrets.DOCKER_USERNAME }}/${{ env.DOCKER_IMAGE_NAME }}
|
||||
tags: |
|
||||
type=ref,event=branch
|
||||
type=ref,event=pr
|
||||
type=semver,pattern={{version}}
|
||||
type=semver,pattern={{major}}.{{minor}}
|
||||
type=semver,pattern={{major}}
|
||||
type=raw,value=latest,enable={{is_default_branch}}
|
||||
type=sha,prefix={{branch}}-
|
||||
|
||||
- name: Build and push Docker image
|
||||
uses: docker/build-push-action@v5
|
||||
with:
|
||||
context: .
|
||||
file: ./Dockerfile
|
||||
push: ${{ github.event_name != 'pull_request' }}
|
||||
tags: ${{ steps.meta.outputs.tags }}
|
||||
labels: ${{ steps.meta.outputs.labels }}
|
||||
cache-from: type=gha
|
||||
cache-to: type=gha,mode=max
|
||||
platforms: linux/amd64,linux/arm64
|
||||
|
||||
- name: Image digest
|
||||
run: echo ${{ steps.meta.outputs.digest }}
|
||||
270
DEPLOY_COOLIFY.md
Normal file
270
DEPLOY_COOLIFY.md
Normal file
@@ -0,0 +1,270 @@
|
||||
# Deploy do OpenSheets no Coolify
|
||||
|
||||
Este guia mostra como fazer deploy do OpenSheets no Coolify usando Docker.
|
||||
|
||||
## 🚀 Resumo Rápido
|
||||
|
||||
**Duas formas principais:**
|
||||
|
||||
### 1. Com imagem do Docker Hub (MAIS RÁPIDO ⚡)
|
||||
- Publicar imagem no Docker Hub primeiro
|
||||
- Deploy em segundos (só faz pull)
|
||||
- Ideal para produção e CI/CD
|
||||
- **Ver guia:** [DOCKER_HUB.md](./DOCKER_HUB.md)
|
||||
|
||||
### 2. Build direto no Coolify (MAIS SIMPLES)
|
||||
- Usar `docker-compose.yml` original
|
||||
- Coolify faz build completo (2-5 min)
|
||||
- Ideal para começar rápido
|
||||
|
||||
---
|
||||
|
||||
## Qual opção escolher?
|
||||
|
||||
| Opção | Quando usar | Deploy | Complexidade |
|
||||
|-------|-------------|--------|--------------|
|
||||
| **Opção 1: Imagem Docker Hub** | Deploy rápido, CI/CD, produção | ⚡ Segundos | ⭐ Fácil |
|
||||
| **Opção 2: Build no Coolify** | Começar rápido, teste | 🐢 2-5 min | ⭐ Fácil |
|
||||
| **Opção 3: PostgreSQL separado** | Backups automáticos, melhor gestão | 🐢 2-5 min | ⭐⭐ Médio |
|
||||
|
||||
**Recomendado para produção: Opção 1 (Docker Hub)** ✅
|
||||
|
||||
---
|
||||
|
||||
## Opção 1: Deploy com Docker Hub (Recomendado para Produção)
|
||||
|
||||
**Vantagens:**
|
||||
- ✅ Deploy em **segundos** (vs minutos)
|
||||
- ✅ Mesma imagem em múltiplos ambientes
|
||||
- ✅ CI/CD automático via GitHub Actions
|
||||
- ✅ Rollback fácil (trocar tag)
|
||||
|
||||
### Passo 0: Publicar Imagem no Docker Hub
|
||||
|
||||
**Siga o guia completo:** [DOCKER_HUB.md](./DOCKER_HUB.md)
|
||||
|
||||
Resumo rápido:
|
||||
1. Configurar secrets no GitHub (DOCKER_USERNAME e DOCKER_PASSWORD)
|
||||
2. Push para main ou criar tag → GitHub Actions publica automaticamente
|
||||
3. Verificar imagem em https://hub.docker.com/
|
||||
|
||||
### Passo 1: Criar Aplicação no Coolify
|
||||
|
||||
1. No Coolify: **Projects** → **+ New Resource** → **Docker Compose Empty**
|
||||
2. Configure:
|
||||
- **Name**: `opensheets`
|
||||
- **Source**: Conecte ao seu repositório Git
|
||||
- **Branch**: `main`
|
||||
- **Docker Compose Location**: `docker-compose.prod.yml`
|
||||
|
||||
### Passo 2: Configurar Variáveis de Ambiente
|
||||
|
||||
```bash
|
||||
# Configuração da imagem do Docker Hub
|
||||
DOCKER_USERNAME=seu-usuario-dockerhub
|
||||
IMAGE_TAG=latest
|
||||
|
||||
# PostgreSQL
|
||||
POSTGRES_USER=opensheets
|
||||
POSTGRES_PASSWORD=SENHA_FORTE_AQUI
|
||||
POSTGRES_DB=opensheets_db
|
||||
DATABASE_URL=postgresql://opensheets:SENHA_FORTE_AQUI@db:5432/opensheets_db
|
||||
|
||||
# Better Auth (OBRIGATÓRIO)
|
||||
BETTER_AUTH_SECRET=GERAR_COM_OPENSSL
|
||||
BETTER_AUTH_URL=https://seu-dominio.com
|
||||
|
||||
# Opcionais: EMAIL, OAUTH, AI (ver abaixo)
|
||||
```
|
||||
|
||||
### Passo 3: Deploy
|
||||
|
||||
1. Clique em **Deploy**
|
||||
2. **Coolify vai fazer PULL da imagem** (segundos) ⚡
|
||||
3. PostgreSQL sobe primeiro
|
||||
4. App executa migrations e inicia
|
||||
|
||||
---
|
||||
|
||||
## Opção 2: Deploy com Build no Coolify (Mais Simples)
|
||||
|
||||
**Use se:** Quer começar rápido sem configurar Docker Hub
|
||||
|
||||
### Passo 1: Criar Aplicação no Coolify
|
||||
|
||||
1. **Projects** → **+ New Resource** → **Docker Compose Empty**
|
||||
2. Configure:
|
||||
- **Name**: `opensheets`
|
||||
- **Source**: Conecte ao repositório
|
||||
- **Branch**: `main`
|
||||
- **Docker Compose Location**: `docker-compose.yml` (ou deixe vazio)
|
||||
|
||||
### Passo 2: Variáveis de Ambiente
|
||||
|
||||
```bash
|
||||
# PostgreSQL
|
||||
POSTGRES_USER=opensheets
|
||||
POSTGRES_PASSWORD=SENHA_FORTE_AQUI
|
||||
POSTGRES_DB=opensheets_db
|
||||
DATABASE_URL=postgresql://opensheets:MESMA_SENHA_ACIMA@db:5432/opensheets_db
|
||||
|
||||
# Better Auth
|
||||
BETTER_AUTH_SECRET=GERAR_COM_OPENSSL
|
||||
BETTER_AUTH_URL=https://seu-dominio.com
|
||||
```
|
||||
|
||||
**Gerar secrets:**
|
||||
```bash
|
||||
openssl rand -base64 32 # Para POSTGRES_PASSWORD
|
||||
openssl rand -base64 32 # Para BETTER_AUTH_SECRET
|
||||
```
|
||||
|
||||
**⚠️ IMPORTANTE:** A senha em `POSTGRES_PASSWORD` e `DATABASE_URL` deve ser igual!
|
||||
|
||||
### Passo 3: Deploy
|
||||
|
||||
1. Clique em **Deploy**
|
||||
2. Coolify faz **build completo** (2-5 min) 🐢
|
||||
3. PostgreSQL e app sobem juntos
|
||||
|
||||
---
|
||||
|
||||
## Opção 3: PostgreSQL Separado
|
||||
|
||||
**Vantagens:**
|
||||
- ✅ Backups automáticos do Coolify
|
||||
- ✅ Monitoring independente
|
||||
- ✅ Melhor para produção
|
||||
|
||||
<details>
|
||||
<summary>Ver instruções detalhadas</summary>
|
||||
|
||||
### Passo 1: Criar PostgreSQL
|
||||
|
||||
1. **Databases** → **+ New Database** → **PostgreSQL 18**
|
||||
2. Configure nome, usuário, senha
|
||||
3. Copie a **Internal Connection String**
|
||||
|
||||
### Passo 2: Criar Aplicação
|
||||
|
||||
1. **Docker Compose Empty** → apontar para `docker-compose.coolify.yml`
|
||||
2. Configurar variáveis (DATABASE_URL aponta para PostgreSQL separado)
|
||||
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
## Variáveis de Ambiente Opcionais
|
||||
|
||||
```bash
|
||||
# Email (Resend)
|
||||
RESEND_API_KEY=re_...
|
||||
EMAIL_FROM=noreply@seu-dominio.com
|
||||
|
||||
# OAuth Google
|
||||
GOOGLE_CLIENT_ID=...
|
||||
GOOGLE_CLIENT_SECRET=...
|
||||
|
||||
# OAuth GitHub
|
||||
GITHUB_CLIENT_ID=...
|
||||
GITHUB_CLIENT_SECRET=...
|
||||
|
||||
# AI Providers
|
||||
ANTHROPIC_API_KEY=sk-ant-...
|
||||
OPENAI_API_KEY=sk-...
|
||||
GOOGLE_GENERATIVE_AI_API_KEY=...
|
||||
OPENROUTER_API_KEY=...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Configurar Domínio
|
||||
|
||||
1. No Coolify: **Domains**
|
||||
2. Adicione seu domínio
|
||||
3. SSL automático via Let's Encrypt
|
||||
|
||||
---
|
||||
|
||||
## Verificação de Deploy
|
||||
|
||||
1. **Health Check**: `https://seu-dominio.com/api/health`
|
||||
```json
|
||||
{"status":"ok","timestamp":"...","service":"opensheets-app"}
|
||||
```
|
||||
|
||||
2. **Logs**: No Coolify → Logs
|
||||
|
||||
3. **Database**: Verificar se migrations rodaram
|
||||
|
||||
---
|
||||
|
||||
## Comparação das Opções
|
||||
|
||||
| | Docker Hub | Build no Coolify | PostgreSQL Separado |
|
||||
|---|---|---|---|
|
||||
| **Tempo de deploy** | ⚡ Segundos | 🐢 2-5 min | 🐢 2-5 min |
|
||||
| **Complexidade** | Médio (setup inicial) | Fácil | Médio |
|
||||
| **CI/CD** | ✅ Automático | ❌ Manual | ✅ Possível |
|
||||
| **Rollback** | ✅ Fácil (trocar tag) | ❌ Rebuild | ✅ Fácil |
|
||||
| **Backups DB** | ❌ Manual | ❌ Manual | ✅ Automático |
|
||||
| **Ideal para** | Produção | Desenvolvimento/Teste | Produção crítica |
|
||||
|
||||
---
|
||||
|
||||
## Atualizações
|
||||
|
||||
### Com Docker Hub (Opção 1):
|
||||
```bash
|
||||
# Fazer alterações
|
||||
git add .
|
||||
git commit -m "feat: nova funcionalidade"
|
||||
git push origin main
|
||||
# → GitHub Actions publica nova imagem automaticamente
|
||||
|
||||
# No Coolify: Redeploy (faz pull da nova imagem)
|
||||
```
|
||||
|
||||
### Com Build no Coolify (Opção 2):
|
||||
```bash
|
||||
git push origin main
|
||||
# No Coolify: Redeploy (faz build novamente)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Deploy demora muito
|
||||
**Causa:** Fazendo build completo
|
||||
**Solução:** Use Opção 1 (Docker Hub)
|
||||
|
||||
### Erro de conexão com banco
|
||||
**Causa:** DATABASE_URL incorreta
|
||||
**Solução:** Verificar host (`db` para compose local, ou nome do serviço no Coolify)
|
||||
|
||||
### Migrations não executam
|
||||
**Solução:** Executar manualmente no terminal do container:
|
||||
```bash
|
||||
pnpm db:push
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Recursos
|
||||
|
||||
- [Documentação Coolify](https://coolify.io/docs)
|
||||
- [Guia Docker Hub](./DOCKER_HUB.md)
|
||||
- [Next.js Deployment](https://nextjs.org/docs/deployment)
|
||||
- [Drizzle Migrations](https://orm.drizzle.team/docs/migrations)
|
||||
|
||||
---
|
||||
|
||||
## Próximos Passos
|
||||
|
||||
1. ✅ Configurar domínio personalizado
|
||||
2. ✅ Configurar OAuth (Google, GitHub)
|
||||
3. ✅ Configurar email (Resend)
|
||||
4. ✅ Configurar AI providers
|
||||
5. ✅ Configurar backups (se PostgreSQL separado)
|
||||
6. ✅ Configurar monitoring
|
||||
130
DEPLOY_README.md
Normal file
130
DEPLOY_README.md
Normal file
@@ -0,0 +1,130 @@
|
||||
# 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
|
||||
303
DOCKER_HUB.md
Normal file
303
DOCKER_HUB.md
Normal file
@@ -0,0 +1,303 @@
|
||||
# Publicação no Docker Hub
|
||||
|
||||
Este guia mostra como publicar a imagem do OpenSheets no Docker Hub e usar no Coolify.
|
||||
|
||||
## 🚀 Resumo Rápido
|
||||
|
||||
1. **Configurar secrets no GitHub** (DOCKER_USERNAME e DOCKER_PASSWORD)
|
||||
2. **Push para main ou criar tag** → GitHub Actions publica automaticamente
|
||||
3. **No Coolify:** usar `docker-compose.prod.yml` apontando para sua imagem do Docker Hub
|
||||
|
||||
---
|
||||
|
||||
## Opção 1: Publicação Automática (GitHub Actions)
|
||||
|
||||
### Passo 1: Criar Access Token no Docker Hub
|
||||
|
||||
1. Acesse [Docker Hub](https://hub.docker.com/)
|
||||
2. Faça login na sua conta
|
||||
3. Vá em **Account Settings** → **Security** → **New Access Token**
|
||||
4. Configure:
|
||||
- **Description**: `GitHub Actions - OpenSheets`
|
||||
- **Access permissions**: `Read & Write`
|
||||
5. Clique em **Generate** e **copie o token** (você não verá novamente!)
|
||||
|
||||
### Passo 2: Configurar Secrets no GitHub
|
||||
|
||||
1. Vá no seu repositório GitHub
|
||||
2. **Settings** → **Secrets and variables** → **Actions**
|
||||
3. Clique em **New repository secret**
|
||||
4. Adicione 2 secrets:
|
||||
|
||||
**Secret 1:**
|
||||
- **Name**: `DOCKER_USERNAME`
|
||||
- **Value**: seu username do Docker Hub (ex: `felipecoutinho`)
|
||||
|
||||
**Secret 2:**
|
||||
- **Name**: `DOCKER_PASSWORD`
|
||||
- **Value**: o access token copiado acima
|
||||
|
||||
### Passo 3: Publicar a Imagem
|
||||
|
||||
O workflow `.github/workflows/docker-publish.yml` já está configurado e vai publicar automaticamente quando você:
|
||||
|
||||
#### Opção A: Push para main (cria tag `latest`)
|
||||
```bash
|
||||
git add .
|
||||
git commit -m "feat: nova versão"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
Isso vai gerar as tags:
|
||||
- `seu-usuario/opensheets:latest`
|
||||
- `seu-usuario/opensheets:main`
|
||||
- `seu-usuario/opensheets:main-abc123` (hash do commit)
|
||||
|
||||
#### Opção B: Criar release com tag semântica (recomendado)
|
||||
```bash
|
||||
# Criar tag de versão
|
||||
git tag v1.0.0
|
||||
git push origin v1.0.0
|
||||
```
|
||||
|
||||
Isso vai gerar as tags:
|
||||
- `seu-usuario/opensheets:latest`
|
||||
- `seu-usuario/opensheets:1.0.0`
|
||||
- `seu-usuario/opensheets:1.0`
|
||||
- `seu-usuario/opensheets:1`
|
||||
|
||||
### Passo 4: Verificar Publicação
|
||||
|
||||
1. Acesse [Docker Hub](https://hub.docker.com/)
|
||||
2. Vá em **Repositories**
|
||||
3. Você verá `seu-usuario/opensheets` com as tags publicadas
|
||||
|
||||
Ou verifique pelo terminal:
|
||||
```bash
|
||||
docker pull seu-usuario/opensheets:latest
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Opção 2: Publicação Manual
|
||||
|
||||
Se preferir publicar manualmente sem GitHub Actions:
|
||||
|
||||
### Passo 1: Login no Docker Hub
|
||||
```bash
|
||||
docker login
|
||||
# Digite seu username e password/token
|
||||
```
|
||||
|
||||
### Passo 2: Build da Imagem
|
||||
```bash
|
||||
# Build com tag do seu usuário
|
||||
docker build -t seu-usuario/opensheets:latest .
|
||||
|
||||
# Opcional: criar tags adicionais
|
||||
docker tag seu-usuario/opensheets:latest seu-usuario/opensheets:v1.0.0
|
||||
```
|
||||
|
||||
### Passo 3: Push para o Docker Hub
|
||||
```bash
|
||||
# Enviar a imagem
|
||||
docker push seu-usuario/opensheets:latest
|
||||
|
||||
# Se criou tags adicionais
|
||||
docker push seu-usuario/opensheets:v1.0.0
|
||||
```
|
||||
|
||||
### Passo 4: Verificar
|
||||
```bash
|
||||
docker pull seu-usuario/opensheets:latest
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Usando no Coolify
|
||||
|
||||
### Opção A: Docker Compose Production (Recomendado)
|
||||
|
||||
1. **No Coolify:**
|
||||
- Projects → + New Resource → **Docker Compose Empty**
|
||||
- Conecte ao repositório
|
||||
- **Docker Compose Location**: `docker-compose.prod.yml`
|
||||
|
||||
2. **Configure variáveis de ambiente:**
|
||||
```bash
|
||||
# Configuração da imagem do Docker Hub
|
||||
DOCKER_USERNAME=seu-usuario
|
||||
IMAGE_TAG=latest
|
||||
|
||||
# PostgreSQL
|
||||
POSTGRES_USER=opensheets
|
||||
POSTGRES_PASSWORD=SENHA_FORTE_AQUI
|
||||
POSTGRES_DB=opensheets_db
|
||||
DATABASE_URL=postgresql://opensheets:SENHA_FORTE_AQUI@db:5432/opensheets_db
|
||||
|
||||
# Better Auth
|
||||
BETTER_AUTH_SECRET=GERAR_COM_OPENSSL
|
||||
BETTER_AUTH_URL=https://seu-dominio.com
|
||||
```
|
||||
|
||||
3. **Deploy**
|
||||
- Clique em Deploy
|
||||
- O Coolify vai fazer **pull da imagem** do Docker Hub (não build!)
|
||||
- Muito mais rápido! ⚡
|
||||
|
||||
### Opção B: Editar docker-compose.prod.yml antes
|
||||
|
||||
Você pode editar o arquivo e fixar sua imagem:
|
||||
|
||||
```yaml
|
||||
app:
|
||||
image: felipecoutinho/opensheets:latest # Seu usuário aqui
|
||||
# ... resto da configuração
|
||||
```
|
||||
|
||||
Depois fazer commit e push. No Coolify vai usar direto a imagem configurada.
|
||||
|
||||
---
|
||||
|
||||
## Vantagens de Usar Imagem do Docker Hub
|
||||
|
||||
✅ **Deploy mais rápido** - Apenas pull da imagem (segundos) vs build completo (minutos)
|
||||
✅ **Mesma imagem em múltiplos ambientes** - Staging, produção, testes
|
||||
✅ **Rollback fácil** - Trocar tag da imagem para versão anterior
|
||||
✅ **CI/CD automatizado** - Push no GitHub → build automático → disponível no hub
|
||||
✅ **Multi-arch** - Suporte para AMD64 e ARM64 (servidores diferentes)
|
||||
|
||||
---
|
||||
|
||||
## Gestão de Versões
|
||||
|
||||
### Estratégia Recomendada
|
||||
|
||||
```bash
|
||||
# Desenvolvimento contínuo
|
||||
main branch → seu-usuario/opensheets:latest
|
||||
|
||||
# Releases estáveis
|
||||
v1.0.0 → seu-usuario/opensheets:1.0.0
|
||||
v1.1.0 → seu-usuario/opensheets:1.1.0
|
||||
v2.0.0 → seu-usuario/opensheets:2.0.0
|
||||
```
|
||||
|
||||
### Exemplo de Workflow Completo
|
||||
|
||||
```bash
|
||||
# 1. Desenvolver feature
|
||||
git checkout -b feature/nova-funcionalidade
|
||||
# ... fazer alterações ...
|
||||
git add .
|
||||
git commit -m "feat: adiciona nova funcionalidade"
|
||||
|
||||
# 2. Merge para main
|
||||
git checkout main
|
||||
git merge feature/nova-funcionalidade
|
||||
git push origin main
|
||||
# → GitHub Actions publica seu-usuario/opensheets:latest
|
||||
|
||||
# 3. Criar release quando estável
|
||||
git tag v1.1.0
|
||||
git push origin v1.1.0
|
||||
# → GitHub Actions publica:
|
||||
# - seu-usuario/opensheets:1.1.0
|
||||
# - seu-usuario/opensheets:1.1
|
||||
# - seu-usuario/opensheets:1
|
||||
# - seu-usuario/opensheets:latest
|
||||
```
|
||||
|
||||
### No Coolify: Controle de Versões
|
||||
|
||||
```bash
|
||||
# Usar sempre a última versão (auto-update)
|
||||
IMAGE_TAG=latest
|
||||
|
||||
# Fixar versão específica (produção estável)
|
||||
IMAGE_TAG=1.0.0
|
||||
|
||||
# Usar versão minor mais recente
|
||||
IMAGE_TAG=1.1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Erro: "unauthorized: authentication required"
|
||||
|
||||
**Causa:** Secrets não configurados ou token inválido
|
||||
|
||||
**Solução:**
|
||||
1. Verifique se DOCKER_USERNAME e DOCKER_PASSWORD estão nos secrets do GitHub
|
||||
2. Gere um novo access token no Docker Hub
|
||||
3. Atualize o secret DOCKER_PASSWORD
|
||||
|
||||
### Erro: "denied: requested access to the resource is denied"
|
||||
|
||||
**Causa:** Username incorreto ou permissões insuficientes
|
||||
|
||||
**Solução:**
|
||||
1. Verifique se DOCKER_USERNAME está correto (lowercase)
|
||||
2. Certifique-se que o access token tem permissão "Read & Write"
|
||||
|
||||
### Build demora muito no GitHub Actions
|
||||
|
||||
**Causa:** Cache não está funcionando
|
||||
|
||||
**Solução:**
|
||||
- O workflow já usa cache (buildx cache)
|
||||
- Espere o primeiro build (demora mais)
|
||||
- Builds seguintes serão mais rápidos
|
||||
|
||||
### Coolify não encontra a imagem
|
||||
|
||||
**Causa:** Variável DOCKER_USERNAME não configurada ou imagem não existe
|
||||
|
||||
**Solução:**
|
||||
1. Verifique se a imagem existe no Docker Hub
|
||||
2. Configure DOCKER_USERNAME no Coolify
|
||||
3. Tente fazer pull manual: `docker pull seu-usuario/opensheets:latest`
|
||||
|
||||
---
|
||||
|
||||
## Limpeza de Imagens Antigas
|
||||
|
||||
No Docker Hub (free tier tem limite de 1 repositório privado):
|
||||
|
||||
1. Vá em **Repositories** → `opensheets` → **Tags**
|
||||
2. Delete tags antigas que não usa mais
|
||||
3. Mantenha: `latest`, versões estáveis importantes
|
||||
|
||||
Ou use Docker Hub CLI:
|
||||
```bash
|
||||
# Instalar hub-tool
|
||||
brew install docker/hub-tool/hub-tool # macOS
|
||||
|
||||
# Listar tags
|
||||
hub-tool tag ls seu-usuario/opensheets
|
||||
|
||||
# Deletar tag
|
||||
hub-tool tag rm seu-usuario/opensheets:old-tag
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Recursos
|
||||
|
||||
- [Docker Hub](https://hub.docker.com/)
|
||||
- [GitHub Actions - Docker](https://docs.github.com/en/actions/publishing-packages/publishing-docker-images)
|
||||
- [Docker Build Push Action](https://github.com/docker/build-push-action)
|
||||
- [Semantic Versioning](https://semver.org/)
|
||||
|
||||
---
|
||||
|
||||
## Próximos Passos
|
||||
|
||||
Depois de configurar:
|
||||
|
||||
1. ✅ Push código para GitHub → imagem publicada automaticamente
|
||||
2. ✅ No Coolify, usar `docker-compose.prod.yml`
|
||||
3. ✅ Deploy super rápido (apenas pull da imagem)
|
||||
4. ✅ Criar releases com tags quando tiver versões estáveis
|
||||
131
docker-compose.prod.yml
Normal file
131
docker-compose.prod.yml
Normal file
@@ -0,0 +1,131 @@
|
||||
# Docker Compose para Produção (com imagem do Docker Hub)
|
||||
# Uso: docker compose -f docker-compose.prod.yml up -d
|
||||
|
||||
name: opensheets
|
||||
|
||||
services:
|
||||
# ============================================
|
||||
# Serviço: PostgreSQL (Banco de dados)
|
||||
# ============================================
|
||||
db:
|
||||
image: postgres:18-alpine
|
||||
container_name: opensheets_postgres
|
||||
restart: unless-stopped
|
||||
|
||||
environment:
|
||||
POSTGRES_USER: ${POSTGRES_USER:-opensheets}
|
||||
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-opensheets_dev_password}
|
||||
POSTGRES_DB: ${POSTGRES_DB:-opensheets_db}
|
||||
POSTGRES_INITDB_ARGS: "-E UTF8 --locale=C"
|
||||
|
||||
ports:
|
||||
- "${DB_PORT:-5432}:5432"
|
||||
|
||||
volumes:
|
||||
- postgres_data:/var/lib/postgresql/data
|
||||
- ./scripts/postgres/init.sql:/docker-entrypoint-initdb.d/init.sql:ro
|
||||
|
||||
healthcheck:
|
||||
test:
|
||||
[
|
||||
"CMD-SHELL",
|
||||
"pg_isready -U ${POSTGRES_USER:-opensheets} -d ${POSTGRES_DB:-opensheets_db}",
|
||||
]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 10s
|
||||
|
||||
networks:
|
||||
- opensheets_network
|
||||
|
||||
# ============================================
|
||||
# Serviço: Aplicação Next.js (imagem do Docker Hub)
|
||||
# ============================================
|
||||
app:
|
||||
# IMPORTANTE: Substitua 'seu-usuario' pelo seu username do Docker Hub
|
||||
# Exemplo: felipecoutinho/opensheets:latest
|
||||
image: ${DOCKER_USERNAME:-seu-usuario}/opensheets:${IMAGE_TAG:-latest}
|
||||
|
||||
container_name: opensheets_app
|
||||
restart: unless-stopped
|
||||
|
||||
ports:
|
||||
- "${APP_PORT:-3000}:3000"
|
||||
|
||||
environment:
|
||||
NODE_ENV: production
|
||||
|
||||
# Database URL
|
||||
DATABASE_URL: ${DATABASE_URL}
|
||||
|
||||
# Better Auth (OBRIGATÓRIO)
|
||||
BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET}
|
||||
BETTER_AUTH_URL: ${BETTER_AUTH_URL:-http://localhost:3000}
|
||||
|
||||
# Email (opcional)
|
||||
RESEND_API_KEY: ${RESEND_API_KEY:-}
|
||||
EMAIL_FROM: ${EMAIL_FROM:-}
|
||||
|
||||
# OAuth (opcional)
|
||||
GOOGLE_CLIENT_ID: ${GOOGLE_CLIENT_ID:-}
|
||||
GOOGLE_CLIENT_SECRET: ${GOOGLE_CLIENT_SECRET:-}
|
||||
GITHUB_CLIENT_ID: ${GITHUB_CLIENT_ID:-}
|
||||
GITHUB_CLIENT_SECRET: ${GITHUB_CLIENT_SECRET:-}
|
||||
|
||||
# AI Providers (opcional)
|
||||
ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
|
||||
OPENAI_API_KEY: ${OPENAI_API_KEY:-}
|
||||
GOOGLE_GENERATIVE_AI_API_KEY: ${GOOGLE_GENERATIVE_AI_API_KEY:-}
|
||||
OPENROUTER_API_KEY: ${OPENROUTER_API_KEY:-}
|
||||
|
||||
depends_on:
|
||||
db:
|
||||
condition: service_healthy
|
||||
|
||||
networks:
|
||||
- opensheets_network
|
||||
|
||||
# Script de inicialização: roda migrations antes de iniciar
|
||||
entrypoint: ["/bin/sh", "-c"]
|
||||
command:
|
||||
- |
|
||||
echo "🚀 Aguardando banco de dados..."
|
||||
sleep 5
|
||||
|
||||
echo "📦 Rodando migrations..."
|
||||
pnpm db:push || echo "⚠️ Migrations falharam ou já estão atualizadas"
|
||||
|
||||
echo "✅ Iniciando aplicação Next.js..."
|
||||
node server.js
|
||||
|
||||
healthcheck:
|
||||
test:
|
||||
[
|
||||
"CMD",
|
||||
"wget",
|
||||
"--quiet",
|
||||
"--tries=1",
|
||||
"--spider",
|
||||
"http://localhost:3000/api/health",
|
||||
]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 40s
|
||||
|
||||
# ============================================
|
||||
# Volumes
|
||||
# ============================================
|
||||
volumes:
|
||||
postgres_data:
|
||||
name: opensheets_postgres_data
|
||||
driver: local
|
||||
|
||||
# ============================================
|
||||
# Networks
|
||||
# ============================================
|
||||
networks:
|
||||
opensheets_network:
|
||||
name: opensheets_network
|
||||
driver: bridge
|
||||
Reference in New Issue
Block a user