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 del processo di configurazione di multicast, consulta Panoramica della configurazione di 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. 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 network-connectivity internal-ranges create comando.

    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 i 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 prenotato. Per creare un intervallo di gruppi multicast, utilizza il network-services multicast-group-ranges create comando.

    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 dell'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 del 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 del 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 (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 è presente nell'elenco di accettazione, il progetto non può creare configurazioni consumer multicast utilizzando questo intervallo di gruppi.

        Puoi specificare fino a 100 progetti per ID progetto o nome.

      • DISTRIBUTION_SCOPE: determina l'ambito della località del traffico multicast. Non puoi 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 la registrazione degli eventi di iscrizione al gruppo è abilitata.

        • Per abilitare la registrazione, utilizza --enable-logging.
        • (Impostazione predefinita) Per disabilitare la registrazione, 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 internalRanges.create metodo.

    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 dell'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 i 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 prenotato. Per creare un intervallo di gruppi multicast, utilizza multicastGroupRanges.create metodo.

    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 dell'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 su true. Un progetto può utilizzare l'intervallo di gruppi solo se lo aggiungi a consumerAcceptList.
      • (Impostazione predefinita) Per consentire tutti i progetti, imposta su false. Qualsiasi progetto che abbia accesso al dominio multicast può utilizzare l'intervallo di gruppi. Nella topologia a stella di 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 è presente nell'elenco di accettazione, il progetto non può creare configurazioni consumer multicast utilizzando questo intervallo di gruppi.

      Puoi specificare fino a 100 progetti per ID progetto o nome. Utilizza il seguente formato: "consumerAcceptList": ["project-1", "project-2"].

    • DISTRIBUTION_SCOPE: determina l'ambito della località del traffico multicast. Non puoi aggiornare questa proprietà in un secondo momento.

      • Per consentire a questo intervallo di inviare traffico multicast solo all'interno di una zona, imposta su INTRA_ZONE.
      • (Impostazione predefinita) Per consentire a questo intervallo di inviare traffico multicast tra le zone, imposta su INTRA_REGION.

    • LOGGING_ENABLED: determina se la registrazione degli eventi di iscrizione al gruppo è abilitata.

      • Per abilitare la registrazione, imposta su true.
      • (Impostazione predefinita) Per disabilitare la registrazione, imposta su false.

Attivare 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 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]

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 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 la registrazione degli eventi di iscrizione al gruppo è abilitata. La configurazione di questo flag in un'attivazione dell'intervallo di gruppi zonale sostituisce l'impostazione per l'intervallo di gruppi globale.
    • Per abilitare la registrazione, utilizza --enable-logging.
    • (Impostazione predefinita) Per disabilitare la registrazione, utilizza --no-enable-logging.

API

Per attivare un intervallo di gruppi multicast, utilizza il multicastGroupRangeActivations.create metodo.

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 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 la registrazione degli eventi di iscrizione al gruppo è abilitata. La configurazione della registrazione in un'attivazione dell'intervallo di gruppi zonale sostituisce l'impostazione per l'intervallo di gruppi globale.
    • Per abilitare la registrazione, imposta su true.
    • (Impostazione predefinita) Per disabilitare la registrazione, imposta su false.

Passaggi successivi