Atualize os parâmetros do domínio multicast

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

Para obter informações sobre a criação e a ativação de domínios de multicast, consulte o artigo Crie domínios de multicast.

Antes de começar

Antes de atualizar os parâmetros do domínio de multicast, reveja o seguinte e planeie a atualização em conformidade:

  • Disponibilidade do serviço durante a atualização: este procedimento pode causar uma interrupção temporária do serviço enquanto Google Cloud reprovisiona a sua infraestrutura de multicast de acordo com os novos parâmetros que fornecer.

    • A interrupção do serviço aplica-se à infraestrutura de multicast para a ativação do domínio de multicast específico que está a atualizar. Durante a atualização, os produtores e os 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 do intervalo de grupos de multicast criadas através da ativação do domínio e a escala dos novos parâmetros que fornecer. Para configurações de grande escala, a atualização pode demorar entre 30 minutos e 1 hora a ser concluída.

  • Alterações às cobranças de faturação após a atualização: as ativações de domínios de multicast incorrem em cobranças de faturação, conforme descrito em Faturação. A atualização dos parâmetros de tráfego de uma ativação de domínio de multicast pode afetar as cobranças de faturação do seu projeto. Para mais informações, contacte o seu Google Cloud representante de vendas.

  • Ação necessária pelos consumidores de multicast após a atualização: após a conclusão da atualização, para começarem a receber tráfego novamente, os consumidores de multicast têm de voltar a juntar-se a todos os grupos de multicast no domínio e na zona. Se necessário, coordene com o administrador da rede de consumo de multicast ou os proprietários da aplicação de consumo de multicast.

Atualize uma ativação de domínio multicast

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

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

gcloud

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

O seguinte comando demora cerca de 10 a 30 minutos a ser concluído. Depois de o comando ser concluído com êxito, a infraestrutura pode demorar mais alguns minutos a ficar pronta para receber e distribuir tráfego de multicast. Para configurações em grande escala, todo este processo pode demorar entre 30 minutos e 1 hora a 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 multicast
  • ZONE: a zona onde o domínio multicast foi ativado

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

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

    • Reveja as limitações correspondentes para o tráfego de multicast descritas na vista geral do multicast.

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

      • Se especificou anteriormente --aggr-egress-pps quando criou a ativação do domínio de multicast, especificar --aggr-egress-pps é opcional. Caso contrário, esta flag é obrigatória.
      • Todas as outras flags são opcionais.

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

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

      Pode introduzir um valor de 0 a 500 000 000 (500 milhões). O valor predefinido é 1000000 (1 milhão). Os valores predefinidos dos outros campos são definidos dinamicamente com base no valor que introduzir para esta flag.

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

      Pode introduzir um valor de 0 a 2000000 (2 milhões). O valor que introduzir para --aggr-ingress-pps não pode ser superior ao valor de --aggr-egress-pps.

    • AVG_PACKET_SIZE: tamanho médio do pacote em bytes. Pode introduzir um valor entre 64 e 1500.

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

      Pode introduzir um valor de 0 a 2000000 (2 milhões). O valor que introduzir para --max-per-group-ingress-pps não pode ser superior ao 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 esta flag para especificar o grupo com o maior número de consumidores de multicast, o que ajuda a determinar com maior precisão a escala necessária da sua infraestrutura de multicast. Google Cloud A inclusão desta flag não aplica um limite ao número de consumidores de multicast para um grupo.

      Pode introduzir um valor de 1 a 500.

API

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

O seguinte comando demora cerca de 10 a 30 minutos a ser concluído. Depois de o comando ser concluído com êxito, a infraestrutura pode demorar mais alguns minutos a ficar pronta para receber e distribuir tráfego de multicast. Para configurações em grande escala, todo este processo pode demorar entre 30 minutos e 1 hora a 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 onde o domínio multicast foi ativado

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

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

    • Reveja as limitações correspondentes para o tráfego de multicast descritas na vista geral do multicast.

    • Consulte as seguintes informações sobre os campos opcionais e obrigatórios:

      • Se especificou anteriormente aggrEgressPps quando criou a ativação do domínio de multicast, especificar aggrEgressPps é opcional. Caso contrário, este 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 de multicast no domínio na zona especificada. A saída refere-se a pacotes distribuídos a partir da infraestrutura de multicast para consumidores de multicast.

      Pode introduzir um valor de 0 a 500 000 000 (500 milhões). O valor predefinido é 1000000 (1 milhão). Os valores predefinidos dos outros campos são definidos dinamicamente com base no valor que introduzir neste campo.

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

      Pode introduzir um valor de 0 a 2000000 (2 milhões). O valor que introduzir para aggrIngressPps não pode ser superior ao valor de aggrEgressPps.

    • AVG_PACKET_SIZE: tamanho médio do pacote em bytes. Pode introduzir um valor entre 64 e 1500.

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

      Pode introduzir um valor de 0 a 2000000 (2 milhões). O valor que introduzir para maxPerGroupIngressPps não pode ser superior ao 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 este campo para especificar o grupo com o maior número de consumidores de multicast, o que ajuda a determinar com maior precisão a escala necessária da sua infraestrutura de multicast. Google Cloud A indicação desta especificação não impõe um limite ao número de consumidores de multicast para um grupo.

      Pode introduzir um valor de 1 a 500.