모든 환경의 일반 옵션 - AWS Elastic Beanstalk
aws:autoscaling:asgaws:autoscaling:launchconfigurationaws:autoscaling:scheduledactionaws:autoscaling:triggeraws:autoscaling:updatepolicy:rollingupdateaws:ec2:instancesaws:ec2:vpcaws:elasticbeanstalk:applicationaws:elasticbeanstalk:application:environmentaws:elasticbeanstalk:cloudwatch:logsaws:elasticbeanstalk:cloudwatch:logs:healthaws:elasticbeanstalk:commandaws:elasticbeanstalk:environmentaws:elasticbeanstalk:environment:process:defaultaws:elasticbeanstalk:environment:process:process_nameaws:elasticbeanstalk:environment:proxy:staticfilesaws:elasticbeanstalk:healthreporting:systemaws:elasticbeanstalk:hostmanageraws:elasticbeanstalk:managedactionsaws:elasticbeanstalk:managedactions:platformupdateaws:elasticbeanstalk:monitoringaws:elasticbeanstalk:sns:topicsaws:elasticbeanstalk:sqsdaws:elasticbeanstalk:trafficsplittingaws:elasticbeanstalk:xrayaws:elb:healthcheckaws:elb:loadbalanceraws:elb:listeneraws:elb:listener:listener_portaws:elb:policiesaws:elb:policies:policy_nameaws:elbv2:listener:defaultaws:elbv2:listener:listener_portaws:elbv2:listenerrule:rule_nameaws:elbv2:loadbalanceraws:rds:dbinstance

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

모든 환경의 일반 옵션

aws:autoscaling:asg

환경의 Auto Scaling 그룹을 구성합니다. 자세한 내용은 Elastic Beanstalk 환경에 대한 Auto Scaling 그룹 섹션을 참조하세요.

네임스페이스: aws:autoscaling:asg
이름 설명 기본값 유효값

Availability Zones

가용 영역(AZ)은 다른 AZ에서 발생한 장애를 고립시키기 위하여 만들어진 AWS 리전 내 장소입니다. 가용 영역은 같은 리전에 있는 다른 AZ에 비용이 저렴하고 지연 시간이 짧은 네트워크 연결을 제공합니다. 인스턴스의 AZ 수를 선택합니다.

Any

Any

Any 1

Any 2

Any 3

Cooldown

휴지 기간을 지정하여 이전 활동의 효과가 표시되기 전에 Amazon EC2 Auto Scaling에서 추가 조정 활동을 시작하지 않도록 할 수 있습니다. 휴지 기간은 조정 활동을 완료한 후 다른 조정 활동을 시작하기 전까지의 시간(초)입니다.

360

0~10000

Custom Availability Zones

인스턴스의 AZ를 정의합니다.

없음

us-east-1a

us-east-1b

us-east-1c

us-east-1d

us-east-1e

eu-central-1

EnableCapacityRebalancing

Auto Scaling 그룹의 스팟 인스턴스에 대해 용량 리밸런싱 기능을 활성화할지 여부를 지정합니다. 자세한 내용은 Amazon EC2 Auto Scaling 사용 설명서의 용량 리밸런싱을 참조하세요.

이 옵션은 aws:ec2:instances 네임스페이스에서 EnableSpot이 true로 설정되었으며 Auto Scaling 그룹에 스팟 인스턴스가 하나 이상 있는 경우에만 관련이 있습니다.

false

true

false

MinSize

Auto Scaling 그룹에 필요한 최소 인스턴스 수입니다.

1

1~10000

MaxSize

Auto Scaling 그룹에 필요한 최대 인스턴스 수입니다.

4

1~10000

aws:autoscaling:launchconfiguration

환경의 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스를 구성합니다.

환경에서 사용되는 인스턴스는 Amazon EC2 시작 템플릿 또는 Auto Scaling 그룹 시작 구성 리소스를 사용하여 생성됩니다. 다음의 옵션은 두 리소스 유형 모두에서 사용할 수 있습니다.

자세한 내용은 Elastic Beanstalk 환경에 대한 Amazon EC2 인스턴스 섹션을 참조하세요. Amazon Elastic Block Store(EBS)에 대한 자세한 내용은 Amazon EC2 - Linux 인스턴스용 사용 설명서의 Amazon EBS 장을 참조하세요.

네임스페이스: aws:autoscaling:launchconfiguration
이름 설명 기본값 유효값

DisableIMDSv1

true로 설정하여 인스턴스 메타데이터 서비스 버전 1(IMDSv1)을 비활성화합니다.

사용자 환경 인스턴스 기본값은 플랫폼 운영 체제에 따라 다음과 같습니다:

  • Windows 서버, AL2 및 이전 버전 — IMDSv1 및 IMDSv2를 모두 활성화합니다

  • AL2023 — IMDSv2만 활성화합니다

자세한 내용은 인스턴스 메타데이터 서비스 구성(Amazon 리눅스)

또는 인스턴스 메타데이터 서비스 구성 (윈도우 서버)를 참조하십시오

false— 윈도우 서버, Amazon 리눅스 2 및 이전 버전 기반 플랫폼

true— Amazon 리눅스 2023에 기반한 플랫폼

true

false

EC2KeyName

키 페어를 통해 EC2 인스턴스에 안전하게 로그인할 수 있습니다.

참고

Elastic Beanstalk 콘솔을 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔이 이 옵션을 권장 값으로 재정의합니다.

없음

IamInstanceProfile

인스턴스 프로파일을 통해 AWS Identity and Access Management(IAM) 사용자와 AWS 서비스는 임시 보안 인증에 대한 액세스 권한을 얻어 AWS API를 호출할 수 있습니다. 인스턴스 프로파일의 이름이나 ARN을 지정합니다.

예제:

  • aws-elasticbeanstalk-ec2-role

  • arn:aws:iam::123456789012:instance-profile/aws-elasticbeanstalk-ec2-role

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 재정의합니다.

없음

인스턴스 프로파일 이름 또는 ARN

ImageId

고유한 사용자 지정 AMI ID를 지정하여 기본 Amazon Machine Image(AMI)를 재정의할 수 있습니다.

예: ami-1f316660

없음

InstanceType

Elastic Beanstalk 환경에서 애플리케이션을 실행할 때 사용되는 인스턴스 유형입니다.

중요

InstanceType 옵션은 더 이상 사용되지 않습니다. 이 옵션은 InstanceTypes 네임스페이스의 보다 강력한 최신 aws:ec2:instances 옵션으로 대체되었습니다. 이러한 새 옵션을 사용하면 환경에 대한 하나 이상의 인스턴스 유형 목록을 지정할 수 있습니다. 해당 목록에 있는 첫 번째 값은 여기에서 설명하는 aws:autoscaling:launchconfiguration 네임스페이스에 포함된 InstanceType 옵션의 값과 같습니다. 새 옵션을 사용하여 인스턴스 유형을 지정하는 것이 좋습니다. 인스턴스 유형이 지정되면 새 옵션이 기존 옵션보다 우선합니다. 자세한 내용은 aws:ec2:instances 네임스페이스 섹션을 참조하세요.

사용 가능한 인스턴스 유형은 사용된 가용 영역 및 리전에 따라 다릅니다. 서브넷을 선택하면 해당 서브넷이 포함된 가용 영역에 따라 사용 가능한 인스턴스 유형이 결정됩니다.

  • Elastic Beanstalk는 Amazon EC2 Mac 인스턴스 유형을 지원하지 않습니다.

  • Amazon EC2 인스턴스 제품군 및 유형에 대한 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 인스턴스 유형 또는 Windows 인스턴스용 Amazon EC2 사용 설명서의 인스턴스 유형을 참조하세요.

  • 리전 전체에서 사용 가능한 인스턴스 유형에 대한 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 사용 가능한 인스턴스 유형 또는 Windows 인스턴스용 Amazon EC2 사용 설명서의 사용 가능한 인스턴스 유형을 참조하세요.

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 덮어씁니다.

계정 및 리전에 따라 다릅니다.

한 가지 EC2 인스턴스 유형입니다.

계정, 리전 및 가용 영역에 따라 다릅니다. 이러한 값으로 필터링된 Amazon EC2 인스턴스 유형 목록을 가져올 수 있습니다. 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 사용 가능한 인스턴스 유형 또는 Windows 인스턴스용 Amazon EC2 사용 설명서의 사용 가능한 인스턴스 유형을 참조하세요.

LaunchTemplateTagPropagationEnabled

true이(가) 환경에 프로비저닝된 특정 리소스의 시작 템플릿에 환경 태그를 전파할 수 있도록 설정합니다.

Elastic Beanstalk는 태그만 전파하여 다음 리소스에 대한 템플릿을 시작할 수 있습니다.

  • EBS 볼륨

  • EC2 인스턴스

  • EC2 네트워크 인터페이스

  • AWS CloudFormation은(는) 리소스를 정의하는 템플릿을 시작합니다

CloudFormation은 특정 리소스에 대한 템플릿 생성 시 태그만 허용하기 때문에 이러한 제약이 존재합니다. 자세한 내용은 AWS CloudFormation 사용 설명서의 TagSpecification를 참조하세요.

중요

  • 기존 환경에서 이 옵션 값을 false에서 true(으)로 변경하는 것은 이전에 존재했던 태그의 주요 변경 사항일 수 있습니다.

  • 이 기능이 활성화된 경우 태그를 전파하려면 EC2를 교체해야 하며, 이로 인해 다운타임이 발생할 수 있습니다. 롤링 업데이트를 활성화하여 구성 변경 사항을 일괄적으로 적용하고 업데이트 프로세스 중 다운타임을 방지할 수 있습니다. 자세한 내용은 구성 변경 섹션을 참조하세요.

시작 템플릿에 대한 자세한 내용은 다음 사항을 참조하세요.

이 옵션에 대한 자세한 내용은 시작 템플릿에 태그 전파 단원을 참조하세요.

false

true

false

MonitoringInterval

Amazon CloudWatch 지표를 반환할 간격(분)입니다.

5 minute

1 minute

5 minute

SecurityGroups

인스턴스에 대한 방화벽 규칙을 정의하기 위해 Auto Scaling 그룹의 EC2 인스턴스에 할당할 Amazon EC2 보안 그룹을 나열합니다.

기존 Amazon EC2 보안 그룹의 이름 또는 템플릿에서 생성된 AWS::EC2::SecurityGroup 리소스에 대한 참조가 포함되는 쉼표로 구분된 값의 단일 문자열을 제공할 수 있습니다. 보안 그룹 이름은 대/소문자를 구분합니다.

Virtual Private Cloud(VPC) 내에서 인스턴스가 시작되도록 Elastic Beanstalk에서 Amazon Virtual Private Cloud(Amazon VPC)를 사용하는 경우 보안 그룹 이름 대신 보안 그룹 ID를 지정합니다.

elasticbeanstalk-default

SSHSourceRestriction

환경에 대한 SSH 액세스를 잠그는 데 사용됩니다. 예를 들어, bastion host만 프라이빗 서브넷의 인스턴스에 액세스할 수 있도록 SSH 액세스를 EC2 인스턴스에 잠글 수 있습니다.

이 문자열은 다음과 같은 형식으로 되어 있습니다.

protocol, fromPort, toPort, source_restriction

protocol

수신 규칙의 프로토콜입니다.

fromPort

시작 포트 번호입니다.

toPort

종료 포트 번호입니다.

source_restriction

트래픽이 라우팅해야 하는 CIDR 범위 또는 보안 그룹의 이름입니다. 다른 계정의 보안 그룹을 지정하려면(EC2-Classic만, 동일한 리전에 있어야 함) 보안 그룹 이름 앞에 계정 ID를 포함합니다. other_account_id/security_group_name 형식을 사용합니다. Virtual Private Cloud(VPC) 내에서 인스턴스가 시작되도록 Elastic Beanstalk에서 Amazon Virtual Private Cloud(Amazon VPC)를 사용하는 경우 보안 그룹 이름 대신 보안 그룹 ID를 지정합니다.

예: tcp, 22, 22, 54.240.196.185/32

예: tcp, 22, 22, my-security-group

예(EC2-Classic): tcp, 22, 22, 123456789012/their-security-group

예(VPC): tcp, 22, 22, sg-903004f8

없음

BlockDeviceMappings

Auto Scaling 그룹의 모든 인스턴스에서 추가 Amazon EBS 볼륨 또는 인스턴스 스토어 볼륨을 연결합니다.

인스턴스 스토어 볼륨을 매핑할 때 디바이스 이름을 볼륨 이름에만 매핑하면 됩니다. 그러나 Amazon EBS 볼륨을 매핑할 때는 다음 필드 중 일부 또는 전부를 추가로 지정하는 것이 좋습니다(각 필드는 콜론으로 구분해야 함).

  • 스냅샷 ID

  • 크기(GB)

  • 종료 시 삭제 여부(true 또는 false)

  • 스토리지 유형(gp3, gp2, standard, st1, sc1 또는 io1만 해당)

  • IOPS(gp3 또는 io1만 해당)

  • 처리량(gp3만 해당)

다음 예제는 세 개의 Amazon EBS 볼륨 즉, 하나의 빈 100GB gp2 볼륨, 하나의 스냅샷, 하나의 빈 20GB io1 볼륨을 프로비저닝된 IOPS 2000인 인스턴스 스토어 볼륨 ephemeral0과 연결합니다. 인스턴스 유형이 지원하는 경우 여러 인스턴스 스토어 볼륨을 연결할 수 있습니다.

/dev/sdj=:100:true:gp2,/dev/sdh=snap-51eef269,/dev/sdi=:20:true:io1:2000,/dev/sdb=ephemeral0

없음

  • 크기 - 500~16,384GiB여야 합니다.

  • 처리량 - 초당 125~1,000메비바이트(MiB/s)여야 합니다.

RootVolumeType

환경 EC2 인스턴스에 연결된 루트 Amazon EBS 볼륨에 사용할 볼륨 유형(마그네틱, 범용 SSD 또는 프로비저닝된 IOPS SSD)입니다.

플랫폼에 따라 다릅니다.

standard(마그네틱 스토리지의 경우).

gp2 또는 gp3(범용 SSD의 경우)

io1(프로비저닝된 IOPS SSD의 경우)

RootVolumeSize

루트 Amazon EBS 볼륨의 전체 스토리지 용량(GB)입니다.

RootVolumeType을 프로비저닝된 IOPS SSD로 설정한 경우 필요합니다.

예: "64".

마그네틱 스토리지 및 범용 SSD의 경우 플랫폼마다 다르지만

프로비저닝된 IOPS SSD의 경우 플랫폼마다 다르지 않습니다.

10~16384GB(범용 및 프로비저닝된 IOPS SSD의 경우).

8~1024GB(마그네틱 스토리지의 경우).

RootVolumeIOPS

프로비저닝된 IOPS SSD 루트 볼륨 또는 범용 gp3 SSD 루트 볼륨에 대해 원하는 초당 입출력 작업 처리량(IOPS)입니다.

IOPS와 볼륨 크기 간 최대 비율은 500:1입니다. 예를 들어 IOPS가 3,000인 볼륨은 최소 6GiB여야 합니다.

없음

100~20000(io1 프로비저닝된 IOPS SSD 루트 볼륨의 경우)

3000~16000(범용 gp3 SSD 루트 볼륨의 경우)

RootVolumeThroughput

환경의 EC2 인스턴스에 연결된 Amazon EBS 루트 볼륨에 프로비저닝할 원하는 처리량(단위: 초당 메가바이트(MIB/초))입니다.

참고

이 옵션은 gp3 스토리지 유형에만 적용됩니다.

없음

125~1000

aws:autoscaling:scheduledaction

환경의 Auto Scaling 그룹에 대한 예약 작업을 구성합니다. 각 설정의 옵션 이름, 네임스페이스 및 값 이외에 각 작업의 resource_name을 지정합니다. aws:autoscaling:scheduledaction 네임스페이스의 예제를 참조하세요.

네임스페이스: aws:autoscaling:scheduledaction
이름 설명 기본값 유효값

StartTime

일회성 작업의 경우 작업을 실행할 날짜와 시간을 선택합니다. 반복 작업의 경우 작업을 활성화할 시점을 선택합니다.

없음

ISO-8601 타임스탬프는 예약된 모든 조정 작업에서 고유합니다.

EndTime

예약된 조정 작업의 반복을 중지할 미래의 날짜와 시간(UTC/GMT 시간대)을 지정합니다. EndTime을 지정하지 않으면 해당 작업이 Recurrence 표현식에 따라 반복됩니다.

예: 2015-04-28T04:07:2Z

예약 작업이 종료됐을 때 Amazon EC2 Auto Scaling은 이전 설정으로 자동으로 되돌아가지 않습니다. 필요에 따라 두 번째 예약 작업은 원래 설정으로 되돌아 가도록 구성할 수 있습니다.

없음

ISO-8601 타임스탬프는 예약된 모든 조정 작업에서 고유합니다.

MaxSize

작업 실행 시 적용되는 최대 인스턴스 개수입니다.

없음

0~10000

MinSize

작업 실행 시 적용되는 최소 인스턴스 개수입니다.

없음

0~10000

DesiredCapacity

Auto Scaling 그룹에 대해 원하는 초기 용량을 설정합니다. 예약 작업이 적용되면 트리거가 설정을 기반으로 원하는 용량을 조정합니다.

없음

0~10000

Recurrence

예약된 작업이 실행되도록 할 빈도입니다. 반복을 지정하지 않으면 StartTime에 의해 지정된 대로 조정 작업이 한 번만 발생합니다.

없음

Cron 식.

Suspend

반복 예약 작업을 일시적으로 비활성화하려면 true로 설정합니다.

false

true

false

aws:autoscaling:trigger

환경 Auto Scaling 그룹에 대한 확장 조정 트리거를 구성합니다.

참고

이 네임스페이스의 세 가지 옵션은 트리거가 발생하기 전에 트리거의 지표가 해당 정의된 한도를 초과해서 유지할 수 있는 기간을 결정합니다. 이러한 옵션은 다음과 같이 관련됩니다:

BreachDuration = Period * EvaluationPeriods

이러한 옵션의 기본값(각각 5, 5 및 1)은 이 등식을 충족합니다. 일관되지 않은 값을 지정하면 Elastic Beanstalk에서 등식이 여전히 충족되도록 값 중 하나를 수정할 수 있습니다.

네임스페이스: aws:autoscaling:trigger
이름 설명 기본값 유효값

BreachDuration

트리거가 호출되기 전 지표가 정의된 한도(UpperThreshold 및 LowerThreshold에 지정된 대로)를 초과할 수 있는 시간(분)입니다.

5

1~600

LowerBreachScaleIncrement

조정 작업 수행 시 제거할 Amazon EC2 인스턴스 수입니다.

-1

LowerThreshold

위반 기간 중 측정값이 이 값 아래로 떨어지면 트리거가 호출됩니다.

2000000

0~20000000

MeasureName

Auto Scaling 트리거에 사용되는 지표입니다.

참고

HealthyHostCount, UnhealthyHostCount 및 TargetResponseTime은 전용 로드 밸런서가 있는 환경에만 적용할 수 있습니다. 공유 로드 밸런서로 구성된 환경에는 유효한 지표 값이 아닙니다. 로드 밸런서 유형에 대한 자세한 내용은 Elastic Beanstalk 환경의 로드 밸런서을 참조하세요.

NetworkOut

CPUUtilization

NetworkIn

NetworkOut

DiskWriteOps

DiskReadBytes

DiskReadOps

DiskWriteBytes

Latency

RequestCount

HealthyHostCount

UnhealthyHostCount

TargetResponseTime

Period

Amazon CloudWatch가 트리거의 측정치를 측정하는 빈도를 지정합니다. 값은 연속되는 두 기간 사이의 분(min)의 수입니다.

5

1~(600).().

EvaluationPeriods

연속되는 평가 기간의 수를 위반 상황이 발생했는지 판단하는 데 사용합니다.

1

1~600

Statistic

트리거가 사용해야 하는 통계입니다(예: Average).

Average

Minimum

Maximum

Sum

Average

Unit

트리거 측정 단위입니다(예: Bytes).

Bytes

Seconds

Percent

Bytes

Bits

Count

Bytes/Second

Bits/Second

Count/Second

None

UpperBreachScaleIncrement

조정 작업 수행 시 추가할 Amazon EC2 인스턴스 수를 지정합니다.

1

UpperThreshold

위반 기간 중 측정값이 이 값보다 커지면 트리거가 호출됩니다.

6000000

0~20000000

aws:autoscaling:updatepolicy:rollingupdate

환경의 Auto Scaling 그룹의 롤링 업데이트를 구성합니다.

네임스페이스: aws:autoscaling:updatepolicy:rollingupdate
이름 설명 기본값 유효값

MaxBatchSize

롤링 업데이트의 각 배치에 포함된 인스턴스 수입니다.

Auto Scaling 그룹 최소 크기의 1/3로, 다음으로 가장 큰 정수로 반올림됩니다.

1~10000

MinInstancesInService

다른 인스턴스가 종료되는 동안 Auto Scaling 그룹 내에서 작동해야 하는 최소 인스턴스 수입니다.

Auto Scaling 그룹의 최소 크기 또는 Auto Scaling 그룹의 최대 크기보다 작은 크기 중에서 더 작은 크기입니다.

0~9999

RollingUpdateEnabled

true인 경우, 환경에 대한 롤링 업데이트를 활성화합니다. Elastic Beanstalk 소프트웨어 애플리케이션에 대해 소규모로 자주 업데이트해야 하고 애플리케이션 가동 중지를 피하려는 경우 롤링 업데이트가 유용합니다.

이 값을 true로 설정하면 MaxBatchSize, MinInstancesInService 및 PauseTime 옵션이 자동으로 활성화됩니다. 또한 이러한 옵션 중 하나를 설정하면 RollingUpdateEnabled 옵션 값이 자동으로 true로 설정됩니다. 이 옵션을 false로 설정하면 롤링 업데이트가 비활성화됩니다.

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 재정의합니다.

false

true

false

RollingUpdateType

여기에는 시간 기반 롤링 업데이트, 상태 기반 롤링 업데이트 및 변경 불가능한 업데이트의 세 가지 유형이 포함됩니다.

시간 기반 롤링 업데이트는 배치 간 PauseTime을 적용합니다. 상태 확인 기반 롤링 업데이트의 새 인스턴스가 상태 확인을 통과할 때까지 대기했다가 다음 배치를 시작합니다. 변경이 불가능한 업데이트는 새 Auto Scaling 그룹의 전체 인스턴스 세트를 시작합니다.

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 덮어씁니다.

Time

Time

Health

Immutable

PauseTime

인스턴스 배치 하나에 대한 업데이트를 완료한 후 다음 배치에 대한 업데이트를 계속하기 전까지 Elastic Beanstalk 서비스가 대기하는 시간(초, 분 또는 시간)입니다.

인스턴스 유형 및 컨테이너를 기반으로 자동으로 계산됩니다.

PT0S*(0초)~PT1H(1시간)

Timeout

인스턴스 배치 하나의 모든 인스턴스가 업데이트 취소 전 상태 확인을 통과하기 위해 대기하는 최대 시간(분 또는 시간)입니다.

PT30M(30분)

PT5M*(5분)~PT1H(1시간)

*ISO8601 기간 형식: PT#H#M#S 여기서 각 #는 각각 시간, 분 및/또는 초의 수입니다.

aws:ec2:instances

스팟 옵션을 포함하여 환경의 인스턴스를 구성합니다. 이 네임스페이스는 aws:autoscaling:launchconfiguration 및 aws:autoscaling:asg를 보완합니다.

자세한 내용은 Elastic Beanstalk 환경에 대한 Auto Scaling 그룹을(를) 참조하세요.

네임스페이스: aws:ec2:instances
이름 설명 기본값 유효값

EnableSpot

환경에 대한 스팟 인스턴스 요청을 활성화합니다. false인 경우 이 네임스페이스의 일부 옵션이 적용되지 않습니다.

false

true

false

InstanceTypes

환경에서 사용할 인스턴스 유형의 쉼표로 구분된 목록입니다(예: t2.micro,t3.micro).

스팟 인스턴스가 활성화되지 않은 경우(EnableSpot이 false인 경우) 목록의 첫 번째 인스턴스 유형만 사용됩니다.

이 옵션 목록의 첫 번째 인스턴스 유형은 InstanceType 네임스페이스의 aws:autoscaling:launchconfiguration 옵션 값과 같습니다. 후자의 옵션은 폐기되었으므로 사용하지 않는 것이 좋습니다. 둘 다 지정하면 InstanceTypes 옵션 목록의 첫 번째 인스턴스 유형이 사용되며 InstanceType은 무시됩니다.

사용 가능한 인스턴스 유형은 사용된 가용 영역 및 리전에 따라 다릅니다. 서브넷을 선택하면 해당 서브넷이 포함된 가용 영역에 따라 사용 가능한 인스턴스 유형이 결정됩니다.

  • Elastic Beanstalk는 Amazon EC2 Mac 인스턴스 유형을 지원하지 않습니다.

  • Amazon EC2 인스턴스 제품군 및 유형에 대한 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 인스턴스 유형 또는 Windows 인스턴스용 Amazon EC2 사용 설명서의 인스턴스 유형을 참조하세요.

  • 리전 전체에서 사용 가능한 인스턴스 유형에 대한 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 사용 가능한 인스턴스 유형 또는 Windows 인스턴스용 Amazon EC2 사용 설명서의 사용 가능한 인스턴스 유형을 참조하세요.

참고

기존의 일부 AWS 계정은 스팟 인스턴스를 지원하지 않는 기본 인스턴스 유형(예: t1.micro)을 Elastic Beanstalk에 제공할 수 있습니다. 스팟 인스턴스 요청을 활성화하고 스팟을 지원하지 않는 인스턴스 유형에 대한 오류가 발생하는 경우 스팟을 지원하는 인스턴스 유형을 구성해야 합니다. 스팟 인스턴스 유형을 선택하려면 스팟 인스턴스 어드바이저를 사용합니다.

환경 구성을 업데이트하고 InstanceTypes 옵션에서 하나 이상의 인스턴스 유형을 제거하면 Elastic Beanstalk는 제거된 인스턴스 유형에서 실행 중인 모든 Amazon EC2 인스턴스를 종료합니다. 그러면 환경의 Auto Scaling 그룹에서 필요에 따라 현재 지정된 인스턴스 유형을 사용하여 원하는 용량을 완료하는 데 필요한 새 인스턴스를 시작합니다.

두 인스턴스 유형의 목록입니다.

계정 및 리전에 따라 다릅니다.

1~10개의 EC2 인스턴스 유형입니다. 2개 이상을 권장합니다.

계정, 리전 및 가용 영역에 따라 다릅니다. 이러한 값으로 필터링된 Amazon EC2 인스턴스 유형 목록을 가져올 수 있습니다. 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 사용 가능한 인스턴스 유형 또는 Windows 인스턴스용 Amazon EC2 사용 설명서의 사용 가능한 인스턴스 유형을 참조하세요.

인스턴스 유형은 모두 동일한 아키텍처의 일부여야 합니다(arm64, x86_64, i386).

SupportedArchitectures 또한 이 네임스페이스의 일부입니다. SupportedArchitectures에 대한 값을 제공하는 경우, InstanceTypes에 대해 입력한 값은 SupportedArchitectures에 대해 제공한 아키텍처 중 하나에만 속해야 합니다.

SpotFleetOnDemandBase

환경 스케일 업에 따라 스팟 인스턴스를 고려하기 전에 Auto Scaling 그룹이 프로비저닝하는 최소 온디맨드 인스턴스 수입니다.

이 옵션은 EnableSpot이 true인 경우에만 사용됩니다.

0

0 네임스페이스의 MaxSize ~ aws:autoscaling:asg 옵션

SpotFleetOnDemandAboveBasePercentage

Auto Scaling 그룹이 SpotOnDemandBase 인스턴스를 초과하여 프로비저닝하는 추가 용량 일부의 온디맨드 인스턴스 비율입니다.

이 옵션은 EnableSpot이 true인 경우에만 사용됩니다.

단일 인스턴스 환경의 경우 0

로드 밸런싱 수행 환경의 경우 70

0~100

SpotMaxPrice

스팟 인스턴스에 대해 지불하려는 단위 시간당 최고 가격(USD)입니다. 스팟 인스턴스에 대한 최고 가격 옵션 권장 사항에 대해서는 Linux 인스턴스용 Amazon EC2 사용 설명서의 스팟 인스턴스 요금 기록을 참조하세요.

이 옵션은 EnableSpot이 true인 경우에만 사용됩니다.

각 인스턴스 유형에 대한 온디맨드 가격입니다. 이 경우 옵션의 값은 null입니다.

0.001~20.0

null

SupportedArchitectures

쉼표로 구분된 환경에 사용할 EC2 인스턴스 아키텍처 유형의 목록입니다.

Elastic Beanstalk는 다음 프로세서 아키텍처를 토대로 인스턴스 유형을 지원합니다.

  • AWS Graviton 64비트 Arm 아키텍처(arm64)

  • 64비트 아키텍처(x86_64)

  • 32비트 아키텍처(i386)

프로세서 아키텍처 및 Amazon EC2 인스턴스 유형에 대한 자세한 내용은 Amazon EC2 인스턴스 유형 단원을 참조하십시오.

없음

arm64

x86_64

i386

참고

32비트 아키텍처 i386은 대부분의 Elastic Beanstalk 플랫폼에서 지원되지 않습니다. 대신 x86_64 또는 arm64 아키텍처 유형을 선택하는 것을 권장합니다.

aws:ec2:vpc

사용자 지정 Amazon Virtual Private Cloud(VPC)에서 리소스를 시작하도록 환경을 구성합니다. 이 네임스페이스에서 설정을 구성하지 않으면 Elastic Beanstalk에서는 기본 VPC에서 리소스를 시작합니다.

네임스페이스: aws:ec2:vpc
이름 설명 기본값 유효값

VPCId

Amazon VPC의 ID입니다.

없음

Subnets

Auto Scaling 그룹 서브넷 또는 서브넷 ID입니다. 서브넷이 여러 개인 경우 이 값은 서브넷 ID의 쉼표로 구분된 단일 문자열로 지정합니다(예: "subnet-11111111,subnet-22222222").

없음

ELBSubnets

탄력적 로드 밸런서에 대한 서브넷의 ID입니다. 서브넷이 여러 개인 경우 이 값은 서브넷 ID의 쉼표로 구분된 단일 문자열로 지정합니다(예: "subnet-11111111,subnet-22222222").

없음

ELBScheme

Amazon VPC 외부에서 Elastic Beanstalk 애플리케이션에 액세스할 수 없도록 Amazon VPC 내부에 내부 로드 밸런서를 생성하려면 internal을(를) 지정합니다. public 또는 internal 이외의 값을 지정하면 Elastic Beanstalk에서 해당 값을 무시합니다.

public

public

internal

DBSubnets

데이터베이스 서브넷의 ID를 포함합니다. 이는 Amazon RDS DB 인스턴스를 애플리케이션의 일부로 추가하려는 경우에만 사용됩니다. 서브넷이 여러 개인 경우 이 값은 서브넷 ID의 쉼표로 구분된 단일 문자열로 지정합니다(예: "subnet-11111111,subnet-22222222").

없음

AssociatePublicIpAddress

Amazon VPC에서 퍼블릭 IP 주소를 사용하는 인스턴스를 시작할지 여부를 지정합니다. 퍼블릭 IP 주소가 있으면 인스턴스는 인터넷과 통신하는 데 NAT 장치가 필요하지 않습니다. 단일 퍼블릭 서브넷에 로드 밸런서와 인스턴스를 포함하려면 이 값을 true로 설정해야 합니다.

이 옵션은 단일 인스턴스 환경에 영향을 미치지 않습니다. 단일 인스턴스 환경에는 항상 탄력적 IP 주소가 있는 단일 Amazon EC2 인스턴스가 있습니다. 이 옵션은 로드 밸런싱 수행 및 확장 가능 환경인 경우에 사용됩니다.

없음

true

false

aws:elasticbeanstalk:application

애플리케이션에 대한 상태 확인 경로를 구성합니다. 자세한 내용은 기본 상태 보고을(를) 참조하세요.

네임스페이스: aws:elasticbeanstalk:application
이름 설명 기본값 유효값

애플리케이션 상태 점검 URL

상태 확인 요청이 전송되는 경로입니다. 이 경로가 설정되지 않은 경우 로드 밸런서는 포트 80에서 TCP 연결을 시도하여 애플리케이션의 상태를 확인합니다. /로 시작하는 경로로 설정하여 HTTP GET 요청을 해당 경로에 보냅니다. 경로 앞에 프로토콜(HTTP, HTTPS, TCP 또는 SSL)과 포트를 포함시켜 HTTPS 연결을 확인하거나 기본 포트가 아닌 다른 포트를 사용할 수도 있습니다.

참고

Elastic Beanstalk 콘솔을 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔이 이 옵션을 권장 값으로 재정의합니다.

없음

유효한 값으로는 다음이 포함됩니다.

/(루트 경로에 대한 HTTP GET)

/health

HTTPS:443/

HTTPS:443/health

EB CLI 및 Elastic Beanstalk 콘솔에서 위의 옵션에 대한 권장 값을 적용합니다. 구성 파일을 사용해 동일하게 구성하고자 하는 경우 이러한 설정을 제거해야 합니다. 세부 정보는 권장 값 단원을 참조하십시오.

aws:elasticbeanstalk:application:environment

애플리케이션의 환경 속성을 구성합니다.

네임스페이스: aws:elasticbeanstalk:application:environment
이름 설명 기본값 유효값

환경 변수 이름

키-값 페어의 형태로 전달됩니다.

없음

환경 변수 값

자세한 정보는 환경 속성 및 기타 소프트웨어 설정 섹션을 참조하세요.

aws:elasticbeanstalk:cloudwatch:logs

애플리케이션에 대한 인스턴스 로그 스트리밍을 구성합니다.

네임스페이스: aws:elasticbeanstalk:cloudwatch:logs
이름 설명 기본값 유효값

StreamLogs

프록시 및 배포 로그에 대한 그룹을 CloudWatch Logs에 만들어 환경의 각 인스턴스에서 로그를 스트리밍할지 여부를 지정합니다.

false

true

false

DeleteOnTerminate

환경을 종료할 때 로그 그룹을 삭제할지 여부를 지정합니다. false인 경우 로그는 RetentionInDays일 동안 유지됩니다.

false

true

false

RetentionInDays

만료 전 로그 이벤트를 유지할 일수입니다.

7

1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, 3653

aws:elasticbeanstalk:cloudwatch:logs:health

애플리케이션에 대한 환경 상태 로그 스트리밍을 구성합니다.

네임스페이스: aws:elasticbeanstalk:cloudwatch:logs:health
이름 설명 기본값 유효값

HealthStreamingEnabled

확장 상태 보고를 활성화한 환경의 경우, CloudWatch Logs에 환경 상태를 위한 그룹을 생성할지 여부와 Elastic Beanstalk 환경 상태 데이터를 아카이브할지 여부를 지정합니다. 확장 상태 활성화에 대한 자세한 내용은 aws:elasticbeanstalk:healthreporting:system 단원을 참조하십시오.

false

true

false

DeleteOnTerminate

환경을 종료할 때 로그 그룹을 삭제할지 여부를 지정합니다. false인 경우 상태 데이터는 RetentionInDays일 동안 유지됩니다.

false

true

false

RetentionInDays

만료하기 전에, 아카이브된 상태 데이터를 유지하는 일수.

7

1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, 3653

aws:elasticbeanstalk:command

애플리케이션 코드에 대한 배포 정책을 구성합니다. 자세한 내용은 정책 및 설정 배포을(를) 참조하세요.

네임스페이스: aws:elasticbeanstalk:command
이름 설명 기본값 유효값

DeploymentPolicy

애플리케이션 버전 배포에 대한 배포 정책을 선택합니다.

참고

Elastic Beanstalk 콘솔을 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔이 이 옵션을 권장 값으로 재정의합니다.

AllAtOnce

AllAtOnce

Rolling

RollingWithAdditionalBatch

Immutable

TrafficSplitting

Timeout

인스턴스가 명령 실행을 완료할 때까지 대기하는 시간(초)입니다.

Elastic Beanstalk에서 내부적으로 Timeout 값에 240초(4분)를 추가합니다. 예를 들어 기본 유효 제한 시간은 840초(600 + 240) 또는 14분입니다.

600

1~3600

BatchSizeType

BatchSize에 지정된 숫자 유형입니다.

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 재정의합니다.

Percentage

Percentage

Fixed

BatchSize

배포를 동시에 수행하는 Auto Scaling 그룹 내 Amazon EC2 인스턴스의 비율 또는 고정된 수입니다. 유효한 값은 사용된 BatchSizeType 설정에 따라 다릅니다.

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 재정의합니다.

100

1~100(Percentage).

1~aws:autoscaling:asg::MaxSize(Fixed)

IgnoreHealthCheck

실패한 상태 확인으로 인해 배포를 취소하지 마세요.

 false

true

false

aws:elasticbeanstalk:environment

환경의 아키텍처 및 서비스 역할을 구성합니다.

네임스페이스: aws:elasticbeanstalk:environment
이름 설명 기본값 유효값

EnvironmentType

SingleInstance을 설정하여 로드 밸런서 없이 EC2 인스턴스 하나를 시작합니다.

LoadBalanced

SingleInstance

LoadBalanced

ServiceRole

Elastic Beanstalk에서 환경의 리소스를 관리하는 데 사용하는 IAM 역할의 이름입니다. 역할 이름(선택적으로 사용자 지정 경로 앞에 옴) 또는 그 ARN을 지정합니다.

예제:

  • aws-elasticbeanstalk-service-role

  • custom-path/custom-role

  • arn:aws:iam::123456789012:role/aws-elasticbeanstalk-service-role

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 재정의합니다.

없음

IAM 역할 이름, 경로/이름 또는 ARN

LoadBalancerType

사용자의 환경에 대한 로드 밸런서의 유형입니다. 자세한 내용은 Elastic Beanstalk 환경의 로드 밸런서을(를) 참조하세요.

classic

classic

application

network

LoadBalancerIsShared

환경의 로드 밸런서를 전용으로 할지 공유할지 여부를 지정합니다. 이 옵션은 Application Load Balancer에만 설정할 수 있습니다. 환경 생성 후에는 변경할 수 없습니다.

false이면 환경이 Elastic Beanstalk에 의해 생성 및 관리되는 자체 전용 로드 밸런서를 갖습니다. true이면 환경이 사용자가 생성하고 aws:elbv2:loadbalancer 네임스페이스의 SharedLoadBalancer 옵션에 지정된 공유 로드 밸런서를 사용합니다.

false

true

false

aws:elasticbeanstalk:environment:process:default

환경의 기본 프로세스를 구성합니다.

네임스페이스: aws:elasticbeanstalk:environment:process:default
이름 설명 기본값 유효값

DeregistrationDelay

등록 취소하기 전에 활성 요청이 완료될 때까지 대기하는 시간(초)입니다.

20

0~3600

HealthCheckInterval

Elastic Load Balancing이 애플리케이션의 Amazon EC2 인스턴스 상태를 확인하는 시간 간격(초)입니다.

Classic 또는 Application Load Balancer 사용 시: 15

Network Load Balancer 사용 시: 30

Classic 또는 Application Load Balancer 사용 시: 5 ~ 300

Network Load Balancer 사용 시: 10, 30

HealthCheckPath

상태 확인에 대한 HTTP 요청이 전송되는 경로입니다.

/

라우팅 가능 경로

HealthCheckTimeout

상태 확인 중 응답 대기 시간(초)입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

5

1~60

HealthyThresholdCount

Elastic Load Balancing에서 인스턴스 상태를 변경하기 전 연속 성공 요청 수입니다.

Classic 또는 Application Load Balancer 사용 시: 3

Network Load Balancer 사용 시: 5

2~10

MatcherHTTPCode

인스턴스 상태가 정상임을 나타내는 HTTP 코드 목록(쉼표로 구분된 목록).

이 옵션은 Network Load Balancer 또는 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

200

Application Load Balancer 사용 시: 200 ~ 499

Network Load Balancer 사용 시: 200 ~ 399

Port

프로세스가 수신 대기하는 포트입니다.

80

1~65535

Protocol

프로세스에서 사용하는 프로토콜입니다.

Application Load Balancer를 사용하는 경우 이 옵션을 HTTP 또는 HTTPS로만 설정할 수 있습니다.

Network Load Balancer를 사용하는 경우 이 옵션을 TCP로만 설정할 수 있습니다.

Classic 또는 Application Load Balancer 사용 시: HTTP

Network Load Balancer 사용 시: TCP

TCP

HTTP

HTTPS

StickinessEnabled

true로 설정하면 고정 세션이 활성화됩니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

'false'

'false'

'true'

StickinessLBCookieDuration

고정 세션 쿠키의 수명 주기(초)입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

86400(1일)

1~604800

StickinessType

lb_cookie로 설정하면 고정 세션에 쿠키를 사용합니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

lb_cookie

lb_cookie

UnhealthyThresholdCount

Elastic Load Balancing에서 인스턴스 상태를 변경하기 전 연속 실패 요청 수입니다.

5

2~10

aws:elasticbeanstalk:environment:process:process_name

환경에 대한 추가 프로세스를 구성합니다.

네임스페이스: aws:elasticbeanstalk:environment:process:process_name
이름 설명 기본값 유효값

DeregistrationDelay

등록 취소하기 전에 활성 요청이 완료될 때까지 대기하는 시간(초)입니다.

20

0~3600

HealthCheckInterval

Elastic Load Balancing이 애플리케이션의 Amazon EC2 인스턴스 상태를 확인하는 간격(초)입니다.

Classic 또는 Application Load Balancer 사용 시: 15

Network Load Balancer 사용 시: 30

Classic 또는 Application Load Balancer 사용 시: 5 ~ 300

Network Load Balancer 사용 시: 10, 30

HealthCheckPath

상태 확인에 대한 HTTP 요청이 전송되는 경로입니다.

/

라우팅 가능 경로

HealthCheckTimeout

상태 확인 중 응답 대기 시간(초)입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

5

1~60

HealthyThresholdCount

Elastic Load Balancing에서 인스턴스 상태를 변경하기 전 연속 성공 요청 수입니다.

Classic 또는 Application Load Balancer 사용 시: 3

Network Load Balancer 사용 시: 5

2~10

MatcherHTTPCode

인스턴스 상태가 정상임을 나타내는 HTTP 코드 목록(쉼표로 구분된 목록)입니다.

이 옵션은 Network Load Balancer 또는 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

200

Application Load Balancer 사용 시: 200 ~ 499

Network Load Balancer 사용 시: 200 ~ 399

Port

프로세스가 수신 대기하는 포트입니다.

80

1~65535

Protocol

프로세스에서 사용하는 프로토콜입니다.

Application Load Balancer를 사용하는 경우 이 옵션을 HTTP 또는 HTTPS로만 설정할 수 있습니다.

Network Load Balancer를 사용하는 경우 이 옵션을 TCP로만 설정할 수 있습니다.

Classic 또는 Application Load Balancer 사용 시: HTTP

Network Load Balancer 사용 시: TCP

TCP

HTTP

HTTPS

StickinessEnabled

true로 설정하면 고정 세션이 활성화됩니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

'false'

'false'

'true'

StickinessLBCookieDuration

고정 세션 쿠키의 수명 주기(초)입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

86400(1일)

1~604800

StickinessType

lb_cookie로 설정하면 고정 세션에 쿠키를 사용합니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

lb_cookie

lb_cookie

UnhealthyThresholdCount

Elastic Load Balancing에서 인스턴스 상태를 변경하기 전 연속 실패 요청 수입니다.

5

2~10

aws:elasticbeanstalk:environment:proxy:staticfiles

다음 네임스페이스를 사용하여 정적 파일을 제공하도록 프록시 서버를 구성할 수 있습니다. 프록시 서버가 지정된 경로에서 파일 요청을 수신하면 요청을 애플리케이션으로 라우팅하는 대신 파일을 직접 제공합니다. 따라서 애플리케이션에서 처리해야 하는 요청 수가 줄어듭니다.

프록시 서버가 제공하는 경로를 정적 자산이 포함된 소스 코드의 폴더에 매핑합니다. 이 네임스페이스에서 정의하는 각 옵션은 다른 경로를 매핑합니다.

참고

이 네임스페이스는 Amazon Linux 2 이상에 기반한 플랫폼 브랜치에 적용됩니다. 사용자 환경에서 Amazon Linux AMI(이전 Amazon Linux 2)에 기반한 플랫폼 버전을 사용하는 경우 플랫폼별 정적 파일 네임스페이스와 관련하여 플랫폼별 옵션을 참조하십시오.

네임스페이스: aws:elasticbeanstalk:environment:proxy:staticfiles
이름 값

프록시 서버가 파일을 제공하는 경로입니다. /로 값을 시작합니다.

예를 들어 /images에서 파일을 제공하도록 subdomain.eleasticbeanstalk.com/images을(를) 지정합니다.

파일이 포함된 폴더의 이름입니다.

예를 들어 소스 번들의 최상위 레벨에 있는 staticimages(이)라는 폴더에서 파일을 제공하도록 staticimages을(를) 지정합니다.

aws:elasticbeanstalk:healthreporting:system

환경에 대해 강화된 상태 보고 서비스를 구성합니다.

네임스페이스: aws:elasticbeanstalk:healthreporting:system
이름 설명 기본값 유효값

SystemType

상태 보고 시스템(기본 또는 고급)입니다. 확장된 상태 보고에는 서비스 역할 및 버전 2 또는 최신 플랫폼 버전이 필요합니다.

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 덮어씁니다.

basic

basic

enhanced

ConfigDocument CloudWatch에 게시할 환경 및 인스턴스 측정치를 설명하는 JSON 문서입니다. 없음

EnhancedHealthAuthEnabled

Elastic Beanstalk가 환경 인스턴스에서 Elastic Beanstalk 서비스로 확장 상태 정보를 전달하는 데 사용하는 내부 API에 대한 권한 부여를 활성화합니다.

자세한 내용은 향상된 상태 역할을(를) 참조하세요.

참고

이 옵션은 확장된 상태 보고(SystemType이 enhanced로 설정된 경우 등)에만 적용할 수 있습니다.

true

true

false

HealthCheckSuccessThreshold

인스턴스가 상태 확인 통과를 위해 임계값을 낮춥니다.

참고

Elastic Beanstalk 콘솔을 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔이 이 옵션을 권장 값으로 재정의합니다.

Ok

Ok

Warning

Degraded

Severe

aws:elasticbeanstalk:hostmanager

Amazon S3에 교체된 로그를 업로드하도록 환경의 EC2 인스턴스를 구성합니다.

네임스페이스: aws:elasticbeanstalk:hostmanager
이름 설명 기본값 유효값

LogPublicationControl

애플리케이션에 연결된 Amazon S3 버킷에 애플리케이션의 Amazon EC2 인스턴스에 대한 로그 파일을 복사합니다.

false

true

false

aws:elasticbeanstalk:managedactions

환경에 대한 관리형 플랫폼 업데이트를 구성합니다.

네임스페이스: aws:elasticbeanstalk:managedactions
이름 설명 기본값 유효값

ManagedActionsEnabled

관리형 플랫폼 업데이트를 활성화합니다.

true로 설정하면 PreferredStartTime 및 UpdateLevel로 지정해야 합니다.

false

true

false

PreferredStartTime

관리형 작업에 대한 유지 관리 기간을 UTC로 구성합니다.

예: "Tue:09:00".

없음

날짜 및 시간 형식

일:시:분

형식

ServiceRoleForManagedUpdates

Elastic Beanstalk가 환경에서 관리형 플랫폼 업데이트를 수행하는 데 사용하는 IAM 역할의 이름입니다.

ServiceRole 네임스페이스의 aws:elasticbeanstalk:environment 옵션에 지정한 동일한 역할 또는 본인 계정의 관리형 업데이트 서비스 연결 역할을 사용할 수 있습니다. 후자의 경우, 계정에 관리형 업데이트 서비스 연결 역할이 아직 없으면 Elastic Beanstalk가 생성합니다.

없음

ServiceRole과 동일

또는

AWSServiceRoleForElasticBeanstalkManagedUpdates

aws:elasticbeanstalk:managedactions:platformupdate

환경에 대한 관리형 플랫폼 업데이트를 구성합니다.

네임스페이스: aws:elasticbeanstalk:managedactions:platformupdate
이름 설명 기본값 유효값

UpdateLevel

관리형 플랫폼 업데이트 사용 시 적용할 가장 높은 업데이트 수준입니다. 플랫폼 버전은 major.minor.patch의 순서로 지정됩니다. 예를 들어, 버전이 2.0.8이면 2는 메이저 버전, 0은 마이너 버전 그리고 8은 패치 버전입니다.

없음

patch(패치 버전 업데이트에만 해당)

minor(마이너 및 패치 버전 업데이트 둘 다에 해당)

InstanceRefreshEnabled

주별 인스턴스 대체를 활성화합니다.

ManagedActionsEnabled을 true로 설정해야 합니다.

 false

true

false

aws:elasticbeanstalk:monitoring

상태 확인에 실패한 EC2 인스턴스를 종료하도록 환경을 구성합니다.

네임스페이스: aws:elasticbeanstalk:monitoring
이름 설명 기본값 유효값

Automatically Terminate Unhealthy Instances

상태 확인에 실패하면 인스턴스를 종료합니다.

참고

이 옵션은 레거시 환경에서만 지원됩니다. 이는 도달 가능성과 기타 인스턴스 관련 측정치를 토대로 인스턴스의 상태를 확인합니다.

Elastic Beanstalk는 애플리케이션의 상태에 따라 인스턴스를 자동 종료할 방법을 제공하지 않습니다.

true

true

false

aws:elasticbeanstalk:sns:topics

환경에 대한 알림을 구성합니다.

네임스페이스: aws:elasticbeanstalk:sns:topics
이름 설명 기본값 유효값

Notification Endpoint

애플리케이션에 영향을 미치는 중요한 이벤트를 알리려는 엔드포인트입니다.

참고

Elastic Beanstalk 콘솔을 통해 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔이 이 옵션을 권장 값으로 재정의합니다.

없음

Notification Protocol

엔드포인트로 알림을 전송하는 데 사용하는 프로토콜입니다.

email

http

https

email

email-json

sqs

Notification Topic ARN

구독하는 주제에 대한 Amazon 리소스 이름(ARN)입니다.

없음

Notification Topic Name

구독하는 주제 이름입니다.

없음

aws:elasticbeanstalk:sqsd

작업자 환경을 위한 Amazon SQS 대기열을 구성합니다.

네임스페이스: aws:elasticbeanstalk:sqsd
이름 설명 기본값 유효값

WorkerQueueURL

작업자 환경 티어의 데몬이 메시지를 읽는 대기열의 URL입니다.

참고

값을 지정하지 않으면 Elastic Beanstalk가 자동으로 생성하는 대기열이 표준 Amazon SQS 대기열입니다. 값을 제공하면 표준 또는 FIFO Amazon SQS 대기열의 URL을 제공할 수 있습니다. FIFO 대기열을 제공하면 정기적인 작업이 지원되지 않습니다.

자동으로 생성됨

값을 지정하지 않으면 Elastic Beanstalk이 대기열을 자동으로 생성합니다.

HttpPath

HTTP POST 메시지가 전송되는 애플리케이션의 상대 경로입니다.

/

MimeType

HTTP POST 요청으로 전송되는 메시지의 MIME 유형입니다.

application/json

application/json

application/x-www-form-urlencoded

application/xml

text/plain

사용자 지정 MIME 유형

HttpConnections

Amazon EC2 인스턴스 내에서 애플리케이션에 대한 최대 동시 접속 수입니다.

참고

Elastic Beanstalk 콘솔을 통해 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔이 이 옵션을 권장 값으로 재정의합니다.

50

1~100

ConnectTimeout

애플리케이션에 연결하기 위해 대기하는 시간(초)입니다.

5

1~60

InactivityTimeout

기존 애플리케이션 연결에 대한 응답을 대기하는 시간(초)입니다.

대몬(daemon)이 작업자 환경 애플리케이션에서 200 (OK) 응답을 수신하거나 RetentionPeriod이(가) 만료될 때까지 메시지가 다시 처리됩니다.

299

1~36000

VisibilityTimeout

처리를 위해 Amazon SQS 대기열에서 수신되는 메시지를 잠그는 시간(초)입니다. 구성된 시간이 경과한 이후에는 다른 데몬에서 읽을 수 있도록 메시지가 대기열에 다시 표시됩니다.

300

0~43200

ErrorVisibilityTimeout

명시적인 오류로 인해 처리 시도가 실패한 이후에 Elastic Beanstalk에서 메시지를 Amazon SQS 대기열로 반환할 때까지 경과하는 시간(초)입니다.

2초

0~43200초

RetentionPeriod

메시지가 유효하고 능동적으로 처리되는 시간(초)입니다.

345600

60~1209600

MaxRetries

Elastic Beanstalk에서 메시지를 배달 못한 편지 대기열로 이동하기 전에 메시지를 처리할 웹 애플리케이션으로 메시지 전송을 시도하는 최대 횟수입니다.

10

1~100

aws:elasticbeanstalk:trafficsplitting

환경에 대한 트래픽 분할 배포를 구성합니다.

이 네임스페이스는 aws:elasticbeanstalk:command 네임스페이스의 DeploymentPolicy 옵션을 TrafficSplitting으로 설정할 때 적용됩니다. 배포 정책에 대한 자세한 내용은 정책 및 설정 배포을 참조하십시오.

네임스페이스: aws:elasticbeanstalk:trafficsplitting
이름 설명 기본값 유효값

NewVersionPercent

Elastic Beanstalk가 수신되는 클라이언트 트래픽을 배포할 새 애플리케이션 버전을 실행하는 환경 인스턴스로 전환하는 초기 비율입니다.

10

1~100

EvaluationTime

Elastic Beanstalk가 모든 수신 클라이언트 트래픽을 배포할 새 애플리케이션 버전으로 전환하기 전에 초기 정상 배포 후에 대기하는 시간(분)입니다.

5

3~600

aws:elasticbeanstalk:xray

AWS X-Ray 데몬을 실행하여 X-Ray 통합 애플리케이션의 트레이스 정보를 전달합니다.

네임스페이스: aws:elasticbeanstalk:xray
이름 설명 기본값 유효값

XRayEnabled

true로 설정하면 환경 인스턴스에서 X-Ray 대몬(daemon)이 실행됩니다.

false

true

false

aws:elb:healthcheck

Classic Load Balancer에 대한 상태 확인을 구성합니다.

네임스페이스: aws:elb:healthcheck
이름 설명 기본값 유효값

HealthyThreshold

Elastic Load Balancing에서 인스턴스 상태를 변경하기 전 연속 성공 요청 수입니다.

3

2~10

Interval

Elastic Load Balancing이 애플리케이션의 Amazon EC2 인스턴스의 상태를 확인하는 간격입니다.

10

5~300

Timeout

Elastic Load Balancing이 인스턴스가 응답하지 않는 것으로 간주되기 전에 응답을 기다리는 시간(초)입니다.

5

2~60

UnhealthyThreshold

Elastic Load Balancing에서 인스턴스 상태를 변경하기 전 연속 실패 요청 수입니다.

5

2~10

(사용되지 않음)Target

상태 확인이 전송되는 백엔드 인스턴스 대상입니다. 대신 Application Healthcheck URL 네임스페이스의 aws:elasticbeanstalk:application을 사용합니다.

TCP:80

대상의 형식은 PROTOCOL:PORT/PATH입니다.

aws:elb:loadbalancer

환경의 Classic Load Balancer를 구성합니다.

이 네임스페이스의 여러 옵션은 더 이상 지원되지 않으며 aws:elb:listener 네임스페이스의 리스너별 옵션으로 대체되었습니다. 더 이상 지원되지 않는 이러한 옵션을 통해서는 표준 포트에서 두 개의 리스너(보안 리스너 하나와 비보안 리스너 하나)만 구성할 수 있습니다.

네임스페이스: aws:elb:loadbalancer
이름 설명 기본값 유효한 값

CrossZone

각 가용 영역 내에서 만이 아니라 모든 가용 영역 내의 모든 인스턴스 간에 트래픽을 균등하게 라우팅하도록 로드 밸런서를 구성합니다.

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 재정의합니다.

false

true

false

SecurityGroups

생성한 하나 이상의 보안 그룹을 로드 밸런서에 할당합니다.

없음

하나 이상의 보안 그룹 ID
ManagedSecurityGroup

새 보안 그룹을 만드는 대신, 환경의 로드 밸런서에 기존 보안 그룹을 할당합니다. 이 설정을 사용하려면 이 네임스페이스의 SecurityGroups 설정을 업데이트하여 보안 그룹의 ID를 포함하고 자동 생성된 보안 그룹 ID(생성된 경우)를 제거합니다.

로드 밸런서의 트래픽을 환경의 EC2 인스턴스로 보내도록 허용하기 위해 Elastic Beanstalk에서는 관리형 보안 그룹의 인바운드 트래픽을 허용하는 규칙을 인스턴스의 보안 그룹에 추가합니다.

 없음 보안 그룹 ID

(사용되지 않음)LoadBalancerHTTPPort

 비보안 리스너의 수신 포트입니다.

80

OFF

80

(사용되지 않음)LoadBalancerPortProtocol

비보안 리스너에서 사용하는 프로토콜입니다.

HTTP

HTTP

TCP

(사용되지 않음)LoadBalancerHTTPSPort

 보안 리스너의 수신 포트입니다.

OFF

OFF

443

8443

(사용되지 않음)LoadBalancerSSLPortProtocol

 보안 리스너에서 사용하는 프로토콜입니다.

HTTPS

HTTPS

SSL

(사용되지 않음)SSLCertificateId

 보안 리스너에 바인딩할 SSL 인증서의 Amazon 리소스 이름(ARN)입니다.

없음

aws:elb:listener

Classic Load Balancer에 대해 기본 리스너(포트 80)를 구성합니다.

네임스페이스: aws:elb:listener
이름 설명 기본값 유효한 값
ListenerProtocol 리스너가 사용하는 프로토콜입니다. HTTP HTTP TCP
InstancePort 이 리스너가 EC2 인스턴스와의 통신에 사용하는 포트입니다. 80 1~65535
InstanceProtocol

이 리스너가 EC2 인스턴스와의 통신에 사용하는 프로토콜입니다.

ListenerProtocol과 동일한 인터넷 프로토콜 계층이어야 합니다. 또한 이 리스너와 동일한 InstancePort를 사용하는 다른 리스너와 동일한 보안 수준이어야 합니다.

예를 들어 ListenerProtocol이 HTTPS(애플리케이션 계층, 보안 연결 사용)인 경우 InstanceProtocol을 HTTP(애플리케이션 계층, 비보안 연결 사용)로 설정할 수 있습니다. 또한 InstancePort를 80으로 설정할 경우 InstanceProtocol가 HTTP으로 설정된 다른 모든 리스너에서 InstancePort을 80로 설정합니다.

HTTP(ListenerProtocol이 HTTP인 경우)

TCP(ListenerProtocol이 TCP인 경우)

 HTTP 또는 HTTPS(ListenerProtocol이 HTTP 또는 HTTPS인 경우)

TCP 또는 SSL(ListenerProtocol이 TCP 또는 SSL인 경우)
PolicyNames 리스너의 포트에 적용할, 쉼표로 구분된 정책 목록입니다. 대신 aws:elb:policies 네임스페이스의 LoadBalancerPorts 옵션을 사용하는 것이 좋습니다. 없음
ListenerEnabled 이 리스너가 활성화되는지 여부를 지정합니다. false을 지정하면 로드 밸런서에 리스너가 포함되지 않습니다. true

true

false

aws:elb:listener:listener_port

Classic Load Balancer에 대한 추가 리스너를 구성합니다.

네임스페이스: aws:elb:listener:listener_port
이름 설명 기본값 유효한 값

ListenerProtocol

 리스너가 사용하는 프로토콜입니다. HTTP HTTP HTTPS TCP SSL

InstancePort

 이 리스너가 EC2 인스턴스와의 통신에 사용하는 포트입니다. listener_port와 동일함 1~65535

InstanceProtocol

이 리스너가 EC2 인스턴스와의 통신에 사용하는 프로토콜입니다.

ListenerProtocol과 동일한 인터넷 프로토콜 계층이어야 합니다. 또한 이 리스너와 동일한 InstancePort를 사용하는 다른 리스너와 동일한 보안 수준이어야 합니다.

예를 들어 ListenerProtocol이 HTTPS(애플리케이션 계층, 보안 연결 사용)인 경우 InstanceProtocol을 HTTP(애플리케이션 계층, 비보안 연결 사용)로 설정할 수 있습니다. 또한 InstancePort를 80으로 설정할 경우 InstanceProtocol가 HTTP으로 설정된 다른 모든 리스너에서 InstancePort을 80로 설정합니다.

HTTP(ListenerProtocol이 HTTP 또는 HTTPS인 경우)

TCP(ListenerProtocol이 TCP 또는 SSL인 경우)

 HTTP 또는 HTTPS(ListenerProtocol이 HTTP 또는 HTTPS인 경우)

TCP 또는 SSL(ListenerProtocol이 TCP 또는 SSL인 경우)

PolicyNames

 리스너의 포트에 적용할, 쉼표로 구분된 정책 목록입니다. 대신 aws:elb:policies 네임스페이스의 LoadBalancerPorts 옵션을 사용하는 것이 좋습니다. 없음

SSLCertificateId

 리스너에 바인딩할 SSL 인증서의 Amazon 리소스 이름(ARN)입니다.

없음

ListenerEnabled

 이 리스너가 활성화되는지 여부를 지정합니다. false을 지정하면 로드 밸런서에 리스너가 포함되지 않습니다. 다른 옵션이 설정된 경우 true이고, 그렇지 않으면 false입니다. true false

aws:elb:policies

Classic Load Balancer에 대한 기본 고정 및 글로벌 로드 밸런서 정책을 수정합니다.

네임스페이스: aws:elb:policies
이름 설명 기본값 유효값

ConnectionDrainingEnabled

비정상 상태가 되었거나 진행 중인 요청을 완료하기 위해 등록 취소된 인스턴스에 대한 기존 연결을 로드 밸런서에서 유지할지 여부를 지정합니다.

참고

Elastic Beanstalk 콘솔 또는 EB CLI를 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔과 EB CLI가 이 옵션을권장 값으로 재정의합니다.

false

true

false

ConnectionDrainingTimeout

연결을 강제로 종료하기 전에 Connection Draining 중 로드 밸런서에서 인스턴스에 대한 기존 연결을 유지할 최대 시간(초)입니다.

참고

Elastic Beanstalk 콘솔을 사용하여 환경을 생성하는 경우 구성 파일에서 이 옵션을 설정할 수 없습니다. 콘솔이 이 옵션을 권장 값으로 재정의합니다.

20

1~3600

ConnectionSettingIdleTimeout

로드 밸런서가 연결을 통해 데이터를 전송 또는 수신하기 위해 대기하는 시간(초)입니다. 이 기간이 경과한 이후 데이터가 전송되거나 전송 또는 수신되지 않으면 로드 밸런서는 연결을 종료합니다.

60

1~3600
LoadBalancerPorts

기본 정책(AWSEB-ELB-StickinessPolicy)이 적용되는 쉼표로 구분된 리스너 포트 목록입니다.

 없음 :all을 사용하여 모든 리스너 포트를 표시할 수 있습니다.

Stickiness Cookie Expiration

각 쿠키가 유효한 시간(초)입니다. 기본 정책(AWSEB-ELB-StickinessPolicy)을 사용합니다.

0

0~1000000

Stickiness Policy

세션 중에 사용자로부터 나오는 모든 요청이 동일한 서버 인스턴스로 전송되도록 사용자 세션을 특정 서버 인스턴스에 바인딩합니다. 기본 정책(AWSEB-ELB-StickinessPolicy)을 사용합니다.

false

true false

aws:elb:policies:policy_name

Classic Load Balancer에 대한 추가 로드 밸런서 정책을 생성합니다.

네임스페이스: aws:elb:policies:policy_name
이름 설명 기본값 유효값

CookieName

 AppCookieStickinessPolicyType 정책의 세션 수명 주기를 제어하는 애플리케이션 생성 쿠키의 이름입니다. 이러한 정책은 HTTP/HTTPS 리스너에만 연결할 수 있습니다. 없음

InstancePorts

이 정책이 적용되는 쉼표로 구분된 인스턴스 포트 목록입니다.

 없음 포트 목록 또는 :all

LoadBalancerPorts

이 정책이 적용되는 쉼표로 구분된 리스너 포트 목록입니다.

 없음 포트 목록 또는 :all

ProxyProtocol

ProxyProtocolPolicyType 정책의 경우 TCP 메시지의 원본 요청 IP 주소 및 포트를 포함할지 여부를 지정합니다. 이 정책은 TCP/SSL 리스너에만 연결할 수 있습니다.

 없음 true false

PublicKey

백엔드 서버를 인증할 때 사용하는 PublicKeyPolicyType 정책에 대한 퍼블릭 키의 내용입니다. 이 정책은 백엔드 서버 또는 리스너에 직접 적용할 수 없습니다. BackendServerAuthenticationPolicyType 정책의 일부여야 합니다.

 없음

PublicKeyPolicyNames

백엔드 서버에 대한 인증을 제어하는 PublicKeyPolicyType 정책 이름 목록으로, 쉼표로 구분됩니다(BackendServerAuthenticationPolicyType 정책에서 가져옴). 이 정책은 HTTPS/SSL을 사용하는 백엔드 서버에만 연결할 수 있습니다.

 없음

SSLProtocols

로드 밸런서가 수락하는 암호 및 프로토콜을 정의하는 SSLNegotiationPolicyType 정책에 대해 활성화할 SSL 프로토콜 목록으로, 쉼표로 구분됩니다. 이 정책은 HTTPS/SSL 리스너에만 연결할 수 있습니다.

 없음

SSLReferencePolicy

AWS 보안 모범 사례를 따르고, 로드 밸런서에서 수락되는 암호 및 프로토콜을 정의하는 SSLNegotiationPolicyType 정책에 대해 활성화할 사전 정의된 보안 정책의 이름입니다. 이 정책은 HTTPS/SSL 리스너에만 연결할 수 있습니다.

 없음

Stickiness Cookie Expiration

각 쿠키가 유효한 시간(초)입니다.

0

0~1000000

Stickiness Policy

세션 중에 사용자로부터 나오는 모든 요청이 동일한 서버 인스턴스로 전송되도록 사용자 세션을 특정 서버 인스턴스에 바인딩합니다.

false

true false

aws:elbv2:listener:default

Application Load Balancer 또는 Network Load Balancer에서 기본 리스너(포트 80)를 구성합니다.

이 네임스페이스는 공유 로드 밸런서를 사용하는 환경에는 적용되지 않습니다. 공유 로드 밸런서에는 기본 리스너가 없습니다.

네임스페이스: aws:elbv2:listener:default
이름 설명 기본값 유효값

DefaultProcess

일치하는 규칙이 없는 경우 트래픽을 전달할 프로세스의 이름입니다.

default

프로세스 이름

ListenerEnabled

false로 설정하면 리스너가 비활성화됩니다. 이 옵션을 사용하여 포트 80에서 기본 리스너를 비활성화할 수 있습니다.

true

true

false

Protocol

처리할 트래픽의 프로토콜입니다.

Application Load Balancer 사용 시: HTTP

Network Load Balancer 사용 시: TCP

Application Load Balancer 사용 시: HTTP, HTTPS

Network Load Balancer 사용 시: TCP

Rules

리스너에 적용할 규칙 목록입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

없음

쉼표로 구분된 규칙 이름 목록입니다.

SSLCertificateArns

리스너에 바인딩할 SSL 인증서의 Amazon 리소스 이름(ARN) 입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

없음

IAM 또는 ACM에 저장된 인증서의 ARN

SSLPolicy

리스너에 적용할 보안 정책을 지정합니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

 없음(ELB 기본값)

로드 밸런서 보안 정책의 이름

aws:elbv2:listener:listener_port

Application Load Balancer 또는 Network Load Balancer에서 추가 리스너를 구성합니다.

참고

공유 Application Load Balancer의 경우 Rule 옵션만 지정할 수 있습니다. 다른 옵션은 공유 로드 밸런서에는 적용되지 않습니다.

네임스페이스: aws:elbv2:listener:listener_port
이름 설명 기본값 유효값

DefaultProcess

일치하는 규칙이 없는 경우 트래픽이 전달되는 프로세스의 이름입니다.

default

프로세스 이름

ListenerEnabled

false로 설정하면 리스너가 비활성화됩니다. 이 옵션을 사용하여 포트 80에서 기본 리스너를 비활성화할 수 있습니다.

true

true

false

Protocol

처리할 트래픽의 프로토콜입니다.

Application Load Balancer 사용 시: HTTP

Network Load Balancer 사용 시: TCP

Application Load Balancer 사용 시: HTTP, HTTPS

Network Load Balancer 사용 시: TCP

Rules

리스너에 적용할 규칙 목록입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

사용자 환경에서 공유 Application Load Balancer를 사용하고 리스너에 이 옵션을 지정하지 않은 경우 Elastic Beanstalk는 default 규칙을 포트 80 리스너에 자동으로 연결합니다.

없음

쉼표로 구분된 규칙 이름 목록입니다.

SSLCertificateArns

리스너에 바인딩할 SSL 인증서의 Amazon 리소스 이름(ARN) 입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

없음

IAM 또는 ACM에 저장된 인증서의 ARN

SSLPolicy

리스너에 적용할 보안 정책을 지정합니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

 없음(ELB 기본값)

로드 밸런서 보안 정책의 이름

aws:elbv2:listenerrule:rule_name

Application Load Balancer의 리스너 규칙을 정의합니다. 요청이 규칙의 호스트 이름 또는 경로와 일치할 경우 로드 밸런서는 요청을 지정된 프로세스로 전달합니다. 규칙을 사용하려면 Rules 옵션을 사용하여 aws:elbv2:listener:listener_port 네임스페이스에서 리스너로 규칙을 추가합니다.

참고

Network Load Balancer를 사용하는 환경에는 이 네임스페이스를 적용할 수 없습니다.

네임스페이스: aws:elbv2:listenerrule:rule_name
이름 설명 기본값 유효값

HostHeaders

일치시킬 호스트 이름 목록입니다. 예: my.example.com.

전용 로드 밸런서: 없음

공유 로드 밸런서: 환경의 CNAME

각 이름은 최대 128자를 포함할 수 있습니다. 패턴에는 대문자와 소문자, 숫자, 하이픈(–) 및 최대 3개의 와일드카드 문자(*은 0개 이상의 문자와 일치하며 ?은 정확히 한 문자와 일치)가 포함될 수 있습니다. 둘 이상의 이름을 쉼표로 구분하여 나열할 수 있습니다. Application Load Balancer는 최대 5개의 HostHeader 및 PathPattern 조합 규칙을 지원합니다.

자세한 내용은 Application Load Balancer 사용 설명서의 호스트 조건을 참조하세요.

PathPatterns

일치시킬 경로 패턴(예: /img/*)입니다.

이 옵션은 Application Load Balancer를 사용하는 환경에만 적용할 수 있습니다.

없음

각 패턴은 최대 128자를 포함할 수 있습니다. 패턴에는 대문자와 소문자, 숫자, 하이픈(–) 및 최대 3개의 와일드카드 문자(*은 0개 이상의 문자와 일치하고 ?은 정확히 한 문자와 일치)가 포함될 수 있습니다. 쉼표로 구분된 여러 경로 패턴을 추가할 수 있습니다. Application Load Balancer는 최대 5개의 HostHeader 및 PathPattern 조합 규칙을 지원합니다.

자세한 내용은 Application Load Balancer 사용 설명서의 경로 조건을 참조하세요.

Priority

여러 규칙이 일치하는 경우 이 규칙이 우선합니다. 번호가 낮을수록 우선 순위가 높습니다. 두 규칙의 우선 순위가 동일할 수는 없습니다.

공유 로드 밸런서를 사용하는 경우 Elastic Beanstalk는 공유 환경 전체에서 규칙 우선 순위를 상대적으로 취급하고 생성 시 절대 우선 순위에 매핑합니다.

1

1~(1000).().

Process

이 규칙이 요청과 일치하는 경우 트래픽을 전달할 프로세스의 이름입니다.

default

프로세스 이름

aws:elbv2:loadbalancer

Application Load Balancer를 구성합니다.

공유 로드 밸런서의 경우 SharedLoadBalancer 및 SecurityGroups 옵션만 유효합니다.

참고

Network Load Balancer를 사용하는 환경에는 이 네임스페이스를 적용할 수 없습니다.

네임스페이스: aws:elbv2:loadbalancer
이름 설명 기본값 유효값

AccessLogsS3Bucket

액세스 로그가 저장되는 Amazon S3 버킷입니다. 이 버킷은 환경과 같은 리전에 있어야 하며 로드 밸런서 쓰기 액세스를 허용해야 합니다.

없음

버킷 이름

AccessLogsS3Enabled

액세스 로그 스토리지를 활성화합니다.

false

true

false

AccessLogsS3Prefix

액세스 로그 이름 앞에 붙는 접두사입니다. 기본적으로 로드 밸런서는 지정한 버킷의 디렉터리 이름 AWSLogs에 로그를 업로드합니다. 다른 디렉터리 내에 AWSLogs 디렉터리를 배치하려면 접두사를 지정하세요.

없음

IdleTimeout

클라이언트 및 인스턴스에 대한 연결을 종료하기 전에 요청이 완료될 때까지 대기하는 시간(초)입니다.

없음

1~3600

ManagedSecurityGroup

새 보안 그룹을 만드는 대신 기존 보안 그룹을 환경의 로드 밸런서에 할당합니다. 이 설정을 사용하려면 이 네임스페이스의 SecurityGroups 설정을 업데이트하여 보안 그룹의 ID를 포함시키고 자동 생성된 보안 그룹의 ID(존재하는 경우)를 제거해야 합니다.

로드 밸런서의 트래픽을 환경의 EC2 인스턴스로 보내도록 허용하기 위해 Elastic Beanstalk에서는 관리형 보안 그룹의 인바운드 트래픽을 허용하는 규칙을 인스턴스의 보안 그룹에 추가합니다.

Elastic Beanstalk에서 로드 밸런서에 대해 생성한 보안 그룹입니다.

보안 그룹 ID

SecurityGroups

로드 밸런서에 연결할 보안 그룹의 목록입니다.

공유 로드 밸런서의 경우 이 값을 지정하지 않으면 Elastic Beanstalk에서 관리하는 기존 보안 그룹이 로드 밸런서에 이미 연결되어 있는지 확인합니다. 로드 밸런서에 연결되어 있지 않으면 Elastic Beanstalk에서 보안 그룹을 생성하여 로드 밸런서에 연결합니다. Elastic Beanstalk는 로드 밸런서를 공유하는 마지막 환경이 종료되면 이 보안 그룹을 삭제합니다.

로드 밸런서 보안 그룹은 Amazon EC2 인스턴스 보안 그룹 수신 규칙을 설정하는 데 사용됩니다.

Elastic Beanstalk에서 로드 밸런서에 대해 생성한 보안 그룹입니다.

쉼표로 구분된 보안 그룹 ID의 목록입니다.

SharedLoadBalancer

공유 로드 밸런서의 Amazon 리소스 이름(ARN)입니다. 이 옵션은 Application Load Balancer에만 관련이 있습니다. aws:elasticbeanstalk:environment 네임스페이스의 LoadBalancerIsShared 옵션이 true로 설정된 경우에 필요합니다. 환경 생성 후에는 공유 로드 밸런서 ARN을 변경할 수 없습니다.

유효한 값의 조건:

  • 환경이 위치한 AWS 리전에서 유효한 활성 로드 밸런서여야 합니다.

  • 환경과 동일한 Amazon Virtual Private Cloud(Amazon VPC)에 있어야 합니다.

  • 다른 환경의 전용 로드 밸런서로 Elastic Beanstalk에서 생성한 로드 밸런서일 수 없습니다. 이러한 전용 로드 밸런서는 접두사 awseb-을 사용하여 식별할 수 있습니다.

예:

arn:aws:elasticloadbalancing:us-east-2:123456789012:loadbalancer/app/FrontEndLB/0dbf78d8ad96abbc

없음

여기에 설명된 모든 기준을 충족하는 유효한 로드 밸런서의 ARN입니다.

aws:rds:dbinstance

연결된 Amazon RDS DB 인스턴스를 구성합니다.

네임스페이스: aws:rds:dbinstance
이름 설명 기본값 유효값

DBAllocatedStorage

할당된 데이터베이스 스토리지 크기로 기가바이트(GB) 단위입니다.

MySQL: 5

Oracle: 10

sqlserver-se: 200

sqlserver-ex: 30

sqlserver-web: 30

MySQL: 5-1024

Oracle: 10-1024

sqlserver: 수정 불가능

DBDeletionPolicy

환경을 종료할 때 DB 인스턴스의 스냅샷을 유지, 삭제 또는 생성할지 여부를 지정합니다.

이 옵션은 HasCoupledDatabase 및 이 네임스페이스의 옵션과 함께 작동합니다.

주의

DB 인스턴스를 삭제하면 데이터가 영구 손실됩니다.

Delete

Delete

Retain

Snapshot

DBEngine

이 인스턴스에서 사용할 데이터베이스 엔진의 이름입니다.

mysql

mysql

oracle-se1

sqlserver-ex

sqlserver-web

sqlserver-se

postgres

DBEngineVersion

데이터베이스 엔진의 버전 번호입니다.

5.5

DBInstanceClass

데이터베이스 인스턴스 유형입니다.

db.t2.micro

(Amazon VPC에서 실행하지 않는 환경의 경우 db.m1.large)

자세한 내용은 Amazon 관계형 데이터베이스 서비스 사용 설명서의 DB 인스턴스 클래스를 참조하세요.

DBPassword

데이터베이스 인스턴스에 대한 마스터 사용자 암호의 이름입니다.

없음

DBSnapshotIdentifier

복구할 DB 스냅샷에 대한 식별자.

없음

DBUser

DB 인스턴스에 대한 마스터 사용자 이름입니다.

ebroot

HasCoupledDatabase

DB 인스턴스를 환경에 연결할지 여부를 지정합니다. true(으)로 토글된 경우, Elastic Beanstalk는 사용자 환경에 연결된 새 DB 인스턴스를 생성합니다. false(으)로 토글된 경우, Elastic Beanstalk가 DB 인스턴스를 사용자 환경에서 분리하기 시작합니다.

이 옵션은 DBDeletionPolicy 및 이 네임스페이스의 옵션과 함께 작동합니다.

참고

참고: 이전 데이터베이스를 분리한 후 이 값을 다시 true으(로) 토글하는 경우 Elastic Beanstalk는 이전 데이터베이스 옵션 설정을 사용하여 새 데이터베이스를 생성합니다. 그러나 환경의 보안을 유지하기 위해 기존 DBUser 및 DBPassword 설정은 유지하지 않습니다. DBUser 및 DBPassword을(를) 다시 지정해야 합니다.

false

true

false

MultiAZDatabase

데이터베이스 인스턴스 다중 AZ 배포를 생성해야 할지 여부를 지정합니다. Amazon 관계형 데이터베이스 서비스(RDS)에서 다중 AZ 배포에 대한 자세한 내용은 Amazon 관계형 데이터베이스 서비스 사용 설명서의 리전 및 가용 영역을 참조하세요.

false

true

false