Skip to content
Docs

📋 Descripción General

Objetivo: Proporcionar una visión completa de cómo Caddy mejora nuestro workflow de desarrollo local, integrando aplicaciones ASP.NET con microservicios externos de forma transparente.

🎯 ¿Qué es Caddy y Por Qué lo Usamos?

Section titled “🎯 ¿Qué es Caddy y Por Qué lo Usamos?”

Definición

Section titled “Definición”

Caddy es un servidor web moderno con configuración automática HTTPS y proxy reverso integrado. En nuestro contexto, actúa como intermediario inteligente entre el navegador y nuestros servicios de desarrollo.

Problema que Resuelve

Section titled “Problema que Resuelve”

Antes de Caddy:

❌ Navegador → http://localhost:80 → Solo aplicación ASP.NET local
❌ APIs externas no accesibles desde la misma URL
❌ Problemas CORS constantes
❌ Diferentes puertos para diferentes servicios
❌ Configuración HTTPS manual y complicada

Con Caddy:

✅ Navegador → https://mi-tenant.local →
   ├── ASP.NET local (puerto 80)
   ├── API ofertas → test-landings-api.xxxxxxx.com
   └── API checkout → pagos.xxxxxxx.com

🏗️ Arquitectura de Nuestra Implementación

Section titled “🏗️ Arquitectura de Nuestra Implementación”

Flujo de Requests

Section titled “Flujo de Requests”
graph TD
    A[🌐 Navegador] --> B[📋 Caddy Proxy
mi-tenant.local:443]

    B --> C{🔍 Análisis de Path}

    C -->|"Path: /"| D[🏠 ASP.NET Local
localhost:80]
    C -->|"Path: /ofertas/*"| E[🎯 API Ofertas
localhost:5250 o test-landings-api]
    C -->|"Path: /pagos/*"| F[💳 API Checkout
pagos.XXXXX.com]

    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style D fill:#e8f5e8
    style E fill:#fff3e0
    style F fill:#fff3e0

Ejemplos de URLs Reales

Section titled “Ejemplos de URLs Reales”

Requests del navegador → Destino real:

Terminal window
# Motor principal
https://mi-tenant.local/ → localhost:80 (ASP.NET local)


# Handlers específicos
https://mi-tenant.local/ofertas/cancun → localhost:5250/render/ofertas/cancun
https://mi-tenant.local/pagos → pagos.XXXXX.com:443/

Beneficios de esta Arquitectura

Section titled “Beneficios de esta Arquitectura”

🔗 URL Unificada

Una sola URL para todo:

  • Frontend: https://mi-tenant.local/
  • APIs: https://mi-motor.local/ofertas
  • Sin problemas CORS
  • Certificados SSL automáticos

🔄 Flexibilidad de Entornos

Switch rápido entre entornos:

  • Dev: Todo local
  • Test: Mix local/remoto
  • Staging: Todo remoto
  • Sin cambiar código frontend

⚡ Performance Optimizado

Características de rendimiento:

  • Connection pooling
  • HTTP/2 automático
  • Compresión gzip
  • Keep-alive inteligente

🛡️ Seguridad Integrada

HTTPS por defecto:

  • Certificados auto-generados
  • TLS 1.3 automático
  • Headers de seguridad
  • Proxy transparente

📊 Métricas y Beneficios

Section titled “📊 Métricas y Beneficios”

Impacto en Desarrollo

Section titled “Impacto en Desarrollo”

Antes de Caddy:

  • ⏱️ Setup inicial: 30-45 minutos
  • 🔧 Configuración CORS: 15 minutos
  • 🔒 Setup HTTPS: 20 minutos
  • 🔄 Cambio de entorno: 10 minutos

Con Caddy:

  • ⏱️ Setup inicial: 5 minutos
  • 🔧 Sin configuración CORS: 0 minutos
  • 🔒 HTTPS automático: 0 minutos
  • 🔄 Cambio de entorno: 30 segundos

⚡ Ahorro total: ~75% del tiempo de setup

🎓 Curva de Aprendizaje

Section titled “🎓 Curva de Aprendizaje”

Para Desarrolladores Nuevos

Section titled “Para Desarrolladores Nuevos”

Conceptos básicos:

  • ✅ Entender qué es un proxy reverso
  • ✅ Configuración básica de Caddyfile
  • ✅ Setup de certificados SSL local
  • ✅ Test de conectividad básica

Tiempo estimado: 2-4 horas

✅ Indicadores de Éxito

Section titled “✅ Indicadores de Éxito”

KPIs Técnicos

Section titled “KPIs Técnicos”
  • ⚡ Tiempo de setup: < 5 minutos por desarrollador
  • 🔄 Uptime: > 99.9% en desarrollo local
  • 📊 Performance: Latencia adicional < 10ms
  • 🐛 Errores de configuración: < 1 por semana por equipo

KPIs de Productividad

Section titled “KPIs de Productividad”
  • 🚀 Onboarding: < 2 horas para nuevo desarrollador
  • 🔄 Context switching: < 1 minuto entre entornos
  • 🛠️ Issues de setup: Reducción del 80%
  • 👥 Satisfacción del equipo: > 4.5/5 en encuestas

🔄 Próximos Pasos

Section titled “🔄 Próximos Pasos”

Dependiendo de tu rol y necesidades:

📞 Soporte y Comunidad

Section titled “📞 Soporte y Comunidad”

Recursos adicionales: