Aggiorna i parametri del dominio multicast

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

Per informazioni sulla creazione e l'attivazione di domini multicast, vedi 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 mentre Google Cloud ripristina l'infrastruttura multicast in base ai nuovi parametri che fornisci.

  • L'interruzione del servizio si applica all'infrastruttura multicast per l'attivazione del dominio multicast specifico che stai aggiornando. Durante l'aggiornamento, i produttori e i consumatori di 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, ad esempio la scala dell'infrastruttura multicast attuale, il numero di attivazioni dell'intervallo di gruppi multicast create utilizzando l'attivazione del dominio e la scala dei nuovi parametri che fornisci. Per le configurazioni su larga scala, l'aggiornamento può richiedere da 30 minuti a 1 ora per essere completato.

• 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 al tuo progetto. Per saperne di più, contatta il tuo Google Cloud rappresentante di vendita.

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

Aggiorna 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 comando network-services multicast-domain-activations update.

Il completamento del seguente comando richiede circa 10-30 minuti. Una volta completato correttamente il comando, potrebbero essere necessari diversi 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 tra 30 minuti e 1 ora per essere completato.

Nota: se il comando seguente restituisce un errore imprevisto, ad esempio un errore di timeout, esegui di nuovo il comando per completare l'aggiornamento.

   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 utilizza questi parametri per determinare la scalabilità dell'infrastruttura multicast.

  Prima di specificare questi parametri, consulta quanto segue:

  • Esamina le limitazioni per il traffico multicast corrispondenti descritte nella panoramica del 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 ciascun flag, consulta le seguenti risorse:

  • AGGR_EGRESS_PPS: pacchetti di uscita aggregati al secondo (pps) per tutti i gruppi di 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 è 1000000 (1 milione). I valori predefiniti per gli altri campi vengono impostati in modo dinamico in base al valore inserito per questo flag.

    Nota: se non conosci il tuo pps di uscita aggregato, puoi stimarlo utilizzando la seguente formula: AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.

  • AGGR_INGRESS_PPS: pps in entrata aggregato per tutti i gruppi di 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 che inserisci per --aggr-ingress-pps non può essere maggiore del valore di --aggr-egress-pps.

  • AVG_PACKET_SIZE: dimensioni medie del pacchetto in byte. Puoi inserire un valore compreso tra 64 e 1500.

  • MAX_PER_GROUP_INGRESS_PPS: il numero massimo di pacchetti al secondo in entrata per un singolo gruppo di 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 scala richiesta della tua 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: 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, il che aiuta Google Cloud a determinare con maggiore precisione la scalabilità richiesta della tua 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 metodo multicastDomainActivations.patch.

Il completamento del seguente comando richiede circa 10-30 minuti. Una volta completato correttamente il comando, potrebbero essere necessari diversi 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 tra 30 minuti e 1 ora.

Nota: se la seguente richiesta restituisce un errore imprevisto, ad esempio un errore di timeout, esegui di nuovo la richiesta per completare l'aggiornamento.

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 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 utilizza questi parametri per determinare la scalabilità della tua infrastruttura multicast.

  Prima di specificare questi parametri, consulta quanto segue:

  • Esamina le limitazioni per il traffico multicast corrispondenti descritte nella panoramica del 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 ciascun campo, consulta le seguenti risorse:

  • AGGR_EGRESS_PPS: pacchetti di uscita aggregati al secondo (pps) per tutti i gruppi di 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 in modo dinamico in base al valore inserito per questo campo.

    Nota: se non conosci il tuo pps di uscita aggregato, puoi stimarlo utilizzando la seguente formula: AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.

  • AGGR_INGRESS_PPS: pps in entrata aggregato per tutti i gruppi di 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 che inserisci per aggrIngressPps non può essere maggiore del valore di aggrEgressPps.

  • AVG_PACKET_SIZE: dimensioni medie del pacchetto in byte. Puoi inserire un valore compreso tra 64 e 1500.

  • MAX_PER_GROUP_INGRESS_PPS: il numero massimo di pacchetti al secondo in entrata per un singolo gruppo di 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 scala richiesta della tua 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: il 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 della tua 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.