Skip to main content
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 en la consola de AWS.
  2. Selecciona Create distribution.
  1. En Origin domain, ingresa [SUBDOMAIN].mintlify.site, donde [SUBDOMAIN] es el subdomain único de tu proyecto.
  1. En «Web Application Firewall (WAF)», habilita las protecciones de seguridad.
  1. Deja el resto de la configuración con los valores predeterminados.
  2. Selecciona Create distribution.

​
Agregar origen predeterminado

  1. Después de crear la distribución, ve a la pestaña “Origins”.
  1. 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.
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.
  1. 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.
  1. 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).
  1. 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
  1. Ve a Route53 en la consola de AWS.
  2. Ve a la “Hosted zone” de tu dominio principal.
  3. Selecciona Create record.
  1. Activa Alias y luego, en Route traffic to, selecciona la opción Alias to CloudFront distribution.
  1. 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.