Crea rangos de grupos de multicast

En esta página, se describen los pasos que debe seguir un administrador de multicast para crear rangos de grupos de multicast.

Para obtener una descripción general del proceso de configuración de multicast, consulta Descripción general de la configuración de multicast.

Antes de comenzar

Un rango de grupos de multicast debe estar asociado con un dominio de multicast específico. Antes de crear un rango de grupos de multicast, sigue los pasos para crear un dominio de multicast.

Crea un rango de grupos de multicast

En esta sección, se describe cómo crear un rango de grupos de multicast en un dominio. Puedes repetir estos pasos para crear varios rangos de grupos en un dominio determinado.

Crea un rango de grupos

Asocia un rango de direcciones IP de grupos de multicast con el dominio de multicast.

gcloud

  1. Reserva un rango interno en la red de VPC del administrador de multicast que contenga las direcciones IP de grupos de multicast que deseas usar. Para reservar un rango interno, usa el network-connectivity internal-ranges create comando.

    gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \
   --network=ADMIN_NETWORK \
   --ip-cidr-range=CIDR_RANGE

    Reemplaza los siguientes valores:

    • INTERNAL_RANGE_NAME: Un nombre para el rango interno que se reservará
    • ADMIN_NETWORK: El nombre de la red del administrador de multicast

    • CIDR_RANGE: El rango CIDR que se reservará

      El rango CIDR que especifiques debe ser una dirección de clase D (como 224.0.0.0 - 239.255.255.255). Además, la cantidad total de direcciones IP en uno o más rangos de grupos de multicast asociados con el mismo dominio no puede exceder tu cuota para grupos de multicast por dominio.

    Para obtener más información sobre la creación de rangos internos, consulta Crea y usa rangos internos.

  2. Crea un rango de grupos de multicast con el rango interno que reservaste. Para crear un rango de grupos de multicast, usa network-services multicast-group-ranges create comando.

    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]

    Reemplaza los siguientes valores:

    • GROUP_RANGE_NAME: Un nombre para el rango de grupos de multicast
    • DOMAIN_NAME: El nombre del dominio de multicast que creaste anteriormente
    • ADMIN_PROJECT: El ID del proyecto del administrador de multicast
    • INTERNAL_RANGE_NAME: El nombre del rango interno que reservaste anteriormente

    • Especifica las siguientes propiedades para el tráfico de multicast, la membresía de grupos y el registro.

      Excepto por el alcance de la distribución del tráfico, puedes actualizar cada propiedad según sea necesario más adelante.

      • --require-explicit-accept: Determina qué proyectos pueden usar el rango de grupos de multicast si la lista de aceptación del consumidor de multicast está vacía. Esta configuración determina si un proyecto de consumidor de multicast puede activar una red de VPC del consumidor de multicast para el rango de grupos.
        • Para rechazar todos los proyectos, incluye esta marca. Un proyecto solo puede usar el rango de grupos si lo agregas a la lista de aceptación del consumidor de multicast.
        • (Valor predeterminado) Para permitir todos los proyectos, excluye esta marca. Cualquier proyecto que tenga acceso al dominio de multicast puede usar el rango de grupos. En la topología de estrella de Network Connectivity Center (NCC), otorgas acceso a un proyecto al dominio si lo aceptas en el concentrador.

      • CONSUMER_ACCEPT_LIST: Si especificaste --require-explicit-accept, puedes ingresar una lista de proyectos de consumidores de multicast que pueden usar este rango de grupos de multicast. Si un proyecto de consumidor de multicast no está en la lista de aceptación, el proyecto no puede crear configuraciones de consumidor de multicast con este rango de grupos.

        Puedes especificar hasta 100 proyectos por ID del proyecto o nombre.

      • DISTRIBUTION_SCOPE: Determina el alcance de la ubicación del tráfico de multicast. No puedes actualizar esta propiedad más adelante.

        • Para permitir que este rango envíe tráfico de multicast solo dentro de una zona, configura esta marca como intra-zone.
        • (Valor predeterminado) Para permitir que este rango envíe tráfico de multicast en todas las zonas, configura esta marca como intra-region.

      • --[no-]enable-logging: Determina si está habilitado el registro de eventos de pertenencia a un grupo.

        • Para habilitar el registro, usa --enable-logging.
        • (Valor predeterminado) Para inhabilitar el registro, usa --no-enable-logging.

API

  1. Reserva un rango interno en la red de VPC del administrador de multicast que contenga las direcciones IP de grupos de multicast que deseas usar. Para reservar un rango interno, usa el internalRanges.create método.

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

    Reemplaza los siguientes valores:

    • INTERNAL_RANGE_NAME: Un nombre para el rango interno que se reservará
    • ADMIN_PROJECT: El ID del proyecto del administrador de multicast
    • ADMIN_NETWORK: El nombre de la red del administrador de multicast

    • CIDR_RANGE: El rango CIDR que se reservará

      El rango CIDR que especifiques debe ser una dirección de clase D (como 224.0.0.0 - 239.255.255.255). Además, la cantidad total de direcciones IP en uno o más rangos de grupos de multicast asociados con el mismo dominio no puede exceder tu cuota para grupos de multicast por dominio.

    Para obtener más información sobre la creación de rangos internos, consulta Crea y usa rangos internos.

  2. Crea un rango de grupos de multicast con el rango interno que reservaste. Para crear un rango de grupos de multicast, usa el multicastGroupRanges.create método.

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

    Reemplaza los siguientes valores:

    • GROUP_RANGE_NAME: Un nombre para el rango de grupos de multicast
    • ADMIN_PROJECT: El ID del proyecto del administrador de multicast
    • DOMAIN_NAME: El nombre del dominio de multicast que creaste anteriormente
    • INTERNAL_RANGE_NAME: El nombre del rango interno que reservaste anteriormente

    Para especificar propiedades para el tráfico de multicast, la membresía de grupos y el registro, incluye los siguientes campos en el cuerpo de la solicitud. Excepto por el alcance de la distribución del tráfico, puedes actualizar cada propiedad según sea necesario más adelante.

    • REQUIRE_EXPLICIT_ACCEPT: Determina qué proyectos pueden usar el rango de grupos de multicast si consumerAcceptList está vacío. Esta configuración determina si un proyecto de consumidor de multicast puede activar una red de VPC del consumidor de multicast para el rango de grupos.
      • Para rechazar todos los proyectos, configura como true. Un proyecto solo puede usar el rango de grupos si lo agregas a consumerAcceptList.
      • (Valor predeterminado) Para permitir todos los proyectos, configura como false. Cualquier proyecto que tenga acceso al dominio de multicast puede usar el rango de grupos. En la topología de estrella de NCC, otorgas acceso a un proyecto al dominio si lo aceptas en el concentrador.

    • CONSUMER_ACCEPT_LIST: Si configuras requireExplicitAccept como true, puedes ingresar una lista de proyectos de consumidores de multicast que pueden usar este rango de grupos de multicast.

      Si un proyecto de consumidor de multicast no está en la lista de aceptación, el proyecto no puede crear configuraciones de consumidor de multicast con este rango de grupos.

      Puedes especificar hasta 100 proyectos por ID del proyecto o nombre. Usa el siguiente formato: "consumerAcceptList": ["project-1", "project-2"].

    • DISTRIBUTION_SCOPE: Determina el alcance de la ubicación del tráfico de multicast. No puedes actualizar esta propiedad más adelante.

      • Para permitir que este rango envíe tráfico de multicast solo dentro de una zona, configura como INTRA_ZONE.
      • (Valor predeterminado) Para permitir que este rango envíe tráfico de multicast en todas las zonas, configura como INTRA_REGION.

    • LOGGING_ENABLED: Determina si está habilitado el registro de eventos de pertenencia a un grupo .

      • Para habilitar el registro, configura como true.
      • (Valor predeterminado) Para inhabilitar el registro, configura como false.

Activa el rango de grupos

Activa el rango de grupos en cada zona en la que los productores o consumidores de multicast necesiten usar las direcciones IP de grupos asociadas.

Si no activas un rango de grupos en una zona determinada, las direcciones IP de grupos asociadas no se pueden usar para enviar ni recibir tráfico de multicast en la zona.

gcloud

Para activar un rango de grupos de multicast, usa el network-services multicast-group-range-activations create comando.

  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]

Reemplaza los siguientes valores:

  • GROUP_RANGE_ACTIVATION_NAME: Un nombre para la activación del rango de grupos de multicast
  • ADMIN_PROJECT: El ID del proyecto del administrador de multicast
  • ZONE: La zona en la que se activará el rango de grupos. Debe ser una zona en la que hayas activado el dominio anteriormente.
  • DOMAIN_ACTIVATION_NAME: El nombre de la activación del dominio que creaste anteriormente en esta zona
  • GROUP_RANGE_NAME: El nombre del rango de grupos que creaste anteriormente
  • --[no-]enable-logging: Opcional, determina si el registro de eventos de pertenencia a un grupo está habilitado. Configurar esta marca en una activación de rango de grupos zonales anula la configuración del rango de grupos global.
    • Para habilitar el registro, usa --enable-logging.
    • (Valor predeterminado) Para inhabilitar el registro, usa --no-enable-logging.

API

Para activar un rango de grupos de multicast, usa el multicastGroupRangeActivations.create método.

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

Reemplaza los siguientes valores:

  • GROUP_RANGE_ACTIVATION_NAME: Un nombre para la activación del rango de grupos de multicast
  • ADMIN_PROJECT: El ID del proyecto del administrador de multicast
  • ZONE: La zona en la que se activará el rango de grupos. Debe ser una zona en la que hayas activado el dominio anteriormente.
  • DOMAIN_ACTIVATION_NAME: El nombre de la activación del dominio que creaste anteriormente en esta zona
  • GROUP_RANGE_NAME: El nombre del rango de grupos que creaste anteriormente
  • LOGGING_ENABLED: Determina si el registro de eventos de pertenencia a un grupo está habilitado. Configurar el registro en una activación de rango de grupos zonales anula la configuración del rango de grupos global.
    • Para habilitar el registro, configura como true.
    • (Valor predeterminado) Para inhabilitar el registro, configura como false.

¿Qué sigue?