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
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 createcomando.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 reservadoADMIN_NETWORK: o nome da rede do administrador de multicastCIDR_RANGE: o intervalo CIDR a ser reservadoO 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.
Crie um intervalo de grupos multicast usando o intervalo interno reservado. Para criar um intervalo de grupos multicast, use
network-services multicast-group-ranges createcomando.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 multicastDOMAIN_NAME: o nome do domínio multicast criado anteriormenteADMIN_PROJECT: o ID do projeto do administrador de multicastINTERNAL_RANGE_NAME: o nome do intervalo interno reservado anteriormenteEspecifique 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.
- Para permitir que esse intervalo envie tráfego multicast apenas em uma zona, defina essa flag como
--[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.
- Para ativar a geração de registros, use
API
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.createmé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 reservadoADMIN_PROJECT: o ID do projeto do administrador de multicastADMIN_NETWORK: o nome da rede do administrador de multicastCIDR_RANGE: o intervalo CIDR a ser reservadoO 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.
Crie um intervalo de grupos multicast usando o intervalo interno reservado. Para criar um intervalo de grupos multicast, use
multicastGroupRanges.createmé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 multicastADMIN_PROJECT: o ID do projeto do administrador de multicastDOMAIN_NAME: o nome do domínio multicast criado anteriormenteINTERNAL_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 seconsumerAcceptListestiver 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 aconsumerAcceptList. - (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.
- Para negar todos os projetos, defina como
CONSUMER_ACCEPT_LIST: se você definirrequireExplicitAcceptcomotrue, 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.
- Para permitir que esse intervalo envie tráfego multicast apenas em uma zona, defina como
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.
- Para ativar a geração de registros, defina como
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 multicastADMIN_PROJECT: o ID do projeto do administrador de multicastZONE: 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 zonaGROUP_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.
- Para ativar a geração de registros, use
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 multicastADMIN_PROJECT: o ID do projeto do administrador de multicastZONE: 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 zonaGROUP_RANGE_NAME: o nome do intervalo de grupos criado anteriormenteLOGGING_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.
- Para ativar a geração de registros, defina como
A seguir
- Para conferir as configurações de intervalo de grupos multicast criadas, consulte Conferir configurações de intervalo de grupos multicast.
- Atualizar configurações de intervalo de grupos multicast
- Ativar uma rede VPC para produzir tráfego multicast