Membuat rentang grup multicast

Halaman ini menjelaskan langkah-langkah yang harus diikuti oleh administrator multicast untuk membuat rentang grup multicast.

Untuk ringkasan proses konfigurasi multicast, lihat Ringkasan konfigurasi multicast.

Sebelum memulai

Rentang grup multicast harus dikaitkan dengan domain multicast tertentu. Sebelum membuat rentang grup multicast, ikuti langkah-langkah untuk membuat domain multicast.

Membuat rentang grup multicast

Bagian ini menjelaskan cara membuat rentang grup multicast di domain. Anda dapat mengulangi langkah-langkah ini untuk membuat beberapa rentang grup dalam domain tertentu.

Membuat rentang grup

Kaitkan rentang alamat IP grup multicast dengan domain multicast.

gcloud

  1. Cadangkan rentang internal di jaringan VPC administrator multicast yang berisi alamat IP grup multicast yang ingin Anda gunakan. Untuk mencadangkan rentang internal, gunakan perintah network-connectivity internal-ranges create.

    gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \
   --network=ADMIN_NETWORK \
   --ip-cidr-range=CIDR_RANGE

    Ganti nilai berikut:

    • INTERNAL_RANGE_NAME: nama untuk rentang internal yang akan dicadangkan
    • ADMIN_NETWORK: nama jaringan administrator multicast

    • CIDR_RANGE: rentang CIDR yang akan dipesan

      Rentang CIDR yang Anda tentukan harus berupa alamat kelas D (seperti 224.0.0.0 - 239.255.255.255) dan harus memiliki awalan yang lebih besar dari atau sama dengan /23. Misalnya, 224.1.60.0/24 adalah rentang yang valid. Rentang dengan panjang awalan /22 atau kurang tidak valid.

    Untuk mengetahui informasi selengkapnya tentang cara membuat rentang internal, lihat Membuat dan menggunakan rentang internal.

  2. Buat rentang grup multicast menggunakan rentang internal yang Anda pesan. Untuk membuat rentang grup multicast, gunakan perintah network-services multicast-group-ranges create.

    gcloud network-services multicast-group-ranges create GROUP_RANGE_NAME \
   --multicast-domain="projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \
   --reserved-internal-range="projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME" \
   --location=global \
   [--require-explicit-accept ] \
   [--consumer-accept-list=CONSUMER_ACCEPT_LIST] \
   [--distribution-scope=DISTRIBUTION_SCOPE] \
   [--enable-logging | --no-enable-logging]

    Ganti nilai berikut:

    • GROUP_RANGE_NAME: nama untuk rentang grup multicast
    • DOMAIN_NAME: nama domain multicast yang Anda buat sebelumnya
    • ADMIN_PROJECT: ID project administrator multicast
    • INTERNAL_RANGE_NAME: nama rentang internal yang Anda cadangkan sebelumnya

    • Tentukan properti berikut untuk traffic multicast, keanggotaan grup, dan logging.

      Kecuali untuk cakupan distribusi traffic, Anda dapat memperbarui setiap properti sesuai kebutuhan di kemudian waktu.

      • --require-explicit-accept: menentukan project mana yang dapat menggunakan rentang grup multicast jika daftar penerima multicast kosong. Konfigurasi ini menentukan apakah project konsumen multicast dapat Mengaktifkan jaringan VPC konsumen multicast untuk rentang grup.
        • Untuk menolak semua project, sertakan tanda ini. Project hanya dapat menggunakan rentang grup jika Anda menambahkannya ke daftar yang diterima konsumen multicast.
        • (Default) Untuk mengizinkan semua project, kecualikan tanda ini. Project apa pun yang memiliki akses ke domain multicast dapat menggunakan rentang grup. Dalam topologi bintang Network Connectivity Center, Anda memberikan akses project ke domain dengan menyetujuinya ke hub.

      • CONSUMER_ACCEPT_LIST: jika Anda menentukan --require-explicit-accept, Anda dapat memasukkan daftar project konsumen multicast yang dapat menggunakan rentang grup multicast ini. Jika project konsumen multicast tidak ada dalam daftar yang diizinkan, maka project tersebut tidak dapat membuat konfigurasi konsumen multicast menggunakan rentang grup ini.

        Anda dapat menentukan hingga 100 project berdasarkan ID atau nama project.

      • DISTRIBUTION_SCOPE: menentukan cakupan lokasi traffic multicast. Anda tidak dapat memperbarui properti ini nanti.

        • Untuk mengizinkan rentang ini mengirim traffic multicast hanya dalam zona, tetapkan tanda ini ke intra-zone.
        • (Default) Untuk mengizinkan rentang ini mengirim traffic multicast di seluruh zona, setel tanda ini ke intra-region.

      • --[no-]enable-logging: menentukan apakah logging peristiwa keanggotaan grup diaktifkan.

        • Untuk mengaktifkan logging, gunakan --enable-logging.
        • (Default) Untuk menonaktifkan logging, gunakan --no-enable-logging.

API

  1. Cadangkan rentang internal di jaringan VPC administrator multicast yang berisi alamat IP grup multicast yang ingin Anda gunakan. Untuk mencadangkan rentang internal, gunakan metode internalRanges.create.

    POST https://networkconnectivity.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/internalRanges?internalRangeId=INTERNAL_RANGE_NAME
{
  "network": "projects/ADMIN_PROJECT/global/networks/ADMIN_NETWORK",
  "ipCidrRange": "CIDR_RANGE"
}

    Ganti nilai berikut:

    • INTERNAL_RANGE_NAME: nama untuk rentang internal yang akan dicadangkan
    • ADMIN_PROJECT: ID project administrator multicast
    • ADMIN_NETWORK: nama jaringan administrator multicast

    • CIDR_RANGE: rentang CIDR yang akan dipesan

      Rentang CIDR yang Anda tentukan harus berupa alamat kelas D (seperti 224.0.0.0 - 239.255.255.255) dan harus memiliki awalan yang lebih besar dari atau sama dengan /23. Misalnya, 224.1.60.0/24 adalah rentang yang valid. Rentang dengan panjang awalan /22 atau kurang tidak valid.

    Untuk mengetahui informasi selengkapnya tentang cara membuat rentang internal, lihat Membuat dan menggunakan rentang internal.

  2. Buat rentang grup multicast menggunakan rentang internal yang Anda pesan. Untuk membuat rentang grup multicast, gunakan metode multicastGroupRanges.create.

    POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/multicastGroupRanges?multicastGroupRangeId=GROUP_RANGE_NAME
{
  "multicastDomain": "projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME",
  "reservedInternalRange": "projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME",
  "requireExplicitAccept": "REQUIRE_EXPLICIT_ACCEPT",
  "consumerAcceptList": [
      "CONSUMER_ACCEPT_LIST"
  ],
  "distributionScope": "DISTRIBUTION_SCOPE",
  "logConfig": {
      "enabled": "LOGGING_ENABLED"
 }
}

    Ganti nilai berikut:

    • GROUP_RANGE_NAME: nama untuk rentang grup multicast
    • ADMIN_PROJECT: ID project administrator multicast
    • DOMAIN_NAME: nama domain multicast yang Anda buat sebelumnya
    • INTERNAL_RANGE_NAME: nama rentang internal yang Anda cadangkan sebelumnya

    Untuk menentukan properti untuk traffic multicast, keanggotaan grup, dan logging, sertakan kolom berikut dalam isi permintaan. Kecuali untuk cakupan distribusi traffic, Anda dapat memperbarui setiap properti sesuai kebutuhan di kemudian hari.

    • REQUIRE_EXPLICIT_ACCEPT: menentukan project mana yang dapat menggunakan rentang grup multicast jika consumerAcceptList kosong. Konfigurasi ini menentukan apakah project konsumen multicast dapat Mengaktifkan jaringan VPC konsumen multicast untuk rentang grup.
      • Untuk menolak semua project, tetapkan ke true. Project hanya dapat menggunakan rentang grup jika Anda menambahkannya ke consumerAcceptList.
      • (Default) Untuk mengizinkan semua project, tetapkan ke false. Project apa pun yang memiliki akses ke domain multicast dapat menggunakan rentang grup. Dalam topologi bintang Network Connectivity Center, Anda memberikan akses project ke domain dengan menyetujuinya ke hub.

    • CONSUMER_ACCEPT_LIST: jika Anda menetapkan requireExplicitAccept ke true, Anda dapat memasukkan daftar project konsumen multicast yang dapat menggunakan rentang grup multicast ini.

      Jika project konsumen multicast tidak ada dalam daftar yang diizinkan, maka project tersebut tidak dapat membuat konfigurasi konsumen multicast menggunakan rentang grup ini.

      Anda dapat menentukan hingga 100 project berdasarkan ID atau nama project. Gunakan format berikut: "consumerAcceptList": ["project-1", "project-2"].

    • DISTRIBUTION_SCOPE: menentukan cakupan lokasi traffic multicast. Anda tidak dapat memperbarui properti ini nanti.

      • Untuk mengizinkan rentang ini mengirim traffic multicast hanya dalam zona, tetapkan ke INTRA_ZONE.
      • (Default) Untuk mengizinkan rentang ini mengirim traffic multicast di seluruh zona, setel ke INTRA_REGION.

    • LOGGING_ENABLED: menentukan apakah logging peristiwa keanggotaan grup diaktifkan.

      • Untuk mengaktifkan logging, tetapkan ke true.
      • (Default) Untuk menonaktifkan logging, setel ke false.

Mengaktifkan rentang grup

Aktifkan rentang grup di setiap zona tempat produsen atau konsumen multicast perlu menggunakan alamat IP grup terkait.

Jika Anda tidak mengaktifkan rentang grup di zona tertentu, alamat IP grup terkait tidak dapat digunakan untuk mengirim atau menerima traffic multicast di zona tersebut.

gcloud

Untuk mengaktifkan rentang grup multicast, gunakan perintah network-services multicast-group-range-activations create.

  gcloud network-services multicast-group-range-activations create GROUP_RANGE_ACTIVATION_NAME \
     --multicast-domain-activation="projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME" \
     --multicast-group-range="projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME" \
     --location=ZONE \
     [--enable-logging | --no-enable-logging]

Ganti nilai berikut:

  • GROUP_RANGE_ACTIVATION_NAME: nama untuk aktivasi rentang grup multicast
  • ADMIN_PROJECT: project ID administrator multicast
  • ZONE: zona tempat mengaktifkan rentang grup. Ini harus berupa zona tempat Anda sebelumnya mengaktifkan domain.
  • DOMAIN_ACTIVATION_NAME: nama aktivasi domain yang Anda buat sebelumnya di zona ini
  • GROUP_RANGE_NAME: nama rentang grup yang Anda buat sebelumnya
  • --[no-]enable-logging: opsional, menentukan apakah logging peristiwa keanggotaan grup diaktifkan. Mengonfigurasi tanda ini pada aktivasi rentang grup zonal akan menggantikan setelan untuk rentang grup global.
    • Untuk mengaktifkan logging, gunakan --enable-logging.
    • (Default) Untuk menonaktifkan logging, gunakan --no-enable-logging.

API

Untuk mengaktifkan rentang grup multicast, gunakan metode multicastGroupRangeActivations.create.

POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/ZONE/multicastGroupRangeActivations?multicastGroupRangeActivationId=GROUP_RANGE_ACTIVATION_NAME
{
    "multicastDomainActivation": "projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME",
    "multicastGroupRange": "projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME",
    "logConfig": {
          "enabled": "LOGGING_ENABLED"
    }
}

Ganti nilai berikut:

  • GROUP_RANGE_ACTIVATION_NAME: nama untuk aktivasi rentang grup multicast
  • ADMIN_PROJECT: project ID administrator multicast
  • ZONE: zona tempat mengaktifkan rentang grup. Ini harus berupa zona tempat Anda sebelumnya mengaktifkan domain.
  • DOMAIN_ACTIVATION_NAME: nama aktivasi domain yang Anda buat sebelumnya di zona ini
  • GROUP_RANGE_NAME: nama rentang grup yang Anda buat sebelumnya
  • LOGGING_ENABLED: menentukan apakah logging peristiwa keanggotaan grup diaktifkan. Mengonfigurasi logging pada aktivasi rentang grup zonal akan menggantikan setelan untuk rentang grup global.
    • Untuk mengaktifkan logging, tetapkan ke true.
    • (Default) Untuk menonaktifkan logging, setel ke false.

Langkah berikutnya