Mapea dominios personalizados

ID de región

El REGION_ID es un código que Google asigna en función de la región que selecciones cuando crees la app. Incluir REGION_ID.r en las URL de App Engine es opcional para las apps existentes y pronto será obligatorio para todas las apps nuevas.

A fin de garantizar una transición sin problemas, estamos actualizando App Engine con lentitud para usar los ID de región. Si aún no actualizamos tu proyecto de Google Cloud, no verás un ID de región para la app. Dado que el ID es opcional para las apps existentes, no necesitas actualizar las URL ni realizar otros cambios una vez que el ID de región esté disponible para las apps existentes.

Obtén más información acerca de los ID de región.

Puedes usar un dominio personalizado en lugar de la dirección predeterminada que App Engine proporciona para tu aplicación.

Para usar un dominio personalizado, asigna el dominio a tu aplicación y, luego, actualiza tus registros DNS. Puedes asignar un dominio simple, como example.com, o un subdominio, como subdomain.example.com. También puedes usar comodines para mapear subdominios.

De forma predeterminada, cuando mapeas un dominio a tu app, App Engine emite un certificado administrado de SSL para las conexiones HTTPS. Para obtener más información sobre cómo usar SSL con el dominio personalizado, incluso con tus propios certificados SSL, consulta Cómo proteger los dominios personalizados con SSL.

Si tu app se encuentra en una de las siguientes regiones, usar dominios personalizados puede agregar bastante latencia a las respuestas:

  • us-west2
  • us-east4
  • northamerica-northeast1
  • southamerica-east1
  • europe-west2
  • europe-west3
  • asia-south1
  • asia-northeast1
  • australia-southeast1

Antes de comenzar

Si no tienes un dominio, compra uno. Puedes usar cualquier registrador de nombres de dominio, pero si usas Google Domains, el dominio se verifica automáticamente para App Engine, por lo que no tendrás que realizar el proceso de verificación de dominio.

Asigna un dominio personalizado a tu app

  1. En Google Cloud Console, ve a la pestaña Dominios personalizados de la página Configuración de App Engine.

    Ir a la página Dominios personalizados

  2. Haz clic en Agregar un dominio personalizado.

  3. Si tu dominio ya está verificado, aparecerá en la sección Selecciona el dominio que deseas usar. Selecciona el dominio en el menú desplegable y haz clic en Continuar.

    Si aún no verificaste tu dominio, haz lo siguiente:

    1. Selecciona Verificar un dominio nuevo en el menú desplegable.
    2. Ingresa tu nombre de dominio simple (como “example.com”) y haz clic en Verificar.

      Incluso si solo deseas asignar un subdominio, como “www.example.com”, ingresa el nombre de dominio simple para verificar la propiedad.

    3. Ingresa la información en la ventana Central para webmasters que aparece. Si deseas obtener ayuda sobre el uso de la Central para webmasters, consulta la ayuda para la Central para Webmasters.

    4. Después de completar los pasos en la Central para webmasters, regresa a la página Agregar un nuevo dominio personalizado en Google Cloud Console.

  4. En la sección Dirige tu dominio a [project-ID], especifica el dominio y los subdominios que deseas asignar.

    Recomendamos asignar el dominio simple y el subdominio www. Puedes agregar más subdominios si los necesitas.

    Después de agregar todas las asignaciones que desees, haz clic en Guardar asignaciones.

  5. Haz clic en Continuar para ver los registros DNS de tu dominio.

    Puedes recuperar estos registros en cualquier momento en la pestaña Dominios personalizados de la página Configuración de App Engine.

  6. Accede al sitio web de tu registrador de dominios y actualiza tus registros DNS con los registros que se muestran en el paso anterior.

Actualiza los registros DNS en el registrador de tu dominio

Después de asignar tu servicio a un dominio personalizado en App Engine, debes actualizar tus registros DNS en tu registrador de dominios. Para tu comodidad, App Engine genera y muestra los registros DNS que debes ingresar.

  1. Puedes recuperar la información del registro DNS para las asignaciones de tu dominio si sigues estos pasos:

    En Google Cloud Console, ve a la pestaña Dominios personalizados de la página Configuración de App Engine. En la página, se enumeran los registros DNS de todos los dominios que asignaste a tu app.

  2. Accede a tu cuenta en el registrador de dominios y abre la página de la configuración de DNS.

  3. Ubica la sección de registros de host de la página de configuración de tu dominio y agrega cada uno de los registros DNS que recuperaste cuando asignaste tu dominio a tu app.

    Ingresa la siguiente información en los campos de registro:

    • Tipo de registro: ingresa el tipo de registro que se muestra en el registro DNS que Google creó para ti (A, AAAA o CNAME).
    • Nombre del registro:
      • En los registros A o AAAA, ingresa @
      • En los registros CNAME, ingresa un nombre de dominio de tercer nivel. Por ejemplo, ingresa www para asignar el subdominio www.example.com.
    • TTL: especifica un TTL según tus necesidades.
    • Datos: ingresa los datos de registro (rrdata) que se muestran en el registro DNS que Google creó para ti.
      • En los registros A o AAAA, los datos del registro son una dirección IP.
      • En los registros CNAME, los datos del registro son un nombre de dominio.
  4. Guarda los cambios en la página de configuración de DNS de la cuenta del dominio. En la mayoría de los casos, estos cambios tardan solo unos minutos en aplicarse, pero en algunos casos pueden tardar varias horas, en función del registrador y el tiempo de actividad (TTL) de los registros DNS anteriores de tu dominio. Puedes usar una herramienta de dig, como esta versión de dig en línea, para confirmar que los registros DNS se hayan actualizado de forma correcta.

  5. Navega a tu servicio con su URL nueva para ver si funciona, por ejemplo, https://www.example.com. Ten en cuenta que el certificado SSL automático puede tomar varios minutos en emitirse.

Delega la propiedad a otros usuarios de Google Cloud o cuentas de servicio

Si necesitas delegar la propiedad del dominio a otros usuarios o cuentas de servicio, puedes agregar permisos a través de la página de la Central para webmasters:

  1. Abre la página de verificación de la Central para webmasters.

  2. En Propiedades, haz clic en el dominio al que deseas agregarle un usuario o una cuenta de servicio.

  3. Al final de la lista Propietarios verificados, haz clic en Agregar un propietario y, luego, ingresa el ID de una cuenta de servicio o una dirección de correo electrónico de una Cuenta de Google.

    Para ver una lista de tus cuentas de servicio, abre la página Cuentas de servicio en Cloud Console:

    Ir a la página Cuentas de servicio

Utiliza subdominios

Si configuras una asignación de subdominios de comodines para tu dominio personalizado, tu aplicación entrega solicitudes a cualquier subdominio coincidente.

  • Si el usuario explora un dominio que coincide con el nombre de la versión de una aplicación o el nombre de un servicio, la aplicación entregará esa versión.
  • Si el usuario explora un dominio que coincide con el nombre de un servicio, la aplicación entregará ese servicio.
  • Hay un límite de 20 certificados SSL administrados por semana para cada dominio base. Si alcanzas este límite, App Engine seguirá tratando de emitir los certificados administrados hasta que se hayan entregado todas las solicitudes.

Mapeos de comodines

Puedes utilizar comodines para mapear subdominios en cualquier nivel, a partir de los subdominios de tercer nivel. Por ejemplo, puedes hacerlo si el dominio es example.com y, además, ingresas texto en el campo de dirección web:

  • Cuando se ingresa *.example.com, se mapean todos los subdominios de example.com a tu app.
  • Cuando se ingresa *.private.example.com, se mapean todos los subdominios de private.example.com a tu app.
  • Cuando se ingresa *.nichol.sharks.nhl.example.com, se mapean todos los subdominios de nichol.sharks.nhl.example.com a tu app.
  • Cuando se ingresa *.excogitate.system.example.com, se mapean todos los subdominios de excogitate.system.example.com a tu app.

Puedes usar mapeos de comodines con servicios en App Engine mediante el archivo dispatch.yaml para definir el enrutamiento de solicitudes a servicios específicos.

Si usas G Suite con otros subdominios en tu dominio, como sites y mail, esos mapeos tienen mayor prioridad y aparecen primero, antes de que se realice cualquier mapeo de comodines. Además, si tienes otras aplicaciones de App Engine mapeadas a otros subdominios, esos mapeos también tienen mayor prioridad que en el caso de cualquier mapeo de comodín.

Es posible que algunos proveedores de DNS no funcionen con los mapeos de subdominios de comodines. En concreto, un proveedor de DNS debe permitir comodines en entradas del host CNAME.

Las reglas de enrutamiento de comodines se aplican a las URL que contienen componentes para los servicios, las versiones y las instancias, de acuerdo con las reglas de enrutamiento de servicios de App Engine.

Qué sigue

Protege dominios personalizados con SSL