Vous pouvez créer une zone d'annuaire des services qui permet à vos services basés surGoogle Cloudd'interroger votre espace de noms de l'annuaire des services à l'aide de Cloud DNS.
Pour suivre ces instructions, vous devez déjà disposer d'un espace de noms d'annuaire des services. Si ce n'est pas le cas, créez d'abord un espace de noms en suivant la procédure décrite dans la section Configurer l'annuaire des services.
Une fois qu'une zone de l'Annuaire des services est associée à l'espace de noms, tous les services et points de terminaison de l'espace de noms deviennent disponibles via DNS sur le réseau privé. Toutes les mises à jour des services et des points de terminaison sont immédiatement répercutées dans leurs enregistrements DNS. Toutefois, le service et le point de terminaison ne sont pas disponibles via le DNS.
Limites
L'intégration de l'annuaire des services à Cloud DNS présente les limites suivantes:
- Vous ne pouvez associer une zone de l'Annuaire des services à un espace de noms que lorsque vous créez la zone.
- Une zone Service Directory doit se trouver dans le même projet que l'espace de noms Service Directory auquel elle est associée.
- Une zone de service Directory ne peut pas être une zone de transfert, une zone privée régulière ni une zone publique.
Créer une zone de l'annuaire des services reposant sur un espace de noms
Vous ne pouvez associer une zone de l'Annuaire des services à un espace de noms que lorsque vous créez la zone. Une zone de service Directory ne peut pas être une zone de transfert, une zone privée régulière ni une zone publique.
Console
- Accédez à la page Cloud DNS dans la console Google Cloud.
Accéder à Cloud DNS - Cliquez sur Créer une zone.
- Dans la section Type de zone, cliquez sur Privé.
- Saisissez un nom pour la zone.
- Saisissez un nom DNS pour la zone.
- Sous Options, sélectionnez Utiliser un espace de noms de l'annuaire des services.
- Sous Networks (Réseaux), sélectionnez un ou plusieurs réseaux pouvant utiliser la zone Service Directory.
- Sélectionnez la région dans laquelle se trouve l'espace de noms que vous souhaitez associer.
- Sélectionnez l'espace de noms que vous souhaitez associer.
- Cliquez sur Créer.
gcloud
gcloud dns managed-zones create SD_ZONE \ --dns-name DNS_NAME \ --description DESCRIPTION \ --visibility private \ --networks https://www.googleapis.com/compute/v1/projects/project_ID/global/networks/network \ --service-directory-namespace https://servicedirectory.googleapis.com/v1/projects/project_ID/locations/region/namespaces/namespace-name
Remplacez les valeurs suivantes :
SD_ZONE
: nom de la zone de l'annuaire des services que vous créez.DNS_NAME
: nom DNS (par exemple,us-east1.example.com.
) de la nouvelle zone.DESCRIPTION
: description de la zone, telle quethis zone is backed by Service Directory
.- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK : nom de domaine complet des réseaux pouvant utiliser la zone.
- https://www.servicedirectory.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/registries/NAMESPACE_NAME : nom de domaine complet de l'espace de noms que vous associez.
Supprimer la zone de l'annuaire des services
Vous pouvez supprimer une zone de l'Annuaire des services à tout moment. Cette suppression se produit via Cloud DNS et n'a aucun effet sur les espaces de noms de l'annuaire des services associés. L'espace de noms associé reste disponible pour la recherche via HTTP et gRPC. Pour en savoir plus, consultez la section Supprimer une zone gérée.
Vous pouvez supprimer un service ou un espace de noms auquel une zone de l'annuaire des services fait référence sans supprimer la zone. Dans ce cas, toutes les autres requêtes DNS pour ce service renvoient NXDOMAIN
.
Étape suivante
- Pour savoir comment sécuriser le service Directory dans un périmètre de service, consultez Service Directory et VPC Service Controls.
- 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.