VPC ネットワークでマルチキャストトラフィックを使用できるようにする

このページでは、VPC ネットワーク内のマルチキャストコンシューマーが、特定のマルチキャストドメインと 1 つ以上のグループ範囲からマルチキャストトラフィックを受信できるように、Google Cloud でリソースを構成する際に必要な手順について説明します。

始める前に

このページの手順を始める前に、このセクションで説明する前提条件を満たしている必要があります。

マルチキャストドメイン、グループ範囲、プロデューサーの構成が完了していることを確認する

マルチキャスト構成の概要の説明に従って、マルチキャストトラフィックを使用するマルチキャストドメイン、マルチキャストグループ範囲、マルチキャストプロデューサーの構成が完了していることを確認します。必要に応じて、ドメインのマルチキャスト管理者に連絡します。

プロジェクトを設定する

マルチキャストコンシューマー VPC ネットワークのプロジェクトを使用するように gcloud CLI を設定します。次の手順で各コマンドに --project=PROJECT フラグを渡すこともできます。

    gcloud config set project PROJECT

PROJECT は、プロジェクトの ID に置き換えます。

API を有効にする

まだ有効にしていない場合は、次の API を有効にします。

API を有効にするには、serviceusage.services.enable 権限が必要です。この権限がない場合は、Identity and Access Management（IAM）管理者に Service Usage 管理者（roles/serviceusage.serviceUsageAdmin）ロールを付与するよう依頼してください。

マルチキャストリソースを作成するには、networkservices API を有効にします。
```
    gcloud services enable networkservices.googleapis.com
```
Network Connectivity Center VPC スポークを作成するには、networkconnectivity API を有効にします。
```
    gcloud services enable networkconnectivity.googleapis.com
```

必要なロール

マルチキャストコンシューマーリソースの構成に必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

ネットワークリソースを作成して管理する: プロジェクトに対する Compute ネットワーク管理者（compute.networkAdmin）
ファイアウォールルールを作成して管理する: プロジェクトに対する Compute セキュリティ管理者（compute.securityAdmin）
Network Connectivity Center スポークを作成する: プロジェクトに対するスポーク管理者（networkconnectivity.spokeAdmin）
マルチキャストドメインに関連付けられたハブに Network Connectivity Center スポークを提案する: マルチキャスト管理者プロジェクトに対するグループユーザー（networkconnectivity.groupUser）
マルチキャストリソースを作成する: プロジェクトに対するマルチキャスト管理者（networkservices.multicastAdmin）。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

VPC ネットワークを作成してハブに追加する

マルチキャストドメインが、個別のマルチキャストコンシューマー VPC ネットワークが存在する Network Connectivity Center スタートポロジを使用している場合は、このセクションの手順を完了する必要があります。

マルチキャストドメインが単一の VPC ネットワークトポロジを使用している場合は、このセクションをスキップして、VPC ネットワークでマルチキャストトラフィックを使用できるようにするに直接進みます。

VPC ネットワークの作成

このセクションでは、マルチキャストトラフィックを使用するために Virtual Private Cloud（VPC）ネットワークを作成する方法について説明します。

VPC ネットワークの作成の詳細については、VPC ネットワークを作成して管理するをご覧ください。

gcloud

compute networks create コマンドを使用して VPC ネットワークを作成します。
```
gcloud compute networks create MULTICAST_CONSUMER_NETWORK --subnet-mode=custom
```
MULTICAST_CONSUMER_NETWORK は、マルチキャストコンシューマーネットワークの名前に置き換えます。
compute networks subnets create コマンドを使用して、マルチキャストコンシューマーをホストするサブネットを 1 つ以上追加します。
```
gcloud compute networks subnets create SUBNET
   --network=MULTICAST_CONSUMER_NETWORK \
   --range=PRIMARY_RANGE \
   --region=REGION
```
次の値を置き換えます。
- SUBNET: サブネットの名前
- MULTICAST_CONSUMER_NETWORK: 前に作成したマルチキャストコンシューマーネットワークの名前
- PRIMARY_RANGE: サブネットのプライマリ IPv4 範囲（CIDR 表記）。詳細については、IPv4 サブネットの範囲をご覧ください。
- REGION: 新しいサブネットが作成される Google Cloud リージョン。us-east5 など、マルチキャストをサポートするリージョンである必要があります。‏

ファイアウォールルールを追加する

このセクションでは、マルチキャストトラフィック用にマルチキャストコンシューマー VPC ネットワークでファイアウォールルールを作成する方法について説明します。

SSH などの追加のファイアウォールルールを作成するには、VPC ファイアウォールルールを作成するをご覧ください。

コマンドには、ファイアウォールルールの名前の例が事前に設定されています。ファイアウォールルールの名前はプロジェクト内で一意にする必要があります。

上り（内向き）マルチキャストトラフィックを許可する

gcloud

マルチキャストプロデューサーネットワークから VPC ネットワークへの上り（内向き）マルチキャストトラフィックを許可するファイアウォールルールを作成するには、compute firewall-rules create コマンドを使用します。

gcloud compute firewall-rules create allow-multicast-traffic-ingress \
   --direction=INGRESS \
   --priority=1000 \
   --network=MULTICAST_CONSUMER_NETWORK \
   --action=ALLOW \
   --rules=udp[:PORT[-PORT]] \
   --source-ranges=MULTICAST_PRODUCER_RANGE \
   --destination-ranges=MULTICAST_GROUP_IP_RANGES

次の値を置き換えます。

MULTICAST_CONSUMER_NETWORK: 前に作成したマルチキャストコンシューマーネットワークの名前
PORT: ファイアウォールルールが適用されるポートのリスト。 Google Cloud は、マルチキャストトラフィックに udp を使用します。特定のポートを通過するトラフィックにファイアウォールルールが適用されるプロトコルの後に、ポートまたはポート範囲を指定できます。ポートまたはポート範囲が指定されていない場合、すべての範囲の接続が適用されます。

たとえば、ポート 1234 経由のマルチキャストトラフィックを許可するには、--rules=udp:1234 を指定します。
MULTICAST_PRODUCER_RANGE: マルチキャストプロデューサーの IP アドレスの割り振りに使用される、マルチキャストプロデューサー VPC ネットワークの CIDR 範囲。--source-ranges フラグを省略して、上り（内向き）の送信元を任意の IPv4 アドレス（0.0.0.0/0）に設定することもできます。
MULTICAST_GROUP_IP_RANGES: マルチキャストプロデューサーがトラフィックを送信するマルチキャストグループの CIDR 範囲。これはクラス D のアドレス範囲である必要があります。たとえば、224.0.0.0/4 を使用してすべてのマルチキャストトラフィックを許可できます。

上り（内向き）IGMP クエリを許可する

gcloud

マルチキャストコンシューマーネットワーク範囲からマルチキャストコンシューマー VPC ネットワークへの上り（内向き）IGMP クエリトラフィックを許可するファイアウォールルールを作成するには、compute firewall-rules create コマンドを使用します。

以下のコマンドには次のものが含まれます。

--destination-ranges=224.0.0.1/32: このサブネット上のすべてのホストを表すマルチキャストグループ IP アドレスを指定します。
IGMP を指定するには、--rules=2 を使用します。

gcloud compute firewall-rules create allow-multicast-igmp-ingress \
    --direction=INGRESS \
    --priority=1000 \
    --network=MULTICAST_CONSUMER_NETWORK \
    --action=ALLOW \
    --rules=2 \
    --source-ranges=MULTICAST_CONSUMER_RANGE \
    --destination-ranges=224.0.0.1/32

次の値を置き換えます。

MULTICAST_CONSUMER_NETWORK: 前に作成したマルチキャストコンシューマーネットワークの名前
MULTICAST_CONSUMER_RANGE: マルチキャストコンシューマーの IP アドレスの割り振りに使用されるマルチキャストコンシューマーネットワークの CIDR 範囲。

下り（外向き）IGMP を許可する

このセクションでは、下り（外向き）IGMP トラフィックを許可するファイアウォールルールを作成して、マルチキャストコンシューマーから IGMP JOIN メッセージと LEAVE メッセージを送信できるようにする方法について説明します。

すべての VPC ネットワークには、優先度が最も低い（65535）デフォルトの IPv4 下り（外向き）許可ルールがあります。下り（外向き）トラフィックを明示的にブロックする優先度の高いルールがない場合は、この手順を完了する必要はありません。詳細については、暗黙のルールをご覧ください。

gcloud

マルチキャストコンシューマー VPC ネットワークからの下り（外向き）マルチキャスト IGMP トラフィックを許可するファイアウォールルールを作成するには、compute firewall-rules create コマンドを使用します。

gcloud compute firewall-rules create allow-multicast-igmp-egress \
    --direction=EGRESS \
    --priority=1000 \
    --network=MULTICAST_CONSUMER_NETWORK \
    --action=ALLOW \
    --rules=2 \
    --destination-ranges=RANGES_FOR_JOIN_AND_LEAVE

次の値を置き換えます。

MULTICAST_CONSUMER_NETWORK: 前に作成したマルチキャストコンシューマーネットワークの名前
RANGES_FOR_JOIN_AND_LEAVE: 次の項目のカンマ区切りリスト。
- マルチキャストコンシューマーが参加する必要のあるマルチキャストグループの CIDR 範囲。クラス D のアドレス範囲を使用する必要があります。
- すべてのルーターの IP アドレス: 224.0.0.2/32。この範囲は、IGMP 離脱メッセージを送信するために必要です。
または、224.0.0.0/4 を指定して、すべてのマルチキャストトラフィックを許可することもできます。

VPC ネットワークを Network Connectivity Center ハブに追加する

このセクションでは、マルチキャスト管理者が作成した Network Connectivity Center ハブに VPC ネットワークを追加する方法について説明します。ネットワークを追加するには、エッジグループに VPC スポークを作成します。

詳細については、Network Connectivity Center のドキュメントのスタートポロジと VPC スポークを作成するをご覧ください。

gcloud

VPC ネットワークをエッジスポークとしてハブに追加するには、network-connectivity spokes linked-vpc-network create コマンドを使用します。
```
  gcloud network-connectivity spokes linked-vpc-network create SPOKE_NAME \
    --hub=projects/MULTICAST_ADMIN_PROJECT/locations/global/hubs/HUB \
    --vpc-network=MULTICAST_CONSUMER_NETWORK \
    --group="edge" \
    --global \
    --include-export-ranges=INCLUDE_RANGES
```
次の値を置き換えます。
- SPOKE_NAME: エッジスポークの名前
- MULTICAST_ADMIN_PROJECT: マルチキャスト管理者プロジェクトの ID
- HUB: マルチキャスト管理者が作成した Network Connectivity Center ハブの名前
- MULTICAST_CONSUMER_NETWORK: 前に作成したマルチキャストコンシューマーネットワークの名前
  
  代わりに、projects/MULTICAST_CONSUMER_PROJECT/global/networks/MULTICAST_CONSUMER_NETWORK の形式でマルチキャストコンシューマーネットワークの URI を指定することもできます。
- INCLUDE_RANGES: ハブにエクスポートする IP アドレス範囲のカンマ区切りリスト。
  
  デフォルトでは、スポークはすべてのサブネット範囲をエクスポートします。ハブ上の他のスポークとの重複を避けるため、エクスポートするサブネット範囲を指定できます。サブネット範囲を指定する場合は、マルチキャストコンシューマーをホストする範囲と、ユニキャストトラフィックなど、センターグループのスポークとの通信に必要なその他の範囲を含めるようにしてください。
  
  Google Cloud は、サブネットルートの一意性で説明されているように、VPC スポーク間のサブネットの重複を禁止します。エクスポートフィルタを使用して重複を回避する方法については、エクスポートフィルタを使用した VPC 接続をご覧ください。
マルチキャスト管理者に連絡して、ハブに VPC スポークを提案したことを通知します。

ハブが別のプロジェクトにある場合、マルチキャスト管理者がプロジェクトを自動承諾プロジェクトとして追加していない限り、マルチキャスト管理者はスポークがアクティブになる前に明示的に承認する必要があります。

スポークの作成後にステータスを確認するには、VPC スポークのステータスを確認するをご覧ください。

VPC ネットワークでマルチキャストトラフィックを使用できるようにする

このセクションでは、VPC ネットワーク内のマルチキャストコンシューマーが特定のドメインと 1 つ以上のグループ範囲からマルチキャストトラフィックを受信できるようにするために必要な手順について説明します。

マルチキャストコンシューマー VPC ネットワークをドメインに追加する

このセクションでは、ネットワークとドメインの間にマルチキャストコンシューマーの関連付けを作成して、マルチキャストコンシューマー VPC ネットワークをドメインに追加する方法について説明します。

マルチキャストコンシューマーをホストする各ゾーンで、次の手順を完了します。

gcloud

マルチキャストコンシューマー VPC ネットワークをドメインに追加するには、network-services multicast-consumer-associations create コマンドを使用します。

   gcloud beta network-services multicast-consumer-associations create CONSUMER_ASSOCIATION_NAME \
      --multicast-domain-activation="projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME" \
      --network="projects/MULTICAST_CONSUMER_PROJECT/locations/global/networks/MULTICAST_CONSUMER_NETWORK" \
      --location=ZONE

次の値を置き換えます。

CONSUMER_ASSOCIATION_NAME: マルチキャストコンシューマーの関連付けの一意の名前。
ADMIN_PROJECT: マルチキャスト管理者プロジェクトの ID
ZONE: 管理者がマルチキャストドメインを有効にしたゾーン。ここでマルチキャストコンシューマーをホストする必要があります
DOMAIN_ACTIVATION_NAME: マルチキャスト管理者が作成したドメインの有効化の名前
MULTICAST_CONSUMER_PROJECT と MULTICAST_CONSUMER_NETWORK: マルチキャストトラフィックを使用するプロジェクトとネットワーク。ドメインのマルチキャストトポロジに応じて、マルチキャスト管理者プロジェクトとネットワーク、または個別のマルチキャストコンシューマープロジェクトとネットワークのいずれかになります。

API

マルチキャストコンシューマー VPC ネットワークをドメインに追加するには、multicastConsumerAssociations.create メソッドを使用します。

POST https://networkservices.googleapis.com/v1beta1/projects/MULTICAST_CONSUMER_PROJECT/locations/ZONE/multicastConsumerAssociations?multicastConsumerAssociationId=CONSUMER_ASSOCIATION_NAME
{
  "multicastDomainActivation": "projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME",
  "network": "projects/MULTICAST_CONSUMER_PROJECT/locations/global/networks/MULTICAST_CONSUMER_NETWORK"
}

次の値を置き換えます。

CONSUMER_ASSOCIATION_NAME: マルチキャストコンシューマーの関連付けの一意の名前。
ADMIN_PROJECT: マルチキャスト管理者プロジェクトの ID
ZONE: 管理者がマルチキャストドメインを有効にしたゾーン。マルチキャストコンシューマーをホストする必要があります。
DOMAIN_ACTIVATION_NAME: マルチキャスト管理者が作成したドメインの有効化の名前
MULTICAST_CONSUMER_PROJECT と MULTICAST_CONSUMER_NETWORK: マルチキャストトラフィックを使用するプロジェクトとネットワーク。ドメインのマルチキャストトポロジに応じて、マルチキャスト管理者プロジェクトとネットワーク、または個別のマルチキャストコンシューマープロジェクトとネットワークのいずれかになります。

グループ範囲のマルチキャストコンシューマー VPC ネットワークを有効にする

このセクションでは、グループ範囲のマルチキャストコンシューマー VPC ネットワークを有効にする方法について説明します。

マルチキャストトラフィックを使用するマルチキャストグループ範囲とゾーンごとに、次の手順を完了します。

この手順を完了すると、IGMP が構成されている場合、ネットワーク内のマルチキャストコンシューマーは、指定されたグループ範囲内のマルチキャストグループ IP アドレスに参加できます。

gcloud

マルチキャストグループ範囲のマルチキャストコンシューマー VPC ネットワークを有効にするには、network-services multicast-group-consumer-activations create コマンドを使用します。

   gcloud beta network-services multicast-group-consumer-activations create GROUP_CONSUMER_ACTIVATION_NAME \
      --multicast-consumer-association="projects/CONSUMER_PROJECT/locations/ZONE/multicastConsumerAssociations/CONSUMER_ASSOCIATION_NAME" \
      --multicast-group-range-activation="projects/ADMIN_PROJECT/locations/ZONE/multicastGroupRangeActivations/GROUP_RANGE_ACTIVATION_NAME" \
      --location=ZONE \
      [--enable-logging | --no-enable-logging]

次の値を置き換えます。

GROUP_CONSUMER_ACTIVATION_NAME: マルチキャストグループコンシューマーの有効化の一意の名前。
CONSUMER_PROJECT: 実際のプロジェクト ID。これは、マルチキャストドメインのトポロジに応じて、マルチキャスト管理者プロジェクトまたは個別のマルチキャストコンシューマープロジェクトのいずれかになります。
ZONE: マルチキャストコンシューマーネットワークを有効にするゾーン。管理者がマルチキャストグループ範囲を有効にしたゾーンにする必要があります。
CONSUMER_ASSOCIATION_NAME: 前に作成したマルチキャストコンシューマーの関連付けの名前
ADMIN_PROJECT: マルチキャスト管理者プロジェクトの ID
GROUP_RANGE_ACTIVATION_NAME: マルチキャスト管理者が作成したグループ範囲の有効化の名前。
--[no-]enable-logging: 省略可。グループメンバーシップのイベントロギングを有効にするかどうかを指定します。
- ロギングを有効にするには、--enable-logging を使用します。
- （デフォルト）ロギングを無効にするには、--no-enable-logging を使用します。

API

マルチキャストグループ範囲のマルチキャストコンシューマー VPC ネットワークを有効にするには、multicastGroupConsumerActivations.create メソッドを使用します。

POST https://networkservices.googleapis.com/v1beta1/projects/CONSUMER_PROJECT/locations/ZONE/multicastGroupConsumerActivations?multicastGroupConsumerActivationId=GROUP_CONSUMER_ACTIVATION_NAME
{
  "multicastConsumerAssociation": "projects/CONSUMER_PROJECT/locations/ZONE/multicastConsumerAssociations/CONSUMER_ASSOCIATION_NAME",
  "multicastGroupRangeActivation": "projects/ADMIN_PROJECT/locations/ZONE/multicastGroupRangeActivations/GROUP_RANGE_ACTIVATION_NAME",
  "logConfig": {
          "enabled": "LOGGING_ENABLED"
    }
}

次の値を置き換えます。

GROUP_CONSUMER_ACTIVATION_NAME: マルチキャストグループコンシューマーの有効化の一意の名前。
CONSUMER_PROJECT: 実際のプロジェクト ID。これは、マルチキャストドメインのトポロジに応じて、マルチキャスト管理者プロジェクトまたは個別のマルチキャストコンシューマープロジェクトのいずれかになります。
ZONE: マルチキャストコンシューマーネットワークを有効にするゾーン。管理者がマルチキャストグループ範囲を有効にしたゾーンにする必要があります。
CONSUMER_ASSOCIATION_NAME: 前に作成したマルチキャストコンシューマーの関連付けの名前
ADMIN_PROJECT: マルチキャスト管理者プロジェクトの ID
GROUP_RANGE_ACTIVATION_NAME: マルチキャスト管理者が作成したグループ範囲の有効化の名前
LOGGING_ENABLED: グループメンバーシップのイベントロギングが有効かどうかを指定します。
- ロギングを有効にするには、true に設定します。
- （デフォルト）ロギングを無効にするには、false に設定します。

マルチキャストコンシューマーインスタンスを作成する

まだ作成していない場合は、マルチキャストトラフィックを使用するアプリケーションを実行する 1 つ以上の VM インスタンスを作成します。マルチキャストコンシューマーインスタンスの IGMP を構成するの説明に沿って、新規または既存のインスタンスで IGMP を構成します。インスタンスの作成の詳細については、Compute Engine インスタンスの作成と開始をご覧ください。

次のステップ

作成したマルチキャストコンシューマーの構成を確認する。マルチキャストコンシューマーの構成を表示するをご覧ください。
マルチキャストコンシューマーインスタンスの IGMP を構成する

VPC ネットワークでマルチキャスト トラフィックを使用できるようにする

始める前に

マルチキャスト ドメイン、グループ範囲、プロデューサーの構成が完了していることを確認する

プロジェクトを設定する

API を有効にする

必要なロール

VPC ネットワークを作成してハブに追加する

VPC ネットワークの作成

gcloud

ファイアウォール ルールを追加する

上り（内向き）マルチキャスト トラフィックを許可する

gcloud

上り（内向き）IGMP クエリを許可する

gcloud

下り（外向き）IGMP を許可する

gcloud

VPC ネットワークを Network Connectivity Center ハブに追加する

gcloud

VPC ネットワークでマルチキャスト トラフィックを使用できるようにする

マルチキャスト コンシューマー VPC ネットワークをドメインに追加する

gcloud

API

グループ範囲のマルチキャスト コンシューマー VPC ネットワークを有効にする

gcloud

API

マルチキャスト コンシューマー インスタンスを作成する

次のステップ

VPC ネットワークでマルチキャストトラフィックを使用できるようにする

マルチキャストドメイン、グループ範囲、プロデューサーの構成が完了していることを確認する

ファイアウォールルールを追加する

上り（内向き）マルチキャストトラフィックを許可する

VPC ネットワークでマルチキャストトラフィックを使用できるようにする

マルチキャストコンシューマー VPC ネットワークをドメインに追加する

グループ範囲のマルチキャストコンシューマー VPC ネットワークを有効にする

マルチキャストコンシューマーインスタンスを作成する