Creare 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 per il multicast, vedi Panoramica della configurazione del 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.

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

Creare 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) e deve avere un prefisso maggiore o uguale a /23. Ad esempio, 224.1.60.0/24 è un intervallo valido. Gli intervalli con una lunghezza del prefisso pari o inferiore a /22 non sono validi.

    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 del gruppo 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 base alle esigenze in un secondo momento.

      • --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 gruppi solo se lo aggiungi all'elenco di accettazione dei consumer multicast.
        • (Impostazione predefinita) 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, 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 è presente 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 o al nome del progetto.

      • 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 le zone, imposta questo flag su intra-region.

      • --[no-]enable-logging: determina se il logging degli eventi di appartenenza 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) e deve avere un prefisso maggiore o uguale a /23. Ad esempio, 224.1.60.0/24 è un intervallo valido. Gli intervalli con una lunghezza del prefisso pari o inferiore a /22 non sono validi.

    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 del gruppo 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 base alle 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 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 il valore false. Qualsiasi progetto che abbia accesso al dominio multicast può utilizzare l'intervallo di gruppi. Nella topologia a stella di Network Connectivity Center, 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 è presente 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 o al nome del progetto. 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 INTRA_ZONE.
      • (Predefinito) Per consentire a questo intervallo di inviare traffico multicast tra le zone, imposta il valore su INTRA_REGION.

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

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

Attiva l'intervallo del gruppo

Attiva l'intervallo di gruppi in ogni zona in cui i produttori o i consumer multicast devono utilizzare gli indirizzi IP del gruppo associato.

Se non attivi un intervallo di gruppo 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 del gruppo. Deve essere 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 la registrazione degli eventi di appartenenza al gruppo è attivata. La configurazione di questo flag sull'attivazione di un intervallo di gruppi zonali 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 del gruppo. Deve essere 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 appartenenza al gruppo. La configurazione della registrazione per l'attivazione di un intervallo di gruppi zonali esegue l'override dell'impostazione per l'intervallo di gruppi globale.
    • Per attivare il logging, imposta il valore su true.
    • (Predefinito) Per disattivare la registrazione, imposta false.

Passaggi successivi