Atualizar parâmetros do domínio multicast

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

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

Antes de começar

Antes de atualizar os parâmetros do domínio de multicast, revise o seguinte e planeje a 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 o Google Cloud reprovisiona sua infraestrutura de multicast de acordo com os novos parâmetros fornecidos.

    • A interrupção do serviço se aplica à infraestrutura de multicast para a 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 nem receber tráfego para o domínio e a zona de multicast correspondentes.

    • A duração da interrupção do serviço depende de vários fatores, como a escala da sua infraestrutura de multicast atual, o número de ativações de intervalo de grupo de 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 projeto. Para mais informações, entre em contato com seu Google Cloud representante de vendas.

  • Ação necessária para 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 participar de novo de todos os grupos de 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 de multicast, use o comando network-services multicast-domain-activations update.

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 o 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 do domínio de multicast.
  • ZONE: a zona em que o domínio de multicast foi ativado.

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

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

    • Revise as limitações correspondentes para o tráfego de multicast descritas na visão geral do multicast.

    • Confira as seguintes informações sobre flags opcionais e obrigatórias:

      • Se você especificou --aggr-egress-pps ao criar a ativação do domínio multicast, especificar --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:

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

      É possível 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 dos outros campos são definidos dinamicamente com base no valor inserido para essa flag.

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

      É possível 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. É possível inserir um valor entre 64 e 1500.

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

      É possível 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 de multicast no domínio na zona especificada. Use essa flag para especificar o grupo com mais consumidores de multicast, o que ajuda o Google Cloud a determinar com mais precisão a escala necessária da sua infraestrutura de multicast. Incluir essa flag não impõe um limite ao número de consumidores de multicast para um grupo.

      É possível inserir um valor de 1 a 500.

API

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

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 o 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 do domínio multicast.
  • ZONE: a zona em que o domínio de multicast foi ativado.

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

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

    • Revise as limitações correspondentes para o tráfego de multicast descritas na visão geral do multicast.

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

      • Se você especificou aggrEgressPps ao criar a ativação do domínio multicast, especificar 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:

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

      É possível 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 dos outros campos são definidos dinamicamente com base no valor inserido neste campo.

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

      É possível 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. É possível inserir um valor entre 64 e 1500.

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

      É possível 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 de multicast no domínio na zona especificada. Use esse campo para especificar o grupo com mais consumidores de multicast, o que ajuda o Google Cloud a determinar com mais precisão a escala necessária da sua infraestrutura de multicast. Fornecer essa especificação não impõe um limite no número de consumidores multicast para um grupo.

      É possível inserir um valor de 1 a 500.