Benannte Sätze verwalten

In dieser Anleitung wird beschrieben, wie Sie die folgenden Aktualisierungen für benannte Sätze für BGP-Routenrichtlinien für Cloud Router ausführen:

  • Benannte Sätze auflisten
  • Benannte Sätze entfernen
  • Benannte Sätze aktualisieren
  • Elemente benannten Sätzen hinzufügen
  • Elemente aus benannten Sätzen entfernen

Benannte Sätze auf einem Router auflisten

Mit dem list-named-sets Befehl können Sie die Namen und Typen der benannten Sätze auf einem einzelnen Router aufrufen.

gcloud compute routers list-named-sets ROUTER_NAME

Ersetzen Sie ROUTER_NAME durch den Namen Ihres Cloud Router.

Benannten Satz entfernen

Wenn in einer BGP-Routenrichtlinie auf dem Router auf einen benannten Satz verwiesen wird, können Sie den benannten Satz nicht entfernen.

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

Ersetzen Sie Folgendes:

  • ROUTER_NAME: Der Name Ihres Cloud Router
  • SET_NAME: Der Name des benannten Satzes, den Sie entfernen möchten

Benannten Satz auf einem Router aktualisieren

Wenn Sie einen vorhandenen benannten Satz aktualisieren, empfehlen wir, den benannten Satz mit dem download-named-set Befehl im YAML- oder JSON-Format vom Router herunterzuladen. Bearbeiten Sie die YAML- oder JSON-Datei lokal und laden Sie die aktualisierte Datei dann mit dem upload-named-set Befehl auf den Router hoch. Der Befehl upload-named-set überschreibt den vorhandenen benannten Satz.

Die Datei, die Sie vom Router herunterladen, enthält das Feld fingerprint. Cloud Router verwendet dieses Feld, um den vorhandenen benannten Satz abzugleichen und widersprüchliche Aktualisierungen zu verhindern.

  1. Führen Sie den Befehl download-named-set aus, um den benannten Satz herunterzuladen: 

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

    Ersetzen Sie Folgendes:

    • ROUTER_NAME durch den Namen des Cloud Router.
    • SET_NAME durch den Namen des Satzes.
    • FILE_NAME durch den gewünschten Dateinamen für den benannten Satz, einschließlich Pfad und Dateinamenerweiterung.
    • FORMAT durch das Format des benannten Satzes, entweder JSON oder YAML.

  2. Ändern Sie den heruntergeladenen benannten Satz in Ihrem bevorzugten Texteditor im JSON- oder YAML-Format.

    In den folgenden Beispielen werden zwei YAML-Dateien verwendet, um benannte Sätze mit den Namen allowed-prefixes und allowed-communities zu aktualisieren.

    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. Führen Sie den Befehl upload-named-set aus, um den benannten Satz hochzuladen: 

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

    Ersetzen Sie Folgendes:

    • ROUTER_NAME durch den Namen des Cloud Router.
    • SET durch den Namen des Satzes.
    • NAME durch den Speicherort und den Dateinamen der bearbeiteten YAML- oder JSON-Datei.
    • FORMAT durch das Format des benannten Satzes, entweder JSON oder YAML.

Element zu einem benannten Satz hinzufügen

Führen Sie dazu diesen Befehl aus:

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

Ersetzen Sie Folgendes:

  • ROUTER_NAME: Der Name Ihres Cloud Router
  • SET_NAME: Der Name des benannten Satzes, den Sie aktualisieren möchten
  • CEL_EXPRESSION: Ein Element, das dem Satz hinzugefügt werden soll, ausgedrückt in Common Expression Language (CEL)

Element aus einem benannten Satz entfernen

Führen Sie dazu diesen Befehl aus:

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

Ersetzen Sie Folgendes:

  • ROUTER_NAME: Der Name Ihres Cloud Router
  • SET_NAME: Der Name des benannten Satzes, den Sie aktualisieren möchten
  • CEL_EXPRESSION: Ein Element, das aus dem Satz entfernt werden soll, ausgedrückt in Common Expression Language (CEL)

Nächste Schritte