Crear dominios de multicast

En esta página se describen los pasos que debe seguir para crear dominios 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

Antes de crear dominios de multidifusión, consulta las siguientes secciones.

Crear o identificar una red de VPC

Si aún no lo has hecho, crea una red de nube privada virtual (VPC) para usarla como red de administrador de multidifusión. Para obtener más información sobre cómo crear redes de VPC, consulta el artículo Crear y gestionar redes de VPC.

Si la red del administrador de multidifusión también va a alojar productores o consumidores de multidifusión (por ejemplo, cuando se usa la topología de una sola red VPC), asegúrate de que la red tenga las reglas de cortafuegos adecuadas para permitir el tráfico de multidifusión. Consulta lo siguiente:

Configurar el proyecto

Configura la CLI de gcloud para que use tu proyecto. También puedes incluir la marca --project=MULTICAST_ADMIN_PROJECT en cada comando de los siguientes procedimientos.

    gcloud config set project MULTICAST_ADMIN_PROJECT

Sustituye MULTICAST_ADMIN_PROJECT por el ID de tu proyecto.

Habilitar APIs

Si aún no lo has hecho, habilita las siguientes APIs.

Para habilitar APIs, necesitas el permiso serviceusage.services.enable. Si no tienes este permiso, pide a tu administrador de Gestión de Identidades y Accesos (IAM) que te conceda el rol Administrador de uso de servicios (roles/serviceusage.serviceUsageAdmin).

  1. Para crear recursos de multidifusión, habilita la API networkservices:

        gcloud services enable networkservices.googleapis.com

  2. Para crear un radio de VPC de Network Connectivity Center, habilita la API networkconnectivity:

        gcloud services enable networkconnectivity.googleapis.com

Roles obligatorios

Para obtener los permisos que necesitas para crear dominios de multidifusión, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

  • Para crear y gestionar recursos de red: Administrador de red de Compute (compute.networkAdmin) en tu proyecto
  • Para crear y gestionar reglas de cortafuegos, sigue estos pasos: Administrador de seguridad de Compute (compute.securityAdmin) en tu proyecto
  • Para crear y gestionar centros y radios de Network Connectivity Center, sigue estos pasos: Administrador de Hub y Spoke (networkconnectivity.hubAdmin) en tu proyecto
  • Para crear recursos de multidifusión, sigue estos pasos: Administrador de multidifusión (networkservices.multicastAdmin) en tu proyecto

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Configurar Network Connectivity Center

Si vas a crear un dominio de multidifusión que use la topología de estrella de Network Connectivity Center, sigue los pasos de esta sección para configurar el hub.

Si vas a crear un dominio de multidifusión que use la topología de una sola red VPC, puedes saltarte esta sección y pasar a Crear un dominio de multidifusión.

En esta sección se describe cómo configurar un centro de conectividad de red con la topología de estrella predefinida para habilitar lo siguiente:

  • Puede añadir la red de VPC de su administrador al centro de conectividad como una red de radio.
  • Si hay una red de VPC de productor de multidifusión independiente, esta puede unirse al hub como una spoke central.
  • Las redes de VPC de consumidor de multidifusión pueden unirse al hub como radios perimetrales.

Para obtener más información, consulta Topología de estrella y Configurar un concentrador en la documentación de Network Connectivity Center.

gcloud

Para configurar Network Connectivity Center, sigue estos pasos:

  1. Para crear un centro de control, usa el comando network-connectivity hubs create.

      gcloud network-connectivity hubs create HUB_NAME \
    --policy-mode=PRESET \
    --preset-topology=STAR

    Sustituye HUB_NAME por el nombre del centro de control.

  2. Para añadir tu red de VPC como una conexión de centro a la red de centro y radio, usa el comando network-connectivity spokes linked-vpc-network create.

      gcloud network-connectivity spokes linked-vpc-network create SPOKE_NAME \
    --hub=projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME \
    --vpc-network=MULTICAST_ADMIN_NETWORK \
    --group="center" \
    --global

    Haz los cambios siguientes:

    • SPOKE_NAME: un nombre para el spoke.
    • MULTICAST_ADMIN_PROJECT: ID del proyecto del administrador de multidifusión
    • HUB_NAME: el nombre del centro de conectividad de red que has creado anteriormente.

    • MULTICAST_ADMIN_NETWORK: el nombre de la red del administrador de multidifusión que has creado anteriormente

      También puedes proporcionar el URI de la red del administrador de multidifusión con el siguiente formato: projects/MULTICAST_ADMIN_PROJECT/global/networks/MULTICAST_ADMIN_NETWORK.

  3. Para permitir que las redes de VPC de consumidores de multidifusión se unan al hub, haz lo siguiente. También puedes seguir configurando la multidifusión y completar estos pasos más adelante, tal como se describe en Controlar el acceso a dominios de multidifusión.

    1. Para que los administradores de redes de consumidores de multidifusión de otros proyectos puedan proponer radios de VPC al hub, sigue los pasos que se indican en la sección Conceder acceso de la documentación de Network Connectivity Center.

    2. Pide a los administradores de las redes consumidoras de multidifusión que añadan sus redes de VPC como radios al centro que has creado siguiendo el procedimiento para habilitar una red de VPC para que consuma tráfico de multidifusión.

    3. Revisa las VPC de radio propuestas según sea necesario para comprobar las propuestas de radio.

    4. Cuando recibas una propuesta de spoke, sigue los pasos para aceptar la VPC de spoke.

Crear un dominio multicast

En esta sección se describe cómo crear un dominio de multidifusión.

Crear un grupo de dominios

En esta sección se describe cómo crear un grupo de dominios de multidifusión. Antes de continuar, revisa lo siguiente:

  • Si tienes previsto crear dominios redundantes, te recomendamos que crees un grupo de dominios para aumentar la disponibilidad entre ellos.

  • Un grupo de dominios agrupa explícitamente dos dominios relacionados. No cree un grupo de dominios para un solo dominio ni para más de dos dominios.

  • Crear un grupo de dominios es una configuración opcional. Si no necesitas un grupo de dominio, puedes saltarte este paso. Sin embargo, no puedes añadir dominios a un grupo de dominios más adelante.

gcloud

Para crear un grupo de dominios, usa el comando network-services multicast-domain-groups create.

gcloud network-services multicast-domain-groups create DOMAIN_GROUP_NAME \
   --location=global

Sustituye DOMAIN_GROUP_NAME por el nombre del grupo de dominios.

API

Para crear un grupo de dominio, usa el método multicastDomainGroups.create.

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups?multicastDomainGroupId=DOMAIN_GROUP_NAME

Haz los cambios siguientes:

  • DOMAIN_GROUP_NAME: nombre del grupo de dominios
  • MULTICAST_ADMIN_PROJECT: ID del proyecto del administrador de multidifusión

Crear un dominio

Crea uno o varios dominios de multidifusión asociados a tu red de VPC de administrador de multidifusión.

gcloud

Para crear un dominio, usa el comando network-services multicast-domains create.

Si quiere usar un grupo de dominios, debe especificarlo al crear el dominio. No podrás añadir el dominio a un grupo de dominios más adelante. Para crear dominios que formen parte de un grupo de dominios, debe ejecutar el siguiente comando dos veces. Por ejemplo, para crear DOMAIN_1 y DOMAIN_2.

   gcloud network-services multicast-domains create DOMAIN_NAME \
      --location=global \
      --admin-network=projects/MULTICAST_ADMIN_PROJECT/locations/global/networks/MULTICAST_ADMIN_NETWORK \
      --connection-type=TOPOLOGY \
      [--ncc-hub=projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME] \
      [--multicast-domain-group=projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups/DOMAIN_GROUP_NAME]

Sustituye los siguientes valores:

  • DOMAIN_NAME: un nombre para el dominio
  • MULTICAST_ADMIN_PROJECT: ID del proyecto del administrador de multidifusión
  • MULTICAST_ADMIN_NETWORK: la red de VPC del administrador de multidifusión. Si usas la topología de Network Connectivity Center, esta red también debe formar parte del centro como radio central. De lo contrario, no se podrá crear el dominio.
  • TOPOLOGY: la topología que quieras configurar para multicast. Especifica una de las siguientes opciones:
    • SAME_VPC: la topología de una sola red de VPC.
    • NCC: la topología de estrella de Network Connectivity Center.
  • HUB_NAME: si estás configurando la topología de estrella de Network Connectivity Center, especifica el nombre del concentrador.
  • DOMAIN_GROUP_NAME: si has creado un grupo de dominios, introduce el nombre del grupo de dominios.

API

Para crear un dominio, usa el método multicastDomains.create.

Si quiere usar un grupo de dominios, debe especificarlo al crear el dominio. No podrás añadir el dominio a un grupo de dominios más adelante. Para crear dominios que formen parte de un grupo de dominios, debe hacer la siguiente solicitud a la API dos veces. Por ejemplo, haz la siguiente solicitud una vez para crear DOMAIN_1 y, a continuación, vuelve a hacer la solicitud para crear DOMAIN_2:

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains?multicastDomainId=DOMAIN_NAME

{
  "adminNetwork": "projects/MULTICAST_ADMIN_PROJECT/locations/global/networks/MULTICAST_ADMIN_NETWORK",
  "connection": {
      "connectionType": "TOPOLOGY",
      "nccHub": "projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME"
  },
  "multicastDomainGroup": "projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups/DOMAIN_GROUP_NAME"
}

Sustituye los siguientes valores:

  • DOMAIN_NAME: un nombre para el dominio
  • MULTICAST_ADMIN_PROJECT: ID del proyecto del administrador de multidifusión
  • MULTICAST_ADMIN_NETWORK: la red de VPC del administrador de multidifusión. Si usas la topología de Network Connectivity Center, esta red también debe formar parte del centro como radio central. De lo contrario, no se podrá crear el dominio.
  • TOPOLOGY: la topología que quieras configurar para multicast. Especifica una de las siguientes opciones:
    • SAME_VPC: la topología de una sola red de VPC.
    • NCC: la topología de estrella de Network Connectivity Center.
  • HUB_NAME: si estás configurando la topología de estrella de Network Connectivity Center, especifica el nombre del concentrador en el campo nccHub.
  • DOMAIN_GROUP_NAME: si has creado un grupo de dominios, introduce el nombre del grupo de dominios en el campo multicastDomainGroup.

Activar el dominio

Activa el dominio en cada zona en la que los productores o consumidores de multidifusión necesiten enviar o recibir tráfico de multidifusión. Cuando activas un dominio en una zona, se aprovisiona la infraestructura de multidifusión para tu dominio en esa zona.Google Cloud

Si no activas un dominio en una zona determinada, el tráfico de multidifusión no se podrá enviar ni recibir en esa zona.

gcloud

Para activar un dominio, usa el comando network-services multicast-domain-activations create.

El siguiente comando tarda entre 10 y 30 minutos en completarse.

   gcloud network-services multicast-domain-activations create DOMAIN_ACTIVATION_NAME \
      --multicast-domain="projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \
      --location=ZONE \
      [--disable-placement-policy] \
      [--aggr-egress-pps=AGGR_EGRESS_PPS] \
      [--aggr-ingress-pps=AGGR_INGRESS_PPS] \
      [--avg-packet-size=AVG_PACKET_SIZE] \
      [--max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS] \
      [--max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS]

Sustituye los siguientes valores:

  • DOMAIN_ACTIVATION_NAME: un nombre para la activación del dominio
  • MULTICAST_ADMIN_PROJECT: ID del proyecto del administrador de multidifusión
  • DOMAIN_NAME: el nombre del dominio que se va a activar
  • ZONE: la zona en la que se activará el dominio
  • --disable-placement-policy: si vas a activar un dominio que forma parte de un grupo de dominios, puedes incluir esta marca para inhabilitar la creación de una política de emplazamiento. De lo contrario, Google Cloudcrea automáticamente una política de emplazamiento que se puede aplicar a consumidores de multidifusión nuevos o actuales.

  • Especifique los siguientes parámetros según sus necesidades para el tráfico de multidifusión de esta zona. Google Cloud usa estos parámetros para determinar la escala de su infraestructura de multidifusión.

    Antes de especificar estos parámetros, consulta lo siguiente:

    • Consulta las limitaciones del tráfico de multidifusión que se describen en la descripción general de la multidifusión.
    • Si no incluyes estas marcas, Google Cloud generará una configuración mínima que puedes usar para hacer pruebas.
    • Puedes actualizar la configuración de estas marcas más adelante, tal como se describe en Actualizar los parámetros del dominio de multidifusión.
    • Aunque estas marcas son opcionales, si incluyes alguna de ellas, --aggr-egress-pps se convierte en una marca obligatoria.

    Para obtener más información sobre cada marca, consulta lo siguiente:

    • AGGR_EGRESS_PPS: paquetes de salida agregados por segundo (pps) de todos los grupos de multidifusión del dominio en la zona especificada. Salida hace referencia a los paquetes distribuidos desde la infraestructura de multidifusión a los consumidores de multidifusión.

      Puedes introducir un valor entre 0 y 500.000.000. El valor predeterminado es 1.000.000. Los valores predeterminados de los demás campos se definen dinámicamente en función del valor que introduzcas en esta marca.

    • AGGR_INGRESS_PPS: pps de entrada agregados de todos los grupos de multidifusión del dominio en la zona especificada. La entrada hace referencia a los paquetes enviados desde productores de multidifusión a la infraestructura de multidifusión.

      Puedes introducir un valor entre 0 y 2.000.000. El valor que introduzca en --aggr-ingress-pps no puede ser superior al de --aggr-egress-pps.

    • AVG_PACKET_SIZE: tamaño medio de los paquetes en bytes. Puede introducir un valor entre 64 y 1500.

    • MAX_PER_GROUP_INGRESS_PPS: pps de entrada máximo de un solo grupo de multidifusión en el dominio de la zona especificada. Usa esta marca para especificar el grupo de multidifusión más activo del dominio, lo que ayuda a Google Cloud determinar con mayor precisión la escala necesaria de tu infraestructura de multidifusión.

      Puedes introducir un valor entre 0 y 2.000.000. El valor que introduzca en --max-per-group-ingress-pps no puede ser superior al valor de --aggr-ingress-pps.

    • MAX_PER_GROUP_SUBSCRIBERS: número máximo de consumidores de multidifusión para un solo grupo de multidifusión del dominio en la zona especificada. Usa esta marca para especificar el grupo con el mayor número de consumidores de multidifusión, lo que ayuda a Google Cloud determinar con mayor precisión la escala necesaria de tu infraestructura de multidifusión. Incluir esta marca no aplica ningún límite al número de consumidores de multidifusión de un grupo.

      Puedes introducir un valor entre 1 y 500.

API

Para activar un dominio, usa el método multicastDomainActivations.create.

La siguiente solicitud tarda entre 10 y 30 minutos en completarse.

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/ZONE/multicastDomainActivations?multicastDomainActivationId=DOMAIN_ACTIVATION_NAME

{
  "multicastDomain": "projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME",
  "disablePlacementPolicy": "PLACEMENT_POLICY_DISABLED",
  "trafficSpec": {
    "aggrEgressPps": "AGGR_EGRESS_PPS",
    "aggrIngressPps": "AGGR_INGRESS_PPS",
    "avgPacketSize": "AVG_PACKET_SIZE",
    "maxPerGroupIngressPps": "MAX_PER_GROUP_INGRESS_PPS",
    "maxPerGroupSubscribers": "MAX_PER_GROUP_SUBSCRIBERS"
  }
}

Sustituye los siguientes valores:

  • DOMAIN_ACTIVATION_NAME: un nombre para la activación del dominio
  • MULTICAST_ADMIN_PROJECT: ID del proyecto del administrador de multidifusión
  • DOMAIN_NAME: el nombre del dominio que se va a activar
  • ZONE: la zona en la que se activará el dominio
  • PLACEMENT_POLICY_DISABLED: Si activas un dominio que forma parte de un grupo de dominios, puedes incluir este campo (opcional) y asignarle el valor true para inhabilitar la creación de una política de emplazamiento. De lo contrario, Google Cloud crea automáticamente una política de colocación que se puede aplicar a consumidores de multidifusión nuevos o ya creados.

  • Especifique los valores del objeto trafficSpec según sus necesidades para el tráfico de multidifusión de esta zona. Google Cloud utiliza estos parámetros para determinar la escala de su infraestructura de multidifusión.

    Antes de especificar estos parámetros, consulta lo siguiente:

    • Consulta las limitaciones del tráfico de multidifusión que se describen en la descripción general de la multidifusión.
    • Si no incluye el objeto trafficSpec en el cuerpo de la solicitud, Google Cloud genera una configuración mínima que puede usar para las pruebas.
    • Puedes actualizar la configuración de trafficSpec más adelante, tal como se describe en Actualizar parámetros de dominio multicast.
    • Aunque los campos de trafficSpec son opcionales, si incluye alguno, aggrEgressPps se convierte en un campo obligatorio. Si incluye el objeto trafficSpec con algunos campos, debe incluir aggrEgressPps.

    Para obtener más información sobre cada campo, consulta lo siguiente:

    • AGGR_EGRESS_PPS: paquetes de salida agregados por segundo (pps) de todos los grupos de multidifusión del dominio en la zona especificada. Salida hace referencia a los paquetes distribuidos desde la infraestructura de multidifusión a los consumidores de multidifusión.

      Puedes introducir un valor entre 0 y 500.000.000. El valor predeterminado es 1.000.000. Los valores predeterminados de los demás campos se definen dinámicamente en función del valor que introduzcas en este campo.

    • AGGR_INGRESS_PPS: pps de entrada agregados de todos los grupos de multidifusión del dominio en la zona especificada. La entrada hace referencia a los paquetes enviados desde productores de multidifusión a la infraestructura de multidifusión.

      Puedes introducir un valor entre 0 y 2.000.000. El valor que introduzca en aggrIngressPps no puede ser superior al de aggrEgressPps.

    • AVG_PACKET_SIZE: tamaño medio de los paquetes en bytes. Puede introducir un valor entre 64 y 1500.

    • MAX_PER_GROUP_INGRESS_PPS: pps de entrada máximo de un solo grupo de multidifusión en el dominio de la zona especificada. Usa esta marca para especificar el grupo de multidifusión más activo del dominio, lo que ayuda a Google Cloud determinar con mayor precisión la escala necesaria de tu infraestructura de multidifusión.

      Puedes introducir un valor entre 0 y 2.000.000. El valor que introduzca en maxPerGroupIngressPps no puede ser superior al valor de aggrIngressPps.

    • MAX_PER_GROUP_SUBSCRIBERS: número máximo de consumidores de multidifusión para un solo grupo de multidifusión del dominio en la zona especificada. Usa esta marca para especificar el grupo con el mayor número de consumidores de multidifusión, lo que ayuda a Google Cloud determinar con mayor precisión la escala necesaria de tu infraestructura de multidifusión. Si proporciona esta especificación, no se aplicará ningún límite al número de consumidores de multidifusión de un grupo.

      Puedes introducir un valor entre 1 y 500.

Siguientes pasos