翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Kinesis Video Streams で IPv6 を使用する

コントロールプレーンオペレーションとデータプレーンオペレーションの両方で IPv6 を使用するように Kinesis Video Streams を設定できます。これにより、アプリケーションはデュアルスタックエンドポイントを介して IPv6 アドレスを使用して Kinesis Video Streams サービスと通信できます。

Kinesis Video Streams は、プロデューサーアプリケーションとコンシューマーアプリケーションの両方でデュアルスタックエンドポイントを介して IPv6 をサポートします。コントロールプレーン API コールとデータプレーンストリーミングオペレーションに IPv6 を使用するようにアプリケーションを設定できます。

AWS SDK for IPv6 を設定する

AWS SDK を使用して本番稼働用セットアップで Kinesis Video Streams コントロールプレーン APIs を呼び出す場合は、デュアルスタックエンドポイントを設定することで IPv6 を有効にできます。 AWS SDK には、デュアルスタックエンドポイントを有効にするための標準化されたメソッドがいくつか用意されています。

環境変数を使用します。

IPv6 デュアルスタックエンドポイントを有効にするには、次の環境変数を設定します。

export AWS_USE_DUALSTACK_ENDPOINT=true

AWS 設定ファイルを使用する

AWS 設定ファイル (~/.aws/config) に次の設定を追加します。

[default]
use_dualstack_endpoint = true

JVM システムプロパティを使用する (Java および Kotlin SDKsのみ)

Java および Kotlin アプリケーションの場合は、次の JVM システムプロパティを設定します。

-Daws.useDualstackEndpoint=true

または、Java コードでプログラム的に以下を実行します。

System.setProperty("aws.useDualstackEndpoint", "true");

SDK サポート

次の AWS SDKs、デュアルスタックのエンドポイント設定をサポートしています。

デュアルスタックエンドポイントを設定すると、 AWS SDK は Kinesis Video Streams コントロールプレーン APIs呼び出すときに IPv6 エンドポイントを自動的に使用します。

IPv6 用の Kinesis Video Streams プロデューサー SDK を設定する

Kinesis Video Streams プロデューサー SDK は、コントロールプレーンオペレーションとデータプレーンオペレーションの両方に IPv6 設定オプションを提供します。これらの設定は AWS SDK デュアルスタックエンドポイント設定で機能します。

C/C++ プロデューサー SDK を設定する

デフォルトのエンドポイントと DNS 解決チェーンは、KVS Producer-C SDK バージョン 1.6.0 によって実装されます。これらのパラメータの設定を設定できる各場所を順番にチェックし、最初に設定したパラメータを選択します。事前定義されたシーケンスは次のとおりです。

プロデューサー SDKs の詳細については、プロデューサー SDK for C、プロデューサー SDK for C++、プロデューサー SDK の関連トピックを参照してください。

エンドポイント設定

2、3、4 では、エンドポイントは に提供されたリージョンに基づいて構築されますcreateAbstractDefaultCallbacksProvider。

DNS フィルタリング

KVS プロデューサー SDK は、設定に応じて適切なCURLOPT_IPRESOLVEパラメータを設定します。

C++ プロデューサー SDK バージョン 3.5.0 では、KVS API コールに Producer-C SDK 1.6.0 を使用します。

GStreamer プラグインを設定する

GStreamer プラグインは基盤となる C プロデューサー SDK を使用するため、前述のように C SDK for IPv6 を設定するとIPv6 設定が自動的に処理されます。

コードの変更は必須ではありません。CMake パラメータを使用して SDK を構築するか、前のセクションで説明したように適切な環境変数を設定します。

データプレーンエンドポイントの解決

データプレーンオペレーションでは、 GetDataEndpoint API を使用して適切なデュアルスタックのデータプレーンエンドポイントを取得します。サービスは、リクエスト URL に応じて対応するエンドポイントを返します。

例:

IPv6 AWS CLI の を設定する

Kinesis Video Streams オペレーション (通常はproof-of-concept作業用) AWS CLI に を使用している場合は、デュアルスタックエンドポイントを設定することで IPv6 を有効にできます。

環境変数の使用

export AWS_USE_DUALSTACK_ENDPOINT=true

AWS 設定ファイルを使用する

AWS CLI 設定ファイル (~/.aws/config) に以下を追加します。

[default]
use_dualstack_endpoint = true

設定例

C SDK の例

KVS Producer-C SDK を IPV6-onlyモードで構築し、環境変数設定を無視するには、次のコマンドを使用して SDK を構築します。

cmake .. -DAWS_KVS_USE_DUAL_STACK_ENDPOINT_ONLY=TRUE -DAWS_KVS_IPV6_ONLY=TRUE
make -j

考慮事項

ネットワークの要件

SDK の互換性

テストと検証

IPv6-enabled Kinesis Video Streams アプリケーションを本番環境にデプロイする前に:

IPv6 を含むアップグレードの影響を受けるお客様

Kinesis Video Streams で IPv6 を有効にすると、継続的な機能を確保するために既存の設定とポリシーを更新する必要がある領域がいくつかあります。

IAM ポリシーと IP アドレスフィルタリング

IAM ユーザーポリシー、ロールポリシー、またはリソースベースのポリシーでソース IP アドレスフィルタリングを使用する場合は、これらのポリシーを更新して IPv6 アドレス範囲を含める必要があります。

IPv6 の IAM ポリシー更新の例:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "kinesisvideo:*",
      "Resource": "*",
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": [
            "192.0.2.0/24",
            "203.0.113.0/24",
            "2001:db8::/32"
          ]
        }
      }
    }
  ]
}

ログ記録とモニタリング

IPv6 アドレスの形式は IPv4 アドレスとは異なるため、ログ記録、モニタリング、分析システムに影響を与える可能性があります。

ログ

ログには、リクエストが IPv6 経由で行われると、 sourceIPAddressフィールドに IPv6 アドレスが含まれます。IPv6 アドレス形式を処理するようにログ解析ツールとスクリプトを更新します。

ログの IPv6 アドレスの例:

{
  "sourceIPAddress": "2001:db8::1",
  "eventName": "CreateStream",
  "eventSource": "kinesisvideo.amazonaws.com"
}

トラブルシューティング

一般的な問題

検証手順

設定の検証

デュアルスタックのエンドポイント設定を確認するには、以下を確認します。