Membuat domain multicast

Halaman ini menjelaskan langkah-langkah yang harus Anda ikuti untuk membuat domain multicast.

Untuk ringkasan proses konfigurasi multicast, lihat Ringkasan konfigurasi multicast.

Sebelum memulai

Sebelum Anda membuat domain multicast, lihat bagian berikut.

Membuat atau mengidentifikasi jaringan VPC

Jika belum melakukannya, buat jaringan Virtual Private Cloud (VPC) untuk digunakan sebagai jaringan administrator multicast. Untuk mengetahui informasi selengkapnya tentang cara membuat jaringan VPC, lihat Membuat dan mengelola jaringan VPC

Jika jaringan administrator multicast Anda juga akan menghosting produsen atau konsumen multicast, seperti saat menggunakan topologi jaringan VPC tunggal, pastikan jaringan memiliki aturan firewall yang sesuai untuk mengizinkan traffic multicast. Lihat referensi berikut:

Menetapkan project Anda

Tetapkan gcloud CLI untuk menggunakan project Anda. Atau, Anda dapat menyertakan flag --project=MULTICAST_ADMIN_PROJECT untuk setiap perintah dalam prosedur berikut.

    gcloud config set project MULTICAST_ADMIN_PROJECT

Ganti MULTICAST_ADMIN_PROJECT dengan ID project Anda.

Mengaktifkan API

Jika belum, aktifkan API berikut.

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda tidak memiliki izin ini, minta administrator Identity and Access Management (IAM) untuk memberi peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin) kepada Anda.

  1. Untuk membuat resource multicast, aktifkan API networkservices:

        gcloud services enable networkservices.googleapis.com

  2. Untuk membuat spoke VPC Network Connectivity Center, aktifkan networkconnectivity API:

        gcloud services enable networkconnectivity.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat domain multicast, minta administrator untuk memberi Anda peran IAM berikut:

  • Untuk membuat dan mengelola resource jaringan: Compute Network Admin (compute.networkAdmin) di project Anda
  • Untuk membuat dan mengelola aturan firewall: Compute Security Admin (compute.securityAdmin) di project Anda
  • Untuk membuat dan mengelola hub dan spoke Network Connectivity Center: Hub and Spoke Admin (networkconnectivity.hubAdmin) di project Anda
  • Untuk membuat resource multicast: Multicast Admin (networkservices.multicastAdmin) di project Anda

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mengonfigurasi Network Connectivity Center

Jika Anda membuat domain multicast yang menggunakan topologi bintang Network Connectivity Center, ikuti langkah-langkah di bagian ini untuk mengonfigurasi hub.

Jika Anda membuat domain multicast yang menggunakan topologi jaringan VPC tunggal, Anda dapat melewati bagian ini dan melanjutkan ke Membuat domain multicast.

Bagian ini menjelaskan cara mengonfigurasi hub Network Connectivity Center dengan topologi bintang preset untuk mengaktifkan hal berikut:

  • Anda dapat menambahkan jaringan VPC administrator ke hub sebagai spoke pusat.
  • Jika ada jaringan VPC produsen multicast terpisah, jaringan VPC produsen multicast dapat bergabung ke hub sebagai spoke pusat.
  • Jaringan VPC konsumen multicast dapat bergabung dengan hub sebagai spoke edge.

Untuk mengetahui informasi selengkapnya, lihat Topologi bintang dan Mengonfigurasi hub dalam dokumentasi Network Connectivity Center.

gcloud

Untuk mengonfigurasi Network Connectivity Center, lakukan hal berikut:

  1. Untuk membuat hub, gunakan perintah network-connectivity hubs create.

      gcloud network-connectivity hubs create HUB_NAME \
    --policy-mode=PRESET \
    --preset-topology=STAR

    Ganti HUB_NAME dengan nama untuk hub.

  2. Untuk menambahkan jaringan VPC Anda sebagai spoke pusat ke hub, gunakan perintah network-connectivity spokes linked-vpc-network create.

      gcloud network-connectivity spokes linked-vpc-network create SPOKE_NAME \
    --hub=projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME \
    --vpc-network=MULTICAST_ADMIN_NETWORK \
    --group="center" \
    --global

    Ganti kode berikut:

    • SPOKE_NAME: nama untuk spoke
    • MULTICAST_ADMIN_PROJECT: ID project administrator multicast
    • HUB_NAME: nama hub Network Connectivity Center yang Anda buat sebelumnya

    • MULTICAST_ADMIN_NETWORK: nama jaringan administrator multicast yang Anda buat sebelumnya

      Atau, Anda dapat memberikan URI jaringan administrator multicast menggunakan format berikut: projects/MULTICAST_ADMIN_PROJECT/global/networks/MULTICAST_ADMIN_NETWORK.

  3. Untuk mengizinkan jaringan VPC konsumen multicast bergabung ke hub, lakukan hal berikut. Atau, Anda dapat melanjutkan konfigurasi multicast dan menyelesaikan langkah-langkah ini nanti seperti yang dijelaskan dalam Mengontrol akses ke domain multicast.

    1. Beri administrator jaringan konsumen multicast di project lain kemampuan untuk mengusulkan spoke VPC ke hub dengan mengikuti langkah-langkah dalam Memberi akses di dokumentasi Network Connectivity Center.

    2. Minta administrator jaringan konsumen multicast untuk menambahkan jaringan VPC mereka sebagai spoke ke hub yang Anda buat saat mereka mengikuti prosedur untuk Mengizinkan jaringan VPC menggunakan traffic multicast.

    3. Tinjau spoke VPC yang diusulkan sesuai kebutuhan untuk memeriksa proposal spoke.

    4. Saat Anda menerima proposal spoke, ikuti langkah-langkah untuk Menerima spoke VPC.

Membuat domain multicast

Bagian ini menjelaskan cara membuat domain multicast.

Membuat grup domain

Bagian ini menjelaskan cara membuat grup domain multicast. Sebelum melanjutkan, tinjau hal berikut:

  • Jika Anda berencana membuat domain redundan, sebaiknya buat grup domain untuk ketersediaan yang lebih tinggi di antara domain tersebut.

  • Grup domain secara eksplisit mengelompokkan dua domain terkait. Jangan membuat grup domain untuk satu domain atau lebih dari dua domain.

  • Membuat grup domain adalah konfigurasi opsional. Jika tidak memerlukan grup domain, Anda dapat melewati langkah ini. Namun, Anda tidak dapat menambahkan domain yang ada ke grup domain nanti.

gcloud

Untuk membuat grup domain, gunakan perintah network-services multicast-domain-groups create.

gcloud network-services multicast-domain-groups create DOMAIN_GROUP_NAME \
   --location=global

Ganti DOMAIN_GROUP_NAME dengan nama untuk grup domain.

API

Untuk membuat grup domain, gunakan metode multicastDomainGroups.create.

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups?multicastDomainGroupId=DOMAIN_GROUP_NAME

Ganti kode berikut:

  • DOMAIN_GROUP_NAME: nama untuk grup domain
  • MULTICAST_ADMIN_PROJECT: ID project administrator multicast

Membuat domain

Buat satu atau beberapa domain multicast yang terkait dengan jaringan VPC administrator multicast Anda.

gcloud

Untuk membuat domain, gunakan perintah network-services multicast-domains create.

Jika ingin menggunakan grup domain, Anda harus menentukan grup domain saat membuat domain. Anda tidak dapat menambahkan domain ke grup domain nanti. Untuk membuat domain yang merupakan bagian dari grup domain, Anda harus menjalankan perintah berikut dua kali, misalnya untuk membuat DOMAIN_1 dan DOMAIN_2.

   gcloud network-services multicast-domains create DOMAIN_NAME \
      --location=global \
      --admin-network=projects/MULTICAST_ADMIN_PROJECT/locations/global/networks/MULTICAST_ADMIN_NETWORK \
      --connection-type=TOPOLOGY \
      [--ncc-hub=projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME] \
      [--multicast-domain-group=projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups/DOMAIN_GROUP_NAME]

Ganti nilai berikut:

  • DOMAIN_NAME: nama untuk domain
  • MULTICAST_ADMIN_PROJECT: ID project administrator multicast
  • MULTICAST_ADMIN_NETWORK: jaringan VPC administrator multicast. Jika Anda menggunakan topologi Network Connectivity Center, jaringan ini juga harus menjadi bagian dari hub sebagai spoke pusat, jika tidak, pembuatan domain akan gagal.
  • TOPOLOGY: topologi yang ingin Anda konfigurasi untuk multicast. Tentukan salah satu opsi berikut:
    • SAME_VPC: topologi jaringan VPC tunggal.
    • NCC: topologi bintang Network Connectivity Center.
  • HUB_NAME: jika Anda mengonfigurasi topologi bintang Network Connectivity Center, tentukan nama hub.
  • DOMAIN_GROUP_NAME: jika Anda membuat grup domain, masukkan nama grup domain.

API

Untuk membuat domain, gunakan metode multicastDomains.create.

Jika ingin menggunakan grup domain, Anda harus menentukan grup domain saat membuat domain. Anda tidak dapat menambahkan domain ke grup domain nanti. Untuk membuat domain yang merupakan bagian dari grup domain, Anda harus membuat permintaan API berikut dua kali. Misalnya, buat permintaan berikut sekali untuk membuat DOMAIN_1, lalu buat permintaan lagi untuk membuat DOMAIN_2:

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains?multicastDomainId=DOMAIN_NAME

{
  "adminNetwork": "projects/MULTICAST_ADMIN_PROJECT/locations/global/networks/MULTICAST_ADMIN_NETWORK",
  "connection": {
      "connectionType": "TOPOLOGY",
      "nccHub": "projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME"
  },
  "multicastDomainGroup": "projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups/DOMAIN_GROUP_NAME"
}

Ganti nilai berikut:

  • DOMAIN_NAME: nama untuk domain
  • MULTICAST_ADMIN_PROJECT: ID project administrator multicast
  • MULTICAST_ADMIN_NETWORK: jaringan VPC administrator multicast. Jika Anda menggunakan topologi Network Connectivity Center, jaringan ini juga harus menjadi bagian dari hub sebagai spoke pusat, jika tidak, pembuatan domain akan gagal.
  • TOPOLOGY: topologi yang ingin Anda konfigurasi untuk multicast. Tentukan salah satu opsi berikut:
    • SAME_VPC: topologi jaringan VPC tunggal.
    • NCC: topologi bintang Network Connectivity Center.
  • HUB_NAME: jika Anda mengonfigurasi topologi bintang Network Connectivity Center, tentukan nama hub menggunakan kolom nccHub.
  • DOMAIN_GROUP_NAME: jika Anda membuat grup domain, masukkan nama grup domain menggunakan kolom multicastDomainGroup.

Mengaktifkan domain

Aktifkan domain di setiap zona tempat produsen atau konsumen multicast perlu mengirim atau menerima traffic multicast. Saat Anda mengaktifkan domain di suatu zona,Google Cloud akan menyediakan infrastruktur multicast untuk domain Anda di zona tersebut.

Jika Anda tidak mengaktifkan domain di zona tertentu, traffic multicast tidak dapat dikirim atau diterima di zona tersebut.

gcloud

Untuk mengaktifkan domain, gunakan perintah network-services multicast-domain-activations create.

Perintah berikut memerlukan waktu sekitar 10 hingga 30 menit untuk diselesaikan.

   gcloud network-services multicast-domain-activations create DOMAIN_ACTIVATION_NAME \
      --multicast-domain="projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \
      --location=ZONE \
      [--disable-placement-policy] \
      [--aggr-egress-pps=AGGR_EGRESS_PPS] \
      [--aggr-ingress-pps=AGGR_INGRESS_PPS] \
      [--avg-packet-size=AVG_PACKET_SIZE] \
      [--max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS] \
      [--max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS]

Ganti nilai berikut:

  • DOMAIN_ACTIVATION_NAME: nama untuk aktivasi domain
  • MULTICAST_ADMIN_PROJECT: ID project administrator multicast
  • DOMAIN_NAME: nama domain yang akan diaktifkan
  • ZONE: zona tempat mengaktifkan domain
  • --disable-placement-policy: Jika Anda mengaktifkan domain yang merupakan bagian dari grup domain, Anda dapat menyertakan flag ini secara opsional untuk menonaktifkan pembuatan kebijakan penempatan. Jika tidak, Google Cloud akan otomatis membuat kebijakan penempatan yang secara opsional dapat diterapkan ke konsumen multicast baru atau yang sudah ada.

  • Tentukan parameter berikut sesuai kebutuhan Anda untuk traffic multicast di zona ini. Google Cloud menggunakan parameter ini untuk menentukan skala infrastruktur multicast Anda.

    Sebelum Anda menentukan parameter ini, lihat hal berikut:

    • Tinjau batasan untuk traffic multicast yang sesuai yang dijelaskan dalam ringkasan multicast.
    • Jika Anda tidak menyertakan tanda ini, Google Cloud akan membuat konfigurasi minimal yang dapat Anda gunakan untuk pengujian.
    • Anda dapat memperbarui konfigurasi flag ini nanti seperti yang dijelaskan dalam Memperbarui parameter domain multicast.
    • Meskipun bersifat opsional, jika Anda menyertakan salah satu tanda ini, maka --aggr-egress-pps menjadi tanda wajib.

    Untuk mengetahui informasi selengkapnya tentang setiap tanda, lihat bagian berikut:

    • AGGR_EGRESS_PPS: paket keluar gabungan per detik (pps) untuk semua grup multicast dalam domain di zona yang ditentukan. Egress mengacu pada paket yang didistribusikan dari infrastruktur multicast ke konsumen multicast.

      Anda dapat memasukkan nilai dari 0 hingga 500000000 (500 juta). Nilai defaultnya adalah 1000000 (1 juta). Nilai default untuk kolom lainnya ditetapkan secara dinamis berdasarkan nilai yang Anda masukkan untuk tanda ini.

    • AGGR_INGRESS_PPS: pps ingress gabungan untuk semua grup multicast di domain dalam zona yang ditentukan. Ingress mengacu pada paket yang dikirim dari produsen multicast ke infrastruktur multicast.

      Anda dapat memasukkan nilai dari 0 hingga 2000000 (2 juta). Nilai yang Anda masukkan untuk --aggr-ingress-pps tidak boleh lebih besar dari nilai --aggr-egress-pps.

    • AVG_PACKET_SIZE: ukuran paket rata-rata dalam byte. Anda dapat memasukkan nilai dari 64 hingga 1500.

    • MAX_PER_GROUP_INGRESS_PPS: pps ingress maksimum untuk satu grup multicast di domain dalam zona yang ditentukan. Gunakan tanda ini untuk menentukan grup multicast yang paling aktif di domain, yang membantu Google Cloud menentukan skala infrastruktur multicast yang diperlukan secara lebih akurat.

      Anda dapat memasukkan nilai dari 0 hingga 2000000 (2 juta). Nilai yang Anda masukkan untuk --max-per-group-ingress-pps tidak boleh lebih besar dari nilai --aggr-ingress-pps.

    • MAX_PER_GROUP_SUBSCRIBERS: jumlah maksimum konsumen multicast untuk satu grup multicast dalam domain di zona yang ditentukan. Gunakan tanda ini untuk menentukan grup dengan konsumen multicast terbanyak, yang membantu Google Cloud lebih akurat menentukan skala infrastruktur multicast yang diperlukan. Menyertakan tanda ini tidak memberlakukan batas pada jumlah konsumen multicast untuk grup.

      Anda dapat memasukkan nilai dari 1 hingga 500.

API

Untuk mengaktifkan domain, gunakan metode multicastDomainActivations.create.

Permintaan berikut memerlukan waktu sekitar 10 hingga 30 menit untuk diselesaikan.

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/ZONE/multicastDomainActivations?multicastDomainActivationId=DOMAIN_ACTIVATION_NAME

{
  "multicastDomain": "projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME",
  "disablePlacementPolicy": "PLACEMENT_POLICY_DISABLED",
  "trafficSpec": {
    "aggrEgressPps": "AGGR_EGRESS_PPS",
    "aggrIngressPps": "AGGR_INGRESS_PPS",
    "avgPacketSize": "AVG_PACKET_SIZE",
    "maxPerGroupIngressPps": "MAX_PER_GROUP_INGRESS_PPS",
    "maxPerGroupSubscribers": "MAX_PER_GROUP_SUBSCRIBERS"
  }
}

Ganti nilai berikut:

  • DOMAIN_ACTIVATION_NAME: nama untuk aktivasi domain
  • MULTICAST_ADMIN_PROJECT: ID project administrator multicast
  • DOMAIN_NAME: nama domain yang akan diaktifkan
  • ZONE: zona tempat mengaktifkan domain
  • PLACEMENT_POLICY_DISABLED: Jika Anda mengaktifkan domain yang merupakan bagian dari grup domain, Anda dapat menyertakan kolom ini secara opsional dan menyetelnya ke true untuk menonaktifkan pembuatan kebijakan penempatan. Jika tidak, Google Cloud akan otomatis membuat kebijakan penempatan yang secara opsional dapat diterapkan ke konsumen multicast baru atau yang sudah ada.

  • Tentukan nilai untuk objek trafficSpec sesuai dengan kebutuhan Anda untuk traffic multicast di zona ini. Google Cloud menggunakan parameter ini untuk menentukan skala infrastruktur multicast Anda.

    Sebelum Anda menentukan parameter ini, lihat hal berikut:

    • Tinjau batasan untuk traffic multicast yang sesuai yang dijelaskan dalam ringkasan multicast.
    • Jika Anda tidak menyertakan objek trafficSpec dalam isi permintaan, Google Cloud akan membuat konfigurasi minimal yang dapat Anda gunakan untuk pengujian.
    • Anda dapat memperbarui konfigurasi trafficSpec nanti seperti yang dijelaskan dalam Memperbarui parameter domain multicast.
    • Meskipun kolom di trafficSpec bersifat opsional, jika Anda menyertakan kolom apa pun, aggrEgressPps akan menjadi kolom wajib diisi. Jika Anda menyertakan objek trafficSpec dengan beberapa kolom, Anda harus menyertakan aggrEgressPps.

    Untuk mengetahui informasi selengkapnya tentang setiap kolom, lihat bagian berikut:

    • AGGR_EGRESS_PPS: paket keluar gabungan per detik (pps) untuk semua grup multicast dalam domain di zona yang ditentukan. Egress mengacu pada paket yang didistribusikan dari infrastruktur multicast ke konsumen multicast.

      Anda dapat memasukkan nilai dari 0 hingga 500000000 (500 juta). Nilai defaultnya adalah 1000000 (1 juta). Nilai default untuk kolom lainnya ditetapkan secara dinamis berdasarkan nilai yang Anda masukkan untuk kolom ini.

    • AGGR_INGRESS_PPS: pps ingress gabungan untuk semua grup multicast di domain dalam zona yang ditentukan. Ingress mengacu pada paket yang dikirim dari produsen multicast ke infrastruktur multicast.

      Anda dapat memasukkan nilai dari 0 hingga 2000000 (2 juta). Nilai yang Anda masukkan untuk aggrIngressPps tidak boleh lebih besar dari nilai aggrEgressPps.

    • AVG_PACKET_SIZE: ukuran paket rata-rata dalam byte. Anda dapat memasukkan nilai dari 64 hingga 1500.

    • MAX_PER_GROUP_INGRESS_PPS: pps ingress maksimum untuk satu grup multicast di domain dalam zona yang ditentukan. Gunakan tanda ini untuk menentukan grup multicast yang paling aktif di domain, yang membantu Google Cloud menentukan skala infrastruktur multicast yang diperlukan secara lebih akurat.

      Anda dapat memasukkan nilai dari 0 hingga 2000000 (2 juta). Nilai yang Anda masukkan untuk maxPerGroupIngressPps tidak boleh lebih besar dari nilai aggrIngressPps.

    • MAX_PER_GROUP_SUBSCRIBERS: jumlah maksimum konsumen multicast untuk satu grup multicast dalam domain di zona yang ditentukan. Gunakan tanda ini untuk menentukan grup dengan konsumen multicast terbanyak, yang membantu Google Cloud lebih akurat menentukan skala infrastruktur multicast yang diperlukan. Menyediakan spesifikasi ini tidak memberlakukan batas pada jumlah konsumen multicast untuk suatu grup.

      Anda dapat memasukkan nilai dari 1 hingga 500.

Langkah berikutnya