Multicast-Domains erstellen

gcloud

So konfigurieren Sie NCC:

1. Verwenden Sie den network-connectivity hubs create Befehl, um einen Hub zu erstellen.

     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 network-connectivity spokes linked-vpc-network create Befehl, um Ihr VPC-Netzwerk als zentralen 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: ein Name für den Spoke
   • MULTICAST_ADMIN_PROJECT: die ID des Projekts des Multicast-Administrators
   • HUB_NAME: der Name des zuvor erstellten NCC-Hubs

   • MULTICAST_ADMIN_NETWORK: der Name des zuvor erstellten Netzwerks des Multicast-Administrators

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

3. So ermöglichen Sie es VPC-Netzwerken für Multicast-Consumer, dem Hub beizutreten: Alternativ können Sie die Konfiguration von Multicast fortsetzen und diese Schritte später ausführen, wie unter Zugriff auf Multicast-Domains steuern beschrieben.

   1. Gewähren Sie Netzwerkadministratoren für Multicast-Consumer 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 Netzwerkadministratoren für Multicast-Consumer ihre VPC-Netzwerke als Spokes zum Hub hinzuzufügen, den Sie erstellt haben, wenn sie der Anleitung unter VPC-Netzwerk für die Nutzung von Multicast-Traffic aktivierenfolgen.

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

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

gcloud

Verwenden Sie den network-services multicast-domain-groups create Befehl, um eine Domaingruppe zu erstellen.

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 die multicastDomainGroups.create Methode, um eine Domaingruppe zu erstellen.

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 Projekts des Multicast-Administrators

gcloud

Verwenden Sie den network-services multicast-domains create Befehl, um eine Domain zu erstellen.

Wenn Sie eine Domaingruppe verwenden möchten, müssen Sie diese beim Erstellen der Domain angeben. Sie können die Domain später nicht mehr zu einer 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 Projekts des Multicast-Administrators
• MULTICAST_ADMIN_NETWORK: das VPC-Netzwerk von dem Multicast-Administrator. Wenn Sie die NCC -Topologie verwenden, muss dieses Netzwerk auch als zentraler Spoke Teil des Hubs sein, andernfalls schlägt die Domainerstellung fehl.
• TOPOLOGY: die Topologie, die Sie für Multicast konfigurieren möchten. Geben Sie eine der folgenden Optionen an:
  • SAME_VPC: die Topologie mit einem einzelnen VPC-Netzwerk.
  • NCC: die NCC-Sterntopologie.
• HUB_NAME: Wenn Sie die Network Connectivity Center-Sterntopologie 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 die multicastDomains.create Methode, um eine Domain zu erstellen.

Wenn Sie eine Domaingruppe verwenden möchten, müssen Sie diese beim Erstellen der Domain angeben. Sie können die Domain später nicht mehr zu einer Domaingruppe hinzufügen. Wenn Sie Domains erstellen möchten, die Teil einer Domaingruppe sind, müssen Sie die folgende API-Anfrage zweimal senden. Senden Sie die folgende Anfrage beispielsweise 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 Projekts des Multicast-Administrators
• MULTICAST_ADMIN_NETWORK: das VPC-Netzwerk von dem Multicast-Administrator. Wenn Sie die NCC -Topologie verwenden, muss dieses Netzwerk auch als zentraler Spoke Teil des Hubs sein, andernfalls schlägt die Domainerstellung fehl.
• TOPOLOGY: die Topologie, die Sie für Multicast konfigurieren möchten. Geben Sie eine der folgenden Optionen an:
  • SAME_VPC: die Topologie mit einem einzelnen VPC-Netzwerk.
  • NCC: die NCC-Sterntopologie.
• HUB_NAME: Wenn Sie die Network Connectivity Center-Sterntopologie 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.

gcloud

Verwenden Sie den network-services multicast-domain-activations create Befehl, um eine Domain zu aktivieren.

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 Projekts des Multicast-Administrators
• 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 angeben, um die Erstellung einer Platzierungsrichtlinie zu deaktivieren. Andernfalls Google Cloud wird automatisch eine Platzierungsrichtlinie erstellt,die optional auf neue oder vorhandene Multicast-Consumer 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 Größe Ihrer Multicast-Infrastruktur zu bestimmen.

  Beachten Sie Folgendes, bevor Sie diese Parameter angeben:

  • Lesen Sie die entsprechenden Einschränkungen für Multicast-Traffic in der Übersicht zu Multicast.
  • Wenn Sie diese Flags nicht angeben, Google Cloud wird eine minimale Konfiguration generiert, 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 zwar optional, aber wenn Sie eines der Flags angeben, wird --aggr-egress-pps zu einem erforderlichen Flag.

  Weitere Informationen zu den einzelnen Flags finden Sie unter:

  • AGGR_EGRESS_PPS: aggregierte Anzahl der ausgehenden Pakete pro Sekunde (pps) für alle Multicast-Gruppen in der Domain in der angegebenen Zone. Ausgehend bezieht sich auf Pakete, die von der Multicast-Infrastruktur an Multicast-Consumer 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 basierend auf dem Wert festgelegt, den Sie für dieses Flag eingeben.

  • AGGR_INGRESS_PPS: aggregierte Anzahl der eingehenden Pakete pro Sekunde für alle Multicast-Gruppen in der Domain in der angegebenen Zone. Eingehend 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 Anzahl der eingehenden Pakete pro Sekunde für eine einzelne Multicast-Gruppe in der Domain in der angegebenen Zone. Mit diesem Flag können Sie die aktivste Multicast-Gruppe in der Domain angeben, um die erforderliche Größe Ihrer Multicast-Infrastruktur genauer zu bestimmen. Google Cloud

    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 können Sie die Gruppe mit den meisten Multicast-Consumern angeben, um Google Cloud die erforderliche Größe Ihrer Multicast Infrastruktur genauer zu bestimmen. Wenn Sie dieses Flag angeben, wird die Anzahl der Multicast-Consumer für eine Gruppe nicht begrenzt.

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

API

Verwenden Sie die multicastDomainActivations.create Methode, um eine Domain zu aktivieren.

Die Ausführung der folgenden 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 Projekts des Multicast-Administrators
• 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 optional dieses Feld angeben und auf true setzen, um die Erstellung einer Platzierungsrichtlinie zu deaktivieren. Andernfalls Google Cloud wird automatisch eine Platzierungsrichtlinie erstellt,die optional auf neue oder vorhandene Multicast-Consumer angewendet werden kann.

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

  Beachten Sie Folgendes, bevor Sie diese Parameter angeben:

  • Lesen Sie die entsprechenden Einschränkungen für Multicast-Traffic in der Übersicht zu Multicast.
  • Wenn Sie das Objekt trafficSpec nicht in den Anfragetext aufnehmen, Google Cloud wird eine minimale Konfiguration generiert, 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 zwar optional, aber wenn Sie Felder angeben, wird aggrEgressPps zu einem Pflichtfeld. Wenn Sie das Objekt trafficSpec mit einigen Feldern angeben, müssen Sie aggrEgressPps angeben.

  Weitere Informationen zu den einzelnen Feldern finden Sie unter:

  • AGGR_EGRESS_PPS: aggregierte Anzahl der ausgehenden Pakete pro Sekunde (pps) für alle Multicast-Gruppen in der Domain in der angegebenen Zone. Ausgehend bezieht sich auf Pakete, die von der Multicast-Infrastruktur an Multicast-Consumer 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 basierend auf dem Wert festgelegt, den Sie für dieses Feld eingeben.

  • AGGR_INGRESS_PPS: aggregierte Anzahl der eingehenden Pakete pro Sekunde für alle Multicast-Gruppen in der Domain in der angegebenen Zone. Eingehend 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 Anzahl der eingehenden Pakete pro Sekunde für eine einzelne Multicast-Gruppe in der Domain in der angegebenen Zone. Mit diesem Flag können Sie die aktivste Multicast-Gruppe in der Domain angeben, um die erforderliche Größe Ihrer Multicast-Infrastruktur genauer zu bestimmen. Google Cloud

    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 können Sie die Gruppe mit den meisten Multicast-Consumern angeben, um die erforderliche Größe Ihrer Multicast Infrastruktur Google Cloud genauer zu bestimmen. Wenn Sie diese Spezifikation angeben, wird die Anzahl der Multicast-Consumer für eine Gruppe nicht begrenzt.

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