Registrar un balanceador de carga de red de paso a través externo

En esta página se explica cómo configurar un balanceador de carga de red de tipo pasarela externo para que se registre automáticamente en Directorio de servicios.

Cuando crees tu balanceador de carga, puedes registrarlo como endpoint en un espacio de nombres y un servicio de Directorio de servicios que ya tengas. Las aplicaciones cliente pueden usar Service Directory (con HTTP o gRPC) para resolver la dirección del servicio de balanceador de carga de red de pases externo y conectarse a él directamente.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos y roles de gestión de identidades y accesos.

Permisos

• servicedirectory.endpoints.create
• servicedirectory.endpoints.delete

Roles

• roles/compute.networkAdmin
• roles/compute.securityAdmin
• roles/compute.instanceAdmin

Limitaciones

La integración de Directorio de servicios con balanceadores de carga de red de paso a través externos tiene las siguientes limitaciones:

• El registro automático solo admite balanceadores de carga externos de capa 4. Puedes registrar los servicios de balanceo de carga de Google Kubernetes Engine mediante la integración de GKE. Puedes registrar otros balanceadores de carga externos, balanceadores de carga globales, objetos Ingress y gateways de Google Kubernetes Engine llamando a la API Service Directory.
• Solo puedes usar el registro automático al crear una regla de reenvío. El registro automático mediante la actualización de la CLI de Google Cloud para una regla de reenvío ya existente no está disponible.
• Service Directory no proporciona conectividad, lo que significa que, aunque Service Directory almacena la dirección IP virtual del balanceador de carga de red de paso a través externo, buscar el balanceador de carga de red de paso a través externo en Service Directory no garantiza que puedas conectarte a la dirección IP virtual.

Antes de empezar

Para seguir estas instrucciones, necesitas lo siguiente:

• Ya debes tener un espacio de nombres y un servicio de Directorio de servicios. Si no lo has hecho, crea un espacio de nombres y un servicio siguiendo el procedimiento que se describe en Configurar Service Directory.

  El espacio de nombres y el servicio de Service Directory deben estar en el mismo proyecto y región que la regla de reenvío del balanceador de carga de red de paso a través externo que estés creando.

• Ya debes haber configurado los recursos necesarios para crear una regla de reenvío de un balanceador de carga de red de paso a través externo.

  Para obtener información sobre cómo crear un balanceador de carga de red de paso a través externo, consulte Configurar un balanceador de carga de red de paso a través externo.

Configurar reglas de reenvío para registrar un balanceador de carga de red de paso a través externo en Directorio de servicios

Debes configurar una regla de reenvío para registrar el balanceador de carga de red de paso a través externo en Directorio de servicios. Para registrar un balanceador de carga de red de paso a través externo, consulta la siguiente sección.

Registrar un balanceador de carga de red de paso a través externo

Para registrar un balanceador de carga de red de paso a través externo, ejecuta el comando gcloud compute forwarding-rules create y define la marca service-directory-registration:

gcloud beta compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=EXTERNAL \
    --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

Haz los cambios siguientes:

• FORWARDING_RULE_NAME: nombre de la regla de reenvío que quieras crear
• REGION: la región en la que se creará la regla de reenvío
• RESERVED_IP_ADDRESS: la dirección IP a la que sirve la regla de reenvío
• PROTOCOL_TYPE: el protocolo IP que debe usar 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: nombre completo del servicio de Directorio de servicios en el que quieres registrar el endpoint. Este servicio debe estar en el mismo proyecto y región que la regla de reenvío que se va a crear. Por ejemplo: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME.

Verificar el endpoint

Los endpoints de Directorio de servicios que se crean al registrar un balanceador de carga de red de paso a través externo tienen las siguientes características:

• El endpoint tiene el mismo nombre que la regla de reenvío con el número de puerto especificado (<forwarding rule name>-<port>). Por ejemplo, si crea una regla de reenvío RULE con --port=8080, obtendrá un endpoint llamado RULE-8080. En la misma regla, si ha especificado dos puertos --port=8080, 8081, obtendrá dos endpoints: RULE-8080 y RULE-8081. Si especificas --port=ALL, el punto final de Directorio de servicios se registra con el puerto 0. Si eres el propietario del balanceador de carga de red de paso a través externo, debes asegurarte de que la persona que llama a la API sepa a qué puerto debe conectarse.
• No puedes modificar ni eliminar el endpoint mediante la API pública de Service Directory. El endpoint solo se elimina automáticamente cuando eliminas la regla de reenvío. Esto significa que no puedes eliminar el servicio y el espacio de nombres en el que reside el endpoint mientras exista la regla de reenvío.
• El endpoint en sí no se factura, aunque se aplican los precios habituales a las llamadas a la API que se hagan al endpoint.

Para confirmar que se ha creado el endpoint, resuelve el servicio en Directorio de servicios. Debería ver un endpoint con el mismo nombre que la regla de reenvío y el número de puerto especificado.

Para resolver el servicio en Service Directory, ejecuta el comando gcloud service-directory services resolve:

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

Haz los cambios siguientes:

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

Limpieza

Para eliminar los recursos que has creado, sigue estos pasos.

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

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

   Haz los cambios siguientes:

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

   Para obtener más información, consulta Eliminar una regla de reenvío.

   Para confirmar que al eliminar la regla de reenvío se ha eliminado automáticamente el punto final de Directorio de servicios, ejecuta el comando gcloud service-directory services resolve descrito en la sección Verificar el punto final de tu servicio de Directorio de servicios.

2. Para eliminar el espacio de nombres y el servicio de Directorio de servicios, consulte Eliminar recursos.

Siguientes pasos

• Para obtener una descripción general de Service Directory, consulta el artículo Descripción general de Service Directory.
• Para encontrar soluciones a los problemas habituales que pueden surgir al usar Service Directory, consulta la sección Solución de problemas.