Actualiza los parámetros del dominio de multicast

En esta página, se describe cómo cambiar el tamaño de la infraestructura de multicast de tu dominio mediante la actualización de los parámetros de tráfico de las activaciones de dominio de multicast zonales existentes.

Para obtener información sobre cómo crear y activar dominios de multicast, consulta Crea dominios de multicast.

Antes de comenzar

Antes de actualizar los parámetros del dominio de multicast, revisa lo siguiente y planifica la actualización en consecuencia:

  • Disponibilidad del servicio durante la actualización: Este procedimiento puede causar una interrupción temporal del servicio mientras se Google Cloud vuelve a aprovisionar la infraestructura de multicast según los parámetros nuevos que proporciones.

    • La interrupción del servicio se aplica a la infraestructura de multicast para la activación de dominio de multicast específica que estás actualizando. Durante la actualización, los productores y consumidores de multicast no pueden enviar ni recibir tráfico para el dominio y la zona de multicast correspondientes.

    • La duración de la interrupción del servicio depende de varios factores, como la escala de tu infraestructura de multicast actual, la cantidad de activaciones de rango de grupos de multicast creadas con la activación de dominio y la escala de los parámetros nuevos que proporciones. Para las configuraciones a gran escala, la actualización puede tardar entre 30 minutos y 1 hora en completarse.

  • Cambios en los cargos de facturación después de la actualización: Las activaciones de dominio de multicast generan cargos de facturación como se describe en Facturación. Actualizar los parámetros de tráfico de una activación de dominio de multicast puede afectar los cargos de facturación de tu proyecto. Para obtener más información, comunícate con tu Google Cloud representante de ventas.

  • Acción requerida por los consumidores de multicast después de la actualización: Una vez que se complete la actualización, para volver a recibir tráfico, los consumidores de multicast deben volver a unirse a los grupos de multicast en el dominio y la zona. Si es necesario, coordina con el administrador de la red del consumidor de multicast o los propietarios de la aplicación del consumidor de multicast.

Actualiza una activación de dominio de multicast

En esta sección, se describe cómo actualizar los parámetros de una activación de dominio de multicast que determinan la escala de tu infraestructura de multicast.

Si activaste un dominio de multicast en varias zonas, sigue este procedimiento para cada activación de dominio de multicast zonal que deseas actualizar.

gcloud

Para actualizar una activación de dominio de multicast, usa el network-services multicast-domain-activations update comando.

El siguiente comando tarda entre 10 y 30 minutos en completarse. Una vez que el comando se complete correctamente, la infraestructura puede tardar varios minutos más en estar lista para recibir y distribuir tráfico de multicast. Para las configuraciones a gran escala, todo este proceso puede tardar entre 30 minutos y 1 hora en completarse por completo.

   gcloud network-services multicast-domain-activations update DOMAIN_ACTIVATION_NAME \
      --location=ZONE \
      --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: Es el nombre de la activación de dominio de multicast.
  • ZONE: Es la zona en la que se activó el dominio de multicast.

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

    • Consulta la siguiente información sobre las marcas opcionales y obligatorias:

      • Si especificaste --aggr-egress-pps cuando creaste la activación de dominio de multicast, especificar --aggr-egress-pps es opcional. De lo contrario, esta marca es obligatoria.
      • Todas las demás marcas son opcionales.

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

    • AGGR_EGRESS_PPS: Son los 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: Son los 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: Es el tamaño promedio del paquete en bytes. Puedes ingresar un valor de 64 a 1,500.

    • MAX_PER_GROUP_INGRESS_PPS: Son los 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: Es la 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 actualizar una activación de dominio de multicast, usa el multicastDomainActivations.patch método.

El siguiente comando tarda entre 10 y 30 minutos en completarse. Una vez que el comando se complete correctamente, la infraestructura puede tardar varios minutos más en estar lista para recibir y distribuir tráfico de multicast. Para las configuraciones a gran escala, todo este proceso puede tardar entre 30 minutos y 1 hora en completarse por completo.

PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME?updateMask=trafficSpec

{
  "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:

  • PROJECT_ID: Es el ID del proyecto del administrador de multicast.
  • DOMAIN_ACTIVATION_NAME: Es el nombre de la activación de dominio de multicast.
  • ZONE: Es la zona en la que se activó el dominio de multicast.

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

    • Consulta la siguiente información sobre los campos opcionales y obligatorios:

      • Si especificaste aggrEgressPps cuando creaste la activación de dominio de multicast, especificar aggrEgressPps es opcional. De lo contrario, este campo es obligatorio.
      • Todos los demás campos en trafficSpec son opcionales.

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

    • AGGR_EGRESS_PPS: Son los 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: Son los 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: Es el tamaño promedio del paquete en bytes. Puedes ingresar un valor de 64 a 1,500.

    • MAX_PER_GROUP_INGRESS_PPS: Son los pps de entrada máximos para un solo grupo de multicast en el dominio de la zona especificada. Usa este campo 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: Es la cantidad máxima de consumidores de multicast para un solo grupo de multicast en el dominio de la zona especificada. Usa este campo 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.