Criar intervalos de grupo multicast

Nesta página, descrevemos as etapas que um administrador de multicast precisa seguir para criar intervalos de grupos de multicast.

Para uma visão geral do processo de configuração do Cloud Multicast, consulte Visão geral da configuração do Cloud Multicast.

Antes de começar

Um intervalo de grupo multicast precisa estar associado a um domínio multicast específico. Antes de criar um intervalo de grupos multicast, siga as etapas para criar um domínio multicast.

Criar um intervalo de grupo multicast

Nesta seção, descrevemos como criar um intervalo de grupos multicast em um domínio. Repita essas etapas para criar vários intervalos de grupos em um determinado domínio.

Criar um intervalo do grupo

Associe um intervalo de endereços IP de grupo multicast ao domínio multicast.

gcloud

  1. Reserve um intervalo interno na rede VPC do administrador de multicast que contém os endereços IP do grupo de multicast que você quer usar. Para reservar um intervalo interno, use o comando network-connectivity internal-ranges create.

    gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \
   --network=ADMIN_NETWORK \
   --ip-cidr-range=CIDR_RANGE

    Substitua os seguintes valores:

    • INTERNAL_RANGE_NAME: um nome para o intervalo interno a ser reservado
    • ADMIN_NETWORK: o nome da rede do administrador de multicast

    • CIDR_RANGE: o intervalo CIDR a ser reservado

      O intervalo CIDR especificado precisa ser um endereço de classe D (como 224.0.0.0 a 239.255.255.255). Além disso, o número total de endereços IP em um ou mais intervalos de grupos de multicast associados ao mesmo domínio não pode exceder sua cota de grupos de multicast por domínio.

    Para mais informações sobre como criar intervalos internos, consulte Criar e usar intervalos internos.

  2. Crie um intervalo de grupo multicast usando o intervalo interno que você reservou. Para criar um intervalo de grupo de multicast, use o comando network-services multicast-group-ranges create.

    gcloud network-services multicast-group-ranges create GROUP_RANGE_NAME \
   --multicast-domain="projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \
   --reserved-internal-range="projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME" \
   --location=global \
   [--require-explicit-accept ] \
   [--consumer-accept-list=CONSUMER_ACCEPT_LIST] \
   [--distribution-scope=DISTRIBUTION_SCOPE] \
   [--enable-logging | --no-enable-logging]

    Substitua os seguintes valores:

    • GROUP_RANGE_NAME: um nome para o intervalo do grupo de multicast
    • DOMAIN_NAME: o nome do domínio multicast que você criou anteriormente
    • ADMIN_PROJECT: o ID do projeto do administrador de multicast
    • INTERNAL_RANGE_NAME: o nome do intervalo interno que você reservou anteriormente.

    • Especifique as seguintes propriedades para tráfego multicast, associação a grupos e geração de registros.

      Exceto pelo escopo de distribuição de tráfego, você pode atualizar cada propriedade conforme necessário em um momento posterior.

      • --require-explicit-accept: determina quais projetos podem usar o intervalo do grupo multicast se a lista de aceitação do consumidor multicast estiver vazia. Essa configuração determina se um projeto consumidor de multicast pode ativar uma rede VPC de consumidor de multicast para o intervalo de grupo.
        • Para negar todos os projetos, inclua esta flag. Um projeto só pode usar o intervalo de grupo se você o adicionar à lista de aceitação de consumidores de multicast.
        • (Padrão) Para permitir todos os projetos, exclua essa flag. Qualquer projeto com acesso ao domínio multicast pode usar o intervalo de grupo. Na topologia em estrela do Network Connectivity Center (NCC), você concede a um projeto acesso ao domínio aceitando-o no hub.

      • CONSUMER_ACCEPT_LIST: se você especificou --require-explicit-accept, insira uma lista de projetos consumidores de multicast que podem usar esse intervalo de grupos de multicast. Se um projeto consumidor de multicast não estiver na lista de aceitação, ele não poderá criar configurações de consumidor de multicast usando esse intervalo de grupo.

        É possível especificar até 100 projetos pelo ID do projeto ou nome.

      • DISTRIBUTION_SCOPE: determina o escopo de local do tráfego multicast. Não será possível atualizar essa propriedade depois.

        • Para permitir que esse intervalo envie tráfego multicast apenas em uma zona, defina esta flag como intra-zone.
        • (Padrão) Para permitir que esse intervalo envie tráfego multicast entre zonas, defina a flag como intra-region.

      • --[no-]enable-logging: determina se o registro de eventos de associação a grupos está ativado.

        • Para ativar a geração de registros, use --enable-logging.
        • (Padrão) Para desativar a geração de registros, use --no-enable-logging.

API

  1. Reserve um intervalo interno na rede VPC do administrador de multicast que contém os endereços IP do grupo de multicast que você quer usar. Para reservar um intervalo interno, use o método internalRanges.create.

    POST https://networkconnectivity.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/internalRanges?internalRangeId=INTERNAL_RANGE_NAME
{
  "network": "projects/ADMIN_PROJECT/global/networks/ADMIN_NETWORK",
  "ipCidrRange": "CIDR_RANGE"
}

    Substitua os seguintes valores:

    • INTERNAL_RANGE_NAME: um nome para o intervalo interno a ser reservado
    • ADMIN_PROJECT: o ID do projeto do administrador de multicast
    • ADMIN_NETWORK: o nome da rede do administrador de multicast

    • CIDR_RANGE: o intervalo CIDR a ser reservado

      O intervalo CIDR especificado precisa ser um endereço de classe D (como 224.0.0.0 a 239.255.255.255). Além disso, o número total de endereços IP em um ou mais intervalos de grupos de multicast associados ao mesmo domínio não pode exceder sua cota de grupos de multicast por domínio.

    Para mais informações sobre como criar intervalos internos, consulte Criar e usar intervalos internos.

  2. Crie um intervalo de grupo multicast usando o intervalo interno que você reservou. Para criar um intervalo de grupo multicast, use o método multicastGroupRanges.create.

    POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/multicastGroupRanges?multicastGroupRangeId=GROUP_RANGE_NAME
{
  "multicastDomain": "projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME",
  "reservedInternalRange": "projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME",
  "requireExplicitAccept": "REQUIRE_EXPLICIT_ACCEPT",
  "consumerAcceptList": [
      "CONSUMER_ACCEPT_LIST"
  ],
  "distributionScope": "DISTRIBUTION_SCOPE",
  "logConfig": {
      "enabled": "LOGGING_ENABLED"
 }
}

    Substitua os seguintes valores:

    • GROUP_RANGE_NAME: um nome para o intervalo do grupo de multicast
    • ADMIN_PROJECT: o ID do projeto do administrador de multicast
    • DOMAIN_NAME: o nome do domínio multicast que você criou anteriormente
    • INTERNAL_RANGE_NAME: o nome do intervalo interno que você reservou anteriormente.

    Para especificar propriedades de tráfego multicast, associação a grupos e geração de registros, inclua os seguintes campos no corpo da solicitação. Exceto pelo escopo de distribuição de tráfego, você pode atualizar cada propriedade conforme necessário em um momento posterior.

    • REQUIRE_EXPLICIT_ACCEPT: determina quais projetos podem usar o intervalo do grupo multicast se consumerAcceptList estiver vazio. Essa configuração determina se um projeto consumidor de multicast pode ativar uma rede VPC de consumidor de multicast para o intervalo de grupo.
      • Para negar todos os projetos, defina como true. Um projeto só pode usar o intervalo de grupos se você o adicionar a consumerAcceptList.
      • (Padrão) Para permitir todos os projetos, defina como false. Qualquer projeto com acesso ao domínio multicast pode usar o intervalo de grupo. Na topologia em estrela do NCC, você concede a um projeto acesso ao domínio aceitando-o no hub.

    • CONSUMER_ACCEPT_LIST: se você definir requireExplicitAccept como true, poderá inserir uma lista de projetos consumidores de multicast que podem usar esse intervalo de grupos de multicast.

      Se um projeto consumidor de multicast não estiver na lista de aceitação, ele não poderá criar configurações de consumidor de multicast usando esse intervalo de grupo.

      É possível especificar até 100 projetos pelo ID do projeto ou nome. Use o seguinte formato: "consumerAcceptList": ["project-1", "project-2"].

    • DISTRIBUTION_SCOPE: determina o escopo de local do tráfego multicast. Não será possível atualizar essa propriedade depois.

      • Para permitir que esse intervalo envie tráfego multicast apenas em uma zona, defina como INTRA_ZONE.
      • (Padrão) Para permitir que esse intervalo envie tráfego multicast entre zonas, defina como INTRA_REGION.

    • LOGGING_ENABLED: determina se o registro de eventos de associação a grupos está ativado.

      • Para ativar a geração de registros, defina como true.
      • (Padrão) Para desativar a geração de registros, defina como false.

Ativar o intervalo do grupo

Ative o intervalo de grupo em cada zona em que os produtores ou consumidores de multicast precisam usar os endereços IP de grupo associados.

Se você não ativar um intervalo de grupo em uma determinada zona, os endereços IP associados não poderão ser usados para enviar ou receber tráfego multicast nessa zona.

gcloud

Para ativar um intervalo de grupos multicast, use o comando network-services multicast-group-range-activations create.

  gcloud network-services multicast-group-range-activations create GROUP_RANGE_ACTIVATION_NAME \
     --multicast-domain-activation="projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME" \
     --multicast-group-range="projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME" \
     --location=ZONE \
     [--enable-logging | --no-enable-logging]

Substitua os seguintes valores:

  • GROUP_RANGE_ACTIVATION_NAME: um nome para a ativação do intervalo do grupo de multicast
  • ADMIN_PROJECT: o ID do projeto do administrador de multicast
  • ZONE: a zona em que o intervalo de grupo será ativado. Essa precisa ser uma zona em que você ativou o domínio anteriormente.
  • DOMAIN_ACTIVATION_NAME: o nome da ativação de domínio que você criou anteriormente nesta zona.
  • GROUP_RANGE_NAME: o nome do intervalo de grupos que você criou anteriormente.
  • --[no-]enable-logging: opcional, determina se o registro de eventos de associação ao grupo está ativado. Configurar essa flag em uma ativação de intervalo de grupo zonal substitui a configuração do intervalo de grupo global.
    • Para ativar a geração de registros, use --enable-logging.
    • (Padrão) Para desativar a geração de registros, use --no-enable-logging.

API

Para ativar um intervalo de grupo multicast, use o método multicastGroupRangeActivations.create.

POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/ZONE/multicastGroupRangeActivations?multicastGroupRangeActivationId=GROUP_RANGE_ACTIVATION_NAME
{
    "multicastDomainActivation": "projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME",
    "multicastGroupRange": "projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME",
    "logConfig": {
          "enabled": "LOGGING_ENABLED"
    }
}

Substitua os seguintes valores:

  • GROUP_RANGE_ACTIVATION_NAME: um nome para a ativação do intervalo do grupo de multicast
  • ADMIN_PROJECT: o ID do projeto do administrador de multicast
  • ZONE: a zona em que o intervalo de grupo será ativado. Essa precisa ser uma zona em que você ativou o domínio anteriormente.
  • DOMAIN_ACTIVATION_NAME: o nome da ativação de domínio que você criou anteriormente nesta zona.
  • GROUP_RANGE_NAME: o nome do intervalo de grupos que você criou anteriormente.
  • LOGGING_ENABLED: determina se o registro de eventos de associação ao grupo está ativado. Configurar o registro em uma ativação de intervalo de grupo zonal substitui a configuração do intervalo de grupo global.
    • Para ativar a geração de registros, defina como true.
    • (Padrão) Para desativar a geração de registros, defina como false.

A seguir