Crea dominios de multicast

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

Antes de crear dominios de multicast, consulta las siguientes secciones.

Crea o identifica una red de VPC

Si aún no lo hiciste, crea una red de nube privada virtual (VPC) para usarla como la red de administrador de multicast. Para obtener más información sobre cómo crear redes de VPC, consulta Crea y administra redes de VPC.

Si tu red de administrador de multicast también alojará productores o consumidores de multicast, como cuando se usa la topología de red de VPC única, asegúrate de que la red tenga las reglas de firewall adecuadas para permitir el tráfico de multicast. Consulta lo siguiente:

Configura tu proyecto

Configura gcloud CLI para usar tu proyecto. Como alternativa, puedes incluir la marca --project=MULTICAST_ADMIN_PROJECT para cada comando en los siguientes procedimientos.

    gcloud config set project MULTICAST_ADMIN_PROJECT

Reemplaza MULTICAST_ADMIN_PROJECT por el ID de tu proyecto.

Habilita las APIs

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

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si no tienes este permiso, pídele a tu administrador de Identity and Access Management (IAM) que te otorgue el rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin).

  1. Para crear recursos de multicast, habilita la API de networkservices:

        gcloud services enable networkservices.googleapis.com
    
  2. Para crear un radio de VPC de Network Connectivity Center (NCC), habilita la API de networkconnectivity:

        gcloud services enable networkconnectivity.googleapis.com
    

Roles obligatorios

Para obtener los permisos que necesitas para crear dominios de multidifusión, pídele a tu administrador que te otorgue los siguientes roles de IAM:

  • Para crear y administrar recursos de red: Administrador de red de Compute (compute.networkAdmin) en tu proyecto
  • Para crear y administrar reglas de firewall: Administrador de seguridad de Compute (compute.securityAdmin) en tu proyecto
  • Para crear y administrar concentradores y radios de NCC: Administrador de Hub y Spoke (networkconnectivity.hubAdmin) en tu proyecto
  • Para crear recursos de multicast: Administrador de multicast (networkservices.multicastAdmin) en tu proyecto

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Configura NCC

Si creas un dominio de multicast que usa la topología de estrella de NCC, sigue los pasos de esta sección para configurar el concentrador.

Si creas un dominio de multidifusión que usa la topología de red de VPC única, puedes omitir esta sección y continuar con Crea un dominio de multidifusión.

En esta sección, se describe cómo configurar un concentrador de NCC con la topología de estrella predeterminada para habilitar lo siguiente:

  • Puedes agregar tu red de VPC de administrador al concentrador como un radio central.
  • Si hay una red de VPC de productor de multicast independiente, esta puede unirse al concentrador como un radio central.
  • Las redes de VPC de consumidores de multicast pueden unirse al concentrador como radios perimetrales.

Para obtener más información, consulta Topología de estrella y Configura un concentrador en la documentación de NCC.

gcloud

Para configurar NCC, haz lo siguiente:

  1. Para crear un concentrador, usa el comando network-connectivity hubs create.

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

    Reemplaza HUB_NAME por un nombre para el concentrador.

  2. Para agregar tu red de VPC como un radio central al concentrador, 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
    

    Reemplaza lo siguiente:

    • SPOKE_NAME: Es el nombre del radio.
    • MULTICAST_ADMIN_PROJECT: Es el ID del proyecto de administrador de multicast.
    • HUB_NAME: Es el nombre del concentrador de NCC que creaste antes.
    • MULTICAST_ADMIN_NETWORK: Es el nombre de la red de administrador de multicast que creaste antes.

      Como alternativa, puedes proporcionar el URI de la red de administrador de multicast con el siguiente formato: projects/MULTICAST_ADMIN_PROJECT/global/networks/MULTICAST_ADMIN_NETWORK.

  3. Para permitir que las redes de VPC de consumidores de multicast se unan al concentrador, haz lo siguiente. Como alternativa, puedes seguir configurando la multidifusión y completar estos pasos más adelante, como se describe en Controla el acceso a los dominios de multidifusión.

    1. Otorga a los administradores de redes de consumidores de multicast de otros proyectos la capacidad de proponer radios de VPC al concentrador siguiendo los pasos que se indican en Otorga acceso en la documentación de NCC.

    2. Pídeles a los administradores de red de consumidores de multicast que agreguen sus redes de VPC como radios al concentrador que creaste cuando sigan el procedimiento para habilitar una red de VPC para consumir tráfico de multicast.

    3. Revisa los radios de VPC propuestos según sea necesario para verificar las propuestas de radio.

    4. Cuando recibas una propuesta de radio, sigue los pasos para aceptar el radio de VPC.

Crea un dominio de multicast

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

Crea un grupo de dominios

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

  • Si planeas crear dominios redundantes, te recomendamos que crees un grupo de dominios para obtener una mayor disponibilidad entre ellos.

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

  • Crear un grupo de dominios es un parámetro de configuración opcional. Si no necesitas un grupo de dominios, puedes omitir este paso. Sin embargo, no puedes agregar dominios existentes 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

Reemplaza DOMAIN_GROUP_NAME por un nombre para el grupo de dominios.

API

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

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

Reemplaza lo siguiente:

  • DOMAIN_GROUP_NAME: Es un nombre para el grupo de dominios.
  • MULTICAST_ADMIN_PROJECT: Es el ID del proyecto de administrador de multicast.

Crea un dominio

Crea uno o más dominios de multicast asociados con tu red de VPC de administrador de multicast.

gcloud

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

Si quieres usar un grupo de dominios, debes especificarlo cuando lo crees. No puedes agregar el dominio a un grupo de dominios más adelante. Para crear dominios que formen parte de un grupo de dominios, debes 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]

Reemplaza los siguientes valores:

  • DOMAIN_NAME: un nombre para el dominio
  • MULTICAST_ADMIN_PROJECT: Es el ID del proyecto de administrador de multicast.
  • MULTICAST_ADMIN_NETWORK: Es la red de VPC del administrador de la multidifusión. Si usas la topología de NCC, esta red también debe formar parte del concentrador como el radio central; de lo contrario, fallará la creación del dominio.
  • TOPOLOGY: Es la topología que deseas configurar para Cloud Multicast. Especifica una de las siguientes opciones:
    • SAME_VPC: Es la topología de red de VPC única.
    • NCC: la topología en estrella de NCC.
  • HUB_NAME: Si configuras la topología en estrella de Network Connectivity Center, especifica el nombre del concentrador.
  • DOMAIN_GROUP_NAME: Si creaste un grupo de dominios, ingresa el nombre del grupo de dominios.

API

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

Si quieres usar un grupo de dominios, debes especificarlo cuando lo crees. No puedes agregar el dominio a un grupo de dominios más adelante. Para crear dominios que formen parte de un grupo de dominios, debes realizar la siguiente solicitud a la API dos veces. Por ejemplo, realiza la siguiente solicitud una vez para crear DOMAIN_1 y, luego, vuelve a realizarla 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"
}

Reemplaza los siguientes valores:

  • DOMAIN_NAME: un nombre para el dominio
  • MULTICAST_ADMIN_PROJECT: Es el ID del proyecto de administrador de multicast.
  • MULTICAST_ADMIN_NETWORK: Es la red de VPC del administrador de la multidifusión. Si usas la topología de NCC, esta red también debe formar parte del concentrador como el radio central; de lo contrario, fallará la creación del dominio.
  • TOPOLOGY: Es la topología que deseas configurar para Cloud Multicast. Especifica una de las siguientes opciones:
    • SAME_VPC: Es la topología de red de VPC única.
    • NCC: la topología en estrella de NCC.
  • HUB_NAME: Si configuras la topología de estrella de Network Connectivity Center, especifica el nombre del concentrador con el campo nccHub.
  • DOMAIN_GROUP_NAME: Si creaste un grupo de dominios, ingresa el nombre del grupo de dominios con el campo multicastDomainGroup.

Activa el dominio

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

Si no activas un dominio en una zona determinada, no se podrá enviar ni recibir tráfico de multicast 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]

Reemplaza los siguientes valores:

  • DOMAIN_ACTIVATION_NAME: un nombre para la activación del dominio
  • MULTICAST_ADMIN_PROJECT: Es el ID del proyecto de administrador de multicast.
  • DOMAIN_NAME: Es el nombre del dominio que se activará.
  • ZONE: Es la zona en la que se activará el dominio.
  • --disable-placement-policy: Si activas un dominio que forma parte de un grupo de dominios, puedes incluir esta marca de forma opcional para inhabilitar la creación de una política de posición. De lo contrario, Google Cloud crea automáticamente una política de posición que, de forma opcional, se puede aplicar a consumidores de multicast nuevos o existentes.
  • Especifica los siguientes parámetros según tus necesidades para el tráfico de multicast en esta zona. Google Cloud usa estos parámetros para determinar la escala de tu infraestructura de multicast.

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

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

    • AGGR_EGRESS_PPS: Es la cantidad de paquetes de salida agregados por segundo (pps) para todos los grupos de multidifusión del dominio en la zona especificada. La salida se refiere a los paquetes distribuidos desde la infraestructura de multicast hasta los consumidores de multicast.

      Puedes ingresar un valor de 0 a 500000000 (500 millones). El valor predeterminado es 1000000 (1 millón). Los valores predeterminados de los otros campos se establecen de forma dinámica según el valor que ingreses para esta marca.

    • AGGR_INGRESS_PPS: Es el total de pps de entrada para todos los grupos de multicast en el dominio de la zona especificada. La entrada se refiere a los paquetes que se envían desde los productores de multicast a la infraestructura de multicast.

      Puedes ingresar un valor de 0 a 2,000,000 (2 millones). El valor que ingreses para --aggr-ingress-pps no puede ser mayor que el valor de --aggr-egress-pps.

    • AVG_PACKET_SIZE: Es el tamaño promedio de los paquetes en bytes. Puedes ingresar un valor de 64 a 1500.

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

      Puedes ingresar un valor de 0 a 2,000,000 (2 millones). El valor que ingreses para --max-per-group-ingress-pps no puede ser mayor que el valor de --aggr-ingress-pps.

    • MAX_PER_GROUP_SUBSCRIBERS: Es la cantidad máxima de consumidores de multicast para un solo grupo de multicast en el dominio en la zona especificada. Usa esta marca para especificar el grupo con la mayor cantidad de consumidores de multicast, lo que ayuda a Google Cloud determinar con mayor precisión la escala requerida de tu infraestructura de multicast. Incluir esta marca no aplica un límite en la cantidad de consumidores de multicast para un grupo.

      Puedes ingresar un valor del 1 al 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"
  }
}

Reemplaza los siguientes valores:

  • DOMAIN_ACTIVATION_NAME: un nombre para la activación del dominio
  • MULTICAST_ADMIN_PROJECT: Es el ID del proyecto de administrador de multicast.
  • DOMAIN_NAME: Es el nombre del dominio que se activará.
  • ZONE: Es 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 de forma opcional y establecerlo en true para inhabilitar la creación de una política de posición. De lo contrario, Google Cloud crea automáticamente una política de ubicación que, de manera opcional, se puede aplicar a los consumidores de multicast nuevos o existentes.
  • Especifica los valores del objeto trafficSpec según tus necesidades para el tráfico de multidifusión en esta zona. Google Cloud usa estos parámetros para determinar la escala de tu infraestructura de multidifusión.

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

    • Revisa las limitaciones correspondientes para el tráfico de multicast que se describen en la descripción general de Cloud Multicast.
    • Si no incluyes el objeto trafficSpec en el cuerpo de la solicitud, Google Cloud genera una configuración mínima que puedes usar para realizar pruebas.
    • Puedes actualizar la configuración de trafficSpec más adelante, como se describe en Actualiza los parámetros del dominio de multicast.
    • Si bien los campos de trafficSpec son opcionales, si incluyes alguno, aggrEgressPps se convierte en un campo obligatorio. Si incluyes el objeto trafficSpec con algunos campos, debes incluir aggrEgressPps.

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

    • AGGR_EGRESS_PPS: Es la cantidad de paquetes de salida agregados por segundo (pps) para todos los grupos de multidifusión del dominio en la zona especificada. La salida se refiere a los paquetes distribuidos desde la infraestructura de multicast hasta los consumidores de multicast.

      Puedes ingresar un valor de 0 a 500000000 (500 millones). El valor predeterminado es 1000000 (1 millón). Los valores predeterminados de los otros campos se establecen de forma dinámica según el valor que ingreses para este campo.

    • AGGR_INGRESS_PPS: Es el total de pps de entrada para todos los grupos de multicast en el dominio de la zona especificada. La entrada se refiere a los paquetes que se envían desde los productores de multicast a la infraestructura de multicast.

      Puedes ingresar un valor de 0 a 2,000,000 (2 millones). El valor que ingreses para aggrIngressPps no puede ser mayor que el valor de aggrEgressPps.

    • AVG_PACKET_SIZE: Es el tamaño promedio de los paquetes en bytes. Puedes ingresar un valor de 64 a 1500.

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

      Puedes ingresar un valor de 0 a 2,000,000 (2 millones). El valor que ingreses para maxPerGroupIngressPps no puede ser mayor que el valor de aggrIngressPps.

    • MAX_PER_GROUP_SUBSCRIBERS: Es la cantidad máxima de consumidores de multicast para un solo grupo de multicast en el dominio en la zona especificada. Usa esta marca para especificar el grupo con la mayor cantidad de consumidores de multicast, lo que ayuda a Google Cloud determinar con mayor precisión la escala requerida de tu infraestructura de multicast. Proporcionar esta especificación no aplica de manera forzosa un límite en la cantidad de consumidores de multicast para un grupo.

      Puedes ingresar un valor del 1 al 500.

¿Qué sigue?