Crea y administra routers

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

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

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

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 proyecto Google Cloud .

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: Es un nombre descriptivo que identifica de forma única este router.
  • NETWORK_NAME: Es el nombre de la red a la que presta servicio este router.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • ASN: Es el número de sistema autónomo (ASN) de este router. Puedes especificar un valor de dos o 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: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • ROUTER_ID: Es un ID que identifica de forma única este router.
  • LABELS: Es una lista de etiquetas que se aplicarán a este recurso de router.
  • NETWORK_NAME: Es el nombre de la red a la que presta servicio este router.
  • ASN: Es el número de sistema autónomo (ASN) de este router. Puedes especificar un valor de dos o 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 de salida

Para establecer una sesión de intercambio de tráfico de salida en un router con una vinculación de interconexión, completa los pasos de esta sección. La conexión de interconexión de destino debe estar asociada al router de destino.

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

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: Es el nombre del router de destino.
  • INTERFACE_NAME: Es un nombre descriptivo para esta interfaz.
  • ATTACHMENT_NAME: Es el nombre del adjunto de interconexión de destino dentro del router de destino.
  • INTERCONNECT_ADDRESS: Es la dirección IPv4 de la interconexión en la que se configura la conexión de interconexión de destino.
  • IP_MASK_LENGTH: Es la longitud de la máscara para la dirección IP de interconexión especificada.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

Establece una sesión de intercambio de tráfico de salida

Para establecer una sesión de intercambio de tráfico de salida 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 proyecto Google Cloud .

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: Es el nombre del router de destino.
  • INTERFACE_NAME: Es un nombre descriptivo para esta interfaz.
  • SUBNETWORK_NAME: Es el nombre de la subred de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud 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 proyecto Google Cloud .

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: Es el nombre del router de destino.
  • INTERFACE_NAME: Es un nombre descriptivo para esta interfaz.
  • LOOPBACK_ADDRESSES: Las direcciones IPv4 entrantes y salientes para la interfaz de bucle invertido, separadas por comas.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud 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 una vinculación 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 proyecto Google Cloud .

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: Es el nombre del router de destino.
  • INTERFACE_NAME: Es un nombre descriptivo para esta interfaz.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

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

Puedes agregar y quitar peers de BGP en una sesión de intercambio de tráfico de BGP establecida 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 peering 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 Cómo obtener 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 que se indican en esta sección.

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

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_IP_RANGE \
    --interface=INTERFACE_NAME \                                                       \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: Es el nombre del router de destino.
  • PEER_NAME: Es un nombre descriptivo para este intercambio de tráfico.
  • PEER_ASN: Es el número de sistema autónomo (ASN) de este par. Puedes especificar un valor de dos o cuatro bytes. Admite valores de ASN públicos y privados.
  • PEER_IP_RANGE: Es el rango de CIDR 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 la conexión de interconexión, la subred o la red asociadas.
  • INTERFACE_NAME: Es el nombre de la interfaz que corresponde a la sesión de BGP de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

Cómo quitar un par de una sesión de intercambio de tráfico de BGP

Para quitar un par de una sesión de peering de BGP, completa los pasos que se indican en esta sección.

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

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: Es el nombre del router de destino.
  • PEER_NAME: Es el nombre del par de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

Mostrar lista de routers

Para enumerar los routers aprovisionados en una zona 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 proyecto Google Cloud .

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: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud 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: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • FILTER: Es una expresión que limita los resultados devueltos a valores específicos.
  • PAGE_SIZE: Es la cantidad de resultados que se mostrarán por página.
  • SORT_BY: Es una lista delimitada por comas de los nombres de los campos por los que se ordenan los resultados devueltos. El orden de clasificación predeterminado es ascendente. Para obtener un orden de clasificación descendente, agrega el prefijo ~ al campo deseado.
  • PAGE_TOKEN: Es un token que se recibe 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 proyecto Google Cloud .

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: Es el nombre del router de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud 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: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • ROUTER_ID: Es 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 en toda la zona, y está listo para usarse.
  • FAILED: El aprovisionamiento del recurso no se realizó correctamente; 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 que se indican en esta sección.

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

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: Es el nombre del router de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud 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: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • ROUTER_ID: Es 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 proyecto Google Cloud .

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: Es el nombre del router de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud 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: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • ROUTER_ID: Es el ID del router de destino.

¿Qué sigue?