Crear intervalos de grupos de multidifusión

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

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

Antes de empezar

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

Crear un intervalo de grupos de multidifusión

En esta sección se describe cómo crear un intervalo de grupos de multidifusión en un dominio. Puede repetir estos pasos para crear varios intervalos de grupos en un dominio determinado.

Crear un intervalo de grupo

Asocia un intervalo de direcciones IP de grupo de multidifusión al dominio de multidifusión.

gcloud

  1. Reserva un intervalo interno en la red de VPC del administrador de multidifusión que contenga las direcciones IP del grupo de multidifusión que quieras usar. Para reservar un intervalo 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

    Sustituye los siguientes valores:

    • INTERNAL_RANGE_NAME: un nombre para el intervalo interno que quieras reservar
    • ADMIN_NETWORK: el nombre de la red del administrador de multicast

    • CIDR_RANGE: el intervalo CIDR que se va a reservar

      El intervalo 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 que sea igual o superior a /23. Por ejemplo, 224.1.60.0/24 es un intervalo válido. Los intervalos con una longitud de prefijo de /22 o menos no son válidos.

    Para obtener más información sobre cómo crear intervalos internos, consulta el artículo Crear y usar intervalos internos.

  2. Crea un intervalo de grupos de multidifusión con el intervalo interno que has reservado. Para crear un intervalo 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]

    Sustituye los siguientes valores:

    • GROUP_RANGE_NAME: un nombre para el intervalo del grupo de multidifusión
    • DOMAIN_NAME: el nombre del dominio multicast que has creado anteriormente
    • ADMIN_PROJECT: el ID del proyecto de administrador de multidifusión
    • INTERNAL_RANGE_NAME: el nombre del intervalo interno que has reservado anteriormente

    • Especifique las siguientes propiedades para el tráfico de multidifusión, la pertenencia a grupos y el registro.

      A excepción del ámbito de distribución del tráfico, puedes actualizar cada propiedad según sea necesario en otro momento.

      • --require-explicit-accept: determina qué proyectos pueden usar el intervalo de grupos de multidifusión si la lista de aceptación de consumidores de multidifusión está vacía. Esta configuración determina si un proyecto consumidor de multidifusión puede activar una red VPC de consumidor de multidifusión para el intervalo de grupos.
        • Para denegar todos los proyectos, incluye esta marca. Un proyecto solo puede usar el intervalo de grupos si lo añades a la lista de aceptación de consumidores de multidifusión.
        • (Valor predeterminado) Para permitir todos los proyectos, excluye esta marca. Cualquier proyecto que tenga acceso al dominio de multidifusión puede usar el intervalo de grupos. En la topología de estrella de Network Connectivity Center, se concede acceso a un proyecto al dominio aceptándolo en el centro de control.

      • CONSUMER_ACCEPT_LIST: si has especificado --require-explicit-accept, puedes introducir una lista de proyectos de consumidor de multidifusión que pueden usar este intervalo de grupos de multidifusión. Si un proyecto de consumidor de multidifusión no está en la lista de aceptación, el proyecto no podrá crear configuraciones de consumidor de multidifusión con este intervalo de grupos.

        Puede especificar hasta 100 proyectos por su ID o nombre.

      • DISTRIBUTION_SCOPE: determina el ámbito de ubicación del tráfico de multidifusión. No podrás actualizar esta propiedad más adelante.

        • Para permitir que este intervalo envíe tráfico multicast solo dentro de una zona, defina esta marca como intra-zone.
        • (Valor predeterminado) Para permitir que este intervalo envíe tráfico multicast entre zonas, asigna el valor intra-region a esta marca.

      • --[no-]enable-logging: determina si está habilitado el registro de eventos de pertenencia a grupos.

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

API

  1. Reserva un intervalo interno en la red de VPC del administrador de multidifusión que contenga las direcciones IP del grupo de multidifusión que quieras usar. Para reservar un intervalo 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"
}

    Sustituye los siguientes valores:

    • INTERNAL_RANGE_NAME: un nombre para el intervalo interno que quieras reservar
    • ADMIN_PROJECT: ID del proyecto del administrador de multidifusión
    • ADMIN_NETWORK: el nombre de la red del administrador de multicast

    • CIDR_RANGE: el intervalo CIDR que se va a reservar

      El intervalo 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 que sea igual o superior a /23. Por ejemplo, 224.1.60.0/24 es un intervalo válido. Los intervalos con una longitud de prefijo de /22 o menos no son válidos.

    Para obtener más información sobre cómo crear intervalos internos, consulta el artículo Crear y usar intervalos internos.

  2. Crea un intervalo de grupos de multidifusión con el intervalo interno que has reservado. Para crear un intervalo 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"
 }
}

    Sustituye los siguientes valores:

    • GROUP_RANGE_NAME: un nombre para el intervalo del grupo de multidifusión
    • ADMIN_PROJECT: el ID del proyecto de administrador de multidifusión
    • DOMAIN_NAME: el nombre del dominio multicast que has creado anteriormente
    • INTERNAL_RANGE_NAME: el nombre del intervalo interno que has reservado anteriormente

    Para especificar las propiedades del tráfico de multidifusión, la pertenencia a grupos y el registro, incluya los siguientes campos en el cuerpo de la solicitud. A excepción del ámbito de distribución del tráfico, puedes actualizar cada propiedad según sea necesario en otro momento.

    • REQUIRE_EXPLICIT_ACCEPT: determina qué proyectos pueden usar el intervalo de grupos de multidifusión si consumerAcceptList está vacío. Esta configuración determina si un proyecto consumidor de multidifusión puede activar una red de VPC de consumidor de multidifusión para el intervalo de grupos.
      • Para denegar todos los proyectos, asigna el valor true. Un proyecto solo puede usar el intervalo de grupos si lo añades a consumerAcceptList.
      • (Predeterminado) Para permitir todos los proyectos, selecciona false. Cualquier proyecto que tenga acceso al dominio de multidifusión puede usar el intervalo de grupos. En la topología de estrella de Network Connectivity Center, se concede acceso a un proyecto al dominio aceptándolo en el centro de control.

    • CONSUMER_ACCEPT_LIST: si asignas el valor true a requireExplicitAccept, puedes introducir una lista de proyectos de consumidor de multidifusión que puedan usar este intervalo de grupos de multidifusión.

      Si un proyecto de consumidor de multidifusión no está en la lista de aceptación, no podrá crear configuraciones de consumidor de multidifusión con este intervalo de grupos.

      Puede especificar hasta 100 proyectos por su ID o nombre. Utiliza el siguiente formato: "consumerAcceptList": ["project-1", "project-2"].

    • DISTRIBUTION_SCOPE: determina el ámbito de ubicación del tráfico de multidifusión. No podrás actualizar esta propiedad más adelante.

      • Para permitir que este intervalo envíe tráfico multicast solo dentro de una zona, defínelo como INTRA_ZONE.
      • (Valor predeterminado) Para permitir que este intervalo envíe tráfico de multidifusión entre zonas, defina el valor INTRA_REGION.

    • LOGGING_ENABLED: determina si está habilitado el registro de eventos de pertenencia a grupos.

      • Para habilitar el registro, asigna el valor true.
      • (Valor predeterminado) Para inhabilitar el registro, asigna el valor false.

Activar el intervalo del grupo

Activa el intervalo de grupos en cada zona en la que los productores o consumidores de multidifusión necesiten usar las direcciones IP de grupo asociadas.

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

gcloud

Para activar un intervalo de grupos de multidifusión, 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]

Sustituye los siguientes valores:

  • GROUP_RANGE_ACTIVATION_NAME: un nombre para el grupo de multidifusión activación del intervalo
  • ADMIN_PROJECT: el ID de proyecto del administrador de multidifusión
  • ZONE: la zona en la que se activará el intervalo del grupo. Debe ser una zona en la que hayas activado el dominio anteriormente.
  • DOMAIN_ACTIVATION_NAME: el nombre de la activación del dominio que has creado anteriormente en esta zona
  • GROUP_RANGE_NAME: el nombre del intervalo de grupos que has creado anteriormente
  • --[no-]enable-logging: opcional, determina si el registro de eventos de pertenencia a grupos está habilitado. Si se configura esta marca en una activación de intervalo de grupo zonal, se anula el ajuste del intervalo de grupo global.
    • Para habilitar el registro, usa --enable-logging.
    • (Predeterminado) Para inhabilitar el registro, usa --no-enable-logging.

API

Para activar un intervalo de grupos de multidifusión, 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"
    }
}

Sustituye los siguientes valores:

  • GROUP_RANGE_ACTIVATION_NAME: un nombre para el grupo de multidifusión activación del intervalo
  • ADMIN_PROJECT: el ID de proyecto del administrador de multidifusión
  • ZONE: la zona en la que se activará el intervalo del grupo. Debe ser una zona en la que hayas activado el dominio anteriormente.
  • DOMAIN_ACTIVATION_NAME: el nombre de la activación del dominio que has creado anteriormente en esta zona
  • GROUP_RANGE_NAME: el nombre del intervalo de grupos que has creado anteriormente
  • LOGGING_ENABLED: determina si está habilitado el registro de eventos de pertenencia a grupos. Configurar el registro en una activación de intervalo de grupo zonal anula la configuración del intervalo de grupo global.
    • Para habilitar el registro, asigna el valor true.
    • (Valor predeterminado) Para inhabilitar el registro, asigna el valor false.

Siguientes pasos