Cette page présente la terminologie clé qui s'applique à l'annuaire des services. Consultez ces termes pour mieux comprendre le fonctionnement du Service Directory.
- Point de terminaison
Un point de terminaison est une paire adresse IP/port individuelle qui sert de façade à un service capable de traiter des requêtes. Un service donné peut ne pas avoir de point de terminaison ou en avoir plusieurs. Le point de terminaison peut être une VM, un conteneur, un équilibreur de charge ou toute autre entité capable de gérer les requêtes. Il peut s'agir, par exemple, d'un cluster de serveurs Redis gérés par l'utilisateur.
Les points de terminaison peuvent comporter des annotations facultatives, sous la forme de paires clé-valeur, que les clients peuvent utiliser. Par exemple, un service Redis peut avoir une annotation comme
replica:server. Les annotations peuvent être utilisées pour stocker des URL. Vous pouvez utiliser un outil tel que jq pour extraire la nouvelle URL de la réponse.Pour l'annuaire des services, un point de terminaison ne peut exister que dans un service et est identifié par un nom de point de terminaison qui est un identifiant de chaîne propre à ce service.
- Service
Un service est un ensemble de points de terminaison (IP/ports) qui fournissent un ensemble de comportements. Les clients recherchent un service par son nom, puis se connectent aux points de terminaison qui fournissent ce service. Des annotations facultatives (paires clé-valeur) peuvent également être associées aux services (par exemple,
use_https:true).Un service doit appartenir à un espace de noms. Chaque nom de service doit être unique dans cet espace de noms.
- Espace de noms
Un espace de noms contient un ensemble de noms de services ainsi que leurs informations de point de terminaison. Un espace de noms permet de regrouper des services pour faciliter leur gestion.
Les espaces de noms sont des ressources régionales et appartiennent à un projet. Le nom d'un espace de noms doit être unique pour ce projet et cette région.
Bien qu'un espace de noms soit une ressource régionale, les services qui lui appartiennent peuvent exister n'importe où et être interrogés n'importe où. Nous recommandons aux clients de choisir une région correspondant à l'emplacement où leurs points de terminaison s'exécutent.
- Clients HTTP/gRPC
L'annuaire de services permet de rechercher des noms de services à l'aide d'HTTP/gRPC. Le service et le client ne doivent pas nécessairement se trouver sur le même réseau.
Les opérations de recherche via gRPC sont contrôlées par IAM.
- Zone de l'annuaire des services
Une zone de l'annuaire des services est un type spécifique de zone privée Cloud DNS dont la source d'informations complète et faisant autorité est un espace de noms de l'annuaire des services. Il vous permet de rechercher des données de l'annuaire des services à l'aide de requêtes DNS.
Si un espace de noms est associé à une zone de l'annuaire des services, tous les services de cet espace de noms sont visibles par tous les réseaux autorisés à interroger la zone.