Configurer des liaisons DNS

Cette page explique comment configurer des liaisons DNS pour les réseaux VMware Engine standards.

Chaque cloud privé déploie un serveur Cloud DNS utilisé pour la résolution de tous les dispositifs de gestion. Vous pouvez configurer ce serveur en tant que serveur DNS pour toutes les charges de travail VMware en configurant des liaisons DNS. Pour ce faire, procédez comme suit:

  1. Obtenir l'adresse IP du serveur DNS du cloud privé
  2. Configurer des autorisations de liaison DNS pour permettre à un compte principal d'utilisateur de s'associer au VPC intranet
  3. Configurez le DNS pour vos charges de travail VMware ou le paramètre DNS DHCP du segment NSX-T

Avant de commencer

Vous ne pouvez configurer des liaisons DNS qu'à l'aide de l'outil gcloud ou de l'API.

Conditions requises pour gcloud et l'API

Pour gérer vos ressources VMware Engine à l'aide de l'outil de ligne de commande gcloud ou de l'API, nous vous recommandons de configurer les outils comme décrit ci-dessous.

gcloud

  1. Définissez votre ID de projet par défaut :

    gcloud config set project PROJECT_ID
    
  2. Définissez une région et une zone par défaut :

    gcloud config set compute/region REGION
    
    gcloud config set compute/zone ZONE
    

Pour en savoir plus sur l'outil gcloud vmware, consultez la documentation de référence de Cloud SDK Cloud.

API

Les exemples d'API de cette documentation utilisent l'outil de ligne de commande cURL pour interroger l'API. Vous devez indiquer un jeton d'accès valide dans la requête cURL. Il existe de nombreuses façons d'obtenir un jeton d'accès valide. Les étapes suivantes font appel à l'outil gcloud pour générer un jeton d'accès:

  1. Connectez-vous à Google Cloud:

    gcloud auth login
    
  2. Générez un jeton d'accès et exportez-le vers TOKEN:

    export TOKEN=`gcloud auth print-access-token`
    
  3. Vérifiez que TOKEN est correctement défini:

    echo $TOKEN
    

À présent, utilisez le jeton d'autorisation dans vos requêtes adressées à l'API. Exemple :

curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

Les exemples de code Python présentés dans cette documentation utilisent la bibliothèque VMware Engine pour communiquer avec l'API. Pour que vous puissiez utiliser cette approche, la bibliothèque doit être installée et les identifiants par défaut de l'application doivent être configurés.

  1. Téléchargez et installez la bibliothèque Python:

    pip install google-cloud-vmwareengine
    
  2. Configurez les informations relatives à l'ADC en exécutant ces commandes dans votre shell:

    gcloud auth application-default login
    

    Vous pouvez également utiliser un fichier de clé de compte de service:

    export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
    

Pour en savoir plus sur la bibliothèque, consultez la page de référence ou les exemples de code sur GitHub.

Obtenir l'adresse IP du serveur DNS d'une charge de travail de cloud privé

Console

Pour obtenir l'adresse IP du serveur DNS de votre cloud privé, procédez comme suit :

  1. Accédez à la console Google Cloud.
  2. Dans le menu de navigation principal, cliquez sur Private clouds (Clouds privés).
  3. Cliquez sur le nom du cloud privé auquel vous souhaitez vous connecter.
  4. Sur la page Résumé du cloud privé, sous Serveurs DNS Cloud privés, cliquez sur Copier pour copier l'adresse IP du serveur Cloud DNS privé.

gcloud

Pour obtenir l'adresse IP du serveur DNS de votre cloud privé à l'aide de Google Cloud CLI, exécutez la commande gcloud vmware private-clouds describe:

gcloud vmware private-clouds describe \
  --private-cloud=PRIVATE_CLOUD_ID \
  --project=PROJECT_ID \
  --location=REGION

Remplacez les éléments suivants :

  • PRIVATE_CLOUD_ID: nom du cloud privé pour cette requête
  • PROJECT_ID : ID du projet pour cette requête
  • REGION: région du cloud privé. S'il s'agit d'un cloud privé étendu, spécifiez la zone de ce cloud privé.

API

Pour obtenir l'adresse IP du serveur DNS de votre cloud privé à l'aide de l'API VMware Engine, exécutez une requête GET:

curl -X GET -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/privateCloud/PRIVATE_CLOUD_ID"

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet pour cette requête
  • REGION: région du cloud privé. S'il s'agit d'un cloud privé étendu, spécifiez la zone de ce cloud privé.
  • PRIVATE_CLOUD_ID: nom du cloud privé pour cette requête.

Configurer les autorisations de liaison DNS

Vous ne pouvez configurer et gérer les autorisations de liaison DNS qu'avec l'outil gcloud ou directement avec l'API REST. Il n'est pas possible de configurer des liaisons via la console.

Accorder l'autorisation de liaison DNS

Pour qu'un utilisateur puisse configurer des liaisons DNS, vous devez accorder à un compte principal d'utilisateur l'autorisation de s'associer au VPC intranet. Dans ce cas, un compte principal d'utilisateur est l'adresse e-mail de l'utilisateur qui liera la zone DNS privée au VPC intranet.

gcloud

gcloud vmware dns-bind-permission grant \
  --user=USER

Remplacez USER par l'adresse e-mail de l'utilisateur qui va lier la zone DNS privée au VPC intranet. Par exemple, example1@gmail.com.

API

Envoyez une requête POST à la méthode dnsBindPermissions:grant et indiquez l'adresse e-mail de l'utilisateur dans le corps de la requête.

curl -X POST -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/privateClouds/dnsBindPermission:grant

{
"Principal": {
  "user": "USER"
}
}

Remplacez les éléments suivants :

  • PROJECT_ID: projet concerné par cette requête.
  • USER: adresse e-mail de l'utilisateur dont vous souhaitez révoquer les autorisations. Par exemple, example1@gmail.com.

Révoquer l'autorisation de liaison DNS

Révoque l'autorisation de liaison DNS précédemment accordée à l'utilisateur.

gcloud

gcloud vmware dns-bind-permission revoke \
  --user=USER

Remplacez USER par l'adresse e-mail de l'utilisateur dont vous souhaitez révoquer les autorisations. Par exemple, example1@gmail.com.

API

Envoyez une requête POST à dnsBindPermissions:revoke et indiquez l'adresse e-mail de l'utilisateur dans le corps de la requête.

curl -X POST -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/privateClouds/dnsBindPermission:revoke

{
"Principal": {
  "user": "USER"
}
}

Remplacez les éléments suivants :

  • PROJECT_ID: projet concerné par cette requête.
  • USER: adresse e-mail de l'utilisateur dont vous souhaitez révoquer les autorisations. Par exemple, example1@gmail.com.

Décrire l'autorisation de liaison DNS

Décrit les autorisations de liaison DNS pour un projet et le compte principal de l'utilisateur qui a accès pour configurer les liaisons DNS.

gcloud

gcloud vmware dns-bind-permission describe

API

Envoyez une requête GET à la ressource dnsBindPermissions.

curl -X GET -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/privateClouds/dnsBindPermission

Remplacez PROJECT_ID par le projet concerné par cette requête.

Lier une zone Cloud DNS privée au VPC intranet du réseau VMware Engine

Une fois que vous avez accordé à un compte principal d'utilisateur les autorisations nécessaires pour configurer les liaisons DNS, l'utilisateur peut créer une liaison entre la zone DNS privée dans Cloud DNS et le VPC intranet du réseau VMware Engine. VMware Engine utilise l'appairage DNS pour faciliter la résolution dans Cloud DNS.

Localiser l'URL du VPC intranet

Vous avez besoin de l'URL du VPC de l'intranet du réseau pour créer la liaison. Pour trouver le VPC intranet du réseau VMware Engine, répertoriez les détails du réseau VMware Engine.

Console

Pour localiser l'URL d'un réseau VPC intranet à l'aide de la console Google Cloud, procédez comme suit:

  1. Accédez à la console Google Cloud.
  2. Dans le menu de navigation principal, cliquez sur Réseaux VMware Engine.
  3. Recherchez le réseau VMware Engine, cliquez sur l'option Action et sélectionnez Copier l'URL du réseau VPC intranet.

gcloud

gcloud vmware networks describe VMWARE_ENGINE_NETWORK

Remplacez VMWARE_ENGINE_NETWORK par le réseau à décrire. Dans la réponse, gcloud renvoie les détails du réseau contenant l'URL du VPC intranet.

API

Envoyez une requête GET à la ressource vmwareEngineNetworks et indiquez le nom du réseau:

curl -X GET -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwarenEngineNetworks/NETWORK_ID

Remplacez les éléments suivants :

  • PROJECT_ID: projet concerné par cette requête
  • NETWORK_ID: réseau à décrire

Liaison

Une fois les autorisations de liaison configurées, le workflow prévu consiste à ajouter un appairage DNS au VPC intranet du réseau VMware Engine dans votre processus de gestion de zone Cloud DNS standard pour chaque zone.

gcloud

gcloud dns managed-zones create peering-DOMAIN  \
--dns-name="DOMAIN" \
--visibility="private" \
--networks="INTRANET_VPC_URL" \
--target-project="PROJECT_ID" \
--target-network="EXISTING_VPC" \
--description="DESCRIPTION"

Remplacez les éléments suivants :

  • DOMAIN: domaine étendu (par exemple, zone1.example.com)
  • INTRANET_VPC_URL: URL du VPC intranet pour le réseau VMware Engine
  • EXISTING_VPC: URL du réseau VPC existant auquel DOMAIN est déjà lié.
  • PROJECT_ID : ID du projet pour cette requête

API

Envoyez une requête PATCH à la ressource managedZones et indiquez le nom de la zone:

curl -X POST -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://dns.googleapis.com/v1/projects/PROJECT_ID/managedZones -d "{
"name": "peering-DOMAIN",
"description": "",
"dnsName": DOMAIN,
"peeringConfig": {
    "targetNetwork": {
        "networkUrl": EXISTING_VPC
    }
  },
  "privateVisibilityConfig": {
    "networks": [
      {
        "networkUrl": INTRANET_VPC_URL
      }
    ]
  }
}"

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet pour cette requête
  • DOMAIN: domaine étendu (par exemple, zone1.example.com)
  • INTRANET_VPC_URL: URL du VPC intranet du réseau VMware Engine.
  • EXISTING_VPC: URL du réseau VPC existant auquel le DOMAIN est déjà lié.

Exemples de liaisons DNS

Voici quelques exemples de liaisons DNS que vous pouvez utiliser.

Primaire

gcloud dns managed-zones create zone1 \
  --dns-name="zone1.example.com." \
  --visibility="private" \
  --description="DESCRIPTION" \
  --networks="EXISTING_VPC"
gcloud dns managed-zones create peering-zone1 \
  --dns-name="zone1.example.com." \
  --visibility="private" \
  --networks="INTRANET_VPC_URL" \
  --target-project="PROJECT_ID" \
  --target-network="EXISTING_VPC" \
  --description="DESCRIPTION"

Transfert conditionnel

gcloud dns managed-zones create zone1 \
  --description="DESCRIPTION" \
  --dns-name="zone1.example.com." \
  --visibility="private" \
  --networks=EXISTING_VPC \
  --forwarding-targets="DNS_SERVER_IP1","DNS_SERVER_IP2"
gcloud dns managed-zones create peering-zone1 \
  --dns-name="zone1.example.com." \
  --visibility="private" \
  --networks="INTRANET_VPC_URL" \
  --target-project="PROJECT_ID" \
  --target-network="EXISTING_VPC" \
  --description="DESCRIPTION"

Tout transférer

gcloud dns managed-zones create forward-all \
  --description="" --dns-name="." \
  --visibility="private" \
  --networks="EXISTING_VPC" \
  --forwarding-targets="DNS_SERVER_IP1","DNS_SERVER_IP2"
gcloud dns managed-zones create peering-forward-all \
  --dns-name="." \
  --visibility="private" \
  --networks="INTRANET_VPC_URL" \
  --target-project="PROJECT_ID" \
  --target-network="EXISTING_VPC" \
  --description="DESCRIPTION"

API Google privée

gcloud dns managed-zones create googleapis \
  --dns-name="googleapis.com." \
  --visibility="private" \
  --description="Direct GCVE traffic to Private IPs for Google API Access" \
  --networks="EXISTING_VPC"
gcloud dns managed-zones create peering-googleapis  \
  --dns-name="googleapis.com." \
  --visibility="private" \
  --networks="INTRANET_VPC_URL" \
  --target-project="PROJECT_ID" \
  --target-network="EXISTING_VPC" \
  --description="DESCRIPTION"
gcloud dns record-sets create private.googleapis.com. \
  --zone="googleapis" \
  --type="A" \
  --ttl="300" \
  --rrdatas="199.36.153.8,199.36.153.9,199.36.153.10,199.36.153.11"
gcloud dns record-sets create *.googleapis.com. \
  --zone="googleapis" \
  --type="CNAME" \
  --ttl="300" \
  --rrdatas="private.googleapis.com."

API Google limitée

gcloud dns managed-zones create googleapis \
  --dns-name="googleapis.com." \
  --visibility="private" \
  --description="Direct GCVE traffic to Private IPs for Google API Access" \
  --networks="EXISTING_VPC"
gcloud dns managed-zones create peering-googleapis \
  --dns-name="googleapis.com." \
  --visibility="private" \
  --networks="INTRANET_VPC_URL" \
  --target-project="PROJECT_ID" \
  --target-network="EXISTING_VPC" \
  --description="DESCRIPTION"
gcloud dns record-sets create restricted.googleapis.com. \
  --zone="googleapis" \
  --type="A" \
  --ttl="300" \
  --rrdatas="199.36.153.4, 199.36.153.5, 199.36.153.6, 199.36.153.7"
gcloud dns record-sets create *.googleapis.com. \
  --zone="googleapis" \
  --type="CNAME" \
  --ttl="300" \
  --rrdatas="restricted.googleapis.com."