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 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 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 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: Es el nombre de la red de administrador de multidifusión.

    • 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 - 239.255.255.255). Además, la cantidad total de direcciones IP en uno o más rangos de grupos de multidifusión asociados con el mismo dominio no puede superar tu cuota de grupos de multidifusión 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 multicast 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 multicast que creaste antes.
    • ADMIN_PROJECT: Es el ID del proyecto de administrador de multicast.
    • INTERNAL_RANGE_NAME: Es el nombre del rango interno que reservaste antes.

    • Especifica las siguientes propiedades para el tráfico de multicast, 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 multicast si la lista de aceptación de consumidores de multicast 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 multicast.
        • Para permitir todos los proyectos, excluye esta marca (opción predeterminada). 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 aceptándolo 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, no puede crear parámetros de configuración de consumidor de multicast con este rango de grupos.

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

      • DISTRIBUTION_SCOPE: Determina el alcance de la ubicación del tráfico de multidifusión. No puedes 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 multicast 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 el rango de grupos. Este parámetro de configuración se aplica a todas las activaciones zonales del rango de grupos que no habilitan ni inhabilitan el registro de forma explícita.

        • Para habilitar el registro, usa --enable-logging.
        • (Predeterminado) Para dejar inhabilitado el registro, omite esta marca o 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: Es el nombre de la red de administrador de multidifusión.

    • 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 - 239.255.255.255). Además, la cantidad total de direcciones IP en uno o más rangos de grupos de multidifusión asociados con el mismo dominio no puede superar tu cuota de grupos de multidifusión 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 multicast 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: Es el ID del proyecto de administrador de multicast.
    • DOMAIN_NAME: Es el nombre del dominio de multicast que creaste antes.
    • INTERNAL_RANGE_NAME: Es el nombre del rango interno que reservaste antes.

    Para especificar las propiedades del tráfico de multidifusión, la membresía de grupo 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 multicast 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 del grupo.
      • Para rechazar todos los proyectos, establece el valor en true. Un proyecto solo puede usar el rango de grupos si lo agregas a consumerAcceptList.
      • (Predeterminado) Para permitir todos los proyectos, establece el valor en 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 aceptándolo 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, no puede crear parámetros de configuración de consumidor de multicast con este rango de grupos.

      Puedes especificar hasta 100 proyectos por el ID del proyecto o el 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 puedes 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 el rango de grupos. Este parámetro de configuración se aplica a todas las activaciones zonales del rango de grupos que no habilitan ni inhabilitan el registro de forma explícita.

      • Para habilitar el registro, configúralo como true.
      • (Predeterminado) Para dejar inhabilitado el registro, omite el campo logConfig o establece enabled 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, las direcciones IP de grupo asociadas no se pueden usar 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 del grupo de multidifusión.
  • ADMIN_PROJECT: el ID del proyecto del administrador de multicast
  • ZONE: Es la zona en la que se activará el rango del grupo. Esta 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 antes en esta zona.
  • GROUP_RANGE_NAME: Es el nombre del rango de grupos que creaste antes.
  • --[no-]enable-logging: Es opcional y determina si el registro de eventos de pertenencia a un grupo está habilitado. Si configuras esta marca en una activación de rango de grupos zonal, se anulará el parámetro de configuración del rango de grupos global.
    • (Predeterminado) Para heredar el parámetro de configuración de registro del rango de grupos global, omite esta marca.
    • Para habilitar el registro en esta zona, independientemente de la configuración global, usa --enable-logging.
    • Para inhabilitar el registro en esta zona, independientemente de la configuración global, 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 del grupo de multidifusión.
  • ADMIN_PROJECT: el ID del proyecto del administrador de multicast
  • ZONE: Es la zona en la que se activará el rango del grupo. Esta 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 antes en esta zona.
  • GROUP_RANGE_NAME: Es el nombre del rango de grupos que creaste antes.
  • LOGGING_ENABLED: Determina si el registro de eventos de pertenencia a un grupo está habilitado. Si configuras el registro en una activación de rango de grupos zonal, se anulará el parámetro de configuración del rango de grupos global.
    • (Predeterminado) Para heredar el parámetro de configuración de registro del rango de grupos global, omite el campo logConfig del cuerpo de la solicitud.
    • Para habilitar el registro en esta zona, independientemente de la configuración global, establece enabled en true.
    • Para inhabilitar el registro en esta zona, independientemente de la configuración global, establece enabled en false.

¿Qué sigue?