Atualizar parâmetros do domínio multicast

Esta página descreve como redimensionar a infraestrutura multicast do seu domínio atualizando os parâmetros de tráfego das ativações de domínio multicast zonais atuais.

Para informações sobre como criar e ativar domínios multicast, consulte Criar domínios multicast.

Antes de começar

Antes de atualizar os parâmetros do domínio multicast, revise o seguinte e planeje sua atualização de acordo:

  • Disponibilidade do serviço durante a atualização: esse procedimento pode causar uma interrupção temporária do serviço enquanto Google Cloud a infraestrutura multicast é reaprovisionada de acordo com os novos parâmetros fornecidos.

    • A interrupção do serviço se aplica à infraestrutura multicast da ativação de domínio multicast específica que você está atualizando. Durante a atualização, os produtores e consumidores de multicast não podem enviar ou receber tráfego para o domínio e a zona multicast correspondentes.

    • A duração da interrupção do serviço depende de vários fatores, como a escala da infraestrutura multicast atual, o número de ativações de intervalo de grupos multicast criadas usando a ativação de domínio e a escala dos novos parâmetros fornecidos. Para configurações em grande escala, a atualização pode levar de 30 minutos a 1 hora para ser concluída.

  • Mudanças nas cobranças de faturamento após a atualização: as ativações de domínio multicast geram cobranças de faturamento, conforme descrito em Faturamento. A atualização dos parâmetros de tráfego de uma ativação de domínio multicast pode afetar as cobranças de faturamento do seu projeto. Para mais informações, entre em contato com seu Google Cloud representante de vendas.

  • Ação necessária dos consumidores de multicast após a atualização: depois que a atualização for concluída, para começar a receber tráfego novamente, os consumidores de multicast precisam ingressar novamente em todos os grupos multicast no domínio e na zona. Se necessário, coordene com o administrador da rede do consumidor de multicast ou com os proprietários do aplicativo do consumidor de multicast.

Atualizar uma ativação de domínio multicast

Esta seção descreve como atualizar os parâmetros de uma ativação de domínio multicast que determinam a escala da sua infraestrutura multicast.

Se você ativou um domínio multicast em várias zonas, siga este procedimento para cada ativação de domínio multicast zonal que você quer atualizar.

gcloud

Para atualizar uma ativação de domínio multicast, use o network-services multicast-domain-activations update comando.

O comando a seguir leva de 10 a 30 minutos para ser concluído. Depois que o comando for concluído, pode levar mais alguns minutos para que a infraestrutura esteja pronta para receber e distribuir tráfego multicast. Para configurações em grande escala, todo esse processo pode levar de 30 minutos a 1 hora para ser concluído.

   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

Substitua os seguintes valores:

  • DOMAIN_ACTIVATION_NAME: o nome da ativação de domínio multicast
  • ZONE: a zona em que o domínio multicast foi ativado

  • Especifique os seguintes parâmetros de acordo com suas necessidades de tráfego multicast nessa zona. Google Cloud Esses parâmetros são usados para determinar a escala da sua infraestrutura multicast.

    Antes de especificar esses parâmetros, consulte o seguinte:

    • Consulte as limitações correspondentes para o tráfego multicast descrito na visão geral do multicast.

    • Consulte as informações a seguir sobre flags opcionais e obrigatórias:

      • Se você especificou --aggr-egress-pps ao criar a ativação de domínio multicast, a especificação de --aggr-egress-pps é opcional. Caso contrário, essa flag é obrigatória.
      • Todas as outras flags são opcionais.

    Para mais informações sobre cada flag, consulte o seguinte:

    • AGGR_EGRESS_PPS: pacotes de saída agregados por segundo (pps) para todos os grupos multicast no domínio na zona especificada. A saída se refere a pacotes distribuídos da infraestrutura multicast para consumidores de multicast.

      Você pode inserir um valor de 0 a 500.000.000 (500 milhões). O valor padrão é 1.000.000 (1 milhão). Os valores padrão para os outros campos são definidos dinamicamente com base no valor inserido para essa flag.

    • AGGR_INGRESS_PPS: pps de entrada agregados para todos os grupos multicast no domínio na zona especificada. A entrada se refere a pacotes enviados de produtores de multicast para a infraestrutura multicast.

      Você pode inserir um valor de 0 a 2.000.000 (2 milhões). O valor inserido para --aggr-ingress-pps não pode ser maior que o valor de --aggr-egress-pps.

    • AVG_PACKET_SIZE: tamanho médio do pacote em bytes. Você pode inserir um valor de 64 a 1500.

    • MAX_PER_GROUP_INGRESS_PPS: pps de entrada máximos para um único grupo multicast no domínio na zona especificada. Use essa flag para especificar o grupo multicast mais ativo no domínio, o que ajuda Google Cloud a determinar com mais precisão a escala necessária da sua infraestrutura multicast.

      Você pode inserir um valor de 0 a 2.000.000 (2 milhões). O valor inserido para --max-per-group-ingress-pps não pode ser maior que o valor de --aggr-ingress-pps.

    • MAX_PER_GROUP_SUBSCRIBERS: número máximo de consumidores de multicast para um único grupo multicast no domínio na zona especificada. Use essa flag para especificar o grupo com os consumidores de multicast, o que ajuda Google Cloud a determinar com mais precisão a escala necessária da sua infraestrutura multicast. A inclusão dessa flag não impõe um limite ao número de consumidores de multicast para um grupo.

      Você pode inserir um valor de 1 a 500.

API

Para atualizar uma ativação de domínio multicast, use o multicastDomainActivations.patch método.

O comando a seguir leva de 10 a 30 minutos para ser concluído. Depois que o comando for concluído, pode levar mais alguns minutos para que a infraestrutura esteja pronta para receber e distribuir tráfego multicast. Para configurações em grande escala, todo esse processo pode levar de 30 minutos a 1 hora para ser concluído.

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

Substitua os seguintes valores:

  • PROJECT_ID: o ID do projeto do administrador de multicast
  • DOMAIN_ACTIVATION_NAME: o nome da ativação de domínio multicast
  • ZONE: a zona em que o domínio multicast foi ativado

  • Especifique valores para o objeto trafficSpec de acordo com suas necessidades de tráfego multicast nessa zona. Google Cloud Esses parâmetros são usados para determinar a escala da sua infraestrutura multicast.

    Antes de especificar esses parâmetros, consulte o seguinte:

    • Consulte as limitações correspondentes para o tráfego multicast descrito na visão geral do multicast.

    • Consulte as informações a seguir sobre campos opcionais e obrigatórios:

      • Se você especificou aggrEgressPps ao criar a ativação de domínio multicast, a especificação de aggrEgressPps é opcional. Caso contrário, esse campo é obrigatório.
      • Todos os outros campos em trafficSpec são opcionais.

    Para mais informações sobre cada campo, consulte o seguinte:

    • AGGR_EGRESS_PPS: pacotes de saída agregados por segundo (pps) para todos os grupos multicast no domínio na zona especificada. A saída se refere a pacotes distribuídos da infraestrutura multicast para consumidores de multicast.

      Você pode inserir um valor de 0 a 500.000.000 (500 milhões). O valor padrão é 1.000.000 (1 milhão). Os valores padrão para os outros campos são definidos dinamicamente com base no valor inserido para esse campo.

    • AGGR_INGRESS_PPS: pps de entrada agregados para todos os grupos multicast no domínio na zona especificada. A entrada se refere a pacotes enviados de produtores de multicast para a infraestrutura multicast.

      Você pode inserir um valor de 0 a 2.000.000 (2 milhões). O valor inserido para aggrIngressPps não pode ser maior que o valor de aggrEgressPps.

    • AVG_PACKET_SIZE: tamanho médio do pacote em bytes. Você pode inserir um valor de 64 a 1500.

    • MAX_PER_GROUP_INGRESS_PPS: pps de entrada máximos para um único grupo multicast no domínio na zona especificada. Use esse campo para especificar o grupo multicast mais ativo no domínio, o que ajuda Google Cloud a determinar com mais precisão a escala necessária da sua infraestrutura multicast.

      Você pode inserir um valor de 0 a 2.000.000 (2 milhões). O valor inserido para maxPerGroupIngressPps não pode ser maior que o valor de aggrIngressPps.

    • MAX_PER_GROUP_SUBSCRIBERS: número máximo de consumidores de multicast para um único grupo multicast no domínio na zona especificada. Use esse campo para especificar o grupo com mais consumidores de multicast, o que ajuda Google Cloud a determinar com mais precisão a escala necessária da sua infraestrutura multicast. A inclusão dessa especificação não impõe um limite ao número de consumidores de multicast para um grupo.

      Você pode inserir um valor de 1 a 500.