Anunciar intervalos de direcciones personalizadas

Usa el modo de anuncio personalizado en un Cloud Router o en una sesión del protocolo de pasarela fronteriza (BGP) en un Cloud Router para anunciar intervalos de direcciones IP que no sean los intervalos de direcciones IP de subred de tu red de nube privada virtual (VPC). Por ejemplo, puedes anunciar intervalos de direcciones IP externas, intervalos de direcciones IP internas arbitrarias o direcciones IP internas de intervalos de direcciones IP de otras redes de VPC conectadas a tu red de VPC. Tu red de VPC puede estar conectada mediante el emparejamiento entre redes de VPC o radios de VPC en Network Connectivity Center.

Cuando un Cloud Router se configura para usar el modo de anuncio predeterminado, solo anuncia rutas de subredes que forman parte de la misma red de VPC que el Cloud Router. En este modo, Cloud Router excluye las rutas estáticas y las rutas que se aprenden de forma dinámica de otras redes de VPC, como las rutas aprendidas mediante el emparejamiento entre redes de VPC o mediante los radios de VPC en Network Connectivity Center.

Para especificar rutas anunciadas personalizadas al crear un router de Cloud Router o configurar una sesión BGP, consulta Crear routers de Cloud Router o Establecer sesiones BGP.

Antes de empezar

gcloud

Si quieres usar los ejemplos de línea de comandos de esta guía, haz lo siguiente:

  1. Instala o actualiza a la versión más reciente de Google Cloud CLI.
  2. Define una región y una zona predeterminadas.

API

Si quieres usar los ejemplos de API de esta guía, configura el acceso a la API.

Especificar rutas anunciadas personalizadas en un router de Cloud Router

Para especificar rutas anunciadas personalizadas en un router de Cloud Router, sigue estos pasos.

Consola

  1. En la Google Cloud consola, ve a la página Cloud Routers.

    Ir a Cloud Routers

  2. Selecciona el Cloud Router que quieras actualizar.

  3. En la página Detalles del router, haz clic en Editar.

  4. En la sección Rutas anunciadas, en Rutas, seleccione Crear rutas personalizadas.

  5. Marca la casilla Anunciar todas las subredes que pueda ver el router de Cloud Router para seguir anunciando las subredes disponibles para el router de Cloud Router. Si habilita esta opción, se imitará el comportamiento de Cloud Router en el modo de anuncio predeterminado.

  6. Selecciona Añadir ruta personalizada para añadir una ruta anunciada.

  7. Configura las rutas anunciadas personalizadas:

    • Origen: selecciona Intervalo de IP personalizado.

    • Intervalo de direcciones IP: usa la notación CIDR para especificar el intervalo de IPs personalizado.

      Puedes especificar intervalos de IP personalizados IPv4 e IPv6. Sin embargo, los intervalos personalizados de IPv6 solo se anuncian en sesiones BGP en las que IPv6 está habilitado.

      Si proporcionas un prefijo de dirección IP sin una máscara de subred, se interpreta como una máscara de subred /32 para IPv4 y /128 para IPv6. Para obtener información sobre el número máximo de rutas aprendidas personalizadas que puedes tener, consulta la sección Límites.

    • Descripción: añade una descripción para identificar el propósito de esta ruta anunciada personalizada y, a continuación, haz clic en Hecho.

  8. Cuando haya terminado de añadir las rutas anunciadas personalizadas, haga clic en Guardar.

gcloud

Ejecuta el comando update. Para especificar los intervalos de IPs personalizados, usa la marca --set-advertisement-ranges o la marca --add-advertisement-ranges.

  1. Usa la marca --set-advertisement-ranges. Se sustituirán todos los anuncios personalizados que ya tengas:

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

    Haz los cambios siguientes:

    • ROUTER_NAME: el nombre de Cloud Router
    • PROJECT_ID: el proyecto que contiene el Cloud Router
    • ADVERTISED_GROUPS: un grupo definido por Google que Cloud Router anuncia dinámicamente.

      El único valor válido es all_subnets, que anuncia subredes en función del modo de enrutamiento dinámico de la red VPC (similar al modo de anuncio predeterminado).

    • ADVERTISED_IP_RANGES: el contenido de la nueva matriz de intervalos de direcciones IP

      Puedes especificar intervalos de IP personalizados IPv4 e IPv6. Sin embargo, los intervalos personalizados de IPv6 solo se anuncian en sesiones BGP en las que IPv6 está habilitado.

      Si proporcionas un prefijo de dirección IP sin una máscara de subred, se interpreta como una máscara de subred /32 para IPv4 y /128 para IPv6. Para obtener información sobre el número máximo de rutas aprendidas personalizadas que puedes tener, consulta la sección Límites.

    En el siguiente ejemplo se actualiza el router de Cloud Router my-router para que anuncie todas las subredes y los intervalos de IP personalizados 192.0.2.0/24 y 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'
    

    En el siguiente ejemplo se actualiza el router de Cloud Router my-router para que anuncie todas las subredes y el intervalo IPv6 predeterminado:

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

    Cloud Router solo anuncia intervalos de IPv6 en sesiones BGP que tengan habilitado IPv6.

    La marca --set-advertisement-groups acepta grupos definidos por Google que el router de Cloud anuncia dinámicamente. Puedes quitar la marca --set-advertisement-groups para excluir los anuncios de subred. Para ver una lista de todos los grupos de anuncios, consulte la marca set-advertisement-groups en la documentación del SDK de Google.

  2. Usa la marca --add-advertisement-ranges, que requiere que el modo de anuncio de Cloud Router ya esté definido como custom:

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

    Haz los cambios siguientes:

    • ROUTER_NAME: el nombre de Cloud Router
    • ADVERTISED_IP_RANGES: el contenido de la nueva matriz de intervalos de direcciones IP

    En el siguiente ejemplo se añade la dirección IP personalizada 203.0.113.1 a los anuncios del Cloud Router:

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

    En el siguiente ejemplo se añade el intervalo de IPv6 personalizado 2001:db8:abcd:12::/64 a los anuncios de Cloud Router:

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

    Cloud Router solo anuncia intervalos IPv6 en sesiones BGP que tengan habilitado IPv6.

API

Usa el método routers.patch para actualizar los campos bgp.advertisedGroups[] y bgp.advertisedIpRanges[].

Los campos bgp.advertisedGroups[] y bgp.advertisedIpRanges[] almacenan matrices de grupos anunciados e intervalos de direcciones IP anunciados. Si PATCH estos campos, se sobrescribirán las matrices que ya haya con las nuevas de su solicitud.

  1. Envía una solicitud GET para obtener las matrices actuales de grupos anunciados e intervalos de direcciones IP anunciados en el router. Para obtener más información, consulta Ver la configuración de la sesión de BGP.

  2. Envía una solicitud PATCH con nuevas matrices de grupos anunciados e intervalos de direcciones IP anunciados. Usa las matrices de la solicitud GET del paso anterior y añade los grupos o los intervalos de direcciones IP que quieras en el router.

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

    Haz los cambios siguientes:

    • PROJECT_ID: el proyecto que contiene el Cloud Router
    • REGION: región en la que se encuentra Cloud Router
    • ROUTER_NAME: el nombre de Cloud Router
    • ADVERTISED_GROUPS: un grupo definido por Google que Cloud Router anuncia dinámicamente.

    El único valor válido es ALL_SUBNETS, que anuncia subredes en función del modo de enrutamiento dinámico de la red VPC (similar a los anuncios predeterminados).

    • ADVERTISED_IP_RANGES: el contenido de la nueva matriz de intervalos de direcciones IP

    Puedes especificar intervalos de IP personalizados IPv4 e IPv6. Sin embargo, los intervalos personalizados de IPv6 solo se anuncian en sesiones BGP en las que IPv6 está habilitado.

    Si proporcionas un prefijo de dirección IP sin una máscara de subred, se interpreta como una máscara de subred /32 para IPv4 y /128 para IPv6. Para obtener información sobre el número máximo de rutas aprendidas personalizadas que puedes tener, consulta la sección Límites.

    En el siguiente ejemplo se incluyen dos intervalos de direcciones IPv4 y un intervalo de direcciones 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"
        }
    

Especificar rutas anunciadas personalizadas para una sesión de BGP

Para especificar rutas anunciadas personalizadas en una sesión BGP, siga estos pasos.

Consola

  1. En la Google Cloud consola, ve a la página Cloud Routers.

    Ir a Cloud Routers

  2. Selecciona el router de Cloud Router que contiene la sesión BGP que quieres actualizar.

  3. En la página Detalles del router, selecciona la sesión BGP que quieras actualizar.

  4. En la página Detalles de la sesión de BGP, haga clic en Editar.

  5. En Rutas, selecciona Crear rutas personalizadas.

  6. Marca la casilla Anunciar todas las subredes que pueda ver el router de Cloud Router para seguir anunciando las subredes disponibles para el router de Cloud Router. Si habilitas esta opción, se imitará el comportamiento predeterminado del Cloud Router.

  7. Selecciona Añadir ruta personalizada para añadir una ruta anunciada.

  8. Configura el anuncio de ruta:

    • Origen: selecciona Intervalo de IP personalizado.

    • Intervalo de direcciones IP: usa la notación CIDR para especificar el intervalo de IPs personalizado. Puedes especificar intervalos de IP personalizados IPv4 e IPv6. Sin embargo, los intervalos personalizados de IPv6 solo se anuncian en sesiones BGP en las que IPv6 esté habilitado.

      Si proporcionas un prefijo de dirección IP sin una máscara de subred, se interpreta como una máscara de subred /32 para IPv4 y /128 para IPv6. Para obtener información sobre el número máximo de rutas aprendidas personalizadas que puedes tener, consulta la sección Límites.

    • Descripción: añade una descripción para ayudarte a identificar el propósito de este anuncio de ruta y, a continuación, haz clic en Hecho.

  9. Cuando hayas terminado de añadir rutas personalizadas, haz clic en Guardar.

gcloud

Ejecuta el comando update-bgp-peer. Para especificar los intervalos de IPs personalizados, usa la marca --set-advertisement-ranges o la marca --add-advertisement-ranges.

  1. Usa la marca --set-advertisement-ranges. Se sustituirán todos los anuncios personalizados que ya tengas:

    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
    

    Haz los cambios siguientes:

    • ROUTER_NAME: el nombre de Cloud Router
    • PEER_NAME: el nombre de tu par de BGP
    • De forma opcional, añade la marca --enable-ipv6 si vas a añadir intervalos IPv6 personalizados.
    • ADVERTISED_GROUPS: un grupo definido por Google que Cloud Router anuncia dinámicamente.

      El único valor válido es all_subnets, que anuncia subredes en función del modo de enrutamiento dinámico de la red VPC (similar a los anuncios predeterminados).

    • ADVERTISED_IP_RANGES: el contenido de la nueva matriz de intervalos de direcciones IP

      Puedes especificar intervalos de IP personalizados IPv4 e IPv6. Sin embargo, los intervalos personalizados de IPv6 solo se anuncian en sesiones BGP en las que IPv6 está habilitado.

      Si proporcionas un prefijo de dirección IP sin una máscara de subred, se interpreta como una máscara de subred /32 para IPv4 y /128 para IPv6. Para obtener información sobre el número máximo de rutas aprendidas personalizadas que puedes tener, consulta la sección Límites.

    En el siguiente ejemplo, se actualiza la sesión BGP my-bgp-session del router de Cloud Router my-router para anunciar todas las subredes y los intervalos de IP personalizados 192.0.2.1, 198.51.100.0/24 y 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'
    

    La marca --set-advertisement-groups acepta grupos definidos por Google que la sesión BGP anuncia de forma dinámica. Puedes quitar la marca --add-advertisement-groups para excluir los anuncios de subred. Para ver una lista de todos los grupos de anuncios, consulte la marca set-advertisement-groups en la documentación del SDK de Google.

  2. Usa la marca --add-advertisement-ranges, que requiere que el modo de anuncio de Cloud Router ya esté definido como custom:

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

    Haz los cambios siguientes:

    • ROUTER_NAME: el nombre de Cloud Router
    • PEER_NAME: el nombre de tu par de BGP
    • ADVERTISED_IP_RANGES: el contenido de la nueva matriz de intervalos de direcciones IP

      Puedes especificar intervalos de IP personalizados IPv4 e IPv6. Sin embargo, los intervalos personalizados de IPv6 solo se anuncian en sesiones BGP en las que IPv6 está habilitado.

      Si proporcionas un prefijo de dirección IP sin una máscara de subred, se interpreta como una máscara de subred /32 para IPv4 y /128 para IPv6. Para obtener información sobre el número máximo de rutas aprendidas personalizadas que puedes tener, consulta la sección Límites.

    En el siguiente ejemplo se añade la dirección IP personalizada 198.51.100.1 a los anuncios del Cloud Router:

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

    En el siguiente ejemplo se añade la dirección IPv6 personalizada 2001:db8:abcd:12::/64 a los anuncios de 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

Usa el método routers.patch para actualizar el campo bgpPeers[].

El campo bgpPeers[] acepta una matriz de pares de BGP. Si PATCH este campo, se sobrescribirá la matriz de peers de BGP con la nueva matriz incluida en tu solicitud.

  1. Envía una solicitud GET para obtener la matriz actual de peers BGP del router. Para obtener más información, consulta Ver la configuración de la sesión de BGP.

  2. Envía una solicitud PATCH con una nueva matriz de peers de BGP. Para cada peer de BGP al que quiera añadir anuncios, haga lo siguiente:

    • Añada los anuncios de intervalos de direcciones IP que quiera en el campo bgpPeers[].advertisedIpRanges[].
    • Añade los anuncios de grupo que quieras en el campo bgpPeers[].advertisedGroups[].

      El único valor válido es ALL_SUBNETS, que anuncia subredes en función del modo de enrutamiento dinámico de la red VPC (similar al modo de anuncio predeterminado).

      Para obtener más información sobre estos valores, consulta routers.patch en la documentación de la API.

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

    Haz los cambios siguientes:

    • PROJECT_ID: el proyecto que contiene el Cloud Router
    • REGION: región en la que se encuentra Cloud Router
    • ROUTER_NAME: el nombre de Cloud Router
    • BGP_PEERS: el contenido del nuevo array de pares de BGP

    En el siguiente ejemplo se muestran dos peers de BGP con anuncios 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"
            }
          ]
        }
    

Siguientes pasos