Crea rangos de grupos de transmisión por 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 la transmisión multidifusión, consulta Descripción general de la configuración de la transmisión multidifusión.

Antes de comenzar

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

Crea 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.

Cómo crear un rango de grupos

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 multidifusión

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

      El rango de CIDR que especifiques debe ser una dirección de clase D (como 224.0.0.0 - 239.255.255.255) y debe tener un prefijo mayor o igual que /23. Por ejemplo, 224.1.60.0/24 es un rango válido. Los rangos con una longitud de prefijo de /22 o menos no son válidos.

    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 el nombre del rango del grupo de multidifusión.
    • DOMAIN_NAME: Es el nombre del dominio de transmisión multidifusión que creaste antes.
    • ADMIN_PROJECT: ID del proyecto del administrador de transmisión simultánea
    • INTERNAL_RANGE_NAME: Es 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 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 grupo si lo agregas a la lista de aceptación de consumidores de transmisión simultánea.
        • (Predeterminado) Para permitir todos los proyectos, excluye esta marca. Cualquier proyecto que tenga acceso al dominio de transmisión multidifusión puede usar el rango de grupos. En la topología en estrella de Network Connectivity Center, debes aceptar el dominio en el concentrador para otorgar acceso a un proyecto.

      • CONSUMER_ACCEPT_LIST: Si especificaste --require-explicit-accept, puedes ingresar una lista de proyectos de consumidor 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, el proyecto 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 multidifusión 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 membresía de 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: ID del proyecto del administrador de multidifusión
    • ADMIN_NETWORK: El nombre de la red del administrador de multidifusión

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

      El rango de CIDR que especifiques debe ser una dirección de clase D (como 224.0.0.0 - 239.255.255.255) y debe tener un prefijo mayor o igual que /23. Por ejemplo, 224.1.60.0/24 es un rango válido. Los rangos con una longitud de prefijo de /22 o menos no son válidos.

    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 el nombre del rango del grupo de multidifusión.
    • ADMIN_PROJECT: ID del proyecto del administrador de transmisión simultánea
    • DOMAIN_NAME: Es el nombre del dominio de transmisión multidifusión que creaste antes.
    • INTERNAL_RANGE_NAME: Es el nombre del rango interno que reservaste anteriormente.

    Para especificar propiedades para el 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 multidifusión 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, configúralo como true. Un proyecto solo puede usar el rango de grupos si lo agregas a consumerAcceptList.
      • (Predeterminado) Para permitir todos los proyectos, configúralo como false. Cualquier proyecto que tenga acceso al dominio de transmisión multidifusión puede usar el rango de grupos. En la topología en estrella de Network Connectivity Center, debes aceptar el dominio en el concentrador para otorgar acceso a un proyecto.

    • CONSUMER_ACCEPT_LIST: Si configuras requireExplicitAccept como true, puedes ingresar una lista de proyectos de consumidor 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, el proyecto 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 multidifusión solo dentro de una zona, configúralo como INTRA_ZONE.
      • (Predeterminado) Configúralo como INTRA_REGION para permitir que este rango envíe tráfico de multidifusión entre zonas.

    • LOGGING_ENABLED: Determina si el registro de eventos de membresía de grupo está habilitado.

      • Para habilitar el registro, establece el valor en true.
      • (Predeterminado) Para inhabilitar el registro, establece el valor en false.

Activa el rango del grupo

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 podrán usar para enviar o recibir tráfico de multidifusión 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 el nombre de la activación del rango del grupo de multidifusión.
  • ADMIN_PROJECT: ID del proyecto del administrador de la transmisión simultánea
  • 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 antes.
  • --[no-]enable-logging: Opcional. Determina si está habilitado el registro de eventos de membresía de grupo. Configurar esta marca en una activación de rango de grupo zonal anula el parámetro de configuración del rango de grupo 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 el nombre de la activación del rango del grupo de multidifusión.
  • ADMIN_PROJECT: ID del proyecto del administrador de la transmisión simultánea
  • 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 antes.
  • LOGGING_ENABLED: Determina si el registro de eventos de membresía de grupo está habilitado. La configuración del registro en la activación de un rango de grupos zonales anula el parámetro de configuración del rango de grupos global.
    • Para habilitar el registro, establece el valor en true.
    • (Predeterminado) Para inhabilitar el registro, establece el valor en false.

¿Qué sigue?