Crea intervalli di gruppi multicast
Questa pagina descrive i passaggi che un amministratore multicast deve seguire per creare intervalli di gruppi multicast.
Per una panoramica del processo di configurazione di Cloud Multicast, consulta Panoramica della configurazione di Cloud Multicast.
Prima di iniziare
Un intervallo di gruppi multicast deve essere associato a un dominio multicast specifico. Prima di creare un intervallo di gruppi multicast, segui i passaggi per creare un dominio multicast.
Crea un intervallo di gruppi multicast
Questa sezione descrive come creare un intervallo di gruppi multicast in un dominio. Puoi ripetere questi passaggi per creare più intervalli di gruppi in un determinato dominio.
Crea un intervallo di gruppi
Associa un intervallo di indirizzi IP del gruppo multicast al dominio multicast.
gcloud
Prenota un intervallo interno nella rete VPC dell'amministratore multicast che contiene gli indirizzi IP del gruppo multicast che vuoi utilizzare. Per prenotare un intervallo interno, utilizza il comando
network-connectivity internal-ranges create.gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \ --network=ADMIN_NETWORK \ --ip-cidr-range=CIDR_RANGE
Sostituisci i seguenti valori:
INTERNAL_RANGE_NAME: un nome per l'intervallo interno da prenotareADMIN_NETWORK: il nome della rete dell'amministratore multicastCIDR_RANGE: l'intervallo CIDR da prenotareL'intervallo CIDR specificato deve essere un indirizzo di classe D (ad esempio
224.0.0.0-239.255.255.255). Inoltre, il numero totale di indirizzi IP in uno o più intervalli di gruppi multicast associati allo stesso dominio non può superare la quota per i gruppi multicast per dominio.
Per saperne di più sulla creazione di intervalli interni, consulta Crea e utilizza intervalli interni.
Crea un intervallo di gruppi multicast utilizzando l'intervallo interno che hai prenotato. Per creare un intervallo di gruppi multicast, utilizza il 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]
Sostituisci i seguenti valori:
GROUP_RANGE_NAME: un nome per l'intervallo di gruppi multicastDOMAIN_NAME: il nome del dominio multicast che hai creato in precedenzaADMIN_PROJECT: l'ID del progetto amministratore multicastINTERNAL_RANGE_NAME: il nome dell'intervallo interno che hai prenotato in precedenzaSpecifica le seguenti proprietà per il traffico multicast, l'appartenenza ai gruppi e il logging.
Ad eccezione dell'ambito di distribuzione del traffico, puoi aggiornare ogni proprietà in base alle tue esigenze in un secondo momento.
--require-explicit-accept: determina quali progetti possono utilizzare l'intervallo di gruppi multicast se la lista consentita dei consumer multicast è vuota. Questa configurazione determina se un progetto consumer multicast può attivare una rete VPC consumer multicast per l'intervallo di gruppi.- Per rifiutare tutti i progetti, includi questo flag. Un progetto può utilizzare l'intervallo di gruppi solo se lo aggiungi alla lista consentita dei consumer multicast.
- (Predefinito) Per consentire tutti i progetti, escludi questo flag. Qualsiasi progetto che ha accesso al dominio multicast può utilizzare l'intervallo di gruppi. Nella topologia a stella di Network Connectivity Center (NCC), concedi a un progetto l'accesso al dominio accettandolo nell'hub.
CONSUMER_ACCEPT_LIST: se hai specificato--require-explicit-accept, puoi inserire l'elenco dei progetti consumer multicast che possono utilizzare questo intervallo di gruppi multicast. Se un progetto consumer multicast non è incluso nell'elenco di accettazione, non può creare configurazioni consumer multicast utilizzando questo intervallo di gruppi.Puoi specificare fino a 100 progetti in base all'ID progetto o al nome.
DISTRIBUTION_SCOPE: determina l'ambito della località del traffico multicast. Non potrai aggiornare questa proprietà in un secondo momento.- Per consentire a questo intervallo di inviare traffico multicast solo all'interno di una zona, imposta questo flag su
intra-zone. - (Predefinito) Per consentire a questo intervallo di inviare traffico multicast tra zone, imposta questo flag su
intra-region.
- Per consentire a questo intervallo di inviare traffico multicast solo all'interno di una zona, imposta questo flag su
--[no-]enable-logging: determina se il logging degli eventi di appartenenza ai gruppi è abilitato per l'intervallo di gruppi. Questa impostazione si applica a tutte le attivazioni di zona dell'intervallo di gruppi che non abilitano o disabilitano esplicitamente il logging.- Per abilitare il logging, utilizza
--enable-logging. - (Predefinito) Per lasciare il logging disattivato, ometti questo flag o utilizza
--no-enable-logging.
- Per abilitare il logging, utilizza
API
Prenota un intervallo interno nella rete VPC dell'amministratore multicast che contiene gli indirizzi IP del gruppo multicast che vuoi utilizzare. Per prenotare un intervallo interno, utilizza il metodo
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" }Sostituisci i seguenti valori:
INTERNAL_RANGE_NAME: un nome per l'intervallo interno da prenotareADMIN_PROJECT: l'ID del progetto amministratore multicastADMIN_NETWORK: il nome della rete dell'amministratore multicastCIDR_RANGE: l'intervallo CIDR da prenotareL'intervallo CIDR specificato deve essere un indirizzo di classe D (ad esempio
224.0.0.0-239.255.255.255). Inoltre, il numero totale di indirizzi IP in uno o più intervalli di gruppi multicast associati allo stesso dominio non può superare la quota per i gruppi multicast per dominio.
Per saperne di più sulla creazione di intervalli interni, consulta Crea e utilizza intervalli interni.
Crea un intervallo di gruppi multicast utilizzando l'intervallo interno che hai prenotato. Per creare un intervallo di gruppi multicast, utilizza il metodo
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" } }Sostituisci i seguenti valori:
GROUP_RANGE_NAME: un nome per l'intervallo di gruppi multicastADMIN_PROJECT: l'ID del progetto amministratore multicastDOMAIN_NAME: il nome del dominio multicast che hai creato in precedenzaINTERNAL_RANGE_NAME: il nome dell'intervallo interno che hai prenotato in precedenza
Per specificare le proprietà per il traffico multicast, l'appartenenza ai gruppi e il logging, includi i seguenti campi nel corpo della richiesta. Ad eccezione dell'ambito di distribuzione del traffico, puoi aggiornare ogni proprietà in base alle tue esigenze in un secondo momento.
REQUIRE_EXPLICIT_ACCEPT: determina quali progetti possono utilizzare l'intervallo di gruppi multicast seconsumerAcceptListè vuoto. Questa configurazione determina se un progetto consumer multicast può attivare una rete VPC consumer multicast per l'intervallo di gruppi.- Per rifiutare tutti i progetti, imposta il valore su
true. Un progetto può utilizzare l'intervallo di gruppi solo se lo aggiungi aconsumerAcceptList. - (Predefinito) Per consentire tutti i progetti, imposta il valore su
false. Qualsiasi progetto che ha accesso al dominio multicast può utilizzare l'intervallo di gruppi. Nella topologia a stella NCC, concedi a un progetto l'accesso al dominio accettandolo nell'hub.
- Per rifiutare tutti i progetti, imposta il valore su
CONSUMER_ACCEPT_LIST: se impostirequireExplicitAcceptsutrue, puoi inserire l'elenco dei progetti consumer multicast che possono utilizzare questo intervallo di gruppi multicast.Se un progetto consumer multicast non è incluso nell'elenco di accettazione, non può creare configurazioni consumer multicast utilizzando questo intervallo di gruppi.
Puoi specificare fino a 100 progetti in base all'ID progetto o al nome. Utilizza il formato seguente:
"consumerAcceptList": ["project-1", "project-2"].DISTRIBUTION_SCOPE: determina l'ambito della località del traffico multicast. Non potrai aggiornare questa proprietà in un secondo momento.- Per consentire a questo intervallo di inviare traffico multicast solo all'interno di una zona, impostalo su
INTRA_ZONE. - (Predefinito) Per consentire a questo intervallo di inviare traffico multicast tra zone, imposta su
INTRA_REGION.
- Per consentire a questo intervallo di inviare traffico multicast solo all'interno di una zona, impostalo su
LOGGING_ENABLED: determina se il logging degli eventi di appartenenza ai gruppi è abilitato per l'intervallo di gruppi. Questa impostazione si applica a tutte le attivazioni di zona dell'intervallo di gruppi che non abilitano o disabilitano esplicitamente il logging.- Per attivare il logging, imposta il valore su
true. - (Predefinito) Per lasciare il logging disattivato, ometti il campo
logConfigo impostaenabledsufalse.
- Per attivare il logging, imposta il valore su
Attiva l'intervallo di gruppi
Attiva l'intervallo di gruppi in ogni zona in cui i producer o i consumer multicast devono utilizzare gli indirizzi IP del gruppo associato.
Se non attivi un intervallo di gruppi in una determinata zona, gli indirizzi IP dei gruppi associati non possono essere utilizzati per inviare o ricevere traffico multicast nella zona.
gcloud
Per attivare un intervallo di gruppi multicast, utilizza il
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]
Sostituisci i seguenti valori:
GROUP_RANGE_ACTIVATION_NAME: un nome per l'attivazione dell'intervallo di gruppi multicastADMIN_PROJECT: l'ID progetto dell'amministratore multicastZONE: la zona in cui attivare l'intervallo del gruppo. Deve essere una zona in cui hai attivato il dominio in precedenza.DOMAIN_ACTIVATION_NAME: il nome dell'attivazione del dominio che hai creato in precedenza in questa zonaGROUP_RANGE_NAME: il nome dell'intervallo di gruppi che hai creato in precedenza--[no-]enable-logging: facoltativo, determina se il logging degli eventi di appartenenza ai gruppi è abilitato. La configurazione di questo flag su un'attivazione dell'intervallo di gruppi a livello di zona sostituisce l'impostazione per l'intervallo di gruppi globale.- (Predefinito) Per ereditare l'impostazione di logging dall'intervallo di gruppi globale, ometti questo flag.
- Per abilitare il logging in questa zona indipendentemente dall'impostazione globale, utilizza
--enable-logging. - Per disattivare il logging in questa zona indipendentemente dall'impostazione globale, utilizza
--no-enable-logging.
API
Per attivare un intervallo di gruppi multicast, utilizza il
metodo 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"
}
}
Sostituisci i seguenti valori:
GROUP_RANGE_ACTIVATION_NAME: un nome per l'attivazione dell'intervallo di gruppi multicastADMIN_PROJECT: l'ID progetto dell'amministratore multicastZONE: la zona in cui attivare l'intervallo del gruppo. Deve essere una zona in cui hai attivato il dominio in precedenza.DOMAIN_ACTIVATION_NAME: il nome dell'attivazione del dominio che hai creato in precedenza in questa zonaGROUP_RANGE_NAME: il nome dell'intervallo di gruppi che hai creato in precedenzaLOGGING_ENABLED: determina se il logging degli eventi di appartenenza ai gruppi è abilitato. La configurazione del logging su un'attivazione dell'intervallo di gruppi a livello di zona esegue l'override dell'impostazione per l'intervallo di gruppi globale.- (Predefinito) Per ereditare l'impostazione di logging dall'intervallo di gruppi globale, ometti il campo
logConfigdal corpo della richiesta. - Per attivare il logging in questa zona indipendentemente dall'impostazione globale, imposta
enabledsutrue. - Per disattivare il logging in questa zona indipendentemente dall'impostazione globale, imposta
enabledsufalse.
- (Predefinito) Per ereditare l'impostazione di logging dall'intervallo di gruppi globale, ometti il campo
Passaggi successivi
- Per visualizzare le configurazioni degli intervalli di gruppi multicast che hai creato, consulta Visualizza le configurazioni degli intervalli di gruppi multicast.
- Aggiorna le configurazioni degli intervalli di gruppi multicast
- Abilita una rete VPC per produrre traffico multicast