Multicast-Gruppenbereiche erstellen

Auf dieser Seite werden die Schritte beschrieben, die ein Multicast-Administrator ausführen muss, um Multicast-Gruppenbereiche zu erstellen.

Eine Übersicht über den Konfigurationsprozess für Cloud Multicast finden Sie unter Übersicht über die Cloud Multicast-Konfiguration.

Hinweis

Ein Multicast-Gruppenbereich muss mit einer bestimmten Multicast-Domain verknüpft sein. Bevor Sie einen Multicast-Gruppenbereich erstellen, führen Sie die Schritte zum Erstellen einer Multicast-Domain aus.

Multicast-Gruppenbereich erstellen

In diesem Abschnitt wird beschrieben, wie Sie einen Multicast-Gruppenbereich in einer Domain erstellen. Sie können diese Schritte wiederholen, um mehrere Gruppenbereiche in einer bestimmten Domain zu erstellen.

Gruppenbereich erstellen

Verknüpfen Sie einen IP-Adressbereich für die Multicast-Gruppe mit der Multicast-Domain.

gcloud

  1. Reservieren Sie einen internen Bereich im VPC-Netzwerk des Multicast-Administrators, der die Multicast-Gruppen-IP-Adressen enthält, die Sie verwenden möchten. Verwenden Sie den Befehl network-connectivity internal-ranges create, um einen internen Bereich zu reservieren.

    gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \
       --network=ADMIN_NETWORK \
       --ip-cidr-range=CIDR_RANGE
    

    Ersetzen Sie die folgenden Werte:

    • INTERNAL_RANGE_NAME: ein Name für den zu reservierenden internen Bereich
    • ADMIN_NETWORK: der Name des Multicast-Administratornetzwerks
    • CIDR_RANGE: der zu reservierende CIDR-Bereich

      Der von Ihnen angegebene CIDR-Bereich muss eine Adresse der Klasse D sein (z. B. 224.0.0.0–239.255.255.255). Außerdem darf die Gesamtzahl der IP-Adressen in einem oder mehreren Multicast-Gruppenbereichen, die mit derselben Domain verknüpft sind, Ihr Kontingent für Multicast-Gruppen pro Domain nicht überschreiten.

    Weitere Informationen zum Erstellen interner Bereiche finden Sie unter Interne Bereiche erstellen und verwenden.

  2. Erstellen Sie einen Multicast-Gruppenbereich mit dem internen Bereich, den Sie reserviert haben. Verwenden Sie den Befehl network-services multicast-group-ranges create, um einen Multicast-Gruppenbereich zu erstellen.

    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]
    

    Ersetzen Sie die folgenden Werte:

    • GROUP_RANGE_NAME: ein Name für den Multicast-Gruppenbereich
    • DOMAIN_NAME: der Name der Multicast-Domain, die Sie zuvor erstellt haben.
    • ADMIN_PROJECT: die ID des Multicast-Administratorprojekts
    • INTERNAL_RANGE_NAME: der Name des internen Bereichs, den Sie zuvor reserviert haben.
    • Geben Sie die folgenden Attribute für Multicast-Traffic, Gruppenmitgliedschaft und Logging an.

      Mit Ausnahme des Bereichs für die Trafficverteilung können Sie jede Property später nach Bedarf aktualisieren.

      • --require-explicit-accept: Bestimmt, welche Projekte den Multicast-Gruppenbereich verwenden können, wenn die Zulassungsliste für Multicast-Nutzer leer ist. Diese Konfiguration bestimmt, ob ein Multicast-Nutzerprojekt ein Multicast-Nutzer-VPC-Netzwerk für den Gruppenbereich aktivieren kann.
        • Wenn Sie alle Projekte ablehnen möchten, fügen Sie dieses Flag hinzu. Ein Projekt kann den Gruppenbereich nur verwenden, wenn Sie es der Multicast-Nutzerannahmeliste hinzufügen.
        • (Standard) Wenn Sie alle Projekte zulassen möchten, schließen Sie dieses Flag aus. Jedes Projekt, das Zugriff auf die Multicast-Domain hat, kann den Gruppenbereich verwenden. In der Sterntopologie des Network Connectivity Center (NCC) gewähren Sie einem Projekt Zugriff auf die Domain, indem Sie es dem Hub hinzufügen.
      • CONSUMER_ACCEPT_LIST: Wenn Sie --require-explicit-accept angegeben haben, können Sie eine Liste der Multicast-Nutzerprojekte eingeben, die diesen Multicast-Gruppenbereich verwenden können. Wenn ein Multicast-Nutzerprojekt nicht in der Annahmeliste enthalten ist, kann das Projekt keine Multicast-Nutzerkonfigurationen mit diesem Gruppenbereich erstellen.

        Sie können bis zu 100 Projekte nach Projekt-ID oder Name angeben.

      • DISTRIBUTION_SCOPE: Bestimmt den Standortbereich des Multicast-Traffics. Sie können dieses Attribut später nicht mehr aktualisieren.

        • Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic nur innerhalb einer Zone sendet, setzen Sie dieses Flag auf intra-zone.
        • (Standard) Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic über Zonen hinweg sendet, setzen Sie dieses Flag auf intra-region.
      • --[no-]enable-logging: Bestimmt, ob die Protokollierung von Gruppenmitgliedschaftsereignissen für den Gruppenbereich aktiviert ist. Diese Einstellung gilt für alle zonalen Aktivierungen des Gruppenbereichs, für die Logging nicht explizit aktiviert oder deaktiviert wird.

        • Verwenden Sie --enable-logging, um das Logging zu aktivieren.
        • (Standard) Wenn Sie das Logging deaktiviert lassen möchten, lassen Sie dieses Flag weg oder verwenden Sie --no-enable-logging.

API

  1. Reservieren Sie einen internen Bereich im VPC-Netzwerk des Multicast-Administrators, der die Multicast-Gruppen-IP-Adressen enthält, die Sie verwenden möchten. Verwenden Sie die Methode internalRanges.create, um einen internen Bereich zu reservieren.

    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"
    }
    

    Ersetzen Sie die folgenden Werte:

    • INTERNAL_RANGE_NAME: ein Name für den zu reservierenden internen Bereich
    • ADMIN_PROJECT: die ID des Multicast-Administratorprojekts
    • ADMIN_NETWORK: der Name des Multicast-Administratornetzwerks
    • CIDR_RANGE: der zu reservierende CIDR-Bereich

      Der von Ihnen angegebene CIDR-Bereich muss eine Adresse der Klasse D sein (z. B. 224.0.0.0–239.255.255.255). Außerdem darf die Gesamtzahl der IP-Adressen in einem oder mehreren Multicast-Gruppenbereichen, die mit derselben Domain verknüpft sind, Ihr Kontingent für Multicast-Gruppen pro Domain nicht überschreiten.

    Weitere Informationen zum Erstellen interner Bereiche finden Sie unter Interne Bereiche erstellen und verwenden.

  2. Erstellen Sie einen Multicast-Gruppenbereich mit dem internen Bereich, den Sie reserviert haben. Verwenden Sie zum Erstellen eines Multicast-Gruppenbereichs die Methode 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"
     }
    }
    

    Ersetzen Sie die folgenden Werte:

    • GROUP_RANGE_NAME: ein Name für den Multicast-Gruppenbereich
    • ADMIN_PROJECT: die ID des Multicast-Administratorprojekts
    • DOMAIN_NAME: der Name der Multicast-Domain, die Sie zuvor erstellt haben.
    • INTERNAL_RANGE_NAME: der Name des internen Bereichs, den Sie zuvor reserviert haben.

    Wenn Sie Attribute für Multicast-Traffic, Gruppenmitgliedschaft und Logging angeben möchten, fügen Sie die folgenden Felder in den Anfragetext ein. Mit Ausnahme des Bereichs für die Trafficverteilung können Sie jede Property später nach Bedarf aktualisieren.

    • REQUIRE_EXPLICIT_ACCEPT: Bestimmt, welche Projekte den Multicast-Gruppenbereich verwenden können, wenn consumerAcceptList leer ist. Diese Konfiguration bestimmt, ob ein Multicast-Nutzerprojekt ein Multicast-Nutzer-VPC-Netzwerk für den Gruppenbereich aktivieren kann.
      • Wenn Sie alle Projekte ablehnen möchten, legen Sie true fest. Ein Projekt kann den Gruppenbereich nur verwenden, wenn Sie es zu consumerAcceptList hinzufügen.
      • (Standard) Wenn Sie alle Projekte zulassen möchten, legen Sie false fest. Jedes Projekt, das Zugriff auf die Multicast-Domain hat, kann den Gruppenbereich verwenden. In der NCC-Sterntopologie gewähren Sie einem Projekt Zugriff auf die Domain, indem Sie es dem Hub hinzufügen.
    • CONSUMER_ACCEPT_LIST: Wenn Sie requireExplicitAccept auf true setzen, können Sie eine Liste der Multicast-Nutzerprojekte eingeben, die diesen Multicast-Gruppenbereich verwenden können.

      Wenn ein Multicast-Nutzerprojekt nicht in der Annahmeliste enthalten ist, kann das Projekt keine Multicast-Nutzerkonfigurationen mit diesem Gruppenbereich erstellen.

      Sie können bis zu 100 Projekte nach Projekt-ID oder Name angeben. Verwenden Sie das folgende Format: "consumerAcceptList": ["project-1", "project-2"].

    • DISTRIBUTION_SCOPE: Bestimmt den Standortbereich des Multicast-Traffics. Sie können dieses Attribut später nicht mehr aktualisieren.

      • Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic nur innerhalb einer Zone sendet, legen Sie INTRA_ZONE fest.
      • (Standard) Wenn Sie diesen Bereich für das Senden von Multicast-Traffic über Zonen hinweg zulassen möchten, legen Sie INTRA_REGION fest.
    • LOGGING_ENABLED: Bestimmt, ob die Protokollierung von Gruppenmitgliedschaftsereignissen für den Gruppenbereich aktiviert ist. Diese Einstellung gilt für alle zonalen Aktivierungen des Gruppenbereichs, für die Logging nicht explizit aktiviert oder deaktiviert wird.

      • Setzen Sie den Wert auf true, um das Logging zu aktivieren.
      • (Standard) Wenn Sie das Logging deaktiviert lassen möchten, lassen Sie das Feld logConfig weg oder setzen Sie enabled auf false.

Gruppenbereich aktivieren

Aktivieren Sie den Gruppenbereich in jeder Zone, in der Multicast-Produzenten oder ‑Nutzer die zugehörigen Gruppen-IP-Adressen verwenden müssen.

Wenn Sie einen Gruppenbereich in einer bestimmten Zone nicht aktivieren, können die zugehörigen Gruppen-IP-Adressen nicht zum Senden oder Empfangen von Multicast-Traffic in der Zone verwendet werden.

gcloud

Verwenden Sie den Befehl network-services multicast-group-range-activations create, um einen Multicast-Gruppenbereich zu aktivieren.

  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]

Ersetzen Sie die folgenden Werte:

  • GROUP_RANGE_ACTIVATION_NAME: ein Name für die Aktivierung des Multicast-Gruppenbereichs
  • ADMIN_PROJECT: die Projekt-ID des Multicast-Administrators
  • ZONE: die Zone, in der der Gruppenbereich aktiviert werden soll. Dies muss eine Zone sein, in der Sie die Domain zuvor aktiviert haben.
  • DOMAIN_ACTIVATION_NAME: der Name der Domainaktivierung, die Sie zuvor in dieser Zone erstellt haben.
  • GROUP_RANGE_NAME: der Name des zuvor erstellten Gruppenbereichs
  • --[no-]enable-logging: optional, bestimmt, ob die Protokollierung von Gruppenmitgliedschaftsereignissen aktiviert ist. Wenn Sie dieses Flag für die Aktivierung eines zonalen Gruppenbereichs konfigurieren, wird die Einstellung für den globalen Gruppenbereich überschrieben.
    • (Standard) Wenn Sie die Logging-Einstellung vom globalen Gruppenbereich übernehmen möchten, lassen Sie dieses Flag weg.
    • Verwenden Sie --enable-logging, um das Logging in dieser Zone unabhängig von der globalen Einstellung zu aktivieren.
    • Wenn Sie das Logging in dieser Zone unabhängig von der globalen Einstellung deaktivieren möchten, verwenden Sie --no-enable-logging.

API

Verwenden Sie zum Aktivieren eines Multicast-Gruppenbereichs die Methode 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"
    }
}

Ersetzen Sie die folgenden Werte:

  • GROUP_RANGE_ACTIVATION_NAME: ein Name für die Aktivierung des Multicast-Gruppenbereichs
  • ADMIN_PROJECT: die Projekt-ID des Multicast-Administrators
  • ZONE: die Zone, in der der Gruppenbereich aktiviert werden soll. Dies muss eine Zone sein, in der Sie die Domain zuvor aktiviert haben.
  • DOMAIN_ACTIVATION_NAME: der Name der Domainaktivierung, die Sie zuvor in dieser Zone erstellt haben.
  • GROUP_RANGE_NAME: der Name des zuvor erstellten Gruppenbereichs
  • LOGGING_ENABLED: Bestimmt, ob die Protokollierung von Gruppenmitgliedschaftsereignissen aktiviert ist. Wenn Sie das Logging für die Aktivierung eines zonalen Gruppenbereichs konfigurieren, wird die Einstellung für den globalen Gruppenbereich überschrieben.
    • (Standard) Wenn Sie die Logging-Einstellung vom globalen Gruppenbereich übernehmen möchten, lassen Sie das Feld logConfig im Anfragetext weg.
    • Wenn Sie das Logging in dieser Zone unabhängig von der globalen Einstellung aktivieren möchten, setzen Sie enabled auf true.
    • Wenn Sie das Logging in dieser Zone unabhängig von der globalen Einstellung deaktivieren möchten, setzen Sie enabled auf false.

Nächste Schritte