Anuncie intervalos de endereços personalizados

Use o modo de publicidade personalizado num Cloud Router ou numa sessão do Border Gateway Protocol (BGP) num Cloud Router para anunciar intervalos de endereços IP que não sejam os intervalos de endereços IP de sub-redes da sua rede de nuvem virtual privada (VPC). Por exemplo, pode anunciar intervalos de endereços IP externos, intervalos de endereços IP internos arbitrários ou endereços IP internos de intervalos de endereços IP de outras redes VPC que estejam ligadas à sua rede VPC. A sua rede VPC pode estar ligada através do intercâmbio da rede da VPC ou de hubs da VPC no Centro de conetividade de rede.

Quando um Cloud Router está configurado para usar o modo de anúncio predefinido, apenas anuncia rotas para sub-redes que fazem parte da mesma rede VPC que o Cloud Router. Neste modo, o Cloud Router exclui todos os trajetos estáticos e trajetos aprendidos dinamicamente a partir de outras redes VPC, como trajetos aprendidos pelo intercâmbio da rede da VPC ou por hubs da VPC no Centro de conetividade de rede.

Para especificar rotas anunciadas personalizadas quando cria um Cloud Router ou configura uma sessão BGP, consulte os artigos Crie Cloud Routers ou Estabeleça sessões BGP.

Antes de começar

gcloud

Se quiser usar os exemplos de linhas de comandos neste guia, faça o seguinte:

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

API

Se quiser usar os exemplos de API neste guia, configure o acesso à API.

Especifique rotas anunciadas personalizadas num Cloud Router

Para especificar rotas anunciadas personalizadas num Cloud Router existente, siga estes passos.

Consola

  1. Na Google Cloud consola, aceda à página Routers na nuvem.

    Aceder aos Cloud Routers

  2. Selecione o Cloud Router a atualizar.

  3. Na página Detalhes do router, clique em Editar.

  4. Na secção Rotas anunciadas, para Rotas, selecione Criar rotas personalizadas.

  5. Selecione a caixa de verificação Anunciar todas as sub-redes visíveis para o Cloud Router para continuar a anunciar as sub-redes disponíveis para o Cloud Router. A ativação desta opção imita o comportamento do Cloud Router no modo de anúncio predefinido.

  6. Selecione Adicionar trajeto personalizado para adicionar um trajeto anunciado.

  7. Configure os encaminhamentos anunciados personalizados:

    • Origem: selecione Intervalo de IP personalizado.

    • Intervalo de endereços IP: use a notação CIDR para especificar o intervalo de IP personalizado.

      Pode especificar intervalos de IP personalizados IPv4 e IPv6. No entanto, os intervalos personalizados IPv6 são anunciados apenas em sessões BGP onde o IPv6 está ativado.

      Se fornecer um prefixo de endereço IP sem uma máscara de sub-rede, é interpretado como uma máscara de sub-rede /32 para IPv4 e /128 para IPv6. Para ver informações sobre o número máximo de rotas aprendidas personalizadas que pode ter, consulte a secção Limites.

    • Descrição: adicione uma descrição para ajudar a identificar a finalidade deste trajeto anunciado personalizado e, de seguida, clique em Concluído.

  8. Depois de terminar de adicionar rotas anunciadas personalizadas, clique em Guardar.

gcloud

Execute o comando update. Para especificar os intervalos de IP personalizados, use a flag --set-advertisement-ranges ou a flag --add-advertisement-ranges.

  1. Use a flag --set-advertisement-ranges; todos os anúncios personalizados existentes são substituídos:

    gcloud compute routers update ROUTER_NAME \
       --project=PROJECT_ID \
       --advertisement-mode custom \
       --set-advertisement-groups=ADVERTISED_GROUPS \
       --set-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Substitua o seguinte:

    • ROUTER_NAME: o nome do Cloud Router
    • PROJECT_ID: o projeto que contém o Cloud Router
    • ADVERTISED_GROUPS: um grupo definido pela Google que o Cloud Router anuncia dinamicamente

      O único valor válido é all_subnets, que anuncia sub-redes com base no modo de encaminhamento dinâmico da rede VPC (semelhante ao modo de anúncio predefinido).

    • ADVERTISED_IP_RANGES: o conteúdo da nova matriz de intervalos de endereços IP

      Pode especificar intervalos de IP personalizados IPv4 e IPv6. No entanto, os intervalos personalizados IPv6 são anunciados apenas em sessões BGP onde o IPv6 está ativado.

      Se fornecer um prefixo de endereço IP sem uma máscara de sub-rede, é interpretado como uma máscara de sub-rede /32 para IPv4 e /128 para IPv6. Para obter informações sobre o número máximo de rotas aprendidas personalizadas que pode ter, consulte a secção Limites.

    O exemplo seguinte atualiza o my-router Cloud Router para anunciar todas as sub-redes e os intervalos de IP personalizados 192.0.2.0/24 e 198.51.100.0/24:

    gcloud compute routers update my-router \
       --advertisement-mode custom \
       --set-advertisement-groups=all_subnets \
       --set-advertisement-ranges='192.0.2.0/24,198.51.100.0/24'
    

    O exemplo seguinte atualiza o my-router Cloud Router para anunciar todas as sub-redes e o intervalo IPv6 predefinido:

    gcloud compute routers update my-router \
       --advertisement-mode custom \
       --set-advertisement-groups=all_subnets \
       --set-advertisement-ranges='2001:db8:abcd:12::/64'
    

    O Cloud Router anuncia intervalos IPv6 apenas em sessões BGP que estão ativadas para IPv6.

    A flag --set-advertisement-groups aceita grupos definidos pela Google que o Cloud Router anuncia dinamicamente. Pode remover a flag --set-advertisement-groups para excluir anúncios de sub-rede. Para ver uma lista de todos os grupos de anúncios, consulte a flag set-advertisement-groups na documentação do SDK da Google.

  2. Use a flag --add-advertisement-ranges, que requer que o modo de publicidade do Cloud Router já esteja definido como custom:

    gcloud compute routers update ROUTER_NAME \
       --add-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Substitua o seguinte:

    • ROUTER_NAME: o nome do Cloud Router
    • ADVERTISED_IP_RANGES: o conteúdo da nova matriz de intervalos de endereços IP

    O exemplo seguinte adiciona o endereço IP personalizado 203.0.113.1 aos anúncios do Cloud Router:

    gcloud compute routers update my-router \
       --add-advertisement-ranges='203.0.113.1'
    

    O exemplo seguinte adiciona o intervalo IPv6 personalizado 2001:db8:abcd:12::/64 aos anúncios do Cloud Router:

    gcloud compute routers update my-router \
       --add-advertisement-ranges='2001:db8:abcd:12::/64'
    

    O Cloud Router anuncia intervalos IPv6 apenas em sessões BGP que estão ativadas para IPv6.

API

Use o método routers.patch para atualizar os campos bgp.advertisedGroups[] e bgp.advertisedIpRanges[].

Os campos bgp.advertisedGroups[] e bgp.advertisedIpRanges[] armazenam matrizes de grupos anunciados e intervalos de endereços IP anunciados. Quando PATCH estes campos, substitui as matrizes existentes pelas novas no seu pedido.

  1. Envie um pedido GET para obter as matrizes atuais de grupos anunciados e intervalos de endereços IP anunciados no router. Para ver detalhes, consulte o artigo Veja a configuração da sessão BGP.

  2. Envie um pedido PATCH com novas matrizes de grupos anunciados e intervalos de endereços IP anunciados. Use as matrizes do pedido GET no passo anterior e adicione os grupos ou os intervalos de endereços IP que quer no router.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgp": {
        "advertisedGroups": [
        "ADVERTISED_GROUPS"
       ],
        "advertisedIpRanges": [
        ADVERTISED_IP_RANGES
       ]
     }
    }
    

    Substitua o seguinte:

    • PROJECT_ID: o projeto que contém o Cloud Router
    • REGION: a região onde o Cloud Router está localizado
    • ROUTER_NAME: o nome do Cloud Router
    • ADVERTISED_GROUPS: um grupo definido pela Google que o Cloud Router anuncia dinamicamente

    O único valor válido é ALL_SUBNETS, que anuncia sub-redes com base no modo de encaminhamento dinâmico da rede VPC (semelhante aos anúncios predefinidos).

    • ADVERTISED_IP_RANGES: o conteúdo da nova matriz de intervalos de endereços IP

    Pode especificar intervalos de IP personalizados IPv4 e IPv6. No entanto, os intervalos personalizados IPv6 são anunciados apenas em sessões BGP onde o IPv6 está ativado.

    Se fornecer um prefixo de endereço IP sem uma máscara de sub-rede, é interpretado como uma máscara de sub-rede /32 para IPv4 e /128 para IPv6. Para obter informações sobre o número máximo de rotas aprendidas personalizadas que pode ter, consulte a secção Limites.

    O exemplo seguinte contém dois intervalos de endereços IPv4 e um intervalo de endereços IPv6:

        {
          "range": "192.0.2.0/24",
          "description": "First example range"
        },
        {
          "range": "198.51.100.0/24",
          "description": "Second example range"
        },
        {
          "range": "2001:db8:abcd:12::/64",
          "description: "Third example range"
        }
    

Especifique rotas anunciadas personalizadas para uma sessão BGP

Para especificar rotas anunciadas personalizadas para uma sessão BGP existente, siga estes passos.

Consola

  1. Na Google Cloud consola, aceda à página Routers na nuvem.

    Aceder aos Cloud Routers

  2. Selecione o Cloud Router que contém a sessão BGP a atualizar.

  3. Na página Detalhes do router, selecione a sessão BGP que quer atualizar.

  4. Na página Detalhes da sessão BGP, clique em Editar.

  5. Para Trajetos, selecione Criar trajetos personalizados.

  6. Selecione a caixa de verificação Anunciar todas as sub-redes visíveis para o Cloud Router para continuar a anunciar as sub-redes disponíveis para o Cloud Router. A ativação desta opção imita o comportamento predefinido do router na nuvem.

  7. Selecione Adicionar trajeto personalizado para adicionar um trajeto anunciado.

  8. Configure o anúncio de trajeto:

    • Origem: selecione Intervalo de IP personalizado.

    • Intervalo de endereços IP: use a notação CIDR para especificar o intervalo de IP personalizado. Pode especificar intervalos de IP personalizados IPv4 e IPv6. No entanto, os intervalos personalizados IPv6 são anunciados apenas em sessões BGP onde o IPv6 está ativado.

      Se fornecer um prefixo de endereço IP sem uma máscara de sub-rede, é interpretado como uma máscara de sub-rede /32 para IPv4 e /128 para IPv6. Para informações sobre o número máximo de rotas aprendidas personalizadas que pode ter, consulte a secção Limites.

    • Descrição: adicione uma descrição para ajudar a identificar a finalidade deste anúncio de trajeto e, de seguida, clique em Concluído.

  9. Depois de terminar de adicionar rotas personalizadas, clique em Guardar.

gcloud

Execute o comando update-bgp-peer. Para especificar os intervalos de IP personalizados, use a flag --set-advertisement-ranges ou a flag --add-advertisement-ranges.

  1. Use a flag --set-advertisement-ranges; todos os anúncios personalizados existentes são substituídos:

    gcloud compute routers update-bgp-peer ROUTER_NAME \
        --peer-name=PEER_NAME \
        --advertisement-mode custom \
        --set-advertisement-groups=ADVERTISED_GROUPS \
        --set-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Substitua o seguinte:

    • ROUTER_NAME: o nome do Cloud Router
    • PEER_NAME: o nome do seu par BGP
    • Opcionalmente, adicione a flag --enable-ipv6 se estiver a adicionar intervalos IPv6 personalizados.
    • ADVERTISED_GROUPS: um grupo definido pela Google que o Cloud Router anuncia dinamicamente

      O único valor válido é all_subnets, que anuncia sub-redes com base no modo de encaminhamento dinâmico da rede VPC (semelhante aos anúncios predefinidos).

    • ADVERTISED_IP_RANGES: o conteúdo da nova matriz de intervalos de endereços IP

      Pode especificar intervalos de IP personalizados IPv4 e IPv6. No entanto, os intervalos personalizados IPv6 são anunciados apenas em sessões BGP onde o IPv6 está ativado.

      Se fornecer um prefixo de endereço IP sem uma máscara de sub-rede, é interpretado como uma máscara de sub-rede /32 para IPv4 e /128 para IPv6. Para ver informações sobre o número máximo de rotas aprendidas personalizadas que pode ter, consulte a secção Limites.

    O exemplo seguinte atualiza a sessão BGP my-bgp-session no Cloud Router my-router para anunciar todas as sub-redes e os intervalos de IP personalizados 192.0.2.1, 198.51.100.0/24 e 2001:db8:abcd:12::/64.

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --enable-ipv6 \
        --advertisement-mode custom \
        --set-advertisement-groups=all_subnets \
        --set-advertisement-ranges='192.0.2.1,198.51.100.0/24,2001:db8:abcd:12::/64'
    

    A flag --set-advertisement-groups aceita grupos definidos pela Google que a sessão BGP anuncia dinamicamente. Pode remover a flag --add-advertisement-groups para excluir anúncios de sub-rede. Para ver uma lista de todos os grupos de anúncios, consulte a flag set-advertisement-groups na documentação do SDK da Google.

  2. Use a flag --add-advertisement-ranges, que requer que o modo de publicidade do Cloud Router já esteja definido como custom:

    gcloud compute routers update-bgp-peer ROUTER_NAME \
        --peer-name=PEER_NAME \
        --add-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Substitua o seguinte:

    • ROUTER_NAME: o nome do Cloud Router
    • PEER_NAME: o nome do seu par BGP
    • ADVERTISED_IP_RANGES: o conteúdo da nova matriz de intervalos de endereços IP

      Pode especificar intervalos de IP personalizados IPv4 e IPv6. No entanto, os intervalos personalizados IPv6 são anunciados apenas em sessões BGP onde o IPv6 está ativado.

      Se fornecer um prefixo de endereço IP sem uma máscara de sub-rede, é interpretado como uma máscara de sub-rede /32 para IPv4 e /128 para IPv6. Para ver informações sobre o número máximo de rotas aprendidas personalizadas que pode ter, consulte a secção Limites.

    O exemplo seguinte adiciona o endereço IP personalizado 198.51.100.1 aos anúncios do Cloud Router:

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --add-advertisement-ranges='198.51.100.1'
    

    O exemplo seguinte adiciona o 2001:db8:abcd:12::/64endereço IPv6 personalizado aos anúncios do Cloud Router:

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --enable-ipv6 \
        --add-advertisement-ranges='2001:db8:abcd:12::/64'
    

API

Use o método routers.patch para atualizar o campo bgpPeers[].

O campo bgpPeers[] aceita uma matriz de pares BGP. Quando PATCH este campo, substitui a matriz existente de pares BGP pela nova matriz incluída no seu pedido.

  1. Envie um pedido GET para obter a matriz atual de pares BGP para o router. Para ver detalhes, consulte o artigo Veja a configuração da sessão BGP.

  2. Envie um pedido PATCH com uma nova matriz de pares BGP. Para cada par BGP para o qual quer adicionar anúncios, faça o seguinte:

    • Adicione os anúncios de intervalo de endereços IP que quer no campo bgpPeers[].advertisedIpRanges[].
    • Adicione os anúncios de grupo que quer no campo bgpPeers[].advertisedGroups[].

      O único valor válido é ALL_SUBNETS, que anuncia sub-redes com base no modo de encaminhamento dinâmico da rede VPC (semelhante ao modo de anúncio predefinido).

      Para mais informações sobre estes valores, consulte routers.patch na documentação da API.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Substitua o seguinte:

    • PROJECT_ID: o projeto que contém o Cloud Router
    • REGION: a região onde o Cloud Router está localizado
    • ROUTER_NAME: o nome do Cloud Router
    • BGP_PEERS: o conteúdo da nova matriz de pares BGP

    O exemplo seguinte contém dois pares BGP com anúncios personalizados:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "enableIpv6": true,
          "advertisedRoutePriority": 100,
          "advertiseMode": "CUSTOM",
          "advertisedGroups": ["ALL_SUBNETS"],
          "advertisedIpRanges": [
            {
              "range": "1.2.3.4",
              "description": "First example range"
            },
            {
              "range": "6.7.0.0/16",
              "description": "Second example range"
            },
            {
              "range": "2001:db8:abcd:12::/64",
              "description: "Third example range"
            }
          ]
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "CUSTOM",
          "advertisedIpRanges": [
            {
              "range": "192.168.10.0/24",
              "description": "Fourth example range"
            }
          ]
        }
    

O que se segue?

  • Para ver a configuração de um Cloud Router, as respetivas sessões BGP e as rotas que o Cloud Router está a anunciar, consulte o artigo Ver detalhes do Cloud Router.

  • Para resolver problemas com rotas anunciadas personalizadas, consulte a secção Resolução de problemas.