配置双堆栈 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 does not have IPv6 CIDR blocks configured. 双堆栈负载均衡器需要 IPv6 CIDR 数据块。在使用双堆栈模式之前，请将 IPv6 CIDR 数据块与 VPC 关联。

VPC 和所有子网都必须有与之关联的 IPv6 CIDR 数据块。这是在配置负载均衡器以支持双堆栈之前必须达成的 VPC 先决条件之一。有关更多信息，请参阅本主题前面的 Amazon VPC 先决条件。

事件：One or more subnets for VPC vpc_id do not have IPv6 CIDR blocks configured. 双堆栈负载均衡器所用的子网需要 IPv6 CIDR 数据块。在使用双堆栈模式之前，请将 IPv6 CIDR 数据块与所有必需的子网关联。

VPC 的所有子网都必须有与之关联的 IPv6 CIDR 数据块。这是在配置负载均衡器以支持双堆栈之前必须达成的 VPC 先决条件之一。有关更多信息，请参阅本主题前面的 Amazon VPC 先决条件。

错误：The IpAddressType option can only be applied on Elastic Beanstalk environments configured with an Application Load Balancer or Network Load Balancer.

此消息表明 Elastic Beanstalk 环境可能是单实例环境，或者该环境可能正在使用经典负载均衡器。只有配置了应用程序负载均衡器或网络负载均衡器的环境才能配置 IpAddressType。