Membuat domain multicast

gcloud

Untuk mengonfigurasi NCC, lakukan hal berikut:

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

     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 NCC 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 terus mengonfigurasi 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 di Memberikan akses dalam dokumentasi NCC.

   2. Minta administrator jaringan konsumen multicast untuk menambahkan jaringan VPC mereka sebagai spoke ke hub yang Anda buat saat mereka mengikuti prosedur untuk Mengaktifkan jaringan VPC untuk 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.

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

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 NCC , 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 hal berikut:
  • SAME_VPC: topologi jaringan VPC tunggal.
  • NCC: topologi bintang NCC.
• 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 NCC , 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 hal berikut:
  • SAME_VPC: topologi jaringan VPC tunggal.
  • NCC: topologi bintang NCC.
• 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.

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 secara opsional menyertakan flag ini untuk menonaktifkan pembuatan kebijakan penempatan. Jika tidak, Google Cloud kebijakan penempatan akan otomatis dibuat dan dapat diterapkan secara opsional ke konsumen multicast baru atau yang sudah ada.

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

  Sebelum menentukan parameter ini, lihat hal berikut:

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

  Untuk mengetahui informasi selengkapnya tentang setiap flag, lihat hal berikut:

  • AGGR_EGRESS_PPS: paket keluar gabungan per detik (pps) untuk semua grup multicast di domain di zona yang ditentukan. Keluar 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 flag ini.

  • AGGR_INGRESS_PPS: pps masuk gabungan untuk semua grup multicast di domain di zona yang ditentukan. Masuk 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 masuk maksimum untuk satu grup multicast di domain di zona yang ditentukan. Gunakan flag ini untuk menentukan grup multicast yang paling aktif di domain, yang membantu Google Cloud menentukan skala infrastruktur multicast Anda dengan 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 di domain di zona yang ditentukan. Gunakan flag ini untuk menentukan grup dengan konsumen multicast terbanyak, yang membantu Google Cloud menentukan skala infrastruktur multicast Anda dengan lebih akurat. Menyertakan flag ini tidak akan menerapkan batas 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 secara opsional menyertakan kolom ini dan menetapkannya ke true untuk menonaktifkan pembuatan kebijakan penempatan. Jika tidak, Google Cloud kebijakan penempatan akan otomatis dibuat dan dapat diterapkan secara opsional 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 Parameter ini digunakan untuk menentukan skala infrastruktur multicast Anda.

  Sebelum menentukan parameter ini, lihat hal berikut:

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

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

  • AGGR_EGRESS_PPS: paket keluar gabungan per detik (pps) untuk semua grup multicast di domain di zona yang ditentukan. Keluar 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 masuk gabungan untuk semua grup multicast di domain di zona yang ditentukan. Masuk 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 masuk maksimum untuk satu grup multicast di domain di zona yang ditentukan. Gunakan flag ini untuk menentukan grup multicast yang paling aktif di domain, yang membantu Google Cloud menentukan skala infrastruktur multicast Anda dengan 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 di domain di zona yang ditentukan. Gunakan flag ini untuk menentukan grup dengan konsumen multicast terbanyak, yang membantu Google Cloud menentukan skala infrastruktur multicast Anda dengan lebih akurat. Memberikan spesifikasi ini tidak akan menerapkan batas jumlah konsumen multicast untuk grup.

    Anda dapat memasukkan nilai dari 1 hingga 500.