Mengelola set bernama

Panduan ini menjelaskan cara melakukan pembaruan berikut pada set bernama untuk kebijakan rute BGP Cloud Router:

  • Mencantumkan set bernama
  • Menghapus set bernama
  • Memperbarui set bernama
  • Menambahkan elemen set bernama
  • Menghapus elemen set bernama

Mencantumkan set bernama di router

Gunakan perintah list-named-sets untuk melihat nama dan jenis set bernama yang ditentukan di satu router.

gcloud compute routers list-named-sets ROUTER_NAME

Ganti ROUTER_NAME dengan nama Cloud Router Anda.

Menghapus set bernama

Jika set bernama direferensikan dalam kebijakan rute BGP apa pun di router, Anda tidak dapat menghapus set bernama.

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

Ganti kode berikut:

  • ROUTER_NAME: Nama Cloud Router Anda
  • SET_NAME: Nama set bernama yang ingin Anda hapus

Memperbarui set bernama di router

Saat memperbarui set bernama yang ada, sebaiknya download set bernama dari router dalam format YAML atau JSON menggunakan download-named-set perintah. Edit file YAML atau JSON secara lokal, lalu upload file yang diperbarui ke router menggunakan perintah upload-named-set. Perintah upload-named-set akan menimpa set bernama yang ada.

File yang Anda download dari router menyertakan kolom fingerprint, yang digunakan Cloud Router untuk mencocokkan set bernama yang ada dan mencegah pembaruan yang bertentangan.

  1. Untuk mendownload set bernama, jalankan perintah download-named-set: 

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

    Ganti kode berikut:

    • ROUTER_NAME dengan nama Cloud Router.
    • SET_NAME dengan nama set.
    • FILE_NAME dengan nama file yang Anda inginkan untuk set bernama, termasuk jalur dan ekstensi nama file.
    • FORMAT dengan format set bernama, baik JSON maupun YAML.

  2. Ubah set bernama yang didownload di editor teks pilihan Anda menggunakan format JSON atau YAML.

    Contoh berikut menggunakan dua file YAML untuk memperbarui set bernama allowed-prefixes dan 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. Untuk mengupload set bernama, jalankan perintah upload-named-set: 

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

    Ganti kode berikut:

    • ROUTER_NAME dengan nama Cloud Router.
    • SET dengan nama set.
    • NAME dengan lokasi dan nama file YAML atau JSON yang Anda edit.
    • FORMAT dengan format set bernama, baik JSON maupun YAML.

Menambahkan elemen set bernama

Jalankan perintah berikut:

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

Ganti kode berikut:

  • ROUTER_NAME: Nama Cloud Router Anda
  • SET_NAME: Nama set bernama yang ingin Anda perbarui
  • CEL_EXPRESSION: Elemen yang akan ditambahkan ke set, yang dinyatakan dalam Common Expression Language (CEL)

Menghapus elemen set bernama

Jalankan perintah berikut:

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

Ganti kode berikut:

  • ROUTER_NAME: Nama Cloud Router Anda
  • SET_NAME: Nama set bernama yang ingin Anda perbarui
  • CEL_EXPRESSION: Elemen yang akan dihapus dari set, yang dinyatakan dalam Common Expression Language (CEL)

Langkah berikutnya