Cette page explique comment configurer un espace de noms de service, ajouter un service à l'espace de noms et ajouter des points de terminaison à un service. Avant d'exécuter les commandes sur cette page, familiarisez-vous avec les concepts de la présentation de Service Directory et des mots clés liés à l'annuaire des services.
Configurer votre projet
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
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.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Enable the Service Directory API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Configurer les ressources de l'Annuaire des services
Configurer un objet Namespace
Créez un espace de noms pour la région de votre choix. Cette région n'a pas besoin d'être là où tous vos services et points de terminaison sont en cours d'exécution, mais doivent être proches, si possible. Vous pouvez enregistrer vos services dans n'importe quelle région de l'Annuaire des services. elles peuvent toujours être traitées dans le monde entier. Les projets peuvent comporter plusieurs espaces de noms au sein d'une même région, et ceux-ci peuvent comporter des espaces de noms. Un espace de noms unique ne peut pas s'étendre sur plusieurs régions.
Console
- Accédez à la page "Espaces de noms de répertoires du service" dans Google Cloud Console.
Accéder à la page "Espaces de noms de répertoire de service" - Cliquez sur Créer un espace de noms.
- Dans le menu déroulant Région, sélectionnez une région pour votre espace de noms.
- Dans le champ Nom de l'espace de noms, attribuez un nom à l'espace de noms.
- Cliquez sur Create (Créer).
gcloud
Pour utiliser Service Directory sur la ligne de commande, commencez par installer la dernière version du SDK Cloud ou passer à la version la plus récente.
Créer un espace de nommage
gcloud service-directory namespaces create NAMESPACE \ --location REGION
Remplacez l'élément suivant :
NAMESPACE
: nom de l'espace de noms que vous créez.REGION
: région Google Cloud qui contient l'espace de noms.
(Facultatif): Définissez une stratégie IAM sur votre espace de noms. Le rôle spécifié est ainsi attribué à l'utilisateur ou au groupe spécifié pour cet espace de noms et tous les services appartenant à cet espace de noms.
gcloud service-directory namespaces add-iam-policy-binding NAMESPACE \ --member user:someone@example.com \ --role ROLE \ --location REGION
Remplacez l'élément suivant :
NAMESPACE
: nom de l'espace de noms que vous avez créé.ROLE
: le rôle que vous accordez.REGION
: région Google Cloud qui contient l'espace de noms.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C# et installez le SDK C# du répertoire de services.
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Go Directory Directory.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Java de l'annuaire des services.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Node.js Directory.
PHP
Pour exécuter ce code, configurez un environnement de développement PHP et installez le SDK PHP de l'annuaire des services.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Python du répertoire de service.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby et installez le SDK Ruby de l'annuaire des services.
Configurer un service
Créez un service dans l'espace de noms. Un service comprend un nom et des métadonnées facultatives associées au service. Il existe des restrictions concernant le format des noms de service:
- Les noms de service doivent être uniques dans un espace de noms.
- Les noms de service doivent respecter la convention d'attribution de noms pour les libellés DNS.
Console
- Accédez à la page "Espaces de noms de répertoires du service" dans Google Cloud Console.
Accéder à la page "Espaces de noms de répertoire de service" - Cliquez sur un espace de noms.
- Cliquez sur Ajouter un service.
- Saisissez un nom de service.
- Facultatif Si vous souhaitez ajouter des métadonnées au service, procédez comme suit :
- Cliquez sur Métadonnées de service.
- Cliquez sur Ajouter des métadonnées.
- Ajoutez une clé et une valeur.
- Pour ajouter d'autres paires de métadonnées, cliquez de nouveau sur Ajouter des métadonnées.
- Cliquez sur Create (Créer).
gcloud
Pour utiliser Service Directory sur la ligne de commande, commencez par installer la dernière version du SDK Cloud ou passer à la version la plus récente.
Créez un service dans un espace de noms.
gcloud service-directory services create SERVICE \ --metadata KEY_1=VALUE_1,KEY_2=VALUE_2 \ --namespace NAMESPACE \ --location REGION
Remplacez l'élément suivant :
SERVICE
: nom du service que vous créez.NAMESPACE
: nom que vous avez attribué à l'espace de noms contenant votre service.REGION
: région Google Cloud qui contient l'espace de noms.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: chaîne et clé de valeur définies par paires.
(Facultatif): Définissez une stratégie IAM sur votre service. Cela attribue le rôle spécifié à l'utilisateur ou au groupe spécifié pour ce service et à tous les points de terminaison appartenant au service.
gcloud service-directory services add-iam-policy-binding SERVICE \ --member user:someone@example.com \ --role ROLE \ --namespace NAMESPACE \ --location REGION
Remplacez l'élément suivant :
SERVICE
: par le nom que vous avez donné au service.NAMESPACE
: nom de l'espace de noms que vous avez créé.ROLE
: le rôle que vous accordez.REGION
: région Google Cloud qui contient l'espace de noms.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C# et installez le SDK C# Directory C#.
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Go Directory Directory.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Java de l'annuaire des services.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Node.js Directory.
PHP
Pour exécuter ce code, configurez un environnement de développement PHP et installez le SDK PHP de l'annuaire des services.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Python du répertoire de service.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby et installez le SDK Ruby de l'annuaire des services.
Configurer un point de terminaison
Une fois le service enregistré, ajoutez des points de terminaison. Un point de terminaison est constitué d'un nom unique et des champs facultatifs de métadonnées d'adresse, de port et de clé/valeur. Si elle est spécifiée, elle doit être une adresse IPv4 ou IPv6 valide.
Console
- Accédez à la page "Espaces de noms de répertoires du service" dans Google Cloud Console.
Accéder à la page "Espaces de noms de répertoire de service" - Cliquez sur un espace de noms.
- Cliquez sur un service.
- Cliquez sur Ajouter un point de terminaison.
- Indiquez un Nom de point de terminaison.
- Saisissez une adresse IP IPv4 ou IPv6.
- Saisissez un numéro de port.
- Facultatif Si vous souhaitez ajouter des métadonnées au point de terminaison, procédez comme suit :
- Cliquez sur Métadonnées des points de terminaison.
- Cliquez sur Ajouter des métadonnées.
- Ajoutez une clé et une valeur.
- Pour ajouter d'autres paires de métadonnées, cliquez de nouveau sur Ajouter des métadonnées.
- Cliquez sur Create (Créer).
gcloud
Pour utiliser Service Directory sur la ligne de commande, commencez par installer la dernière version du SDK Cloud ou effectuer une mise à niveau.
Une fois le service enregistré, ajoutez des points de terminaison.
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
Remplacez les valeurs suivantes :
ENDPOINT
etENDPOINT2
: noms des points de terminaison que vous créez dans votre service.IP_ADDRESS
etIP_ADDRESS2
: les adresses IPv6 et IPv4 des points de terminaison, respectivement.PORT_NUMBER
etPORT_NUMBER2
: ports sur lesquels les points de terminaison sont en cours d'exécutionSERVICE
: nom du service que vous créez.NAMESPACE
: nom que vous avez attribué à l'espace de noms contenant votre service.REGION
: région Google Cloud qui contient l'espace de noms.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: chaîne et clé de valeur définies par paires.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C# et installez le SDK C# du répertoire de services.
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Go Directory Directory.
Java
Pour exécuter ce code, configurez un environnement de développement Java et installez le SDK Java de l'annuaire des services.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Node.js Directory.
PHP
Pour exécuter ce code, configurez un environnement de développement PHP et installez le SDK PHP de l'annuaire des services.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Python de l'annuaire des services.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby et installez le SDK Ruby de l'annuaire des services.
Résoudre un service
L'Annuaire des services permet aux clients de résoudre les services à l'aide des protocoles DNS, HTTP et gRPC. La résolution du service renvoie toutes les propriétés du service, ainsi que tous les points de terminaison et toutes les métadonnées.
gcloud
Pour utiliser Service Directory sur la ligne de commande, commencez par installer la dernière version du SDK Cloud ou effectuer une mise à niveau.
gcloud service-directory services resolve SERVICE \ --namespace NAMESPACE \ --location REGION
Remplacez l'élément suivant :
SERVICE
: nom du service que vous créez.NAMESPACE
: nom que vous avez attribué à l'espace de noms contenant votre service.REGION
: région Google Cloud qui contient l'espace de noms.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C# et installez le SDK C# Directory C#.
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Go Directory Directory.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Java de l'annuaire des services.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Node.js Directory.
PHP
Pour exécuter ce code, commencez par configurer un environnement de développement PHP et installez le SDK PHP de l'annuaire des services.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Python de l'annuaire des services.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby et installez le SDK Ruby de l'annuaire des services.
Supprimer des ressources
Supprimer un point de terminaison d'un service
Console
- Accédez à la page "Espaces de noms de répertoires du service" dans Google Cloud Console.
Accéder à la page "Espaces de noms de répertoire de service" - Cliquez sur l'espace de noms duquel vous souhaitez supprimer le point de terminaison.
- Cliquez sur le service dont vous souhaitez supprimer le point de terminaison.
- Cochez la case en regard du point de terminaison que vous souhaitez supprimer.
- Cliquez sur Supprimer.
- Dans la boîte de dialogue de confirmation, cliquez de nouveau sur Supprimer .
gcloud
Pour utiliser Service Directory sur la ligne de commande, commencez par installer la dernière version du SDK Cloud ou effectuer une mise à niveau.
gcloud service-directory endpoints delete ENDPOINT \ --service=SERVICE \ --namespace=NAMESPACE \ --location=REGION
Remplacez l'élément suivant :
SERVICE
: nom du service que vous créez.NAMESPACE
: nom que vous avez attribué à l'espace de noms contenant votre service.REGION
: région Google Cloud qui contient l'espace de noms.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C# et installez le SDK C# Directory C#.
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Go Directory Directory.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Java de l'annuaire des services.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Node.js Directory.
PHP
Pour exécuter ce code, commencez par configurer un environnement de développement PHP et installez le SDK PHP de l'annuaire des services.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Python de l'annuaire des services.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby et installez le SDK Ruby de l'annuaire des services.
Supprimer un service d'un espace de noms
Vous pouvez supprimer un service qui dispose de points de terminaison. Lorsqu'un service est supprimé, tous ses points de terminaison le sont également.
Vous pouvez supprimer un service dont la zone d'annuaire de services pointe vers celle-ci. Toute autre requête DNS pour ce service renvoie NXDOMAIN
.
Console
- Accédez à la page "Espaces de noms de répertoires du service" dans Google Cloud Console.
Accéder à la page "Espaces de noms de répertoire de service" - Cliquez sur l'espace de noms duquel vous souhaitez supprimer le service.
- Cochez la case à côté du service que vous souhaitez supprimer.
- Cliquez sur Supprimer.
- Cliquez à nouveau sur Supprimer dans la boîte de dialogue de confirmation.
gcloud
Pour utiliser Service Directory sur la ligne de commande, commencez par installer la dernière version du SDK Cloud ou effectuer une mise à niveau.
gcloud service-directory services delete SERVICE \ --namespace=NAMESPACE \ --location=REGION
Remplacez l'élément suivant :
SERVICE
: nom du service que vous créez.NAMESPACE
: nom que vous avez attribué à l'espace de noms contenant votre service.REGION
: région Google Cloud qui contient l'espace de noms.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C# et installez le SDK C# Directory C#.
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Go Directory Directory.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Java de l'annuaire des services.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Node.js Directory.
PHP
Pour exécuter ce code, commencez par configurer un environnement de développement PHP et installez le SDK PHP de l'annuaire des services.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Python de l'annuaire des services.
Ruby
Pour exécuter ce code, configurez un environnement de développement Ruby et installez le SDK Ruby de l'annuaire des services.
Supprimer un espace de noms
Vous pouvez supprimer un espace de noms comportant des services et des points de terminaison. Lorsqu'un espace de noms est supprimé, tous ses services et points de terminaison le sont également.
Vous pouvez supprimer un espace de noms dont la zone d'annuaire de services pointe vers celle-ci. Toutes les autres requêtes DNS (à l'exception des requêtes SOA/NS pour l'origine de la zone) renvoient NXDOMAIN
.
Console
- Accédez à la page "Espaces de noms de répertoires du service" dans Google Cloud Console.
Accéder à la page "Espaces de noms de répertoire de service" - Cochez la case en regard de l'espace de noms que vous souhaitez supprimer.
- Cliquez sur Supprimer.
- Dans la boîte de dialogue de confirmation, cliquez de nouveau sur Supprimer.
gcloud
Pour utiliser Service Directory sur la ligne de commande, commencez par installer la dernière version du SDK Cloud ou effectuer une mise à niveau.
gcloud service-directory namespaces delete NAMESPACE \ --location=REGION
Remplacez l'élément suivant :
NAMESPACE
: nom que vous avez attribué à l'espace de noms contenant votre service.REGION
: région Google Cloud qui contient l'espace de noms.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C# et installez le SDK C# Directory C#.
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Go Directory Directory.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Java de l'annuaire des services.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Node.js Directory.
PHP
Pour exécuter ce code, commencez par configurer un environnement de développement PHP et installez le SDK PHP de l'annuaire des services.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Python de l'annuaire des services.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby et installez le SDK Ruby de l'annuaire des services.
Étape suivante
- Pour configurer une zone de répertoire de service afin de pouvoir interroger votre service à l'aide d'un DNS, consultez la section Zone de répertoire de service.
- Pour obtenir une présentation de l'annuaire des services, consultez la présentation de l'Annuaire des services.
- Pour trouver des solutions aux problèmes courants que vous pouvez rencontrer lors de l'utilisation de Service Directory, consultez la page Dépannage.