Créer des plages de groupes multicast
Cette page décrit les étapes qu'un administrateur de multidiffusion doit suivre pour créer des plages de groupes de multidiffusion.
Pour en savoir plus sur le processus de configuration de Cloud Multicast, consultez Présentation de la configuration de Cloud Multicast.
Avant de commencer
Une plage de groupes multicast doit être associée à un domaine multicast spécifique. Avant de créer une plage de groupes multicast, suivez la procédure pour créer un domaine multicast.
Créer une plage de groupes multicast
Cette section explique comment créer une plage de groupes multicast dans un domaine. Vous pouvez répéter ces étapes pour créer plusieurs plages de groupes dans un domaine donné.
Créer une plage de groupes
Associez une plage d'adresses IP de groupe multicast au domaine multicast.
gcloud
Réservez une plage interne dans le réseau VPC de l'administrateur multicast qui contient les adresses IP du groupe multicast que vous souhaitez utiliser. Pour réserver une plage interne, utilisez la commande
network-connectivity internal-ranges create.gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \ --network=ADMIN_NETWORK \ --ip-cidr-range=CIDR_RANGE
Remplacez les valeurs suivantes :
INTERNAL_RANGE_NAME: nom de la plage interne à réserverADMIN_NETWORK: nom du réseau d'administrateur multicastCIDR_RANGE: plage CIDR à réserverLa plage CIDR que vous spécifiez doit être une adresse de classe D (telle que
224.0.0.0-239.255.255.255). De plus, le nombre total d'adresses IP dans une ou plusieurs plages de groupes de multidiffusion associées au même domaine ne peut pas dépasser votre quota de groupes de multidiffusion par domaine.
Pour en savoir plus sur la création de plages internes, consultez Créer et utiliser des plages internes.
Créez une plage de groupes multicast à l'aide de la plage interne que vous avez réservée. Pour créer une plage de groupes multicast, utilisez la commande
network-services multicast-group-ranges create.gcloud network-services multicast-group-ranges create GROUP_RANGE_NAME \ --multicast-domain="projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \ --reserved-internal-range="projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME" \ --location=global \ [--require-explicit-accept ] \ [--consumer-accept-list=CONSUMER_ACCEPT_LIST] \ [--distribution-scope=DISTRIBUTION_SCOPE] \ [--enable-logging | --no-enable-logging]
Remplacez les valeurs suivantes :
GROUP_RANGE_NAME: nom de la plage de groupes multicastDOMAIN_NAME: nom du domaine multicast que vous avez créé précédemmentADMIN_PROJECT: ID du projet administrateur multicastINTERNAL_RANGE_NAME: nom de la plage interne que vous avez réservée précédemmentSpécifiez les propriétés suivantes pour le trafic multicast, l'appartenance à un groupe et la journalisation.
À l'exception du champ d'application de la répartition du trafic, vous pouvez mettre à jour chaque propriété si nécessaire à un moment ultérieur.
--require-explicit-accept: détermine les projets qui peuvent utiliser la plage de groupes multicast si la liste d'autorisation des consommateurs multicast est vide. Cette configuration détermine si un projet de consommateur multicast peut activer un réseau VPC de consommateur multicast pour la plage de groupes.- Pour refuser tous les projets, incluez cette option. Un projet ne peut utiliser la plage de groupe que si vous l'ajoutez à la liste d'acceptation des clients multicast.
- (Par défaut) Pour autoriser tous les projets, excluez cette option. Tout projet ayant accès au domaine multicast peut utiliser la plage de groupes. Dans la topologie en étoile de Network Connectivity Center (NCC), vous accordez à un projet l'accès au domaine en l'acceptant dans le hub.
CONSUMER_ACCEPT_LIST: si vous avez spécifié--require-explicit-accept, vous pouvez saisir la liste des projets de consommateurs multicast pouvant utiliser cette plage de groupes multicast. Si un projet client multicast ne figure pas dans la liste d'acceptation, il ne peut pas créer de configurations client multicast à l'aide de cette plage de groupes.Vous pouvez spécifier jusqu'à 100 projets par leur ID ou leur nom.
DISTRIBUTION_SCOPE: détermine le champ d'application géographique du trafic multicast. Vous ne pourrez pas modifier cette propriété ultérieurement.- Pour autoriser cette plage à envoyer du trafic multicast uniquement dans une zone, définissez cet indicateur sur
intra-zone. - (Par défaut) Pour autoriser cette plage à envoyer du trafic multicast entre les zones, définissez cette option sur
intra-region.
- Pour autoriser cette plage à envoyer du trafic multicast uniquement dans une zone, définissez cet indicateur sur
--[no-]enable-logging: détermine si la journalisation des événements d'appartenance à un groupe est activée pour la plage de groupes. Ce paramètre s'applique à toutes les activations zonales de la plage de groupes qui n'activent ni ne désactivent explicitement la journalisation.- Pour activer la journalisation, utilisez
--enable-logging. - (Par défaut) Pour laisser la journalisation désactivée, omettez cette option ou utilisez
--no-enable-logging.
- Pour activer la journalisation, utilisez
API
Réservez une plage interne dans le réseau VPC de l'administrateur multicast qui contient les adresses IP du groupe multicast que vous souhaitez utiliser. Pour réserver une plage interne, utilisez la méthode
internalRanges.create.POST https://networkconnectivity.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/internalRanges?internalRangeId=INTERNAL_RANGE_NAME { "network": "projects/ADMIN_PROJECT/global/networks/ADMIN_NETWORK", "ipCidrRange": "CIDR_RANGE" }Remplacez les valeurs suivantes :
INTERNAL_RANGE_NAME: nom de la plage interne à réserverADMIN_PROJECT: ID du projet d'administrateur multicastADMIN_NETWORK: nom du réseau d'administrateur multicastCIDR_RANGE: plage CIDR à réserverLa plage CIDR que vous spécifiez doit être une adresse de classe D (telle que
224.0.0.0-239.255.255.255). De plus, le nombre total d'adresses IP dans une ou plusieurs plages de groupes de multidiffusion associées au même domaine ne peut pas dépasser votre quota de groupes de multidiffusion par domaine.
Pour en savoir plus sur la création de plages internes, consultez Créer et utiliser des plages internes.
Créez une plage de groupes multicast à l'aide de la plage interne que vous avez réservée. Pour créer une plage de groupes multicast, utilisez la méthode
multicastGroupRanges.create.POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/multicastGroupRanges?multicastGroupRangeId=GROUP_RANGE_NAME { "multicastDomain": "projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME", "reservedInternalRange": "projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME", "requireExplicitAccept": "REQUIRE_EXPLICIT_ACCEPT", "consumerAcceptList": [ "CONSUMER_ACCEPT_LIST" ], "distributionScope": "DISTRIBUTION_SCOPE", "logConfig": { "enabled": "LOGGING_ENABLED" } }Remplacez les valeurs suivantes :
GROUP_RANGE_NAME: nom de la plage de groupes multicastADMIN_PROJECT: ID du projet administrateur multicastDOMAIN_NAME: nom du domaine multicast que vous avez créé précédemmentINTERNAL_RANGE_NAME: nom de la plage interne que vous avez réservée précédemment
Pour spécifier les propriétés du trafic multicast, de l'appartenance au groupe et de la journalisation, incluez les champs suivants dans le corps de la requête. À l'exception du champ d'application de la répartition du trafic, vous pouvez mettre à jour chaque propriété si nécessaire à un moment ultérieur.
REQUIRE_EXPLICIT_ACCEPT: détermine quels projets peuvent utiliser la plage de groupes multicast siconsumerAcceptListest vide. Cette configuration détermine si un projet de client multicast peut activer un réseau VPC de client multicast pour la plage de groupes.- Pour refuser tous les projets, définissez la valeur sur
true. Un projet ne peut utiliser la plage du groupe que si vous l'ajoutez àconsumerAcceptList. - (Par défaut) Pour autoriser tous les projets, définissez la valeur sur
false. Tout projet ayant accès au domaine multicast peut utiliser la plage de groupes. Dans la topologie en étoile NCC, vous accordez à un projet l'accès au domaine en l'acceptant dans le hub.
- Pour refuser tous les projets, définissez la valeur sur
CONSUMER_ACCEPT_LIST: si vous définissezrequireExplicitAcceptsurtrue, vous pouvez saisir la liste des projets de consommateurs multicast qui peuvent utiliser cette plage de groupes multicast.Si un projet client multicast ne figure pas dans la liste d'acceptation, il ne peut pas créer de configurations client multicast à l'aide de cette plage de groupes.
Vous pouvez spécifier jusqu'à 100 projets par leur ID ou leur nom. Utilisez le format suivant :
"consumerAcceptList": ["project-1", "project-2"].DISTRIBUTION_SCOPE: détermine le champ d'application géographique du trafic multicast. Vous ne pourrez pas modifier cette propriété ultérieurement.- Pour autoriser cette plage à envoyer du trafic multicast uniquement dans une zone, définissez la valeur sur
INTRA_ZONE. - (Par défaut) Pour autoriser cette plage à envoyer du trafic multicast entre les zones, définissez la valeur sur
INTRA_REGION.
- Pour autoriser cette plage à envoyer du trafic multicast uniquement dans une zone, définissez la valeur sur
LOGGING_ENABLED: détermine si la journalisation des événements d'appartenance à un groupe est activée pour la plage de groupes. Ce paramètre s'applique à toutes les activations zonales de la plage de groupes qui n'activent ni ne désactivent explicitement la journalisation.- Pour activer la journalisation, définissez ce paramètre sur
true. - (Par défaut) Pour laisser la journalisation désactivée, omettez le champ
logConfigou définissezenabledsurfalse.
- Pour activer la journalisation, définissez ce paramètre sur
Activer la plage de groupes
Activez la plage de groupes dans chaque zone où les producteurs ou les consommateurs multicast doivent utiliser les adresses IP de groupe associées.
Si vous n'activez pas une plage de groupes dans une zone donnée, les adresses IP de groupe associées ne peuvent pas être utilisées pour envoyer ou recevoir du trafic multicast dans la zone.
gcloud
Pour activer une plage de groupes multicast, utilisez la commande network-services multicast-group-range-activations create.
gcloud network-services multicast-group-range-activations create GROUP_RANGE_ACTIVATION_NAME \
--multicast-domain-activation="projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME" \
--multicast-group-range="projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME" \
--location=ZONE \
[--enable-logging | --no-enable-logging]
Remplacez les valeurs suivantes :
GROUP_RANGE_ACTIVATION_NAME: nom de l'activation de la plage de groupes multicastADMIN_PROJECT: ID du projet de l'administrateur multicastZONE: zone dans laquelle activer la plage de groupes. Il doit s'agir d'une zone dans laquelle vous avez déjà activé le domaine.DOMAIN_ACTIVATION_NAME: nom de l'activation de domaine que vous avez créée précédemment dans cette zone.GROUP_RANGE_NAME: nom de la plage de groupes que vous avez créée précédemment--[no-]enable-logging: facultatif, détermine si la journalisation des événements d'appartenance à un groupe est activée. La configuration de cette option sur une activation de plage de groupes zonale remplace le paramètre de la plage de groupes globale.- (Par défaut) Pour hériter du paramètre de journalisation de la plage de groupes globale, omettez cette option.
- Pour activer la journalisation dans cette zone, quel que soit le paramètre global, utilisez
--enable-logging. - Pour désactiver la journalisation dans cette zone, quel que soit le paramètre global, utilisez
--no-enable-logging.
API
Pour activer une plage de groupes multicast, utilisez la méthode multicastGroupRangeActivations.create.
POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/ZONE/multicastGroupRangeActivations?multicastGroupRangeActivationId=GROUP_RANGE_ACTIVATION_NAME
{
"multicastDomainActivation": "projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME",
"multicastGroupRange": "projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME",
"logConfig": {
"enabled": "LOGGING_ENABLED"
}
}
Remplacez les valeurs suivantes :
GROUP_RANGE_ACTIVATION_NAME: nom de l'activation de la plage de groupes multicastADMIN_PROJECT: ID du projet de l'administrateur multicastZONE: zone dans laquelle activer la plage de groupes. Il doit s'agir d'une zone dans laquelle vous avez déjà activé le domaine.DOMAIN_ACTIVATION_NAME: nom de l'activation de domaine que vous avez créée précédemment dans cette zone.GROUP_RANGE_NAME: nom de la plage de groupes que vous avez créée précédemmentLOGGING_ENABLED: détermine si la journalisation des événements d'appartenance à un groupe est activée. La configuration de la journalisation sur une activation de plage de groupes zonale remplace le paramètre de la plage de groupes globale.- (Par défaut) Pour hériter du paramètre de journalisation de la plage de groupes globale, omettez le champ
logConfigdu corps de la requête. - Pour activer la journalisation dans cette zone, quel que soit le paramètre global, définissez
enabledsurtrue. - Pour désactiver la journalisation dans cette zone, quel que soit le paramètre global, définissez
enabledsurfalse.
- (Par défaut) Pour hériter du paramètre de journalisation de la plage de groupes globale, omettez le champ
Étapes suivantes
- Pour afficher les configurations de plage de groupes multicast que vous avez créées, consultez Afficher les configurations de plage de groupes multicast.
- Mettre à jour les configurations de plage de groupes multicast
- Activer un réseau VPC pour produire du trafic multicast