Memberitahukan rentang alamat kustom

Gunakan mode iklan kustom di Cloud Router atau sesi Border Gateway Protocol (BGP) di Cloud Router untuk mengiklankan rentang alamat IP selain rentang alamat IP subnet jaringan Virtual Private Cloud (VPC) Anda. Misalnya, Anda dapat mengiklankan rentang alamat IP eksternal, rentang alamat IP internal arbitrer, atau alamat IP internal dari rentang alamat IP dari jaringan VPC lain yang terhubung ke jaringan VPC Anda. Anda. Jaringan VPC Anda mungkin terhubung melalui Peering Jaringan VPC atau jari-jari VPC di Network Connectivity Center.

Jika Cloud Router dikonfigurasi untuk menggunakan mode, default, Cloud Router hanya memberitahukan rute untuk subnet yang merupakan bagian dari jaringan VPC yang sama dengan Cloud Router. Dalam mode ini, Cloud Router mengecualikan semua rute dan rute statis yang dipelajari secara dinamis dari jaringan VPC lain, seperti rute yang dipelajari oleh Peering atau oleh jari-jari VPC di Network Connectivity Center.

Untuk menentukan rute kustom yang diberitahukan saat Anda membuat Cloud Router atau mengonfigurasi sesi BGP, lihat Membuat Router Cloud atau Menetapkan sesi BGP.

Sebelum memulai

gcloud

Jika Anda ingin menggunakan contoh command line dalam panduan ini, lakukan tindakan berikut:

  1. Instal Google Cloud CLI atau update ke versi terbaru.
  2. Tetapkan region dan zona default.

API

Jika Anda ingin menggunakan contoh API dalam panduan ini, siapkan akses API.

Menentukan rute kustom yang diberitahukan pada Cloud Router

Untuk menentukan rute kustom yang diberitahukan pada Cloud Router yang ada, ikuti langkah-langkah berikut.

Konsol

  1. Di konsol Google Cloud, buka halaman Cloud Router.

    Buka Cloud Router

  2. Pilih Cloud Router yang akan diupdate.

  3. Di halaman detail Router, klik Edit.

  4. Di bagian Advertised routes untuk Routes, pilih Create custom routes.

  5. Centang kotak Beriklan semua subnet yang terlihat oleh Cloud Router untuk terus mengiklankan subnet yang tersedia untuk Cloud Router. Mengaktifkan opsi ini meniru perilaku Cloud Router dalam mode iklan default.

  6. Pilih Tambahkan rute kustom untuk menambahkan rute yang diiklankan.

  7. Mengonfigurasikan rute kustom yang diberitahukan:

    • Sumber: Pilih Rentang IP kustom.

    • Rentang alamat IP: Gunakan notasi CIDR untuk menentukan rentang IP kustom.

      Anda dapat menentukan pilihan IP kustom IPv4 dan IPv6. Namun, rentang kustom IPv6 hanya diberitahukan dalam sesi BGP tempat IPv6 diaktifkan.

      Jika Anda memberikan awalan alamat IP tanpa subnet mask, awalan tersebut akan ditafsirkan sebagai subnet mask /32 untuk IPv4 dan /128 untuk IPv6. Untuk informasi tentang jumlah maksimum rute kustom yang dipelajari yang dapat Anda miliki, lihat Batas.

    • Deskripsi: Tambahkan deskripsi untuk membantu Anda mengidentifikasi tujuan rute khusus yang diiklankan, lalu klik Selesai.

  8. Setelah Anda selesai menambahkan rute kustom yang diiklankan, klik Simpan.

gcloud

Jalankan perintah update. Untuk menentukan rentang IP kustom, gunakan flag --set-advertisement-ranges atau flag --add-advertisement-ranges.

  1. Menggunakan flag --set-advertisement-ranges; semua iklan khusus yang ada akan diganti:

    gcloud compute routers update ROUTER_NAME \
       --project=PROJECT_ID \
       --advertisement-mode custom \
       --set-advertisement-groups=ADVERTISED_GROUPS \
       --set-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Ganti kode berikut:

    • ROUTER_NAME: nama Cloud Router
    • PROJECT_ID: project yang berisi Cloud Router
    • ADVERTISED_GROUPS: grup yang ditentukan Google dan diberitahukan secara dinamis oleh Cloud Router

      Satu-satunya nilai yang valid adalah all_subnets, yang memberitahukan subnet berdasarkan mode perutean dinamis jaringan VPC (mirip dengan mode pemberitahuan default).

    • ADVERTISED_IP_RANGES: konten array baru rentang alamat IP

      Anda dapat menentukan pilihan IP kustom IPv4 dan IPv6. Namun, rentang kustom IPv6 hanya diiklankan dalam sesi BGP tempat IPv6 diaktifkan.

      Jika Anda memberikan awalan alamat IP tanpa subnet mask, awalan tersebut akan ditafsirkan sebagai subnet mask /32 untuk IPv4 dan /128 untuk IPv6. Untuk informasi tentang jumlah maksimum rute kustom yang dipelajari yang dapat Anda miliki, lihat Batas.

    Contoh berikut mengupdate my-router Cloud Router untuk mengiklankan semua subnet dan rentang IP kustom 192.0.2.0/24 dan 198.51.100.0/24:

    gcloud compute routers update my-router \
       --advertisement-mode custom \
       --set-advertisement-groups=all_subnets \
       --set-advertisement-ranges='192.0.2.0/24,198.51.100.0/24'
    

    Contoh berikut mengupdate my-router Cloud Router untuk mengiklankan semua subnet dan rentang IPv6 default:

    gcloud compute routers update my-router \
       --advertisement-mode custom \
       --set-advertisement-groups=all_subnets \
       --set-advertisement-ranges='2001:db8:abcd:12::/64'
    

    Cloud Router hanya mengiklankan rentang IPv6 dalam sesi BGP yang diaktifkan untuk IIPv6.

    Tanda --set-advertisement-groups menerima grup yang ditentukan Google yang diiklankan secara dinamis oleh Cloud Router. Anda dapat menghapus --set-advertisement-groups untuk mengecualikan iklan subnet. Untuk mengetahui daftar semua grup iklan, lihat flag set-advertisement-groups dalam dokumentasi Google SDK.

  2. Gunakan flag --add-advertisement-ranges yang mengharuskan ode iklan Cloud Router sudah ditetapkan ke custom:

    gcloud compute routers update ROUTER_NAME \
       --add-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Ganti kode berikut:

    • ROUTER_NAME: nama Cloud Router
    • ADVERTISED_IP_RANGES: konten array baru rentang alamat IP

    Contoh berikut menambahkan 203.0.113.1 alamat IP kustom ke iklan Cloud Router:

    gcloud compute routers update my-router \
       --add-advertisement-ranges='203.0.113.1'
    

    Contoh berikut menambahkan rentang IPv6 kustom 2001:db8:abcd:12::/64 ke iklan Cloud Router:

    gcloud compute routers update my-router \
       --add-advertisement-ranges='2001:db8:abcd:12::/64'
    

    Cloud Router hanya mengiklankan rentang IPv6 di sesi BGP yang diaktifkan untuk IPv6.

API

Gunakan routers.patch metode untuk memperbarui kolom bgp.advertisedGroups[] dan bgp.advertisedIpRanges[] .

Kolom bgp.advertisedGroups[] dan bgp.advertisedIpRanges[] menyimpan array grup yang diiklankan dan rentang alamat IP yang diiklankan. Saat Anda melakukan PATCH pada kolom ini, Anda akan menimpa array yang ada dengan yang baru dalam permintaan Anda.

  1. Kirim permintaan GET untuk mendapatkan array grup yang diberitahukan dan rentang alamat IP yang diberitahukan saat ini di router. Untuk mengetahui detailnya, liat Melihat konfigurasi sesi BGP.

  2. Kirim permintaan PATCH dengan array baru dari grup yang diberitahukan dan rentang alamat IP yang diberitahukan. Gunakan array dari GET permintaan di tlangkah sebelumnya, dan tambahkan grup atau rentang alamat IP apa pun yang Anda inginkan di router.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgp": {
        "advertisedGroups": [
        "ADVERTISED_GROUPS"
       ],
        "advertisedIpRanges": [
        ADVERTISED_IP_RANGES
       ]
     }
    }
    

    Ganti kode berikut:

    • PROJECT_ID: project yang berisi Cloud Router
    • REGION: region tempat Cloud Router berada
    • ROUTER_NAME: nama Cloud Router
    • ADVERTISED_GROUPS: grup yang ditentukan Google dan diberitahukan secara dinamis oleh Cloud Router

    Satu-satunya nilai yang valid adalah ALL_SUBNETS, yang memberitahukan subnet berdasarkan mode perutean dinamis jaringan VPC (mirip dengan iklan default).

    • ADVERTISED_IP_RANGES: konten array baru rentang alamat IP

    Anda dapat menentukan pilihan IP kustom IPv4 dan IPv6. Namun, rentang kustom IPv6 hanya diiklankan dalam sesi BGP tempat IPv6 diaktifkan.

    Jika Anda memberikan awalan alamat IP tanpa subnet mask, awalan tersebut akan ditafsirkan sebagai subnet mask /32 untuk IPv4 dan /128 untuk IPv6. Untuk informasi tentang jumlah maksimum rute kustom yang dipelajari yang dapat Anda miliki, lihat Batas.

    Contoh berikut berisi dua rentang alamat IPv4 dan satu rentang alamat IPv6:

        {
          "range": "192.0.2.0/24",
          "description": "First example range"
        },
        {
          "range": "198.51.100.0/24",
          "description": "Second example range"
        },
        {
          "range": "2001:db8:abcd:12::/64",
          "description: "Third example range"
        }
    

Menentukan rute kustom yang diberitahukan untuk sesi BGP

Untuk menentukan rute kustom yang diberitahukan untuk sesi BGP yang ada, ikuti langkah-langkah berikut.

Konsol

  1. Di konsol Google Cloud, buka halaman Cloud Router.

    Buka Cloud Router

  2. Pilih Cloud Router yang berisi sesi BGP yang akan diupdate.

  3. Di halaman Detail rute, pilih sesi BGP yang akan diupdate.

  4. Di halaman Detail sesi BGP, klik Edit.

  5. Untuk Rute, pilih Create custom routes.

  6. Centang kotak Beriklan semua subnet yang terlihat oleh Cloud Router untuk terus mengiklankan subnet yang tersedia untuk Cloud Router. Mengaktifkan opsi ini akan meniru perilaku default Cloud Router.

  7. Pilih Tambahkan rute kustom untuk menambahkan rute yang diiklankan.

  8. Mengonfigurasikan pemberitahuan rute:

    • Sumber: Pilih Rentang IP kustom.

    • Rentang alamat IP: Gunakan notasi CIDR untuk menentukan rentang IP kustom. Anda dapat menentukan pilihan IP kustom IPv4 dan IPv6. Namun, rentang kustom IPv6 hanya diiklankan dalam sesi BGP tempat IPv6 diaktifkan.

      Jika Anda memberikan awalan alamat IP tanpa subnet mask, awalan tersebut akan ditafsirkan sebagai subnet mask /32 untuk IPv4 dan /128 untuk IPv6. Untuk mengetahui informasi tentang jumlah maksimum rute kustom yang dipelajari yang dapat Anda miliki, lihat Batas.

    • Deskripsi: Tambahkan deskripsi untuk membantu Anda mengidentifikasi tujuan iklan pemberitahuan rute ini, lalu klik Selesai.

  9. Setelah Anda selesai menambahkan rute kustom yang diiklankan, klik Simpan.

gcloud

Jalankan perintah update-bgp-peer. Untuk menentukan rentang IP kustom, gunakan flag --set-advertisement-ranges atau flag --add-advertisement-ranges.

  1. Menggunakan flag --set-advertisement-ranges; semua iklan khusus yang ada akan diganti:

    gcloud compute routers update-bgp-peer ROUTER_NAME \
        --peer-name=PEER_NAME \
        --advertisement-mode custom \
        --set-advertisement-groups=ADVERTISED_GROUPS \
        --set-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Ganti kode berikut:

    • ROUTER_NAME: nama Cloud Router
    • PEER_NAME: nama peer BGP Anda
    • Secara opsional, tambahkan flag --enable-ipv6 jika Anda menambahkan rentang IPv6 kustom.
    • ADVERTISED_GROUPS: grup yang ditentukan Google dan diberitahukan secara dinamis oleh Cloud Router

      Satu-satunya nilai yang valid adalah all_subnets, yang memberitahukan subnet berdasarkan mode perutean dinamis jaringan VPC (mirip dengan iklan default).

    • ADVERTISED_IP_RANGES: konten array baru rentang alamat IP

      Anda dapat menentukan pilihan IP kustom IPv4 dan IPv6. Namun, rentang kustom IPv6 hanya diiklankan dalam sesi BGP tempat IPv6 diaktifkan.

      Jika Anda memberikan awalan alamat IP tanpa subnet mask, awalan tersebut akan ditafsirkan sebagai subnet mask /32 untuk IPv4 dan /128 untuk IPv6. Untuk informasi tentang jumlah maksimum rute kustom yang dipelajari yang dapat Anda miliki, lihat Batas.

    Contoh berikut memperbarui sesi BGP my-bgp-session di my-router Cloud Router untuk mengiklankan semua subnet dan rentang IP kustom 192.0.2.1, 198.51.100.0/24, dan 2001:db8:abcd:12::/64.

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --enable-ipv6 \
        --advertisement-mode custom \
        --set-advertisement-groups=all_subnets \
        --set-advertisement-ranges='192.0.2.1,198.51.100.0/24,2001:db8:abcd:12::/64'
    

    Flag --set-advertisement-groups menerima grup yang ditentukan Google yang diberitahukan secara dinamis oleh sesi BGP. Anda dapat menghapus --add-advertisement-groups untuk mengecualikan iklan subnet. Untuk mengetahui daftar semua grup iklan, lihat flag set-advertisement-groups dalam dokumentasi Google SDK.

  2. Gunakan flag --add-advertisement-ranges yang mengharuskan ode iklan Cloud Router sudah ditetapkan ke custom:

    gcloud compute routers update-bgp-peer ROUTER_NAME \
        --peer-name=PEER_NAME \
        --add-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Ganti kode berikut:

    • ROUTER_NAME: nama Cloud Router
    • PEER_NAME: nama peer BGP Anda
    • ADVERTISED_IP_RANGES: konten array baru rentang alamat IP

      Anda dapat menentukan pilihan IP kustom IPv4 dan IPv6. Namun, rentang kustom IPv6 hanya diiklankan dalam sesi BGP tempat IPv6 diaktifkan.

      Jika Anda memberikan awalan alamat IP tanpa subnet mask, awalan tersebut akan ditafsirkan sebagai subnet mask /32 untuk IPv4 dan /128 untuk IPv6. Untuk informasi tentang jumlah maksimum rute kustom yang dipelajari yang dapat Anda miliki, lihat Batas.

    Contoh berikut menambahkan 198.51.100.1 alamat IP kustom ke iklan Cloud Router:

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --add-advertisement-ranges='198.51.100.1'
    

    Contoh berikut menambahkan alamat 2001:db8:abcd:12::/64 IPv6 kustom address ke iklan Cloud Router:

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --enable-ipv6 \
        --add-advertisement-ranges='2001:db8:abcd:12::/64'
    

API

Gunakan metode routers.patch untuk memperbarui kolom bgpPeers[].

Kolom bgpPeers[] menerima array peer BGP. Saat melakukan PATCH pada kolom ini, Anda akan menimpa array peer BGP yang ada dengan array baru yang disertakan dalam permintaan Anda.

  1. Kirim permintaan GET untuk mendapatkan array peer BGP saat ini untuk router. Untuk mengetahui detailnya, baca Melihat konfigurasi sesi BGP.

  2. Kirim permintaan PATCH dengan array baru peer BGP. Untuk setiap peer BGP yang ingin Anda tambahkan iklan, lakukan hal berikut:

    • Tambahkan iklan rentang alamat IP yang Anda inginkan di bgpPeers[].advertisedIpRanges[] kolom.
    • Tambahkan iklan grup yang Anda inginkan di bgpPeers[].advertisedGroups[] kolom.

      Satu-satunya nilai yang valid adalah ALL_SUBNETS, yang memberitahukan subnet berdasarkan mode perutean dinamis jaringan VPC (mirip dengan mode pemberitahuan default).

      Untuk mengetahui informasi selengkapnya tentang nilai ini, lihat routers.patch dalam dokumentasi API.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Ganti kode berikut:

    • PROJECT_ID: project yang berisi Cloud Router
    • REGION: region tempat Cloud Router berada
    • ROUTER_NAME: nama Cloud Router
    • BGP_PEERS: konten array baru peer BGP

    Contoh berikut berisi dua peer BGP dengan iklan kustom:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "enableIpv6": true,
          "advertisedRoutePriority": 100,
          "advertiseMode": "CUSTOM",
          "advertisedGroups": ["ALL_SUBNETS"],
          "advertisedIpRanges": [
            {
              "range": "1.2.3.4",
              "description": "First example range"
            },
            {
              "range": "6.7.0.0/16",
              "description": "Second example range"
            },
            {
              "range": "2001:db8:abcd:12::/64",
              "description: "Third example range"
            }
          ]
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "CUSTOM",
          "advertisedIpRanges": [
            {
              "range": "192.168.10.0/24",
              "description": "Fourth example range"
            }
          ]
        }
    

Langkah selanjutnya

  • Untuk melihat konfigurasi Cloud Router, sesi BGP-nya, dan rute yang diberitahukan Cloud Router, baca bagian Melihat detail Cloud Router.

  • Untuk memecahkan masalah dengan rute pemberitahuan khusus, lihat Pemecahan masalah.