Aggiornare i parametri del dominio multicast

Questa pagina descrive come ridimensionare l'infrastruttura multicast per il tuo dominio aggiornando i parametri di traffico delle attivazioni di dominio multicast zonali esistenti.

Per informazioni sulla creazione e l'attivazione dei domini multicast, consulta Creare domini multicast.

Prima di iniziare

Prima di aggiornare i parametri del dominio multicast, esamina quanto segue e pianifica l'aggiornamento di conseguenza:

  • Disponibilità del servizio durante l'aggiornamento: questa procedura potrebbe causare un' interruzione temporanea del servizio durante il Google Cloud riprovisioning dell'infrastruttura multicast in base ai nuovi parametri forniti.

    • L'interruzione del servizio si applica all'infrastruttura multicast per l'attivazione del dominio multicast specifico che stai aggiornando. Durante l'aggiornamento, i producer e i consumer multicast non possono inviare o ricevere traffico per il dominio e la zona multicast corrispondenti.

    • La durata dell'interruzione del servizio dipende da diversi fattori, come la scalabilità dell'infrastruttura multicast attuale, il numero di attivazioni dell'intervallo di gruppi multicast creati utilizzando l'attivazione del dominio e la scalabilità dei nuovi parametri forniti. Per le configurazioni su larga scala, l'aggiornamento può richiedere da 30 minuti a 1 ora.

  • Modifiche agli addebiti di fatturazione dopo l'aggiornamento: le attivazioni del dominio multicast comportano addebiti di fatturazione come descritto in Fatturazione. L'aggiornamento dei parametri di traffico di un'attivazione del dominio multicast potrebbe influire sugli addebiti di fatturazione del progetto. Per ulteriori informazioni, contatta il tuo Google Cloud rappresentante di vendita.

  • Azione richiesta dai consumer multicast dopo l'aggiornamento: al termine dell'aggiornamento, per iniziare a ricevere di nuovo il traffico, i consumer multicast devono rientrare in tutti i gruppi multicast nel dominio e nella zona. Se necessario, coordina con l'amministratore di rete del consumer multicast o con i proprietari dell'applicazione consumer multicast.

Aggiornare un'attivazione del dominio multicast

Questa sezione descrive come aggiornare i parametri di un'attivazione del dominio multicast che determinano la scalabilità dell'infrastruttura multicast.

Se hai attivato un dominio multicast in più zone, segui questa procedura per ogni attivazione del dominio multicast zonale che vuoi aggiornare.

gcloud

Per aggiornare un'attivazione del dominio multicast, utilizza il network-services multicast-domain-activations update comando.

Il completamento del seguente comando richiede circa 10-30 minuti. Una volta completato correttamente il comando, potrebbero essere necessari alcuni minuti prima che l'infrastruttura sia pronta a ricevere e distribuire il traffico multicast. Per le configurazioni su larga scala, l'intero processo può richiedere da 30 minuti a 1 ora.

   gcloud network-services multicast-domain-activations update DOMAIN_ACTIVATION_NAME \
      --location=ZONE \
      --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: il nome dell'attivazione del dominio multicast
  • ZONE: la zona in cui è stato attivato il dominio multicast

  • 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, consulta quanto segue:

    • Esamina le limitazioni corrispondenti per il traffico multicast descritte nella panoramica di multicast.

    • Consulta le seguenti informazioni sui flag facoltativi e obbligatori:

      • Se in precedenza hai specificato --aggr-egress-pps quando hai creato l'attivazione del dominio multicast, la specifica di --aggr-egress-pps è facoltativa. In caso contrario, questo flag è obbligatorio.
      • Tutti gli altri flag sono facoltativi.

    Per ulteriori informazioni su ogni flag, consulta quanto segue:

    • 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 inserito per questo flag.

    • AGGR_INGRESS_PPS: pps di ingresso aggregati per tutti i gruppi multicast nel dominio nella zona specificata. L'ingresso 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 inserito 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 di ingresso massimi per un singolo gruppo multicast nel dominio nella zona specificata. Utilizza questo flag per specificare il gruppo multicast più attivo nel dominio, il che aiuta Google Cloud a 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 inserito 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, il che aiuta Google Cloud a 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 aggiornare un'attivazione del dominio multicast, utilizza il multicastDomainActivations.patch metodo.

Il completamento del seguente comando richiede circa 10-30 minuti. Una volta completato correttamente il comando, potrebbero essere necessari alcuni minuti prima che l'infrastruttura sia pronta a ricevere e distribuire il traffico multicast. Per le configurazioni su larga scala, l'intero processo può richiedere da 30 minuti a 1 ora.

PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME?updateMask=trafficSpec

{
  "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:

  • PROJECT_ID: l'ID del progetto dell'amministratore multicast
  • DOMAIN_ACTIVATION_NAME: il nome dell'attivazione del dominio multicast
  • ZONE: la zona in cui è stato attivato il dominio multicast

  • 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, consulta quanto segue:

    • Esamina le limitazioni corrispondenti per il traffico multicast descritte nella panoramica di multicast.

    • Consulta le seguenti informazioni sui campi facoltativi e obbligatori:

      • Se in precedenza hai specificato aggrEgressPps quando hai creato l'attivazione del dominio multicast, la specifica di aggrEgressPps è facoltativa. In caso contrario, questo campo è obbligatorio.
      • Tutti gli altri campi in trafficSpec sono facoltativi.

    Per ulteriori informazioni su ogni campo, consulta quanto segue:

    • 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 inserito per questo campo.

    • AGGR_INGRESS_PPS: pps di ingresso aggregati per tutti i gruppi multicast nel dominio nella zona specificata. L'ingresso 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 inserito 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 di ingresso massimi per un singolo gruppo multicast nel dominio nella zona specificata. Utilizza questo campo per specificare il gruppo multicast più attivo nel dominio, il che aiuta Google Cloud a 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 inserito 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 campo per specificare il gruppo con il maggior numero di consumer multicast, il che aiuta Google Cloud a determinare con 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.