Créer des plages de groupes multicast

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

Pour obtenir une présentation du processus de configuration du multicast, consultez Présentation de la configuration du 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

  1. 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é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) et doit avoir un préfixe supérieur ou égal à /23. Par exemple, 224.1.60.0/24 est une plage valide. Les plages dont la longueur de préfixe est inférieure ou égale à /22 ne sont pas valides.

    Pour en savoir plus sur la création de plages internes, consultez 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 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 multicast
    • DOMAIN_NAME : nom du domaine multicast que vous avez créé précédemment
    • ADMIN_PROJECT : ID du projet d'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 au groupe et la journalisation.

      À l'exception du champ d'application de la distribution du trafic, vous pouvez mettre à jour chaque propriété ultérieurement, selon vos besoins.

      • --require-explicit-accept : détermine les projets pouvant utiliser la plage de groupes multicast si la liste d'acceptation des consommateurs 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 consommateurs 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 Network Connectivity Center, vous accordez l'accès à 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 de consommateur multicast pouvant utiliser cette plage de groupes multicast. Si un projet consommateur de multidiffusion ne figure pas dans la liste d'acceptation, il ne peut pas créer de configurations de consommateur de multidiffusion à 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 à n'envoyer du trafic multicast que 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 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é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) et doit avoir un préfixe supérieur ou égal à /23. Par exemple, 224.1.60.0/24 est une plage valide. Les plages dont la longueur de préfixe est inférieure ou égale à /22 ne sont pas valides.

    Pour en savoir plus sur la création de plages internes, consultez 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 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 multicast
    • ADMIN_PROJECT : ID du projet d'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 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 distribution du trafic, vous pouvez mettre à jour chaque propriété ultérieurement, selon vos besoins.

    • REQUIRE_EXPLICIT_ACCEPT : détermine les projets pouvant 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 cette 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 cette valeur sur false. Tout projet ayant accès au domaine multicast peut utiliser la plage de groupes. Dans la topologie en étoile Network Connectivity Center, vous accordez l'accès à 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 pouvant utiliser cette plage de groupes multicast.

      Si un projet consommateur de multidiffusion ne figure pas dans la liste d'acceptation, il ne peut pas créer de configurations de consommateur de multidiffusion à 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) Définissez la valeur sur INTRA_REGION pour autoriser cette plage à envoyer du trafic multicast entre les zones.

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

      • Pour activer la journalisation, définissez ce paramètre 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 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 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. Si vous configurez cet indicateur pour activer une plage de groupes zonaux, le paramètre de la plage de groupes globale est remplacé.
    • 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 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 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 pour l'activation d'une plage de groupes zonaux remplace le paramètre de la plage de groupes globale.
    • Pour activer la journalisation, définissez ce paramètre sur true.
    • (Par défaut) Pour désactiver la journalisation, définissez la valeur sur false.

Étapes suivantes