Usa un dominio de prueba

Obtén más información sobre cómo usar registros DNS comodín para configurar un dominio para tu clúster. Debes configurar un dominio a fin de permitir que tus servicios acepten solicitudes y te permitan acceder con fines de prueba.

De forma predeterminada, tus clústeres de Cloud Run for Anthos en Google Cloud usan el dominio base example.com y no permiten solicitudes a tus servicios. Por ejemplo, el envío de solicitudes a http://{service}.{namespace}.example.com falla.

Si deseas habilitar los servicios en tu clúster para que acepten solicitudes, debes configurar tu dominio a fin de que use una de las siguientes opciones:

  • Un servicio DNS comodín gratuito
  • Un dominio personalizado que te pertenezca. Para obtener más información, consulta Asigna dominios personalizados.

Los registros DNS comodín deben usarse solo para pruebas debido a problemas relacionados con la confiabilidad de las solicitudes. Obtén más información sobre los registros DNS comodín.

Antes de comenzar

Asegúrate de haber instalado y configurado el SDK de Cloud y kubectl.

Elige entre un servicio DNS comodín y un dominio personalizado

Cuando desarrollas y pruebas, puedes cambiar el dominio predeterminado para usar un sitio de prueba de DNS comodín. Los ejemplos incluyen:

Si ya tienes un dominio que deseas usar para fines de prueba o no te importa comprar un dominio para fines de prueba, puedes configurar que el dominio predeterminado sea el tuyo. Un dominio personalizado ofrece una mayor confiabilidad para las pruebas.

Obtén la dirección IP externa

Antes de continuar, debes obtener la dirección IP externa del servicio de balanceador de cargas creado para el controlador de entrada de Istio.

Console

Para obtener la dirección IP externa del balanceador de cargas de Google Cloud Console, sigue estos pasos:

  1. Ve a la página de GKE en Cloud Console:
    Ir a la página de GKE

  2. Haz clic en Ingress y servicios.

  3. Identifica el servicio que es el controlador de entrada de Istio de tu clúster. El Tipo del servicio será Balanceador de cargas externo. En la siguiente tabla, se muestra el nombre del servicio según la versión de tu clúster:

    Versión del clúster ISTIO-GATEWAY
    1.15.3-gke.19 y posteriores
    1.14.3-gke.12 y posteriores
    1.13.10-gke.8 y posteriores
    istio-ingress
    Todas las demás versiones istio-ingressgateway
  4. Una vez que encuentres el controlador de entrada de Istio de tu clúster, copia su Extremo. Esta será la dirección IP sin el número de puerto. Por ejemplo, es posible que veas que 00.000.000.000:11 aparece como un extremo, pero solo necesitas copiar 00.000.000.000.

Línea de comandos

Para obtener la IP externa de la puerta de enlace de entrada de Istio, ejecuta lo siguiente:
kubectl get svc istio-ingress -n gke-system
El resultado se ve de la siguiente manera:
NAME            TYPE           CLUSTER-IP     EXTERNAL-IP  PORT(S)
istio-ingress   LoadBalancer   XX.XX.XXX.XX   pending      80:32380/TCP,443:32390/TCP,32400:32400/TCP
La EXTERNAL-IP del balanceador de cargas es la dirección IP que debes usar.

Si usas un servicio comodín, necesitarás la dirección IP externa cuando edites la configuración del clúster. Si usas tu propio dominio personalizado, necesitarás la dirección IP externa para crear o actualizar un registro en tu registrador de dominios.

Configura el dominio de tu clúster

Cloud Run for Anthos usa el ConfigMap config-domain para definir el dominio base de todos los servicios implementados en el clúster. El comando para editar esta configuración variará en función de si usas un servicio de DNS comodín o tu propio dominio personalizado. Puedes repetir estos pasos con diferentes valores si quieres actualizar el dominio del clúster predeterminado en el futuro.

Realiza pruebas con un servicio de DNS comodín

xip.io se usa para demostrar cómo configurar tu dominio a fin de que use un servicio de DNS comodín, pero puedes reemplazarlo con el servicio que elijas.

Console

Para cambiar el dominio base predeterminado de example.com a uno de los servicios de DNS comodín (por ejemplo, xip.io) en Cloud Console, haz lo siguiente:

  1. Ve a la página Mapeos de dominios de Cloud Run for Anthos en Google Cloud Console:
    Ir a la página Mapeos de dominios

  2. Selecciona Agregar asignación > Agregar dominio predeterminado del clúster.

  3. Selecciona la casilla de verificación que está junto a “Aplicar esta asignación de dominio a todos los servicios de Cloud Run for Anthos implementados en este clúster”.

  4. Selecciona tu clúster en el menú desplegable.

  5. En el campo Dominio, ingresa [EXTERNAL-IP].xip.io. Reemplaza lo siguiente:

    • [EXTERNAL-IP] por la dirección IP externa del balanceador de cargas

    • xip.io con el sitio de DNS comodín que usas.

Línea de comandos

Para cambiar el dominio base predeterminado de example.com a uno de los sitios de DNS comodín (por ejemplo, xip.io), usa el siguiente comando:

kubectl patch configmap config-domain --namespace knative-serving --patch \
  '{"data": {"example.com": null, "[EXTERNAL-IP].xip.io": ""}}'

Reemplazar

  • [EXTERNAL-IP] por la dirección IP externa del balanceador de cargas
  • xip.io con el sitio de DNS comodín que usas.

Tu servicio ahora está disponible en {service-name}.{namespace}.{[EXTERNAL-IP].xip.io}.

Realiza pruebas con un dominio personalizado

Si deseas usar un dominio personalizado propio para tu prueba, los siguientes pasos te ayudarán con la configuración.

Primero, actualiza el ConfigMap del clúster para que apunte a tu dominio:

Console

  1. Ve a la página Mapeos de dominios de Cloud Run for Anthos en Google Cloud Console:
    Ir a la página Mapeos de dominios

  2. Selecciona Agregar asignación > Agregar dominio predeterminado del clúster.

  3. Selecciona la casilla de verificación que está junto a “Aplicar esta asignación de dominio a todos los servicios de Cloud Run for Anthos implementados en este clúster”.

  4. Selecciona tu clúster en el menú desplegable.

  5. En el campo Dominio, ingresa el nombre de tu dominio. Por ejemplo, example.com

Línea de comandos

Especifica tu dominio personalizado mediante el siguiente comando:

kubectl patch configmap config-domain --namespace knative-serving --patch \
'{"data": {"example.com": null, "[DOMAIN]": ""}}'

Reemplaza [DOMAIN] por tu propio dominio, por ejemplo, mydomain.com. El comando anterior quita example.com del ConfigMap y agrega mydomain.com como el dominio base predeterminado. Puedes repetir este comando si deseas volver a cambiarlo a otro dominio.

Los pasos restantes se deben realizar en el sitio web del registrador de tu dominio:

  1. Accede a tu cuenta en el Registrador de dominios y, a continuación, abre la página de la configuración de DNS.

  2. Busca la sección de registros del host de la página de configuración del dominio y, luego, agrega los registros de recursos que necesites.

    1. Para agregar un registro DNS a la cuenta en el proveedor de DNS, haz lo siguiente:

      • Selecciona el tipo de registro A.
      • Proporciona el comodín *, como se muestra en el siguiente ejemplo:

        DNS comodín

    2. 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.

Después de actualizar tus registros DNS y vincularlos a tu clúster, tu servicio estará disponible en {service-name}.{namespace}.{your-domain}.