Questa pagina mostra come configurare uno spazio dei nomi Service Directory, registrare un servizio nel relativo spazio dei nomi e aggiungere endpoint a un servizio. Puoi creare uno spazio dei nomi quando registri un servizio o prima di registrarlo.
Prima di eseguire i comandi elencati in questa pagina, familiarizza con i concetti descritti nella panoramica di Service Directory e nei termini chiave relativi a Service Directory.
Configura il progetto
- 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
Configura le risorse di Service Directory
Per compilare Service Directory con i servizi, crea uno spazio dei nomi e registra il servizio nello spazio dei nomi.
Configura uno spazio dei nomi
Per il tuo progetto, crea uno spazio dei nomi nella tua regione. Questa regione non deve necessariamente essere quella in cui sono in esecuzione tutti i servizi e gli endpoint, ma deve essere vicina, se possibile.
Puoi registrare i tuoi servizi in qualsiasi regione di Service Directory; questi servizi continueranno a essere risolvibili a livello globale. All'interno di una regione, i progetti possono avere più spazi dei nomi e questi spazi dei nomi possono essere in regioni diverse. Un singolo spazio dei nomi non può includere più regioni.
Console
Nella console Google Cloud, vai alla pagina Spazi dei nomi di Service Directory.
- Fai clic su Crea spazio dei nomi.
- Nell'elenco Regione, seleziona una regione per il tuo spazio dei nomi.
- Nel campo Nome spazio dei nomi, assegna un nome allo spazio dei nomi.
- Fai clic su Crea.
gcloud
Per utilizzare Service Directory sulla riga di comando, esegui l'installazione o l'upgrade alla versione più recente di Google Cloud CLI.
Crea uno spazio dei nomi
gcloud service-directory namespaces create NAMESPACE \ --location REGION
Sostituisci quanto segue:
NAMESPACE
: il nome dello spazio dei nomi che stai creando.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.
(Facoltativo) Imposta un criterio IAM sullo spazio dei nomi. In questo modo, all'utente o al gruppo specificato viene assegnato il ruolo specificato per questo spazio dei nomi e per tutti i servizi che appartengono allo spazio dei nomi.
gcloud service-directory namespaces add-iam-policy-binding NAMESPACE \ --member user:someone@example.com \ --role ROLE \ --location REGION
Sostituisci quanto segue:
NAMESPACE
: il nome dello spazio dei nomi che hai creato.ROLE
: il ruolo che stai concedendo.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C Directory Service Service.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Service Directory.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java di Service Directory.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Service Directory.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP di Service Directory.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Service Directory.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Service Directory.
Configura un servizio
Crea un servizio nello spazio dei nomi. Un servizio è costituito da un nome e da annotazioni facoltative relative al servizio. Esistono alcune limitazioni relative al formato dei nomi dei servizi:
- I nomi dei servizi devono essere univoci all'interno di uno spazio dei nomi.
- I nomi dei servizi devono rispettare la convenzione di denominazione per le etichette DNS.
Per creare una regola di inoltro Private Service Connect e registrarla come servizio in Service Directory, consulta Registrare un endpoint Private Service Connect in Service Directory.
Per registrare un servizio standard in Service Directory:
Console
Nella console Google Cloud, vai alla pagina Directory dei servizi.
- Fai clic su Registra servizio.
- Fai clic su Standard e poi su Avanti.
- Scegli una regione in cui registrare il servizio.
- Scegli uno spazio dei nomi in cui registrare il servizio.
Se non hai un ambito, segui questi passaggi per crearne uno:
- Nella casella Spazio dei nomi, fai clic su Crea spazio dei nomi.
- Inserisci un nome per lo spazio dei nomi.
- Fai clic su Crea.
- Inserisci un nome del servizio.
- (Facoltativo) Se vuoi aggiungere annotazioni al servizio:
- Fai clic su Aggiungi annotazione.
- Aggiungi una Chiave e un Valore.
- Per aggiungere altre annotazioni, fai di nuovo clic su Aggiungi annotazione.
- Fai clic su Crea.
gcloud
Per utilizzare Service Directory sulla riga di comando, installa o esegui l'upgrade alla versione più recente di Google Cloud CLI.
Crea un servizio in uno spazio dei nomi.
gcloud service-directory services create SERVICE \ --annotations KEY_1=VALUE_1,KEY_2=VALUE_2 \ --namespace NAMESPACE \ --location REGION
Sostituisci quanto segue:
SERVICE
: il nome del servizio che stai creando.NAMESPACE
: il nome dello spazio dei nomi che contiene il tuo servizio.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: stringhe chiave e valore impostate in coppia.
(Facoltativo) Imposta un criterio IAM sul tuo servizio. In questo modo, l'utente o il gruppo specificato ottiene il ruolo specificato per questo servizio e per tutti gli endpoint che appartengono al servizio.
gcloud service-directory services add-iam-policy-binding SERVICE \ --member user:someone@example.com \ --role ROLE \ --namespace NAMESPACE \ --location REGION
Sostituisci quanto segue:
SERVICE
: il nome che hai assegnato al servizio.NAMESPACE
: il nome dello spazio dei nomi che contiene il servizioROLE
: il ruolo che stai concedendo.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C Directory Service Service.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Service Directory.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java di Service Directory.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Service Directory.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP di Service Directory.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Service Directory.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Service Directory.
Configurare un endpoint
Dopo aver registrato il servizio, aggiungi alcuni endpoint. Un endpoint è costituito da un nome univoco, un indirizzo IP facoltativo e una porta, nonché da annotazioni chiave-valore. L'indirizzo IP, se specificato, deve essere un indirizzo IPv4 o IPv6 valido.
Console
Nella console Google Cloud, vai alla pagina Directory dei servizi.
- Fai clic su un servizio.
- Fai clic su Aggiungi endpoint.
- Fornisci un nome endpoint.
- Inserisci un indirizzo IP IPv4 o IPv6.
- Inserisci un numero di porta.
- (Facoltativo) Se vuoi aggiungere annotazioni all'endpoint:
- In Annotazioni, fai clic su Aggiungi annotazione.
- Aggiungi una Chiave e un Valore.
- Per aggiungere altre annotazioni, fai di nuovo clic su Aggiungi annotazione.
- Fai clic su Crea.
gcloud
Per utilizzare Service Directory sulla riga di comando, esegui l'installazione o l'upgrade alla versione più recente di Google Cloud CLI.
Una volta registrato il servizio, aggiungi alcuni endpoint.
gcloud service-directory endpoints create ENDPOINT \ --address IP_ADDRESS \ --port PORT_NUMBER \ --annotations 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
Sostituisci quanto segue:
ENDPOINT
eENDPOINT2
: i nomi gli endpoint che stai creando nel tuo servizio.IP_ADDRESS
eIP_ADDRESS2
: rispettivamente gli indirizzi IPv6 e IPv4 degli endpoint.PORT_NUMBER
ePORT_NUMBER2
: le porte su cui vengono eseguiti gli endpoint.SERVICE
: il nome del servizio che contiene il tuo endpoint.NAMESPACE
: il nome dello spazio dei nomi che contiene il servizio.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: stringhe chiave e valore impostate in coppia.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C Directory Service Service.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Service Directory.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java di Service Directory.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Service Directory.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP di Service Directory.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Service Directory.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Service Directory.
Risolvere un problema relativo a un servizio
Service Directory consente ai client di risolvere i servizi utilizzando DNS, HTTP e gRPC. La risoluzione del servizio restituisce tutte le proprietà del servizio, tutti gli endpoint e tutte le annotazioni.
gcloud
Per utilizzare Service Directory sulla riga di comando, installa o esegui l'upgrade alla versione più recente di Google Cloud CLI.
gcloud service-directory services resolve SERVICE \ --namespace NAMESPACE \ --location REGION
Sostituisci quanto segue:
SERVICE
: il nome del servizio di cui stai risolvendo il problema.NAMESPACE
: il nome dello spazio dei nomi che contiene il tuo servizio.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C Directory Service Service.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Service Directory.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java di Service Directory.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Service Directory.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP di Service Directory.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Service Directory.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Service Directory.
Elimina risorse
Se non hai bisogno di una risorsa, puoi eliminarla dalla Directory dei servizi.
Eliminare un endpoint da un servizio
Console
Nella console Google Cloud, vai alla pagina Directory dei servizi.
- Fai clic sul servizio da cui vuoi eliminare l'endpoint.
- Seleziona la casella di controllo accanto all'endpoint che vuoi eliminare.
- Fai clic su Elimina.
- Nella finestra di dialogo di conferma, fai di nuovo clic su Elimina.
gcloud
Per utilizzare Service Directory sulla riga di comando, installa o esegui l'upgrade alla versione più recente di Google Cloud CLI.
gcloud service-directory endpoints delete ENDPOINT \ --service=SERVICE \ --namespace=NAMESPACE \ --location=REGION
Sostituisci quanto segue:
ENDPOINT
: il nome dell'endpoint da eliminare.SERVICE
: il nome del servizio che contiene il tuo endpoint.NAMESPACE
: il nome dello spazio dei nomi che contiene il tuo servizio.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C Directory Service Service.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Service Directory.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java di Service Directory.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Service Directory.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP di Service Directory.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Service Directory.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Service Directory.
Eliminare un servizio da uno spazio dei nomi
Puoi eliminare un servizio con endpoint. Quando un servizio viene eliminato, vengono eliminati anche tutti i relativi endpoint.
Puoi eliminare un servizio a cui fa riferimento una
zona di Service Directory. Eventuali altre query DNS per quel servizio restituiscono NXDOMAIN
.
Console
Nella console Google Cloud, vai alla pagina Directory dei servizi.
- Seleziona la casella di controllo accanto al servizio che vuoi eliminare.
- Fai clic su Elimina.
- Nella finestra di dialogo di conferma, fai di nuovo clic su Elimina.
gcloud
Per utilizzare Service Directory sulla riga di comando, installa o esegui l'upgrade alla versione più recente di Google Cloud CLI.
gcloud service-directory services delete SERVICE \ --namespace=NAMESPACE \ --location=REGION
Sostituisci quanto segue:
SERVICE
: il nome del servizio da eliminare.NAMESPACE
: il nome dello spazio dei nomi che contiene il servizio.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C Directory Service Service.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Service Directory.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java di Service Directory.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Service Directory.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP di Service Directory.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Service Directory.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Service Directory.
Eliminare uno spazio dei nomi
Puoi eliminare uno spazio dei nomi con servizi ed endpoint. Quando viene eliminato uno spazio dei nomi, vengono eliminati anche tutti i relativi servizi ed endpoint.
Puoi eliminare uno spazio dei nomi a cui fa riferimento una
zona Service Directory. Eventuali altre query DNS (non incluse le richieste SOA/NS per l'origine della zona) restituiscono NXDOMAIN
.
Console
Nella console Google Cloud, vai alla pagina Spazi dei nomi di Service Directory.
- Seleziona la casella di controllo accanto allo spazio dei nomi da eliminare.
- Fai clic su Elimina.
- Nella finestra di dialogo di conferma, fai di nuovo clic su Elimina.
gcloud
Per utilizzare Service Directory sulla riga di comando, installa o esegui l'upgrade alla versione più recente di Google Cloud CLI.
gcloud service-directory namespaces delete NAMESPACE \ --location=REGION
Sostituisci quanto segue:
NAMESPACE
: il nome dello spazio dei nomi da eliminare.REGION
: la Google Cloud regione che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C Directory Service Service.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Service Directory.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java di Service Directory.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Service Directory.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP di Service Directory.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Service Directory.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Service Directory.
Passaggi successivi
- Per configurare una zona Service Directory in modo da poter eseguire query sul servizio utilizzando il DNS, consulta Configurare una zona Service Directory.
- Per una panoramica di Service Directory, consulta la panoramica di Service Directory.
- Per trovare soluzioni ai problemi comuni che potresti riscontrare durante l'utilizzo di Service Directory, consulta la sezione Risoluzione dei problemi.