Registra un balanceador de cargas interno

En esta página, se proporciona información para configurar un balanceador de cargas de red de transferencia interno o un balanceador de cargas de aplicaciones interno (vista previa) para que se registre automáticamente en el Directorio de servicios.

Cuando creas el balanceador de cargas, puedes registrarlo como un extremo en un espacio de nombres existente del Directorio de servicios y en un servicio de tu preferencia. Luego, las aplicaciones cliente pueden usar el Directorio de servicios (con HTTP o gRPC) o DNS (si creaste una zona de DNS del Directorio de servicios) para resolver la dirección del servicio del balanceador de cargas interno y conectarse directamente.

Limitaciones

La integración del Directorio de servicios con el balanceo de cargas interno tiene las siguientes limitaciones:

  • El registro automático solo se aplica a los balanceadores de cargas internos y de red. Puedes registrar los servicios de balanceo de cargas de Google Kubernetes Engine con la integración de GKE. Puedes registrar balanceadores de cargas globales, y las puertas de enlace y las entradas de Google Kubernetes Engine llamando a la API del Directorio de servicios.
  • Puedes usar el registro automático solo en el momento de la creación de la regla de reenvío. El registro automático con la actualización de Google Cloud CLI para una regla de reenvío ya existente no está disponible.
  • Puedes registrar balanceadores de cargas internos en el Directorio de servicios en los proyectos host o de servicio de una configuración de red de VPC compartida. Sin embargo, todos los componentes y backends del balanceo de cargas deben existir en el mismo proyecto. Para obtener más detalles, consulta las limitaciones del balanceo de cargas interno.
  • El Directorio de servicios no proporciona conectividad, lo que significa que, aunque el Directorio de servicios almacena la dirección IP virtual del balanceador de cargas interno, buscar el balanceador de cargas interno en el Directorio de servicios no garantiza que puedas conectarte a la dirección IP virtual.

Antes de comenzar

Estas instrucciones requieren lo siguiente:

  • Ya debes tener un espacio de nombres y un servicio del Directorio de servicios. Si no lo tienes, crea un espacio de nombres y un servicio con el procedimiento que se describe en Configura el Directorio de servicios.

    El espacio de nombres y el servicio del Directorio de servicios deben estar en el mismo proyecto y región que la regla de reenvío del balanceador de cargas interno que estás creando.

  • Ya debes haber configurado los recursos necesarios para crear una regla de reenvío del balanceador de cargas interno.

Configura reglas de reenvío para registrar un balanceador de cargas interno en el Directorio de servicios

Debes configurar una regla de reenvío para registrar el balanceador de cargas interno en el Directorio de servicios. Para registrar un balanceador de cargas de red de transferencia interno o un balanceador de cargas de aplicaciones interno, consulta las siguientes secciones.

Registra un balanceador de cargas de red de transferencia interno

Para registrar un balanceador de cargas de red de transferencia interno, ejecuta el gcloud compute forwarding-rules create comando y establece la marca service-directory-registration:

gcloud compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=INTERNAL \
    --network=NETWORK_NAME \
    --subnet=SUBNET_NAME \
    --address=RESERVED_IP_ADDRESS \
    --ip-protocol=PROTOCOL_TYPE \
    --ports=PORT_NUMBER \
    --backend-service=BACKEND_SERVICE_NAME \
    --backend-service-region=REGION \
    --service-directory-registration=SD_SERVICE_NAME

Reemplaza lo siguiente:

  • FORWARDING_RULE_NAME: un nombre para la regla de reenvío que deseas crear
  • REGION: la región en la que se creará la regla de reenvío
  • NETWORK_NAME: la red a la que se aplica esta regla de reenvío
  • SUBNET_NAME: la subred a la que se aplica esta regla de reenvío
  • RESERVED_IP_ADDRESS: la dirección IP que entrega la regla de reenvío
  • PROTOCOL_TYPE: el protocolo IP que entregará la regla
  • PORT_NUMBER: una lista de puertos separados por comas
  • BACKEND_SERVICE_NAME: el servicio de backend de destino que recibe el tráfico
  • SD_SERVICE_NAME: el nombre completamente calificado del servicio de Directorio de servicios en el que deseas registrar el extremo. Debe estar en el mismo proyecto y región que la regla de reenvío que se crea. Por ejemplo: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME.

Registra un balanceador de cargas de aplicaciones interno

Para registrar un balanceador de cargas de aplicaciones interno regional, ejecuta el gcloud compute forwarding-rules create comando y establece la marca service-directory-registration:

gcloud beta compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=INTERNAL_MANAGED \
    --network=NETWORK_NAME \
    --address=RESERVED_IP_ADDRESS \
    --target-https-proxy=PROXY_NAME \
    --target-https-proxy-region=PROXY_REGION \
    --ports=PORT_NUMBER \
    --service-directory-registration=SD_SERVICE_NAME

Reemplaza lo siguiente:

  • FORWARDING_RULE_NAME: un nombre para la regla de reenvío que deseas crear
  • REGION: la región en la que se creará la regla de reenvío
  • NETWORK_NAME: la red a la que se aplica esta regla de reenvío
  • RESERVED_IP_ADDRESS: la dirección IP que entrega la regla de reenvío
  • PROXY_NAME: el proxy de destino que recibe el tráfico
  • PROXY_REGION: la región del proxy en la que se operará
  • PORT_NUMBER: una lista de puertos separados por comas
  • SD_SERVICE_NAME: el nombre completamente calificado del servicio de Directorio de servicios en el que deseas registrar el extremo. Este servicio debe estar en el mismo proyecto y región que la regla de reenvío que se crea. Por ejemplo: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME.

Verifica el extremo

Uno o más extremos del Directorio de servicios que se crean cuando registras un balanceador de cargas interno tienen las siguientes características:

  • El extremo tiene el mismo nombre que el de la regla de reenvío con el número de puerto especificado (<forwarding rule name>-<port>). Por ejemplo, si creas una regla de reenvío RULE con --port=8080, obtienes un extremo llamado RULE-8080. Para la misma regla, si especificaste dos puertos --port=8080, 8081, obtienes dos extremos, RULE-8080 y RULE-8081. Si especificas --port=ALL, el extremo del Directorio de servicios se registra con el puerto 0. Si eres el propietario del balanceador de cargas interno, debes asegurarte de que el llamador de la API sepa a qué puerto conectarse.
  • No puedes modificar ni borrar el extremo con la API pública del Directorio de servicios. El extremo se borra automáticamente solo cuando borras la regla de reenvío. Esto significa que no puedes borrar el servicio y el espacio de nombres en el que reside el extremo mientras exista la regla de reenvío.
  • El extremo en sí no se factura, aunque los detalles de precios normales se aplican a cualquier llamada a la API al extremo.

Para confirmar que se creó el extremo, resuelve el servicio en el Directorio de servicios. Deberías ver un extremo con el mismo nombre que el de la regla de reenvío con el número de puerto especificado.

Para resolver el servicio en el Directorio de servicios, haz lo siguiente:

gcloud

Ejecuta el gcloud service-directory services resolve comando:

gcloud service-directory services resolve SD_SERVICE_NAME \
    --namespace=SD_NAMESPACE_NAME \
    --location=REGION

Reemplaza lo siguiente:

  • SD_SERVICE_NAME: el nombre del servicio del Directorio de servicios que se resolverá. Debe estar en el nombre del espacio de nombres del Directorio de servicios.
  • SD_NAMESPACE_NAME: el nombre que le diste al espacio de nombres que contiene tu servicio.
  • REGION: la Google Cloud región que contiene el espacio de nombres. Debe ser la misma que la región en la que creaste la regla de reenvío.

Opcional: Crea una zona del Directorio de servicios con Cloud DNS

Puedes resolver los extremos del Directorio de servicios que se registran a través de esta integración con DNS como cualquier otro extremo del Directorio de servicios. Para crear una zona del Directorio de servicios con Cloud DNS, consulta Configura una zona del Directorio de servicios.

Para verificar que tu zona esté configurada correctamente, puedes ejecutar una consulta de DNS de tu zona del Directorio de servicios. Si deseas obtener instrucciones sobre cómo realizar una consulta con DNS, consulta Cómo realizar una consulta con DNS. Si tu zona está configurada correctamente, deberías ver la dirección IP de tu balanceador de cargas interno en el resultado del comando.

Limpieza

Para borrar los recursos que creaste, haz lo siguiente:

gcloud

  1. Para borrar la regla de reenvío, ejecuta el gcloud compute forwarding-rules delete comando:

    gcloud compute forwarding-rules delete FORWARDING_RULE_NAME \
  --region=REGION \

    Reemplaza lo siguiente:

    • FORWARDING_RULE_NAME: el nombre de la regla de reenvío que creaste
    • REGION: la región para la regla de reenvío

    Para obtener más detalles, consulta Borra una regla de reenvío.

    Para confirmar que borrar la regla de reenvío borró automáticamente el extremo del Directorio de servicios, ejecuta el gcloud service-directory services resolve comando que se describe en la sección Verifica el extremo en tu servicio del Directorio de servicios.

  2. Para borrar la zona, si creaste una, sigue las instrucciones que se indican en Borra una zona administrada.

  3. Para borrar el espacio de nombres y el servicio del Directorio de servicios, consulta Borra recursos.

¿Qué sigue?