듀얼 스택 Elastic Beanstalk 로드 밸런서 구성

듀얼 스택으로 구성된 로드 밸런서를 사용하여 IPv4 및 IPv6 프로토콜을 모두 제공하도록 Elastic Beanstalk 환경을 활성화할 수 있습니다. 로드 밸런싱된 환경을 생성할 때 인프라는 기본적으로 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 구성 파일 사용

환경의 로드 밸런서가 IPv6 및 IPv4 네트워크 트래픽을 모두 처리할 수 있도록 하려면 Elastic Beanstalk 구성 파일을 사용할 수 있습니다. aws:elbv2:loadbalancer 네임스페이스의 IpAddressType 옵션을 dualstack으로 설정하세요.

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 블록이 필요합니다. 듀얼 스택 모드를 사용하기 전에 VPC에 IPv6 CIDR 블록을 연결하세요.

VPC와 모든 서브넷에는 IPv6 CIDR 블록이 연결되어 있어야 합니다. 이는 듀얼 스택 지원을 위해 로드 밸런서를 구성하기 전에 완료해야 하는 VPC 사전 조건 중 하나입니다. 이 작업을 완료하는 데 필요한 자세한 내용은 이 주제 전반부의 Amazon VPC 사전 조건 섹션을 참조하세요.

이벤트: VPC vpc_id의 하나 이상의 서브넷에 IPv6 CIDR 블록이 구성되어 있지 않습니다. 듀얼 스택 로드 밸런서와 함께 사용할 서브넷에는 반드시 IPv6 CIDR 블록이 연결되어 있어야 합니다. 듀얼 스택 모드를 사용하기 전에 IPv6 CIDR 블록을 모든 필수 서브넷과 연결하세요.

VPC의 모든 서브넷에는 IPv6 CIDR 블록이 연결되어 있어야 합니다. 이는 듀얼 스택 지원을 위해 로드 밸런서를 구성하기 전에 완료해야 하는 VPC 사전 조건 중 하나입니다. 이 작업을 완료하는 데 필요한 자세한 내용은 이 주제 전반부의 Amazon VPC 사전 조건 섹션을 참조하세요.

오류: 이 IpAddressType 옵션은 Application Load Balancer 또는 Network Load Balancer로 구성된 Elastic Beanstalk 환경에서만 적용할 수 있습니다.

이 메시지는 사용자의 Elastic Beanstalk 환경이 단일 인스턴스 환경이거나 Classic Load Balancer를 사용하고 있을 수 있음을 나타냅니다. Application Load Balancer 또는 Network Load Balancer로 구성된 환경에서만 IpAddressType를 구성할 수 있습니다.