Gestisci gli insiemi denominati

Questa guida descrive come eseguire i seguenti aggiornamenti agli insiemi denominati per le policy di route BGP del router Cloud:

  • Elenca gli insiemi denominati
  • Rimuovi gli insiemi denominati
  • Aggiorna gli insiemi denominati
  • Aggiungi elementi di insiemi denominati
  • Rimuovi elementi di insiemi denominati

Elenca gli insiemi denominati su un router

Utilizza il comando list-named-sets per visualizzare i nomi e i tipi di insiemi denominati definiti su un singolo router.

gcloud compute routers list-named-sets ROUTER_NAME

Sostituisci ROUTER_NAME con il nome del tuo router Cloud.

Rimuovi un insieme denominato

Se un insieme denominato viene fatto riferimento in una policy di route BGP sul router, non puoi rimuoverlo.

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

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del tuo router Cloud
  • SET_NAME: il nome dell'insieme denominato che vuoi rimuovere

Aggiorna un insieme denominato su un router

Quando aggiorni un insieme denominato esistente, ti consigliamo di scaricarlo dal router in formato YAML o JSON utilizzando il download-named-set comando. Modifica il file YAML o JSON in locale, quindi carica il file aggiornato sul router utilizzando il upload-named-set comando. Il comando upload-named-set sovrascrive l'insieme denominato esistente.

Il file che scarichi dal router include il campo fingerprint, che il router Cloud utilizza per trovare l'insieme denominato esistente ed evitare aggiornamenti in conflitto.

  1. Per scaricare l'insieme denominato, esegui il comando download-named-set: 

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

    Sostituisci quanto segue:

    • ROUTER_NAME con il nome del router Cloud.
    • SET_NAME con il nome dell'insieme.
    • FILE_NAME con il nome file che vuoi utilizzare per l'insieme denominato, inclusi il percorso e l'estensione del nome file.
    • FORMAT con il formato dell'insieme denominato, JSON o YAML.

  2. Modifica l'insieme denominato scaricato nell'editor di testo che preferisci utilizzando la formattazione JSON o YAML.

    Gli esempi seguenti utilizzano due file YAML per aggiornare gli insiemi denominati allowed-prefixes e 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. Per caricare l'insieme denominato, esegui il comando upload-named-set: 

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

    Sostituisci quanto segue:

    • ROUTER_NAME con il nome del router Cloud.
    • SET con il nome dell'insieme.
    • NAME con la posizione e il nome file del file YAML o JSON che hai modificato.
    • FORMAT con il formato dell'insieme denominato, JSON o YAML.

Aggiungi un elemento di insieme denominato

Esegui questo comando:

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

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del tuo router Cloud
  • SET_NAME: il nome dell'insieme denominato che vuoi aggiornare
  • CEL_EXPRESSION: un elemento da aggiungere all'insieme, espresso in Common Expression Language (CEL)

Rimuovi un elemento di insieme denominato

Esegui questo comando:

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

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del tuo router Cloud
  • SET_NAME: il nome dell'insieme denominato che vuoi aggiornare
  • CEL_EXPRESSION: un elemento da rimuovere dall'insieme, espresso in Common Expression Language (CEL)

Passaggi successivi