Crea domini multicast

Questa pagina descrive i passaggi da seguire per creare domini multicast.

Per una panoramica del processo di configurazione di Cloud Multicast, consulta Panoramica della configurazione di Cloud Multicast.

Prima di iniziare

Prima di creare domini multicast, consulta le sezioni seguenti.

Crea o identifica una rete VPC

Se non l'hai ancora fatto, crea una rete Virtual Private Cloud (VPC) da utilizzare come rete di amministrazione multicast. Per ulteriori informazioni sulla creazione di reti VPC, consulta Crea e gestisci le reti VPC.

Se la tua rete di amministrazione multicast ospiterà anche producer o consumer multicast, ad esempio quando utilizzi la topologia di rete VPC singola, assicurati che la rete abbia le regole firewall appropriate per consentire il traffico multicast. Consulta i seguenti articoli:

Imposta il progetto

Imposta gcloud CLI in modo che utilizzi il tuo progetto. In alternativa, puoi includere il flag --project=MULTICAST_ADMIN_PROJECT per ogni comando nelle seguenti procedure.

    gcloud config set project MULTICAST_ADMIN_PROJECT

Sostituisci MULTICAST_ADMIN_PROJECT con l'ID del tuo progetto.

Abilita API

Se non l'hai già fatto, abilita le seguenti API.

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se non disponi di questa autorizzazione, chiedi all'amministratore di Identity and Access Management (IAM) di concederti il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin).

  1. Per creare risorse multicast, abilita l'API networkservices:

        gcloud services enable networkservices.googleapis.com

  2. Per creare uno spoke VPC di Network Connectivity Center (NCC), abilita l'API networkconnectivity:

        gcloud services enable networkconnectivity.googleapis.com

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare domini multicast, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Per creare e gestire le risorse di rete: Compute Network Admin (compute.networkAdmin) sul progetto
  • Per creare e gestire le regole firewall: Compute Security Admin (compute.securityAdmin) sul tuo progetto
  • Per creare e gestire hub e spoke NCC: Amministratore hub e spoke (networkconnectivity.hubAdmin) sul tuo progetto
  • Per creare risorse multicast: Multicast Admin (networkservices.multicastAdmin) nel tuo progetto

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Configura NCC

Se stai creando un dominio multicast che utilizza la topologia a stella di NCC, segui i passaggi descritti in questa sezione per configurare l'hub.

Se stai creando un dominio multicast che utilizza la topologia di rete VPC singola, puoi saltare questa sezione e procedere a Crea un dominio multicast.

Questa sezione descrive come configurare un hub NCC con la topologia a stella preimpostata per attivare quanto segue:

  • Puoi aggiungere la tua rete VPC amministratore all'hub come spoke centrale.
  • Se esiste una rete VPC producer multicast separata, questa può unirsi all'hub come spoke centrale.
  • Le reti VPC consumer multicast possono unirsi all'hub come spoke perimetrali.

Per saperne di più, consulta Topologia a stella e Configura un hub nella documentazione di NCC.

gcloud

Per configurare NCC, segui questi passaggi:

  1. Per creare un hub, utilizza il comando network-connectivity hubs create.

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

    Sostituisci HUB_NAME con un nome per l'hub.

  2. Per aggiungere la tua rete VPC come spoke centrale all'hub, utilizza il comando 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

    Sostituisci quanto segue:

    • SPOKE_NAME: un nome per lo spoke
    • MULTICAST_ADMIN_PROJECT: l'ID del progetto amministratore multicast
    • HUB_NAME: il nome dell'hub NCC che hai creato in precedenza

    • MULTICAST_ADMIN_NETWORK: il nome della rete di amministrazione multicast creata in precedenza

      In alternativa, puoi fornire l'URI della rete amministratore multicast utilizzando il seguente formato: projects/MULTICAST_ADMIN_PROJECT/global/networks/MULTICAST_ADMIN_NETWORK.

  3. Per consentire alle reti VPC consumer multicast di unirsi all'hub, segui questi passaggi. In alternativa, puoi continuare a configurare il multicast e completare questi passaggi in un secondo momento, come descritto in Controlla l'accesso ai domini multicast.

    1. Concedi agli amministratori di rete consumer multicast di altri progetti la possibilità di proporre spoke VPC all'hub seguendo i passaggi descritti in Concedi l'accesso nella documentazione di NCC.

    2. Chiedi agli amministratori di rete consumer multicast di aggiungere le proprie reti VPC come spoke all'hub che hai creato quando seguono la procedura per abilitare una rete VPC a utilizzare il traffico multicast.

    3. Esamina gli spoke VPC proposti per verificare la presenza di proposte di spoke.

    4. Quando ricevi una proposta di spoke, segui i passaggi per accettare lo spoke VPC.

Crea un dominio multicast

Questa sezione descrive come creare un dominio multicast.

Crea un gruppo di domini

Questa sezione descrive come creare un gruppo di domini multicast. Prima di procedere, esamina quanto segue:

  • Se prevedi di creare domini ridondanti, ti consigliamo di creare un gruppo di domini per una maggiore disponibilità tra i domini.

  • Un gruppo di domini raggruppa esplicitamente due domini correlati. Non creare un gruppo di domini per un singolo dominio o per più di due domini.

  • La creazione di un gruppo di domini è una configurazione facoltativa. Se non hai bisogno di un gruppo di domini, puoi saltare questo passaggio. Tuttavia, non puoi aggiungere domini esistenti a un gruppo di domini in un secondo momento.

gcloud

Per creare un gruppo di domini, utilizza il comando network-services multicast-domain-groups create.

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

Sostituisci DOMAIN_GROUP_NAME con un nome per il gruppo di domini.

API

Per creare un gruppo di domini, utilizza il metodo multicastDomainGroups.create.

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

Sostituisci quanto segue:

  • DOMAIN_GROUP_NAME: un nome per il gruppo di domini
  • MULTICAST_ADMIN_PROJECT: l'ID del progetto amministratore multicast

Crea un dominio

Crea uno o più domini multicast associati alla rete VPC dell'amministratore multicast.

gcloud

Per creare un dominio, utilizza il comando network-services multicast-domains create.

Se vuoi utilizzare un gruppo di domini, devi specificarlo quando crei il dominio. Non puoi aggiungere il dominio a un gruppo di domini in un secondo momento. Per creare domini che fanno parte di un gruppo di domini, devi eseguire il comando seguente due volte, ad esempio per creare DOMAIN_1 e 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]

Sostituisci i seguenti valori:

  • DOMAIN_NAME: un nome per il dominio
  • MULTICAST_ADMIN_PROJECT: l'ID del progetto amministratore multicast
  • MULTICAST_ADMIN_NETWORK: la rete VPC dell'amministratore multicast. Se utilizzi la topologia NCC, questa rete deve far parte dell'hub come spoke centrale, altrimenti la creazione del dominio non va a buon fine.
  • TOPOLOGY: la topologia che vuoi configurare per Cloud Multicast. Specifica una delle seguenti opzioni:
    • SAME_VPC: la topologia di rete VPC singola.
    • NCC: la topologia a stella NCC.
  • HUB_NAME: se stai configurando la topologia a stella di Network Connectivity Center, specifica il nome dell'hub.
  • DOMAIN_GROUP_NAME: se hai creato un gruppo di domini, inserisci il nome del gruppo di domini.

API

Per creare un dominio, utilizza il metodo multicastDomains.create.

Se vuoi utilizzare un gruppo di domini, devi specificarlo quando crei il dominio. Non puoi aggiungere il dominio a un gruppo di domini in un secondo momento. Per creare domini che fanno parte di un gruppo di domini, devi effettuare la seguente richiesta API due volte. Ad esempio, invia la seguente richiesta una volta per creare DOMAIN_1, quindi invia nuovamente la richiesta per creare 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"
}

Sostituisci i seguenti valori:

  • DOMAIN_NAME: un nome per il dominio
  • MULTICAST_ADMIN_PROJECT: l'ID del progetto amministratore multicast
  • MULTICAST_ADMIN_NETWORK: la rete VPC dell'amministratore multicast. Se utilizzi la topologia NCC, questa rete deve far parte dell'hub come spoke centrale, altrimenti la creazione del dominio non va a buon fine.
  • TOPOLOGY: la topologia che vuoi configurare per Cloud Multicast. Specifica una delle seguenti opzioni:
    • SAME_VPC: la topologia di rete VPC singola.
    • NCC: la topologia a stella NCC.
  • HUB_NAME: se stai configurando la topologia a stella di Network Connectivity Center, specifica il nome dell'hub utilizzando il campo nccHub.
  • DOMAIN_GROUP_NAME: se hai creato un gruppo di domini, inserisci il nome del gruppo di domini utilizzando il campo multicastDomainGroup.

Attiva il dominio

Attiva il dominio in ogni zona in cui i producer o i consumer multicast devono inviare o ricevere traffico multicast. Quando attivi un dominio in una zona,Google Cloud esegue il provisioning dell'infrastruttura multicast per il tuo dominio in quella zona.

Se non attivi un dominio in una determinata zona, il traffico multicast non può essere inviato o ricevuto in quella zona.

gcloud

Per attivare un dominio, utilizza il comando network-services multicast-domain-activations create.

Il completamento del comando seguente richiede circa 10-30 minuti.

   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]

Sostituisci i seguenti valori:

  • DOMAIN_ACTIVATION_NAME: un nome per l'attivazione del dominio
  • MULTICAST_ADMIN_PROJECT: l'ID del progetto amministratore multicast
  • DOMAIN_NAME: il nome del dominio da attivare
  • ZONE: la zona in cui attivare il dominio
  • --disable-placement-policy: se stai attivando un dominio che fa parte di un gruppo di domini, puoi facoltativamente includere questo flag per disattivare la creazione di una policy di posizionamento. In caso contrario, Google Cloud crea automaticamente una policy di posizionamento che può essere facoltativamente applicata ai consumer multicast nuovi o esistenti.

  • Specifica i seguenti parametri in base alle tue esigenze per il traffico multicast in questa zona. Google Cloud utilizza questi parametri per determinare la scalabilità della tua infrastruttura multicast.

    Prima di specificare questi parametri, consulta quanto segue:

    • Esamina le corrispondenti limitazioni per il traffico multicast descritte nella panoramica di Cloud Multicast.
    • Se non includi questi flag, Google Cloud genera una configurazione minima che puoi utilizzare per i test.
    • Puoi aggiornare la configurazione di questi flag in un secondo momento, come descritto in Aggiorna i parametri del dominio multicast.
    • Sebbene questi flag siano facoltativi, se ne includi uno, --aggr-egress-pps diventa un flag obbligatorio.

    Per ulteriori informazioni su ciascun flag, consulta le seguenti risorse:

    • AGGR_EGRESS_PPS: pacchetti in uscita aggregati al secondo (pps) per tutti i gruppi multicast nel dominio nella zona specificata. Il traffico in uscita si riferisce ai pacchetti distribuiti dall'infrastruttura multicast ai consumer multicast.

      Puoi inserire un valore compreso tra 0 e 500.000.000 (500 milioni). Il valore predefinito è 1.000.000 (1 milione). I valori predefiniti per gli altri campi vengono impostati dinamicamente in base al valore inserito per questo flag.

    • AGGR_INGRESS_PPS: pps in entrata aggregati per tutti i gruppi multicast nel dominio nella zona specificata. Il traffico in entrata si riferisce ai pacchetti inviati dai producer multicast all'infrastruttura multicast.

      Puoi inserire un valore compreso tra 0 e 2.000.000 (2 milioni). Il valore che inserisci per --aggr-ingress-pps non può essere maggiore del valore di --aggr-egress-pps.

    • AVG_PACKET_SIZE: dimensione media dei pacchetti in byte. Puoi inserire un valore compreso tra 64 e 1500.

    • MAX_PER_GROUP_INGRESS_PPS: pps in entrata massimo per un singolo gruppo multicast nel dominio nella zona specificata. Utilizza questo flag per specificare il gruppo multicast più attivo nel dominio, in modo da determinare con maggiore precisione la scalabilità richiesta per l'infrastruttura multicast. Google Cloud

      Puoi inserire un valore compreso tra 0 e 2.000.000 (2 milioni). Il valore che inserisci per --max-per-group-ingress-pps non può essere maggiore del valore di --aggr-ingress-pps.

    • MAX_PER_GROUP_SUBSCRIBERS: il numero massimo di consumer multicast per un singolo gruppo multicast nel dominio nella zona specificata. Utilizza questo flag per specificare il gruppo con il maggior numero di consumer multicast, in modo da aiutare Google Cloud a determinare con maggiore precisione la scalabilità richiesta per l'infrastruttura multicast. L'inclusione di questo flag non impone un limite al numero di consumer multicast per un gruppo.

      Puoi inserire un valore compreso tra 1 e 500.

API

Per attivare un dominio, utilizza il metodo multicastDomainActivations.create.

Il completamento della richiesta seguente richiede circa 10-30 minuti.

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"
  }
}

Sostituisci i seguenti valori:

  • DOMAIN_ACTIVATION_NAME: un nome per l'attivazione del dominio
  • MULTICAST_ADMIN_PROJECT: l'ID del progetto amministratore multicast
  • DOMAIN_NAME: il nome del dominio da attivare
  • ZONE: la zona in cui attivare il dominio
  • PLACEMENT_POLICY_DISABLED: se stai attivando un dominio che fa parte di un gruppo di domini, puoi includere facoltativamente questo campo e impostarlo su true per disattivare la creazione di una policy di posizionamento. In caso contrario, Google Cloud crea automaticamente una policy di posizionamento che può essere facoltativamente applicata ai consumer multicast nuovi o esistenti.

  • Specifica i valori per l'oggetto trafficSpec in base alle tue esigenze per il traffico multicast in questa zona. Google Cloud utilizza questi parametri per determinare la scalabilità della tua infrastruttura multicast.

    Prima di specificare questi parametri, consulta quanto segue:

    • Esamina le corrispondenti limitazioni per il traffico multicast descritte nella panoramica di Cloud Multicast.
    • Se non includi l'oggetto trafficSpec nel corpo della richiesta, Google Cloud genera una configurazione minima che puoi utilizzare per i test.
    • Puoi aggiornare la configurazione di trafficSpec in un secondo momento, come descritto in Aggiorna i parametri del dominio multicast.
    • Sebbene i campi in trafficSpec siano facoltativi, se includi dei campi, aggrEgressPps diventa un campo obbligatorio. Se includi l'oggetto trafficSpec con alcuni campi, devi includere aggrEgressPps.

    Per saperne di più su ciascun campo, consulta quanto segue:

    • AGGR_EGRESS_PPS: pacchetti in uscita aggregati al secondo (pps) per tutti i gruppi multicast nel dominio nella zona specificata. Il traffico in uscita si riferisce ai pacchetti distribuiti dall'infrastruttura multicast ai consumer multicast.

      Puoi inserire un valore compreso tra 0 e 500.000.000 (500 milioni). Il valore predefinito è 1.000.000 (1 milione). I valori predefiniti per gli altri campi vengono impostati in modo dinamico in base al valore inserito per questo campo.

    • AGGR_INGRESS_PPS: pps in entrata aggregati per tutti i gruppi multicast nel dominio nella zona specificata. Il traffico in entrata si riferisce ai pacchetti inviati dai producer multicast all'infrastruttura multicast.

      Puoi inserire un valore compreso tra 0 e 2.000.000 (2 milioni). Il valore che inserisci per aggrIngressPps non può essere maggiore del valore di aggrEgressPps.

    • AVG_PACKET_SIZE: dimensione media dei pacchetti in byte. Puoi inserire un valore compreso tra 64 e 1500.

    • MAX_PER_GROUP_INGRESS_PPS: pps in entrata massimo per un singolo gruppo multicast nel dominio nella zona specificata. Utilizza questo flag per specificare il gruppo multicast più attivo nel dominio, in modo da determinare con maggiore precisione la scalabilità richiesta per l'infrastruttura multicast. Google Cloud

      Puoi inserire un valore compreso tra 0 e 2.000.000 (2 milioni). Il valore che inserisci per maxPerGroupIngressPps non può essere maggiore del valore di aggrIngressPps.

    • MAX_PER_GROUP_SUBSCRIBERS: il numero massimo di consumer multicast per un singolo gruppo multicast nel dominio nella zona specificata. Utilizza questo flag per specificare il gruppo con il maggior numero di consumer multicast, in modo da aiutare Google Cloud a determinare con maggiore precisione la scalabilità richiesta per la tua infrastruttura multicast. La specifica di questo valore non impone un limite al numero di consumer multicast per un gruppo.

      Puoi inserire un valore compreso tra 1 e 500.

Passaggi successivi