Membuat rentang grup multicast

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

Untuk ringkasan proses konfigurasi Cloud Multicast, lihat Ringkasan konfigurasi Cloud 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 di 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 dicadangkan

      Rentang CIDR yang Anda tentukan harus berupa alamat class D (seperti 224.0.0.0 - 239.255.255.255). Selain itu, jumlah total alamat IP dalam satu atau beberapa rentang grup multicast yang terkait dengan domain yang sama tidak boleh melebihi kuota Anda untuk Grup multicast per domain.

    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 cadangkan. 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 lain waktu.

      • --require-explicit-accept: menentukan project mana yang dapat menggunakan rentang grup multicast jika daftar penerimaan konsumen multicast kosong. Konfigurasi ini menentukan apakah project konsumen multicast dapat Mengaktifkan jaringan VPC konsumen multicast untuk rentang grup.
        • Untuk menolak semua project, sertakan flag ini. Project hanya dapat menggunakan rentang grup jika Anda menambahkannya ke daftar penerimaan konsumen multicast.
        • (Default) Untuk mengizinkan semua project, kecualikan flag ini. Setiap project yang memiliki akses ke domain multicast dapat menggunakan rentang grup. Dalam topologi bintang Network Connectivity Center (NCC), Anda memberikan akses project ke domain dengan menerimanya 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 penerimaan, project tersebut tidak dapat membuat konfigurasi konsumen multicast menggunakan rentang grup ini.

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

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

        • Untuk mengizinkan rentang ini mengirim traffic multicast hanya dalam satu zona, tetapkan flag ini ke intra-zone.
        • (Default) Untuk mengizinkan rentang ini mengirim traffic multicast di seluruh zona, tetapkan flag ini ke intra-region.
      • --[no-]enable-logging: menentukan apakah logging peristiwa keanggotaan grup diaktifkan untuk rentang grup. Setelan ini berlaku untuk semua aktivasi zona rentang grup yang tidak mengaktifkan atau menonaktifkan logging secara eksplisit.

        • Untuk mengaktifkan logging, gunakan --enable-logging.
        • (Default) Untuk membiarkan logging dinonaktifkan, hapus flag ini atau 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 dicadangkan

      Rentang CIDR yang Anda tentukan harus berupa alamat class D (seperti 224.0.0.0 - 239.255.255.255). Selain itu, jumlah total alamat IP dalam satu atau beberapa rentang grup multicast yang terkait dengan domain yang sama tidak boleh melebihi kuota Anda untuk Grup multicast per domain.

    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 cadangkan. 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 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 lain waktu.

    • 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. Setiap project yang memiliki akses ke domain multicast dapat menggunakan rentang grup. Dalam topologi bintang NCC, Anda memberikan akses project ke domain dengan menerimanya 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 penerimaan, project tersebut tidak dapat membuat konfigurasi konsumen multicast menggunakan rentang grup ini.

      Anda dapat menentukan hingga 100 project berdasarkan project ID atau nama. 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 satu zona, tetapkan ke INTRA_ZONE.
      • (Default) Untuk mengizinkan rentang ini mengirim traffic multicast di seluruh zona, tetapkan ke INTRA_REGION.
    • LOGGING_ENABLED: menentukan apakah logging peristiwa keanggotaan grup diaktifkan untuk rentang grup. Setelan ini berlaku untuk semua aktivasi zona rentang grup yang tidak mengaktifkan atau menonaktifkan logging secara eksplisit.

      • Untuk mengaktifkan logging, tetapkan ke true.
      • (Default) Untuk membiarkan logging dinonaktifkan, hapus kolom logConfig atau tetapkan enabled ke false.

Mengaktifkan rentang grup

Aktifkan rentang grup di setiap zona tempat produsen atau konsumen multicast memerlukan penggunaan 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. Zona ini harus merupakan zona tempat Anda mengaktifkan domain sebelumnya.
  • 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 pencatatan log peristiwa keanggotaan grup diaktifkan. Mengonfigurasi flag ini pada aktivasi rentang grup zona akan menggantikan setelan untuk rentang grup global.
    • (Default) Untuk mewarisi setelan logging dari rentang grup global, hapus flag ini.
    • Untuk mengaktifkan logging di zona ini, terlepas dari setelan global, gunakan --enable-logging.
    • Untuk menonaktifkan logging di zona ini, terlepas dari setelan global, 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. Zona ini harus merupakan zona tempat Anda mengaktifkan domain sebelumnya.
  • 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 zona akan mengganti setelan untuk rentang grup global.
    • (Default) Untuk mewarisi setelan logging dari rentang grup global, hapus kolom logConfig dari isi permintaan.
    • Untuk mengaktifkan logging di zona ini, terlepas dari setelan global, tetapkan enabled ke true.
    • Untuk menonaktifkan logging di zona ini, terlepas dari setelan global, tetapkan enabled ke false.

Langkah berikutnya