Nesta página, mostramos como configurar um namespace do diretório de serviços, adicionar um serviço ao namespace e incluir endpoints em um serviço. Antes de executar os comandos desta página, familiarize-se com os conceitos Visão geral do diretório de serviços e Termos-chave relacionados ao Diretório de serviços.
Crie o projeto
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Service Directory API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Service Directory API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Como configurar recursos do Diretório de serviços
Como configurar um namespace
Crie um namespace para o projeto para a região escolhida. Essa região não precisa ser onde todos os seus serviços e endpoints estão em execução, mas precisam estar próximos, se possível. É possível registrar seus serviços em qualquer região do Diretório de serviços; ainda poderão ser resolvidos globalmente. Os projetos podem ter vários namespaces em uma região, e várias regiões podem ter namespaces. Um único namespace não pode abranger regiões.
Console
- Acesse a página "Namespaces" do Diretório de serviços no Console do Google Cloud.
Acessar a página "Namespaces do diretório de serviços" - Clique em Criar namespace.
- No menu suspenso Região, selecione uma região para o namespace.
- No campo Nome do namespace, dê um nome ao namespace.
- Clique em Criar.
gcloud
Para usar o diretório de serviços na linha de comando, primeiro instale ou atualize para a versão mais recente do SDK do Cloud.
Criar um namespace
gcloud service-directory namespaces create NAMESPACE \ --location REGION
Substitua:
NAMESPACE
: o nome do namespace que você está criando.REGION
: a região do Google Cloud que contém o namespace.
Opcional: defina uma política do IAM no namespace. Fornece ao usuário ou grupo especificado o papel especificado para esse namespace e todos os serviços que pertencem ao namespace.
gcloud service-directory namespaces add-iam-policy-binding NAMESPACE \ --member user:someone@example.com \ --role ROLE \ --location REGION
Substitua:
NAMESPACE
: o nome do namespace que você criou.ROLE
: o papel que você está concedendo.REGION
: a região do Google Cloud que contém o namespace.
C#
Para executar esse código, primeiro configure um ambiente de desenvolvimento em C# e instale o SDK do serviço C#.
Go
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Go e instale o SDK do Go Directory do serviço.
Java
Para executar esse código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK de serviço do Java Directory.
Node.js
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Diretório de serviços.
PHP
Para executar esse código, primeiro configure um ambiente de desenvolvimento PHP e instale o SDK do Service Directory para PHP.
Python
Para executar este código, primeiro configure um ambiente de desenvolvimento do Python e instale o SDK do Python do Diretório de serviços.
Ruby
Para executar esse código, primeiro configure um ambiente de desenvolvimento em Ruby e instale o SDK do Service Directory para Ruby.
Como configurar um serviço
Crie um serviço no namespace. Um serviço consiste em um nome e metadados opcionais relacionados. Há algumas restrições sobre o formato dos nomes de serviço:
- Os nomes de serviço precisam ser exclusivos dentro de um namespace.
- Os nomes de serviços precisam seguir a convenção de nomenclatura dos rótulos de DNS.
Console
- Acesse a página "Namespaces" do Diretório de serviços no Console do Google Cloud.
Acessar a página "Namespaces do diretório de serviços" - Clique em um namespace.
- Clique em Adicionar serviço.
- Digite um Nome de serviço.
- Opcional Para adicionar metadados ao serviço, faça o seguinte:
- Clique em Metadados do serviço.
- Clique em Adicionar metadados.
- Adicione uma Chave e um Valor.
- Para adicionar mais pares de metadados, clique em Adicionar metadados novamente.
- Clique em Criar.
gcloud
Para usar o diretório de serviços na linha de comando, primeiro instale ou atualize para a versão mais recente do SDK do Cloud.
Crie um serviço em um namespace.
gcloud service-directory services create SERVICE \ --metadata KEY_1=VALUE_1,KEY_2=VALUE_2 \ --namespace NAMESPACE \ --location REGION
Substitua:
SERVICE
: o nome do serviço que você está criando.NAMESPACE
: nome que você atribuiu ao namespace contendo seu serviço.REGION
: a região do Google Cloud que contém o namespace.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: string de chave e valor definida em pares.
Opcional: defina uma política do IAM no seu serviço. Fornece ao usuário ou grupo especificado o papel especificado para esse serviço e todos os endpoints que pertencem ao serviço.
gcloud service-directory services add-iam-policy-binding SERVICE \ --member user:someone@example.com \ --role ROLE \ --namespace NAMESPACE \ --location REGION
Substitua:
SERVICE
: o nome do serviço;NAMESPACE
: o nome do namespace que você criou.ROLE
: o papel que você está concedendo.REGION
: a região do Google Cloud que contém o namespace.
C#
Para executar esse código, primeiro configure um ambiente de desenvolvimento em C# e instale o SDK do serviço C#.
Go
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Go e instale o SDK do Go Directory do serviço.
Java
Para executar esse código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK de serviço do Java Directory.
Node.js
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Diretório de serviços.
PHP
Para executar esse código, primeiro configure um ambiente de desenvolvimento PHP e instale o SDK do Service Directory para PHP.
Python
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Python e instale o SDK do Service Directory para Python.
Ruby
Para executar esse código, primeiro configure um ambiente de desenvolvimento em Ruby e instale o SDK do Service Directory para Ruby.
Como configurar um endpoint
Após o registro do serviço, adicione alguns endpoints. Um endpoint consiste em um nome exclusivo e os campos opcionais de endereço, porta e metadados de chave-valor. O endereço, se especificado, precisa ser um endereço IPv4 ou IPv6 válido.
Console
- Acesse a página "Namespaces" do Diretório de serviços no Console do Google Cloud.
Acessar a página "Namespaces do diretório de serviços" - Clique em um namespace.
- Clique em um serviço.
- Clique em Adicionar endpoint.
- Digite um nome de endpoint.
- Digite um endereço IP IPv4 ou IPv6.
- Digite um número de Porta.
- Opcional Se você quiser adicionar metadados ao endpoint, faça o seguinte:
- Clique em Metadados do endpoint.
- Clique em Adicionar metadados.
- Adicione uma Chave e um Valor.
- Para adicionar mais pares de metadados, clique em Adicionar metadados novamente.
- Clique em Criar.
gcloud
Para usar o diretório de serviços na linha de comando, primeiro instale ou atualize para a versão mais recente do SDK do Cloud.
Após o registro do serviço, adicione alguns endpoints.
gcloud service-directory endpoints create ENDPOINT \ --address IP_ADDRESS \ --port PORT_NUMBER \ --metadata KEY_1=VALUE_1,KEY_2=VALUE_2 \ --service SERVICE \ --namespace NAMESPACE \ --location REGION
gcloud service-directory endpoints create ENDPOINT2 \ --address IP_ADDRESS2 \ --port PORT_NUMBER2 \ --service SERVICE \ --namespace NAMESPACE \ --location REGION
Substitua os seguintes valores:
ENDPOINT
eENDPOINT2
: os nomes dos endpoints que você está criando no seu serviço.IP_ADDRESS
eIP_ADDRESS2
: os endereços IPv6 e IPv4 dos endpoints, respectivamente.PORT_NUMBER
ePORT_NUMBER2
: as portas em que os endpoints estão sendo executados.SERVICE
: o nome do serviço que você está criando.NAMESPACE
: nome que você atribuiu ao namespace contendo seu serviço.REGION
: a região do Google Cloud que contém o namespace.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: string de chave e valor definida em pares.
C#
Para executar esse código, primeiro configure um ambiente de desenvolvimento em C# e instale o SDK do serviço C#.
Go
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Go e instale o SDK do Go Directory do serviço.
Java
Para executar esse código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK de serviço do Java Directory.
Node.js
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Diretório de serviços.
PHP
Para executar esse código, primeiro configure um ambiente de desenvolvimento PHP e instale o SDK do Service Directory para PHP.
Python
Para executar este código, primeiro configure um ambiente de desenvolvimento do Python e instale o SDK do Python do Diretório de serviços.
Ruby
Para executar esse código, primeiro configure um ambiente de desenvolvimento em Ruby e instale o SDK do Service Directory para Ruby.
Como resolver um serviço
No diretório de serviço, os clientes resolvem serviços usando DNS, HTTP e gRPC. Resolver o serviço retorna todas as propriedades do serviço, bem como todos os endpoints e metadados.
gcloud
Para usar o diretório de serviços na linha de comando, primeiro instale ou atualize para a versão mais recente do SDK do Cloud.
gcloud service-directory services resolve SERVICE \ --namespace NAMESPACE \ --location REGION
Substitua:
SERVICE
: o nome do serviço que você está criando.NAMESPACE
: o nome do qual você forneceu o namespace que contém seu serviço.REGION
: a região do Google Cloud que contém o namespace.
C#
Para executar esse código, primeiro configure um ambiente de desenvolvimento em C# e instale o SDK do serviço C#.
Go
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Go e instale o SDK do Go Directory do serviço.
Java
Para executar esse código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK de serviço do Java Directory.
Node.js
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Diretório de serviços.
PHP
Para executar esse código, primeiro configure um ambiente de desenvolvimento PHP e instale o SDK do Service Directory para PHP.
Python
Para executar este código, primeiro configure um ambiente de desenvolvimento do Python e instale o SDK do Python do Diretório de serviços.
Ruby
Para executar esse código, primeiro configure um ambiente de desenvolvimento em Ruby e instale o SDK do Service Directory para Ruby.
Excluir recursos
Como excluir um endpoint de um serviço
Console
- Acesse a página "Namespaces" do Diretório de serviços no Console do Google Cloud.
Acessar a página "Namespaces do diretório de serviços" - Clique no namespace do endpoint que você quer excluir.
- Clique no serviço do endpoint que você quer excluir.
- Clique na caixa de seleção ao lado do endpoint que você quer excluir.
- Clique em Excluir.
- Na caixa de diálogo de confirmação, clique em Excluir novamente .
gcloud
Para usar o diretório de serviços na linha de comando, primeiro instale ou atualize para a versão mais recente do SDK do Cloud.
gcloud service-directory endpoints delete ENDPOINT \ --service=SERVICE \ --namespace=NAMESPACE \ --location=REGION
Substitua:
SERVICE
: o nome do serviço que você está criando.NAMESPACE
: nome que você atribuiu ao namespace contendo seu serviço.REGION
: a região do Google Cloud que contém o namespace.
C#
Para executar esse código, primeiro configure um ambiente de desenvolvimento em C# e instale o SDK do serviço C#.
Go
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Go e instale o SDK do Go Directory do serviço.
Java
Para executar esse código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK de serviço do Java Directory.
Node.js
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Diretório de serviços.
PHP
Para executar esse código, primeiro configure um ambiente de desenvolvimento PHP e instale o SDK do Service Directory para PHP.
Python
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Python e instale o SDK do Service Directory para Python.
Ruby
Para executar esse código, primeiro configure um ambiente de desenvolvimento em Ruby e instale o SDK do Service Directory para Ruby.
Como excluir um serviço de um namespace
É possível excluir um serviço que tenha endpoints. Quando um serviço é excluído, todos os endpoints dele também são excluídos.
É possível excluir um serviço que tenha uma zona de diretório de serviços que aponte para ele. Todas as outras consultas DNS para esse serviço retornam NXDOMAIN
.
Console
- Acesse a página "Namespaces" do Diretório de serviços no Console do Google Cloud.
Acessar a página "Namespaces do diretório de serviços" - Clique no namespace do serviço que você quer excluir.
- Clique na caixa de seleção ao lado do serviço que você quer excluir.
- Clique em Excluir.
- Clique em Excluir novamente na caixa de diálogo de confirmação.
gcloud
Para usar o diretório de serviços na linha de comando, primeiro instale ou atualize para a versão mais recente do SDK do Cloud.
gcloud service-directory services delete SERVICE \ --namespace=NAMESPACE \ --location=REGION
Substitua:
SERVICE
: o nome do serviço que você está criando.NAMESPACE
: nome que você atribuiu ao namespace contendo seu serviço.REGION
: a região do Google Cloud que contém o namespace.
C#
Para executar esse código, primeiro configure um ambiente de desenvolvimento em C# e instale o SDK do serviço C#.
Go
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Go e instale o SDK do Go Directory do serviço.
Java
Para executar esse código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK de serviço do Java Directory.
Node.js
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Diretório de serviços.
PHP
Para executar esse código, primeiro configure um ambiente de desenvolvimento PHP e instale o SDK do Service Directory para PHP.
Python
Para executar este código, primeiro configure um ambiente de desenvolvimento do Python e instale o SDK do Python do Diretório de serviços.
Ruby
Para executar esse código, primeiro configure um ambiente de desenvolvimento em Ruby e instale o SDK do Service Directory para Ruby.
Como excluir um namespace
É possível excluir um namespace com serviços e endpoints. Quando um namespace é excluído, todos os serviços e endpoints dele também são excluídos.
É possível excluir um namespace com uma zona de diretório de serviços que aponte para ele. Todas as outras consultas DNS (não incluindo solicitações SOA/NS para a origem da zona) retornam NXDOMAIN
.
Console
- Acesse a página "Namespaces" do Diretório de serviços no Console do Google Cloud.
Acessar a página "Namespaces do diretório de serviços" - Clique na caixa de seleção ao lado do namespace que você quer excluir.
- Clique em Excluir.
- Na caixa de diálogo de confirmação, clique em Excluir novamente.
gcloud
Para usar o diretório de serviços na linha de comando, primeiro instale ou atualize para a versão mais recente do SDK do Cloud.
gcloud service-directory namespaces delete NAMESPACE \ --location=REGION
Substitua:
NAMESPACE
: nome que você atribuiu ao namespace contendo seu serviço.REGION
: a região do Google Cloud que contém o namespace.
C#
Para executar esse código, primeiro configure um ambiente de desenvolvimento em C# e instale o SDK do serviço C#.
Go
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Go e instale o SDK do Go Directory do serviço.
Java
Para executar esse código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK de serviço do Java Directory.
Node.js
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Diretório de serviços.
PHP
Para executar esse código, primeiro configure um ambiente de desenvolvimento PHP e instale o SDK do Service Directory para PHP.
Python
Para executar este código, primeiro configure um ambiente de desenvolvimento do Python e instale o SDK do Python do Diretório de serviços.
Ruby
Para executar esse código, primeiro configure um ambiente de desenvolvimento em Ruby e instale o SDK do Service Directory para Ruby.
A seguir
- Para configurar uma zona do Diretório de serviços a fim de consultar o serviço usando DNS, consulte Zona do diretório de serviços.
- Para uma visão geral do Diretório de serviços, consulte esta página.
- Para encontrar soluções para problemas comuns que podem ser encontrados ao usar o Diretório de serviços, consulte Solução de problemas.