Administrar conjuntos con nombre

En esta guía, se describe cómo realizar las siguientes actualizaciones en los conjuntos con nombre para las políticas de ruta de BGP de Cloud Router:

  • Enumera los conjuntos con nombre
  • Cómo quitar conjuntos con nombre
  • Actualiza los conjuntos con nombre
  • Cómo agregar elementos de conjuntos con nombre
  • Cómo quitar elementos de un conjunto con nombre

Enumera los conjuntos con nombre en un router

Usa el comando list-named-sets para ver los nombres y los tipos de conjuntos con nombre definidos en un solo router.

gcloud compute routers list-named-sets ROUTER_NAME

Reemplaza ROUTER_NAME por el nombre de tu Cloud Router.

Cómo quitar un conjunto con nombre

Si se hace referencia a un conjunto con nombre en alguna política de ruta de BGP del router, no podrás quitar el conjunto con nombre.

gcloud compute routers remove-named-set ROUTER_NAME
    --set-name=SET_NAME

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre de tu Cloud Router
  • SET_NAME: Nombre del conjunto con nombre que deseas quitar

Actualiza un conjunto con nombre en un router

Cuando actualices un conjunto con nombre existente, te recomendamos que descargues el conjunto con nombre del router en formato YAML o JSON con el comando download-named-set. Edita el archivo YAML o JSON de forma local y, luego, sube el archivo actualizado al router con el comando upload-named-set. El comando upload-named-set reemplaza el conjunto con nombre existente.

El archivo que descargas del router incluye el campo fingerprint, que Cloud Router usa para hacer coincidir el conjunto con nombre existente y evitar actualizaciones conflictivas.

  1. Para descargar el conjunto con nombre, ejecuta el comando download-named-set: 

    gcloud compute routers download-named-set ROUTER_NAME
    --set-name=SET_NAME
    --file-name=FILE_NAME
    --file-format=FORMAT

    Reemplaza lo siguiente:

    • ROUTER_NAME por el nombre del Cloud Router
    • SET_NAME por el nombre del conjunto.
    • FILE_NAME con el nombre de archivo que deseas para el conjunto con nombre, incluida la ruta de acceso y la extensión del nombre de archivo
    • FORMAT con el formato del conjunto con nombre, ya sea JSON o YAML.

  2. Modifica el conjunto con nombre descargado en tu editor de texto preferido con formato JSON o YAML.

    En los siguientes ejemplos, se usan dos archivos YAML para actualizar los conjuntos con nombre allowed-prefixes y allowed-communities.

    allowed-prefixes.yaml:

    # Prefix set
resource:
  elements:
  - expression: "'192.168.1.0/24'"
  - expression: "'fd00::/8'"
  - expression: "prefix('10.0.0.0/20').orLonger()"
  name: allowed-prefixes
  type: NAMED_SET_TYPE_PREFIX

    allowed-communities.yaml:

    # Community set
resource:
  elements:
  - expression: "'64500:100'"
  - expression: "'64500:300'"
  name: allowed-communities
  type: NAMED_SET_TYPE_COMMUNITY

  3. Para subir el conjunto con nombre, ejecuta el comando upload-named-set: 

    gcloud compute routers upload-named-set ROUTER_NAME
    --set-name=SET
    --file-name=NAME
    --file-format=FORMAT

    Reemplaza lo siguiente:

    • ROUTER_NAME por el nombre del Cloud Router
    • SET por el nombre del conjunto.
    • NAME con la ubicación y el nombre del archivo YAML o JSON que editaste.
    • FORMAT con el formato del conjunto con nombre, ya sea JSON o YAML.

Agrega un elemento de conjunto con nombre

Ejecuta el comando siguiente:

gcloud compute routers add-named-set-element ROUTER_NAME
    --set-name=SET_NAME
    --new-set-element=CEL_EXPRESSION

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre de tu Cloud Router
  • SET_NAME: Es el nombre del conjunto con nombre que deseas actualizar.
  • CEL_EXPRESSION: Es un elemento que se agregará al conjunto, expresado en Common Expression Language (CEL).

Cómo quitar un elemento de un conjunto con nombre

Ejecuta el comando siguiente:

gcloud compute routers remove-named-set-element ROUTER_NAME
    --set-name=SET_NAME
    --set-element=CEL_EXPRESSION

Reemplaza lo siguiente:

  • ROUTER_NAME: El nombre de tu Cloud Router
  • SET_NAME: Es el nombre del conjunto con nombre que deseas actualizar.
  • CEL_EXPRESSION: Es un elemento que se quitará del conjunto, expresado en Common Expression Language (CEL).

¿Qué sigue?