Questa pagina fornisce la terminologia chiave che si applica a Service Directory. Esamina questi termini per comprendere meglio il funzionamento di Service Directory.
- Endpoint
Un endpoint è una singola coppia di IP/porta che rappresenta un servizio in grado di gestire le richieste. Qualsiasi servizio può avere zero o più endpoint. L'endpoint può essere una VM, un container, un bilanciatore del carico o un'altra entità in grado di gestire le richieste. Un esempio è un cluster di server Redis gestiti dall'utente.
Gli endpoint possono avere annotazioni facoltative, sotto forma di coppie chiave:valore, che possono essere utilizzate dai clienti. Ad esempio, un servizio Redis potrebbe avere un'annotazione come
replica:server. Le annotazioni possono essere utilizzate per memorizzare gli URL. Puoi utilizzare uno strumento come jq per estrarre il nuovo URL dalla risposta.Per Service Directory, un endpoint può esistere solo all'interno di un servizio ed è identificato da un nome di endpoint che è un identificatore di stringa univoco per quel servizio.
- Servizio
Un servizio è una raccolta di endpoint (IP/porte) che forniscono un insieme di comportamenti. I client cercano un servizio in base al nome e si connettono agli endpoint che forniscono il servizio. Ai servizi possono essere associate anche annotazioni facoltative (coppie chiave-valore), ad esempio
use_https:true.Un servizio deve appartenere a uno spazio dei nomi. Ogni nome del servizio deve essere univoco all'interno di questo spazio dei nomi.
- Spazio dei nomi
Uno spazio dei nomi contiene un insieme di nomi di servizi insieme alle informazioni sugli endpoint. Uno spazio dei nomi è un mezzo per raggruppare i servizi per facilitarne la gestione.
Gli spazi dei nomi sono risorse regionali e appartengono a un progetto. Il nome di uno spazio dei nomi deve essere univoco per il progetto e la regione.
Sebbene uno spazio dei nomi sia una risorsa regionale, i servizi che appartengono a questo spazio dei nomi possono esistere ovunque ed essere sottoposti a query da qualsiasi luogo. Consigliamo ai clienti di scegliere una regione che corrisponda alla posizione in cui vengono eseguiti i relativi endpoint.
- Client HTTP/gRPC
Service Directory supporta la ricerca dei nomi dei servizi utilizzando HTTP/gRPC. Non è necessario che il servizio e il client si trovino sulla stessa rete.
Le operazioni di ricerca tramite gRPC sono controllate da IAM.
- Zona Service Directory
Una zona Service Directory è un tipo specifico di zona Cloud DNS privata la cui fonte di informazioni completa e autorevole è uno spazio dei nomi Service Directory. Ti consente di cercare i dati di Service Directory utilizzando le richieste DNS.
Se uno spazio dei nomi è associato a una zona di Service Directory, tutti i servizi in quel determinato spazio dei nomi sono visibili a tutte le reti autorizzate a eseguire query sulla zona.