Actualizar los parámetros de dominio multicast

En esta página se describe cómo cambiar el tamaño de la infraestructura de multidifusión de tu dominio actualizando los parámetros de tráfico de las activaciones de dominio de multidifusión de zona.

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

Antes de empezar

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

• Disponibilidad del servicio durante la actualización: este procedimiento puede provocar una interrupción temporal del servicio mientras Google Cloud revisa tu infraestructura de multidifusión según los nuevos parámetros que proporciones.

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

  • La duración de la interrupción del servicio depende de varios factores, como la escala de tu infraestructura de multidifusión actual, el número de activaciones de intervalos de grupos de multidifusión creadas mediante la activación del dominio y la escala de los nuevos parámetros que proporciones. En el caso de 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 dominios de multidifusión conllevan cargos de facturación, tal como se describe en la sección Facturación. Si actualizas los parámetros de tráfico de una activación de dominio multicast, es posible que afecte a los cargos de facturación de tu proyecto. Para obtener más información, ponte en contacto con tuGoogle Cloud representante de ventas.

• Acción que deben realizar los consumidores de multidifusión después de la actualización: una vez completada la actualización, para volver a recibir tráfico, los consumidores de multidifusión deben volver a unirse a los grupos de multidifusión del dominio y la zona. Si es necesario, coordínate con el administrador de la red de consumidores de multidifusión o con los propietarios de la aplicación de consumidores de multidifusión.

Actualizar la activación de un dominio multicast

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

Si has activado un dominio de multidifusión en varias zonas, sigue este procedimiento para cada activación de dominio de multidifusión zonal que quieras actualizar.

gcloud

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

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

Nota: Si el siguiente comando devuelve un error inesperado, como un error de tiempo de espera, vuelve a ejecutar el comando para completar la actualización.

   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

Sustituye los siguientes valores:

• DOMAIN_ACTIVATION_NAME: el nombre de la activación del dominio multicast
• ZONE: la zona en la que se activó el dominio multicast

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

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

    • Si especificaste --aggr-egress-pps al crear la activación del dominio de multidifusión, no es necesario que vuelvas a especificar --aggr-egress-pps. De lo contrario, esta marca es obligatoria.
    • El resto de las marcas son opcionales.

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

    Nota: Si no conoces tu pps de salida agregado, puedes estimarlo con la siguiente fórmula: AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.

  • 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 de entre 0 y 2.000.000. El valor que introduzca en --aggr-ingress-pps no puede ser superior al valor 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 actualizar la activación de un dominio multicast, usa el método multicastDomainActivations.patch.

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

Nota: Si la siguiente solicitud devuelve un error inesperado, como un error de tiempo de espera, vuelve a enviar la solicitud para completar la actualización.

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"
  }
}

Sustituye los siguientes valores:

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

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

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

    • Si especificaste aggrEgressPps al crear la activación del dominio de multidifusión, no es obligatorio especificar aggrEgressPps. De lo contrario, este campo es obligatorio.
    • Todos los demás campos de trafficSpec son opcionales.

  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.

    Nota: Si no conoces tu pps de salida agregado, puedes estimarlo con la siguiente fórmula: AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.

  • 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 de 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 este campo para especificar el grupo de multidifusión más activo del dominio, lo que ayuda a determinar con mayor precisión la escala necesaria de tu infraestructura de multidifusión. Google Cloud

    Puedes introducir un valor de 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 este campo 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. Proporcionar esta especificación no impone un límite en el número de consumidores de multidifusión de un grupo.

    Puedes introducir un valor entre 1 y 500.