Nesta página, você encontra a terminologia principal que se aplica ao Diretório de serviços. Leia estes termos para entender melhor como o Diretório de serviços funciona.
- Endpoint
Um endpoint é um par individual de IP/porta que protege um serviço que pode processar solicitações. Qualquer serviço pode ter zero ou mais endpoints. O endpoint pode ser uma VM, um contêiner, um balanceador de carga ou outra entidade capaz de processar as solicitações. Um exemplo seria um cluster de servidores Redis gerenciados pelo usuário.
Os endpoints podem ter anotações opcionais, na forma de pares de 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. Use uma ferramenta como jq para extrair o novo URL da resposta.No Diretório de serviços, um endpoint só pode existir em um serviço e é identificado com um nome de endpoint que é um identificador de string exclusivo para esse serviço.
- Serviço
Um serviço é uma coleção de endpoints (IPs/portas) que fornecem um conjunto de comportamentos. Os clientes procuram um serviço pelo nome e se conectam aos endpoints que fornecem esse serviço. Os serviços também podem ter anotações opcionais (pares de chave-valor) associadas a eles, por exemplo,
use_https:true.Um serviço precisa pertencer a um namespace. Cada nome de serviço precisa ser exclusivo nesse namespace.
- Namespace
Um namespace contém um conjunto de nomes de serviço com as informações do endpoint. Um namespace é uma forma de agrupar serviços para facilitar o gerenciamento.
Os namespaces são recursos regionais e pertencem a um projeto. O nome de um espaço de nomes precisa ser exclusivo para esse projeto e região.
Embora um namespace seja um recurso regional, os serviços que pertencem a ele podem existir em qualquer lugar e ser consultados de qualquer lugar. Recomendamos que os clientes escolham uma região que corresponda ao local em que os endpoints estão em execução.
- Clientes HTTP/gRPC
O Diretório de serviços oferece suporte à pesquisa de nomes de serviços usando HTTP/gRPC. Não há requisitos para que o serviço e o cliente estejam na mesma rede.
As operações de pesquisa no gRPC são controladas pelo IAM.
- Zona do Diretório de serviços
Uma zona do Diretório de serviços é um tipo específico de zona particular do Cloud DNS, em que a fonte de informações completa e confiável é um namespace do Diretório de serviços. Ele permite que você pesquise dados do Diretório de serviços usando solicitações de DNS.
Se um namespace estiver anexado a uma zona do diretório de serviços, todos os serviços nesse namespace vão ficar visíveis para todas as redes que tiverem permissão para consultar a zona.