Criar intervalos de grupos multicast

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

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

Antes de começar

Um intervalo de grupos multicast precisa ser 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 grupos multicast

Esta seção descreve como criar um intervalo de grupos multicast em um domínio. Você pode repetir essas etapas para criar vários intervalos de grupos em um determinado domínio.

Criar um intervalo de grupos

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

gcloud

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

    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 - 239.255.255.255). Além disso, o número total de endereços IP em um ou mais intervalos de grupos multicast associados ao mesmo domínio não pode exceder sua cota de grupos multicast por domínio.

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

  2. Crie um intervalo de grupos multicast usando o intervalo interno reservado. Para criar um intervalo de grupos multicast, use network-services multicast-group-ranges create comando.

    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 de grupos multicast
    • DOMAIN_NAME: o nome do domínio multicast criado anteriormente
    • ADMIN_PROJECT: o ID do projeto do administrador de multicast
    • INTERNAL_RANGE_NAME: o nome do intervalo interno reservado anteriormente
    • Especifique as seguintes propriedades para tráfego multicast, associação a grupos e geração de registros.

      Com exceção do escopo de distribuição de tráfego, é possível atualizar cada propriedade conforme necessário em um momento posterior.

      • --require-explicit-accept: determina quais projetos podem usar o intervalo de grupos multicast se a lista de permissões do consumidor de multicast estiver vazia. Essa configuração determina se um projeto de consumidor de multicast pode ativar uma rede VPC de consumidor de multicast para o intervalo de grupos.
        • Para negar todos os projetos, inclua essa flag. Um projeto só poderá usar o intervalo de grupos se você o adicionar à lista de permissões do consumidor de multicast.
        • (Padrão) Para permitir todos os projetos, exclua essa flag. Qualquer projeto que tenha acesso ao domínio multicast pode usar o intervalo de grupos. Na topologia em estrela do Network Connectivity Center (NCC), você concede acesso a um projeto ao domínio aceitando-o no hub.
      • CONSUMER_ACCEPT_LIST: se você especificou --require-explicit-accept, insira a lista de projetos de consumidores de multicast que podem usar esse intervalo de grupos multicast. Se um projeto de consumidor de multicast não estiver na lista de permissões, ele não poderá criar configurações de consumidor de multicast usando esse intervalo de grupos.

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

      • DISTRIBUTION_SCOPE: determina o escopo de localização do tráfego multicast. Não é possível atualizar essa propriedade mais tarde.

        • Para permitir que esse intervalo envie tráfego multicast apenas em uma zona, defina essa flag como intra-zone.
        • (Padrão) Para permitir que esse intervalo envie tráfego multicast entre zonas, defina essa flag como intra-region.
      • --[no-]enable-logging: determina se a geração de registros de eventos de associação a grupos está ativada.

        • 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 contenha os endereços IP de grupos multicast que você quer usar. Para reservar um intervalo interno, use o internalRanges.create método.

    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 - 239.255.255.255). Além disso, o número total de endereços IP em um ou mais intervalos de grupos multicast associados ao mesmo domínio não pode exceder sua cota de grupos multicast por domínio.

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

  2. Crie um intervalo de grupos multicast usando o intervalo interno reservado. Para criar um intervalo de grupos multicast, use multicastGroupRanges.create método.

    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 de grupos multicast
    • ADMIN_PROJECT: o ID do projeto do administrador de multicast
    • DOMAIN_NAME: o nome do domínio multicast criado anteriormente
    • INTERNAL_RANGE_NAME: o nome do intervalo interno reservado anteriormente

    Para especificar propriedades para tráfego multicast, associação a grupos e geração de registros, inclua os seguintes campos no corpo da solicitação. Com exceção do escopo de distribuição de tráfego, é possível atualizar cada propriedade conforme necessário em um momento posterior.

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

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

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

    • DISTRIBUTION_SCOPE: determina o escopo de localização do tráfego multicast. Não é possível atualizar essa propriedade mais tarde.

      • 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 a geração de registros de eventos de associação a grupos está ativada.

      • 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 de grupos

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

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

gcloud

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

  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 de grupos multicast
  • ADMIN_PROJECT: o ID do projeto do administrador de multicast
  • ZONE: a zona em que o intervalo de grupos 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 criada anteriormente nessa zona
  • GROUP_RANGE_NAME: o nome do intervalo de grupos criado anteriormente
  • --[no-]enable-logging: opcional, determina se o log de eventos de associação ao grupo está ativado. A configuração dessa flag em uma ativação de intervalo de grupos zonal substitui a configuração do intervalo de grupos 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 grupos multicast, use o multicastGroupRangeActivations.create método.

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 de grupos multicast
  • ADMIN_PROJECT: o ID do projeto do administrador de multicast
  • ZONE: a zona em que o intervalo de grupos 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 criada anteriormente nessa zona
  • GROUP_RANGE_NAME: o nome do intervalo de grupos criado anteriormente
  • LOGGING_ENABLED: determina se a geração de registros de eventos de associação a grupos está ativada. A configuração da geração de registros em uma ativação de intervalo de grupos zonal substitui a configuração do intervalo de grupos 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