Multicast-Domains erstellen

Auf dieser Seite werden die Schritte beschrieben, die Sie ausführen müssen, um Multicast-Domains zu erstellen.

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

Hinweis

Lesen Sie die folgenden Abschnitte, bevor Sie Multicast-Domains erstellen.

VPC-Netzwerk erstellen oder identifizieren

Erstellen Sie ein VPC-Netzwerk (Virtual Private Cloud), das als Multicast-Administratornetzwerk verwendet werden soll, falls noch nicht geschehen. Weitere Informationen zum Erstellen von VPC-Netzwerken finden Sie unter VPC-Netzwerke erstellen und verwalten.

Wenn Ihr Multicast-Administratornetzwerk auch Multicast-Produzenten oder ‑Nutzer hostet, z. B. bei Verwendung der Topologie mit einem einzelnen VPC-Netzwerk, müssen Sie dafür sorgen, dass das Netzwerk die entsprechenden Firewallregeln hat, um Multicast-Traffic zuzulassen. Weitere Informationen finden Sie hier:

Projekt festlegen

Legen Sie die gcloud CLI so fest, dass sie Ihr Projekt verwendet. Alternativ können Sie das Flag --project=MULTICAST_ADMIN_PROJECT für jeden Befehl in den folgenden Verfahren angeben.

    gcloud config set project MULTICAST_ADMIN_PROJECT

Ersetzen Sie MULTICAST_ADMIN_PROJECT durch die ID Ihres Projekts.

APIs aktivieren

Aktivieren Sie die folgenden APIs, falls noch nicht geschehen.

Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie diese Berechtigung nicht haben, bitten Sie Ihren IAM-Administrator (Identity and Access Management), Ihnen die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) zuzuweisen.

  1. Aktivieren Sie die networkservices API, um Multicast-Ressourcen zu erstellen:

        gcloud services enable networkservices.googleapis.com

  2. Aktivieren Sie die networkconnectivity API, um einen VPC-Spoke für das Network Connectivity Center (NCC) zu erstellen:

        gcloud services enable networkconnectivity.googleapis.com

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Multicast-Domains benötigen:

  • Zum Erstellen und Verwalten von Netzwerkressourcen: Compute-Netzwerkadministrator (compute.networkAdmin) für Ihr Projekt
  • Zum Erstellen und Verwalten von Firewallregeln: Compute-Sicherheitsadministrator (compute.securityAdmin) für Ihr Projekt
  • Zum Erstellen und Verwalten von NCC-Hubs und ‑Spokes: Hub-and-Spoke-Administrator (networkconnectivity.hubAdmin) für Ihr Projekt
  • So erstellen Sie Multicast-Ressourcen: Multicast-Administrator (networkservices.multicastAdmin) für Ihr Projekt

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

NCC konfigurieren

Wenn Sie eine Multicast-Domain erstellen, die die NCC-Sterntopologie verwendet, folgen Sie der Anleitung in diesem Abschnitt, um den Hub zu konfigurieren.

Wenn Sie eine Multicast-Domain erstellen, die die Topologie mit einem einzelnen VPC-Netzwerk verwendet, können Sie diesen Abschnitt überspringen und mit Multicast-Domain erstellen fortfahren.

In diesem Abschnitt wird beschrieben, wie Sie einen NCC-Hub mit der voreingestellten Sterntopologie konfigurieren, um Folgendes zu ermöglichen:

  • Sie können Ihr Administrator-VPC-Netzwerk dem Hub als Center-Spoke hinzufügen.
  • Wenn ein separates Multicast-Ersteller-VPC-Netzwerk vorhanden ist, kann es dem Hub als Center-Spoke beitreten.
  • Multicast-Nutzer-VPC-Netzwerke können dem Hub als Edge-Spokes beitreten.

Weitere Informationen finden Sie in der NCC-Dokumentation unter Sterntopologie und Hub konfigurieren.

gcloud

So konfigurieren Sie NCC:

  1. Verwenden Sie zum Erstellen eines Hubs den Befehl network-connectivity hubs create.

      gcloud network-connectivity hubs create HUB_NAME \
    --policy-mode=PRESET \
    --preset-topology=STAR

    Ersetzen Sie HUB_NAME durch einen Namen für den Hub.

  2. Verwenden Sie den Befehl network-connectivity spokes linked-vpc-network create, um Ihr VPC-Netzwerk als Center-Spoke zum Hub hinzuzufügen.

      gcloud network-connectivity spokes linked-vpc-network create SPOKE_NAME \
    --hub=projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME \
    --vpc-network=MULTICAST_ADMIN_NETWORK \
    --group="center" \
    --global

    Ersetzen Sie Folgendes:

    • SPOKE_NAME: Name für den Spoke
    • MULTICAST_ADMIN_PROJECT: die ID des Multicast-Administratorprojekts
    • HUB_NAME: der Name des NCC-Hubs, den Sie zuvor erstellt haben

    • MULTICAST_ADMIN_NETWORK: der Name des zuvor erstellten Multicast-Administratornetzwerks

      Alternativ können Sie den URI des Multicast-Administratornetzwerks im folgenden Format angeben: projects/MULTICAST_ADMIN_PROJECT/global/networks/MULTICAST_ADMIN_NETWORK.

  3. So erlauben Sie Multicast-Nutzer-VPC-Netzwerken, dem Hub beizutreten: Alternativ können Sie mit der Konfiguration von Multicast fortfahren und diese Schritte später ausführen, wie unter Zugriff auf Multicast-Domains steuern beschrieben.

    1. Gewähren Sie Administratoren von Multicast-Nutzernetzwerken in anderen Projekten die Möglichkeit, VPC-Spokes für den Hub vorzuschlagen. Folgen Sie dazu der Anleitung unter Zugriff gewähren in der NCC-Dokumentation.

    2. Bitten Sie die Administratoren des Multicast-Nutzernetzwerks, ihre VPC-Netzwerke als Spokes zum von Ihnen erstellten Hub hinzuzufügen, wenn sie die Schritte unter VPC-Netzwerk für die Nutzung von Multicast-Traffic aktivieren ausführen.

    3. Prüfen Sie die vorgeschlagenen VPC-Spokes nach Bedarf, um nach Spoke-Vorschlägen zu suchen.

    4. Wenn Sie einen Spoke-Vorschlag erhalten, folgen Sie der Anleitung unter VPC-Spoke akzeptieren.

Multicast-Domain erstellen

In diesem Abschnitt wird beschrieben, wie Sie eine Multicast-Domain erstellen.

Domaingruppe erstellen

In diesem Abschnitt wird beschrieben, wie Sie eine Multicast-Domaingruppe erstellen. Beachten Sie Folgendes, bevor Sie fortfahren:

  • Wenn Sie redundante Domains erstellen möchten, empfehlen wir, eine Domaingruppe für eine höhere Verfügbarkeit zwischen den Domains zu erstellen.

  • Eine Domaingruppe fasst zwei zusammengehörige Domains explizit zusammen. Erstellen Sie keine Domaingruppe für eine einzelne Domain oder für mehr als zwei Domains.

  • Das Erstellen einer Domaingruppe ist eine optionale Konfiguration. Wenn Sie keine Domaingruppe benötigen, können Sie diesen Schritt überspringen. Sie können einer Domaingruppe später jedoch keine vorhandenen Domains hinzufügen.

gcloud

Verwenden Sie zum Erstellen einer Domaingruppe den Befehl network-services multicast-domain-groups create.

gcloud network-services multicast-domain-groups create DOMAIN_GROUP_NAME \
   --location=global

Ersetzen Sie DOMAIN_GROUP_NAME durch einen Namen für die Domaingruppe.

API

Verwenden Sie zum Erstellen einer Domaingruppe die Methode multicastDomainGroups.create.

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups?multicastDomainGroupId=DOMAIN_GROUP_NAME

Ersetzen Sie Folgendes:

  • DOMAIN_GROUP_NAME: ein Name für die Domaingruppe
  • MULTICAST_ADMIN_PROJECT: die ID des Multicast-Administratorprojekts

Domain erstellen

Erstellen Sie eine oder mehrere Multicast-Domains, die mit Ihrem Multicast-Administrator-VPC-Netzwerk verknüpft sind.

gcloud

Verwenden Sie zum Erstellen einer Domain den Befehl network-services multicast-domains create.

Wenn Sie eine Domaingruppe verwenden möchten, müssen Sie die Domaingruppe beim Erstellen der Domain angeben. Sie können die Domain später keiner Domaingruppe hinzufügen. Wenn Sie Domains erstellen möchten, die Teil einer Domaingruppe sind, müssen Sie den folgenden Befehl zweimal ausführen, z. B. um DOMAIN_1 und DOMAIN_2 zu erstellen.

   gcloud network-services multicast-domains create DOMAIN_NAME \
      --location=global \
      --admin-network=projects/MULTICAST_ADMIN_PROJECT/locations/global/networks/MULTICAST_ADMIN_NETWORK \
      --connection-type=TOPOLOGY \
      [--ncc-hub=projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME] \
      [--multicast-domain-group=projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups/DOMAIN_GROUP_NAME]

Ersetzen Sie die folgenden Werte:

  • DOMAIN_NAME: ein Name für die Domain
  • MULTICAST_ADMIN_PROJECT: die ID des Multicast-Administratorprojekts
  • MULTICAST_ADMIN_NETWORK: das VPC-Netzwerk des Multicast-Administrators. Wenn Sie die NCC-Topologie verwenden, muss dieses Netzwerk auch Teil des Hubs als zentraler Spoke sein, da die Domain sonst nicht erstellt werden kann.
  • TOPOLOGY: die Topologie, die Sie für Cloud Multicast konfigurieren möchten. Wählen Sie eine der folgenden Optionen aus:
    • SAME_VPC: die Topologie mit einem einzelnen VPC-Netzwerk.
    • NCC: die NCC-Sterntopologie.
  • HUB_NAME: Wenn Sie die Sterntopologie des Network Connectivity Center konfigurieren, geben Sie den Namen des Hubs an.
  • DOMAIN_GROUP_NAME: Wenn Sie eine Domaingruppe erstellt haben, geben Sie den Namen der Domaingruppe ein.

API

Verwenden Sie zum Erstellen einer Domain die Methode multicastDomains.create.

Wenn Sie eine Domaingruppe verwenden möchten, müssen Sie die Domaingruppe beim Erstellen der Domain angeben. Sie können die Domain später keiner Domaingruppe hinzufügen. Wenn Sie Domains erstellen möchten, die Teil einer Domaingruppe sind, müssen Sie die folgende API-Anfrage zweimal stellen. Stellen Sie beispielsweise die folgende Anfrage einmal, um DOMAIN_1 zu erstellen, und dann noch einmal, um DOMAIN_2 zu erstellen:

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains?multicastDomainId=DOMAIN_NAME

{
  "adminNetwork": "projects/MULTICAST_ADMIN_PROJECT/locations/global/networks/MULTICAST_ADMIN_NETWORK",
  "connection": {
      "connectionType": "TOPOLOGY",
      "nccHub": "projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB_NAME"
  },
  "multicastDomainGroup": "projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomainGroups/DOMAIN_GROUP_NAME"
}

Ersetzen Sie die folgenden Werte:

  • DOMAIN_NAME: ein Name für die Domain
  • MULTICAST_ADMIN_PROJECT: die ID des Multicast-Administratorprojekts
  • MULTICAST_ADMIN_NETWORK: das VPC-Netzwerk des Multicast-Administrators. Wenn Sie die NCC-Topologie verwenden, muss dieses Netzwerk auch Teil des Hubs als zentraler Spoke sein, da die Domain sonst nicht erstellt werden kann.
  • TOPOLOGY: die Topologie, die Sie für Cloud Multicast konfigurieren möchten. Wählen Sie eine der folgenden Optionen aus:
    • SAME_VPC: die Topologie mit einem einzelnen VPC-Netzwerk.
    • NCC: die NCC-Sterntopologie.
  • HUB_NAME: Wenn Sie die Sterntopologie des Network Connectivity Center konfigurieren, geben Sie den Namen des Hubs im Feld nccHub an.
  • DOMAIN_GROUP_NAME: Wenn Sie eine Domaingruppe erstellt haben, geben Sie den Namen der Domaingruppe im Feld multicastDomainGroup ein.

Domain aktivieren

Aktivieren Sie die Domain in jeder Zone, in der Multicast-Produzenten oder ‑Nutzer Multicast-Traffic senden oder empfangen müssen. Wenn Sie eine Domain in einer Zone aktivieren, stelltGoogle Cloud Multicast-Infrastruktur für Ihre Domain in dieser Zone bereit.

Wenn Sie eine Domain in einer bestimmten Zone nicht aktivieren, kann in dieser Zone kein Multicast-Traffic gesendet oder empfangen werden.

gcloud

Verwenden Sie zum Aktivieren einer Domain den Befehl network-services multicast-domain-activations create.

Die Ausführung des folgenden Befehls dauert etwa 10 bis 30 Minuten.

   gcloud network-services multicast-domain-activations create DOMAIN_ACTIVATION_NAME \
      --multicast-domain="projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \
      --location=ZONE \
      [--disable-placement-policy] \
      [--aggr-egress-pps=AGGR_EGRESS_PPS] \
      [--aggr-ingress-pps=AGGR_INGRESS_PPS] \
      [--avg-packet-size=AVG_PACKET_SIZE] \
      [--max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS] \
      [--max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS]

Ersetzen Sie die folgenden Werte:

  • DOMAIN_ACTIVATION_NAME: ein Name für die Domainaktivierung
  • MULTICAST_ADMIN_PROJECT: die ID des Multicast-Administratorprojekts
  • DOMAIN_NAME: der Name der zu aktivierenden Domain
  • ZONE: die Zone, in der die Domain aktiviert werden soll
  • --disable-placement-policy: Wenn Sie eine Domain aktivieren, die Teil einer Domaingruppe ist, können Sie optional dieses Flag einfügen, um die Erstellung einer Platzierungsrichtlinie zu deaktivieren. Andernfalls erstellt Google Cloudautomatisch eine Platzierungsrichtlinie, die optional auf neue oder vorhandene Multicast-Nutzer angewendet werden kann.

  • Geben Sie die folgenden Parameter entsprechend Ihren Anforderungen für den Multicast-Traffic in dieser Zone an. Google Cloud verwendet diese Parameter, um die Skalierung Ihrer Multicast-Infrastruktur zu bestimmen.

    Bevor Sie diese Parameter angeben, sollten Sie Folgendes beachten:

    • Lesen Sie die entsprechenden Einschränkungen für Multicast-Traffic in der Übersicht zu Cloud Multicast.
    • Wenn Sie diese Flags nicht angeben, generiert Google Cloudeine minimale Konfiguration, die Sie für Tests verwenden können.
    • Sie können die Konfiguration dieser Flags später aktualisieren, wie unter Multicast-Domainparameter aktualisieren beschrieben.
    • Diese Flags sind optional. Wenn Sie jedoch eines der Flags angeben, wird --aggr-egress-pps zu einem erforderlichen Flag.

    Weitere Informationen zu den einzelnen Flags finden Sie hier:

    • AGGR_EGRESS_PPS: Aggregierte ausgehende Pakete pro Sekunde (pps) für alle Multicast-Gruppen in der Domain in der angegebenen Zone. Ausgehender Traffic bezieht sich auf Pakete, die von der Multicast-Infrastruktur an Multicast-Nutzer verteilt werden.

      Sie können einen Wert zwischen 0 und 500.000.000 (500 Millionen) eingeben. Der Standardwert ist 1.000.000 (1 Million). Die Standardwerte für die anderen Felder werden dynamisch anhand des Werts festgelegt, den Sie für dieses Flag eingeben.

    • AGGR_INGRESS_PPS: Aggregierte eingehende pps für alle Multicast-Gruppen in der Domain in der angegebenen Zone. Eingehender Traffic bezieht sich auf Pakete, die von Multicast-Producern an die Multicast-Infrastruktur gesendet werden.

      Sie können einen Wert zwischen 0 und 2.000.000 (2 Millionen) eingeben. Der Wert, den Sie für --aggr-ingress-pps eingeben, darf nicht größer als der Wert von --aggr-egress-pps sein.

    • AVG_PACKET_SIZE: durchschnittliche Paketgröße in Byte. Sie können einen Wert zwischen 64 und 1.500 eingeben.

    • MAX_PER_GROUP_INGRESS_PPS: maximale eingehende pps für eine einzelne Multicast-Gruppe in der Domain in der angegebenen Zone. Verwenden Sie dieses Flag, um die aktivste Multicast-Gruppe in der Domain anzugeben. So kann Google Cloud die erforderliche Skalierung Ihrer Multicast-Infrastruktur genauer bestimmen.

      Sie können einen Wert zwischen 0 und 2.000.000 (2 Millionen) eingeben. Der Wert, den Sie für --max-per-group-ingress-pps eingeben, darf nicht größer als der Wert von --aggr-ingress-pps sein.

    • MAX_PER_GROUP_SUBSCRIBERS: maximale Anzahl von Multicast-Consumern für eine einzelne Multicast-Gruppe in der Domain in der angegebenen Zone. Mit diesem Flag geben Sie die Gruppe mit den meisten Multicast-Nutzern an. So kann Google Cloud die erforderliche Skalierung Ihrer Multicast-Infrastruktur genauer bestimmen. Wenn Sie dieses Flag angeben, wird die Anzahl der Multicast-Nutzer für eine Gruppe nicht begrenzt.

      Sie können einen Wert zwischen 1 und 500 eingeben.

API

Verwenden Sie zum Aktivieren einer Domain die Methode multicastDomainActivations.create.

Die folgende Anfrage dauert etwa 10 bis 30 Minuten.

POST https://networkservices.googleapis.com/v1/projects/MULTICAST_ADMIN_PROJECT/locations/ZONE/multicastDomainActivations?multicastDomainActivationId=DOMAIN_ACTIVATION_NAME

{
  "multicastDomain": "projects/MULTICAST_ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME",
  "disablePlacementPolicy": "PLACEMENT_POLICY_DISABLED",
  "trafficSpec": {
    "aggrEgressPps": "AGGR_EGRESS_PPS",
    "aggrIngressPps": "AGGR_INGRESS_PPS",
    "avgPacketSize": "AVG_PACKET_SIZE",
    "maxPerGroupIngressPps": "MAX_PER_GROUP_INGRESS_PPS",
    "maxPerGroupSubscribers": "MAX_PER_GROUP_SUBSCRIBERS"
  }
}

Ersetzen Sie die folgenden Werte:

  • DOMAIN_ACTIVATION_NAME: ein Name für die Domainaktivierung
  • MULTICAST_ADMIN_PROJECT: die ID des Multicast-Administratorprojekts
  • DOMAIN_NAME: der Name der zu aktivierenden Domain
  • ZONE: die Zone, in der die Domain aktiviert werden soll
  • PLACEMENT_POLICY_DISABLED: Wenn Sie eine Domain aktivieren, die Teil einer Domaingruppe ist, können Sie dieses Feld optional einfügen und auf true setzen, um die Erstellung einer Platzierungsrichtlinie zu deaktivieren. Andernfalls erstellt Google Cloud automatisch eine Platzierungsrichtlinie, die optional auf neue oder vorhandene Multicast-Nutzer angewendet werden kann.

  • Geben Sie Werte für das Objekt trafficSpec entsprechend Ihren Anforderungen für den Multicast-Traffic in dieser Zone an. Google Cloud verwendet diese Parameter, um die Skalierung Ihrer Multicast-Infrastruktur zu bestimmen.

    Bevor Sie diese Parameter angeben, sollten Sie Folgendes beachten:

    • Lesen Sie die entsprechenden Einschränkungen für Multicast-Traffic in der Übersicht zu Cloud Multicast.
    • Wenn Sie das Objekt trafficSpec nicht in den Anfragetext aufnehmen, generiert Google Cloudeine minimale Konfiguration, die Sie für Tests verwenden können.
    • Sie können die trafficSpec-Konfiguration später aktualisieren, wie unter Multicast-Domainparameter aktualisieren beschrieben.
    • Die Felder in trafficSpec sind optional. Wenn Sie jedoch Felder angeben, wird aggrEgressPps zu einem Pflichtfeld. Wenn Sie das trafficSpec-Objekt mit einigen Feldern angeben, müssen Sie aggrEgressPps angeben.

    Weitere Informationen zu den einzelnen Feldern finden Sie hier:

    • AGGR_EGRESS_PPS: Aggregierte ausgehende Pakete pro Sekunde (pps) für alle Multicast-Gruppen in der Domain in der angegebenen Zone. Ausgehender Traffic bezieht sich auf Pakete, die von der Multicast-Infrastruktur an Multicast-Nutzer verteilt werden.

      Sie können einen Wert zwischen 0 und 500.000.000 (500 Millionen) eingeben. Der Standardwert ist 1.000.000 (1 Million). Die Standardwerte für die anderen Felder werden dynamisch anhand des Werts festgelegt, den Sie für dieses Feld eingeben.

    • AGGR_INGRESS_PPS: Aggregierte eingehende pps für alle Multicast-Gruppen in der Domain in der angegebenen Zone. Eingehender Traffic bezieht sich auf Pakete, die von Multicast-Producern an die Multicast-Infrastruktur gesendet werden.

      Sie können einen Wert zwischen 0 und 2.000.000 (2 Millionen) eingeben. Der Wert, den Sie für aggrIngressPps eingeben, darf nicht größer als der Wert von aggrEgressPps sein.

    • AVG_PACKET_SIZE: durchschnittliche Paketgröße in Byte. Sie können einen Wert zwischen 64 und 1.500 eingeben.

    • MAX_PER_GROUP_INGRESS_PPS: maximale eingehende pps für eine einzelne Multicast-Gruppe in der Domain in der angegebenen Zone. Verwenden Sie dieses Flag, um die aktivste Multicast-Gruppe in der Domain anzugeben. So kann Google Cloud die erforderliche Skalierung Ihrer Multicast-Infrastruktur genauer bestimmen.

      Sie können einen Wert zwischen 0 und 2.000.000 (2 Millionen) eingeben. Der Wert, den Sie für maxPerGroupIngressPps eingeben, darf nicht größer als der Wert von aggrIngressPps sein.

    • MAX_PER_GROUP_SUBSCRIBERS: maximale Anzahl von Multicast-Consumern für eine einzelne Multicast-Gruppe in der Domain in der angegebenen Zone. Mit diesem Flag geben Sie die Gruppe mit den meisten Multicast-Nutzern an. So kann Google Cloud die erforderliche Skalierung Ihrer Multicast-Infrastruktur genauer bestimmen. Durch die Angabe dieser Spezifikation wird keine Beschränkung für die Anzahl der Multicast-Nutzer für eine Gruppe erzwungen.

      Sie können einen Wert zwischen 1 und 500 eingeben.

Nächste Schritte