Creare domini multicast

gcloud

Per configurare NCC:

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

     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 rete VPC come spoke centrale all'hub, utilizza il network-connectivity spokes linked-vpc-network create comando.

     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 dell'amministratore multicast
   • HUB_NAME: il nome dell'hub NCC creato in precedenza

   • MULTICAST_ADMIN_NETWORK: il nome della rete dell'amministratore multicast creata in precedenza

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

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

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

   2. Chiedi agli amministratori di rete dei consumer multicast di aggiungere le loro 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 se necessario, per verificare la presenza di proposte di spoke.

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

gcloud

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

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 multicastDomainGroups.create metodo.

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 dell'amministratore multicast

gcloud

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

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 seguente comando 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 dell'amministratore multicast
• MULTICAST_ADMIN_NETWORK: la rete VPC dell' amministratore multicast. Se utilizzi la topologia NCC, questa rete deve far parte anche dell'hub come spoke centrale, altrimenti la creazione del dominio non riesce.
• TOPOLOGY: la topologia che vuoi configurare per il multicast. Specifica uno dei seguenti valori:
  • 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 multicastDomains.create metodo.

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, effettua la seguente richiesta una volta per creare DOMAIN_1, quindi effettua di nuovo 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 dell'amministratore multicast
• MULTICAST_ADMIN_NETWORK: la rete VPC dell' amministratore multicast. Se utilizzi la topologia NCC, questa rete deve far parte anche dell'hub come spoke centrale, altrimenti la creazione del dominio non riesce.
• TOPOLOGY: la topologia che vuoi configurare per il multicast. Specifica uno dei seguenti valori:
  • 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.

gcloud

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

Il completamento del seguente comando 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 dell'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 includere facoltativamente questo flag per disattivare la creazione di una policy di posizionamento. In caso contrario, Google Cloud viene creata automaticamente una policy di posizionamento che può essere applicata facoltativamente ai consumer multicast nuovi o esistenti.

• Specifica i seguenti parametri in base alle tue esigenze per il traffico multicast in questa zona. Google Cloud Questi parametri vengono utilizzati per determinare la scalabilità dell'infrastruttura multicast.

  Prima di specificare questi parametri:

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

  Per saperne di più su ogni flag:

  • AGGR_EGRESS_PPS: pacchetti in uscita aggregati al secondo (pps) per tutti i gruppi multicast nel dominio nella zona specificata. L'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 che inserisci per questo flag.

  • AGGR_INGRESS_PPS: pps in entrata aggregati per tutti i gruppi multicast nel dominio nella zona specificata. L'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 massimi 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 Google Cloud determinare con maggiore precisione la scalabilità richiesta dell'infrastruttura multicast.

    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: 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 Google Cloud determinare con maggiore precisione la scalabilità richiesta dell'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 multicastDomainActivations.create metodo.

Il completamento della seguente richiesta 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 dell'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 viene creata automaticamente una policy di posizionamento che può essere applicata facoltativamente 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 Questi parametri vengono utilizzati per determinare la scalabilità dell'infrastruttura multicast.

  Prima di specificare questi parametri:

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

  Per saperne di più su ogni campo:

  • AGGR_EGRESS_PPS: pacchetti in uscita aggregati al secondo (pps) per tutti i gruppi multicast nel dominio nella zona specificata. L'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 che inserisci per questo campo.

  • AGGR_INGRESS_PPS: pps in entrata aggregati per tutti i gruppi multicast nel dominio nella zona specificata. L'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 massimi 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 Google Cloud determinare con maggiore precisione la scalabilità richiesta dell'infrastruttura multicast.

    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: 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 determinare con Google Cloud maggiore precisione la scalabilità richiesta dell'infrastruttura multicast. La fornitura di questa specifica non impone un limite al numero di consumer multicast per un gruppo.

    Puoi inserire un valore compreso tra 1 e 500.