Créer des plages de groupes multicast

Cette page décrit la procédure qu'un administrateur multicast doit suivre pour créer des plages de groupes multicast.

Pour obtenir une présentation du processus de configuration de la fonctionnalité multicast, consultez la page Présentation de la configuration de la fonctionnalité 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 de création d'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

  1. Réservez une plage interne dans le réseau VPC de l'administrateur multicast qui contient les adresses IP de groupe multicast que vous souhaitez utiliser. Pour réserver une plage interne, utilisez la network-connectivity internal-ranges create commande.

    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éserver
    • ADMIN_NETWORK: nom du réseau de l'administrateur multicast

    • CIDR_RANGE : plage CIDR à réserver

      La plage CIDR que vous spécifiez doit être une adresse de classe D (par exemple, 224.0.0.0 - 239.255.255.255). De plus, le nombre total d'adresses IP dans une ou plusieurs plages de groupes multicast associées au même domaine ne peut pas dépasser votre quota de groupes multicast par domaine.

    Pour en savoir plus sur la création de plages internes, consultez la section Créer et utiliser des plages internes.

  2. 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 network-services multicast-group-ranges create commande.

    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 multicast
    • DOMAIN_NAME: nom du domaine multicast que vous avez créé précédemment
    • ADMIN_PROJECT : ID du projet de l'administrateur multicast
    • INTERNAL_RANGE_NAME: nom de la plage interne que vous avez réservée précédemment

    • Spécifiez les propriétés suivantes pour le trafic multicast, l'appartenance à un groupe et la journalisation.

      À l'exception de la répartition du trafic, vous pouvez modifier chaque propriété ultérieurement, si nécessaire.

      • --require-explicit-accept: détermine les projets qui peuvent utiliser la plage de groupes multicast si la liste d'acceptation des clients multicast est vide. Cette configuration détermine si un projet client multicast peut activer un réseau VPC client multicast pour la plage de groupes.
        • Pour refuser tous les projets, incluez cet indicateur. Un projet ne peut utiliser la plage de groupes que si vous l'ajoutez à la liste d'acceptation des clients multicast.
        • (Par défaut) Pour autoriser tous les projets, excluez cet indicateur. 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 l'accès d'un projet 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 clients 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 de client multicast à l'aide de cette plage de groupes.

        Vous pouvez spécifier jusqu'à 100 projets par ID ou nom de projet.

      • 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 cet indicateur sur intra-region.

      • --[no-]enable-logging : détermine si la journalisation des événements d'appartenance à un groupe est activée.

        • Pour activer la journalisation, utilisez --enable-logging.
        • (Par défaut) Pour désactiver la journalisation, utilisez --no-enable-logging.

API

  1. Réservez une plage interne dans le réseau VPC de l'administrateur multicast qui contient les adresses IP de groupe multicast que vous souhaitez utiliser. Pour réserver une plage interne, utilisez la internalRanges.create méthode.

    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éserver
    • ADMIN_PROJECT: ID du projet de l'administrateur multicast
    • ADMIN_NETWORK: nom du réseau de l'administrateur multicast

    • CIDR_RANGE : plage CIDR à réserver

      La plage CIDR que vous spécifiez doit être une adresse de classe D (par exemple, 224.0.0.0 - 239.255.255.255). De plus, le nombre total d'adresses IP dans une ou plusieurs plages de groupes multicast associées au même domaine ne peut pas dépasser votre quota de groupes multicast par domaine.

    Pour en savoir plus sur la création de plages internes, consultez la section Créer et utiliser des plages internes.

  2. 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 multicastGroupRanges.create méthode.

    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 multicast
    • ADMIN_PROJECT : ID du projet de l'administrateur multicast
    • DOMAIN_NAME: nom du domaine multicast que vous avez créé précédemment
    • INTERNAL_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 à un groupe et de la journalisation, incluez les champs suivants dans le corps de la requête. À l'exception de la répartition du trafic, vous pouvez modifier chaque propriété ultérieurement, si nécessaire.

    • REQUIRE_EXPLICIT_ACCEPT: détermine les projets qui peuvent utiliser la plage de groupes multicast si consumerAcceptList est vide. Cette configuration détermine si un projet client multicast peut activer un réseau VPC 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 de groupes 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 de NCC, vous accordez l'accès d'un projet au domaine en l'acceptant dans le hub.

    • CONSUMER_ACCEPT_LIST: si vous définissez requireExplicitAccept sur true, vous pouvez saisir la liste des projets clients 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 de client multicast à l'aide de cette plage de groupes.

      Vous pouvez spécifier jusqu'à 100 projets par ID ou nom de projet. 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.

    • LOGGING_ENABLED : détermine si la journalisation des événements d'appartenance à un groupe est activée.

      • Pour activer la journalisation, définissez la valeur sur true.
      • (Par défaut) Pour désactiver la journalisation, définissez la valeur sur false.

Activer la plage de groupes

Activez la plage de groupes dans chaque zone où les producteurs ou les clients 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 network-services multicast-group-range-activations create commande.

  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 multicast
  • ADMIN_PROJECT : ID du projet de l'administrateur multicast
  • ZONE : 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 cet indicateur sur une activation de plage de groupes zonale remplace le paramètre de la plage de groupes globale.
    • Pour activer la journalisation, utilisez --enable-logging.
    • (Par défaut) Pour désactiver la journalisation, utilisez --no-enable-logging.

API

Pour activer une plage de groupes multicast, utilisez la multicastGroupRangeActivations.create méthode.

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 multicast
  • ADMIN_PROJECT : ID du projet de l'administrateur multicast
  • ZONE : 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
  • LOGGING_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.
    • Pour activer la journalisation, définissez la valeur sur true.
    • (Par défaut) Pour désactiver la journalisation, définissez la valeur sur false.

Étape suivante