Términos clave

En esta página se incluye la terminología clave que se aplica a Directorio de servicios. Consulta estos términos para entender mejor cómo funciona Directorio de servicios.

Endpoint

Un endpoint es un par puerto-IP concreto que está delante de un servicio y puede gestionar solicitudes. Un servicio determinado puede tener cero o más endpoints. El endpoint puede ser una VM, un contenedor, un balanceador de carga u otra entidad capaz de gestionar las solicitudes. Por ejemplo, un clúster de servidores Redis gestionados por el usuario.

Los endpoints pueden tener anotaciones opcionales en forma de pares clave-valor que los clientes pueden usar. Por ejemplo, un servicio de Redis podría tener una anotación como replica:server. Las anotaciones se pueden usar para almacenar URLs. Puedes usar una herramienta como jq para extraer la nueva URL de la respuesta.

En Directorio de servicios, un punto final solo puede existir en un servicio y se identifica con un nombre de punto final, que es un identificador de cadena único para ese servicio.

Servicio

Un servicio es una colección de endpoints (IP/puertos) que proporcionan un conjunto de comportamientos. Los clientes buscan un servicio por su nombre y, a continuación, se conectan a los puntos finales que proporcionan ese servicio. Los servicios también pueden tener anotaciones opcionales (pares clave-valor) asociadas (por ejemplo, use_https:true).

Un servicio debe pertenecer a un espacio de nombres. Cada nombre de servicio debe ser único dentro de ese espacio de nombres.

Espacio de nombres

Un espacio de nombres contiene un conjunto de nombres de servicio junto con la información de sus puntos finales. Un espacio de nombres es una forma de agrupar servicios para facilitar su gestión.

Los espacios de nombres son recursos regionales y pertenecen a un proyecto. El nombre de un espacio de nombres debe ser único en ese proyecto y región.

Aunque un espacio de nombres es un recurso regional, los servicios que pertenecen a ese espacio de nombres pueden estar en cualquier lugar y se pueden consultar desde cualquier lugar. Recomendamos a los clientes que elijan una región que se corresponda con la ubicación de sus endpoints.

Clientes HTTP/gRPC

Service Directory admite la búsqueda de nombres de servicios mediante HTTP/gRPC. No es necesario que el servicio y el cliente estén en la misma red.

Las operaciones de búsqueda en gRPC se controlan mediante la gestión de identidades y accesos.

Zona de Directorio de servicios

Una zona de Directorio de servicios es un tipo específico de zona privada de Cloud DNS cuya fuente de información completa y autorizada es un espacio de nombres de Directorio de servicios. Te permite buscar datos de Directorio de servicios mediante solicitudes de DNS.

Si un espacio de nombres está asociado a una zona de Service Directory, todos los servicios de ese espacio de nombres serán visibles para todas las redes que tengan permiso para consultar la zona.