Crea y administra routers

En esta página, se describe cómo crear y administrar recursos de router de Google Distributed Cloud conectado en una zona de Distributed Cloud.

Esta funcionalidad solo está disponible en racks de Distributed Cloud conectado. Los servidores de Distributed Cloud conectado no admiten recursos de router.

Para obtener más información sobre los routers de Distributed Cloud, consulta Cómo funciona Distributed Cloud conectado.

Ten en cuenta lo siguiente:

  • Puedes crear un router por red de Distributed Cloud.

  • Te recomendamos que crees un router junto con su adjunto de interconexión correspondiente al mismo tiempo. Para obtener más información sobre cómo crear un adjunto de interconexión, consulta Crea un adjunto de interconexión.

Crear un router

Para crear un router de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers create:

gcloud edge-cloud networking routers create ROUTER_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --asn=ASN

Reemplaza lo siguiente:

  • ROUTER_NAME: Un nombre descriptivo que identifica de forma única este router.
  • NETWORK_NAME: El nombre de la red que atiende este router.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.
  • ASN: El número de sistema autónomo (ASN) para este router. Puedes especificar un valor de dos bytes o de cuatro bytes. Admite valores de ASN públicos y privados.

API

Realiza una solicitud POST al método projects.locations.zones.routers.create:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?routerId=ROUTER_ID
{
 "labels": { LABELS,
  },
 "network": { NETWORK_NAME,
  },
 "asn": { ASN,
  },      
}

Reemplaza lo siguiente:

  • PROJECT_ID: El ID delproyecto de destino Google Cloud .
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.
  • ROUTER_ID: Un ID que identifica de forma única este router.
  • LABELS: Una lista de etiquetas para aplicar a este recurso de router.
  • NETWORK_NAME: El nombre de la red que atiende este router.
  • ASN: El número de sistema autónomo (ASN) para este router. Puedes especificar un valor de dos bytes o de cuatro bytes. Admite valores de ASN públicos y privados.

Establece una sesión de intercambio de tráfico de BGP en un router

Un router te permite establecer los siguientes tipos de sesiones de intercambio de tráfico del protocolo de puerta de enlace de frontera (BGP):

Para establecer una sesión de intercambio de tráfico de BGP, se agrega una interfaz al router para el componente de red de Distributed Cloud que corresponde al tipo de sesión de intercambio de tráfico.

Establece una sesión de intercambio de tráfico en dirección norte

Para establecer una sesión de intercambio de tráfico en dirección norte en un router con un adjunto de interconexión, completa los pasos de esta sección. El adjunto de interconexión de destino debe estar asociado con el router de destino.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --interconnect-attachment=ATTACHMENT_NAME \
    --ip-address=INTERCONNECT_ADDRESS \
    --ip-mask-length=IP_MASK_LENGTH \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • INTERFACE_NAME: Un nombre descriptivo para esta interfaz.
  • ATTACHMENT_NAME: El nombre del adjunto de interconexión de destino dentro del router de destino.
  • INTERCONNECT_ADDRESS: La dirección IP de la interconexión en la que se configura el adjunto de interconexión de destino.
  • IP_MASK_LENGTH: La longitud de la máscara para la dirección IP de interconexión especificada.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

Establece una sesión de intercambio de tráfico en dirección sur

Para establecer una sesión de intercambio de tráfico en dirección sur en un router con una subred, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --subnet=SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • INTERFACE_NAME: Un nombre descriptivo para esta interfaz.
  • SUBNETWORK_NAME: El nombre de la subred de destino.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

Establece una sesión de intercambio de tráfico de bucle invertido

Para establecer una sesión de intercambio de tráfico de bucle invertido en un router con una red, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --loopback-ip-addresses=LOOPBACK_ADDRESSES \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • INTERFACE_NAME: Un nombre descriptivo para esta interfaz.
  • LOOPBACK_ADDRESSES: Las direcciones IPv4 entrantes y salientes para la interfaz de bucle invertido, separadas por comas.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

Finaliza una sesión de intercambio de tráfico de BGP

Para finalizar una sesión de intercambio de tráfico de BGP entre un router y un adjunto de interconexión, una subred o una red, debes borrar la interfaz de ese componente de red del router de destino. Para borrar la interfaz, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers remove-interface:

gcloud edge-cloud networking routers remove-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • INTERFACE_NAME: Un nombre descriptivo para esta interfaz.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

Configura pares en una sesión de intercambio de tráfico de BGP

Puedes agregar y quitar pares de BGP en una sesión de intercambio de tráfico de BGP que se establece entre un router y un adjunto de interconexión, una subred o una red. Cuando agregas un par a una sesión de intercambio de tráfico de BGP, la detección de reenvío bidireccional (BFD) se habilita automáticamente en el router de destino con un intervalo de 100 ms, una ventana de recepción mínima de 100 ms y un multiplicador de 3.

Después de agregar un par a la sesión de intercambio de tráfico de BGP de destino, puedes asignar la dirección IP del par al pod que ejecuta tu carga de trabajo. Para encontrar la dirección IP del par, completa los pasos que se indican en Obtén información sobre un router.

Agrega un par a una sesión de intercambio de tráfico de BGP

Para agregar un par a una sesión de intercambio de tráfico de BGP, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers add-bgp-peer:

gcloud edge-cloud networking routers add-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --peer-asn=PEER_ASN \
    --peer-ipv4-range=PEER_IPv4_RANGE \
    --peer-ipv6-range=PEER_IPv6_RANGE \        
    --interface=INTERFACE_NAME \                                                       \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • PEER_NAME: Un nombre descriptivo para este par.
  • PEER_ASN: El número de sistema autónomo (ASN) para este par. Puedes especificar un valor de dos bytes o de cuatro bytes. Admite valores de ASN públicos y privados.
  • PEER_IPv4_RANGE: El rango CIDR de IPv4 para este par. Este rango de direcciones debe estar en la misma subred que la dirección IP o el rango de direcciones para el adjunto de interconexión, la subred o la red asociados.
  • PEER_IPv6_RANGE: El rango CIDR IPv6 para este par. Este rango de direcciones debe estar en la misma subred que la dirección IP o el rango de direcciones para el adjunto de interconexión, la subred o la red asociados.
  • INTERFACE_NAME: El nombre de la interfaz que corresponde a la sesión de BGP de destino.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

Quita un par de una sesión de intercambio de tráfico de BGP

Para quitar un par de una sesión de intercambio de tráfico de BGP, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers remove-bgp-peer:

gcloud edge-cloud networking routers remove-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • PEER_NAME: El nombre del par de destino.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

Mostrar lista de routers

Para enumerar los routers aprovisionados dentro de una zona de Distributed Cloud conectado, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de red perimetral (roles/edgenetwork.viewer) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers list:

gcloud edge-cloud networking routers list \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

API

Realiza una solicitud GET al método projects.locations.zones.routers.list:

 GET /v1/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Reemplaza lo siguiente:

  • PROJECT_ID: El ID delproyecto de destino Google Cloud .
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.
  • FILTER: Una expresión que restringe los resultados que se muestran a valores específicos.
  • PAGE_SIZE: La cantidad de resultados que se mostrarán por página.
  • SORT_BY: Una lista delimitada por comas de nombres de campos por los que se ordenan los resultados que se muestran. El orden de clasificación predeterminado es ascendente; para el orden de clasificación descendente, agrega el prefijo ~ al campo deseado.
  • PAGE_TOKEN: Un token recibido en la respuesta a la última solicitud de lista en el campo nextPageToken de la respuesta. Envía este token para recibir una página de resultados.

Obtén información sobre un router

Para obtener información sobre un router de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de red perimetral (roles/edgenetwork.viewer) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers describe:

gcloud edge-cloud networking routers describe ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

API

Realiza una solicitud GET al método projects.locations.zones.routers.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Reemplaza lo siguiente:

  • PROJECT_ID: El ID delproyecto de destino Google Cloud .
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.
  • ROUTER_ID: El ID del router de destino.

Esta operación devuelve información detallada sobre el recurso, incluido su estado de aprovisionamiento:

  • PENDING: El recurso aún no comenzó el aprovisionamiento y aún no se propagó por toda la zona.
  • PROVISIONING: Se está aprovisionando el recurso; debes esperar hasta que se propague por toda la zona.
  • RUNNING: El recurso se aprovisionó y propagó correctamente por toda la zona; está listo para usarse.
  • FAILED: No se pudo aprovisionar el recurso; el recurso no se propagó por toda la zona.

Verifica el estado operativo de un router

Para verificar el estado operativo de un router de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de red perimetral (roles/edgenetwork.viewer) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers get-status:

gcloud edge-cloud networking routers get-status ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

API

Realiza una solicitud GET al método projects.locations.zones.routers.diagnose:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID:diagnose

Reemplaza lo siguiente:

  • PROJECT_ID: El ID delproyecto de destino Google Cloud .
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.
  • ROUTER_ID: El ID del router de destino.

Borrar un router

Para borrar un router de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking routers delete:

gcloud edge-cloud networking routers delete ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre del router de destino.
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.

API

Realiza una solicitud DELETE al método projects.locations.zones.routers.delete:

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Reemplaza lo siguiente:

  • PROJECT_ID: El ID delproyecto de destino Google Cloud .
  • REGION: la Google Cloud región a la que pertenece la zona de Distributed Cloud conectado de destino.
  • ZONE_NAME: El nombre de la zona de Distributed Cloud conectado de destino.
  • ROUTER_ID: El ID del router de destino.

¿Qué sigue?