> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-mintlify-fff028b1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# AWS Route 53 y CloudFront
> Despliega tu documentación de Mintlify en una subruta en AWS usando Route 53 para el enrutamiento DNS y CloudFront como CDN con funciones Lambda@Edge.
Para alojar tu documentación en una subruta como `yoursite.com/docs` con AWS Route 53 y CloudFront, debes configurar tu proveedor de DNS para que apunte a tu distribución de CloudFront.
## Descripción general
Dirige el tráfico a estas rutas con una política de caché **CachingDisabled**:
* `/.well-known/acme-challenge/*` - Obligatorio para la verificación de certificados de Let's Encrypt
* `/.well-known/vercel/*` - Obligatorio para la verificación del dominio
* `/docs/*` - Obligatorio para el enrutamiento por subruta
* `/docs/` - Obligatorio para el enrutamiento por subruta
Dirige el tráfico a esta ruta con una política de caché **CachingEnabled**:
* `/mintlify-assets/_next/static/*`
* `Default (*)` - La página de inicio de tu sitio web
Todos los comportamientos (Behaviors) deben tener una **origin request policy** de `AllViewerExceptHostHeader`.
## Crear una distribución de CloudFront
1. Navega a [CloudFront](https://aws.amazon.com/cloudfront) en la consola de AWS.
2. Selecciona **Create distribution**.
3. En Origin domain, ingresa `[SUBDOMAIN].mintlify.site`, donde `[SUBDOMAIN]` es el subdomain único de tu proyecto.
4. En «Web Application Firewall (WAF)», habilita las protecciones de seguridad.
5. Deja el resto de la configuración con los valores predeterminados.
6. Selecciona **Create distribution**.
## Agregar origen predeterminado
1. Después de crear la distribución, ve a la pestaña "Origins".
2. Busca tu URL de staging que refleje el dominio principal. Esto varía según el proveedor de alojamiento de tu página de inicio. Por ejemplo, la URL de staging de Mintlify es [mintlify-landing-page.vercel.app](https://mintlify-landing-page.vercel.app).
Si Webflow aloja tu página de inicio, usa la URL de staging de Webflow. Se verá como `.webflow.io`.
Si usas Vercel, usa el domain `.vercel.app` disponible para cada proyecto.
3. Crea un nuevo Origin y agrega tu URL de staging como el "Origin domain".
A este punto, deberías tener dos Origins: uno con `[SUBDOMAIN].mintlify.site` y otro con tu URL de staging.
## Configurar comportamientos
Los comportamientos en CloudFront permiten controlar la lógica de subrutas. A grandes rasgos, queremos implementar la siguiente lógica:
* **Si un usuario llega a tu subruta personalizada**, redirigir a `[SUBDOMAIN].mintlify.site`.
* **Si un usuario llega a cualquier otra página**, redirigir a la página de inicio actual.
1. Ve a la pestaña "Behaviors" de tu distribución de CloudFront.
2. Selecciona el botón **Create behavior** y crea los siguientes comportamientos.
### `/.well-known/*`
Crea comportamientos para las rutas de verificación de domain de Vercel con un **Patrón de ruta** de `/.well-known/*` y establece **Origin and origin groups** en la URL de tu documentación.
Para "Cache policy", selecciona **CachingDisabled** para garantizar que estas solicitudes de verificación se procesen sin caché.
Si `.well-known/*` es demasiado genérico, puedes acotarlo a un mínimo de 2 comportamientos para Vercel:
* `/.well-known/vercel/*` - Obligatorio para la verificación de domain de Vercel
* `/.well-known/acme-challenge/*` - Obligatorio para la verificación del certificado de Let's Encrypt
### Tu subruta
Crea un comportamiento con un **Path pattern** de la subruta que elijas, por ejemplo `/docs`, con **Origin and origin groups** apuntando a la URL `.mintlify.site` (en nuestro caso `acme.mintlify.site`).
* Establece "Cache policy" en **CachingOptimized**.
* Establece "Origin request policy" en **AllViewerExceptHostHeader**.
* Establece "Viewer protocol policy" en **Redirect HTTP to HTTPS**.
### Tu subruta con comodín
Crea un comportamiento con un **Path pattern** que sea la subruta que elijas seguida de `/*`, por ejemplo `/docs/*`, y con **Origin and origin groups** apuntando a la misma URL `.mintlify.site`.
Esta configuración debe coincidir exactamente con el comportamiento de tu subruta base, con la excepción de **Path pattern**.
* Establece "Cache policy" en **CachingOptimized**.
* Establece "Origin request policy" en **AllViewerExceptHostHeader**.
* Establece "Viewer protocol policy" en **Redirect HTTP to HTTPS**.
### `/mintlify-assets/_next/static/*`
* Establece la "política de caché" en **CachingOptimized**
* Establece la "política de solicitud de origen" en **AllViewerExceptHostHeader**
* Establece la "política de protocolo del visor" en **Redirect HTTP to HTTPS**
### `Default (*)`
Por último, vamos a editar el comportamiento de `Default (*)`.
1. Cambia **Origin and origin groups** del comportamiento predeterminado a la URL de staging (en nuestro caso, `mintlify-landing-page.vercel.app`).
2. Selecciona **Guardar cambios**.
### Verifica que hayas configurado los comportamientos correctamente
Si sigues los pasos anteriores, tus comportamientos deberían verse así:
## Vista previa de la distribución
Ahora puedes comprobar si configuraste tu distribución correctamente yendo a la pestaña "General" y visitando la URL de **Distribution domain name**.
Todas las páginas deberían redirigir a tu página de inicio principal, pero si agregas la subruta que elegiste, por ejemplo `/docs`, a la URL, deberías ver que te lleva a tu instancia de documentación de Mintlify.
## Conectar con Route 53
Ahora vamos a llevar las capacidades de la distribución de CloudFront a tu dominio principal.
Para esta sección, también puedes consultar la guía oficial de AWS sobre [Configurar
Amazon Route 53 para enrutar el tráfico a una
distribución de CloudFront](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config)
1. Ve a [Route53](https://aws.amazon.com/route53) en la consola de AWS.
2. Ve a la "Hosted zone" de tu dominio principal.
3. Selecciona **Create record**.
4. Activa `Alias` y luego, en **Route traffic to**, selecciona la opción `Alias to CloudFront distribution`.
5. Selecciona **Create records**.
Es posible que tengas que eliminar el registro A existente si ya hay uno.
Tu documentación ahora está disponible en la subruta elegida de tu dominio principal.
Después de configurar tu DNS, los subdominios personalizados suelen estar disponibles en unos minutos. La propagación de DNS a veces puede tardar de 1 a 4 horas y, en casos excepcionales, hasta 48 horas. Si tu subdominio no está disponible de inmediato, espera antes de intentar solucionarlo.