Membuat dan mengelola router

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

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

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

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

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

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

Mengakhiri sesi peering BGP

Untuk mengakhiri 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: Google Cloud region tempat zona Distributed Cloud terhubung berada.
  • ZONE_NAME: nama zona Distributed Cloud terhubung.

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. 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_IPv4_RANGE \
    --peer-ipv6-range=PEER_IPv6_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_IPv4_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.
  • PEER_IPv6_RANGE: rentang CIDR IPv6 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: Google Cloud region tempat zona Distributed Cloud terhubung berada.
  • ZONE_NAME: nama zona Distributed Cloud terhubung.

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

Membuat daftar router

Untuk membuat daftar router yang disediakan dalam zona Distributed Cloud terhubung, 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: Google Cloud region tempat zona Distributed Cloud terhubung berada.
  • ZONE_NAME: nama zona Distributed Cloud terhubung.

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

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

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

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

Langkah berikutnya