Membuat dan mengelola router

Halaman ini menjelaskan cara membuat dan mengelola resource router Google Distributed Cloud di zona Distributed Cloud.

Untuk mengetahui informasi selengkapnya tentang router Distributed Cloud, lihat Cara kerja Distributed Cloud.

Ingat hal berikut:

  • Anda dapat membuat satu router per jaringan Distributed Cloud.

  • Sebaiknya buat router beserta lampiran interkoneksi yang sesuai secara bersamaan. Untuk mengetahui informasi selengkapnya tentang cara membuat lampiran interkoneksi, lihat Membuat lampiran interkoneksi.

Membuat router

Untuk membuat router Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Admin (roles/edgenetwork.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers create:

gcloud edge-cloud networking routers create ROUTER_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --asn=ASN

Ganti kode berikut:

  • ROUTER_NAME: nama deskriptif yang secara unik mengidentifikasi router ini.
  • NETWORK_NAME: nama jaringan yang dilayani oleh router ini.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.
  • ASN: Autonomous System Number (ASN) untuk router ini. Anda dapat menentukan nilai dua byte atau empat byte. Mendukung nilai ASN publik dan pribadi.

API

Buat permintaan POST ke metode projects.locations.zones.routers.create:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?routerId=ROUTER_ID
{
 "labels": { LABELS,
  },
 "network": { NETWORK_NAME,
  },
 "asn": { ASN,
  },      
}

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: region Google Cloud tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.
  • ROUTER_ID: ID yang mengidentifikasi router ini secara unik.
  • LABELS: daftar label yang akan diterapkan ke resource router ini.
  • NETWORK_NAME: nama jaringan yang dilayani router ini.
  • ASN: Autonomous System Number (ASN) untuk router ini. Anda dapat menentukan nilai dua byte atau empat byte. Mendukung nilai ASN publik dan pribadi.

Membuat sesi peering BGP di router

Router memungkinkan Anda membuat jenis sesi peering Border Gateway Protocol (BGP) berikut:

Sesi peering BGP dibuat dengan menambahkan antarmuka ke router untuk komponen jaringan Distributed Cloud yang sesuai dengan jenis sesi peering.

Membuat sesi peering northbound

Untuk membuat sesi peering utara pada router dengan lampiran interkoneksi, selesaikan langkah-langkah di bagian ini. Lampiran interkoneksi target harus dikaitkan dengan router target.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Admin (roles/edgenetwork.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --interconnect-attachment=ATTACHMENT_NAME \
    --ip-address=INTERCONNECT_ADDRESS \
    --ip-mask-length=IP_MASK_LENGTH \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • INTERFACE_NAME: nama deskriptif untuk antarmuka ini.
  • ATTACHMENT_NAME: nama lampiran interkoneksi target dalam router target.
  • INTERCONNECT_ADDRESS: alamat IPv4 interkoneksi tempat lampiran interkoneksi target dikonfigurasi.
  • IP_MASK_LENGTH: panjang mask untuk alamat IP interkoneksi yang ditentukan.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

Membuat sesi peering southbound

Untuk membuat sesi peering southbound di router dengan subnetwork, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Admin (roles/edgenetwork.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --subnet=SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • INTERFACE_NAME: nama deskriptif untuk antarmuka ini.
  • SUBNETWORK_NAME: nama subnetwork target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

Membuat sesi peering loopback

Untuk membuat sesi peering loopback di router dengan jaringan, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Admin (roles/edgenetwork.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --loopback-ip-addresses=LOOPBACK_ADDRESSSES \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • INTERFACE_NAME: nama deskriptif untuk antarmuka ini.
  • LOOPBACK_ADDRESSES: alamat masuk dan keluar IPv4 untuk antarmuka loopback, yang dipisahkan koma.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

Menghentikan sesi peering BGP

Untuk menghentikan sesi peering BGP antara router dan lampiran interkoneksi, subnetwork, atau jaringan, Anda harus menghapus antarmuka untuk komponen jaringan tersebut dari router target. Untuk menghapus antarmuka, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Admin (roles/edgenetwork.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers remove-interface:

gcloud edge-cloud networking routers remove-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • INTERFACE_NAME: nama deskriptif untuk antarmuka ini.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

Mengonfigurasi peer dalam sesi peering BGP

Anda dapat menambahkan dan menghapus peer BGP dalam sesi peering BGP yang dibuat antara router dan lampiran interkoneksi, subnetwork, atau jaringan. Saat Anda menambahkan peer ke sesi peering BGP, Deteksi Penerusan Dua Arah (BFD) akan otomatis diaktifkan di router target dengan interval 100 md, jendela penerimaan minimum 100 md, dan pengali 3.

Setelah menambahkan peer ke sesi peering BGP target, Anda dapat menetapkan alamat IP peer ke Pod yang menjalankan beban kerja Anda. Untuk menemukan alamat IP peer, selesaikan langkah-langkah di Mendapatkan informasi tentang router.

Menambahkan peer ke sesi peering BGP

Untuk menambahkan peer ke sesi peering BGP, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Admin (roles/edgenetwork.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers add-bgp-peer:

gcloud edge-cloud networking routers add-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --peer-asn=PEER_ASN \
    --peer-ipv4-range=PEER_IP_RANGE \
    --interface=INTERFACE_NAME \                                                       \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • PEER_NAME: nama deskriptif untuk peer ini.
  • PEER_ASN: Nomor Sistem Otonom (ASN) untuk peer ini. Anda dapat menentukan nilai dua byte atau empat byte. Mendukung nilai ASN publik dan pribadi.
  • PEER_IP_RANGE: rentang CIDR IPv4 untuk peer ini. Rentang alamat ini harus berada di subnetwork yang sama dengan alamat IP atau rentang alamat untuk lampiran interkoneksi, subnetwork, atau jaringan terkait.
  • INTERFACE_NAME: nama antarmuka yang sesuai dengan sesi BGP target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

Menghapus peer dari sesi peering BGP

Untuk menghapus peer dari sesi peering BGP, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Admin (roles/edgenetwork.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers remove-bgp-peer:

gcloud edge-cloud networking routers remove-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • PEER_NAME: nama peer target.
  • REGION: region Google Cloud tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

Membuat daftar router

Untuk mencantumkan router yang disediakan dalam zona Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Viewer (roles/edgenetwork.viewer) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers list:

gcloud edge-cloud networking routers list \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

API

Buat permintaan GET ke metode projects.locations.zones.routers.list:

 GET /v1/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.
  • FILTER: ekspresi yang membatasi hasil yang ditampilkan ke nilai tertentu.
  • PAGE_SIZE: jumlah hasil yang akan ditampilkan per halaman.
  • SORT_BY: daftar nama kolom yang dipisahkan koma yang digunakan untuk mengurutkan hasil yang ditampilkan. Urutan pengurutan default adalah menaik; untuk urutan pengurutan menurun, beri awalan kolom yang diinginkan dengan ~.
  • PAGE_TOKEN: token yang diterima dalam respons terhadap permintaan daftar terakhir di kolom nextPageToken dalam respons. Kirim token ini untuk menerima halaman hasil.

Mendapatkan informasi tentang router

Untuk mendapatkan informasi tentang router Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Viewer (roles/edgenetwork.viewer) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers describe:

gcloud edge-cloud networking routers describe ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

API

Buat permintaan GET ke metode projects.locations.zones.routers.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.
  • ROUTER_ID: ID router target.

Operasi ini menampilkan informasi mendetail tentang resource, termasuk status penyediaannya:

  • PENDING: resource belum mulai disediakan dan belum disebarkan ke seluruh zona.
  • PROVISIONING: resource sedang disediakan; Anda harus menunggu hingga resource disalurkan ke seluruh zona.
  • RUNNING: resource telah berhasil disediakan dan disebarkan di seluruh zona; resource siap digunakan.
  • FAILED: penyediaan resource tidak berhasil; resource belum disebarkan ke seluruh zona.

Memeriksa status operasional router

Untuk memeriksa status operasional router Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Viewer (roles/edgenetwork.viewer) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers get-status:

gcloud edge-cloud networking routers get-status ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

API

Buat permintaan GET ke metode projects.locations.zones.routers.diagnose:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID:diagnose

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.
  • ROUTER_ID: ID router target.

Menghapus router

Untuk menghapus router Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Admin (roles/edgenetwork.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud networking routers delete:

gcloud edge-cloud networking routers delete ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ganti kode berikut:

  • ROUTER_NAME: nama router target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.

API

Buat permintaan DELETE ke metode projects.locations.zones.routers.delete:

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud target.
  • REGION: Google Cloud region tempat zona Distributed Cloud target berada.
  • ZONE_NAME: nama target zona Distributed Cloud.
  • ROUTER_ID: ID router target.

Langkah berikutnya