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 Cloud Multicast-Konfiguration – Übersicht.

Hinweis

Ein Multicast-Gruppenbereich muss einer bestimmten Multicast-Domain zugeordnet sein. Bevor Sie einen Multicast-Gruppenbereich erstellen, erstellen Sie eine Multicast-Domain.

Multicast-Gruppenbereich erstellen

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

Gruppenbereich erstellen

Ordnen Sie der Multicast-Domain einen IP-Adressbereich für Multicast-Gruppen zu.

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. Zum Reservieren eines internen Bereichs verwenden Sie den Befehl network-connectivity internal-ranges create.

    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 Klasse D-Adresse 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 derselben Domain zugeordnet 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 Multicastgruppenbereich
    • DOMAIN_NAME: Der Name der Multicast-Domain, die Sie zuvor erstellt haben.
    • ADMIN_PROJECT: die ID des Projekts des Multicast-Administrators
    • 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 Verteilung des Traffics können Sie jede Eigenschaft bei Bedarf zu einem späteren Zeitpunkt aktualisieren.

      • --require-explicit-accept: Gibt an, welche Projekte den Multicast-Gruppenbereich verwenden können, wenn die Akzeptanzliste für Multicast-Empfänger leer ist. Mit dieser Konfiguration wird festgelegt, ob ein Multicast-Nutzerprojekt ein VPC-Netzwerk für Multicast-Nutzer für den Gruppenbereich aktivieren kann.
        • Wenn Sie alle Projekte ablehnen möchten, fügen Sie dieses Flag ein. Ein Projekt kann den Gruppenbereich nur verwenden, wenn Sie es der Akzeptanzliste für Multicast-Nutzer 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 NCC-Sterntopologie (Network Connectivity Center) gewähren Sie einem Projekt Zugriff auf die Domain, indem Sie es für den Hub akzeptieren.

      • CONSUMER_ACCEPT_LIST: Wenn Sie --require-explicit-accept angegeben haben, können Sie eine Liste von Multicast-Consumer-Projekten eingeben, die diesen Multicast-Gruppenbereich verwenden können. Wenn ein Multicast-Nutzerprojekt nicht in der Akzeptanzliste enthalten ist, können im Projekt keine Multicast-Nutzerkonfigurationen mit diesem Gruppenbereich erstellt werden.

        Sie können bis zu 100 Projekte anhand der Projekt-ID oder des Projektnamens angeben.

      • DISTRIBUTION_SCOPE: bestimmt den Standortbereich des Multicast-Traffics. Sie können diese Property später nicht mehr aktualisieren.

        • Wenn für diesen Bereich Multicast-Traffic nur innerhalb einer Zone gesendet werden soll, setzen Sie dieses Flag auf intra-zone.
        • (Standard) Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic zonenübergreifend sendet, setzen Sie dieses Flag auf intra-region.

      • --[no-]enable-logging: Legt fest, ob Protokollierung von Gruppenmitgliedschaftsereignissen aktiviert ist.

        • Verwenden Sie --enable-logging, um das Logging zu aktivieren.
        • (Standard) Um das Logging zu deaktivieren, 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 Projekts des Multicast-Administrators
    • ADMIN_NETWORK: der Name des Multicast-Administratornetzwerks

    • CIDR_RANGE: der zu reservierende CIDR-Bereich

      Der von Ihnen angegebene CIDR-Bereich muss eine Klasse D-Adresse 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 derselben Domain zugeordnet 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 Multicastgruppenbereich
    • ADMIN_PROJECT: die ID des Projekts des Multicast-Administrators
    • 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 Eigenschaften 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 Verteilung des Traffics können Sie jede Eigenschaft bei Bedarf zu einem späteren Zeitpunkt aktualisieren.

    • REQUIRE_EXPLICIT_ACCEPT: Gibt an, welche Projekte den Multicast-Gruppenbereich verwenden können, wenn consumerAcceptList leer ist. Mit dieser Konfiguration wird festgelegt, ob ein Multicast-Nutzerprojekt ein VPC-Netzwerk für Multicast-Nutzer 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 ihn 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 für den Hub akzeptieren.

    • CONSUMER_ACCEPT_LIST: Wenn Sie requireExplicitAccept auf true setzen, können Sie eine Liste von Multicast-Consumer-Projekten eingeben, die diesen Multicast-Gruppenbereich verwenden können.

      Wenn ein Multicast-Nutzerprojekt nicht in der Akzeptanzliste enthalten ist, können im Projekt keine Multicast-Nutzerkonfigurationen mit diesem Gruppenbereich erstellt werden.

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

    • DISTRIBUTION_SCOPE: bestimmt den Standortbereich des Multicast-Traffics. Sie können diese Property später nicht mehr aktualisieren.

      • Wenn für diesen Bereich Multicast-Traffic nur innerhalb einer Zone gesendet werden soll, legen Sie INTRA_ZONE fest.
      • (Standard) Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic über Zonen hinweg sendet, legen Sie den Wert auf INTRA_REGION fest.

    • LOGGING_ENABLED: Legt fest, ob Protokollierung von Gruppenmitgliedschaftsereignissen aktiviert ist.

      • Setzen Sie den Wert auf true, um das Logging zu aktivieren.
      • (Standard) Um das Logging zu deaktivieren, legen Sie false fest.

Gruppenbereich aktivieren

Aktivieren Sie den Gruppenbereich in jeder Zone, in der Multicast-Producer oder ‑Consumer 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 network-services multicast-group-range-activations create-Befehl, 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: Name für die Aktivierung des Multicastgruppenbereichs
  • 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 Gruppenbereichs, den Sie zuvor erstellt haben.
  • --[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.
    • Verwenden Sie --enable-logging, um das Logging zu aktivieren.
    • (Standard) Um das Logging zu deaktivieren, verwenden Sie --no-enable-logging.

API

Verwenden Sie die Methode multicastGroupRangeActivations.create, um einen Multicast-Gruppenbereich zu aktivieren.

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: Name für die Aktivierung des Multicastgruppenbereichs
  • 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 Gruppenbereichs, den Sie zuvor erstellt haben.
  • LOGGING_ENABLED: Legt fest, ob Protokollierung von Gruppenmitgliedschaftsereignissen aktiviert ist. Wenn Sie die Protokollierung für eine zonale Aktivierung des Gruppenbereichs konfigurieren, wird die Einstellung für den globalen Gruppenbereich überschrieben.
    • Setzen Sie den Wert auf true, um das Logging zu aktivieren.
    • (Standard) Um das Logging zu deaktivieren, legen Sie false fest.

Nächste Schritte