Konnektivitätstests erstellen und ausführen

Erfahren Sie, wie Sie mit den Schritten auf dieser Seite Konnektivitätstests ausführen.

Informationen zum Bearbeiten oder Löschen eines oder mehrerer Tests finden Sie unter Tests aktualisieren oder löschen.

Weitere Informationen zu Konnektivitätstests finden Sie in der Übersicht.

Hinweise

Bevor Sie Konnektivitätstests verwenden können, müssen Sie folgende Elemente in Google Cloud einrichten:

  1. Rufen Sie in der Google Cloud Console die Seite für die Projektauswahl auf.

    Projektauswahl aufrufen

    Wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.

  2. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
  3. Installieren Sie das Google Cloud CLI, das Teil des Google Cloud CLI ist. Informationen zum Installieren der neuesten Version der gcloud CLI finden Sie in der gcloud CLI-Dokumentation.

    Eine Liste aller Befehle finden Sie in der gcloud-Befehlsreferenz.

  4. Aktivieren Sie die Network Management API. Durch die Aktivierung der API haben Sie folgende Möglichkeiten:

    • Beispiele für API-Aufrufe, die die Network Management API verwenden.

      Sie können die Network Management API-Befehle mit dem API Explorer testen. Verwenden Sie im Referenzdokument der Network Management API die Spalte Try this API, um API-Felder zu untersuchen und einen Test auszuführen.

    • Beispielcode, der den Python API-Client verwendet

      Der Beispielcode setzt voraus, dass Sie eine Ressource mit dem Namen api erstellt haben, um mit der Network Management API zu interagieren. Verwenden Sie zum Erstellen einer Ressource die Funktion build. Sehen Sie sich folgendes Beispiel an:

      from googleapiclient.discovery import build
      api = build('networkmanagement', 'v1')
      

      Weitere Informationen zum API-Python-Client finden Sie hier:

  5. Rufen Sie die Berechtigungen ab, die Sie zum Ausführen und Anzeigen von Tests benötigen. Weitere Informationen finden Sie unter Zugriff zuweisen.

Konnektivitätstests ausführen

Wenn Sie einen Konnektivitätstest ausführen, stellen Sie Testeingaben als 5-Tupel ohne den Quellport bereit.

In den folgenden Abschnitten erfahren Sie, wie Sie einen Test für Quell- und Zielendpunkte ausführen, der in Allgemeine Anwendungsfälle beschrieben ist.

Über die Google Cloud Console können Sie Konnektivitätstests mit einer der folgenden Methoden ausführen:

  • Die Seite Konnektivitätstests, die über das Menü Netzwerk > Network Intelligence Center verfügbar ist

  • Die Seite Details zur Netzwerkschnittstelle für eine Netzwerkschnittstelle einer Compute Engine-VM-Instanz. Wenn Sie diese Seite verwenden, müssen Sie die aktuelle Netzwerkschnittstelle als Quelle oder Ziel des Tests verwenden. Auf dieser Seite werden nur Tests aufgeführt, die für die aktuelle Netzwerkschnittstelle relevant sind.

Jeder von Ihnen erstellte Test wird unmittelbar nach dem Erstellen ausgeführt und in der Konnektivitätstests-Ressource gespeichert. Ein Test ist vorhanden, bis Sie ihn löschen.

Informationen zum Prüfen des Status eines Testvorgangs während dessen Ausführung finden Sie unter Laufenden Testvorgang prüfen. Einige Beispiele für Testvorgänge sind create und rerun.

Wenn Sie eine IP-Adresse für den Quell- oder Zielendpunkt verwenden, müssen Sie möglicherweise zusätzliche Felder angeben.

Best Practices

  • Wenn Sie einen Endpunkt (eine VM oder IP-Adresse) testen, der sich in einem gemeinsam genutzten VPC-Dienstprojekt befindet, ist es einfacher, den Test über das Dienstprojekt auszuführen. Dies liegt daran, dass Sie die VM- oder IP-Adresse aus dem Drop-down-Menü in der Google Cloud Console auswählen können.

    Sie müssen jedoch weiter das Hostprojekt vor dem VPC-Netzwerk (Virtual Private Cloud) angeben, da sich das Netzwerk im Hostprojekt befindet. Weitere Informationen finden Sie unter IP-Adressen in einem gemeinsam genutzten VPC-Netzwerk testen.

  • Wenn Sie einen Test zwischen Ihrem VPC-Netzwerk und Ihrem Peering- oder lokalen Netzwerk ausführen, kann es hilfreich sein, einen weiteren Konnektivitätstest durchzuführen. Verwenden Sie dazu die lokale IP-Adresse als Quelle und eine VM-Instanz oder die IP-Adresse in Ihrem VPC-Netzwerk als Ziel.

    Diese Art von Test prüft, ob Google Cloud erwartungsgemäß Routen für Ihr lokales Netzwerk bewirbt. Konnektivitätstests prüfen jedoch nicht, ob Ihr lokales Netzwerk diese Routen empfangen und implementiert hat.

  • Es dauert zwischen 20 und 120 Sekunden, bis die Verbindungstests ein Konfigurationsupdate erhalten und es in die Analyse einfließt. Wenn Sie einen Test sofort nach einer Konfigurationsänderung ausführen, werden möglicherweise nicht die erwarteten Ergebnisse angezeigt. Achten Sie auf ausreichend Wartezeit zwischen der Änderung der Konfiguration und der Ausführung der Tests.

    Diese Verzögerung gilt nicht für die Analyse der Live-Datenebene. Daher kann es zu einer vorübergehenden Abweichung zwischen den Ergebnissen der Analyse der Live-Datenebene und der Konfigurationsanalyse kommen. Wenn Sie beispielsweise eine Firewallregel hinzufügen, kann diese möglicherweise für die Analyse der Live-Datenebene erreichbar sein. Sie müssen jedoch möglicherweise etwas warten, bis die Firewallregel für die Konfigurationsanalyse erreichbar ist.

Tests zu oder von einer VM mit mehreren Netzwerkschnittstellen ausführen

In diesem Abschnitt wird beschrieben, wie Sie einen Test zu oder von einer nicht primären Netzwerkschnittstelle einer VM ausführen.

Console

Wenn Sie eine VM-Instanz mit mehreren Netzwerkschnittstellen als Quelle oder Ziel eines Tests angeben, werden Sie bei Konnektivitätstests aufgefordert, eine Netzwerkschnittstelle aus einer Liste auszuwählen.

Alternativ können Sie über die Seite Details zur Netzwerkschnittstelle einen Test für eine Netzwerkschnittstelle einer Compute Engine-VM-Instanz ausführen. Wenn Sie diese Seite verwenden, müssen Sie die aktuelle Netzwerkschnittstelle als Quelle oder Ziel des Tests verwenden.

gcloud und API

Sie müssen die Netzwerkschnittstelle, die für den Test verwendet werden soll, auf eine der folgenden Arten festlegen:

  • IP-Adresse und Netzwerk-URI
  • IP-Adresse und VM-URI
  • Netzwerk-URI und VM-URI

Wenn Sie nur den URI für eine VM mit mehreren Schnittstellen bereitstellen, wird nur die primäre Schnittstelle der VM ausgewählt.

Alle Tests für ein Projekt auflisten

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie oben auf der Seite im Drop-down-Menü für Projekte ein Projekt aus.
  3. Die Seite Konnektivitätstests wird aktualisiert und zeigt Ihnen die Tests für dieses Projekt.

gcloud

Geben Sie den folgenden gcloud-Befehl ein, um alle Tests eines Projekts aufzulisten. Dieser Befehl zeigt Tests im aktuell ausgewählten Projekt an.

  gcloud network-management connectivity-tests list

Geben Sie die PROJECT_ID an, um Tests in einem bestimmten Projekt aufzulisten.

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

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.list, um alle vorhandenen Tests eines Projekts aufzulisten.

GET https://networkmanagement.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/global}/connectivityTests
  • Ersetzen Sie PROJECT_ID durch die Projekt-ID des Projekts, das die Tests enthält, die Sie auflisten möchten.

Python

Der folgende Beispielcode listet alle vorhandenen Tests eines Projekts auf. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter list.

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))

Ersetzen Sie PROJECT_ID durch die Projekt-ID des Projekts, das die Tests enthält, die Sie auflisten möchten.

Zwischen VM-Instanzen in einem VPC-Netzwerk testen

Bei diesen Schritten wird davon ausgegangen, dass sich beide VM-Instanzen im selben Google Cloud-Projekt befinden.

Console

Auf der Hauptseite für Konnektivitätstests

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

    Die verbleibenden Schritte werden automatisch in der Google Cloud Console angezeigt.

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Quelle so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option VM-Instanz aus.
    2. Wählen Sie im Menü Quell-VM-Instanz die gewünschte Quell-VM-Instanz aus.
    3. Wählen Sie im Menü Quellnetzwerkschnittstelle die Netzwerkschnittstelle aus.

      Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, die den Quellstandort eindeutig identifiziert.

    4. Optional: Wählen Sie Quell-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.
  6. Führen Sie unter Ziel die folgenden Schritte aus:
    1. Wählen Sie im Menü Zielendpunkt die Option VM-Instanz aus.
    2. Wählen Sie im Menü Ziel-VM-Instanz die gewünschte Ziel-VM-Instanz aus.
    3. Wählen Sie im Menü Zielnetzwerkschnittstelle die Netzwerkschnittstelle aus.

      Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, um den Zielstandort eindeutig zu identifizieren.

    4. Optional: Wählen Sie Ziel-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Ziel-VM-Instanz.
  7. Hinweis: Bei einer Dual-Stack-Instanz müssen die Quell- und die Ziel-IP-Adresse vom gleichen Typ sein. Beispiel: Sie können von einer VM mit einer IPv4-Adresse aus keine VM mit einer IPv6-Adresse testen.

  8. Geben Sie im Feld Zielport einen Zielport ein.
  9. Klicken Sie auf Erstellen.
  10. Nachdem der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

Auf der Detailseite der Netzwerkschnittstelle

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Wählen Sie das Projekt mit der Instanz aus, die Sie testen möchten, falls noch nicht geschehen.
  3. Klicken Sie auf die Instanz, die Sie zum Testen verwenden möchten.
  4. Wählen Sie unter Netzwerkschnittstellen die Netzwerkschnittstelle aus, die Sie zum Ausführen eines Tests verwenden möchten.

    Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, um den Zielspeicherort eindeutig zu identifizieren.

  5. Klicken Sie unter Netzwerkanalyse auf Konnektivitätstest erstellen und gehen Sie so vor:

    1. Geben Sie im Feld Testname einen Namen für den Test ein.
    2. Wählen Sie in der Liste Protokoll ein Protokoll aus.
    3. Für Quelle können Sie entweder Aktuelle Netzwerkschnittstelle oder Andere auswählen.

      Wenn Sie Aktuelle Netzwerkschnittstelle auswählen, gehen Sie so vor:

      1. Wählen Sie im Menü Zielendpunkt die Option VM-Instanz aus.
      2. Wählen Sie im Menü Ziel-VM-Instanz die Instanz aus.
      3. Wählen Sie im Menü Zielnetzwerkschnittstelle die Netzwerkschnittstelle aus.
      4. Optional: Wählen Sie die Ziel-IP-Adresse aus. Die Standardeinstellung ist die IP-Adresse der Ziel-VM-Instanz.

      Wenn Sie Sonstiges auswählen, gehen Sie so vor:

      1. Wählen Sie im Menü Quellendpunkt die Option VM-Instanz aus.
      2. Wählen Sie im Menü Quell-VM-Instanz die Instanz aus.
      3. Wählen Sie im Menü Quellnetzwerkschnittstelle die Netzwerkschnittstelle aus.
      4. Optional: Wählen Sie die Quell-IP-Adresse aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.
    4. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

    5. Klicken Sie auf Erstellen.

  6. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-instance=SOURCE_INSTANCE \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --destination-instance=DESTINATION_INSTANCE \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Terraform

Sie können eine Terraform-Ressource verwenden, um einen Test zwischen zwei VM-Instanzen in einem VPC-Netzwerk zu erstellen.

resource "google_network_management_connectivity_test" "instance_test" {
  name = "conn-test-instances"
  source {
    instance = google_compute_instance.source.id
  }

  destination {
    instance = google_compute_instance.destination.id
    port     = "80"
  }

  protocol = "TCP"
}

resource "google_compute_instance" "source" {
  name         = "source-vm"
  machine_type = "e2-medium"

  boot_disk {
    initialize_params {
      image = data.google_compute_image.debian_9.id
    }
  }

  network_interface {
    network = "default"
    access_config {
    }
  }
}

resource "google_compute_instance" "destination" {
  name         = "dest-vm"
  machine_type = "e2-medium"

  boot_disk {
    initialize_params {
      image = data.google_compute_image.debian_9.id
    }
  }

  network_interface {
    network = "default"
    access_config {
    }
  }
}

data "google_compute_image" "debian_9" {
  family  = "debian-11"
  project = "debian-cloud"
}

API

Der folgende Beispieltest ermittelt, ob die vorhandene Netzwerkkonfiguration es der VM instance1 ermöglicht, die VM instance2 zu pingen.

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen zwei VM-Instanzen erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "instance":
          "DESTINATION_INSTANCE",
      "ipAddress":
          "DESTINATION_IP_ADDRESS",
      "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))

Ersetzen Sie Folgendes:

  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • SOURCE_INSTANCE_PROJECT_ID: die Projekt-ID der Quell-VM.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • DESTINATION_INSTANCE_PROJECT_ID: die Projekt-ID der Ziel-VM.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Zwischen privaten IP-Adressen in einem VPC-Netzwerk testen

In diesem Beispiel wird davon ausgegangen, dass beide IP-Adressen private IP-Adressen im selben Google Cloud-Projekt und im selben VPC-Netzwerk sind.

Wenn Sie zwischen Peered-VPC-Netzwerken testen, wählen Sie die Quell- und Zielnetzwerke für jeden Peer aus.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

    Die verbleibenden Schritte werden automatisch in der Google Cloud Console angezeigt.

  2. Wählen Sie Konnektivitätstest erstellen aus.

  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:

    1. Wählen Sie in der Liste Quellendpunkt die Option IP-Adresse aus.
    2. Geben Sie im Feld Quell-IP-Adresse die Quell-IP-Adresse ein.
    3. Wenn sich das VPC-Netzwerk der Quell-IP-Adresse im aktuellen Projekt befindet, entfernen Sie das Häkchen aus dem Kästchen Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.

      Wenn sich das VPC-Netzwerk in einem anderen Projekt befindet, wählen Sie im Feld Quell-IP-Adresse oder Dienstprojekt das Projekt aus, in dem sich das Netzwerk befindet.

      Wenn die IP-Adresse außerhalb des RFC 1918-Adressbereichs liegt, aktivieren Sie das Kästchen Ich bestätige, dass sich der Quellendpunkt in einem Bereich außerhalb des RFC 1918-Adressbereichs befindet. Wählen Sie dann in der Liste Quellnetzwerk das Netzwerk aus, das die Quell-IP-Adresse enthält.

  6. Gehen Sie für Ziel so vor:

    1. Wählen Sie in der Liste Zielendpunkt die Option IP-Adresse aus.
    2. Geben Sie im Feld Ziel-IP-Adresse die Ziel-IP-Adresse ein.
    3. Wenn sich das VPC-Netzwerk der Ziel-IP-Adresse im aktuellen Projekt befindet, entfernen Sie das Häkchen aus dem Kästchen Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.

      Wenn sich das VPC-Netzwerk in einem anderen Projekt befindet, wählen Sie im Feld Ziel-IP-Adresse oder Dienstprojekt das Projekt aus, in dem sich das Netzwerk befindet.

      Wenn die IP-Adresse außerhalb des RFC 1918-Adressbereichs liegt, aktivieren Sie das Kästchen Ich bestätige, dass sich der Zielendpunkt in einem Bereich außerhalb des RFC 1918-Adressbereichs befindet. Wählen Sie dann in der Liste Zielnetzwerk das Netzwerk aus, das die Ziel-IP-Adresse enthält.

  7. Geben Sie in das Feld Zielport eine gültige Zielportnummer ein. Die Zahl muss zwischen 0 und 65.535 (jeweils einschließlich) liegen.
  8. Klicken Sie auf Erstellen.

Nachdem der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Ersetzen Sie Variablen für die Befehlsoptionen durch Werte aus Ihrem VPC-Netzwerk.

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 \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK: der URI für das VPC-Netzwerk, in dem sich die Quell-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_NETWORK: der URI für das VPC-Netzwerk, in dem sich die Ziel-IP-Adresse befindet, z. B. projects/myproject/global/networks/network-a.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle. Der Standardwert ist Port 80.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Wenn das Netzwerk unbekannt ist oder Sie keine Berechtigung zum Zugriff auf das Netzwerk haben, können Sie das Netzwerk als GCP_NETWORK angeben, anstatt einen Netzwerk-URI anzugeben.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand der Quell- und Ziel-IP-Adressen ausgewählt.

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK_TYPE: der Typ des Netzwerks, in dem sich die Quelle befindet. Verwenden Sie in diesem Fall den Wert GCP_NETWORK.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle. Der Standardwert ist Port 80.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Wenn Sie eine Quell-IP-Adresse angeben, die eine externe IP-Adresse außerhalb von Google Cloud ist, müssen Sie als networkType NON_GCP_NETWORK angeben. Ersetzen Sie die Werte im folgenden Befehl durch Werte aus Ihrem VPC-Netzwerk.

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK_TYPE: der Typ des Netzwerks, in dem sich die Quelle befindet. Verwenden Sie in diesem Fall den Wert NON_GCP_NETWORK.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_NETWORK: ein URI für das VPC-Netzwerk, in dem sich die Ziel-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Terraform

Sie können eine Terraform-Ressource verwenden, um einen Test zwischen zwei IP-Adressen in einem VPC-Netzwerk zu erstellen.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand der Quell- und Ziel-IP-Adressen ausgewählt.

resource "google_network_management_connectivity_test" "default" {
  name = "conn-test-addr"
  source {
    ip_address   = google_compute_address.source_addr.address
    project_id   = google_compute_address.source_addr.project
    network      = google_compute_network.default.id
    network_type = "GCP_NETWORK"
  }

  destination {
    ip_address = google_compute_address.dest_addr.address
    project_id = google_compute_address.dest_addr.project
    network    = google_compute_network.default.id
    port       = "80"
  }

  protocol = "UDP"
}

resource "google_compute_network" "default" {
  name                    = "connectivity-vpc"
  auto_create_subnetworks = false
}

resource "google_compute_subnetwork" "default" {
  name          = "connectivity-vpc-subnet"
  ip_cidr_range = "10.0.0.0/8"
  region        = "us-central1"
  network       = google_compute_network.default.id
}

resource "google_compute_firewall" "default" {
  name    = "allow-incoming-all"
  network = google_compute_network.default.name

  allow {
    protocol = "all"
  }

  source_ranges = ["0.0.0.0/0"]
}

resource "google_compute_address" "source_addr" {
  name         = "src-addr"
  subnetwork   = google_compute_subnetwork.default.id
  address_type = "INTERNAL"
  address      = "10.0.0.42"
  region       = "us-central1"
}

resource "google_compute_address" "dest_addr" {
  name         = "dest-addr"
  subnetwork   = google_compute_subnetwork.default.id
  address_type = "INTERNAL"
  address      = "10.0.0.43"
  region       = "us-central1"
}

resource "google_compute_instance" "source" {
  name         = "source-vm1"
  machine_type = "e2-medium"
  zone         = "us-central1-a"

  boot_disk {
    initialize_params {
      image = data.google_compute_image.default.id
    }
  }

  network_interface {
    network    = google_compute_network.default.id
    subnetwork = google_compute_subnetwork.default.id
    network_ip = "10.0.0.42"
    access_config {
    }
  }
}

resource "google_compute_instance" "destination" {
  name         = "dest-vm1"
  machine_type = "e2-medium"
  zone         = "us-central1-a"

  boot_disk {
    initialize_params {
      image = data.google_compute_image.default.id
    }
  }

  network_interface {
    network    = google_compute_network.default.id
    subnetwork = google_compute_subnetwork.default.id
    network_ip = "10.0.0.43"
    access_config {
    }
  }
}

data "google_compute_image" "default" {
  family  = "debian-11"
  project = "debian-cloud"
}

API

In diesem Beispiel wird die Fähigkeit getestet, von der Quell-IP-Adresse zur Ziel-IP-Adresse zu pingen.

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

  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".
  }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK: der URI für das VPC-Netzwerk, in dem sich die Quell-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_NETWORK: ein URI für das VPC-Netzwerk, in dem sich die Ziel-IP-Adresse befindet, z. B. projects/myproject/global/networks/network-a.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Wenn das VPC-Netzwerk unbekannt ist oder Sie keine Berechtigung zum Zugriff auf das Netzwerk haben, können Sie das Netzwerk als GCP_NETWORK angeben, anstatt einen Netzwerk-URI anzugeben.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand der Quell- und Ziel-IP-Adressen ausgewählt.

  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": "DESTINATION_INSTANCE",
      "ipAddress": "DESTINATION_IP_ADDRESS"
    },
    "protocol": "PROTOCOL"
  }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK_TYPE: der Typ des Netzwerks, in dem sich die Quelle befindet. Verwenden Sie in diesem Fall den Wert GCP_NETWORK.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Wenn Sie eine Quell-IP-Adresse angeben, die eine externe IP-Adresse außerhalb von Google Cloud ist, müssen Sie als networkType NON_GCP_NETWORK angeben. Ersetzen Sie die Werte im folgenden Befehl durch Werte für Ihr Google Cloud-Netzwerk.

  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

Mit dem folgenden Beispielcode wird ein Test zwischen zwei IP-Adressen erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

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))

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_IP_PROJECT_ID: die Projekt-ID für die Quell-IP-Adresse.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • DESTINATION_IP_PROJECT_ID: die Projekt-ID für die Ziel-IP-Adresse.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Wenn das VPC-Netzwerk unbekannt ist oder Sie keine Berechtigung zum Zugriff auf das Netzwerk haben, können Sie das Netzwerk als GCP_NETWORK angeben, anstatt einen Netzwerk-URI anzugeben.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand der Quell- und Ziel-IP-Adressen ausgewählt.

Mit dem folgenden Beispiel wird ein Test zwischen zwei IP-Adressen erstellt.

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))

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK_TYPE: Der Typ des Netzwerks, in dem sich die Quelle befindet. Verwenden Sie in diesem Fall den Wert GCP_NETWORK.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • DESTINATION_IP_PROJECT_ID: die Projekt-ID für die Ziel-IP-Adresse.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Wenn Sie eine Quell-IP-Adresse angeben, die eine externe IP-Adresse außerhalb von Google Cloud ist, müssen Sie als networkType NON_GCP_NETWORK angeben.

IP-Adressen in einem gemeinsam genutzten VPC-Netzwerk testen

Wenn Sie ein freigegebenes VPC-Netzwerk haben, können Sie einen Test über das Hostprojekt oder das Serviceprojekt erstellen und ausführen.

Das folgende Beispiel zeigt beide Fälle und verwendet eine im Serviceprojekt zugewiesene Ziel-IP-Adresse. Die Feldwerte in der Google Cloud Console unterscheiden sich jeweils geringfügig. Die Befehlsoptionen für die Google Cloud-Befehlszeile und für API-Aufrufe sind jedoch identisch.

Console: vom Host

  1. Rufen Sie in der Google Cloud Console aus dem Hostprojekt die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option IP-Adresse aus.
    2. Geben Sie die Quell-IP-Adresse ein.
    3. Klicken Sie auf das Kästchen Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.
    4. Wenn es sich um eine interne IP-Adresse handelt, auf die nicht über das Internet zugegriffen werden kann, wählen Sie das VPC-Netzwerk aus, in dem sich die Adresse befindet.
    5. Wenn sich Ihre private IP-Adresse außerhalb des RFC 1918-Adressbereichs befindet, wählen Sie Ich bestätige, dass sich der Quellendpunkt in einem Bereich außerhalb des RFC 1918-Adressbereichs befindet und dann das Zielnetzwerk aus, das die IP-Adresse enthält.
  6. Führen Sie unter Ziel die folgenden Schritte aus:
    1. Wählen Sie im Menü Zielendpunkt die Option IP-Adresse aus.
    2. Geben Sie die Ziel-IP-Adresse ein.
    3. Klicken Sie auf das Kästchen Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.
    4. Wenn es sich um eine interne IP-Adresse handelt, auf die nicht über das Internet zugegriffen werden kann, wählen Sie das VPC-Netzwerk aus, in dem sich die Adresse befindet.
    5. Wenn sich Ihre private IP-Adresse außerhalb des RFC 1918-Adressbereichs befindet, wählen Sie Ich bestätige, dass sich der Quellendpunkt in einem Bereich außerhalb des RFC 1918-Adressbereichs befindet und dann das Zielnetzwerk aus, das die IP-Adresse enthält.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

Console: vom Dienst

  1. Rufen Sie in der Google Cloud Console aus dem Dienstprojekt die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option IP-Adresse aus.
    2. Geben Sie die Quell-IP-Adresse ein.
    3. Klicken Sie auf das Kästchen Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.
    4. Wenn es sich um eine interne IP-Adresse handelt, auf die nicht über das Internet zugegriffen werden kann, wählen Sie das VPC-Netzwerk aus, in dem sich die Adresse befindet.
  6. Führen Sie unter Ziel die folgenden Schritte aus:
    1. Wählen Sie im Menü Zielendpunkt die Option IP-Adresse aus.
    2. Geben Sie die Ziel-IP-Adresse ein.
    3. Klicken Sie auf das Kästchen Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.
    4. Geben Sie die Ziel-IP-Adresse oder das Dienstprojekt an, in dem sich die IP-Adresse befindet.
    5. Wenn Ihre private IP-Adresse außerhalb des RFC 1918-Adressbereichs liegt, klicken Sie auf das Kästchen Ich bestätige, dass sich der Quellendpunkt in einem Bereich außerhalb des RFC 1918-Adressbereichs befindet. Wählen Sie dann das Zielnetzwerk aus, das die IP-Adresse enthält.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Geben Sie den folgenden Befehl ein, um zwischen zwei privaten IP-Adressen in einem Host und in einem Serviceprojekt zu testen, in dem sich die Ziel-IP-Adresse im Serviceprojekt befindet. Ersetzen Sie Variablen für die Befehlsoptionen durch Werte aus Ihrem VPC-Netzwerk.

Da sich die Ziel-IP-Adresse im Serviceprojekt befindet, geben Sie das Serviceprojekt und den Netzwerk-URI des Hostprojekts an. In diesem Fall steht default für das Standard-VPC-Netzwerk für 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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_PROJECT: die Projekt-ID des Quellendpunkts.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, zu der Sie im Dienstprojekt testen.
  • DESTINATION_NETWORK: ein URI für das VPC-Netzwerk für das Hostprojekt, z. B. projects/host-project/global/networks/default.
  • DESTINATION_PROJECT: die Projekt-ID des Zielendpunkts, z. B. ein Projekt namens service-project, das das für dieses freigegebene VPC-Netzwerk verwendete Dienstprojekt darstellt.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

  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",
    }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_PROJECT: die Projekt-ID des Quellendpunkts.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, zu der Sie im Dienstprojekt testen.
  • DESTINATION_PROJECT: die Projekt-ID des Zielendpunkts, z. B. ein Projekt namens service-project, das das für dieses freigegebene VPC-Netzwerk verwendete Dienstprojekt darstellt.
  • DESTINATION_NETWORK: ein URI für das VPC-Netzwerk für das Hostprojekt, z. B. projects/host-project/global/networks/default.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen zwei IP-Adressen erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

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))

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_IP_PROJECT_ID: die Projekt-ID des Quellendpunkts.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, zu der Sie im Dienstprojekt testen.
  • DESTINATION_IP_PROJECT_ID: die Projekt-ID des Zielendpunkts, z. B. ein Projekt namens service-project, das das für dieses freigegebene VPC-Netzwerk verwendete Dienstprojekt darstellt.
  • DESTINATION_NETWORK: ein URI für das VPC-Netzwerk für das Hostprojekt, z. B. projects/host-project/global/networks/default.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Von einer VM zu einem von Google verwalteten Dienst testen

In diesem Abschnitt wird beschrieben, wie Sie von einer VM in Ihrem VPC-Netzwerk zu einem Dienst testen können, der in einem VPC-Netzwerk von Google ausgeführt wird. Beispielsweise können Sie die Schritte in diesem Abschnitt ausführen, um die Konnektivität zu einer Cloud SQL-Instanz oder der Steuerungsebene eines GKE-Cluster zu testen. Sie können auch einen Test ausführen, indem Sie einen von Google verwalteten Dienstendpunkt als Quelle und einen Endpunkt in Ihrem VPC-Netzwerk als Ziel verwenden.

Konnektivitätstests versuchen standardmäßig, einen Test mithilfe der privaten IP-Adresse des Endpunkts des von Google verwalteten Dienstes auszuführen. Wenn der Endpunkt keine private IP-Adresse hat, wird bei Konnektivitätstests die öffentliche IP-Adresse verwendet. Konnektivitätstests analysieren, ob das Paket den Endpunkt erreichen kann. Dazu gehört auch die Analyse der Konfiguration innerhalb des Google-VPC-Netzwerks. Wenn in Ihrem Projekt Konfigurationsprobleme erkannt werden, wird die Analyse angehalten, bevor die Google-Netzwerkkonfiguration analysiert wird.

Informationen zum Testen der Konnektivität von einer VM zu einem von Google verwalteten Dienst finden Sie in der folgenden Anleitung.

Console

Auf der Hauptseite für Konnektivitätstests

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:

    1. Wählen Sie im Menü Quellendpunkt die Option VM-Instanz aus.
    2. Wählen Sie im Menü Quell-VM-Instanz die gewünschte Quell-VM-Instanz aus.
    3. Wählen Sie im Menü Quellnetzwerkschnittstelle die Netzwerkschnittstelle aus.

      Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, die den Quellspeicherort eindeutig identifiziert.

    4. Optional: Wählen Sie Quell-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.

  6. Gehen Sie für Ziel so vor:

    1. Wählen Sie im Menü Zielendpunkt einen Typ der von Google verwalteten Dienstressource aus, z. B. Steuerungsebene des GKE-Clusters.
    2. Wählen Sie im Menü Steuerungsebene des GKE-Cluster-Zielclusters den Cluster aus, für den Sie die Verbindung zur GKE-Steuerungsebene testen möchten.
    3. Optional: Wählen Sie die IP-Adresse der Steuerungsebene des GKE-Cluster aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

  8. Klicken Sie auf Erstellen.

  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

Auf der Detailseite der Netzwerkschnittstelle

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Wählen Sie das Projekt mit der Instanz aus, die Sie testen möchten, falls noch nicht geschehen.
  3. Klicken Sie auf die Instanz, die Sie zum Testen verwenden möchten.
  4. Wählen Sie unter Netzwerkschnittstellen die Netzwerkschnittstelle aus, die Sie zum Ausführen eines Tests verwenden möchten.
  5. Klicken Sie unter Netzwerkanalyse auf Konnektivitätstest erstellen.
  6. Geben Sie im Feld Testname einen Namen für den Test ein.
  7. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  8. Wählen Sie für Quelle die Option Aktuelle Netzwerkschnittstelle aus.
  9. Führen Sie unter Ziel die folgenden Schritte aus:
    1. Wählen Sie im Menü Zielendpunkt einen Typ der von Google verwalteten Dienstressource aus, z. B. Steuerungsebene des GKE-Clusters.
    2. Wählen Sie im Menü Steuerungsebene des GKE-Cluster-Zielclusters den Cluster aus, für den Sie die Verbindung zur GKE-Steuerungsebene testen möchten.
    3. Optional: Wählen Sie die IP-Adresse der Steuerungsebene des GKE-Cluster aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.
  10. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
    1. Klicken Sie auf Erstellen.
    2. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Ersetzen Sie die Variablen für die Befehlsoptionen gemäß der folgenden Anleitung:

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_RESOURCE_FLAG: Das Flag, das den Typ der von Google verwalteten Dienstressource angibt.

    Hier finden Sie Informationen zu verfügbaren Optionen:

    • --destination-gke-master-cluster
    • --destination-cloud-sql-instance

    Weitere Informationen finden Sie in der Referenz zu gcloud network-management connectivity-tests create.

  • DESTINATION_ENDPOINT: der URI für den Zielendpunkt, z. B. projects/myproject/locations/us-central1/clusters/cluster-1 für das Flag --destination-gke-master-cluster.

  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.

  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_RESOURCE_FIELD: das Feld, das den Typ der von Google verwalteten Dienstressource angibt.

    Hier finden Sie Informationen zu verfügbaren Optionen:

    • gkeMasterCluster
    • cloudSqlInstance

    Weitere Informationen finden Sie in der Endpunktreferenz.

  • DESTINATION_ENDPOINT: der URI für den Zielendpunkt, z. B. projects/myproject/locations/us-central1/clusters/cluster-1 für das Feld gkeMasterCluster.

  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.

  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen einer VM-Instanz und dem Endpunkt eines von Google verwalteten Diensts erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "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))

Ersetzen Sie Folgendes:

  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • SOURCE_INSTANCE_PROJECT_ID: die Projekt-ID der Quell-VM.
  • DESTINATION_RESOURCE_FIELD: das Feld, das den Typ der von Google verwalteten Dienstressource angibt.

    Hier finden Sie Informationen zu verfügbaren Optionen:

    • gkeMasterCluster
    • cloudSqlInstance

    Weitere Informationen finden Sie in der Endpunktreferenz.

  • DESTINATION_ENDPOINT: der URI für den Zielendpunkt, z. B. projects/myproject/locations/us-central1/clusters/cluster-1 für das Feld gkeMasterCluster.

  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.

  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.

  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Von einer VM zu Private Service Connect-Endpunkten testen

In diesem Abschnitt wird beschrieben, wie Sie von einer VM zu einem Private Service Connect-Endpunkt testen.

Sie können beispielsweise den Schritten in diesem Abschnitt folgen, um zu testen, ob ein Paket an einen veröffentlichten Dienst übertragen werden kann, der Private Service Connect verwendet. Konnektivitätstests analysieren, ob ein Paket den Endpunkt erreichen kann. Dazu gehören die Analyse verbundener Endpunkte, veröffentlichter Dienste und der Proxyverbindung. Die Analyse wird vorzeitig beendet, wenn die Verbindung zu einem veröffentlichten Dienst, der Private Service Connect verwendet, nicht akzeptiert wird.

Sie können die Verbindung zu Folgendem testen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:

    1. Wählen Sie im Menü Quellendpunkt die Option VM-Instanz aus.
    2. Wählen Sie im Menü Quell-VM-Instanz die gewünschte Quell-VM-Instanz aus.
    3. Wählen Sie im Menü Quellnetzwerkschnittstelle die Netzwerkschnittstelle aus.

      Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, die den Quellspeicherort eindeutig identifiziert.

    4. Optional: Wählen Sie Quell-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.

  6. Gehen Sie für Ziel so vor:

    1. Wählen Sie im Menü Zielendpunkt die Option PSC-Endpunkt aus.
    2. Wählen Sie im Menü Ziel-PSC-Endpunkt den PSC-Endpunkt aus.

      Wenn sich der Zielendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, wählen Sie Endpunkt befindet sich in einem anderen Projekt als „PROJECT_NAME aus. Wählen Sie dann im Feld Zielendpunktprojekt das Projekt aus, in dem sich der Endpunkt befindet.

  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

  8. Klicken Sie auf Erstellen.

  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_IP_ADDRESS: die IP-Adresse des Endpunkts oder Back-Ends, das Sie testen möchten.
  • DESTINATION_NETWORK: ein URI für das VPC-Netzwerk, in dem sich die Ziel-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Wenn der Endpunkt oder das Back-End für den Zugriff auf veröffentlichte Dienste verwendet wird, müssen Sie die DESTINATION_NETWORK angeben, da der Endpunkt oder das Back-End eine interne IP-Adresse hat.

API

Im folgenden Beispieltest wird ermittelt, ob die vorhandene Netzwerkkonfiguration es der VM instance1 ermöglicht, die IP-Adresse des Private Service Connect-Endpunkts zu pingen.

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_IP_ADDRESS: die IP-Adresse des Endpunkts oder Back-Ends, das Sie testen möchten.
  • DESTINATION_NETWORK: ein URI für das VPC-Netzwerk, in dem sich die Ziel-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Wenn der Endpunkt oder das Back-End für den Zugriff auf veröffentlichte Dienste verwendet wird, müssen Sie die DESTINATION_NETWORK angeben, da der Endpunkt oder das Back-End eine interne IP-Adresse hat.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen einer VM-Instanz und einem Private Service Connect-Endpunkt erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "forwardingRule": "DESTINATION_FORWARDING_RULE",
      "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))

Ersetzen Sie Folgendes:

  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • SOURCE_INSTANCE_PROJECT_ID: die Projekt-ID der Quell-VM.
  • DESTINATION_IP_ADDRESS: die IP-Adresse des Endpunkts oder Back-Ends, das Sie testen möchten.
  • DESTINATION_NETWORK: ein URI für das VPC-Netzwerk, in dem sich die Ziel-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Wenn der Endpunkt oder das Back-End für den Zugriff auf veröffentlichte Dienste verwendet wird, müssen Sie die DESTINATION_NETWORK angeben, da der Endpunkt oder das Back-End eine interne IP-Adresse hat.

Von einer App Engine-Standardumgebungsversion an ein Ziel testen

In diesem Abschnitt wird beschrieben, wie Sie die Konnektivität von einer App Engine-Standardumgebung zu einer VM-Instanz, einer IP-Adresse oder einem von Google verwalteten Dienst testen.

Eine Anwendung in der App Engine-Standardumgebung besteht aus einer einzelnen Anwendungsressource, die aus einem oder mehreren Diensten besteht. Innerhalb jedes Dienstes stellen Sie Versionen dieses Dienstes bereit. Sie können die Erreichbarkeit von einer Version eines Dienstes in der App Engine-Standardumgebung zu einer VM-Instanz, einer IP-Adresse oder einem von Google verwalteten Dienst testen.

Um eine detaillierte Konfigurationsanalyse zu erhalten, müssen Sie Ihren Dienst für die Verwendung eines Connectors für serverlosen VPC-Zugriff konfigurieren. Das Ergebnis eines Konnektivitätstests kann für jede Version des Dienstes unterschiedlich sein. Sie können die Erreichbarkeit nur für Testpakete testen, die das UDP- oder TCP-Protokoll verwenden.

Konnektivität von einer Version eines Dienstes der App Engine-Standardumgebung zu einer VM-Instanz testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie einen Namen für den Test ein.
  4. Wählen Sie ein Protokoll aus.
  5. Wählen Sie im Menü Quellendpunkt die Option App Engine aus.
    1. Wählen Sie im Menü App Engine-Dienst den spezifischen Dienst der App Engine-Standardumgebung aus, von dem aus Sie die Konnektivität testen möchten. Wählen Sie beispielsweise helloworld-service aus.
      1. Wenn sich der Quellendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, klicken Sie das Kästchen Endpunkt befindet sich in einem anderen Projekt als PROJECT_NAME an.
      2. Wählen Sie ein Projekt aus, in dem der Endpunkt vorhanden ist.
    2. Wählen Sie im Menü App Engine-Version eine Version des App Engine-Standardumgebungsdienstes aus, von dem aus Sie die Verbindung testen möchten.
  6. Wählen Sie für Ziel eine Ziel-VM-Instanz aus der Liste aus.

    Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, um den Zielspeicherort eindeutig zu identifizieren.

  7. Optional: Wählen Sie Ziel-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Ziel-VM-Instanz.

  8. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

  9. Klicken Sie auf Erstellen.

  10. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-app-engine-version=APP_ENGINE_VERSION \
    --destination-instance=DESTINATION_INSTANCE \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • APP_ENGINE_VERSION: Der URI für die Quellversion der App Engine-Standardumgebung, z. B. apps/myproject/services/service-name/versions/version-name.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-Cloud Functions-Funktion.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • APP_ENGINE_VERSION: Der URI für die Quellversion der App Engine-Standardumgebung, z. B. apps/myproject/services/service-name/versions/version-name.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

Konnektivität von einer Version eines Dienstes der App Engine-Standardumgebung zu einer IP-Adresse testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie einen Namen für den Test ein.
  4. Wählen Sie ein Protokoll aus.
  5. Wählen Sie im Menü Quellendpunkt eine App Engine aus.
    1. Wählen Sie im Menü App Engine-Dienst den spezifischen Dienst der App Engine-Standardumgebung aus, von dem aus Sie die Konnektivität testen möchten. Wählen Sie beispielsweise helloworld-service aus.
      1. Wenn sich der Quellendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, wählen Sie Endpunkt befindet sich in einem anderen Projekt als „PROJECT_NAME aus.
      2. Wählen Sie ein Projekt aus, in dem der Endpunkt vorhanden ist.
    2. Wählen Sie im Menü App Engine-Version eine Version des App Engine-Standardumgebungsdienstes aus, von dem aus Sie die Verbindung testen möchten.
  6. Wählen Sie für Ziel die Option IP-Adresse aus und geben Sie eine IP-Adresse ein.
  7. Geben Sie einen Zielport ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-app-engine-version=APP_ENGINE_VERSION \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • APP_ENGINE_VERSION: Der URI für die Quellversion der App Engine-Standardumgebung, z. B. apps/myproject/services/service-name/versions/version-name.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

  POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "appEngineVersion": {
        "uri": "APP_ENGINE_VERSION",
        },
    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
    },
    "protocol": "PROTOCOL",
  }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-Cloud Functions-Funktion.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • APP_ENGINE_VERSION: Der URI für die Quellversion der App Engine-Standardumgebung, z. B. apps/myproject/services/service-name/versions/version-name.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

Verbindung von einer Version eines Dienstes der App Engine-Standardumgebung zu einem von Google verwalteten Dienst testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie einen Namen für den Test ein.
  4. Wählen Sie ein Protokoll aus.
  5. Wählen Sie im Menü Quellendpunkt eine App Engine aus.
    1. Wählen Sie im Menü App Engine-Dienst den spezifischen Dienst der App Engine-Standardumgebung aus, von dem aus Sie die Konnektivität testen möchten. Wählen Sie beispielsweise helloworld-service aus.
      1. Wenn sich der Quellendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, wählen Sie Endpunkt befindet sich in einem anderen Projekt als „PROJECT_NAME aus.
      2. Wählen Sie ein Projekt aus, in dem der Endpunkt vorhanden ist.
    2. Wählen Sie im Menü App Engine-Version eine Version des App Engine-Standardumgebungsdienstes aus, von dem aus Sie die Verbindung testen möchten.
  6. Führen Sie unter Ziel die folgenden Schritte aus:
    1. Wählen Sie im Menü Zielendpunkt einen Typ der von Google verwalteten Dienstressource aus, z. B. Steuerungsebene des GKE-Clusters.
    2. Wählen Sie im Menü Steuerungsebene des GKE-Cluster-Zielclusters den Cluster aus, für den Sie die Verbindung zur GKE-Steuerungsebene testen möchten.
    3. Optional: Wählen Sie in der Liste die IP-Adresse der Steuerungsebene des GKE-Cluster-Zielclusters aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-app-engine-version=APP_ENGINE_VERSION \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
      DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • APP_ENGINE_VERSION: Der URI für die Quellversion der App Engine-Standardumgebung, z. B. apps/myproject/services/servicename/versions/version-number.
  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_RESOURCE_FLAG: Das Flag, das den Typ der von Google verwalteten Dienstressource angibt.

    Hier finden Sie Informationen zu verfügbaren Optionen:

    • --destination-gke-master-cluster
    • --destination-cloud-sql-instance

    Weitere Informationen finden Sie in der Referenz zu gcloud network-management connectivity-tests create.

  • DESTINATION_ENDPOINT: der URI für den Zielendpunkt, z. B. projects/myproject/locations/us-central1/clusters/cluster-1 für das Flag --destination-gke-master-cluster.

  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle. Der Standardwert ist Port 80.

  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

  POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "appEngineVersion": {
        "uri": "APP_ENGINE_VERSION",
        },
    },
    "destination": {
      "DESTINATION_RESOURCE_FIELD": "DESTINATION_ENDPOINT",
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": DESTINATION_PORT,
    },
    "protocol": "PROTOCOL",
  }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-Cloud Functions-Funktion.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • APP_ENGINE_VERSION: Der URI für die Quellversion der App Engine-Standardumgebung, z. B. apps/myproject/services/servicename/versions/version-number.
  • DESTINATION_RESOURCE_FIELD: das Feld, das den Typ der von Google verwalteten Dienstressource angibt.

    Hier finden Sie Informationen zu verfügbaren Optionen:

    • gkeMasterCluster
    • cloudSqlInstance

    Weitere Informationen finden Sie in der Endpunktreferenz.

  • DESTINATION_ENDPOINT: der URI für den Zielendpunkt, z. B. projects/myproject/locations/us-central1/clusters/cluster-1 für das Feld gkeMasterCluster.

  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.

  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle. Der Standardwert ist Port 80.

  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Von einer Cloud Functions-Funktion an ein Ziel testen

In diesem Abschnitt wird beschrieben, wie Sie die Konnektivität von einer Cloud Function, die in einer bestimmten Google Cloud-Region bereitgestellt wird, zu einer VM-Instanz, einer IP-Adresse oder einem von Google verwalteten Dienst testen. Sie können beispielsweise die Schritte in diesem Abschnitt ausführen, um die Konnektivität von einer Cloud Functions-Funktion, die in us-central1 als Quelle bereitgestellt wird, zu einem Endpunkt in Ihrem VPC-Netzwerk als Ziel zu testen.

Wenn Sie eine detaillierte Konfigurationsanalyse erhalten möchten, müssen Sie dafür sorgen, dass Ihre Cloud Function aktiv ist und Sie für sie einen Connector für Cloud Function VPC-Zugriff konfiguriert haben.

Einstellungen für ausgehenden Traffic für Cloud Functions steuern das Routing ausgehender HTTP-Anfragen von einer Cloud Function und steuern die Traffictypen, die über den Connector an Ihr VPC-Netzwerk weitergeleitet werden. Weitere Informationen finden Sie unter Einstellungen für ausgehenden Cloud Functions-Traffic.

Konnektivität von einer Cloud Functions-Funktion zu einer VM-Instanz testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option Cloud Functions 1st gen aus.
    2. Wählen Sie im Menü Cloud Functions die spezifische Cloud Functions-Funktion aus, von der Sie die Konnektivität testen möchten. Wählen Sie beispielsweise function-1 aus.
    3. Wählen Sie im Standortmenü der Cloud Functions-Funktion die Google Cloud-Region aus, in der Sie die Cloud Functions-Funktion bereitgestellt haben. Sie können Cloud Functions in mehreren Regionen mit unterschiedlichen Konfigurationen, aber demselben Namen bereitstellen.
  6. Gehen Sie für Ziel so vor:

    1. Wählen Sie im Menü Zielendpunkt die Option VM-Instanz aus.
    2. Wählen Sie im Menü Ziel-VM-Instanz eine VM-Instanz aus.
    3. Wählen Sie im Menü Zielnetzwerkschnittstelle die Netzwerkschnittstelle aus.

      Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, die den Zielstandort eindeutig identifiziert.

    4. Optional: Wählen Sie Ziel-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Ziel-VM-Instanz.

  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

  8. Klicken Sie auf Erstellen.

  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-function=SOURCE_CLOUD_FUNCTION \
    --destination-instance=DESTINATION_INSTANCE \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_CLOUD_FUNCTION: der URI der Cloud Functions-Funktion, z. B. projects/myproject/locations/us-central1/functions/function-1.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-Cloud Functions-Funktion.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_CLOUD_FUNCTION: der URI der Cloud Functions-Funktion, z. B. projects/myproject/locations/us-central1/functions/function-1.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Konnektivität von einer Cloud Functions-Funktion zu einer IP-Adresse testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option Cloud Functions 1st gen aus.
    2. Wählen Sie im Menü Cloud Functions die spezifische Cloud Functions-Funktion aus, von der Sie die Konnektivität testen möchten. Wählen Sie beispielsweise function-1 aus.
    3. Wählen Sie im Standortmenü der Cloud Functions-Funktion die Google Cloud-Region aus, in der Sie die Cloud Functions-Funktion bereitgestellt haben. Sie können Cloud Functions in mehreren Regionen mit unterschiedlichen Konfigurationen, aber demselben Namen bereitstellen.
  6. Wählen Sie für Ziel die Option IP-Adresse aus und geben Sie eine IP-Adresse ein.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie weiter unten auf dieser Seite mit dem Abschnitt Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-function=SOURCE_CLOUD_FUNCTION \
    --destination-ip-address==DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_CLOUD_FUNCTION: der URI der Cloud Functions-Funktion, z. B. projects/myproject/locations/us-central1/functions/function-1.
  • DESTINATION_IP_ADDRESS: die Ziel-IP-Adresse, die Sie testen möchten.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
{
  "source": {
    "cloudFunction": {
      "uri": "SOURCE_CLOUD_FUNCTION",
    },
  },
  "destination": {
    "ipAddress": "DESTINATION_IP_ADDRESS",
  },
  "protocol": "PROTOCOL",
}'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-Cloud Functions-Funktion.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_CLOUD_FUNCTION: der URI der Cloud Functions-Funktion, z. B. projects/myproject/locations/us-central1/functions/function-1.
  • DESTINATION_IP_ADDRESS: die Ziel-IP-Adresse, die Sie testen möchten.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Konnektivität von einer Cloud Function zu einem von Google verwalteten Dienst testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option Cloud Functions 1st gen aus.
    2. Wählen Sie im Menü Cloud Functions die spezifische Cloud Functions-Funktion aus, von der Sie die Konnektivität testen möchten. Wählen Sie beispielsweise function-1 aus.
    3. Wählen Sie im Menü Cloud Functions-Standort die Google Cloud-Region aus, in der Sie die Cloud Functions-Funktion bereitgestellt haben. Sie können Cloud Functions in mehreren Regionen mit unterschiedlichen Konfigurationen, aber demselben Namen bereitstellen.
  6. Führen Sie unter Ziel die folgenden Schritte aus:
    1. Wählen Sie im Menü Zielendpunkt einen Typ einer von Google verwalteten Dienstressource aus, z. B. Cloud SQL-Instanz.
    2. Wählen Sie im Menü Cloud SQL-Zielinstanz die Cloud SQL-Instanz aus, von der aus Sie die Verbindung testen möchten.
    3. Optional: Wählen Sie in der Liste die IP-Adresse der Cloud SQL-Zielinstanz aus. Der Standardwert ist die IP-Adresse der Cloud Function-Quellfunktion.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie weiter unten auf dieser Seite mit dem Abschnitt Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-function=SOURCE_CLOUD_FUNCTION \
      DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_CLOUD_FUNCTION: Der URI der Cloud Functions-Funktion, z. B. projects/myproject/locations/us-central1/functions/function-1.
  • DESTINATION_RESOURCE_FLAG: Das Flag, das den Typ der von Google verwalteten Dienstressource angibt.

    Hier finden Sie Informationen zu verfügbaren Optionen:

    • --destination-gke-master-cluster
    • --destination-cloud-sql-instance

    Weitere Informationen finden Sie in der Referenz zu gcloud network-management connectivity-tests create.

  • DESTINATION_ENDPOINT: der URI für den Zielendpunkt, z. B. projects/myproject/locations/us-central1/clusters/cluster-1 für das Flag --destination-gke-master-cluster.

  • DESTINATION_IP_ADDRESS: die interne oder externe Ziel-IP-Adresse, die Sie testen möchten.

  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle. Der Standardwert ist Port 80.

  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Von einer Cloud Run-Version an ein Ziel testen

In diesem Abschnitt wird beschrieben, wie Sie die Konnektivität von einer Cloud Run-Version zu einer VM-Instanz, einer IP-Adresse oder einem von Google verwalteten Dienst testen.

Sie können mehrere Cloud Run-Dienste in einem einzelnen Projekt bereitstellen. Jeder Cloud Run-Dienst hat einen HTTPS-Endpunkt auf einer eindeutigen Subdomain der Domain *.run.app. Bei jeder Bereitstellung des Cloud Run-Dienstes wird eine neue unveränderliche Version erstellt. Sie können die Erreichbarkeit von einer Version zu einer VM-Instanz, einer IP-Adresse oder einem von Google verwalteten Dienst testen. Um eine detaillierte Konfigurationsanalyse zu erhalten, müssen Sie einen Connector für serverlosen VPC-Zugriff für Ihre Überarbeitung konfigurieren. Die Ergebnisse des Konnektivitätstests können für jede Überarbeitung unterschiedlich sein.

Für einen Cloud Run-Dienst namens cloud_run_test wurde beispielsweise die Überarbeitungs-first-revision-Version für die Verwendung eines Connectors für Serverloser VPC-Zugriff und eine andere Überarbeitungs-second-revision, die nicht für die Verwendung eines Connectors für Serverloser VPC-Zugriff konfiguriert ist, konfiguriert. Das Gesamtergebnis zur Erreichbarkeit ist möglicherweise für first-revision erreichbar, für second-revision jedoch nicht.

Wenn Sie einen Konnektivitätstest erstellen, können Sie aus einer Liste von Versionen für einen Cloud Run-Dienst eine Auswahl treffen.

Verbindung von einer Version eines Cloud Run-Dienstes zu einer VM-Instanz testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie einen Namen für den Test ein.
  4. Wählen Sie ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option Cloud Run aus.
    2. Wählen Sie im Menü Cloud Run-Dienst den spezifischen Cloud Run-Dienst aus, von dem aus Sie die Konnektivität testen möchten. Wählen Sie beispielsweise helloworld-run aus.
      1. Wenn sich der Quellendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, wählen Sie Endpunkt befindet sich in einem anderen Projekt als „PROJECT_NAME aus.
      2. Wählen Sie ein Projekt aus, in dem der Endpunkt vorhanden ist.
    3. Wählen Sie im Menü Cloud Run-Version eine Cloud Run-Version aus, von der Sie testen möchten.
  6. Gehen Sie für Ziel so vor:

    1. Wählen Sie im Menü Zielendpunkt die Option VM-Instanz aus.
    2. Wählen Sie im Menü Ziel-VM-Instanz die gewünschte Ziel-VM-Instanz aus.
    3. Wählen Sie im Menü Zielnetzwerkschnittstelle die Netzwerkschnittstelle aus.

      Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, um den Zielspeicherort eindeutig zu identifizieren.

    4. Optional: Wählen Sie Ziel-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Ziel-VM-Instanz.

  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

  8. Klicken Sie auf Erstellen.

  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-run-revision=CLOUD_RUN_REVISION \
    --destination-instance=DESTINATION_INSTANCE \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • CLOUD_RUN_REVISION: Der URI für die Cloud Run-Quellversion, z. B. projects/myproject/locations/us-central1/revisions/cloudrun-revision.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-Cloud Functions-Funktion.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • CLOUD_RUN_REVISION: Der URI für die Cloud Run-Quellversion, z. B. projects/myproject/locations/us-central1/revisions/cloudrun-revision.
  • DESTINATION_INSTANCE: der URI für die Ziel-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-2.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM-Instanz, die Sie testen möchten. Die IP-Adresse sollte eine der IP-Adressen der Ziel-VM-Instanz sein.
  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

Verbindung von einer Version eines Cloud Run-Dienstes zu einer IP-Adresse testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie einen Namen für den Test ein.
  4. Wählen Sie ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option Cloud Run aus.
    2. Wählen Sie im Menü Cloud Run-Dienst den spezifischen Cloud Run-Dienst aus, von dem aus Sie die Konnektivität testen möchten. Wählen Sie beispielsweise helloworld-run aus.
      1. Wenn sich der Quellendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, wählen Sie Endpunkt befindet sich in einem anderen Projekt als „PROJECT_NAME aus.
      2. Wählen Sie ein Projekt aus, in dem der Endpunkt vorhanden ist.
    3. Wählen Sie im Menü Cloud Run-Version eine Cloud Run-Version aus, von der Sie testen möchten.
  6. Wählen Sie für Ziel die Option IP-Adresse aus und geben Sie eine IP-Adresse ein.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-run-revision=CLOUD_RUN_REVISION \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • CLOUD_RUN_REVISION: Der URI für die Cloud Run-Quellversion, z. B. projects/myproject/locations/us-central1/revisions/cloudrun-revision.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
{
  "source": {
    "cloudRunRevision": {
      "uri": "CLOUD_RUN_REVISION",
      },
  },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      },
    "protocol": "PROTOCOL",
  }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-Cloud Functions-Funktion.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • CLOUD_RUN_REVISION: Der URI für die Cloud Run-Quellversion, z. B. projects/myproject/locations/us-central1/revisions/cloudrun-revision.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

Verbindung von einer Version eines Cloud Run-Dienstes zu einem von Google verwalteten Dienst testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie einen Namen für den Test ein.
  4. Wählen Sie ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option Cloud Run aus.
    2. Wählen Sie im Menü Cloud Run-Dienst den spezifischen Cloud Run-Dienst aus, von dem aus Sie die Konnektivität testen möchten. Wählen Sie beispielsweise helloworld-run aus.
      1. Wenn sich der Quellendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, wählen Sie Endpunkt befindet sich in einem anderen Projekt als „PROJECT_NAME aus.
      2. Wählen Sie ein Projekt aus, in dem der Endpunkt vorhanden ist.
    3. Wählen Sie im Menü Cloud Run-Version eine Cloud Run-Version aus, von der Sie testen möchten.
  6. Führen Sie unter Ziel die folgenden Schritte aus:
    1. Wählen Sie im Menü Zielendpunkt einen Typ der von Google verwalteten Dienstressource aus, z. B. Steuerungsebene des GKE-Clusters.
    2. Wählen Sie im Menü Steuerungsebene des GKE-Cluster-Zielclusters den Cluster aus, für den Sie die Verbindung zur GKE-Steuerungsebene testen möchten.
    3. Optional: Wählen Sie in der Liste die IP-Adresse der Steuerungsebene des GKE-Cluster-Zielclusters aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-run-revision=CLOUD_RUN_REVISION \
      DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • CLOUD_RUN_REVISION: Der URI für die Cloud Run-Quellversion, z. B. projects/myproject/locations/us-central1/revisions/cloudrun-revision.
  • PROJECT_NAME: der Name des Projekts, in dem sich der Endpunkt befindet, z. B. myproject.
  • DESTINATION_RESOURCE_FLAG: Das Flag, das den Typ der von Google verwalteten Dienstressource angibt.

    Hier finden Sie Informationen zu verfügbaren Optionen:

    • --destination-gke-master-cluster
    • --destination-cloud-sql-instance

    Weitere Informationen finden Sie in der Referenz zu gcloud network-management connectivity-tests create.

  • DESTINATION_ENDPOINT: der URI für den Zielendpunkt, z. B. projects/myproject/locations/us-central1/clusters/cluster-1 für das Flag --destination-gke-master-cluster.

  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle. Der Standardwert ist Port 80.

  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-Cloud Functions-Funktion.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • CLOUD_RUN_REVISION: Der URI für die Cloud Run-Quellversion, z. B. projects/myproject/locations/us-central1/revisions/cloudrun-revision.
  • DESTINATION_RESOURCE_FIELD: das Feld, das den Typ der von Google verwalteten Dienstressource angibt.

    Hier finden Sie Informationen zu verfügbaren Optionen:

    • gkeMasterCluster
    • cloudSqlInstance

    Weitere Informationen finden Sie in der Endpunktreferenz.

  • DESTINATION_ENDPOINT: der URI für den Zielendpunkt, z. B. projects/myproject/locations/us-central1/clusters/cluster-1 für das Feld gkeMasterCluster.

  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle. Der Standardwert ist Port 80.

  • PROTOCOL: die Netzwerkprotokolle, die von den Connectors für Serverloser VPC-Zugriff unterstützt werden (TCP oder UDP).

Aus einem VPC-Netzwerk in ein Nicht-Google Cloud-Netzwerk testen

Führen Sie die folgenden Schritte aus, um einen Test von einem VPC-Netzwerk zu einem Nicht-Google Cloud-Netzwerk durchzuführen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Wählen Sie für Quelle die Option IP-Adresse aus und geben Sie eine IP-Adresse ein.
    1. Wenn sich das VPC-Netzwerk in einem anderen Projekt befindet, wählen Sie Dies ist eine IP-Adresse, die in Google Cloud verwendet wird aus. Wählen Sie dann im Feld Quell-IP-Adresse oder Dienstprojekt das Projekt aus, in dem sich das Netzwerk befindet.
    2. Wenn sich Ihre private IP-Adresse außerhalb des RFC 1918-Adressbereichs befindet, klicken Sie das Kästchen Ich bestätige, dass sich der Quellendpunkt in einem Bereich außerhalb des RFC 1918-Adressbereichs befindet an. Wählen Sie danach das Quellnetzwerk aus, das die IP-Adresse enthält.
  6. Wählen Sie für Ziel die Option IP-Adresse aus und geben Sie eine externe IP-Adresse ein.
  7. Deaktivieren Sie die Option Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.
  8. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  9. Klicken Sie auf Erstellen.
  10. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Geben Sie den folgenden Befehl ein, um zwischen einer internen und einer externen IP-Adresse zu testen. Ersetzen Sie Variablen für die Befehlsoptionen durch Werte aus Ihrem VPC-Netzwerk.

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK: der URI für das VPC-Netzwerk, in dem sich die Quell-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand der Quell- und Ziel-IP-Adressen ausgewählt.

API

In diesem Beispiel wird die Fähigkeit getestet, von der Quell-IP-Adresse zur Ziel-IP-Adresse zu pingen.

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

  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",
      "port": "DESTINATION_PORT",
    },
      "protocol": "PROTOCOL".
  }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK: der URI für das VPC-Netzwerk, in dem sich die Quell-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen zwei IP-Adressen erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "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))

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_IP_PROJECT_ID: die Projekt-ID für die Quell-IP-Adresse.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand der Quell- und Ziel-IP-Adressen ausgewählt.

Mit dem folgenden Beispiel wird ein Test zwischen zwei IP-Adressen erstellt.

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "GCP_NETWORK"
    },
    "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "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))

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK_TYPE: Der Typ des Netzwerks, in dem sich die Quelle befindet. Verwenden Sie in diesem Fall den Wert GCP_NETWORK.
  • DESTINATION_IP_ADDRESS: die IP-Adresse des Ziels
  • DESTINATION_PORT: die Nummer des Ziel-TCP- oder UDP-Ports. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Von einem VPC-Spoke mit einem anderen VPC-Spoke testen, der mit demselben Network Connectivity Center-Hub verbunden ist

Führen Sie die folgenden Schritte aus, um von einem VPC-Spoke in einem Network Connectivity Center-Hub zu einem anderen VPC-Spoke zu testen, der mit demselben Hub verbunden ist.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Wählen Sie für Quelle die Option IP-Adresse aus und geben Sie dann die IP-Adresse aus dem Quell-Spoke-VPC-Netzwerk ein.
  6. Wählen Sie für Ziel die Option IP-Adresse aus und geben Sie dann die IP-Adresse in einem anderen Spoke-VPC-Netzwerk ein, in dem Sie testen möchten.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.
  8. Klicken Sie auf Erstellen.
  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Geben Sie den folgenden Befehl ein, um zwischen zwei Spokes zu testen. Ersetzen Sie Variablen für die Befehlsoptionen durch Werte aus Ihrem VPC-Netzwerk.

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK: der URI für das VPC-Netzwerk, in dem sich die Quell-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_IP_ADDRESS: die Ziel-IP-Adresse in einem anderen Spoke-VPC-Netzwerk, in dem Sie testen.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand der Quell- und Ziel-IP-Adressen ausgewählt.

API

In diesem Beispiel wird die Fähigkeit getestet, von der Quell-IP-Adresse zur Ziel-IP-Adresse zu pingen.

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

  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",
      "port": "DESTINATION_PORT",
    },
      "protocol": "PROTOCOL".
  }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK: der URI für das VPC-Netzwerk, in dem sich die Quell-IP-Adresse befindet, z. B. projects/myproject/global/networks/default.
  • DESTINATION_IP_ADDRESS: die Ziel-IP-Adresse in einem anderen Spoke-VPC-Netzwerk, in dem Sie testen.
  • DESTINATION_PORT: die Nummer des Ziel-TCP- oder UDP-Ports. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen zwei IP-Adressen erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter der Methode create.

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "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))

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_IP_PROJECT_ID: die Projekt-ID für die Quell-IP-Adresse
  • DESTINATION_IP_ADDRESS: die Ziel-IP-Adresse in einem anderen Spoke-VPC-Netzwerk, in dem Sie testen.
  • DESTINATION_PORT: die Nummer des Ziel-TCP- oder UDP-Ports. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand der Quell- und Ziel-IP-Adressen ausgewählt.

Mit dem folgenden Beispiel wird ein Test zwischen zwei IP-Adressen erstellt.

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "GCP_NETWORK"
    },
    "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "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))

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK_TYPE: Der Typ des Netzwerks, in dem sich die Quelle befindet. Verwenden Sie in diesem Fall den Wert GCP_NETWORK.
  • DESTINATION_IP_ADDRESS: die IP-Adresse der Ziel-VM.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Aus einer VM zu einem Nicht-Google Cloud-Netzwerk testen

Dieser Test analysiert die Konnektivität von der Quell-VM zu einem Edge-Standort des Google-Netzwerks.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:

    1. Wählen Sie im Menü Quellendpunkt die Option VM-Instanz aus.
    2. Wählen Sie im Menü Quell-VM-Instanz die gewünschte Quell-VM-Instanz aus.
    3. Wählen Sie im Menü Quellnetzwerkschnittstelle die Netzwerkschnittstelle aus.

      Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, die den Quellspeicherort eindeutig identifiziert.

    4. Optional: Wählen Sie Quell-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.

  6. Gehen Sie für Ziel so vor:

    1. Wählen Sie im Menü Zielendpunkt die Option IP-Adresse aus.
    2. Geben Sie eine externe Ziel-IP-Adresse ein.
    3. Deaktivieren Sie die Option Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.
  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

  8. Klicken Sie auf Erstellen.

  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Geben Sie den folgenden Befehl ein, um zwischen einer VM und einer externen IP-Adresse zu testen. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

API

Der folgende Beispieltest ermittelt, ob die vorhandene Netzwerkkonfiguration es der VM instance1 ermöglicht, die Ziel-IP-Adresse zu pingen.

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen einer VM-Instanz und einer externen IP-Adresse erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "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))

Ersetzen Sie Folgendes:

  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • SOURCE_INSTANCE_PROJECT_ID: die Projekt-ID der Quell-VM.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Von einer VM oder IP-Adresse zu einem Load-Balancer testen

In diesem Abschnitt wird beschrieben, wie Sie die Verbindung von einer VM oder IP-Adresse zu einem Google Cloud-Load-Balancer testen.

Die Konfigurationsanalyse der Konnektivitätstests unterstützt das Tracing simulierter Pakete für alle Arten von Google Cloud-Load-Balancern. Der Trace-Pfad für einen externen Application Load Balancer gilt auch für externe Proxy-Network Load Balancer. Weitere Informationen finden Sie in der Übersicht über Cloud Load Balancing.

Sie können die Verbindung zu Folgendem testen:

Von einer VM zu einem Load-Balancer testen

In diesem Abschnitt wird die Verbindung von der Quell-VM zu einem Load-Balancer analysiert.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:

    1. Wählen Sie im Menü Quellendpunkt die Option VM-Instanz aus.
    2. Wählen Sie im Menü Quell-VM-Instanz die gewünschte Quell-VM-Instanz aus.
    3. Wählen Sie im Menü Quellnetzwerkschnittstelle die Netzwerkschnittstelle aus.

      Wenn die VM-Instanz mehrere Netzwerkschnittstellen hat, wählen Sie eine VM-Netzwerkschnittstelle aus, die den Quellspeicherort eindeutig identifiziert.

    4. Optional: Wählen Sie Quell-IP-Adresse aus der Liste aus. Die Standardeinstellung ist die IP-Adresse der Quell-VM-Instanz.

  6. Gehen Sie für Ziel so vor:

    1. Wählen Sie im Menü Zielendpunkt die Option Load-Balancer aus.
    2. Wählen Sie im Menü Ziel-Load-Balancer den Load-Balancer aus.

      Wenn sich der Zielendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, wählen Sie Endpunkt befindet sich in einem anderen Projekt als „PROJECT_NAME aus. Wählen Sie dann im Feld Zielendpunktprojekt das Projekt aus, in dem sich der Endpunkt befindet.

    3. Wählen Sie die Zielweiterleitungsregel aus.

  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

  8. Klicken Sie auf Erstellen.

  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Geben Sie den folgenden Befehl ein, um zwischen einer VM und einem Load-Balancer zu testen.

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.
  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • DESTINATION_FORWARDING_RULE: die Zielweiterleitungsregel, die den Endpunkt darstellt.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen einer VM-Instanz und einem Load-Balancer-Endpunkt erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "forwardingRule": "DESTINATION_FORWARDING_RULE",
      "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))

Ersetzen Sie Folgendes:

  • SOURCE_INSTANCE: der URI für die Quell-VM, z. B. projects/myproject/zones/us-east1-b/instances/instance-1.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • SOURCE_INSTANCE_PROJECT_ID: die Projekt-ID der Quell-VM.
  • DESTINATION_FORWARDING_RULE: die Zielweiterleitungsregel, die den Endpunkt darstellt.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Von einer IP-Adresse zu einem Load-Balancer testen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie Konnektivitätstest erstellen aus.
  3. Geben Sie im Feld Testname einen Namen für den Test ein.
  4. Wählen Sie in der Liste Protokoll ein Protokoll aus.
  5. Gehen Sie für Source (Quelle) so vor:
    1. Wählen Sie im Menü Quellendpunkt die Option IP-Adresse aus.
    2. Geben Sie im Feld Quell-IP-Adresse die Quell-IP-Adresse ein.
      1. Wenn sich das VPC-Netzwerk in einem anderen Projekt befindet, wählen Sie Dies ist eine IP-Adresse, die in Google Cloud verwendet wird aus. Wählen Sie dann im Feld Quell-IP-Adresse oder Dienstprojekt das Projekt aus, in dem sich das Netzwerk befindet.
      2. Wenn die IP-Adresse außerhalb des RFC 1918-Adressbereichs liegt, wählen Sie Ich bestätige, dass sich der Quellendpunkt in einem Bereich außerhalb des RFC 1918-Adressbereichs befindet aus. Wählen Sie dann in der Liste Quellnetzwerk das Netzwerk aus, das die Quell-IP-Adresse enthält.
  6. Gehen Sie für Ziel so vor:

    1. Wählen Sie im Menü Zielendpunkt die Option Load-Balancer aus.
    2. Wählen Sie im Menü Ziel-Load-Balancer den Load-Balancer-Endpunkt aus.

      Wenn sich der Zielendpunkt in einem anderen Projekt als dem aktuellen Projekt befindet, wählen Sie Endpunkt befindet sich in einem anderen Projekt als „PROJECT_NAME aus. Wählen Sie dann im Feld Zielendpunktprojekt das Projekt aus, in dem sich der Endpunkt befindet.

    3. Wählen Sie die Zielweiterleitungsregel aus.

  7. Geben Sie im Feld Zielport einen Zielport für das angegebene Ziel ein.

  8. Klicken Sie auf Erstellen.

  9. Wenn der Test abgeschlossen ist, wird die Hauptseite für Konnektivitätstests geladen und eine Liste mit diesem Test und anderen Tests angezeigt. Fahren Sie mit Testergebnisse ansehen fort.

gcloud

Führen Sie den Befehl gcloud network-management connectivity-tests create aus. Ersetzen Sie die Beispielwerte durch Werte aus Ihrem VPC-Netzwerk.

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

Ersetzen Sie Folgendes:

  • NAME: der Name des Konnektivitätstests.
  • SOURCE_PROJECT: die Projekt-ID des Quellendpunkts.
  • SOURCE_IP_ADDRESS: die IP-Adresse der Quell-VM-Instanz, von der aus Sie testen. Die IP-Adresse sollte eine der IP-Adressen der Quell-VM-Instanz sein.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • DESTINATION_IP_ADDRESS: die externe Ziel-IP-Adresse, die Sie testen möchten.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.

Wenn der Endpunkt für den Zugriff auf verwaltete Dienste oder Dienste in einem anderen VPC-Netzwerk verwendet wird, müssen Sie die DESTINATION_NETWORK angeben, da der Endpunkt eine interne IP-Adresse hat.

API

In diesem Beispiel wird die Möglichkeit getestet, von der Quell-IP-Adresse einen Ping an einen Load-Balancer-Endpunkt zu senden.

Verwenden Sie die Methode projects.locations.global.connectivityTests.create.

Wenn Sie eine Quell-IP-Adresse angeben, die eine externe IP-Adresse außerhalb von Google Cloud ist, müssen Sie als networkType NON_GCP_NETWORK angeben. Ersetzen Sie die Werte im folgenden Befehl durch Werte für Ihr Google Cloud-Netzwerk.

  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": {
      "forwardingRule": "DESTINATION_FORWARDING_RULE",
      "port": "DESTINATION_PORT",
    },
    "protocol": "PROTOCOL",
  }'

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • DESTINATION_FORWARDING_RULE: die Zielweiterleitungsregel, die den Endpunkt darstellt.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.

Wenn der Endpunkt für den Zugriff auf veröffentlichte Dienste verwendet wird, müssen Sie die DESTINATION_NETWORK angeben, da der Endpunkt eine interne IP-Adresse hat.

Python

Mit dem folgenden Beispielcode wird ein Test zwischen einer IP-Adresse und einem Load-Balancer-Endpunkt erstellt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter create.

Wenn Sie eine Quell-IP-Adresse angeben, die eine externe IP-Adresse außerhalb von Google Cloud ist, müssen Sie als networkType NON_GCP_NETWORK angeben.

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "NON_GCP_NETWORK"
    },
    "destination": {
        "forwardingRule": "DESTINATION_FORWARDING_RULE",
        "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))

Ersetzen Sie Folgendes:

  • SOURCE_IP_ADDRESS: die Quell-IP-Adresse, von der aus Sie testen.
  • SOURCE_NETWORK_TYPE: Der Typ des Netzwerks, in dem sich die Quelle befindet. Verwenden Sie in diesem Fall den Wert NON_GCP_NETWORK.
  • DESTINATION_FORWARDING_RULE: die Zielweiterleitungsregel, die den Endpunkt darstellt.
  • DESTINATION_PORT: der IP-Protokollport des Ziels. Diese Option gilt nur für TCP- oder UDP-Protokolle.
  • DESTINATION_IP_PROJECT_ID: die Projekt-ID für die Ziel-IP-Adresse.
  • PROTOCOL: ein unterstütztes Protokoll für Konnektivitätstests Das Standardprotokoll ist TCP.
  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie den Test erstellen.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Wenn der Endpunkt für den Zugriff auf veröffentlichte Dienste verwendet wird, müssen Sie die DESTINATION_NETWORK angeben, da der Endpunkt eine interne IP-Adresse hat.

Sie müssen nicht prüfen, ob sich Ihre IP-Adresse in Google Cloud befindet oder ob sich die Quell- und Zielendpunkte oder -endpunkte außerhalb des RFC 1918-Adressbereichs befinden. Diese Parameter werden automatisch anhand Ihrer Quell- und Ziel-IP-Adressen ausgewählt.

Aus einem Nicht-Google Cloud-Netzwerk zu einem VPC-Netzwerk testen

Dieses Verfahren ist mit dem Verfahren Zwischen privaten IP-Adressen in einem VPC-Netzwerk testen mit Ausnahme der folgenden Schritte identisch. Verwenden Sie dieses Verfahren für die Google Cloud Console, die Google Cloud CLI, API-Beispiele und Python-Beispiele.

  1. Wenn sich die Quelladresse nicht in Google Cloud befindet, aber nicht aus Ihrem Peering-Netzwerk (lokal) stammt, geben Sie eine externe IP-Adresse an.
  2. Wenn die Quelladresse aus Ihrem Peering-Netzwerk (lokal) stammt, müssen Sie Anderes nicht-Google Cloud-Netzwerk auswählen.

Aus einem Nicht-Google Cloud-Netzwerk zu einem Nicht-Google Cloud-Netzwerk testen

Dieses Verfahren ist mit dem Verfahren Zwischen privaten IP-Adressen in einem VPC-Netzwerk testen mit Ausnahme der folgenden Schritte identisch. Verwenden Sie dieses Verfahren für die Google Cloud Console, die Google Cloud CLI, API-Beispiele und Python-Beispiele.

  1. Geben Sie externe IP-Adressen für die Quell- und Ziel-IP-Adresse an.
  2. Deaktivieren Sie in der Google Cloud Console die Option Dies ist eine IP-Adresse, die in Google Cloud verwendet wird.

Testergebnisse ansehen

In diesem Abschnitt wird beschrieben, wie Sie die Ergebnisse eines Konnektivitätstests ansehen.

Console

Sie können einen Test von verschiedenen Seiten ausführen.

Auf der Hauptseite für Konnektivitätstests

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie in der Spalte Ergebnisdetails einen Test aus und klicken Sie dann auf Anzeigen.
  3. Das Infofeld für den Test wird angezeigt. Sie können das Gesamtergebnis und die Ergebniskarten für jede Google Cloud-Ressource im Testpfad ansehen. Sie können auf einen Link zur Detailseite für einige Google Cloud-Ressourcen klicken, z. B. zu VM-Instanzen oder Routen. Wenn der Test mehrere Traces enthält, können Sie ein Trace aus der Liste Trace-Ergebnis auswählen.

    Wenn der Test für die Analyse der Live-Datenebene berechtigt ist, können Sie Messwerte zu Paketverlust und Latenz aufrufen.

  4. Klicken Sie zum Maximieren oder Schließen einer Ergebniskarte auf den Pfeil rechts neben der Karte.

  5. Informationen zum Interpretieren der Testergebnisse finden Sie unter Konfigurationsanalysestatus.

  6. Zum Schließen des Infofelds klicken Sie oben rechts auf der Seite auf Infofeld ausblenden.

Auf der Detailseite des Konnektivitätstests

Klicken Sie alternativ auf der Hauptseite der Google Cloud Console auf den Namen eines Tests und sehen Sie sich die Ergebnisse auf der Seite Details zum Konnektivitätstest an.

Auf der Detailseite der Netzwerkschnittstelle

Sie können sich die Ergebnisse auch auf der Seite Details zur Netzwerkschnittstelle ansehen, um die Netzwerkschnittstelle einer Compute Engine-VM-Instanz aufzurufen. Auf dieser Seite werden nur Tests aufgeführt, bei denen die aktuelle Netzwerkschnittstelle als Quelle oder Ziel verwendet wird.

Zum Aufrufen der Ergebnisse können Sie in der Spalte Ergebnisdetails die Option Anzeigen auswählen oder auf den Namen des Tests klicken.

gcloud

Geben Sie den folgenden Befehl ein, um die Ergebnisse eines Tests anzusehen. Verwenden Sie die Test-ID, die Sie ansehen möchten.

gcloud network-management connectivity-tests describe NAME

Ersetzen Sie NAME durch den Namen des Konnektivitätstests.

API

Verwenden Sie die Methode projects.locations.global.connectivityTests.get, um die Ergebnisse eines Tests anzusehen.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Python

Der folgende Beispielcode gibt die Ergebnisse eines Tests aus. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter get.

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))

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Projekts, in dem der Test erstellt wurde.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Einen oder mehrere Tests noch einmal ausführen

Möglicherweise möchten Sie einen Konnektivitätstest noch einmal ausführen, wenn Sie Konfigurationsänderungen an den Google Cloud-Ressourcen im Testpfad vornehmen und Ergebnisse für die neueste Netzwerkkonfiguration ansehen möchten. Sie können einen oder mehrere Tests gleichzeitig wiederholen.

Ein Konnektivitätstest basiert auf einem Snapshot der Netzwerkkonfiguration bei der Ausführung. Durch wiederholtes Ausführen eines Tests werden die vorherigen Testergebnisse überschrieben. Wenn Sie ältere Ergebnisse beibehalten möchten, erstellen Sie stattdessen einen neuen Test.

Wie Sie den Status des laufenden Testvorgangs rerun überprüfen können, erfahren Sie unter Laufenden Testvorgang prüfen.

Console

Auf der Hauptseite für Konnektivitätstests

  1. Rufen Sie in der Google Cloud Console die Seite Konnektivitätstests auf.

    Zu Konnektivitätstests

  2. Wählen Sie einen oder mehrere Tests aus der Liste der verfügbaren Konnektivitätstests aus.
  3. Klicken Sie auf Erneut ausführen.

Über die Detailseite der Konnektivitätstests

  1. Klicken Sie auf der vorherigen Hauptseite für Konnektivitätstests auf den Namen eines Tests.
  2. Klicken Sie oben auf der Seite Details zum Konnektivitätstest auf Noch einmal ausführen.

Auf der Detailseite der Netzwerkschnittstelle

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Wählen Sie, falls noch nicht geschehen, das Projekt mit der Instanz aus, für die Sie den Test wiederholen möchten.
  3. Klicken Sie auf die Instanz, die Sie verwenden möchten, um einen Test noch einmal auszuführen.
  4. Wählen Sie unter Netzwerkschnittstellen die Netzwerkschnittstelle aus, die Sie zum nochmaligen Ausführen eines Tests verwenden möchten.
  5. Klicken Sie unter Netzwerkanalyse auf Konnektivitätstests.
  6. Wählen Sie einen oder mehrere Tests aus der Liste der verfügbaren Konnektivitätstests aus.
  7. Klicken Sie auf Erneut ausführen.

gcloud

Geben Sie den folgenden Befehl ein, um einen Konnektivitätstest noch einmal auszuführen. Verwenden Sie die Test-ID, die Sie noch einmal ausführen möchten.

gcloud network-management connectivity-tests rerun NAME

Ersetzen Sie NAME durch den Namen des Konnektivitätstests.

API

Wenn die Network Management API eine connectivityTests-Ressource erstellt, behält sie diese Testressource bei, bis Sie sie löschen. Aus diesem Grund können Sie Tests noch einmal ausführen.

Wenn Sie keine dauerhaften Tests erstellen möchten, können Sie mithilfe der API einen Test erstellen und nach dem Ansehen des Testergebnisses löschen.

Verwenden Sie die Methode projects.locations.global.connectivityTests.rerun, um einen Test noch einmal auszuführen.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID der Quell-VM.
  • TEST_ID: die ID des Objekts „Konnektivitätstests“ (Test), das Sie ausführen.

Python

Mit dem folgenden Beispielcode wird ein Test noch einmal ausgeführt. Weitere Informationen finden Sie in der Google API-Clientbibliothek für Python unter rerun.

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))

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die Projekt-ID des Projekts, in dem der Test erstellt wurde
  • TEST_ID: die ID des Konnektivitätstests-Objekts (Test), das Sie ausführen

Nächste Schritte