Questa pagina mostra come configurare uno spazio dei nomi Service Directory, aggiungere un servizio allo spazio dei nomi e aggiungere endpoint a un servizio. Prima di eseguire i comandi in questa pagina, acquisisci familiarità con i concetti della panoramica di Service Directory e dei termini chiave relativi a Service Directory.
Configurare il progetto
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita l'API Service Directory.
- 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.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita l'API Service Directory.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Configurazione delle risorse di Service Directory
Configurazione di uno spazio dei nomi
Crea uno spazio dei nomi per il tuo progetto per l'area geografica che hai scelto. Non è necessario che l'area geografica contenga tutti i servizi e gli endpoint in esecuzione, ma è possibile chiuderla, se possibile. È possibile registrare i servizi in qualsiasi area geografica di Service Directory. sono comunque risolvibili in tutto il mondo. I progetti possono avere più spazi dei nomi all'interno di un'area geografica e più aree geografiche possono avere spazi dei nomi. Un singolo spazio dei nomi non può includere aree geografiche.
Console
- Vai alla pagina degli spazi dei nomi di Service Directory in Google Cloud Console.
Vai alla pagina degli spazi dei nomi di Service Directory - Fai clic su Crea spazio dei nomi.
- Nel menu a discesa Regione, seleziona un'area geografica per lo 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 nella riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Cloud SDK.
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
: l'area geografica di Google Cloud che contiene lo spazio dei nomi.
(Facoltativo) Imposta un criteri IAM sullo spazio dei nomi. In questo modo, l'utente o il gruppo specificato avrà il ruolo specificato per lo spazio dei nomi e 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
: l'area geografica di Google Cloud che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK Service Directory C#.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Service Directory Go.
Java
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Java e installare l'SDK Service Directory Java.
Node.js
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Node.js e installare l'SDK Service Directory Node.js.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Directory Service.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK di Service Directory Python.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK di Ruby Directory.
Configurazione di un servizio
Crea un servizio nello spazio dei nomi. Un servizio consiste di un nome e dei metadati facoltativi relativi ai servizi. Esistono alcune limitazioni per il formato dei nomi di servizio:
- I nomi dei servizi devono essere univoci all'interno di uno spazio dei nomi.
- I nomi di servizio devono rispettare la convenzione di denominazione per le etichette DNS.
Console
- Vai alla pagina degli spazi dei nomi di Service Directory in Google Cloud Console.
Vai alla pagina degli spazi dei nomi di Service Directory - Fai clic su uno spazio dei nomi.
- Fai clic su Aggiungi servizio.
- Inserisci un Nome servizio.
- (Facoltativo) Se vuoi aggiungere metadati al servizio, procedi nel seguente modo:
- Fai clic su Metadati del servizio.
- Fai clic su Aggiungi metadati.
- Aggiungi una Chiave e un Valore.
- Per aggiungere altre coppie di metadati, fai di nuovo clic su Aggiungi metadati.
- Fai clic su Crea.
gcloud
Per utilizzare Service Directory nella riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Cloud SDK.
Crea un servizio in uno spazio dei nomi.
gcloud service-directory services create SERVICE \ --metadata 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 assegnato allo spazio dei nomi contenente il tuo servizio.REGION
: l'area geografica di Google Cloud che contiene lo spazio dei nomi.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: stringa di chiave e valore impostata in coppie.
(Facoltativo) Imposta un criteri IAM sul servizio. In questo modo l'utente o il gruppo specificato viene assegnato il ruolo specificato per il servizio e 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 dato al tuo servizio.NAMESPACE
: il nome dello spazio dei nomi che hai creato.ROLE
: il ruolo che stai concedendo.REGION
: l'area geografica di Google Cloud 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 Service Directory Go.
Java
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Java e installare l'SDK Service Directory Java.
Node.js
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Node.js e installare l'SDK Service Directory Node.js.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Directory Service.
Python
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Python e installare l'SDK Python Directory Service.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK di Ruby Directory.
Configurazione di un endpoint
Una volta registrato il servizio, aggiungi alcuni endpoint. Un endpoint è composto da un nome univoco e dai campi facoltativi di indirizzo, porta e metadati chiave/valore. L'indirizzo, se specificato, deve essere un indirizzo IPv4 o IPv6 valido.
Console
- Vai alla pagina degli spazi dei nomi di Service Directory in Google Cloud Console.
Vai alla pagina degli spazi dei nomi di Service Directory - Fai clic su uno spazio dei nomi.
- Fai clic su un servizio.
- Fai clic su Aggiungi endpoint.
- Inserisci un Nome endpoint.
- Inserisci un indirizzo IP IPv4 o IPv6.
- Inserisci un numero di Porta.
- (Facoltativo) Se vuoi aggiungere metadati all'endpoint, procedi nel seguente modo:
- Fai clic su Metadati endpoint.
- Fai clic su Aggiungi metadati.
- Aggiungi una Chiave e un Valore.
- Per aggiungere altre coppie di metadati, fai di nuovo clic su Aggiungi metadati.
- Fai clic su Crea.
gcloud
Per utilizzare Service Directory nella riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Cloud SDK.
Una volta registrato il servizio, aggiungi alcuni endpoint.
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
Sostituisci i seguenti valori:
ENDPOINT
eENDPOINT2
: i nomi degli endpoint che stai creando nel servizio.IP_ADDRESS
eIP_ADDRESS2
: rispettivamente, gli indirizzi IPv6 e IPv4 degli endpoint.PORT_NUMBER
ePORT_NUMBER2
: le porte su cui sono in esecuzione gli endpoint.SERVICE
: il nome del servizio che stai creando.NAMESPACE
: il nome assegnato allo spazio dei nomi contenente il tuo servizio.REGION
: l'area geografica di Google Cloud che contiene lo spazio dei nomi.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: stringa di chiave e valore impostata in coppie.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK Service Directory C#.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Service Directory Go.
Java
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Java e installare l'SDK Service Directory Java.
Node.js
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Node.js e installare l'SDK Service Directory Node.js.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Directory Service.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK di Service Directory Python.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK di Ruby Directory.
Risoluzione di 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 nonché tutti gli endpoint e i metadati.
gcloud
Per utilizzare Service Directory nella riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Cloud SDK.
gcloud service-directory services resolve SERVICE \ --namespace NAMESPACE \ --location REGION
Sostituisci quanto segue:
SERVICE
: il nome del servizio che stai creando.NAMESPACE
: il nome assegnato allo spazio dei nomi contenente il tuo servizio.REGION
: l'area geografica di Google Cloud che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK Service Directory C#.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Service Directory Go.
Java
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Java e installare l'SDK Service Directory Java.
Node.js
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Node.js e installare l'SDK Service Directory Node.js.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Directory Service.
Python
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Python e installare l'SDK Python Directory Service.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK di Ruby Directory.
Eliminazione delle risorse
Eliminazione di un endpoint da un servizio
Console
- Vai alla pagina degli spazi dei nomi di Service Directory in Google Cloud Console.
Vai alla pagina degli spazi dei nomi di Service Directory - Fai clic sullo spazio dei nomi dal quale vuoi eliminare l'endpoint.
- Fai clic sul servizio da cui vuoi eliminare l'endpoint.
- Fai clic sulla casella di controllo accanto all'endpoint che vuoi eliminare.
- Fai clic su Elimina.
- Nella finestra di dialogo di conferma, fai nuovamente clic su Elimina .
gcloud
Per utilizzare Service Directory nella riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Cloud SDK.
gcloud service-directory endpoints delete ENDPOINT \ --service=SERVICE \ --namespace=NAMESPACE \ --location=REGION
Sostituisci quanto segue:
SERVICE
: il nome del servizio che stai creando.NAMESPACE
: il nome assegnato allo spazio dei nomi contenente il tuo servizio.REGION
: l'area geografica di Google Cloud 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 Service Directory Go.
Java
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Java e installare l'SDK Service Directory Java.
Node.js
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Node.js e installare l'SDK Service Directory Node.js.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Directory Service.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK di Service Directory Python.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK di Ruby Directory.
Eliminazione di un servizio da uno spazio dei nomi
Puoi eliminare un servizio che contiene endpoint. Quando un servizio viene eliminato, vengono eliminati anche tutti i relativi endpoint.
Puoi eliminare un servizio che ha un
zona di Service Directory
che gli punta ad esso. Eventuali altre query DNS per tale servizio restituiscono NXDOMAIN
.
Console
- Vai alla pagina degli spazi dei nomi di Service Directory in Google Cloud Console.
Vai alla pagina degli spazi dei nomi di Service Directory - Fai clic sullo spazio dei nomi dal quale vuoi eliminare il servizio.
- Fai clic sulla casella di controllo accanto al servizio che vuoi eliminare.
- Fai clic su Elimina.
- Fai nuovamente clic su Elimina nella finestra di dialogo di conferma.
gcloud
Per utilizzare Service Directory nella riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Cloud SDK.
gcloud service-directory services delete SERVICE \ --namespace=NAMESPACE \ --location=REGION
Sostituisci quanto segue:
SERVICE
: il nome del servizio che stai creando.NAMESPACE
: il nome assegnato allo spazio dei nomi contenente il tuo servizio.REGION
: l'area geografica di Google Cloud che contiene lo spazio dei nomi.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK Service Directory C#.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Service Directory Go.
Java
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Java e installare l'SDK Service Directory Java.
Node.js
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Node.js e installare l'SDK Service Directory Node.js.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Directory Service.
Python
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Python e installare l'SDK Python Directory Service.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK di Ruby Directory.
Eliminazione di uno spazio dei nomi
Puoi eliminare uno spazio dei nomi che include servizi ed endpoint. Quando uno spazio dei nomi viene eliminato, vengono eliminati anche tutti i relativi servizi e endpoint.
Puoi eliminare uno spazio dei nomi che contiene una
zona di Service Directory. Eventuali altre query DNS (incluse le richieste SOA/NS per l'origine della zona) restituiscono NXDOMAIN
.
Console
- Vai alla pagina degli spazi dei nomi di Service Directory in Google Cloud Console.
Vai alla pagina degli spazi dei nomi di Service Directory - Fai clic sulla casella di controllo accanto allo spazio dei nomi che vuoi eliminare.
- Fai clic su Elimina.
- Nella finestra di dialogo di conferma, fai di nuovo clic su Elimina.
gcloud
Per utilizzare Service Directory nella riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Cloud SDK.
gcloud service-directory namespaces delete NAMESPACE \ --location=REGION
Sostituisci quanto segue:
NAMESPACE
: il nome assegnato allo spazio dei nomi contenente il tuo servizio.REGION
: l'area geografica di Google Cloud 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 Service Directory Go.
Java
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Java e installare l'SDK Service Directory Java.
Node.js
Per eseguire questo codice, devi innanzitutto impostare un ambiente di sviluppo Node.js e installare l'SDK Service Directory Node.js.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Directory Service.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK di Service Directory Python.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK di Ruby Directory.
Passaggi successivi
- Per configurare una zona in Service Directory in modo da eseguire query sul servizio utilizzando DNS, vedi Service Directory zone.
- Per una panoramica di Service Directory, consulta la panoramica di Service Directory.
- Per trovare soluzioni per problemi comuni che potresti riscontrare durante l'utilizzo di Service Directory, consulta la sezione Risoluzione dei problemi.