Exécuter des tests de connectivité

Découvrez comment exécuter des tests de connectivité en suivant les étapes décrites dans cette page.

Pour modifier ou supprimer un ou plusieurs tests, consultez la section Mettre à jour ou supprimer des tests de connectivité.

Pour en savoir plus sur les tests de connectivité, consultez la présentation.

Avant de commencer

Configurez les éléments suivants dans Google Cloud avant d'utiliser les tests de connectivité :

  1. Dans Google Cloud Console, accédez à la page de sélection du projet.

    Accéder à la page de sélection du projet

  2. Sélectionnez ou créez un projet Google Cloud.
  3. Assurez-vous que la facturation est activée pour votre projet Cloud.
  4. Activer l'API Network Management

Les procédures décrites dans ce document sont les suivantes :

  • Exemples d'appels d'API qui utilisent l'API Network Management Pour plus d'informations, consultez la section Documentation sur l'API.

  • Exemple de code qui utilisent le client Python de l'API

Utiliser le client Python de l'API

L'exemple de code présenté dans ce document suppose que vous avez créé une ressource nommée api pour interagir avec l'API Network Management. Pour créer une ressource, utilisez la fonction build.

Consultez l'exemple ci-dessous :

 from googleapiclient.discovery import build

 api = build('networkmanagement', 'v1')

Pour en savoir plus, consultez les ressources suivantes :

Utiliser l'API Explorer

Vous pouvez tester les commandes de l'API Network Management à l'aide de l'explorateur d'API. Dans la documentation de référence de l'API Network Management, reportez-vous à la colonne Try this API pour explorer les champs de l'API et exécuter un test.

Utiliser le SDK gcloud

L'outil de ligne de commande gcloud fait partie du SDK Cloud. Pour installer la dernière version de l'outil gcloud, consultez la documentation du SDK Cloud.

Pour obtenir la liste de toutes les commandes, reportez-vous à la documentation de référence sur les commandesgcloud.

Obtenir les autorisations de test

Pour plus d'informations sur les autorisations que vous devez exécuter et afficher des tests, consultez la section Contrôle des accès pour les tests de connectivité.

Vérifier une opération de test en cours d'exécution

Pour vérifier l'état d'une opération de test pendant son exécution, reportez-vous à la page Vérifier une opération de test en cours.

create et rerun sont deux exemples d'opérations de test.

Exécuter des tests de connectivité

Lorsque vous exécutez un test de connectivité, vous fournissez des entrées de test sous forme de hachage à cinq tuples sans le port source.

Les sections suivantes expliquent comment exécuter un test pour les points de terminaison source et de destination décrits dans les cas d'utilisation courants.

Vous pouvez lancer des tests de connectivité à partir de Google Cloud Console, en utilisant l'une des méthodes suivantes :

  • Depuis la page Tests de connectivité, disponible dans le menu Réseau > Network Intelligence Center.

  • Depuis la page Détails de l'interface réseau pour l'interface réseau d'une instance de machine virtuelle (VM) Compute Engine Si vous utilisez cette page, vous devez utiliser l'interface réseau actuelle comme Source ou Destination du test. Cette page répertorie uniquement les tests pertinents pour l'interface réseau actuelle.

Chaque test que vous créez s'exécute immédiatement après sa création et est stocké dans la ressource Connectivity Tests. Un test existe jusqu'à ce que vous le supprimiez.

Lorsque vous utilisez une adresse IP pour le point de terminaison source ou de destination, vous devrez peut-être spécifier des champs supplémentaires.

Bonnes pratiques

  • Lorsque vous testez un point de terminaison (une VM ou une adresse IP) situé dans un projet de service VPC partagé, il est plus pratique d'exécuter le test à partir du projet de service. En effet, vous pouvez sélectionner la VM ou l'adresse IP dans la liste déroulante de Cloud Console.

    Cependant, vous devez toujours spécifier le projet hôte avant de spécifier le réseau cloud privé virtuel (VPC), car le réseau se trouve dans le projet hôte. Pour plus d'informations, consultez la page Tester des adresses IP dans un réseau VPC partagé.

  • Lors de l'exécution d'un test entre votre réseau VPC et votre réseau pair ou sur site, il peut être utile d'exécuter un autre test de connectivité en utilisant l'adresse IP sur site comme source, et une instance de VM ou adresse IP de votre réseau VPC comme destination.

    Ce type de test vérifie que Google Cloud publie les routes comme prévu vers votre réseau sur site. Cependant, les tests de connectivité ne vérifient pas que votre réseau sur site a reçu et mis en œuvre ces routes.

  • Entre 20 et 120 secondes s'écoulent pour que les tests de connectivité reçoivent une mise à jour de la configuration et l'intègrent à l'analyse. Si vous exécutez un test immédiatement après avoir modifié une configuration, vous risquez de ne pas obtenir les résultats attendus. Veillez à patienter suffisamment entre une modification de la configuration et l'exécution de vos tests.

    Ce délai ne s'applique pas à la validation dynamique. Par conséquent, vous pouvez constater une différence temporaire entre les résultats affichés par la validation dynamique et l'analyse de configuration. Par exemple, si vous ajoutez une règle de pare-feu, elle peut être joignable pour la validation dynamique. Toutefois, vous devrez peut-être attendre un certain temps avant que la règle de pare-feu soit joignable pour l'analyse de configuration.

Effectuer un test vers ou depuis une VM avec plusieurs interfaces réseau

Cette section explique comment effectuer des tests vers ou depuis l'interface réseau non principale d'une VM.

Console

Si vous spécifiez une instance de VM avec plusieurs interfaces réseau comme source ou destination d'un test, les tests de connectivité vous invitent à sélectionner une interface réseau dans un menu déroulant.

Vous pouvez également exécuter un test depuis la page Informations sur l'interface réseau d'une interface réseau d'une instance de VM Compute Engine. Si vous utilisez cette page, vous devez utiliser l'interface réseau actuelle comme Source ou Destination du test.

gcloud et API

Vous devez spécifier l'interface réseau à utiliser pour le test de l'une des manières suivantes :

  • Adresse IP et URI du réseau
  • Adresse IP et URI de la VM
  • URI du réseau et URI de la VM

Si vous fournissez uniquement l'URI d'une VM avec plusieurs interfaces, seule l'interface principale de la VM est sélectionnée.

Répertorier tous les tests pour un projet

Console

  1. Dans Cloud Console, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. En haut de la page, sélectionnez un projet dans le menu déroulant.
  3. La page Tests de connectivité s'actualise et affiche les tests pour ce projet.

gcloud

Pour répertorier tous les tests appartenant à un projet, saisissez la commande gcloud suivante. Cette commande affiche les tests dans le projet actuellement sélectionné.

  gcloud network-management connectivity-tests list

Pour répertorier les tests dans un projet spécifique, spécifiez l'PROJECT_ID.

  gcloud network-management connectivity-tests list --project=PROJECT_ID

API

Pour répertorier tous les tests existants appartenant à un projet, utilisez la méthode networkmanagement.connectivitytests.list.

GET https://networkmanagement.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/global}/connectivityTests
  • Remplacez PROJECT_ID par l'ID du projet contenant les tests que vous souhaitez répertorier.

Python

L'exemple de code suivant répertorie tous les tests existants appartenant à un projet. Pour en savoir plus, consultez la section list dans la documentation de référence du client Python de l'API.

project_id = "PROJECT_ID"
parent = 'projects/%s/locations/global' % project_id
request = api.projects().locations().global_().connectivityTests().list(parent=parent)
print(json.dumps(request.execute(), indent=4))

Remplacez PROJECT_ID par l'ID du projet contenant les tests que vous souhaitez répertorier.

Effectuer un test entre des instances de VM dans un réseau VPC

Ces étapes supposent que les deux instances de VM se trouvent dans le même projet Google Cloud.

Console

Depuis la page principale Tests de connectivité

  1. Dans Cloud Console, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Sélectionnez Créer un test de connectivité.
  3. Saisissez un nom pour le test.
  4. Sélectionnez un protocole.
  5. Sous Source, sélectionnez une instance de VM source dans le menu déroulant.
    • Si l'instance de VM comporte plusieurs interfaces réseau, sélectionnez une interface réseau de VM qui identifie de manière unique l'emplacement source.
  6. Sous Destination, sélectionnez une instance de VM de destination dans le menu déroulant.
    • Si l'instance de VM comporte plusieurs interfaces réseau, sélectionnez une interface réseau de VM pour identifier de manière unique l'emplacement de destination.
  7. Saisissez un port de destination.
  8. Cliquez sur Create (Créer).
  9. Une fois le test terminé, la page principale Tests de connectivité s'affiche. Elle contient une liste incluant ce test, ainsi que d'autres tests. Continuez vers Afficher les résultats du test.

Depuis la page d'informations Interface réseau

  1. Dans Cloud Console, accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Si ce n'est pas déjà fait, sélectionnez le projet contenant l'instance pour laquelle vous souhaitez exécuter un test.
  3. Cliquez sur l'instance à utiliser pour exécuter un test.
  4. Sous Interfaces réseau, sélectionnez l'interface réseau que vous souhaitez utiliser pour exécuter un test.
  5. Sous Analyse du réseau, cliquez sur Tests de connectivité, puis sur Créer.
  6. Saisissez un nom pour le test.
  7. Sélectionnez un protocole.
  8. Si vous souhaitez utiliser l'interface réseau actuelle comme source, sélectionnez Interface réseau actuelle sous Source. Sinon, sélectionnez Interface réseau actuelle sous Destination.
  9. Sous le champ Autre développé, sélectionnez une instance de VM dans le menu déroulant.
    • Si l'instance de VM comporte plusieurs interfaces réseau, sélectionnez une interface réseau de VM pour identifier de manière unique l'emplacement de destination.
  10. Saisissez un port de destination pour la destination spécifiée.
  11. Cliquez sur Create (Créer).
  12. Une fois le test terminé, la page principale Tests de connectivité s'affiche. Elle contient une liste incluant ce test, ainsi que d'autres tests. Continuez vers Afficher les résultats du test.

gcloud

Pour effectuer un test entre des VM d'un même projet Cloud, saisissez la commande suivante. Remplacez les exemples de valeurs par les valeurs de votre réseau VPC.

  gcloud network-management connectivity-tests create NAME \
  --source-instance=SOURCE_INSTANCE
  --destination-instance=DESTINATION_INSTANCE
  --protocol=PROTOCOL

Remplacez les valeurs suivantes :

  • NAME : nom du test de connectivité.
  • SOURCE_INSTANCE : URI de la VM source (par exemple, projects/myproject/zones/us-east1-b/instances/instance-1).
  • DESTINATION_INSTANCE : URI de la VM de destination (par exemple, projects/myproject/zones/us-east1-b/instances/instance-2).
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

API

L'exemple de test suivant détermine si la configuration réseau existante permet à la VM instance1 d'envoyer une requête ping à la VM instance2.

Utilisez la méthode networkmanagement.connectivitytests.create pour créer le test.

 POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
     "instance": "SOURCE_INSTANCE",
   },
     "destination": {
     "instance": "DESTINATION_INSTANCE",
   },
     "protocol": "PROTOCOL",
   }'

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.
  • SOURCE_INSTANCE : URI de la VM source (par exemple, projects/myproject/zones/us-east1-b/instances/instance-1).
  • DESTINATION_INSTANCE : URI de la VM de destination (par exemple, projects/myproject/zones/us-east1-b/instances/instance-2).
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

Python

L'exemple de code suivant crée un test entre deux instances de VM. Pour en savoir plus, consultez la section create dans la documentation de référence du client Python de l'API.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "instance":
          "DESTINATION_INSTANCE",
      "projectId": "DESTINATION_INSTANCE_PROJECT_ID"
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • SOURCE_INSTANCE : URI de la VM source (par exemple, projects/myproject/zones/us-east1-b/instances/instance-1).
  • SOURCE_INSTANCE_PROJECT_ID : ID de projet de la VM source.
  • DESTINATION_INSTANCE : URI de la VM de destination (par exemple, projects/myproject/zones/us-east1-b/instances/instance-2).
  • DESTINATION_INSTANCE_PROJECT_ID : ID de projet de la VM de destination.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.
  • PROJECT_ID : ID du projet dans lequel vous créez le test.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Effectuer un test entre des adresses IP privées dans un réseau VPC

Cet exemple suppose que les deux adresses IP sont des adresses IP privées situées dans le même projet Cloud et sur le même réseau VPC.

Si vous effectuez le test entre des réseaux VPC appairés, sélectionnez les réseaux source et de destination pour chaque pair.

Console

  1. Dans Cloud Console, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Sélectionnez Créer un test de connectivité.
  3. Saisissez un nom pour le test.
  4. Sélectionnez un protocole.
  5. Sous IP source ou instance, sélectionnez Adresse IP et saisissez une adresse IP.
    1. Sélectionnez la case Il s'agit d'une adresse IP utilisée dans Google Cloud.
    2. S'il s'agit d'une adresse IP interne, non accessible depuis Internet, sélectionnez le réseau VPC où se trouve l'adresse.
  6. Sous IP ou instance de destination, sélectionnez Adresse IP et saisissez une adresse IP.
    1. Sélectionnez la case Il s'agit d'une adresse IP utilisée dans Google Cloud.
    2. S'il s'agit d'une adresse IP interne, non accessible depuis Internet, sélectionnez le réseau VPC où se trouve l'adresse.
  7. Saisissez un port de destination.
  8. Cliquez sur Create (Créer).
  9. Une fois le test terminé, la page principale Tests de connectivité s'affiche. Elle contient une liste incluant ce test, ainsi que d'autres tests. Continuez vers Afficher les résultats du test.

gcloud

Saisissez la commande suivante pour effectuer un test entre deux adresses IP internes dans le même projet et le même réseau. Remplacez les variables des options de commande par les valeurs de votre réseau VPC.

  gcloud network-management connectivity-tests create NAME \
  --source-ip-address=SOURCE_IP_ADDRESS \
  --source-network=SOURCE_NETWORK
  --destination-ip-address=DESTINATION_IP_ADDRESS \
  --destination-network=DESTINATION_NETWORK \
  --protocol=PROTOCOL

Remplacez les valeurs suivantes :

  • NAME : nom du test de connectivité.
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_NETWORK : URI du réseau VPC où se trouve l'adresse IP source (par exemple, projects/myproject/global/networks/default).
  • DESTINATION_IP_ADDRESS : adresse IP de destination interne ou externe vers laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • DESTINATION_NETWORK : URI du réseau VPC où se trouve l'adresse IP de destination (par exemple, projects/myproject/global/networks/network-a).
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

Si le réseau est inconnu ou si vous n'êtes pas autorisé à y accéder, vous pouvez le spécifier en tant que GCP_NETWORK, au lieu de fournir un URI de réseau.

  gcloud network-management connectivity-tests create NAME \
  --source-ip-address=SOURCE_IP_ADDRESS \
  --source-network-type=GCP_NETWORK \
  --destination-instance=DESTINATION_INSTANCE  \
  --protocol=PROTOCOL

Remplacez les valeurs suivantes :

  • NAME : nom du test de connectivité.
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_NETWORK_TYPE : type de réseau sur lequel se trouve la source. Dans ce cas, utilisez la valeur GCP_NETWORK.
  • DESTINATION_INSTANCE : URI de la VM de destination (par exemple, projects/myproject/zones/us-east1-b/instances/instance-2).
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

Lorsque vous spécifiez une adresse IP privée provenant de l'extérieur de Google Cloud en tant qu'adresse IP source, vous devez spécifier un networkType NON_GCP_NETWORK. Remplacez les valeurs de la commande suivante par des valeurs de votre réseau VPC.

  gcloud network-management connectivity-tests create NAME \
  --source-ip-address=SOURCE_IP_ADDRESS \
  --source-network-type=NON_GCP_NETWORK \
  --destination-ip-address= DESTINATION_IP_ADDRESS \
  --destination-network=DESTINATION_NETWORK \
  --destination-port=DESTINATION_PORT \
  --protocol=PROTOCOL

Remplacez les valeurs suivantes :

  • NAME : nom du test de connectivité.
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_NETWORK_TYPE : type de réseau sur lequel se trouve la source. Dans ce cas, utilisez la valeur NON_GCP_NETWORK.
  • DESTINATION_IP_ADDRESS : adresse IP de destination interne ou externe vers laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • DESTINATION_NETWORK : URI du réseau VPC où se trouve l'adresse IP de destination (par exemple, projects/myproject/global/networks/default).
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

API

Cet exemple teste la possibilité d'envoyer une requête ping de l'adresse IP source à l'adresse IP de destination.

Utilisez la méthode networkmanagement.connectivitytests.create pour créer le test.

  POST https://reachability.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "network": "SOURCE_NETWORK"
    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
    },
      "protocol": "PROTOCOL".
  }'

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_NETWORK : URI du réseau VPC où se trouve l'adresse IP source (par exemple, projects/myproject/global/networks/default).
  • DESTINATION_IP_ADDRESS : adresse IP de destination interne ou externe vers laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • DESTINATION_NETWORK : URI du réseau VPC où se trouve l'adresse IP de destination (par exemple, projects/myproject/global/networks/network-a).
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

Si le réseau VPC est inconnu ou si vous n'êtes pas autorisé à y accéder, vous pouvez le spécifier en tant que GCP_NETWORK, au lieu de fournir un URI de réseau.

  POST https://reachability.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?connectivityTestId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "networkType": "GCP_NETWORK"
    },
    "destination": {
      "instance": "projects/myproject/zones/us-east1-b/instances/instance-2 ",
    },
    "protocol": "PROTOCOL"
  }'

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_NETWORK_TYPE : type de réseau sur lequel se trouve la source. Dans ce cas, utilisez la valeur GCP_NETWORK.
  • DESTINATION_INSTANCE : URI de la VM de destination (par exemple, projects/myproject/zones/us-east1-b/instances/instance-2).
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

Lorsque vous spécifiez une adresse IP privée provenant de l'extérieur de Google Cloud en tant qu'adresse IP source, vous devez spécifier un networkType NON_GCP_NETWORK. Remplacez les valeurs de la commande suivante par les valeurs de votre réseau Google Cloud.

  POST https://reachability.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "networkType": "NON_GCP_NETWORK",

    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
    },
    "protocol": "PROTOCOL",
  }'

Python

L'exemple de code ci-dessous permet de créer un test entre deux adresses IP. Pour en savoir plus, consultez la section create dans la documentation de référence du client Python de l'API.

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
      "projectId": "DESTINATION_IP_PROJECT_ID"
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_IP_PROJECT_ID : ID de projet pour l'adresse IP source.
  • DESTINATION_IP_ADDRESS : adresse IP de destination interne ou externe vers laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • DESTINATION_IP_PROJECT_ID : ID de projet pour l'adresse IP de destination.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.
  • PROJECT_ID : ID du projet dans lequel vous créez le test.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Si le réseau VPC est inconnu ou si vous n'êtes pas autorisé à y accéder, vous pouvez le spécifier en tant que GCP_NETWORK, au lieu de fournir un URI de réseau. Consultez l'exemple de code suivant :

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "GCP_NETWORK"
    },
    "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "port": "DESTINATION_PORT",
        "projectId": "DESTINATION_IP_PROJECT_ID"
    },
    "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
  parent="projects/PROJECT_ID/locations/global",
  testId="TEST_ID",
  body=test_input)

print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_NETWORK_TYPE : type de réseau sur lequel se trouve la source. Dans ce cas, utilisez la valeur GCP_NETWORK.
  • DESTINATION_IP_ADDRESS : adresse IP de la VM de destination.
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • DESTINATION_IP_PROJECT_ID : ID de projet pour l'adresse IP de destination.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.
  • PROJECT_ID : ID du projet dans lequel vous créez le test.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Lorsque vous spécifiez une adresse IP privée provenant de l'extérieur de Google Cloud en tant qu'adresse IP source, vous devez spécifier un networkType NON_GCP_NETWORK.

Effectuer un test des adresses IP dans un réseau VPC partagé

Lorsque vous disposez d'un réseau VPC partagé, vous pouvez créer et exécuter un test à partir du projet hôte ou du projet de service.

L'exemple suivant décrit les deux cas et utilise une adresse IP de destination allouée dans le projet de service. Les valeurs de champ dans Cloud Console sont légèrement différentes pour chaque cas. Cependant, les options de commande de l'outil de ligne de commande gcloud et des appels d'API sont les mêmes.

Console : depuis l'hôte

  1. Dans Cloud Console, à partir du projet hôte, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Sélectionnez Créer un test de connectivité.
  3. Saisissez un nom pour le test.
  4. Sélectionnez un protocole.
  5. Sous IP source ou instance, sélectionnez Adresse IP et saisissez une adresse IP.
    1. Assurez-vous que la case Il s'agit d'une adresse IP utilisée dans Google Cloud est cochée.
    2. Sélectionnez l'instance ou l'adresse IP source.
  6. Sous IP ou instance de destination, sélectionnez Adresse IP et saisissez une adresse IP.
    1. Assurez-vous que la case Il s'agit d'une adresse IP utilisée dans Google Cloud est cochée.
    2. Spécifiez le projet de service où se trouve l'adresse IP.
    3. Sélectionnez le réseau dans le projet hôte (actuel) où se trouve l'adresse IP.
  7. Saisissez un port de destination.
  8. Cliquez sur Create (Créer).
  9. Une fois le test terminé, la page principale Tests de connectivité s'affiche. Elle contient une liste incluant ce test, ainsi que d'autres tests. Continuez vers Afficher les résultats du test.

Console : depuis le service

  1. Dans Cloud Console, à partir du projet de service, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Sélectionnez Créer un test de connectivité.
  3. Saisissez un nom pour le test.
  4. Sélectionnez un protocole. Pendant la phase bêta, seuls les protocoles affichés dans le menu sont disponibles.
  5. Sous IP source ou instance, sélectionnez Adresse IP et saisissez une adresse IP.
    1. Assurez-vous que la case Il s'agit d'une adresse IP utilisée dans Google Cloud est cochée.
  6. Sous IP ou instance de destination, sélectionnez Adresse IP et saisissez une adresse IP.
    1. Assurez-vous que la case Il s'agit d'une adresse IP utilisée dans Google Cloud est cochée.
    2. Spécifiez le projet de service où se trouve l'adresse IP.
    3. Sélectionnez la case Le réseau se trouve dans un projet autre que le projet actuel.
    4. Sélectionnez le projet hôte.
    5. Sélectionnez le réseau où se trouve l'adresse IP.
  7. Saisissez un port de destination.
  8. Cliquez sur Create (Créer).
  9. Une fois le test terminé, la page principale Tests de connectivité s'affiche. Elle contient une liste incluant ce test, ainsi que d'autres tests. Continuez vers Afficher les résultats du test.

gcloud

Saisissez la commande suivante pour effectuer un test entre deux adresses IP privées dans un projet hôte et dans un projet de service, où l'adresse IP de destination se trouve dans le projet de service. Remplacez les variables des options de commande par les valeurs de votre réseau VPC.

Comme l'adresse IP de destination se trouve dans le projet de service, spécifiez le projet de service et l'URI du réseau du projet hôte. Dans ce cas, default représente le réseau VPC par défaut du host-project.

  gcloud network-management connectivity-tests create NAME \
  --source-ip-address=SOURCE_IP_ADDRESS \
  --source-project=SOURCE_PROJECT \
  --destination-ip-address=DESTINATION_IP_ADDRESS \
  --destination-network=DESTINATION_NETWORK  \
  --destination-project=DESTINATION_PROJECT \
  --destination-port=DESTINATION_PORT \
  --protocol=PROTOCOL

Remplacez les valeurs suivantes :

  • NAME : nom du test de connectivité.
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_PROJECT : ID de projet du point de terminaison source.
  • DESTINATION_IP_ADDRESS : adresse IP interne ou externe que vous testez dans le projet de service. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge.
  • DESTINATION_NETWORK : URI du réseau VPC pour le projet hôte (par exemple, projects/host-project/global/networks/default).
  • DESTINATION_PROJECT : ID de projet du point de terminaison de destination (par exemple, un projet appelé service-project qui représente le projet de service utilisé pour ce réseau VPC partagé).
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

API

Utilisez la méthode networkmanagement.connectivitytests.create pour créer le test.

  POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
    {
      "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "projectId": "SOURCE_PROJECT",
      },
      "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "projectId": "DESTINATION_PROJECT",
        "network": "DESTINATION_NETWORK",
        "port": "DESTINATION_PORT",
      },
      "protocol": "PROTOCOL",
    }'

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_PROJECT : ID de projet du point de terminaison source.
  • DESTINATION_IP_ADDRESS : adresse IP interne ou externe que vous testez dans le projet de service. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge.
  • DESTINATION_PROJECT : ID de projet du point de terminaison de destination (par exemple, un projet appelé service-project qui représente le projet de service utilisé pour ce réseau VPC partagé).
  • DESTINATION_NETWORK : URI du réseau VPC pour le projet hôte (par exemple, projects/host-project/global/networks/default).
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

Python

L'exemple de code ci-dessous permet de créer un test entre deux adresses IP. Pour en savoir plus, consultez la section create dans la documentation de référence du client Python de l'API.

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "projectId": "DESTINATION_IP_PROJECT_ID",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_IP_PROJECT_ID : ID de projet du point de terminaison source.
  • DESTINATION_IP_ADDRESS : adresse IP interne ou externe que vous testez dans le projet de service. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge.
  • DESTINATION_IP_PROJECT_ID : ID de projet du point de terminaison de destination (par exemple, un projet appelé service-project qui représente le projet de service utilisé pour ce réseau VPC partagé).
  • DESTINATION_NETWORK : URI du réseau VPC pour le projet hôte (par exemple, projects/host-project/global/networks/default).
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.
  • PROJECT_ID : ID du projet dans lequel vous créez le test.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Effectuer des tests depuis une VM vers un service géré par Google (alpha)

Cette section explique comment effectuer un test à partir d'une VM de votre réseau VPC vers un service qui s'exécute dans un réseau VPC appartenant à Google. Par exemple, vous pouvez suivre les étapes de cette section pour tester la connectivité à une instance Cloud SQL ou un maître GKE. Vous pouvez également exécuter un test en utilisant un point de terminaison de service géré par Google comme source et un point de terminaison de votre réseau VPC comme destination.

Par défaut, les tests de connectivité tentent d'exécuter un test en utilisant l'adresse IP privée du point de terminaison du service géré par Google. Si le point de terminaison ne dispose pas d'adresse IP privée, les tests de connectivité utilisent l'adresse IP publique. Les tests de connectivité vérifient que le paquet peut atteindre le point de terminaison, ce qui inclut l'analyse de la configuration au sein du réseau VPC appartenant à Google. Si des problèmes de configuration sont détectés au sein de votre projet, l'analyse s'arrête avant d'analyser la configuration du réseau appartenant à Google.

Pour effectuer le test d'une VM vers un service géré par Google, consultez les instructions suivantes.

Console

Depuis la page principale Tests de connectivité

  1. Dans Cloud Console, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Sélectionnez Créer un test de connectivité.
  3. Saisissez un nom pour le test.
  4. Sélectionnez un protocole.
  5. Sous Source, sélectionnez une instance de VM source dans le menu déroulant.
    • Si l'instance de VM comporte plusieurs interfaces réseau, sélectionnez une interface réseau de VM qui identifie de manière unique l'emplacement source.
  6. Sous Destination, sélectionnez un type de ressource de service géré par Google dans le menu déroulant Point de terminaison de destination, tel que Cluster maître GKE.
    1. Utilisez le menu déroulant supplémentaire à droite pour sélectionner le point de terminaison spécifique. Par exemple, si vous avez sélectionné Cluster maître GKE, sélectionnez le cluster pour lequel vous souhaitez tester la connectivité au maître de cluster.
  7. Saisissez un port de destination.
  8. Cliquez sur Create (Créer).
  9. Une fois le test terminé, la page principale Tests de connectivité s'affiche. Elle contient une liste incluant ce test, ainsi que d'autres tests. Continuez vers Afficher les résultats du test.

Depuis la page d'informations Interface réseau

  1. Dans Cloud Console, accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Si ce n'est pas déjà fait, sélectionnez le projet contenant l'instance pour laquelle vous souhaitez exécuter un test.
  3. Cliquez sur l'instance à utiliser pour exécuter un test.
  4. Sous Interfaces réseau, sélectionnez l'interface réseau que vous souhaitez utiliser pour exécuter un test.
  5. Sous Analyse du réseau, cliquez sur Tests de connectivité, puis sur Créer.
  6. Saisissez un nom pour le test.
  7. Sélectionnez un protocole.
  8. Sélectionnez Interface réseau actuelle sous Source.
  9. Sous Destination, sélectionnez un type de ressource de service géré par Google dans le menu déroulant Point de terminaison de destination, tel que Cluster maître GKE.
    1. Utilisez le menu déroulant supplémentaire à droite pour sélectionner le point de terminaison spécifique. Par exemple, si vous avez sélectionné Cluster maître GKE, sélectionnez le cluster pour lequel vous souhaitez tester la connectivité au maître de cluster.
  10. Saisissez un port de destination pour la destination spécifiée.
  11. Cliquez sur Create (Créer).
  12. Une fois le test terminé, la page principale Tests de connectivité s'affiche. Elle contient une liste incluant ce test, ainsi que d'autres tests. Continuez vers Afficher les résultats du test.

gcloud

Pour effectuer le test d'une VM de votre réseau VPC vers un service géré par Google, saisissez la commande suivante. Remplacez les variables des options de commande conformément aux instructions suivantes :

  gcloud beta network-management connectivity-tests create NAME \
  --source-instance=SOURCE_INSTANCE \
  DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
  --destination-port=DESTINATION_PORT \
  --protocol=PROTOCOL

Remplacez les valeurs suivantes :

  • NAME : nom du test de connectivité.
  • SOURCE_INSTANCE : URI de la VM source (par exemple, projects/myproject/zones/us-east1-b/instances/instance-1).
  • DESTINATION_RESOURCE_FLAG : option indiquant le type de ressource de service géré par Google. Consultez la liste suivante pour connaître les options disponibles et la documentation de référence de gcloud beta network-management connectivity-tests create pour plus d'informations :
    • --destination-gke-master-cluster
    • --destination-cloud-sql-instance
  • DESTINATION_ENDPOINT : URI du point de terminaison de destination (par exemple, projects/myproject/locations/us-central1/clusters/cluster-1 pour l'option --destination-gke-master-cluster).
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

API

L'exemple suivant permet de tester la connectivité d'une VM de votre réseau VPC à un service géré par Google.

Utilisez la méthode networkmanagement.connectivitytests.create pour créer le test.

 POST https: //networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
     "instance": "SOURCE_INSTANCE",
   },
     "destination": {
     "DESTINATION_RESOURCE_FIELD": "DESTINATION_ENDPOINT",
     "port": DESTINATION_PORT
   },
     "protocol": "PROTOCOL",
   }'

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.
  • SOURCE_INSTANCE : URI de la VM source (par exemple, projects/myproject/zones/us-east1-b/instances/instance-1).
  • DESTINATION_RESOURCE_FIELD : champ indiquant le type de ressource de service géré par Google. Consultez la liste suivante pour connaître les options disponibles et la documentation de référence des points de terminaison pour plus d'informations :
    • gkeMasterCluster
    • cloudSqlInstance
  • DESTINATION_ENDPOINT : URI du point de terminaison de destination (par exemple, projects/myproject/locations/us-central1/clusters/cluster-1 pour le champ gkeMasterCluster).
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.

Python

L'exemple de code suivant crée un test entre une instance de VM et un point de terminaison de service géré par Google. Pour en savoir plus, consultez la section create dans la documentation de référence du client Python de l'API.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "DESTINATION_RESOURCE_FIELD":
          "DESTINATION_ENDPOINT",
      "port": "DESTINATION_PORT"
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • SOURCE_INSTANCE : URI de la VM source (par exemple, projects/myproject/zones/us-east1-b/instances/instance-1).
  • SOURCE_INSTANCE_PROJECT_ID : ID de projet de la VM source.
  • DESTINATION_RESOURCE_FIELD : champ indiquant le type de ressource de service géré par Google. Consultez la liste suivante pour connaître les options disponibles et la documentation de référence des points de terminaison pour plus d'informations :
    • gkeMasterCluster
    • cloudSqlInstance
  • DESTINATION_ENDPOINT : URI du point de terminaison de destination (par exemple, projects/myproject/locations/us-central1/clusters/cluster-1 pour le champ gkeMasterCluster).
  • DESTINATION_PORT : port du protocole IP de la destination. Cette option n'est valide que pour les protocoles TCP ou UDP. Le port par défaut est 80.
  • PROTOCOL : protocole compatible pour les tests de connectivité. Le protocole par défaut est TCP.
  • PROJECT_ID : ID du projet dans lequel vous créez le test.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Effectuer un test depuis un réseau VPC vers un réseau non-Google Cloud

Cette procédure est identique à la procédure de test entre des adresses IP privées dans un réseau VPC, sauf les étapes suivantes. Suivez cette procédure pour Cloud Console, l'outil de ligne de commande gcloud, les exemples d'API et les exemples Python.

  1. Spécifiez une adresse IP externe pour l'adresse IP de destination.
  2. Dans Cloud Console, désélectionnez la case Il s'agit d'une adresse IP utilisée dans Google Cloud.

Effectuer un test depuis un réseau non-Google Cloud vers un réseau VPC

Cette procédure est identique à la procédure de test entre des adresses IP privées dans un réseau VPC, sauf les étapes suivantes. Utilisez cette procédure pour Cloud Console, l'outil de ligne de commande gcloud, les exemples d'API et les exemples Python.

  1. Si l'adresse source ne se trouve pas dans Google Cloud, mais ne provient pas de votre réseau de pairs (sur site), spécifiez une adresse IP externe.
  2. Si l'adresse source provient de votre réseau de pairs (sur site), vous devez sélectionner Autre réseau non Google Cloud.

Effectuer un test depuis un réseau non-Google Cloud vers un réseau non-Google Cloud

Cette procédure est identique à la procédure de test entre des adresses IP privées dans un réseau VPC, sauf les étapes suivantes. Suivez cette procédure pour Cloud Console, l'outil de ligne de commande gcloud, les exemples d'API et les exemples Python.

  1. Spécifiez les adresses IP externes pour l'adresse IP source et l'adresse IP de destination.
  2. Dans Cloud Console, désélectionnez la case Il s'agit d'une adresse IP utilisée dans Google Cloud.

Afficher les résultats des tests

Cette section décrit comment afficher les résultats d'un test de connectivité.

Console

Vous pouvez afficher un test à partir de plusieurs pages différentes.

Depuis la page principale Tests de connectivité

  1. Dans Cloud Console, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Dans la colonne Résultats détaillés, sélectionnez un test, puis cliquez sur Afficher.
  3. Le panneau d'informations du test apparaît. Vous pouvez afficher le résultat global et les fiches de résultats pour chaque ressource Google Cloud dans le chemin de test. Vous pouvez cliquer sur un lien vers la page des détails de certaines ressources Google Cloud, telles que des instances ou des routes de VM. Si le test contient plusieurs traces, vous pouvez sélectionner une trace dans le menu déroulant Résultat des traces.
  4. Pour développer ou fermer une fiche de résultats, cliquez sur la flèche à droite de la fiche.
  5. Pour interpréter les résultats du test, consultez la documentation de référence sur les états de test.
  6. Pour fermer le panneau d'informations, en haut à droite de la page, cliquez sur Masquer le panneau d'informations.

Depuis la page d'informations Tests de connectivité

Vous pouvez également accéder à la page principale de Cloud Console et cliquer sur le nom d'un test, puis afficher ses résultats sur la page Informations sur le test de connectivité.

Depuis la page d'informations Interface réseau

Vous pouvez également afficher les résultats sur la page Informations sur l'interface réseau d'une interface réseau d'une instance de VM Compute Engine. Cette page répertorie uniquement les tests qui utilisent l'interface réseau actuelle comme source ou destination.

Pour afficher les résultats, vous pouvez sélectionner Afficher dans la colonne Résultats détaillés ou cliquer sur le nom du test.

gcloud

Pour afficher les résultats d'un test, entrez la commande suivante. Utilisez l'ID de test que vous souhaitez afficher.

  gcloud network-management connectivity-tests describe NAME

Remplacez NAME par le nom du test de connectivité.

API

Utilisez la méthode networkmanagement.connectivitytests.get pour afficher les résultats d'un test.

GET https://networkmanagement.googleapis.com/v1/{name=projects/PROJECT_ID/locations/global/connectivityTests/TEST_ID

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Python

L'exemple de code suivant imprime les résultats d'un test. Pour en savoir plus, consultez la section get dans la documentation de référence du client Python de l'API.

project_id = "PROJECT_ID"
test_id= "TEST_ID"
request = api.projects().locations().global_().connectivityTests().get(
      name='projects/%s/locations/global/connectivityTests/%s' %
      (project_id, test_id))
print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • PROJECT_ID : l'ID du projet dans lequel le test a été créé.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Réexécuter un ou plusieurs tests

Vous souhaiterez peut-être réexécuter un test de connectivité si vous apportez des modifications de configuration aux ressources Google Cloud dans le chemin de test et souhaitez afficher les résultats de la dernière configuration réseau. Vous pouvez réexécuter un ou plusieurs tests en même temps.

Un test de connectivité est basé sur un instantané de la configuration du réseau au moment de l'exécution. La réexécution d'un test écrase les résultats du test précédent. Si vous souhaitez conserver les anciens résultats, créez plutôt un nouveau test.

Console

Depuis la page principale Tests de connectivité

  1. Dans Cloud Console, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Cochez la case à gauche d'un ou des tests que vous souhaitez réexécuter.
  3. En haut de la page, cliquez sur Exécuter de nouveau (Rerun) .

Depuis la page d'informations Tests de connectivité

  1. Sur la page principale Tests de connectivité précédente, cliquez sur le nom d'un test.
  2. En haut de la page Informations sur le test de connectivité, cliquez sur Exécuter de nouveau (Rerun) .

Depuis la page d'informations Interface réseau

  1. Dans Cloud Console, accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Si ce n'est pas déjà fait, sélectionnez le projet contenant l'instance pour laquelle vous souhaitez réexécuter un test.
  3. Cliquez sur l'instance à utiliser pour réexécuter un test.
  4. Sous Interfaces réseau, sélectionnez l'interface réseau que vous souhaitez utiliser pour réexécuter un test.
  5. Sous Analyse du réseau, cliquez sur Tests de connectivité.
  6. Cochez la case à gauche d'un ou des tests que vous souhaitez réexécuter.
  7. En haut de la liste des tests, cliquez sur Exécuter de nouveau (Exécuter de nouveau) .

gcloud

Pour réexécuter un test de connectivité, saisissez la commande suivante. Utilisez l'ID de test que vous souhaitez réexécuter.

  gcloud network-management connectivity-tests rerun NAME

Remplacez NAME par le nom du test de connectivité.

API

Lorsque l'API Network Management crée une ressource connectivityTests, elle conserve cette ressource de test jusqu'à ce que vous la supprimiez. Pour cette raison, vous pouvez réexécuter les tests.

Si vous ne souhaitez pas créer de tests persistants, vous pouvez utiliser l'API pour créer un test et le supprimer après avoir affiché le résultat du test.

Utilisez la méthode networkmanagement.connectivitytests.rerun pour réexécuter un test.

  POST https://networkmanagement.googleapis.com/v1/{name=projects/*/locations/global/connectivityTests/*}:rerun
    {
      "name": {projects/PROJECT_ID/connectivityTests/{TEST_ID}
    }

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Python

L'exemple de code suivant réexécute un test. Pour en savoir plus, consultez rerun dans la documentation de référence du client Python de l'API.

project_id = "PROJECT_ID"
test_id = "TEST_ID"
request = api.projects().locations().global_().connectivityTests().rerun(name='projects/%s/locations/global/connectivityTests/%s' %       (project_id, test_id))
print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • PROJECT_ID : l'ID du projet dans lequel le test a été créé.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.

Étape suivante