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 zonales existantes.

Pour en savoir plus sur la création et l'activation de domaines multicast, consultez Créer des domaines multicast.

Avant de commencer

Avant de mettre à jour les paramètres du domaine multicast, consultez les informations suivantes 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 votre infrastructure multicast est reprovisionnée en fonction des nouveaux paramètres que vous fournissez.

    • L'interruption de service s'applique à l'infrastructure multicast pour l'activation de domaine multicast spécifique que vous mettez à jour. Pendant la mise à jour, les producteurs et les clients multicast ne peuvent pas envoyer ni recevoir de trafic pour le domaine et la zone multicast correspondants.

    • La durée de l'interruption de service dépend de plusieurs facteurs, tels que l'échelle 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'échelle 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 : les activations de domaine multicast entraînent 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 de votre projet. Pour en savoir plus, contactez votre Google Cloud représentant commercial.

  • Action requise par les clients multicast après la mise à jour : une fois la mise à jour terminée, pour recommencer à recevoir du trafic, les clients multicast doivent rejoindre tous les groupes multicast du domaine et de la zone. Si nécessaire, coordonnez-vous avec l'administrateur réseau du client multicast ou les propriétaires d'applications clientes multicast.

Mettre à jour une activation de domaine multicast

Cette section explique comment mettre à jour les paramètres d'une activation de 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 network-services multicast-domain-activations update commande.

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 options facultatives et obligatoires :

      • Si vous avez spécifié --aggr-egress-pps lors de la création de l'activation du domaine multicast, vous n'avez pas besoin de spécifier --aggr-egress-pps. Sinon, cette option est obligatoire.
      • Toutes les autres options sont facultatives.

    Pour en savoir plus sur chaque option, consultez les informations suivantes :

    • AGGR_EGRESS_PPS: nombre agrégé de paquets sortants par seconde pour tous les groupes multicast du domaine dans la zone spécifiée. La sortie fait référence aux paquets distribués 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 cette option.

    • AGGR_INGRESS_PPS: nombre agrégé de paquets entrants par seconde 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 (2 millions). 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 entrants par seconde pour un seul groupe multicast du domaine dans la zone spécifiée. Utilisez cette option pour spécifier le groupe multicast le plus actif du domaine, ce qui permet de déterminer plus précisément l'échelle requise de votre infrastructure multicast. Google Cloud

      Vous pouvez saisir une valeur comprise entre 0 et 2 000 000 (2 millions). 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 clients multicast pour un seul groupe multicast du domaine dans la zone spécifiée. Utilisez cette option pour spécifier le groupe avec le plus de clients multicast, ce qui permet Google Cloud de déterminer plus précisément l'échelle requise de votre infrastructure multicast. L'inclusion de cette option n'impose pas de limite au nombre de clients 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 multicastDomainActivations.patch méthode.

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.

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 des valeurs pour 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'avez pas besoin 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 informations suivantes :

    • AGGR_EGRESS_PPS: nombre agrégé de paquets sortants par seconde pour tous les groupes multicast du domaine dans la zone spécifiée. La sortie fait référence aux paquets distribués 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 ce champ.

    • AGGR_INGRESS_PPS: nombre agrégé de paquets entrants par seconde 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 (2 millions). 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 entrants par seconde 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, ce qui permet Google Cloud de 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 (2 millions). La valeur que vous saisissez pour maxPerGroupIngressPps ne peut pas être supérieure à celle de aggrIngressPps.

    • MAX_PER_GROUP_SUBSCRIBERS: nombre maximal de clients multicast pour un seul groupe multicast du domaine dans la zone spécifiée. Utilisez ce champ pour spécifier le groupe avec le plus de clients multicast, ce qui 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 clients multicast pour un groupe.

      Vous pouvez saisir une valeur comprise entre 1 et 500.