Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Mettre à jour les paramètres du domaine multicast

Cette page explique comment redimensionner l'infrastructure multicast de votre domaine en mettant à jour les paramètres de trafic des activations de domaine multicast zonal existantes.

Pour savoir comment créer et activer des domaines multidiffusion, consultez Créer des domaines multidiffusion.

Avant de commencer

Avant de mettre à jour les paramètres du domaine de multidiffusion, examinez les points suivants et planifiez votre mise à jour en conséquence :

Disponibilité du service pendant la mise à jour : cette procédure peut entraîner une interruption temporaire du service pendant que Google Cloud reprovisionne votre infrastructure multicast en fonction des nouveaux paramètres que vous fournissez.
- L'indisponibilité du service s'applique à l'infrastructure multicast pour l'activation du domaine multicast spécifique que vous mettez à jour. Pendant la mise à jour, les producteurs et les consommateurs multicast ne peuvent pas envoyer ni recevoir de trafic pour le domaine et la zone multicast correspondants.
- La durée de l'indisponibilité du service dépend de plusieurs facteurs, tels que l'ampleur de votre infrastructure multicast actuelle, le nombre d'activations de plages de groupes multicast créées à l'aide de l'activation de domaine et l'ampleur des nouveaux paramètres que vous fournissez. Pour les configurations à grande échelle, la mise à jour peut prendre entre 30 minutes et 1 heure.
Modifications des frais de facturation après la mise à jour : l'activation des domaines multicast entraîne des frais de facturation, comme décrit dans Facturation. La mise à jour des paramètres de trafic d'une activation de domaine multicast peut avoir une incidence sur les frais de facturation associés à votre projet. Pour en savoir plus, contactez votre conseiller commercialGoogle Cloud .
Action requise par les consommateurs de multicast après la mise à jour : une fois la mise à jour terminée, pour recommencer à recevoir du trafic, les consommateurs de multicast doivent rejoindre à nouveau tous les groupes de multicast du domaine et de la zone. Si nécessaire, coordonnez-vous avec l'administrateur du réseau de clients multicast ou les propriétaires de l'application cliente multicast.

Mettre à jour une activation de domaine multicast

Cette section explique comment mettre à jour les paramètres d'activation d'un domaine multicast qui déterminent l'échelle de votre infrastructure multicast.

Si vous avez activé un domaine multicast dans plusieurs zones, suivez cette procédure pour chaque activation de domaine multicast zonal que vous souhaitez mettre à jour.

gcloud

Pour mettre à jour une activation de domaine multicast, utilisez la commande network-services multicast-domain-activations update.

L'exécution de la commande suivante prend environ 10 à 30 minutes. Une fois la commande exécutée, l'infrastructure peut mettre plusieurs minutes à être prête à recevoir et à distribuer le trafic multicast. Pour les configurations à grande échelle, l'ensemble du processus peut prendre entre 30 minutes et 1 heure.

   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

Remplacez les valeurs suivantes :

DOMAIN_ACTIVATION_NAME : nom de l'activation du domaine multicast
ZONE : zone dans laquelle le domaine multicast a été activé
Spécifiez les paramètres suivants en fonction de vos besoins pour le trafic multicast dans cette zone. Google Cloud utilise ces paramètres pour déterminer l'échelle de votre infrastructure multicast.

Avant de spécifier ces paramètres, consultez les informations suivantes :
- Consultez les limites correspondantes pour le trafic multicast décrites dans la présentation du multicast.
- Consultez les informations suivantes sur les indicateurs facultatifs et obligatoires :
  - Si vous avez spécifié --aggr-egress-pps lors de la création de l'activation du domaine multicast, vous n'êtes pas obligé de spécifier --aggr-egress-pps. Sinon, cette option est obligatoire.
  - Toutes les autres options sont facultatives.
Pour en savoir plus sur chaque indicateur, consultez les pages suivantes :
- AGGR_EGRESS_PPS : nombre agrégé de paquets sortants par seconde (pps) pour tous les groupes multicast du domaine dans la zone spécifiée. La sortie fait référence aux paquets distribués à partir de l'infrastructure multicast aux clients multicast.
  
  Vous pouvez saisir une valeur comprise entre 0 et 500 000 000 (500 millions). La valeur par défaut est 1 000 000 (1 million). Les valeurs par défaut des autres champs sont définies de manière dynamique en fonction de la valeur que vous saisissez pour cet indicateur.
  
  Remarque : Si vous ne connaissez pas votre pps de sortie agrégé, vous pouvez l'estimer à l'aide de la formule suivante : AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.
- AGGR_INGRESS_PPS : pps d'entrée agrégés pour tous les groupes multicast du domaine dans la zone spécifiée. L'Ingress fait référence aux paquets envoyés par les producteurs multicast à l'infrastructure multicast.
  
  Vous pouvez saisir une valeur comprise entre 0 et 2 000 000. La valeur que vous saisissez pour --aggr-ingress-pps ne peut pas être supérieure à celle de --aggr-egress-pps.
- AVG_PACKET_SIZE : taille moyenne des paquets en octets. Vous pouvez saisir une valeur comprise entre 64 et 1 500.
- MAX_PER_GROUP_INGRESS_PPS : nombre maximal de paquets par seconde en entrée pour un seul groupe multicast du domaine dans la zone spécifiée. Utilisez cet indicateur pour spécifier le groupe multicast le plus actif du domaine. Cela aide Google Cloud à déterminer plus précisément l'échelle requise de votre infrastructure multicast.
  
  Vous pouvez saisir une valeur comprise entre 0 et 2 000 000. La valeur que vous saisissez pour --max-per-group-ingress-pps ne peut pas être supérieure à celle de --aggr-ingress-pps.
- MAX_PER_GROUP_SUBSCRIBERS : nombre maximal de consommateurs multicast pour un groupe multicast unique dans le domaine de la zone spécifiée. Utilisez cet indicateur pour spécifier le groupe avec le plus de consommateurs multicast, ce qui aide Google Cloud à déterminer plus précisément l'échelle requise de votre infrastructure multicast. L'inclusion de cet indicateur n'impose pas de limite au nombre de consommateurs multicast pour un groupe.
  
  Vous pouvez saisir une valeur comprise entre 1 et 500.

API

Pour mettre à jour une activation de domaine multicast, utilisez la méthode multicastDomainActivations.patch.

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

Remplacez les valeurs suivantes :

PROJECT_ID : ID du projet d'administrateur multicast
DOMAIN_ACTIVATION_NAME : nom de l'activation du domaine multicast
ZONE : zone dans laquelle le domaine multicast a été activé
Spécifiez les valeurs de l'objet trafficSpec en fonction de vos besoins pour le trafic multicast dans cette zone. Google Cloud utilise ces paramètres pour déterminer l'échelle de votre infrastructure multicast.

Avant de spécifier ces paramètres, consultez les informations suivantes :
- Consultez les limites correspondantes pour le trafic multicast décrites dans la présentation du multicast.
- Consultez les informations suivantes sur les champs facultatifs et obligatoires :
  - Si vous avez spécifié aggrEgressPps lors de la création de l'activation du domaine multicast, vous n'êtes pas obligé de spécifier aggrEgressPps. Sinon, ce champ est obligatoire.
  - Tous les autres champs de trafficSpec sont facultatifs.
Pour en savoir plus sur chaque champ, consultez les ressources suivantes :
- AGGR_EGRESS_PPS : nombre agrégé de paquets sortants par seconde (pps) pour tous les groupes multicast du domaine dans la zone spécifiée. La sortie fait référence aux paquets distribués à partir de l'infrastructure multicast aux clients multicast.
  
  Vous pouvez saisir une valeur comprise entre 0 et 500 000 000 (500 millions). La valeur par défaut est 1 000 000 (1 million). Les valeurs par défaut des autres champs sont définies de manière dynamique en fonction de la valeur que vous saisissez dans ce champ.
  
  Remarque : Si vous ne connaissez pas votre pps de sortie agrégé, vous pouvez l'estimer à l'aide de la formule suivante : AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.
- AGGR_INGRESS_PPS : pps d'entrée agrégés pour tous les groupes multicast du domaine dans la zone spécifiée. L'Ingress fait référence aux paquets envoyés par les producteurs multicast à l'infrastructure multicast.
  
  Vous pouvez saisir une valeur comprise entre 0 et 2 000 000. La valeur que vous saisissez pour aggrIngressPps ne peut pas être supérieure à celle de aggrEgressPps.
- AVG_PACKET_SIZE : taille moyenne des paquets en octets. Vous pouvez saisir une valeur comprise entre 64 et 1 500.
- MAX_PER_GROUP_INGRESS_PPS : nombre maximal de paquets par seconde en entrée pour un seul groupe multicast du domaine dans la zone spécifiée. Utilisez ce champ pour spécifier le groupe multicast le plus actif du domaine. Cela aide Google Cloud à déterminer plus précisément l'échelle requise de votre infrastructure multicast.
  
  Vous pouvez saisir une valeur comprise entre 0 et 2 000 000. La valeur que vous saisissez pour maxPerGroupIngressPps ne peut pas être supérieure à celle de aggrIngressPps.
- MAX_PER_GROUP_SUBSCRIBERS : nombre maximal de consommateurs multicast pour un groupe multicast unique dans le domaine de la zone spécifiée. Utilisez ce champ pour spécifier le groupe avec le plus de consommateurs multicast. Cela permet à Google Cloud de déterminer plus précisément l'échelle requise de votre infrastructure multicast. Cette spécification n'impose pas de limite au nombre de consommateurs multicast pour un groupe.
  
  Vous pouvez saisir une valeur comprise entre 1 et 500.