Despliegue - Introducción
Esta sección cubre todo lo necesario para desplegar Floutic en producción y staging. Floutic tiene 4 entornos: desarrollo local, desarrollo con Mailpit, staging (dev.floutic.com) y producción (floutic.com).
Pre-requisitos
- Infraestructura: host Linux (Ubuntu 22.04 LTS o similar) con Docker 24+ y Docker Compose v2
- Recursos: Recomendado: 4 vCPU, 8 GB RAM y 50 GB de disco SSD para entornos pequeños
- Networking: Abrir puertos 80/443 (reverse proxy) y restringir 5432 (PostgreSQL) y 6379 (Redis) a la red interna
- Dominio: DNS apuntando a los hosts públicos (
FRONTEND_HOST,BACKEND_HOST,DOCS_HOST) - Certificados TLS: Manejar certificados vía Traefik/Caddy/NGINX (Let's Encrypt)
Entornos del proyecto
| Entorno | Archivo Docker | DB | Redis | Dominio | Gestión |
|---|---|---|---|---|---|
| Local dev | docker-compose.yml | floutic (local) | DB 0 (local) | localhost | Manual |
| Local dev + mailpit | + docker-compose.dev.yml | floutic (local) | DB 0 (local) | localhost | Manual |
| Producción | docker-compose.yml + docker-compose.prod.yml | floutic | DB 0 | floutic.com | Coolify |
| Staging | docker-compose.coolify-staging.yml | floutic_dev (propia) | DB 0 (propio) | dev.floutic.com | Coolify |
:::info Coolify
Staging y producción se gestionan con Coolify. Staging tiene deploy automático desde la branch dev via webhook.
:::
Guías de Despliegue
- Docker - Despliegue con Docker Compose
- Variables de Entorno - Configuración de variables
- Entorno de Staging - Setup y mantenimiento de staging (dev.floutic.com)
- Modos de Despliegue - Desarrollo vs Producción vs Staging
- Checklist de Despliegue - Checklist completo
- Configuración de Stripe - Setup de Stripe
- Configuración de GoHighLevel - Setup de GHL
Pasos Principales
- Preparar infraestructura - Servidor, DNS, certificados
- Configurar variables de entorno - Secretos y configuración
- Construir imágenes - Docker images para producción
- Aplicar migraciones - Base de datos
- Desplegar servicios - Backend, Frontend, Docs
- Verificar funcionamiento - Health checks y tests
Documentación Adicional
Para más detalles, consulta: