Despliegue

TalentBricksAI usa Fly.io para hosting. Esta guia cubre el despliegue completo.

Prerequisitos

• Cuenta en Fly.io
• Fly CLI instalado
• Stripe configurado en modo produccion
• AWS S3/CloudFront configurado

Instalar Fly CLI

# macOS
brew install flyctl

# Linux
curl -L https://fly.io/install.sh | sh

# Verificar
fly version

Login en Fly

fly auth login

Despliegue Inicial

1. Configurar la Aplicacion

Desde el directorio app/:

wasp deploy fly launch talentbricksai mia

• talentbricksai: nombre de la app
• mia: region (Miami, cercana a Latinoamerica)

Esto crea:

• Aplicacion de servidor
• Base de datos PostgreSQL
• Configuracion de despliegue

2. Configurar Variables de Entorno

# JWT Secret (generar uno seguro)
wasp deploy fly cmd --context server secrets set JWT_SECRET="tu-jwt-secret-muy-seguro-para-produccion"

# Stripe (modo produccion)
wasp deploy fly cmd --context server secrets set STRIPE_SECRET_KEY="sk_live_..."
wasp deploy fly cmd --context server secrets set STRIPE_WEBHOOK_SECRET="whsec_..."

# AWS S3
wasp deploy fly cmd --context server secrets set AWS_ACCESS_KEY_ID="AKIA..."
wasp deploy fly cmd --context server secrets set AWS_SECRET_ACCESS_KEY="..."
wasp deploy fly cmd --context server secrets set AWS_S3_BUCKET="talentbricksai-videos"
wasp deploy fly cmd --context server secrets set AWS_S3_REGION="us-east-1"

# CloudFront
wasp deploy fly cmd --context server secrets set CLOUDFRONT_DOMAIN="d123abc.cloudfront.net"
wasp deploy fly cmd --context server secrets set CLOUDFRONT_KEY_PAIR_ID="K123..."
wasp deploy fly cmd --context server secrets set CLOUDFRONT_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----..."

# SendGrid (emails)
wasp deploy fly cmd --context server secrets set SENDGRID_API_KEY="SG...."

# URL del cliente
wasp deploy fly cmd --context server secrets set CLIENT_URL="https://talentbricksai.fly.dev"

3. Variables del Cliente

Para variables del cliente, editar fly.toml o usar:

wasp deploy fly cmd --context client secrets set REACT_APP_STRIPE_PUBLISHABLE_KEY="pk_live_..."

4. Ejecutar Despliegue

wasp deploy fly deploy

Despliegues Subsecuentes

Para actualizaciones:

cd app
wasp deploy fly deploy

Configuracion de Dominio Personalizado

1. Obtener IP del Servidor

fly ips list -a talentbricksai

2. Configurar DNS

En tu proveedor de DNS, agregar:

Tipo	Host	Valor
A	@	IP_DEL_SERVIDOR
A	www	IP_DEL_SERVIDOR

3. Agregar Dominio en Fly

fly certs add tudominio.com -a talentbricksai
fly certs add www.tudominio.com -a talentbricksai

4. Actualizar Variables

wasp deploy fly cmd --context server secrets set CLIENT_URL="https://tudominio.com"

Configurar Stripe para Produccion

1. Activar Modo Produccion

En Stripe Dashboard:

1. Completar verificacion de cuenta
2. Cambiar a “Live mode”
3. Obtener nuevas API keys

2. Configurar Webhook de Produccion

1. Ir a Developers > Webhooks
2. Add endpoint: https://tudominio.com/stripe-webhook
3. Seleccionar eventos necesarios
4. Copiar signing secret y actualizar variable

Monitoreo

Logs en Tiempo Real

fly logs -a talentbricksai

Dashboard de Fly

Visitar https://fly.io/dashboard para:

• Metricas de uso
• Estado de la base de datos
• Alertas

Conectar a la Base de Datos

fly postgres connect -a talentbricksai-db

Escalar la Aplicacion

Escalar Servidor

# Ver maquinas actuales
fly scale show -a talentbricksai

# Escalar a mas instancias
fly scale count 2 -a talentbricksai

# Cambiar tamano de maquina
fly scale vm shared-cpu-2x -a talentbricksai

Escalar Base de Datos

# Ver estado actual
fly postgres show -a talentbricksai-db

# Escalar
fly postgres scale -a talentbricksai-db --vm-size shared-cpu-2x

Backup de Base de Datos

Backup Manual

# Conectar via proxy
fly proxy 5432 -a talentbricksai-db

# En otra terminal, hacer dump
pg_dump -h localhost -p 5432 -U postgres -d talentbricksai > backup.sql

Restore

psql -h localhost -p 5432 -U postgres -d talentbricksai < backup.sql

Troubleshooting

Ver Logs de Error

fly logs -a talentbricksai | grep -i error

Reiniciar la Aplicacion

fly apps restart talentbricksai

Verificar Estado

fly status -a talentbricksai

Problemas Comunes

Error: “Connection refused”

• Verificar que la base de datos este corriendo
• Revisar variables de entorno

Error: “Stripe webhook failed”

• Verificar STRIPE_WEBHOOK_SECRET
• Asegurar que el endpoint sea accesible

Error: “S3 access denied”

• Verificar credenciales de AWS
• Revisar politicas IAM

Costos Estimados (Fly.io)

Recurso	Costo
App (shared-cpu-1x, 256MB)	~$1.94/mes
App (shared-cpu-2x, 512MB)	~$3.88/mes
PostgreSQL (1GB)	~$1.94/mes
PostgreSQL (10GB)	~$19.40/mes

Total inicial: ~$5-10/mes

Checklist de Produccion

• Variables de entorno configuradas
• Stripe en modo produccion
• Webhook de Stripe configurado
• AWS S3/CloudFront funcionando
• SendGrid configurado para emails
• Dominio personalizado (opcional)
• SSL certificado activo
• Backups de base de datos configurados
• Monitoreo/alertas activos

Siguiente Paso

• Vision General - Revisar arquitectura
• Crear un Curso - Agregar contenido