Membuat dan mengelola router

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

Fungsi ini hanya tersedia di rack Distributed Cloud connected. Server Distributed Cloud connected tidak mendukung resource router.

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

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 Edge Network Admin (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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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.

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 northbound 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 Edge Network Admin (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 interconnect tempat lampiran interconnect target dikonfigurasi.
  • IP_MASK_LENGTH: panjang mask untuk alamat IP interconnect yang ditentukan.
  • REGION: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected target.

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 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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected target.

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 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_ADDRESSES \
    --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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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 Edge Network Admin (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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected target.

Mengonfigurasi peer dalam sesi peering BGP

Anda dapat menambahkan dan menghapus peer BGP dalam sesi peering BGP yang dibuat 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 Edge Network Admin (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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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 Edge Network Admin (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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected target.

Membuat daftar router

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

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Network Viewer (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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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 Edge Network Viewer (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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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 Edge Network Viewer (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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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 Edge Network Admin (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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected 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: the Google Cloud region tempat zona Distributed Cloud connected target berada.
  • ZONE_NAME: nama zona Distributed Cloud connected target.
  • ROUTER_ID: ID router target.

Langkah berikutnya