Crea rangos de grupos de multidifusión

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

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

Antes de comenzar

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

Cómo crear un rango de grupos de transmisión por multidifusión

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

Crear un rango de grupo

Asocia un rango de direcciones IP de grupo 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 del grupo de multicast que deseas usar. Para reservar un rango interno, usa el comando network-connectivity internal-ranges create.

    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: Es el rango CIDR que se reservará.

      El rango CIDR que especifiques debe ser una dirección de clase D (como 224.0.0.0 a 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 superar tu cuota de grupos de multicast por dominio.

    Para obtener más información sobre cómo crear rangos internos, consulta Crea y usa rangos internos.

  2. Crea un rango de grupos de multidifusión con el rango interno que reservaste. Para crear un rango de grupos de multidifusión, usa el comando 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]

    Reemplaza los siguientes valores:

    • GROUP_RANGE_NAME: Es un nombre para el rango del grupo de multidifusión.
    • DOMAIN_NAME: Es el nombre del dominio de transmisión multidifusión que creaste anteriormente.
    • ADMIN_PROJECT: ID del proyecto de administrador de transmisión simultánea
    • INTERNAL_RANGE_NAME: El nombre del rango interno que reservaste anteriormente

    • Especifica las siguientes propiedades para el tráfico de multidifusión, la membresía de grupo y el registro.

      Excepto por el alcance de la distribución del tráfico, puedes actualizar cada propiedad según sea necesario en un momento posterior.

      • --require-explicit-accept: Determina qué proyectos pueden usar el rango de grupos de transmisión simultánea si la lista de aceptación de consumidores de transmisión simultánea está vacía. Esta configuración determina si un proyecto de consumidor de multicast puede activar una red de VPC de 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 de consumidores de transmisión por multidifusión.
        • (Predeterminado) Para permitir todos los proyectos, excluye esta marca. Cualquier proyecto que tenga acceso al dominio de transmisión por multidifusión puede usar el rango de grupos. En la topología en estrella de Network Connectivity Center (NCC), otorgas acceso a un proyecto al dominio aceptándolo en el concentrador.

      • CONSUMER_ACCEPT_LIST: Si especificaste --require-explicit-accept, puedes ingresar una lista de proyectos de consumidores de transmisión simultánea que pueden usar este rango de grupos de transmisión simultánea. Si un proyecto de consumidor de multicast no está en la lista de aceptación, no podrá 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 multidifusión. No podrás actualizar esta propiedad más adelante.

        • Para permitir que este rango envíe tráfico de multicast solo dentro de una zona, establece esta marca en intra-zone.
        • (Predeterminado) Para permitir que este rango envíe tráfico de multidifusión entre zonas, establece esta marca en intra-region.

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

        • Para habilitar el registro, usa --enable-logging.
        • (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 del grupo de multicast que deseas usar. Para reservar un rango interno, usa el método 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"
}

    Reemplaza los siguientes valores:

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

    • CIDR_RANGE: Es el rango CIDR que se reservará.

      El rango CIDR que especifiques debe ser una dirección de clase D (como 224.0.0.0 a 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 superar tu cuota de grupos de multicast por dominio.

    Para obtener más información sobre cómo crear rangos internos, consulta Crea y usa rangos internos.

  2. Crea un rango de grupos de multidifusión con el rango interno que reservaste. Para crear un rango de grupos de multidifusión, usa el método 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"
 }
}

    Reemplaza los siguientes valores:

    • GROUP_RANGE_NAME: Es un nombre para el rango del grupo de multidifusión.
    • ADMIN_PROJECT: ID del proyecto de administrador de transmisión simultánea
    • DOMAIN_NAME: Es el nombre del dominio de transmisión multidifusión que creaste anteriormente.
    • INTERNAL_RANGE_NAME: El nombre del rango interno que reservaste anteriormente

    Para especificar propiedades para el tráfico de multidifusión, 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 en un momento posterior.

    • REQUIRE_EXPLICIT_ACCEPT: Determina qué proyectos pueden usar el rango de grupos de transmisión simultánea si consumerAcceptList está vacío. Esta configuración determina si un proyecto de consumidor de multicast puede activar una red de VPC de consumidor de multicast para el rango de grupos.
      • Para rechazar todos los proyectos, establece el valor en true. Un proyecto solo puede usar el rango de grupo si lo agregas a consumerAcceptList.
      • (Predeterminado) Para permitir todos los proyectos, establece el valor en false. Cualquier proyecto que tenga acceso al dominio de transmisión por multidifusión puede usar el rango de grupos. En la topología en estrella de NCC, otorgas acceso a un proyecto al dominio aceptándolo en el hub.

    • CONSUMER_ACCEPT_LIST: Si configuras requireExplicitAccept como true, puedes ingresar una lista de proyectos de consumidores de transmisión simultánea que pueden usar este rango de grupos de transmisión simultánea.

      Si un proyecto de consumidor de multicast no está en la lista de aceptación, no podrá 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 multidifusión. No podrás actualizar esta propiedad más adelante.

      • Para permitir que este rango envíe tráfico de multicast solo dentro de una zona, establece el valor en INTRA_ZONE.
      • (Predeterminado) Para permitir que este rango envíe tráfico de multicast entre zonas, establece el valor en INTRA_REGION.

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

      • Para habilitar el registro, configúrala como true.
      • (Predeterminado) Para inhabilitar el registro, establece el valor en 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 grupo asociadas.

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

gcloud

Para activar un rango de grupos de multicast, usa el comando 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]

Reemplaza los siguientes valores:

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

API

Para activar un rango de grupos de multicast, usa el método 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"
    }
}

Reemplaza los siguientes valores:

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

¿Qué sigue?