Esta página apresenta a terminologia essencial que se aplica ao diretório de serviços. Reveja estes termos para compreender melhor o funcionamento do diretório de serviços.
- Ponto final
Um ponto final é um par IP/porta individual que está à frente de um serviço que pode processar pedidos. Qualquer serviço pode ter zero ou mais pontos finais. O ponto final pode ser uma VM, um contentor, um balanceador de carga ou outra entidade capaz de processar os pedidos. Um exemplo seria um cluster de servidores Redis geridos pelo utilizador.
Os pontos finais podem ter anotações opcionais, sob a forma de pares chave:valor, que os clientes podem usar. Por exemplo, um serviço Redis pode ter uma anotação como
replica:server. As anotações podem ser usadas para armazenar URLs. Pode usar uma ferramenta como jq para extrair o novo URL da resposta.Para o Service Directory, um ponto final só pode existir num serviço e é identificado com um nome de ponto final que é um identificador de string exclusivo para esse serviço.
- Serviço
Um serviço é uma coleção de pontos finais (IP/portas) que fornecem um conjunto de comportamentos. Os clientes procuram um serviço pelo nome e, em seguida, estabelecem ligação aos pontos finais que fornecem esse serviço. Os serviços também podem ter anotações opcionais (pares de chave-valor) associadas (por exemplo,
use_https:true).Um serviço tem de pertencer a um espaço de nomes. Cada nome de serviço tem de ser exclusivo nesse espaço de nomes.
- Espaço de nomes
Um espaço de nomes contém um conjunto de nomes de serviços juntamente com as respetivas informações de ponto final. Um espaço de nomes é uma forma de agrupar serviços para facilitar a gestão.
Os espaços de nomes são recursos regionais e pertencem a um projeto. O nome de um espaço de nomes tem de ser exclusivo para esse projeto e região.
Embora um espaço de nomes seja um recurso regional, os serviços que pertencem a esse espaço de nomes podem existir em qualquer lugar e ser consultados a partir de qualquer lugar. Recomendamos que os clientes escolham uma região que corresponda ao local onde os respetivos pontos finais estão a ser executados.
- Clientes HTTP/gRPC
O Service Directory suporta a procura de nomes de serviços através de HTTP/gRPC. Não existem requisitos para que o serviço e o cliente estejam na mesma rede.
As operações de pesquisa sobre gRPC são controladas pela IAM.
- Zona do diretório de serviços
Uma zona do Service Directory é um tipo específico de zona privada do Cloud DNS cuja origem completa e autorizada de informações é um espaço de nomes do Service Directory. Permite-lhe procurar dados do diretório de serviços através de pedidos DNS.
Se um espaço de nomes estiver associado a uma zona do Service Directory, todos os serviços nesse espaço de nomes ficam visíveis para todas as redes autorizadas a consultar a zona.