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

  1. 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 prenotare
    • ADMIN_NETWORK: il nome della rete dell'amministratore multicast
    • CIDR_RANGE: l'intervallo CIDR da prenotare

      L'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.

  2. 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 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 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.
      • --[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.

API

  1. 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 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 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.

  2. 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 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 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 se consumerAcceptList è 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 a consumerAcceptList.
      • (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.
    • CONSUMER_ACCEPT_LIST: se imposti requireExplicitAccept su true, 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.
    • 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 logConfig o imposta enabled su 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 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 multicast
  • ADMIN_PROJECT: l'ID progetto dell'amministratore multicast
  • ZONE: 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 zona
  • GROUP_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 multicast
  • ADMIN_PROJECT: l'ID progetto dell'amministratore multicast
  • ZONE: 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 zona
  • GROUP_RANGE_NAME: il nome dell'intervallo di gruppi che hai creato in precedenza
  • LOGGING_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 logConfig dal corpo della richiesta.
    • Per attivare il logging in questa zona indipendentemente dall'impostazione globale, imposta enabled su true.
    • Per disattivare il logging in questa zona indipendentemente dall'impostazione globale, imposta enabled su false.

Passaggi successivi