AWS Route 53 & CloudFront
Redirige el tráfico de /docs a través de AWS CloudFront y Route 53 hacia tu sitio de Jamdesk. Incluye configuración de distribución, configuración del origen y reglas de comportamiento de caché.
Configura una distribución de CloudFront para reenviar /docs/* a tu sitio de Jamdesk, con Route 53 para DNS. Tarda aproximadamente 15 minutos.
Requisitos previos
- Una cuenta de AWS con acceso a CloudFront y Route 53
- Tu dominio gestionado en Route 53 (o capacidad para actualizar el DNS en otro lugar)
- Tu subdominio de Jamdesk (disponible en la configuración del dashboard)
Paso 1: Crear una distribución de CloudFront
- Abre la consola de CloudFront
- Haz clic en Create Distribution
- Configura el origen:
| Configuración | Valor |
|---|---|
| Origin domain | YOUR_SLUG.jamdesk.app |
| Protocol | HTTPS only |
| Name | jamdesk-docs-origin |
Reemplaza YOUR_SLUG con tu subdominio real de Jamdesk.
Paso 2: Configurar los ajustes del origen
En los ajustes del origen, añade encabezados personalizados para identificar tu dominio:
| Nombre del encabezado | Valor |
|---|---|
X-Forwarded-Host | yoursite.com |
X-Jamdesk-Forwarded-Host | yoursite.com |
Estos encabezados indican a Jamdesk qué dominio está realizando la solicitud. El encabezado X-Jamdesk-Forwarded-Host es obligatorio para la verificación del dominio.
Tu dominio debe estar verificado en el dashboard de Jamdesk antes de que CloudFront pueda servir contenido. Completa el proceso de verificación DNS después de añadir tu dominio.
Paso 3: Crear comportamientos de caché
Añade comportamientos para enrutar /docs/* y las solicitudes de recursos hacia tu origen de Jamdesk:
- Ve a la pestaña Behaviors
- Haz clic en Create Behavior
- Crea tres comportamientos con estos ajustes:
| Patrón de ruta | Origen | Política de caché | Política de solicitud al origen |
|---|---|---|---|
/docs/* | jamdesk-docs-origin | CachingOptimized | AllViewerExceptHostHeader |
/_next/* | jamdesk-docs-origin | CachingOptimized | AllViewerExceptHostHeader |
/_jd/* | jamdesk-docs-origin | CachingOptimized | AllViewerExceptHostHeader |
Establece la Viewer protocol policy en Redirect HTTP to HTTPS para los tres.
Los comportamientos /_next/* y /_jd/* son necesarios para que los recursos estáticos de Next.js (JS, CSS) y los recursos de Jamdesk (fuentes, imágenes, branding) se carguen correctamente.
La política AllViewerExceptHostHeader es obligatoria. Reenvía todos los encabezados excepto Host, lo que permite a Jamdesk recibir la información de solicitud necesaria.
Paso 4: Añadir nombre de dominio alternativo
- En la pestaña General, haz clic en Edit
- En Alternate domain name (CNAME), añade
yoursite.com - Selecciona o solicita un certificado SSL para tu dominio
Paso 5: Configurar Route 53
Crea un registro de alias que apunte a tu distribución de CloudFront:
- Abre la consola de Route 53
- Selecciona tu zona alojada
- Haz clic en Create Record
- Configura:
| Configuración | Valor |
|---|---|
| Record name | yoursite.com (o déjalo en blanco para el apex) |
| Record type | A |
| Alias | Yes |
| Route traffic to | CloudFront distribution |
| Distribution | Selecciona tu distribución |
Paso 6: Verificar
Tras la propagación DNS (normalmente entre 5 y 15 minutos), visita https://yoursite.com/docs para confirmar que tu documentación se carga correctamente.
Resumen completo de la configuración de CloudFront
Distribution Settings:
├── Origin: YOUR_SLUG.jamdesk.app
│ ├── Custom Header: X-Forwarded-Host = yoursite.com
│ └── Custom Header: X-Jamdesk-Forwarded-Host = yoursite.com
├── Behavior: /docs/*
│ ├── Cache Policy: CachingOptimized
│ └── Origin Request Policy: AllViewerExceptHostHeader
├── Behavior: /_next/*
│ ├── Cache Policy: CachingOptimized
│ └── Origin Request Policy: AllViewerExceptHostHeader
├── Behavior: /_jd/*
│ ├── Cache Policy: CachingOptimized
│ └── Origin Request Policy: AllViewerExceptHostHeader
└── Alternate Domain: yoursite.com (with SSL certificate)
Solución de problemas
Asegúrate de que el dominio de origen sea exactamente YOUR_SLUG.jamdesk.app sin el prefijo https://.
Verifica que la política de protocolo del visor esté configurada como "Redirect HTTP to HTTPS" y que tu certificado SSL sea válido.
Crea una invalidación de CloudFront para /docs/* para borrar el contenido en caché tras publicar cambios.
Si ves "Domain is not authorized to serve this content":
- Verifica que tu dominio esté registrado en el dashboard de Jamdesk
- Completa la verificación DNS (registro TXT) para tu dominio
- Asegúrate de que los encabezados personalizados
X-Forwarded-HostyX-Jamdesk-Forwarded-Hostestén configurados en tu configuración de origen - Comprueba que tu dominio esté asignado al proyecto correcto
El dominio debe estar verificado antes de que CloudFront pueda servir la documentación.