IBM Cloud Docs
Adición y eliminación de túneles GRE redundantes

Adición y eliminación de túneles GRE redundantes

Puede añadir o eliminar túneles conectados a conexiones redundantes GRE. Tenga en cuenta que se requieren un mínimo de dos túneles GRE.

Antes de empezar

Antes de añadir un túnel a un GRE redundante, asegúrese de revisar las Consideraciones sobre GRE(Generic Routing Encapsulation) generales y redundantes.

Adición de un túnel a un GRE redundante en la interfaz de usuario

Puede añadir túneles al crear un GRE redundante, o después de suministrar una pasarela de tránsito existente con un GRE redundante. Para añadir un túnel a un GRE redundante existente, siga estos pasos:

  1. Desde su navegador, abra la consola IBM Cloud y conéctese a su cuenta.

  2. Seleccione el icono del Menú de navegación Menú de navegación en la parte superior izquierda y, a continuación, haga clic en Infraestructura > Red > Transit Gateway.

  3. Haga clic en el nombre de la pasarela de tránsito en la que desea añadir un túnel.

  4. En la vista con pestañas Conexiones, pulse el menú Acciones icono Acciones al final de la fila de tabla de la conexión donde desea añadir un túnel.

    Si expande la fila de la conexión, se listan los detalles del túnel y sus estados.

  5. Pulse Añadir túnel. Puedes añadir más túneles, pero no puedes superar los dos túneles por zona.

  6. En la ventana Añadir túnel, elija una zona de disponibilidad en la que crear el túnel. A continuación, rellene los siguientes campos.

    Cuando selecciona una zona para el túnel, sólo se muestran como opciones las zonas válidas para una conexión GRE.

    1. Opcionalmente, introduzca el ASN BGP remoto, que es un valor válido de 2 ó 4 bytes de su elección. Si deja este campo en blanco, se asigna un ASN exclusivo.
    2. Introduzca la IP de la pasarela local que la pasarela de tránsito utiliza para alojar la red subyacente del túnel GRE. Esta dirección IP seleccionada por el usuario se configura en el túnel GRE de la pasarela de tránsito después de que se haya creado.
    3. Introduzca la IP de la puerta de enlace remota para el punto final del túnel GRE.
    4. Introduzca una IP de túnel local /30 para ambos extremos del túnel, por ejemplo 192.168.103.1.
    5. Introduzca una IP de túnel remoto /30 para ambos extremos del túnel, por ejemplo 192.168.103.2.
    6. Especifique un nombre de conexión para el túnel GRE.
  7. Haga clic en Añadir para crear el túnel.

Eliminación de un túnel de un GRE redundante en la interfaz de usuario

Para eliminar un túnel de un GRE redundante, siga estos pasos:

  1. Desde su navegador, abra la consola IBM Cloud y conéctese a su cuenta.

  2. Seleccione el icono del Menú de navegación Menú de navegación en la parte superior izquierda y, a continuación, haga clic en Infraestructura > Red > Transit Gateway.

  3. Haga clic en el nombre de la pasarela de tránsito en la que desea eliminar un túnel.

  4. En la vista con pestañas Conexiones, pulse el menú Acciones icono Acciones al final de la fila de tabla de la conexión donde desea eliminar un túnel.

    Si expande la fila de la conexión, se listan los detalles del túnel y sus estados.

  5. Pulse Eliminar túnel.

  6. En la ventana Suprimir túnel GRE, seleccione el nombre del túnel GRE que desea eliminar y, a continuación, pulse Suprimir. No puede deshacer esta acción.

Una conexión no puede tener menos de dos túneles conectados a una GRE redundante.

Adición de un túnel a un GRE redundante desde la CLI

Puede añadir un túnel a un GRE redundante utilizando las opciones de CLI o un archivo JSON. La sintaxis del mandato para añadir un túnel utilizando las opciones de CLI es la siguiente:

ibmcloud tg redundant-gre-tunnel-add|targre GATEWAY_ID REDUNDANT_GRE_ID --name NAME --zone ZONE --local-gateway-ip LOCAL_GATEWAY_IP --local-tunnel-ip  LOCAL_TUNNEL_IP --remote-gateway-ip REMOTE_GATEWAY_IP --remote-tunnel-ip REMOTE_TUNNEL_IP [--remote-bgp-asn REMOTE_BGP_ASN] [--output json]

Donde:

GATEWAY_ID
ID de la pasarela a la que está vinculada la nueva conexión.
REDUNDANT_GRE_ID
ID del GRE redundante.
--name
Nombre del nuevo túnel.
--zone
Zona de disponibilidad para el túnel GRE. Ejemplo:us-south-1
--local-gateway-ip
Dirección IP de la pasarela local[^ip2] para la conexión del túnel GRE.
--local-tunnel-ip
Dirección IP del túnel local para la conexión del túnel GRE.
--remote-gateway-ip
Dirección IP de la puerta de enlace remota para la conexión del túnel GRE.
--remote-tunnel-ip
Dirección IP del túnel remoto para la conexión del túnel GRE.
--remote-bgp-asn
Opcional: si no se especifica el ASN BGP remoto, se genera uno.
--output json
(Opcional) Especifique si desea que la salida se muestre en formato JSON.
--help | -h
Opcional: Obtener ayuda sobre este comando.

Para añadir un túnel que utilice un archivo JSON como entrada, especifique el mandato siguiente:

ibmcloud tg redundant-gre-tunnel-add|targre JSON_FILE_PATH [--output json]

Ejemplo de archivo JSON:

{
  "gateway_id": "47f11b01-471c-47d0-9e84-550c88c94055",
  "redundant_gre_id": "83792525-471c-47d0-9e84-jdy830jd",
  "name": "unbound_gre_tunnel",
  "local_gateway_ip": "192.168.100.1",
  "local_tunnel_ip": "192.168.129.2",
  "remote_bgp_asn": 65010,
  "remote_gateway_ip": "10.242.63.12",
  "remote_tunnel_ip": "192.168.129.1",
  "zone": {
      "name": "us-south-1"
        }
}

Eliminación de un túnel de un GRE redundante de la CLI

Para eliminar un túnel de un GRE redundante, especifique el mandato siguiente:

ibmcloud tg redundant-gre-tunnel-remove|trrgre GATEWAY_ID REDUNDANT_GRE_ID TUNNEL_ID [--force | -f ] [--help | -h]

Donde:

GATEWAY_ID
ID de la pasarela a la que está vinculada la conexión.
REDUNDANT_GRE_ID
ID del GRE redundante.
TUNNEL_ID
ID del túnel a eliminar.
--force | -f
Opcional: Forzar la eliminación sin confirmación.
--help | -h
Opcional: Obtener ayuda sobre este comando.

Adición de un túnel a un GRE redundante con la API

Puede añadir un túnel a un GRE redundante existente con la API.

Solicitud de ejemplo

curl -H "Content-Type: application/json" -X POST https://$TS_ENDPOINT/v1/transit_gateways/$GATEWAY_ID/connections/$CONNECTION_ID/tunnels?version=2020-03-31   -H "authorization: Bearer $IAM_TOKEN"   -d '{
  "local_gateway_ip": "192.168.100.1",
  "local_tunnel_ip": "192.168.129.2",
  "name": "gre1",
  "remote_bgp_asn": 65010,
  "remote_gateway_ip": "10.242.63.12",
  "remote_tunnel_ip": "192.168.129.1",
  "zone": {
    "name": "us-south-1"
  }
}'

Respuesta de ejemplo

{
  "name": "gre1",
  "id": "47f11b01-471c-47d0-9e84-550c88c94057",
  "mtu": 9000,
  "status": "up",
  "updated_at": "2024-06-10T14:52:54.918Z",
  "created_at": "2024-06-10T14:52:54.918Z",
  "local_gateway_ip": "192.168.200.1",
  "local_tunnel_ip": "192.168.239.2",
  "remote_gateway_ip": "10.242.63.12",
  "remote_tunnel_ip": "192.168.129.1",
  "local_bgp_asn": 64490,
  "remote_bgp_asn": 65010,
  "zone": {
    "name": "us-south-1"
  }
}

Para obtener más información, consulte Adición de una conexión a una Transit Gateway en la referencia de la API Transit Gateway.

Eliminación de un túnel de un GRE redundante con la API

Puede añadir un túnel a un GRE redundante existente con la API siempre que tenga más de dos túneles:

curl -X DELETE https://$TS_ENDPOINT/v1/transit_gateways/$GATEWAY_ID/connections/$CONNECTION_ID/tunnels/$TUNNEL_ID?version=2020-03-31   -H "authorization: Bearer $IAM_TOKEN"

Se devuelve un código HTTP 204 en caso de borrado correcto sin cuerpo de respuesta. Para conocer los parámetros y ejemplos de la API, consulte Elimina el túnel GRE redundante Transit Gateway especificado en la referencia de la API Transit Gateway.

Adición de un túnel a una GRE redundante utilizando Terraform

Para utilizar Terraform, descargue la CLI de Terraform y configure el plug-in de proveedor IBM Cloud. Para obtener más información, consulte Cómo empezar con Terraform.

El ejemplo siguiente ilustra la adición de un túnel GRE redundante utilizando Terraform:

resource "ibm_tg_connection_rgre_tunnel" "test_ibm_tg_connection_tunnel" {
  gateway = ibm_tg_gateway.test_tg_gateway.id
  connection_id = ibm_tg_connection.test_ibm_tg_connection.connection_id
  local_gateway_ip = "192.139.200.1"
  local_tunnel_ip = "192.178.239.2"
  name =  "tunnel_name"
  remote_gateway_ip = "10.186.203.4"
  remote_tunnel_ip = "192.178.239.1"
  zone =  "us-south-3"
}

Para más información, consulte el registro de Terraform.

Eliminación de un túnel de un GRE redundante utilizando Terraform

El ejemplo siguiente ilustra la eliminación de un túnel a un GRE redundante utilizando Terraform:

terraform destroy -target=ibm_tg_connection_rgre_tunnel.test_ibm_tg_connection_tunnel

Para más información, consulte el registro de Terraform.