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 bersama dengan lampiran interconnect yang sesuai pada saat yang sama. Untuk mengetahui informasi selengkapnya tentang cara membuat lampiran interconnect, lihat Membuat lampiran interconnect.

Membuat router

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

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Jaringan Edge (roles/edgenetwork.admin) di Google Cloud project 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: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.
  • 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 target Google Cloud .
  • REGION: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.
  • ROUTER_ID: ID yang secara unik mengidentifikasi router ini.
  • LABELS: daftar label yang akan diterapkan ke resource router ini.
  • NETWORK_NAME: nama jaringan yang dilayani oleh 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.

Menetapkan sesi peering BGP di router

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

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

Menetapkan sesi peering utara

Untuk menetapkan sesi peering utara di router dengan lampiran interconnect, selesaikan langkah-langkah di bagian ini. Lampiran interconnect target harus dikaitkan dengan router target.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Jaringan Edge (roles/edgenetwork.admin) di Google Cloud project 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 interconnect target dalam router target.
  • INTERCONNECT_ADDRESS: alamat IPv4 dari interconnect tempat lampiran interconnect target dikonfigurasi.
  • IP_MASK_LENGTH: panjang mask untuk alamat IP interconnect yang ditentukan.
  • REGION: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

Menetapkan sesi peering selatan

Untuk menetapkan sesi peering selatan di router dengan subnetwork, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Jaringan Edge (roles/edgenetwork.admin) di Google Cloud project 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: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

Menetapkan sesi peering loopback

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

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Jaringan Edge (roles/edgenetwork.admin) di Google Cloud project 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, dipisahkan koma.
  • REGION: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

Menghentikan sesi peering BGP

Untuk menghentikan sesi peering BGP antara router dan lampiran interconnect, 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 Admin Jaringan Edge (roles/edgenetwork.admin) di Google Cloud project 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: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

Mengonfigurasi peer dalam sesi peering BGP

Anda dapat menambahkan dan menghapus peer BGP dalam sesi peering BGP yang ditetapkan antara router dan lampiran interconnect, subnetwork, atau jaringan. Saat Anda menambahkan peer ke sesi peering BGP, Bidirectional Forwarding Detection (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 workload 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 Admin Jaringan Edge (roles/edgenetwork.admin) di Google Cloud project 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: Autonomous System Number (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 interconnect, subnetwork, atau jaringan terkait.
  • INTERFACE_NAME: nama antarmuka yang sesuai dengan sesi BGP target.
  • REGION: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

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 Admin Jaringan Edge (roles/edgenetwork.admin) di Google Cloud project 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 tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

Membuat daftar router

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

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Viewer Jaringan Edge (roles/edgenetwork.viewer) di Google Cloud project 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: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

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 target Google Cloud .
  • REGION: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.
  • 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, tambahkan awalan ~ ke kolom yang diinginkan.
  • 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 Viewer Jaringan Edge (roles/edgenetwork.viewer) di Google Cloud project 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: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

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 target Google Cloud .
  • REGION: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.
  • 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 disebarkan ke seluruh zona.
  • RUNNING: resource telah berhasil disediakan dan disebarkan ke 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 Viewer Jaringan Edge (roles/edgenetwork.viewer) di Google Cloud project 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: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

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 target Google Cloud .
  • REGION: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.
  • 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 Admin Jaringan Edge (roles/edgenetwork.admin) di Google Cloud project 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: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.

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 target Google Cloud .
  • REGION: region tempat zona Distributed Cloud target berada. Google Cloud
  • ZONE_NAME: nama zona Distributed Cloud target.
  • ROUTER_ID: ID router target.

Langkah berikutnya