Criar um Cloud Router para conectar uma rede VPC a uma de peering

gcloud

Para usar os exemplos de linha de comando deste guia:

1. Instale ou atualize para a versão mais recente da Google Cloud CLI.
2. Defina uma região e uma zona padrão.

API

Para usar os exemplos da API deste guia, configure o acesso a ela.

Console

1. No console Google Cloud , acesse a página Criar um Cloud Router.

   Acesse Criar um Cloud Router.

2. Especifique os detalhes do Cloud Router:

• Nome: o nome do Cloud Router. Esse nome é exibido no console Google Cloud e é usado pela Google Cloud CLI para fazer referência ao Cloud Router. Por exemplo, my-router.
• Descrição (opcional): uma descrição do Cloud Router.
• Rede: a rede VPC que contém as instâncias que você quer alcançar, por exemplo, my-network.
• Região: a região em que você quer localizar o Cloud Router, por exemplo, asia-east1.

• ASN do Google: qualquer ASN privado (64512-65534, 4200000000-4294967294) que você ainda não usa na rede local. O Cloud Router exige o uso de um ASN privado, mas seu ASN local pode ser público ou privado.

• Intervalo de sinal de atividade do BGP: o intervalo entre duas mensagens de sinal de atividade sucessivas do BGP enviadas para o roteador de mesmo nível. Esse valor precisa ser um número inteiro entre 20 e 60 que especifique o número de segundos do intervalo. O padrão é 20 segundos. Para mais informações, consulte Como gerenciar timers do BGP.

• Identificador do BGP: opcional. O identificador do BGP, às vezes chamado de ID de roteador, que identifica exclusivamente um Cloud Router em uma rede. Se omitido, os Cloud Routers com sessões IPv4 do BGP usam um dos endereços IPv4 do BGP como identificador do BGP, e adicionar a primeira interface IPv6 a esse Cloud Router preenche o campo automaticamente.

  Para mais informações, consulte Configurar o intervalo do identificador do BGP para um Cloud Router.

3. Opcional: para especificar rotas divulgadas personalizadas, acesse a seção Rotas anunciadas. Para saber mais, consulte Rotas anunciadas.
   1. Para especificar Rotas personalizadas, selecione Criar rotas personalizadas.
   2. Escolha se você quer divulgar as sub-redes visíveis para o Cloud Router. A ativação dessa opção imita o comportamento padrão do Cloud Router.
   3. Para adicionar uma rota divulgada, selecione Adicionar rota personalizada e configure-a.
4. Para salvar as configurações e criar um Cloud Router, clique em Criar. Seu novo roteador do Cloud Router é exibido na página de listagem do Cloud Router. Para visualizar os detalhes e configurar uma sessão do BGP, selecione-a.

gcloud

O comando gcloud compute routers create cria um novo Cloud Router. Um Cloud Router é associado a uma rede VPC ou a um spoke do gateway do NCC. Depois de criada, não é possível mudar a região, a rede VPC associada ou o spoke do gateway do NCC associado.

A flag --set-advertisement-groups=ALL_SUBNETS só é válida quando a flag --advertisement-mode=CUSTOM está definida. Quando essa flag e esse valor são especificados, as divulgações no nível do roteador incluem intervalos de sub-rede local de acordo com o modo de roteamento dinâmico da rede VPC.

Para mais informações, consulte Anúncio de intervalo de sub-rede.

Inclua a flag --encrypted-interconnect-router somente se o Cloud Router gerenciar sessões do BGP para a VPN de alta disponibilidade pelo Cloud Interconnect.

• Para criar um Cloud Router associado a uma região de uma rede VPC, use o seguinte comando:

  gcloud compute routers create ROUTER_NAME \
      --project=PROJECT_ID \
      --network=NETWORK \
      --region=REGION\
      --asn=ASN_NUMBER \
      [--advertisement-mode=ADVERTISEMENT_MODE] \
      [--set-advertisement-groups=ALL_SUBNETS] \
      [--set-advertisement-ranges=CUSTOM_ADVERTISED_RANGES] \
      [--bgp-identifier-range=ROUTER_IDENTIFIER_RANGE] \
      [--keepalive-interval=KEEPALIVE_TIMER] \
      [--encrypted-interconnect-router]
  

  Substitua:

  • ROUTER_NAME: o nome do Cloud Router

  • PROJECT_ID: o ID do projeto que contém o Cloud Router

  • NETWORK: a rede VPC que contém o Cloud Router

  • REGION: a região que contém o Cloud Router

  • ASN_NUMBER: qualquer ASN particular (64512-65534, 4200000000-4294967294) que você ainda não use na rede local.

    O Cloud Router exige que você use um ASN particular, mas o ASN local pode ser público ou privado.

  • ADVERTISEMENT_MODE: especifica o modo de anúncio no nível do roteador

    Os valores válidos são CUSTOM ou DEFAULT. Se você omitir a sinalização --advertisement-mode, Google Cloud usará o modo de divulgação DEFAULT no nível do roteador. Para saber mais sobre o significado do modo de divulgação no nível do roteador e o efeito dele nas divulgações de sessão do BGP, consulte Modos de divulgação e Divulgações eficazes.

  • CUSTOM_ADVERTISED_RANGES: válido apenas quando --advertisement-mode=CUSTOM, uma lista opcional de intervalos de endereços IP personalizados no formato CIDR ou endereços IP individuais para serem incluídos nas propagandas no nível do roteador

    Endereços IPv4 individuais são interpretados como um CIDR com uma máscara de sub-rede /32, e endereços IPv6 individuais são interpretados como um CIDR com uma máscara de sub-rede /128. Para informações sobre o número máximo de divulgações de rota personalizadas, consulte Limites.

  • ROUTER_IDENTIFIER_RANGE: um intervalo de endereços IPv4 opcional que serve como um identificador exclusivo para o Cloud Router

    Para mais informações, consulte Configurar o intervalo do identificador do BGP.

  • KEEPALIVE_TIMER: um tempo opcional, em segundos, que define o timer de keepalive do BGP

    Os valores válidos estão entre 20 e 60, inclusive. Se você omitir a flag --keepalive-interval, o Cloud Router vai usar um temporizador de keepalive do BGP de 20 segundos. Para mais informações, consulte Timer de sinal de atividade.

• Para criar um Cloud Router associado a um spoke do gateway do NCC, use o seguinte comando.

  Use a flag --advertisement-mode=CUSTOM para definir o modo de divulgação no roteador como CUSTOM e especificar divulgações de rota personalizadas no roteador.

  Para saber mais sobre o efeito do modo de divulgação no nível do roteador em divulgações de sessão do BGP individuais, consulte Divulgações eficazes.

  gcloud compute routers create ROUTER_NAME \
      --project=PROJECT_ID \
      --ncc-gateway=NCC_GATEWAY_URI \
      --region=REGION\
      --asn=ASN_NUMBER \
      --advertisement-mode=CUSTOM \
      --set-advertisement-ranges=CUSTOM_ADVERTISED_RANGES \
      [--bgp-identifier-range=ROUTER_IDENTIFIER_RANGE] \
      [--keepalive-interval=KEEPALIVE_TIMER] \
  

  Substitua:

  • ROUTER_NAME: o nome do Cloud Router

  • PROJECT_ID: o ID do projeto que contém o Cloud Router

  • NCC_GATEWAY_URI: o URI completo do gateway NCC associado ao roteador. O formato do URI segue este padrão: https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/GATEWAY_SPOKE_NAME

  • REGION: a região que contém o Cloud Router

  • ASN_NUMBER: qualquer ASN particular (64512-65534, 4200000000-4294967294) que você ainda não use na rede local.

    O Cloud Router exige que você use um ASN particular, mas o ASN local pode ser público ou privado.

  • --advertisement-mode=CUSTOM: define o modo de divulgação no roteador como CUSTOM para que você possa especificar divulgações de rota personalizadas no nível do roteador.

    Para saber mais sobre o efeito do modo de divulgação no nível do roteador em divulgações de sessão do BGP individuais, consulte Divulgações eficazes.

  • CUSTOM_ADVERTISED_RANGES: a lista de intervalos de endereços IP personalizados no formato CIDR ou endereços IP individuais a serem incluídos nas propagandas no nível do roteador

    Endereços IPv4 individuais são interpretados como um CIDR com uma máscara de sub-rede /32, e endereços IPv6 individuais são interpretados como um CIDR com uma máscara de sub-rede /128. Para informações sobre o número máximo de divulgações de rota personalizadas, consulte Limites.

  • ROUTER_IDENTIFIER_RANGE: um intervalo de endereço IPv4 opcional que serve como um identificador exclusivo do Cloud Router

    Para mais informações, consulte Configurar o intervalo do identificador do BGP.

  • KEEPALIVE_TIMER: um tempo opcional, em segundos, que define o timer de keepalive do BGP

    Os valores válidos estão entre 20 e 60, inclusive. Se você omitir a flag --keepalive-interval, o Cloud Router vai usar um temporizador de keepalive do BGP de 20 segundos. Para mais informações, consulte Timer de sinal de atividade.

Terraform

Use o móduloGoogle Cloud do Terraform para o Cloud Router.

module "cloud_router" {
  source  = "terraform-google-modules/cloud-router/google"
  version = "~> 7.0"

  name   = "my-router"
  region = "us-central1"

  bgp = {
    # The ASN (16550, 64512 - 65534, 4200000000 - 4294967294) can be any private ASN
    # not already used as a peer ASN in the same region and network or 16550 for Partner Interconnect.
    asn = "65001"
  }

  project = var.project_id
  network = module.vpc.network_name
}

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

API

O método routers.insert cria um novo Cloud Router. Um Cloud Router é associado a uma rede VPC ou a um spoke do gateway do NCC. Depois de criada, não é possível mudar a região, a rede VPC associada ou o spoke do gateway do NCC associado.

A flag "advertisedGroups": [ALL_SUBNETS] é válida apenas quando bgp.advertiseMode: CUSTOM, quando bgp.advertisedGroups: [ALL_SUBNETS], as divulgações no nível do roteador incluem intervalos de sub-rede locais de acordo com o modo de roteamento dinâmico da rede VPC. Para mais informações, consulte Anúncio de intervalo de sub-rede.

A flag encryptedInterconnectRouter é um parâmetro booleano para indicar se o Cloud Router gerencia sessões do BGP para VPN de alta disponibilidade pelo Cloud Interconnect.

• Para criar um Cloud Router associado a uma região de uma rede VPC, use a seguinte solicitação:

       POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers
       {
         "name": "ROUTER_NAME",
         "network": "NETWORK",
         "encryptedInterconnectRouter": True|False,
         "bgp": {
           "asn": "ASN_NUMBER",
           "advertiseMode": "ADVERTISEMENT_MODE",
           "advertisedGroups": [ALL_SUBNETS],
           "advertisedIpRanges": [
              {
                 "range": CUSTOM_ADVERTISED_RANGE,
                 "description": CUSTOM_ADVERTISED_RANGE_DESCRIPTION
              }, ...
           ],
           "identifierRange": ROUTER_IDENTIFIER_RANGE,
           "keepaliveInterval": KEEPALIVE_TIMER
         }
       }
  

  Substitua:

  • ROUTER_NAME: o nome do Cloud Router

  • PROJECT_ID: o ID do projeto que contém o Cloud Router

  • NETWORK: a rede VPC que contém o Cloud Router

  • REGION: a região que contém o Cloud Router

  • ASN_NUMBER: qualquer ASN particular (64512-65534, 4200000000-4294967294) que você ainda não use na rede local.

    O Cloud Router exige que você use um ASN particular, mas o ASN local pode ser público ou privado.

  • ADVERTISEMENT_MODE: especifica o modo de anúncio no nível do roteador

    Os valores válidos são CUSTOM ou DEFAULT. Se você omitir bgp.advertiseMode, Google Cloud usará o modo de divulgação DEFAULT no nível do roteador. Para saber mais sobre o significado do modo de divulgação no nível do roteador e o efeito dele em divulgações de sessão BGP individuais, consulte Modos de divulgação e Divulgações eficazes.

  • CUSTOM_ADVERTISED_RANGE e CUSTOM_ADVERTISED_RANGE_DESCRIPTION: chaves em um dicionário que especificam uma divulgação de rota personalizada no nível do roteador

    bgp.advertisedIpRanges é a lista que contém cada dicionário de publicidade de rota personalizada. A especificação de bgp.advertisedIpRanges requer bgp.advertiseMode: CUSTOM. Cada CUSTOM_ADVERTISED_RANGE é um intervalo de endereços IP no formato CIDR ou um endereço IP individual. Endereços IPv4 individuais são interpretados como um CIDR com uma máscara de sub-rede /32, e endereços IPv6 individuais são interpretados como um CIDR com uma máscara de sub-rede /128. Para informações sobre o número máximo de anúncios de rota personalizados, consulte Limites. Cada CUSTOM_ADVERTISED_RANGE_DESCRIPTION é uma string para descrever o anúncio.

  • ROUTER_IDENTIFIER_RANGE: define um intervalo de endereços IPv4 que serve como um identificador exclusivo para o Cloud Router.

    Para mais informações, consulte Configurar o intervalo do identificador do BGP.

  • KEEPALIVE_TIMER: um tempo opcional, em segundos, que define o timer de keepalive do BGP

    Os valores válidos estão entre 20 e 60, inclusive. Se você omitir bgp.keepaliveInterval, o Cloud Router vai usar um temporizador de keepalive do BGP de 20 segundos. Para mais informações, consulte Timer de sinal de atividade.

  • encryptedInterconnectRouter: um parâmetro booleano para indicar se o Cloud Router gerencia sessões do BGP para VPN de alta disponibilidade pelo Cloud Interconnect.

• Para criar um Cloud Router associado a um spoke do Gateway do NCC, use a seguinte solicitação.

  A flag bgp.advertiseMode: CUSTOM define o modo de divulgação no roteador como CUSTOM para que você possa especificar divulgações de rota personalizadas no nível do roteador. Para saber mais sobre o efeito do modo de divulgação no nível do roteador em divulgações de sessão do BGP individuais, consulte Divulgações eficazes.

       POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers
       {
         "name": "ROUTER_NAME",
         "ncc_gateway": "NCC_GATEWAY_URI",
         "bgp": {
           "asn": "ASN_NUMBER",
           "advertiseMode": CUSTOM,
           "advertisedIpRanges": [
              {
                 "range": CUSTOM_ADVERTISED_RANGE,
                 "description": CUSTOM_ADVERTISED_RANGE_DESCRIPTION
              }, ...
           ],
           "identifierRange": ROUTER_IDENTIFIER_RANGE,
           "keepaliveInterval": KEEPALIVE_TIMER
         }
       }
  

  Substitua:

  • ROUTER_NAME: o nome do Cloud Router

  • PROJECT_ID: o ID do projeto que contém o Cloud Router

  • NCC_GATEWAY_URI: o URI completo do gateway NCC associado ao roteador. O formato do URI segue este padrão: https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/GATEWAY_SPOKE_NAME

  • REGION: a região que contém o Cloud Router

  • ASN_NUMBER: qualquer ASN particular (64512-65534, 4200000000-4294967294) que você ainda não use na rede local.

    O Cloud Router exige que você use um ASN particular, mas o ASN local pode ser público ou privado.

  • CUSTOM_ADVERTISED_RANGE e CUSTOM_ADVERTISED_RANGE_DESCRIPTION: chaves em um dicionário que especificam uma divulgação de rota personalizada no nível do roteador

    bgp.advertisedIpRanges é a lista que contém cada dicionário de publicidade de rota personalizada. A especificação de bgp.advertisedIpRanges requer bgp.advertiseMode: CUSTOM. Cada CUSTOM_ADVERTISED_RANGE é um intervalo de endereços IP no formato CIDR ou um endereço IP individual. Endereços IPv4 individuais são interpretados como um CIDR com uma máscara de sub-rede /32, e endereços IPv6 individuais são interpretados como um CIDR com uma máscara de sub-rede /128. Para informações sobre o número máximo de divulgações de rota personalizadas, consulte Limites. Cada CUSTOM_ADVERTISED_RANGE_DESCRIPTION é uma string para descrever o anúncio.

  • ROUTER_IDENTIFIER_RANGE: define um intervalo de endereços IPv4 que serve como um identificador exclusivo para o Cloud Router

    Para mais informações, consulte Configurar o intervalo do identificador do BGP.

  • KEEPALIVE_TIMER: um tempo opcional, em segundos, que define o timer de keepalive do BGP

    Os valores válidos estão entre 20 e 60, inclusive. Se você omitir bgp.keepaliveInterval, o Cloud Router vai usar um temporizador de keepalive do BGP de 20 segundos. Para mais informações, consulte Timer de sinal de atividade.