Vous pouvez créer une zone d'annuaire de service qui permet à vos services basés sur Google 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 de l'annuaire des services. Si ce n'est pas le cas, commencez par créer un espace de noms à l'aide de la procédure décrite dans Configurer l'annuaire des services.
Une fois que vous avez associé une zone d'Annuaire des services à 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 reflétées dans leurs enregistrements DNS. Toutefois, le service et le point de terminaison ne sont pas disponibles via 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 qu'au moment de la création de la zone.
- Une zone d'Annuaire des services doit se trouver dans le même projet que l'espace de noms Annuaire des services auquel elle est associée.
- Une zone Annuaire des services ne peut pas être également une zone de transfert, une zone privée standard ou une zone publique.
Créer une zone d'Annuaire des services reposant sur un espace de noms
Vous ne pouvez associer une zone de l'Annuaire des services à un espace de noms qu'au moment de la création de la zone. Une zone Annuaire des services ne peut pas être également une zone de transfert, une zone privée standard ou une zone publique.
Console
- Accédez à la page Cloud DNS dans la Google Cloud console.
Accéder à Cloud DNS - Cliquez sur Créer une zone.
- Dans la section Type de zone, cliquez sur Privé.
- Indiquez 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 Réseaux, sélectionnez un ou plusieurs réseaux pouvant utiliser la zone d'Annuaire des services.
- 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 d'Annuaire des services que vous créez.DNS_NAME: nom DNS, tel queus-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 d'Annuaire des services
Vous pouvez supprimer une zone d'Annuaire des services à tout moment. Cette suppression s'effectue 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 Supprimer une zone gérée.
Vous pouvez supprimer un
service
ou un espace de noms vers lequel pointe une zone d'Annuaire des services sans
supprimer la zone. Dans ce cas, toutes les requêtes DNS ultérieures pour ce service renvoient NXDOMAIN.
Étape suivante
- Pour découvrir comment sécuriser l'annuaire des services dans un périmètre de service, consultez Annuaire des services 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 pourriez rencontrer en utilisant l'annuaire des services, consultez Dépannage.