Cette page explique comment créer, mettre à jour, répertorier et supprimer des zones gérées Cloud DNS. Avant d'utiliser cette page, familiarisez-vous avec la présentation de Cloud DNS et les termes clés.
Avant de commencer
L'API Cloud DNS requiert la création d'un projet Cloud DNS et l'activation de l'API Cloud DNS.
Si vous créez une application qui utilise l'API REST, vous devez également créer un ID client OAuth 2.0.
- Si vous n'en possédez pas déjà un, vous devez créer un compte Google.
- Activez l'API Cloud DNS dans Google Cloud Console. Vous pouvez sélectionner un projet Compute Engine ou App Engine existant, ou en créer un.
- Si vous devez envoyer des requêtes à l'API REST, vous devez créer un ID OAuth 2.0. Consultez la section Configurer OAuth 2.0.
- Dans le projet, notez les informations suivantes que vous devrez saisir aux prochaines étapes :
-
L'ID client (
xxxxxx.apps.googleusercontent.com
). - L'ID du projet que vous souhaitez utiliser. L'ID se trouve en haut de la page Présentation dans Google Cloud Console. Vous pouvez également demander aux utilisateurs d'indiquer le nom du projet qu'ils souhaitent utiliser dans votre application.
-
L'ID client (
Si vous n'avez pas encore utilisé Google Cloud CLI, vous devez exécuter la commande suivante pour spécifier le nom du projet et vous authentifier dans Google Cloud Console :
gcloud auth login
Si vous souhaitez exécuter une commande gcloud
sur les ressources Google Cloud d'un autre projet, spécifiez l'option --project
pour cette commande et pour les autres commandes gcloud
de cette page.
Créer des zones gérées
Chaque zone gérée que vous créez est associée à un projet Google Cloud. Dans les sections suivantes, nous allons voir comment créer le type de zone gérée compatible avec Cloud DNS.
Créer une zone publique
Pour créer une zone gérée, procédez comme suit :
Console
Dans Google Cloud Console, accédez à la page Créer une zone DNS.
Dans le champ Type de zone, sélectionnez Publique.
Saisissez un Nom de zone, tel que
my-new-zone
.Saisissez un suffixe de Nom DNS pour la zone à l'aide d'un nom de domaine vous appartenant. Tous les enregistrements de la zone partagent ce suffixe, par exemple :
example.com
.Dans le champ DNSSEC, sélectionnez Désactivé, Activé ou Transfer. Pour en savoir plus, consultez la page Activer DNSSEC pour les zones gérées existantes.
Cliquez sur Create (Créer). La page Détails de la zone s'affiche.
gcloud
Exécutez la commande dns managed-zones create
:
gcloud dns managed-zones create NAME \ --description=DESCRIPTION \ --dns-name=DNS_SUFFIX \ --labels=LABELS \ --visibility=public
Remplacez les éléments suivants :
NAME
: nom de votre zoneDESCRIPTION
: description de votre zoneDNS_SUFFIX
: suffixe DNS de votre zone, tel queexample.com
LABELS
: liste facultative de paires clé/valeur séparées par une virgule, telle quedept=marketing
ouproject=project1
. Pour en savoir plus, consultez la documentation du SDK.
Terraform
API
Envoyez une requête POST
à l'aide de la méthode managedZones.create
:
POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones { "name": "NAME", "description": "DESCRIPTION", "dnsName": "DNS_NAME", "visibility": "public" }
Remplacez l'élément suivant :
PROJECT_ID
: ID du projet dans lequel la zone gérée est crééeNAME
: nom de votre zoneDESCRIPTION
: description de votre zoneDNS_NAME
: suffixe DNS de votre zone, tel queexample.com
Créer une zone privée
Pour créer une zone gérée avec des enregistrements DNS privés gérés par Cloud DNS, procédez comme suit : Pour plus d'informations, consultez les Bonnes pratiques pour les zones privées Cloud DNS.
Console
Dans Google Cloud Console, accédez à la page Créer une zone DNS.
Dans le champ Type de zone, sélectionnez Privé.
Saisissez un Nom de zone, tel que
my-new-zone
.Saisissez un suffixe de Nom DNS pour la zone privée. Tous les enregistrements de la zone partagent ce suffixe, par exemple :
example.private
.Facultatif : ajoutez une description.
Dans le champ Options, sélectionnez Par défaut (privé).
Sélectionnez les réseaux de cloud privé virtuel (VPC) sur lesquels la zone privée doit être visible. Seuls les réseaux VPC que vous sélectionnez sont autorisés à interroger des enregistrements dans la zone.
Cliquez sur Créer.
gcloud
Exécutez la commande dns managed-zones create
:
gcloud dns managed-zones create NAME \ --description=DESCRIPTION \ --dns-name=DNS_SUFFIX \ --networks=VPC_NETWORK_LIST \ --labels=LABELS \ --visibility=private
Remplacez les éléments suivants :
NAME
: nom de votre zoneDESCRIPTION
: description de votre zoneDNS_SUFFIX
: suffixe DNS de votre zone, tel queexample.private
VPC_NETWORK_LIST
: liste de réseaux VPC autorisés à interroger la zone, séparés par une virgule.LABELS
: liste facultative de paires clé/valeur séparées par une virgule, telle quedept=marketing
ouproject=project1
. Pour en savoir plus, consultez la documentation du SDK.
Terraform
API
Envoyez une requête POST
à l'aide de la méthode managedZones.create
:
POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones { "name": "NAME", "description": "DESCRIPTION", "dnsName": "DNS_NAME", "visibility": "private" "privateVisibilityConfig": { "kind": "dns#managedZonePrivateVisibilityConfig", "networks": [{ "kind": "dns#managedZonePrivateVisibilityConfigNetwork", "networkUrl": VPC_NETWORK_1 }, { "kind": "dns#managedZonePrivateVisibilityConfigNetwork", "networkUrl": VPC_NETWORK_2 }, .... ] }
Remplacez l'élément suivant :
PROJECT_ID
: ID du projet dans lequel la zone gérée est crééeNAME
: nom de votre zoneDESCRIPTION
: description de votre zoneDNS_NAME
: suffixe DNS de votre zone, tel queexample.private
VPC_NETWORK_1
etVPC_NETWORK_2
: URL des réseaux VPC du même projet, pouvant interroger les enregistrements dans cette zone Vous pouvez ajouter plusieurs réseaux VPC, comme indiqué. Pour déterminer l'URL d'un réseau VPC, utilisez la commandegcloud
suivante, en remplaçantVPC_NETWORK_NAME
par le nom du réseau :gcloud compute networks describe VPC_NETWORK_NAME \ --format="get(selfLink)"
Créer une zone avec des autorisations IAM spécifiques
L'autorisation IAM (Identity and Access Management) pour une zone gérée individuelle de ressource vous permet de configurer des autorisations de lecture, d'écriture ou d'administrateur spécifiques pour différentes zones gérées d'un même projet.
Pour obtenir des instructions sur la création d'une zone avec des autorisations IAM spécifiques, consultez la page Créer une zone avec des autorisations IAM spécifiques.
Créer une zone DNS dans l'annuaire des services
Vous pouvez créer une zone d'annuaire de service qui permet à vos services basés sur Google Cloud d'interroger votre espace de noms de l'annuaire des services via DNS.
Pour obtenir des instructions détaillées sur la création d'une zone DNS dans l'annuaire des services, consultez la section Configurer une zone DNS dans l'annuaire des services.
Pour savoir comment utiliser DNS pour interroger votre annuaire de services, consultez la page Interroger à l'aide de DNS.
Terraform
Créer une zone privée de recherche inversée gérée
Une zone de recherche inversée gérée est une zone privée comportant un attribut spécial qui indique à Cloud DNS d'effectuer une recherche PTR sur les données DNS de Compute Engine. Dans Cloud DNS, vous devez configurer des zones de recherche inversées gérées afin de résoudre correctement les enregistrements PTR non-RFC 1918 pour vos instances de machine virtuelle.
Pour découvrir comment créer une zone privée de recherche inversée gérée, consultez la section Créer une zone de recherche inversée gérée.
Créer une zone de transfert
Les zones de transfert vous permettent de cibler des serveurs de noms pour des zones privées spécifiques. Pour obtenir des instructions sur la création d'une zone de transfert privée gérée, consultez la section Créer une zone de transfert.
Créer une zone d'appairage
L'appairage DNS vous permet d'envoyer les requêtes des enregistrements provenant de l'espace de noms d'une zone à un autre réseau VPC. Pour obtenir des instructions sur la création d'une zone d'appairage, consultez la section Créer une zone d'appairage.
Créer une zone de liaison inter-projet
Créez une zone privée gérée qui peut être liée à un réseau appartenant à un autre projet au sein de la même organisation. Pour savoir comment créer une zone de liaison inter-projets, consultez la section Zones de liaison inter-projets.
Mettre à jour des zones gérées
Cloud DNS vous permet de modifier certains attributs de votre zone géréepublique ou privée.
Mettre à jour les zones publiques
Vous pouvez modifier la description ou la configuration DNSSEC d'une zone publique.
Console
Dans Google Cloud Console, accédez à la page Zones Cloud DNS.
Cliquez sur la zone publique que vous souhaitez mettre à jour.
Cliquez sur
Modifier.Pour modifier les paramètres DNSSEC, sous DNSSEC, sélectionnez Désactivé, Activé ou Transfert. Pour en savoir plus, consultez la page Activer DNSSEC pour les zones gérées existantes.
Facultatif : mettez à jour la description.
Cliquez sur Enregistrer.
gcloud
Exécutez la commande dns managed-zones update
:
gcloud dns managed-zones update NAME \ --description=DESCRIPTION \ --dnssec-state=STATE
Remplacez les éléments suivants :
NAME
: nom de votre zoneDESCRIPTION
: description de votre zoneSTATE
: paramètre DNSSEC tel queOff
,On
ouTransfer
Pour modifier les réseaux VPC pour lesquels une zone privée est visible :
Console
Dans Google Cloud Console, accédez à la page Zones Cloud DNS.
Cliquez sur la zone privée que vous souhaitez mettre à jour.
Cliquez sur
Modifier.Sélectionnez les réseaux pour lesquels la zone privée doit être visible. Seuls les réseaux VPC sélectionnés sont autorisés à interroger des enregistrements dans la zone.
Cliquez sur Enregistrer.
gcloud
Exécutez la commande dns managed-zones update
:
gcloud dns managed-zones update NAME \ --description=DESCRIPTION \ --networks=VPC_NETWORK_LIST
Remplacez les éléments suivants :
NAME
: nom de votre zoneDESCRIPTION
: description de votre zoneVPC_NETWORK_LIST
: liste de réseaux VPC autorisés à interroger la zone, séparés par une virgule.
Mettre à jour les étiquettes
Pour ajouter, modifier ou supprimer un libellé, ou supprimer tous les libellés d'une zone gérée, procédez comme suit :
gcloud
Exécutez la commande dns managed-zones update
:
gcloud dns managed-zones update NAME \ --update-labels=LABELS
gcloud dns managed-zones update NAME \ --remove-labels=LABELS
gcloud dns managed-zones update NAME \ --clear-labels
Remplacez les éléments suivants :
NAME
: nom de votre zoneLABELS
: liste facultative de paires clé/valeur séparées par une virgule, telle quedept=marketing
ouproject=project1
. Pour en savoir plus, consultez la documentation du SDK.
Répertorier et décrire les zones gérées
Les sections suivantes expliquent comment répertorier ou décrire une zone gérée.
Répertorier les zones gérées
Pour répertorier toutes les zones gérées d'un projet, procédez comme suit :
Console
Dans Google Cloud Console, accédez à la page Zones Cloud DNS.
Affichez les zones gérées dans le volet de droite.
gcloud
Exécutez la commande dns managed-zones list
:
gcloud dns managed-zones list
Pour répertorier toutes les zones gérées, modifiez la commande comme suit :
gcloud dns managed-zones list
--filter="visibility=public"
gcloud dns managed-zones list \ --filter="visibility=private"
Décrire une zone gérée
Pour afficher les attributs d'une zone gérée, procédez comme suit :
Console
Dans Google Cloud Console, accédez à la page Zones Cloud DNS.
Cliquez sur la zone que vous souhaitez inspecter.
gcloud
Exécutez la commande dns managed-zones describe
:
gcloud dns managed-zones describe NAME
Remplacez NAME
par le nom de votre zone.
Supprimer une zone gérée
Lorsque vous supprimez une zone, ses enregistrements DNS sont supprimés définitivement et ne peuvent pas être récupérés. Pour éviter de perdre vos enregistrements DNS, exportez vos données de zone avant de les supprimer. Pour savoir comment exporter des données de zone, consultez la section Importer et exporter des jeux d'enregistrements de ressources.
Pour supprimer une zone gérée, procédez comme suit :
Console
Dans Google Cloud Console, accédez à la page Zones Cloud DNS.
Cliquez sur la zone gérée que vous souhaitez supprimer.
Cliquez sur Supprimer la zone.
gcloud
Supprimez tous les enregistrements de la zone, à l'exception des enregistrements
SOA
etNS
. Pour en savoir plus, consultez la section Supprimer un enregistrement. Vous pouvez rapidement vider une zone entière en important un fichier vide dans un jeu d'enregistrements. Pour en savoir plus, consultez la section Importer et exporter des jeux d'enregistrements. Exemple :touch empty-file gcloud dns record-sets import -z NAME \ --delete-all-existing \ empty-file rm empty-file
Remplacez
NAME
par le nom de votre zone.Pour supprimer une nouvelle zone gérée privée, exécutez la commande
dns managed-zones delete
:gcloud dns managed-zones delete NAME
Remplacez
NAME
par le nom de votre zone.
Étapes suivantes
- Pour trouver des solutions aux problèmes courants que vous pouvez rencontrer lors de l'utilisation de Cloud DNS, consultez la page Dépannage.
- Pour configurer des règles de serveur Cloud DNS et les utiliser avec des réseaux VPC, consultez la page Appliquer des règles de serveur Cloud DNS.
- Pour utiliser des IDN avec Cloud DNS, consultez la page Créer des zones avec des noms de domaine internationalisés.
- Pour afficher un journal d'audit des opérations, consultez la page Visualiser les opérations effectuées sur des zones gérées.