Go 1.13 ahora está disponible a nivel general.

Mapea dominios personalizados

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 asignar subdominios.

De forma predeterminada, cuando asignas 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.

El uso de dominios personalizados puede agregar una latencia notable a las respuestas que App Engine envía a los usuarios de tu app en algunas regiones. Las regiones son las siguientes:

  • 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. Si usas Google Domains, el dominio se verifica automáticamente para App Engine y no es necesario que realices el proceso de verificación del dominio.

  • Si usas Cloud Load Balancing y NEG sin servidores para enrutar el tráfico a tu app de App Engine, te recomendamos asignar el dominio personalizado al balanceador de cargas, en lugar de hacerlo directamente a tu aplicación, y usar certificados SSL creados para el balanceador de cargas. Esto elimina la necesidad de administrar certificados SSL distintos para cada aplicación sin servidores. Además, con Cloud Load Balancing puedes establecer políticas de SSL que controlan las características de SSL que tu balanceador de cargas negocia con los clientes. Si deseas obtener más información, consulta las páginas siguientes:

    Ten en cuenta la siguiente limitación:

    • No puedes inhabilitar las URL que Google Cloud asigna de forma automática para los servicios de App Engine. Los usuarios que ya tienen la URL predeterminada del servicio de App Engine pueden omitir el balanceador de cargas y dirigirse directamente a la URL del servicio. Esto significa que, aunque puedas configurar las políticas de seguridad de Google Cloud Armor, los certificados SSL y las claves privadas a través del balanceador de cargas, los usuarios con la URL predeterminada pueden eludir estas políticas.

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, la aplicación de estos cambios toma solo unos minutos, pero en algunos casos puede tomar varias horas, en función del registrador y el tiempo de actividad (TTL) de cualquier registro DNS anterior del 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 al servicio con la URL nueva para probar 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.