Crea dominios de multicast

En esta página, se describen los pasos que debes seguir para crear dominios de multicast.

Para obtener una descripción general del proceso de configuración de multicast, consulta Descripción general de la configuración de 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 del 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 multicast, 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 concentrador y radio (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 mediante 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 multicast que usa la topología de red de VPC única, puedes omitir esta sección y continuar con Crea un dominio de multicast.

En esta sección, se describe cómo configurar el concentrador de NCC con la topología de estrella preestablecida 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, la red de VPC de productor de multicast puede unirse al concentrador como un radio central.
  • Las redes de VPC de consumidor 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 network-connectivity hubs create comando.

      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 network-connectivity spokes linked-vpc-network create comando.

      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: un nombre para el radio
    • MULTICAST_ADMIN_PROJECT: el ID del proyecto de administrador de multicast
    • HUB_NAME: el nombre del concentrador de NCC que creaste antes

    • MULTICAST_ADMIN_NETWORK: 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 consumidor de multicast se unan al concentrador, haz lo siguiente. Como alternativa, puedes continuar configurando el multicast y completar estos pasos más adelante, como se describe en Controla el acceso a los dominios de multicast.

    1. Otorga a los administradores de red de consumidor de multicast en otros proyectos la capacidad de proponer radios de VPC al concentrador. Para ello, sigue los pasos que se indican en Otorga acceso en la documentación de NCC.

    2. Pídeles a los administradores de red de consumidor 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 los dominios.

  • Un grupo de dominios agrupa explícitamente dos dominios relacionados. No crees 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 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 network-services multicast-domain-groups create comando.

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 multicastDomainGroups.create método.

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

Reemplaza lo siguiente:

  • DOMAIN_GROUP_NAME: un nombre para el grupo de dominios
  • MULTICAST_ADMIN_PROJECT: 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 network-services multicast-domains create comando.

Si quieres usar un grupo de dominios, debes especificarlo cuando crees el dominio. No puedes agregar el dominio a un grupo de dominios más adelante. Para crear dominios que forman 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: el ID del proyecto de administrador de multicast
  • MULTICAST_ADMIN_NETWORK: la red de VPC de l administrador de multicast. 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: la topología que deseas configurar para el multicast. Especifica una de las siguientes opciones:
    • SAME_VPC: la topología de red de VPC única.
    • NCC: la topología de estrella de NCC.
  • HUB_NAME: si configuras la topología de 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 multicastDomains.create método.

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

Reemplaza los siguientes valores:

  • DOMAIN_NAME: un nombre para el dominio
  • MULTICAST_ADMIN_PROJECT: el ID del proyecto de administrador de multicast
  • MULTICAST_ADMIN_NETWORK: la red de VPC de l administrador de multicast. 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: la topología que deseas configurar para el multicast. Especifica una de las siguientes opciones:
    • SAME_VPC: la topología de red de VPC única.
    • NCC: la topología de 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 se 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 network-services multicast-domain-activations create comando.

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: el ID del proyecto de administrador de multicast
  • DOMAIN_NAME: el nombre del dominio que se activará
  • ZONE: 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 se crea automáticamente una política de posición que se puede aplicar de forma opcional a los 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:

    • Revisa las limitaciones correspondientes para el tráfico de multicast que se describen en la descripción general de multicast.
    • Si no incluyes estas marcas, Google Cloud se genera una configuración mínima que puedes usar para realizar pruebas.
    • Puedes actualizar la configuración de estas marcas más adelante, como se describe en Actualiza los parámetros del dominio de multicast.
    • Si bien 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) para todos los grupos de multicast en el dominio de la zona especificada. La salida hace referencia a los paquetes distribuidos desde la infraestructura de multicast a los consumidores de multicast.

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

    • AGGR_INGRESS_PPS: pps de entrada agregados para todos los grupos de multicast en el dominio de la zona especificada. La entrada hace referencia a los paquetes enviados 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: tamaño promedio del paquete en bytes. Puedes ingresar un valor de 64 a 1,500.

    • MAX_PER_GROUP_INGRESS_PPS: pps de entrada máximos 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 Google Cloud a 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: cantidad máxima de consumidores de multicast para un solo grupo de multicast en el dominio de la zona especificada. Usa esta marca para especificar el grupo con la mayor cantidad de consumidores de multicast, lo que ayuda Google Cloud a 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 de 1 a 500.

API

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

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: el ID del proyecto de administrador de multicast
  • DOMAIN_NAME: el nombre del dominio que se 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 de forma opcional y configurarlo como true para inhabilitar la creación de una política de posición. De lo contrario, Google Cloud se crea automáticamente una política de posición que se puede aplicar de forma opcional a los consumidores de multicast nuevos o existentes .

  • Especifica valores para el objeto trafficSpec 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:

    • Revisa las limitaciones correspondientes para el tráfico de multicast que se describen en la descripción general de multicast.
    • Si no incluyes el objeto trafficSpec en el cuerpo de la solicitud, Google Cloud se 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 algún campo, 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: paquetes de salida agregados por segundo (pps) para todos los grupos de multicast en el dominio de la zona especificada. La salida hace referencia a los paquetes distribuidos desde la infraestructura de multicast a los consumidores de multicast.

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

    • AGGR_INGRESS_PPS: pps de entrada agregados para todos los grupos de multicast en el dominio de la zona especificada. La entrada hace referencia a los paquetes enviados 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: tamaño promedio del paquete en bytes. Puedes ingresar un valor de 64 a 1,500.

    • MAX_PER_GROUP_INGRESS_PPS: pps de entrada máximos 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 Google Cloud a 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: cantidad máxima de consumidores de multicast para un solo grupo de multicast en el dominio de la zona especificada. Usa esta marca para especificar el grupo con la mayor cantidad de consumidores de multicast, lo que ayuda Google Cloud a determinar con mayor precisión la escala requerida de tu infraestructura de multicast. Proporcionar esta especificación no aplica un límite en la cantidad de consumidores de multicast para un grupo.

      Puedes ingresar un valor de 1 a 500.

¿Qué sigue?