Crie e execute testes de conetividade

Saiba como executar testes de conetividade seguindo os passos nesta página.

Para editar ou eliminar um ou mais testes, consulte o artigo Atualize ou elimine testes.

Para saber mais sobre os testes de conetividade, consulte a vista geral.

Antes de começar

Antes de poder usar os testes de conetividade, configure os seguintes itens em Google Cloud:

1. Na Google Cloud consola, aceda à página do seletor de projetos.

   Aceda ao seletor de projetos

   Selecione ou crie um Google Cloud projeto.

2. Certifique-se de que a faturação está ativada para o seu Google Cloud projeto.

3. Instale a CLI Google Cloud, que faz parte da CLI Google Cloud. Para instalar a versão mais recente da CLI gcloud, consulte a documentação da CLI gcloud.

   Para ver uma lista de todos os comandos, consulte a referência de comandosgcloud.

4. Ative a API Network Management. A ativação da API oferece-lhe o seguinte:

   • Exemplos de chamadas de API que usam a API Network Management

     Pode testar comandos da API Network Management através do API Explorer. No documento de referência da API Network Management, use a coluna Try this API para explorar os campos da API e executar um teste.

   • Exemplo de código que usa o cliente Python da API

     O código de exemplo pressupõe que criou um recurso denominado api para interagir com a API Network Management. Para criar um recurso, use a função build. Veja o exemplo seguinte:

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

     Para mais informações sobre o cliente Python da API, consulte o seguinte:

     • Documentos da biblioteca cliente da API Google para Python no GitHub, que incluem instruções de instalação e autenticação.
     • A documentação de referência da API Network Management para o cliente Python da API.
5. Obtenha as autorizações de que precisa para executar e ver testes. Para ver detalhes, consulte a secção Atribua acesso.

Execute testes de conetividade

Quando executa um teste de conetividade, fornece entradas de teste como um 5-tuple sem a porta de origem.

As secções seguintes mostram como executar um teste para os pontos finais de origem e destino descritos em Exemplos de utilização comuns.

Na Google Cloud consola, pode executar testes de conetividade através de uma das seguintes opções:

• A página Testes de conetividade, que está disponível no menu Redes > Centro de inteligência de rede.

• A página Detalhes da interface de rede para uma interface de rede de uma instância de máquina virtual (VM) do Compute Engine. Se usar esta página, tem de usar a interface de rede atual como a Origem ou o Destino do teste. Esta página apenas apresenta testes relevantes para a interface de rede atual.

Cada teste que criar é executado imediatamente após a criação e é armazenado no recurso de testes de conectividade. Um teste existe até o eliminar.

Para verificar o estado de uma operação de teste enquanto a operação é executada, consulte o artigo Verifique uma operação de teste em execução. Alguns exemplos de operações de teste são create e rerun.

Quando usa um endereço IP para o ponto final de origem ou de destino, pode ter de especificar campos adicionais.

Práticas recomendadas

• Quando testa um ponto final (uma VM ou um endereço IP) localizado num projeto de serviço de VPC partilhada, é mais conveniente executar o teste a partir do projeto de serviço. Isto deve-se ao facto de poder selecionar a VM ou o endereço IP na caixa de menu pendente na Google Cloud consola.

  No entanto, tem de especificar o projeto anfitrião antes de especificar a rede da nuvem virtual privada (VPC), porque a rede está no projeto anfitrião. Para obter detalhes, consulte o artigo Teste endereços IP numa rede de VPC partilhada.

• Quando executa um teste entre a sua rede VPC e a sua rede local ou paritária, pode ser útil executar outro teste de conectividade usando o endereço IP local como a origem e uma instância de VM ou um endereço IP na sua rede VPC como o destino.

  Este tipo de teste verifica se Google Cloud está a anunciar rotas conforme esperado para a sua rede no local. No entanto, os testes de conetividade não verificam se a sua rede no local recebeu e implementou essas rotas.

• Os testes de conectividade demoram entre 20 e 120 segundos a receber uma atualização de configuração e a incorporá-la na análise. Se executar um teste imediatamente após fazer uma alteração de configuração, pode não ver os resultados esperados. Certifique-se de que aguarda tempo suficiente entre a alteração da configuração e a execução dos testes.

  Este atraso não se aplica à análise do plano de dados em direto. Por conseguinte, pode verificar uma discrepância temporária entre os resultados apresentados pela análise do plano de dados em direto e a análise da configuração. Por exemplo, se adicionar uma regra de firewall, pode ser alcançável para a análise do plano de dados em direto. No entanto, pode ter de aguardar algum tempo antes de a regra da firewall estar acessível para análise de configuração.

Teste para ou a partir de uma VM com várias interfaces de rede

Esta secção descreve como testar para ou a partir da interface de rede não principal de uma VM.

Consola

Se especificar uma instância de VM com várias interfaces de rede como a origem ou o destino de um teste, os testes de conectividade pedem-lhe que selecione uma interface de rede a partir de uma lista.

Em alternativa, pode executar um teste a partir da página Detalhes da interface de rede para uma interface de rede de uma instância de VM do Compute Engine. Se usar esta página, tem de usar a interface de rede atual como Origem ou Destino do teste.

gcloud e API

Tem de especificar a interface de rede a usar para o teste de uma das seguintes formas:

• Endereço IP e URI de rede
• Endereço IP e URI da VM
• URI de rede e URI de VM

Se fornecer apenas o URI de uma VM com várias interfaces, seleciona apenas a interface principal da VM.

Apresenta todos os testes de um projeto.

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Na parte superior da página, no menu pendente do projeto, selecione um projeto.
3. A página Testes de conetividade é atualizada e mostra os testes para esse projeto.

gcloud

Para apresentar uma lista de todos os testes pertencentes a um projeto, introduza o seguinte comando gcloud. Este comando mostra os testes no projeto selecionado atualmente.

  gcloud network-management connectivity-tests list

Para listar testes num projeto específico, especifique o PROJECT_ID.

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

API

Para listar todos os testes existentes pertencentes a um projeto, use o método projects.locations.global.connectivityTests.list.

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

• Substitua PROJECT_ID pelo ID do projeto que contém os testes que quer listar.

Python

O seguinte exemplo de código apresenta todos os testes existentes pertencentes a um projeto. Para mais informações, consulte list na biblioteca cliente de APIs Google para Python.

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

Substitua PROJECT_ID pelo ID do projeto que contém os testes que quer listar.

Teste entre instâncias de VM numa rede de VPC

Estes passos pressupõem que ambas as instâncias de VM estão no mesmo Google Cloud projeto.

Consola

A partir da página principal de testes de conetividade

1. Na Google Cloud consola, aceda à página Testes de conetividade.

   Aceda a Testes de conetividade

   Os passos restantes aparecem automaticamente na Google Cloud consola.

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Instância de VM.
   2. No menu Instância de VM de origem, selecione a instância de VM de origem específica.

   3. No menu Interface de rede de origem, selecione a interface de rede.

      Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM que identifique exclusivamente a localização de origem.

   4. Opcional: selecione o Endereço IP de origem na lista. A predefinição é o endereço IP da instância de VM de origem.
6. Para Destino, faça o seguinte:
   1. No menu Ponto final de destino, selecione Instância de VM.
   2. No menu Instância de VM de destino, selecione a instância de VM de destino específica.

   3. No menu Interface de rede de destino, selecione a interface de rede.

      Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM para identificar a localização de destino de forma exclusiva.

   4. Opcional: selecione o Endereço IP de destino na lista. A predefinição é o endereço IP da instância de VM de destino.

Nota: para uma instância de pilha dupla, o endereço IP de origem e de destino têm de ser do mesmo tipo. Por exemplo, não pode testar a partir de uma VM com um endereço IPv4 para uma VM com um endereço IPv6.

7. No campo Porta de destino, introduza uma porta de destino.
8. Clique em Criar.

Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

Na página de detalhes da interface de rede

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Se ainda não estiver selecionado, selecione o projeto que contém a instância para a qual quer executar um teste.
3. Clique na instância que quer usar para executar um teste.

4. Para Interfaces de rede, selecione a interface de rede que quer usar para executar um teste.

   Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM para identificar exclusivamente a localização de destino.

5. Para a Análise de rede, clique em Criar teste de conetividade e faça o seguinte:

   1. No campo Nome do teste, introduza um nome para o teste.
   2. Na lista Protocolo, selecione um protocolo.

   3. Para Origem, pode selecionar Interface de rede atual ou Outro.

      Se selecionar Interface de rede atual, faça o seguinte:

      1. No menu Ponto final de destino, selecione Instância de VM.
      2. No menu Instância de VM de destino, selecione a instância.
      3. No menu Interface de rede de destino, selecione a interface de rede.
      4. Opcional: selecione o endereço IP de destino. O valor predefinido é o endereço IP da instância de VM de destino.

      Se selecionar Outro, faça o seguinte:

      1. No menu Ponto final de origem, selecione Instância de VM.
      2. No menu Instância de VM de origem, selecione a instância.
      3. No menu Interface de rede de origem, selecione a interface de rede.
      4. Opcional: selecione o endereço IP de origem. A predefinição é o endereço IP da instância de VM de origem.

   4. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

   5. Clique em Criar.

6. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• DESTINATION_INSTANCE: o URI da VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Terraform

Pode usar um recurso do Terraform para criar um teste entre duas instâncias de VM numa rede VPC.

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

O seguinte teste de exemplo determina se a configuração de rede existente permite que a VM instance1envie um ping para a VM instance2.

Use o método 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",
   }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• DESTINATION_INSTANCE: o URI do VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Python

O exemplo de código seguinte cria um teste entre duas instâncias de VM. Para mais informações, consulte create na biblioteca cliente de APIs Google para Python.

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

Substitua o seguinte:

• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
• DESTINATION_INSTANCE: o URI da VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• DESTINATION_INSTANCE_PROJECT_ID: o ID do projeto da VM de destino.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Teste entre endereços IP privados numa rede da VPC

Este exemplo pressupõe que ambos os endereços IP são endereços IP privados no mesmo Google Cloud projeto e na mesma rede da VPC.

Se estiver a testar entre redes de VPC com peering, selecione as redes de origem e de destino para cada par.

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade.

   Aceda a Testes de conetividade

   Os passos restantes aparecem na Google Cloud consola.

2. Selecione Criar teste de conetividade.

3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.

5. Para a Origem, faça o seguinte:

   1. Na lista Ponto final de origem, selecione Endereço IP.
   2. No campo Endereço IP de origem, introduza o endereço IP de origem.
   3. Se a rede VPC do endereço IP de origem estiver no projeto atual, desmarque a caixa de verificação Este é um endereço IP usado em Google Cloud.
      

      Se a rede VPC estiver noutro projeto, no campo Endereço IP de origem ou projeto de serviço, selecione o projeto onde a rede está localizada.

      Se o endereço IP estiver fora do espaço de endereço RFC 1918, selecione a caixa de verificação Confirmo que o ponto final de origem reside num intervalo fora do espaço de endereço RFC 1918. Em seguida, na lista Rede de origem, selecione a rede que contém o endereço IP de origem.

6. Para Destino, faça o seguinte:

   1. Na lista Ponto final de destino, selecione Endereço IP.
   2. No campo Endereço IP de destino, introduza o endereço IP de destino.
   3. Se a rede VPC do endereço IP de destino estiver no projeto atual, desmarque a caixa de verificação Este é um endereço IP usado em Google Cloud.
      

      Se a rede VPC estiver noutro projeto, no campo Endereço IP de destino ou projeto de serviço, selecione o projeto onde a rede está localizada.

      Se o endereço IP estiver fora do espaço de endereço RFC 1918, selecione a caixa de verificação Confirmo que o ponto final de destino reside num intervalo fora do espaço de endereço RFC 1918. Em seguida, na lista Rede de destino, selecione a rede que contém o endereço IP de destino.

7. No campo Porta de destino, introduza um número de porta de destino válido. O número tem de estar entre 0 e 65535, inclusive.
8. Clique em Criar.

Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Substitua as variáveis das opções de comando por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK: o URI da rede VPC onde o endereço IP de origem está localizado, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.
• DESTINATION_NETWORK: o URI da rede VPC onde o endereço IP de destino está localizado, por exemplo, projects/myproject/global/networks/network-a.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP. A porta predefinida é 80.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Se a rede for desconhecida ou não tiver autorização para aceder à rede, pode especificar a rede como GCP_NETWORK, em vez de fornecer um URI de rede.

Não tem de confirmar se o seu endereço IP está em Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereço RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e de destino.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK_TYPE: o tipo de rede onde a origem está localizada. Neste caso, use um valor de GCP_NETWORK.
• DESTINATION_INSTANCE: o URI do VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP. A porta predefinida é 80.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Quando especifica um endereço IP de origem que é um endereço IP externo fora de Google Cloud, tem de especificar um networkType de NON_GCP_NETWORK. Substitua os valores no seguinte comando por valores da sua rede VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK_TYPE: o tipo de rede onde a origem está localizada. Neste caso, use um valor de NON_GCP_NETWORK.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.
• DESTINATION_NETWORK: um URI para a rede VPC onde o endereço IP de destino está localizado, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Terraform

Pode usar um recurso do Terraform para criar um teste entre dois endereços IP numa rede VPC.

Não tem de confirmar se o seu endereço IP está em Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereço RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e de destino.

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

Este exemplo testa a capacidade de enviar um ping do endereço IP de origem para o endereço IP de destino.

Use o método 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".
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK: o URI da rede VPC onde se encontra o endereço IP de origem, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.
• DESTINATION_NETWORK: um URI para a rede VPC onde o endereço IP de destino está localizado, por exemplo, projects/myproject/global/networks/network-a.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Se a rede VPC for desconhecida ou não tiver autorização para aceder à rede, pode especificar a rede como GCP_NETWORK, em vez de fornecer um URI de rede.

Não tem de confirmar se o seu endereço IP está em Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereço RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e de destino.

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

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK_TYPE: o tipo de rede onde a origem está localizada. Neste caso, use um valor de GCP_NETWORK.
• DESTINATION_INSTANCE: o URI da VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Quando especifica um endereço IP de origem que é um endereço IP externo fora de Google Cloud, tem de especificar um networkType de NON_GCP_NETWORK. Substitua os valores no seguinte comando por valores da sua Google Cloud rede.

  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

O código de exemplo seguinte cria um teste entre dois endereços IP. Para mais informações, consulte create na biblioteca cliente de APIs Google para Python.

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_IP_PROJECT_ID: o ID do projeto do endereço IP de origem.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• DESTINATION_IP_PROJECT_ID: o ID do projeto do endereço IP de destino.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Se a rede VPC for desconhecida ou não tiver autorização para aceder à rede, pode especificar a rede como GCP_NETWORK, em vez de fornecer um URI de rede.

Não tem de confirmar se o seu endereço IP está em Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereço RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e de destino.

O exemplo seguinte cria um teste entre dois endereços IP:

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK_TYPE: o tipo de rede onde a origem está localizada. Neste caso, use um valor de GCP_NETWORK.
• DESTINATION_IP_ADDRESS: o endereço IP da VM de destino.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• DESTINATION_IP_PROJECT_ID: o ID do projeto do endereço IP de destino.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Quando especifica um endereço IP de origem que é um endereço IP externo fora de Google Cloud, tem de especificar um networkType de NON_GCP_NETWORK.

Teste endereços IP numa rede VPC partilhada

Quando tem uma rede VPC partilhada, pode criar e executar um teste a partir do projeto anfitrião ou do projeto de serviço.

O exemplo seguinte mostra ambos os casos e usa um endereço IP de destino atribuído no projeto de serviço. Os valores dos campos na Google Cloud consola são ligeiramente diferentes para cada caso. No entanto, as opções de comando para a CLI do Google Cloud e para as chamadas API são as mesmas.

Nota: quando especifica um endereço IP de origem ou de destino numa rede de VPC partilhada localizada num projeto anfitrião, estes endereços IP são efetivamente atribuídos e usados num projeto de serviço. Assim, quando seleciona a rede num projeto anfitrião, também tem de especificar o ID do projeto de serviço para o endereço IP. Por outro lado, quando especifica um endereço IP num projeto de serviço, também tem de selecionar a respetiva rede no projeto anfitrião.

Consola: do anfitrião

1. Na Google Cloud consola, no projeto anfitrião, aceda à página Testes de conetividade.

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Endereço IP.
   2. Introduza o endereço IP de origem.
   3. Selecione a caixa de verificação Este é um endereço IP usado em Google Cloud.
   4. Se este for um endereço IP interno que não é acessível a partir da Internet, selecione a rede VPC onde o endereço está localizado.
   5. Se o seu endereço IP privado estiver fora do espaço de endereço RFC 1918, selecione Confirmo que o ponto final de origem reside num intervalo fora do espaço de endereço RFC 1918 e, em seguida, selecione a rede de destino que contém o endereço IP.
6. Para Destino, faça o seguinte:
   1. No menu Ponto final de destino, selecione Endereço IP.
   2. Introduza o endereço IP de destino.
   3. Selecione a caixa de verificação Este é um endereço IP usado em Google Cloud.
   4. Se este for um endereço IP interno que não é acessível a partir da Internet, selecione a rede VPC onde o endereço está localizado.
   5. Se o seu endereço IP privado estiver fora do espaço de endereço RFC 1918, selecione Confirmo que o ponto final de origem reside num intervalo fora do espaço de endereço RFC 1918 e, em seguida, selecione a rede de destino que contém o endereço IP.
7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

Consola: do serviço

1. Na Google Cloud consola, no projeto de serviço, aceda à página Testes de conetividade.

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Endereço IP.
   2. Introduza o endereço IP de origem.
   3. Selecione a caixa de verificação Este é um endereço IP usado em Google Cloud.
   4. Se este for um endereço IP interno que não é acessível a partir da Internet, selecione a rede VPC onde o endereço está localizado.
6. Para Destino, faça o seguinte:
   1. No menu Ponto final de destino, selecione Endereço IP.
   2. Introduza o endereço IP de destino.
   3. Selecione a caixa de verificação Este é um endereço IP usado em Google Cloud.
   4. Especifique o endereço IP de destino ou o projeto de serviço onde o endereço IP está localizado.
   5. Se o seu endereço IP privado estiver fora do espaço de endereços RFC 1918, selecione a caixa de verificação com a etiqueta Confirmo que o ponto final de origem reside num intervalo fora do espaço de endereços RFC 1918 e, em seguida, selecione a rede de destino que contém o endereço IP.
7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Introduza o seguinte comando para testar entre dois endereços IP privados num anfitrião e num projeto de serviço onde o endereço IP de destino está localizado no projeto de serviço. Substitua as variáveis das opções de comando por valores da sua rede de VPC.

Uma vez que o endereço IP de destino está no projeto de serviço, especifique o projeto de serviço e o URI de rede do projeto anfitrião. Neste caso, default representa a rede VPC predefinida para o 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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_PROJECT: o ID do projeto do ponto final de origem.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo que está a testar no projeto de serviço.
• DESTINATION_NETWORK: um URI para a rede VPC do projeto anfitrião, por exemplo, projects/host-project/global/networks/default.
• DESTINATION_PROJECT: o ID do projeto do ponto final de destino, por exemplo, um projeto denominado service-project que representa o projeto de serviço usado para esta rede VPC partilhada.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

API

Use o método 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",
    }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_PROJECT: o ID do projeto do ponto final de origem.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo que está a testar no projeto de serviço.
• DESTINATION_PROJECT: o ID do projeto do ponto final de destino, por exemplo, um projeto denominado service-project que representa o projeto de serviço usado para esta rede VPC partilhada.
• DESTINATION_NETWORK: um URI para a rede VPC do projeto anfitrião, por exemplo, projects/host-project/global/networks/default.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Python

O código de exemplo seguinte cria um teste entre dois endereços IP. Para mais informações, consulte create na biblioteca cliente de APIs Google para Python.

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_IP_PROJECT_ID: o ID do projeto do ponto final de origem.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo que está a testar no projeto de serviço.
• DESTINATION_IP_PROJECT_ID: o ID do projeto do ponto final de destino, por exemplo, um projeto denominado service-project que representa o projeto de serviço usado para esta rede de VPC partilhada.
• DESTINATION_NETWORK: um URI para a rede VPC do projeto anfitrião, por exemplo, projects/host-project/global/networks/default.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Teste de uma VM para um serviço gerido pela Google

Esta secção descreve como testar a partir de uma VM na sua rede da VPC para um serviço executado numa rede da VPC pertencente à Google. Por exemplo, pode seguir os passos nesta secção para testar a conetividade a uma instância do Cloud SQL ou a um cluster do GKE plano de controlo. Também pode executar um teste usando um ponto final de serviço gerido pela Google como origem e um ponto final na sua rede da VPC como destino.

Por predefinição, os testes de conetividade tentam executar um teste através do endereço IP privado do ponto final do serviço gerido pela Google. Se o ponto final não tiver um endereço IP privado, os testes de conectividade usam o endereço IP público. Os testes de conetividade analisam se o pacote consegue alcançar o ponto final, o que inclui a análise da configuração na rede VPC pertencente à Google. Se forem detetados problemas de configuração no seu projeto, a análise é interrompida antes de analisar a configuração de rede pertencente à Google.

Para testar a partir de uma VM para um serviço gerido pela Google, consulte as instruções seguintes.

Consola

A partir da página principal de testes de conetividade

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.

5. Para a Origem, faça o seguinte:

   1. No menu Ponto final de origem, selecione Instância de VM.
   2. No menu Instância de VM de origem, selecione a instância de VM de origem específica.

   3. No menu Interface de rede de origem, selecione a interface de rede.

      Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM que identifique exclusivamente a localização de origem.

   4. Opcional: selecione o Endereço IP de origem na lista. A predefinição é o endereço IP da instância de VM de origem.

6. Para Destino, faça o seguinte:

   1. No menu Ponto final de destino, selecione um tipo de recurso de serviço gerido pela Google, como Plano de controlo do cluster do GKE.
   2. No menu Plano de controlo do cluster GKE de destino, selecione o cluster para o qual quer testar a conetividade com o plano de controlo do GKE.
   3. Opcional: selecione o Ponto final do plano de controlo do cluster GKE de destino na lista. A predefinição é o ponto final baseado em IP do cluster do GKE.

7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

8. Clique em Criar.

9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

Na página de detalhes da interface de rede

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Se ainda não estiver selecionado, selecione o projeto que contém a instância para a qual quer executar um teste.
3. Clique na instância que quer usar para executar um teste.
4. Para Interfaces de rede, selecione a interface de rede que quer usar para executar um teste.
5. Para a Análise de rede, clique em Criar teste de conetividade.
6. No campo Nome do teste, introduza um nome para o teste.
7. Na lista Protocolo, selecione um protocolo.
8. Para Origem, selecione Interface de rede atual.
9. Para Destino, faça o seguinte:
   1. No menu Ponto final de destino, selecione um tipo de recurso de serviço gerido pela Google, como Plano de controlo do cluster do GKE.
   2. No menu Plano de controlo do cluster GKE de destino, selecione o cluster para o qual quer testar a conetividade com o plano de controlo do GKE.
   3. Opcional: selecione o Ponto final do plano de controlo do cluster GKE de destino na lista. A predefinição é o ponto final baseado em IP do cluster do GKE.
10. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
    1. Clique em Criar.
    2. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Substitua as variáveis das opções de comando de acordo com as seguintes orientações:

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.

• DESTINATION_RESOURCE_FLAG: o indicador que especifica o tipo de recurso de serviço gerido pela Google.

  Para ver as opções disponíveis, consulte o seguinte:

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

  Para mais informações, consulte a gcloud network-management connectivity-tests create referência.

• DESTINATION_ENDPOINT: o URI do ponto final de destino, por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para a flag --destination-gke-master-cluster.

• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.

• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

API

Use o método 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",
   }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.

• DESTINATION_RESOURCE_FIELD: o campo que especifica o tipo de recurso de serviço gerido pela Google.

  Para ver as opções disponíveis, consulte o seguinte:

  • gkeMasterCluster
  • cloudSqlInstance
  • redisInstance
  • redisCluster

  Para mais informações, consulte a Referência de pontos finais.

• DESTINATION_ENDPOINT: o URI do ponto final de destino, por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1, para o campo gkeMasterCluster.

• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.

• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Python

O código de exemplo seguinte cria um teste entre uma instância de VM e um ponto final de serviço gerido pela Google. Para mais informações, consulte create na biblioteca cliente de APIs Google para Python.

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

Substitua o seguinte:

• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.

• DESTINATION_RESOURCE_FIELD: o campo que especifica o tipo de recurso de serviço gerido pela Google.

  Para ver as opções disponíveis, consulte o seguinte:

  • gkeMasterCluster
  • cloudSqlInstance
  • redisInstance
  • redisCluster

  Para mais informações, consulte a Referência de pontos finais.

• DESTINATION_ENDPOINT: o URI do ponto final de destino, por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1, para o campo gkeMasterCluster.

• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.

• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

• PROJECT_ID: o ID do projeto no qual está a criar o teste.

• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Teste a partir de uma VM para pontos finais do Private Service Connect

Esta secção descreve como testar a partir de uma VM para um ponto final do Private Service Connect.

Por exemplo, pode seguir os passos nesta secção para testar se um pacote pode ser entregue a um serviço publicado que usa o Private Service Connect. Os testes de conetividade analisam se um pacote consegue alcançar o ponto final, o que inclui a análise dos pontos finais ligados, dos serviços publicados e da ligação proxy. A análise termina antecipadamente se a ligação a um serviço publicado que usa o Private Service Connect não for aceite.

Pode testar a conetividade com o seguinte:

• Endpoints para APIs Google

• Pontos finais para serviços publicados

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.

5. Para a Origem, faça o seguinte:

   1. No menu Ponto final de origem, selecione Instância de VM.
   2. No menu Instância de VM de origem, selecione a instância de VM de origem específica.

   3. No menu Interface de rede de origem, selecione a interface de rede.

      Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM que identifique exclusivamente a localização de origem.

   4. Opcional: selecione o Endereço IP de origem na lista. A predefinição é o endereço IP da instância de VM de origem.

6. Para Destino, faça o seguinte:

   1. No menu Ponto final de destino, selecione Ponto final do PSC.

   2. No menu Ponto final do PSC de destino, selecione o ponto final do PSC.

      Se o ponto final de destino estiver num projeto diferente do projeto atual, selecione O ponto final está num projeto diferente de "PROJECT_NAME". Em seguida, no campo Projeto do ponto final de destino, selecione o projeto onde o ponto final está localizado.

7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

8. Clique em Criar.

9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• DESTINATION_IP_ADDRESS: o endereço IP do ponto final ou do back-end que quer testar.
• DESTINATION_NETWORK: um URI para a rede VPC onde o endereço IP de destino está localizado, por exemplo, projects/myproject/global/networks/default.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Se o ponto final ou o back-end for usado para aceder a serviços publicados, tem de especificar o DESTINATION_NETWORK porque o ponto final ou o back-end tem um endereço IP interno.

API

O seguinte teste de exemplo determina se a configuração de rede existente permite que a VM instance1 faça ping ao endereço IP do ponto final do Private Service Connect.

Use o método 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",
   }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• DESTINATION_IP_ADDRESS: o endereço IP do ponto final ou do back-end que quer testar.
• DESTINATION_NETWORK: um URI para a rede VPC onde o endereço IP de destino está localizado, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Se o ponto final ou o back-end for usado para aceder a serviços publicados, tem de especificar o DESTINATION_NETWORK porque o ponto final ou o back-end tem um endereço IP interno.

Python

O código de exemplo seguinte cria um teste entre uma instância de VM e um ponto final do Private Service Connect. Para mais informações, consulte create na biblioteca cliente da API Google para Python.

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

Substitua o seguinte:

• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
• DESTINATION_IP_ADDRESS: o endereço IP do ponto final ou do back-end que quer testar.
• DESTINATION_NETWORK: um URI para a rede VPC onde o endereço IP de destino está localizado, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Se o ponto final ou o back-end for usado para aceder a serviços publicados, tem de especificar o DESTINATION_NETWORK porque o ponto final ou o back-end tem um endereço IP interno.

Teste a partir de uma versão do ambiente padrão do App Engine para um destino

Esta secção descreve como testar a conetividade de uma versão do ambiente padrão do App Engine a uma instância de VM, um endereço IP ou um serviço gerido pela Google.

Uma app do ambiente padrão do App Engine é composta por um único recurso de aplicação que consiste num ou mais serviços. Em cada serviço, implementa versões desse serviço. Pode testar a acessibilidade a partir de uma versão de um serviço do ambiente padrão do App Engine para uma instância de VM, um endereço IP ou um serviço gerido pela Google.

Para ver uma análise detalhada da configuração, tem de configurar o seu serviço para usar um conetor de acesso à VPC sem servidor. O resultado de um teste de conetividade pode ser diferente para cada versão do serviço. Só pode testar a acessibilidade de pacotes de teste que usam o protocolo UDP ou TCP.

Teste a conetividade de uma versão de um serviço do ambiente padrão do App Engine a uma instância de VM

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. Introduza um nome para o teste.
4. Selecione um protocolo.
5. No menu Ponto final de origem, selecione App Engine.
   1. No menu Serviço do App Engine, selecione o serviço do ambiente padrão do App Engine específico a partir do qual quer testar a conetividade. Por exemplo, selecione helloworld-service.
      1. Se o ponto final de origem estiver num projeto diferente do projeto atual, selecione a caixa de verificação O ponto final está num projeto diferente de "PROJECT_NAME".
      2. Selecione um projeto onde o ponto final exista.
   2. No menu Versão do App Engine, selecione uma versão do serviço do ambiente padrão do App Engine a partir do qual quer testar a conetividade.

6. Para Destino, selecione uma instância de VM de destino na lista.

   Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM para identificar exclusivamente a localização de destino.

7. Opcional: selecione o Endereço IP de destino na lista. O valor predefinido é o endereço IP da instância de VM de destino.

8. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

9. Clique em Criar.

10. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• APP_ENGINE_VERSION: o URI da origem Versão do ambiente padrão do App Engine, por exemplo, apps/myproject/services/service-name/versions/version-name.
• DESTINATION_INSTANCE: o URI do VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

API

Use o método 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",
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• APP_ENGINE_VERSION: o URI da origem Versão do ambiente padrão do App Engine, por exemplo, apps/myproject/services/service-name/versions/version-name.
• DESTINATION_INSTANCE: o URI do VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

Teste a conetividade de uma versão de um serviço do ambiente padrão do App Engine a um endereço IP

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. Introduza um nome para o teste.
4. Selecione um protocolo.
5. No menu Ponto final de origem, selecione um App Engine.
   1. No menu Serviço do App Engine, selecione o serviço do ambiente padrão do App Engine específico a partir do qual quer testar a conetividade. Por exemplo, selecione helloworld-service.
      1. Se o ponto final de origem estiver num projeto diferente do projeto atual, selecione O ponto final está num projeto diferente de "PROJECT_NAME".
      2. Selecione um projeto onde o ponto final exista.
   2. No menu Versão do App Engine, selecione uma versão do serviço do ambiente padrão do App Engine a partir do qual quer testar a conetividade.
6. Para Destino, selecione Endereço IP e, de seguida, introduza um endereço IP.
7. Introduza uma porta de destino.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• APP_ENGINE_VERSION: o URI da origem Versão do ambiente padrão do App Engine, por exemplo, apps/myproject/services/service-name/versions/version-name.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

API

Use o método 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",
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• APP_ENGINE_VERSION: o URI da origem Versão do ambiente padrão do App Engine, por exemplo, apps/myproject/services/service-name/versions/version-name.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

Teste a conetividade de uma versão de um serviço do ambiente padrão do App Engine para um serviço gerido pela Google

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. Introduza um nome para o teste.
4. Selecione um protocolo.
5. No menu Ponto final de origem, selecione um App Engine.
   1. No menu Serviço do App Engine, selecione o serviço do ambiente padrão do App Engine específico a partir do qual quer testar a conetividade. Por exemplo, selecione helloworld-service.
      1. Se o ponto final de origem estiver num projeto diferente do projeto atual, selecione O ponto final está num projeto diferente de "PROJECT_NAME".
      2. Selecione um projeto onde o ponto final exista.
   2. No menu Versão do App Engine, selecione uma versão do serviço do ambiente padrão do App Engine a partir do qual quer testar a conetividade.
6. Para Destino, faça o seguinte:
   1. No menu Ponto final de destino, selecione um tipo de recurso de serviço gerido pela Google, como Plano de controlo do cluster do GKE.
   2. No menu Plano de controlo do cluster GKE de destino, selecione o cluster para o qual quer testar a conetividade com o plano de controlo do GKE.
   3. Opcional: selecione o Ponto final do plano de controlo do cluster GKE de destino na lista. A predefinição é o ponto final baseado em IP do cluster do GKE.
7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• APP_ENGINE_VERSION: o URI da origem Versão do ambiente padrão do App Engine, por exemplo, apps/myproject/services/servicename/versions/version-number.
• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.

• DESTINATION_RESOURCE_FLAG: o indicador que especifica o tipo de recurso de serviço gerido pela Google.

  Para ver as opções disponíveis, consulte o seguinte:

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

  Para mais informações, consulte a gcloud network-management connectivity-tests create referência.

• DESTINATION_ENDPOINT: o URI do ponto final de destino, por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para a flag --destination-gke-master-cluster.

• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP. A predefinição é a porta 80.

• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

API

Use o método 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",
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• APP_ENGINE_VERSION: o URI da origem Versão do ambiente padrão do App Engine, por exemplo, apps/myproject/services/servicename/versions/version-number.

• DESTINATION_RESOURCE_FIELD: o campo que especifica o tipo de recurso de serviço gerido pela Google.

  Para ver as opções disponíveis, consulte o seguinte:

  • gkeMasterCluster
  • cloudSqlInstance
  • redisInstance
  • redisCluster

  Para mais informações, consulte a Referência de pontos finais.

• DESTINATION_ENDPOINT: o URI do ponto final de destino, por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1, para o campo gkeMasterCluster.

• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.

• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP. A predefinição é a porta 80.

• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Teste de uma função do Cloud Run para um destino

Esta secção descreve como testar a conetividade a partir de uma função do Cloud Run implementada numa Google Cloud região específica para uma instância de VM, um endereço IP ou um serviço gerido pela Google. Por exemplo, pode seguir os passos nesta secção para testar a conetividade a partir de uma função do Cloud Run implementada no us-central1 como origem para um ponto final na sua rede VPC como destino.

Para ver uma análise de configuração detalhada, certifique-se de que a função do Cloud Run está ativa e de que configurou um conetor de acesso à VPC sem servidor para a função do Cloud Run.

As definições de saída para as funções do Cloud Run controlam o encaminhamento de pedidos HTTP de saída de uma função do Cloud Run e controlam os tipos de tráfego encaminhados através do conector para a sua rede VPC. Para mais informações, consulte as Definições de saída das funções do Cloud Run.

Teste a conetividade de uma função do Cloud Run a uma instância de VM

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Função do Cloud de 1.ª geração.
   2. No menu Função na nuvem, selecione a função específica do Cloud Run a partir da qual quer testar a conetividade. Por exemplo, selecione function-1.
   3. No menu de localização da Cloud Function, selecione a região onde implementou a função do Cloud Run. Google Cloud Pode implementar funções do Cloud Run em várias regiões com configurações diferentes, mas com o mesmo nome.

6. Para Destino, faça o seguinte:

   1. No menu Ponto final de destino, selecione Instância de VM.
   2. No menu Instância de VM de destino, selecione uma instância de VM.

   3. No menu Interface de rede de destino, selecione a interface de rede.

      Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM que identifique exclusivamente a localização de destino.

   4. Opcional: selecione o Endereço IP de destino na lista. A predefinição é o endereço IP da instância de VM de destino.

7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

8. Clique em Criar.

9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, por exemplo, projects/myproject/locations/us-central1/functions/function-1.
• DESTINATION_INSTANCE: o URI do VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

API

Use o método 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",
}'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, por exemplo, projects/myproject/locations/us-central1/functions/function-1.
• DESTINATION_INSTANCE: o URI do VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Teste a conetividade de uma função do Cloud Run a um endereço IP

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Função do Cloud de 1.ª geração.
   2. No menu Função na nuvem, selecione a função específica do Cloud Run a partir da qual quer testar a conetividade. Por exemplo, selecione function-1.
   3. No menu de localização da Cloud Function, selecione a região onde implementou a função do Cloud Run. Google Cloud Pode implementar funções do Cloud Run em várias regiões com configurações diferentes, mas com o mesmo nome.
6. Para Destino, selecione Endereço IP e, de seguida, introduza um endereço IP.
7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para a secção Ver resultados do teste mais adiante nesta página.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run. Por exemplo, projects/myproject/locations/us-central1/functions/function-1.
• DESTINATION_IP_ADDRESS: o endereço IP de destino para o qual está a fazer o teste.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

API

Use o método 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",
}'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, por exemplo, projects/myproject/locations/us-central1/functions/function-1.
• DESTINATION_IP_ADDRESS: o endereço IP de destino para o qual está a fazer o teste.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Teste a conetividade de uma função do Cloud Run a um serviço gerido pela Google

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Função do Cloud de 1.ª geração.
   2. No menu Função na nuvem, selecione a função específica do Cloud Run a partir da qual quer testar a conetividade. Por exemplo, selecione function-1.
   3. No menu Localização da Cloud Function, selecione a região onde implementou a função do Cloud Run. Google Cloud Pode implementar funções do Cloud Run em várias regiões com configurações diferentes, mas com o mesmo nome.
6. Para Destino, faça o seguinte:
   1. No menu Ponto final de destino, selecione um tipo de recurso de serviço gerido pela Google, como instância do Cloud SQL.
   2. No menu Instância do Cloud SQL de destino, selecione a instância do Cloud SQL a partir da qual quer testar a conetividade.
   3. Opcional: selecione o Endereço IP da instância do Cloud SQL de destino na lista. A predefinição é o endereço IP da função do Cloud Run de origem.
7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para a secção Ver resultados do teste mais adiante nesta página.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, por exemplo, projects/myproject/locations/us-central1/functions/function-1.

• DESTINATION_RESOURCE_FLAG: o indicador que especifica o tipo de recurso de serviço gerido pela Google.

  Para ver as opções disponíveis, consulte o seguinte:

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

  Para mais informações, consulte a gcloud network-management connectivity-tests create referência.

• DESTINATION_ENDPOINT: o URI do ponto final de destino, por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para a flag --destination-gke-master-cluster.

• DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste.

• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP. A predefinição é a porta 80.

• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Teste de uma revisão do Cloud Run para um destino

Esta secção descreve como testar a conetividade de uma revisão do Cloud Run a uma instância de VM, a um endereço IP ou a um serviço gerido pela Google.

Pode implementar vários serviços do Cloud Run num único projeto. Todos os serviços do Cloud Run têm um ponto final HTTPS num subdomínio exclusivo do domínio *.run.app. Cada implementação do serviço do Cloud Run cria uma nova revisão imutável. Pode testar a acessibilidade de uma revisão a uma instância de VM, um endereço IP ou um serviço gerido pela Google. Para ver uma análise detalhada da configuração, tem de configurar um conetor de acesso a VPC sem servidor para a sua revisão. Os resultados do teste de conetividade podem ser diferentes para cada revisão.

Por exemplo, um serviço do Cloud Run denominado cloud_run_test tem uma revisão first-revision configurada para usar um conetor do Acesso a VPC sem servidor e outra revisão second-revision que não está configurada para usar um conetor do Acesso a VPC sem servidor. O resultado geral da acessibilidade pode ser acessível para first-revision, mas inacessível para second-revision.

Quando cria um teste de conetividade, pode selecionar a partir de uma lista de revisões para um serviço do Cloud Run.

Teste a conetividade de uma revisão de um serviço do Cloud Run a uma instância de VM

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. Introduza um nome para o teste.
4. Selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Cloud Run.
   2. No menu Serviço do Cloud Run, selecione o serviço do Cloud Run específico a partir do qual quer testar a conetividade. Por exemplo, selecione helloworld-run.
      1. Se o ponto final de origem estiver num projeto diferente do projeto atual, selecione O ponto final está num projeto diferente de "PROJECT_NAME".
      2. Selecione um projeto onde o ponto final exista.
   3. No menu Revisão do Cloud Run, selecione uma revisão do Cloud Run a partir da qual está a fazer testes.

6. Para Destino, faça o seguinte:

   1. No menu Ponto final de destino, selecione Instância de VM.
   2. No menu Instância de VM de destino, selecione a instância de VM de destino específica.

   3. No menu Interface de rede de destino, selecione a interface de rede.

      Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM para identificar exclusivamente a localização de destino.

   4. Opcional: selecione o Endereço IP de destino na lista. A predefinição é o endereço IP da instância de VM de destino.

7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

8. Clique em Criar.

9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, por exemplo, projects/myproject/locations/us-central1/revisions/cloudrun-revision.
• DESTINATION_INSTANCE: o URI do VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

API

Use o método 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",
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, por exemplo, projects/myproject/locations/us-central1/revisions/cloudrun-revision.
• DESTINATION_INSTANCE: o URI do VM de destino, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-2.
• DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino para a qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de destino.
• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

Teste a conetividade de uma revisão de um serviço do Cloud Run a um endereço IP

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. Introduza um nome para o teste.
4. Selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Cloud Run.
   2. No menu Serviço do Cloud Run, selecione o serviço do Cloud Run específico a partir do qual quer testar a conetividade. Por exemplo, selecione helloworld-run.
      1. Se o ponto final de origem estiver num projeto diferente do projeto atual, selecione O ponto final está num projeto diferente de "PROJECT_NAME".
      2. Selecione um projeto onde o ponto final exista.
   3. No menu Revisão do Cloud Run, selecione uma revisão do Cloud Run a partir da qual está a fazer testes.
6. Para Destino, selecione Endereço IP e, de seguida, introduza um endereço IP.
7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, por exemplo, projects/myproject/locations/us-central1/revisions/cloudrun-revision.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

API

Use o método 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",
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, por exemplo, projects/myproject/locations/us-central1/revisions/cloudrun-revision.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

Teste a conetividade de uma revisão de um serviço do Cloud Run a um serviço gerido pela Google

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. Introduza um nome para o teste.
4. Selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Cloud Run.
   2. No menu Serviço do Cloud Run, selecione o serviço do Cloud Run específico a partir do qual quer testar a conetividade. Por exemplo, selecione helloworld-run.
      1. Se o ponto final de origem estiver num projeto diferente do projeto atual, selecione O ponto final está num projeto diferente de "PROJECT_NAME".
      2. Selecione um projeto onde o ponto final exista.
   3. No menu Revisão do Cloud Run, selecione uma revisão do Cloud Run a partir da qual está a fazer testes.
6. Para Destino, faça o seguinte:
   1. No menu Ponto final de destino, selecione um tipo de recurso de serviço gerido pela Google, como Plano de controlo do cluster do GKE.
   2. No menu Plano de controlo do cluster GKE de destino, selecione o cluster para o qual quer testar a conetividade com o plano de controlo do GKE.
   3. Opcional: selecione o Ponto final do plano de controlo do cluster GKE de destino na lista. A predefinição é o ponto final baseado em IP do cluster do GKE.
7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, por exemplo, projects/myproject/locations/us-central1/revisions/cloudrun-revision.
• PROJECT_NAME: o nome do projeto onde o ponto final está localizado, por exemplo, myproject.

• DESTINATION_RESOURCE_FLAG: o indicador que especifica o tipo de recurso de serviço gerido pela Google.

  Para ver as opções disponíveis, consulte o seguinte:

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

  Para mais informações, consulte a gcloud network-management connectivity-tests create referência.

• DESTINATION_ENDPOINT: o URI do ponto final de destino, por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para a flag --destination-gke-master-cluster.

• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP. A predefinição é a porta 80.

• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

API

Use o método 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",
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, por exemplo, projects/myproject/locations/us-central1/revisions/cloudrun-revision.

• DESTINATION_RESOURCE_FIELD: o campo que especifica o tipo de recurso de serviço gerido pela Google.

  Para ver as opções disponíveis, consulte o seguinte:

  • gkeMasterCluster
  • cloudSqlInstance
  • redisInstance
  • redisCluster

  Para mais informações, consulte a Referência de pontos finais.

• DESTINATION_ENDPOINT: o URI do ponto final de destino, por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1, para o campo gkeMasterCluster.

• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP. A predefinição é a porta 80.

• PROTOCOL: os protocolos de rede suportados pelos conetores do Acesso a VPC sem servidor: TCP ou UDP.

Teste de uma rede de VPC para uma rede nãoGoogle Cloud

Para testar a partir de uma rede de VPC para uma rede que não seja deGoogle Cloud VPC, siga estes passos.

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Para Origem, selecione Endereço IP e, de seguida, introduza um endereço IP.
   1. Se a rede VPC estiver noutro projeto, selecione Este é um endereço IP usado no Google Cloud. Em seguida, no campo Endereço IP de origem ou projeto de serviço, selecione o projeto onde a rede está localizada.
   2. Se o seu endereço IP privado estiver fora do espaço de endereço RFC 1918, selecione a caixa com a etiqueta Confirmo que o ponto final de origem reside num intervalo fora do espaço de endereço RFC 1918 e selecione a rede de origem que contém o endereço IP.
6. Para Destino, selecione Endereço IP e, de seguida, introduza um endereço IP externo.
7. Claro Este é um endereço IP usado no Google Cloud.
8. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
9. Clique em Criar.
10. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Introduza o seguinte comando para testar entre um endereço IP interno e externo. Substitua as variáveis das opções de comando por valores da sua rede VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK: o URI da rede VPC onde o endereço IP de origem está localizado, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Não tem de confirmar se o seu endereço IP está em Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereço RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e de destino.

API

Este exemplo testa a capacidade de enviar um ping do endereço IP de origem para o endereço IP de destino.

Use o método 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".
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK: o URI da rede VPC onde se encontra o endereço IP de origem, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Python

O código de exemplo seguinte cria um teste entre dois endereços IP. Para mais informações, consulte create na biblioteca cliente de APIs Google para Python.

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_IP_PROJECT_ID: o ID do projeto do endereço IP de origem.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Não tem de confirmar se o seu endereço IP está em Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereço RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e de destino.

O exemplo seguinte cria um teste entre dois endereços IP:

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK_TYPE: o tipo de rede onde a origem está localizada. Neste caso, use um valor de GCP_NETWORK.
• DESTINATION_IP_ADDRESS: o endereço IP do destino
• DESTINATION_PORT: o número da porta TCP ou UDP de destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Teste a partir de um raio da VPC para outro raio da VPC ligado ao mesmo hub do Network Connectivity Center

Para testar a partir de um raio da VPC num hub do Network Connectivity Center para outro raio da VPC ligado ao mesmo hub, siga estes passos.

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Em Origem, selecione Endereço IP e, de seguida, introduza o endereço IP da rede de VPC do spoke de origem.
6. Para Destino, selecione Endereço IP e, de seguida, introduza o endereço IP noutra rede VPC spoke que está a testar.
7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.
8. Clique em Criar.
9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Introduza o seguinte comando para testar entre dois raios. Substitua as variáveis das opções de comando por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK: o URI da rede VPC onde o endereço IP de origem está localizado, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_IP_ADDRESS: o endereço IP de destino noutra rede VPC spoke que está a testar.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Não tem de confirmar se o seu endereço IP está em Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereço RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e de destino.

API

Este exemplo testa a capacidade de enviar um ping do endereço IP de origem para o endereço IP de destino.

Use o método 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".
  }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK: o URI da rede VPC onde se encontra o endereço IP de origem, por exemplo, projects/myproject/global/networks/default.
• DESTINATION_IP_ADDRESS: o endereço IP de destino noutra rede VPC spoke que está a testar.
• DESTINATION_PORT: o número da porta TCP ou UDP de destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Python

O código de exemplo seguinte cria um teste entre dois endereços IP. Para mais informações, consulte o método create na biblioteca cliente da API Google para Python.

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_IP_PROJECT_ID: o ID do projeto do endereço IP de origem
• DESTINATION_IP_ADDRESS: o endereço IP de destino noutra rede VPC spoke que está a testar.
• DESTINATION_PORT: o número da porta TCP ou UDP de destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Não tem de confirmar se o seu endereço IP está em Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereço RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e de destino.

O exemplo seguinte cria um teste entre dois endereços IP:

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK_TYPE: o tipo de rede onde a origem está localizada. Neste caso, use um valor de GCP_NETWORK.
• DESTINATION_IP_ADDRESS: o endereço IP da VM de destino.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Teste de uma VM para uma rede que não seja doGoogle Cloud

Este teste analisa a conetividade da VM de origem para uma localização na periferia da rede Google.

Nota: se o seu destino for um endereço IP pertencente à Google ou um endereço IP usado em Google Cloud, os resultados da análise do plano de dados em direto não são apresentados porque o pacote não sai da rede Google. Por exemplo, se o seu destino for um endereço IP pertencente à Google, como 8.8.8.8, os resultados da análise do plano de dados em direto não são apresentados.

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.

5. Para a Origem, faça o seguinte:

   1. No menu Ponto final de origem, selecione Instância de VM.
   2. No menu Instância de VM de origem, selecione a instância de VM de origem específica.

   3. No menu Interface de rede de origem, selecione a interface de rede.

      Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM que identifique exclusivamente a localização de origem.

   4. Opcional: selecione o Endereço IP de origem na lista. A predefinição é o endereço IP da instância de VM de origem.

6. Para Destino, faça o seguinte:

   1. No menu Ponto final de destino, selecione Endereço IP.
   2. Introduza um endereço IP de destino externo.
   3. Claro Este é um endereço IP usado no Google Cloud.

7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

8. Clique em Criar.

9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Para testar entre uma VM e um endereço IP externo, introduza o seguinte comando. Substitua os valores de exemplo por valores da sua rede de VPC.

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

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste; o endereço IP deve ser um dos endereços IP da instância de VM de origem.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

API

O seguinte teste de exemplo determina se a configuração de rede existente permite que a VM instance1envie um ping para o endereço IP de destino.

Use o método 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",
   }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Python

O código de exemplo seguinte cria um teste entre uma instância de VM e um endereço IP externo. Para mais informações, consulte create na biblioteca cliente da API Google para Python.

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

Substitua o seguinte:

• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer testes.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Teste a partir de uma VM ou de um endereço IP para um equilibrador de carga

Esta secção descreve como testar a conetividade de uma VM ou de um endereço IP a um Google Cloud equilibrador de carga.

A análise da configuração dos testes de conetividade suporta a monitorização de pacotes simulados para todos os tipos de Google Cloud equilibradores de carga. O caminho de rastreio de um balanceador de carga de aplicações externo também se aplica a balanceadores de carga de rede de proxy externos. Para mais informações, consulte a Vista geral do Cloud Load Balancing.

Pode testar a conetividade com o seguinte:

• Balanceador de carga de aplicações externo
• Balanceador de carga de aplicações interno
• Balanceador de carga de rede de encaminhamento externo
• Balanceador de carga de rede de passagem interno
• Balanceador de carga de rede de proxy externo

Teste de uma VM para um balanceador de carga

Esta secção analisa a conetividade da VM de origem a um equilibrador de carga.

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.

5. Para a Origem, faça o seguinte:

   1. No menu Ponto final de origem, selecione Instância de VM.
   2. No menu Instância de VM de origem, selecione a instância de VM de origem específica.

   3. No menu Interface de rede de origem, selecione a interface de rede.

      Se a instância de VM tiver várias interfaces de rede, selecione uma interface de rede de VM que identifique exclusivamente a localização de origem.

   4. Opcional: selecione o Endereço IP de origem na lista. A predefinição é o endereço IP da instância de VM de origem.

6. Para Destino, faça o seguinte:

   1. No menu Ponto final de destino, selecione Balanceador de carga.

   2. No menu Destination Load Balancer, selecione o equilibrador de carga.

      Se o ponto final de destino estiver num projeto diferente do projeto atual, selecione O ponto final está num projeto diferente de "PROJECT_NAME". Em seguida, no campo Projeto do ponto final de destino, selecione o projeto onde o ponto final está localizado.

   3. Selecione a regra de encaminhamento de destino.

      Nota: um equilibrador de carga pode ter várias configurações de front-end e cada configuração é representada por uma regra de encaminhamento. Para uma compreensão geral das regras de encaminhamento, consulte o artigo Vista geral das regras de encaminhamento.

7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

8. Clique em Criar.

9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Para testar entre uma VM e um balanceador de carga, introduza o seguinte comando.

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 \

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo com o qual está a fazer o teste.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.

API

Use o método 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",
   }'

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.
• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• DESTINATION_FORWARDING_RULE: a regra de encaminhamento de destino que representa o ponto final.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Python

O código de exemplo seguinte cria um teste entre uma instância de VM e um ponto final do equilibrador de carga. Para mais informações, consulte create na biblioteca cliente da API Google para Python.

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

Substitua o seguinte:

• SOURCE_INSTANCE: o URI da VM de origem, por exemplo, projects/myproject/zones/us-east1-b/instances/instance-1.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
• DESTINATION_FORWARDING_RULE: a regra de encaminhamento de destino que representa o ponto final.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Teste a partir de um endereço IP para um balanceador de carga

Consola

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione Criar teste de conetividade.
3. No campo Nome do teste, introduza um nome para o teste.
4. Na lista Protocolo, selecione um protocolo.
5. Para Origem, faça o seguinte:
   1. No menu Ponto final de origem, selecione Endereço IP.
   2. No campo Endereço IP de origem, introduza o endereço IP de origem.
      1. Se a rede VPC estiver noutro projeto, selecione Este é um endereço IP usado em Google Cloud. Em seguida, no campo Endereço IP de origem ou projeto de serviço, selecione o projeto onde a rede está localizada.
      2. Se o endereço IP estiver fora do espaço de endereço RFC 1918, selecione Confirmo que o ponto final de origem reside num intervalo fora do espaço de endereço RFC 1918. Em seguida, na lista Rede de origem, selecione a rede que contém o endereço IP de origem.

6. Para Destino, faça o seguinte:

   1. No menu Ponto final de destino, selecione Balanceador de carga.

   2. No menu Destination Load Balancer, selecione o ponto final do balanceador de carga.

      Se o ponto final de destino estiver num projeto diferente do projeto atual, selecione O ponto final está num projeto diferente de "PROJECT_NAME". Em seguida, no campo Projeto do ponto final de destino, selecione o projeto onde o ponto final está localizado.

   3. Selecione a regra de encaminhamento de destino.

      Nota: um equilibrador de carga pode ter várias configurações de front-end e cada configuração é representada por uma regra de encaminhamento. Para uma compreensão geral das regras de encaminhamento, consulte o artigo Conceitos de regras de encaminhamento.

7. No campo Porta de destino, introduza uma porta de destino para o destino especificado.

8. Clique em Criar.

9. Após a conclusão do teste, a página principal Testes de conetividade é carregada e apresenta uma lista que contém este teste e outros testes. Continue para Ver resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo por valores da sua rede de VPC.

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 \

Substitua o seguinte:

• NAME: o nome do teste de conetividade.
• SOURCE_PROJECT: o ID do projeto do ponto final de origem.
• SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem a partir da qual está a fazer o teste. O endereço IP deve ser um dos endereços IP da instância de VM de origem.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• DESTINATION_IP_ADDRESS: o endereço IP de destino externo para o qual está a fazer o teste.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.

Se o ponto final for usado para aceder a serviços geridos ou serviços noutra rede VPC, tem de especificar o DESTINATION_NETWORK porque o ponto final tem um endereço IP interno.

API

Este exemplo testa a capacidade de enviar um ping do endereço IP de origem para um ponto final do balanceador de carga.

Use o método projects.locations.global.connectivityTests.create.

Quando especifica um endereço IP de origem que é um endereço IP externo fora de Google Cloud, tem de especificar um networkType de NON_GCP_NETWORK. Substitua os valores no seguinte comando por valores da sua Google Cloud rede.

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• DESTINATION_FORWARDING_RULE: a regra de encaminhamento de destino que representa o ponto final.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.

Se o ponto final for usado para aceder a serviços publicados, tem de especificar o DESTINATION_NETWORK porque o ponto final tem um endereço IP interno.

Python

O código de exemplo seguinte cria um teste entre um endereço IP e um ponto final do equilibrador de carga. Para mais informações, consulte create na biblioteca cliente de APIs Google para Python.

Quando especifica um endereço IP de origem que é um endereço IP externo fora de Google Cloud, tem de especificar um networkType de NON_GCP_NETWORK.

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

Substitua o seguinte:

• SOURCE_IP_ADDRESS: o endereço IP de origem a partir do qual está a fazer o teste.
• SOURCE_NETWORK_TYPE: o tipo de rede onde a origem está localizada. Neste caso, use um valor de NON_GCP_NETWORK.
• DESTINATION_FORWARDING_RULE: a regra de encaminhamento de destino que representa o ponto final.
• DESTINATION_PORT: a porta do protocolo IP do destino. Esta opção só é válida para protocolos TCP ou UDP.
• DESTINATION_IP_PROJECT_ID: o ID do projeto do endereço IP de destino.
• PROTOCOL: um protocolo suportado para testes de conetividade. O protocolo predefinido é TCP.
• PROJECT_ID: o ID do projeto no qual está a criar o teste.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Se o ponto final for usado para aceder a serviços publicados, tem de especificar o DESTINATION_NETWORK porque o ponto final tem um endereço IP interno.

Não tem de confirmar se o seu endereço IP está dentro Google Cloud ou se os pontos finais de origem e destino estão fora do espaço de endereços RFC 1918. Estes parâmetros são selecionados automaticamente com base nos seus endereços IP de origem e destino.

Teste de uma rede que não seja deGoogle Cloud para uma rede de VPC

Este procedimento é igual ao procedimento Teste entre endereços IP privados numa rede da VPC , exceto nos seguintes passos. Use este procedimento para a Google Cloud consola, a CLI Google Cloud, exemplos de API e exemplos de Python.

1. Se o endereço de origem não estiver localizado em Google Cloud , mas não for da sua rede de pares (no local), especifique um endereço IP externo.
2. Se o endereço de origem for da sua rede de pares (no local), tem de selecionar Outra rede não pertencente ao Google Cloud.

Teste de uma rede nãoGoogle Cloud para uma rede nãoGoogle Cloud

Este procedimento é igual ao procedimento Teste entre endereços IP privados numa rede da VPC , exceto nos seguintes passos. Use este procedimento para a Google Cloud consola, a CLI Google Cloud, exemplos de API e exemplos de Python.

1. Especifique endereços IP externos para o endereço IP de origem e o endereço IP de destino.
2. Na Google Cloud consola, limpe Este é um endereço IP usado no Google Cloud.

Veja os resultados do teste

Esta secção descreve como ver os resultados de um teste de conetividade.

Consola

Pode ver um teste a partir de várias páginas diferentes.

A partir da página principal de testes de conetividade

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Na coluna Detalhes dos resultados, escolha um teste e, de seguida, clique em Ver.

3. É apresentado o painel de informações do teste. Pode ver o resultado geral e os cartões de resultados de cada Google Cloud recurso no caminho de teste. Pode clicar num link para a página de detalhes de alguns Google Cloud recursos, como instâncias de VM ou rotas. Se o teste contiver várias rastreios, pode selecionar um rastreio na lista Resultado do rastreio.

   Se o teste for elegível para a análise do plano de dados em direto, pode ver as métricas de perda de pacotes e latência.

4. Para expandir ou fechar um cartão de resultados, clique na seta à direita do cartão.

5. Para interpretar os resultados dos testes, consulte os Estados de análise da configuração.

6. Para fechar o painel de informações, clique em Ocultar painel de informações na parte superior direita da página.

Na página de detalhes do teste de conetividade

Em alternativa, na página principal da consola Google Cloud , clique no nome de um teste e veja os respetivos resultados na página Detalhes do teste de conetividade.

Na página de detalhes da interface de rede

Também pode ver os resultados na página Detalhes da interface de rede para uma interface de rede de uma instância de VM do Compute Engine. Esta página apenas apresenta testes que usam a interface de rede atual como origem ou destino.

Para ver os resultados, pode selecionar Ver na coluna Detalhes dos resultados ou clicar no nome do teste.

gcloud

Para ver os resultados de um teste, introduza o seguinte comando. Use o ID de teste que quer ver.

gcloud network-management connectivity-tests describe NAME

Substitua NAME pelo nome do teste de conectividade.

API

Use o método projects.locations.global.connectivityTests.get para ver os resultados de um teste.

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

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Python

O seguinte exemplo de código imprime os resultados de um teste. Para mais informações, consulte get na biblioteca cliente da API Google para Python.

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

Substitua o seguinte:

• PROJECT_ID: o ID do projeto no qual o teste foi criado.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Volte a executar um ou mais testes

Pode querer executar novamente um teste de conetividade se fizer alterações de configuração aos recursos do Google Cloud no caminho de teste e quiser ver os resultados da configuração de rede mais recente. Pode voltar a executar um ou mais testes em simultâneo.

Um teste de conetividade baseia-se num resumo da configuração de rede no momento da execução. A nova execução de um teste substitui os resultados do teste anterior. Se quiser preservar resultados mais antigos, crie um novo teste.

Para verificar o estado da operação de teste enquanto está em execução, consulte o artigo Verifique uma operação de teste em execução.rerun

Consola

A partir da página principal de testes de conetividade

1. Na Google Cloud consola, aceda à página Testes de conetividade

   Aceda a Testes de conetividade

2. Selecione um ou mais testes na lista de testes de conetividade disponíveis.
3. Clique em Executar novamente.

Na página de detalhes dos testes de conetividade

1. Na página principal Testes de conetividade anterior, clique no nome de um teste.
2. Na parte superior da página Detalhes do teste de conetividade, clique em Executar novamente.

Na página de detalhes da interface de rede

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Se ainda não estiver selecionado, selecione o projeto que contém a instância para a qual quer executar novamente um teste.
3. Clique na instância que quer usar para executar novamente um teste.
4. Para Interfaces de rede, selecione a interface de rede que quer usar para executar novamente um teste.
5. Para a Análise de rede, clique em Testes de conetividade.
6. Selecione um ou mais testes na lista de testes de conetividade disponíveis.
7. Clique em Executar novamente.

gcloud

Para executar novamente um teste de conetividade, introduza o seguinte comando. Use o ID do teste que quer executar novamente.

gcloud network-management connectivity-tests rerun NAME

Substitua NAME pelo nome do teste de conectividade.

API

Quando a API Network Management cria um recurso connectivityTests, retém esse recurso de teste até que o elimine. Por este motivo, pode executar novamente os testes.

Se não quiser criar testes persistentes, pode usar a API para criar um teste e eliminá-lo depois de ver o resultado do teste.

Use o método projects.locations.global.connectivityTests.rerun para executar novamente um teste.

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

Substitua o seguinte:

• PROJECT_ID: o ID do projeto da VM de origem.
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar.

Python

O exemplo de código seguinte volta a executar um teste. Para mais informações, consulte rerun na biblioteca cliente da API Google para Python.

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

Substitua os seguintes valores:

• PROJECT_ID: o ID do projeto no qual o teste foi criado
• TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar

O que se segue?

• Estados da análise da configuração
• Resolva problemas com os testes de conetividade