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 della procedura 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

  1. Riserva 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 prenotare
    • ADMIN_NETWORK: il nome della rete dell'amministratore multicast

    • CIDR_RANGE: l'intervallo CIDR da prenotare

      L'intervallo CIDR che specifichi 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 Gruppi multicast per dominio.

    Per saperne di più sulla creazione di intervalli interni, consulta Creare e utilizzare intervalli interni.

  2. Crea un intervallo di gruppi multicast utilizzando l'intervallo interno che hai riservato. 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 multicast
    • DOMAIN_NAME: il nome del dominio multicast che hai creato in precedenza
    • ADMIN_PROJECT: l'ID del progetto amministratore multicast
    • INTERNAL_RANGE_NAME: il nome dell'intervallo interno che hai prenotato in precedenza

    • Specifica le seguenti proprietà per il traffico multicast, l'appartenenza al gruppo e la registrazione.

      Ad eccezione dell'ambito di distribuzione del traffico, puoi aggiornare ogni proprietà in un secondo momento, se necessario.

      • --require-explicit-accept: determina quali progetti possono utilizzare l'intervallo di gruppi multicast se l'elenco di accettazione dei consumer multicast è vuoto. Questa configurazione determina se un progetto consumer multicast può attivare una rete VPC consumer multicast per l'intervallo di gruppi.
        • Per negare tutti i progetti, includi questo flag. Un progetto può utilizzare l'intervallo di gruppo solo se lo aggiungi all'elenco di accettazione dei consumer multicast.
        • (Predefinito) Per consentire tutti i progetti, escludi questo flag. Qualsiasi progetto che abbia 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 un elenco di progetti consumer multicast che possono utilizzare questo intervallo di gruppi multicast. Se un progetto consumer multicast non è nell'elenco di accettazione, il progetto 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.
        • (Impostazione predefinita) Per consentire a questo intervallo di inviare traffico multicast tra le zone, imposta questo flag su intra-region.

      • --[no-]enable-logging: determina se il logging degli eventi di iscrizione al gruppo è abilitato.

        • Per attivare il logging, utilizza --enable-logging.
        • (Predefinito) Per disattivare la registrazione, utilizza --no-enable-logging.

API

  1. Riserva 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 prenotare
    • ADMIN_PROJECT: l'ID del progetto amministratore multicast
    • ADMIN_NETWORK: il nome della rete dell'amministratore multicast

    • CIDR_RANGE: l'intervallo CIDR da prenotare

      L'intervallo CIDR che specifichi 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 Gruppi multicast per dominio.

    Per saperne di più sulla creazione di intervalli interni, consulta Creare e utilizzare intervalli interni.

  2. Crea un intervallo di gruppi multicast utilizzando l'intervallo interno che hai riservato. 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 multicast
    • ADMIN_PROJECT: l'ID del progetto amministratore multicast
    • DOMAIN_NAME: il nome del dominio multicast che hai creato in precedenza
    • INTERNAL_RANGE_NAME: il nome dell'intervallo interno che hai prenotato in precedenza

    Per specificare le proprietà per il traffico multicast, l'appartenenza al gruppo e la registrazione, includi i seguenti campi nel corpo della richiesta. Ad eccezione dell'ambito di distribuzione del traffico, puoi aggiornare ogni proprietà in un secondo momento, se necessario.

    • REQUIRE_EXPLICIT_ACCEPT: determina quali progetti possono utilizzare l'intervallo di gruppi multicast se consumerAcceptList è vuoto. Questa configurazione determina se un progetto consumer multicast può attivare una rete VPC consumer multicast per l'intervallo di gruppi.
      • Per negare tutti i progetti, imposta true. Un progetto può utilizzare l'intervallo di gruppi solo se lo aggiungi a consumerAcceptList.
      • (Predefinito) Per consentire tutti i progetti, imposta false. Qualsiasi progetto che abbia 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.

    • CONSUMER_ACCEPT_LIST: se imposti requireExplicitAccept su true, puoi inserire un elenco di progetti consumer multicast che possono utilizzare questo intervallo di gruppi multicast.

      Se un progetto consumer multicast non è nell'elenco di accettazione, il progetto 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, imposta il valore INTRA_ZONE.
      • (Predefinito) Per consentire a questo intervallo di inviare traffico multicast tra le zone, imposta INTRA_REGION.

    • LOGGING_ENABLED: determina se il logging degli eventi di iscrizione al gruppo è abilitato.

      • Per attivare il logging, imposta il valore su true.
      • (Predefinito) Per disattivare il logging, imposta false.

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 del gruppo associato 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 multicast
  • ADMIN_PROJECT: l'ID progetto dell'amministratore multicast
  • ZONE: la zona in cui attivare l'intervallo di gruppi. Deve trattarsi di una zona in cui hai attivato in precedenza il dominio.
  • DOMAIN_ACTIVATION_NAME: il nome dell'attivazione del dominio che hai creato in precedenza in questa zona
  • GROUP_RANGE_NAME: il nome dell'intervallo di gruppi che hai creato in precedenza
  • --[no-]enable-logging: facoltativo, determina se è attivata la registrazione degli eventi di iscrizione al gruppo. La configurazione di questo flag su un'attivazione intervallo di gruppi zonale sostituisce l'impostazione per l'intervallo di gruppi globale.
    • Per attivare il logging, utilizza --enable-logging.
    • (Predefinito) Per disattivare la registrazione, 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 multicast
  • ADMIN_PROJECT: l'ID progetto dell'amministratore multicast
  • ZONE: la zona in cui attivare l'intervallo di gruppi. Deve trattarsi di una zona in cui hai attivato in precedenza il dominio.
  • DOMAIN_ACTIVATION_NAME: il nome dell'attivazione del dominio che hai creato in precedenza in questa zona
  • GROUP_RANGE_NAME: il nome dell'intervallo di gruppi che hai creato in precedenza
  • LOGGING_ENABLED: determina se è abilitato il logging degli eventi di iscrizione al gruppo. La configurazione della registrazione su un'attivazione intervallo di gruppi zonale override dell'impostazione per l'intervallo di gruppi globale.
    • Per attivare il logging, imposta il valore su true.
    • (Predefinito) Per disattivare il logging, imposta false.

Passaggi successivi