デュアルスタック Elastic Beanstalk ロードバランサーを設定する

デュアルスタック設定されたロードバランサーを使用して、Elastic Beanstalk 環境が IPv4 プロトコルと IPv6 プロトコルの両方を提供できるようにします。負荷分散された環境を作成すると、インフラストラクチャはデフォルトで IPv4 になります。デュアルスタック設定で新しい環境を作成するか、既存の IPv4 のみの環境をデュアルスタックに更新するかを選択できます。

環境のロードバランサーが IPv6 と IPv4 の両方のネットワークトラフィックを処理できるようにするには、aws:elbv2:loadbalancer 名前空間の IpAddressType オプションをデュアルスタックに設定します。

Amazon VPC の前提条件

Elastic Beanstalk 環境でロードバランサーを設定する前に、まず Amazon VPC でいくつかの設定ステップを完了する必要があります。

Amazon VPC コンソールまたは AWS CLI コマンドを使用して、これらの前提条件の設定を完了できます。以下のトピックでは、ユーザーをガイドして、詳細については、Amazon VPC ユーザーガイドと AWS CLI コマンドリファレンスに導きます。

コンソールを使用して VPC の前提条件を完了する

「Amazon VPC ユーザーガイド」は、これらの前提条件のタスクを完了するための詳細な手順を提供します。

AWS CLI を使用して VPC の前提条件を完了する

AWS CLI を使用して、前提条件の設定を完了して検証できます。

Elastic Beanstalk ロードバランサーのデュアルスタックを設定する

環境に VPC の前提条件設定を行ったら、デュアルスタックオプションを使用してロードバランサーを設定し、IPv4 プロトコルと IPv6 プロトコルの両方を提供できます。Elastic Beanstalk コンソール、AWS CLI、.ebextensions の設定ファイル、および AWS SDK を使用して、デュアルスタックトラフィックを処理するようにロードバランサーを設定できます。

コンソールを使用する

Elastic Beanstalk コンソールを使用して、環境のロードバランサーのデュアルスタックを設定できます。

の使用AWS CLI

AWS コマンドラインインターフェイス (AWS CLI) を使用して、IPv6 と IPv4 の両方のネットワークトラフィックを処理するように環境のロードバランサーを設定できます。このセクションでは、aws:elbv2:loadbalancer 名前空間がある create-environment および update-environment コマンドの例を提供します。

aws elasticbeanstalk create-environment \
--region us-east-1 \
--application-name my-app \
--environment-name my-env \
--solution-stack-name "64bit Amazon Linux 2 v3.4.0 running Python 3.8" \
--option-settings \
Namespace=aws:autoscaling:launchconfiguration,OptionName=IamInstanceProfile,Value=aws-elasticbeanstalk-ec2-role \
Namespace=aws:elbv2:loadbalancer,OptionName=IpAddressType,Value=dualstack

別の方法として、options.jsonファイルを使用して、インラインで名前空間オプションを含めるのではなく、名前空間オプションを指定します。次のコマンド例は、update-environment コマンドを示しています。

aws elasticbeanstalk update-environment \
--region us-east-1 \
--application-name my-app \
--environment-name my-env \
--solution-stack-name "64bit Amazon Linux 2 v3.4.0 running Python 3.8" \
--option-settings \ file://options.json

### example options.json ###
[
  {
    "Namespace": "aws:elbv2:loadbalancer",
    "OptionName": "IpAddressType",
    "Value": "dualstack"
  }
]

次の例では、既存の環境を更新して、IpAddressType オプションを IPv4 に設定します。

aws elasticbeanstalk update-environment \
--region us-east-1 \
--application-name my-app \
--environment-name my-env \
--solution-stack-name "64bit Amazon Linux 2 v3.4.0 running Python 3.8" \
--option-settings \
Namespace=aws:elbv2:loadbalancer,OptionName=IpAddressType,Value=ipv4

.ebextensions 設定ファイルを使用する

Elastic Beanstalk 設定ファイルを使用して、環境のロードバランサーが IPv6 と IPv4 の両方のネットワークトラフィックを処理できるようにします。aws:elbv2:loadbalancer 名前空間の IpAddressType オプションをデュアルスタックに設定します。

option_settings:
  aws:elbv2:loadbalancer:
    IpAddressType: dualstack

option_settings:
  - namespace: aws:elbv2:loadbalancer
    option_name: IpAddressType
    value: dualstack

AWS SDK の使用

AWS SDK を使用してデュアルスタックを設定できます。前のセクションで説明した update-environment および create-environment AWS CLI コマンドと同様に、CreateEnvironment および UpdateEnvironment API アクションを使用できます。OptionSettings リクエストパラメータを使用して、aws:elbv2:loadbalancer 名前空間のオプションを指定します。

トラブルシューティング

このセクションでは、ロードバランサーのデュアルスタック設定に関する問題をトラブルシューティングするためのガイダンスを提供します。

イベント: VPC vpc_id には IPv6 CIDR ブロックが設定されていません。デュアルスタックロードバランサーには IPv6 CIDR ブロックが必要です。デュアルスタックモードを使用する前に、IPv6 CIDR ブロックを VPC に関連付けてください。

VPC とすべてのサブネットには IPv6 CIDR ブロックが関連付けられている必要があります。これは、デュアルスタックのサポート用にロードバランサーを設定する前に完了する必要がある VPC 前提条件の 1 つです。このタスクを完了するための詳細については、このトピックで前述した「Amazon VPC の前提条件」を参照してください。

イベント: VPC vpc_id の 1 つ以上のサブネットに IPv6 CIDR ブロックが設定されていません。デュアルスタックロードバランサーとともに使用されるサブネットには、IPv6 CIDR ブロックが必要です。デュアルスタックモードを使用する前に、IPv6 CIDR ブロックをすべての必要なサブネットに関連付けてください。

VPC のすべてのサブネットには、IPv6 CIDR ブロックが関連付けられている必要があります。これは、デュアルスタックのサポート用にロードバランサーを設定する前に完了する必要がある VPC 前提条件の 1 つです。このタスクを完了するための詳細については、このトピックで前述した「Amazon VPC の前提条件」を参照してください。

エラー: IpAddressType オプションは、Application Load Balancer または Network Load Balancer を使用して設定された Elastic Beanstalk 環境にのみ適用されます。

このメッセージは、Elastic Beanstalk 環境が単一のインスタンス環境であるか、Classic Load Balancer を使用している可能性があることを示しています。Application Load Balancer または Network Load Balancer を使用して設定された環境のみが IpAddressType を設定できます。