Beanstalk 클러스터 환경의 구성 옵션

cluster-role

Amazon EKS가 클러스터에 대해 수임하는 IAM 역할의 ARN입니다.

없음. 값을 제공해야 합니다.

IAM 역할 ARN

node-role

클러스터의 Amazon EC2 노드가 수임하는 IAM 역할의 ARN입니다.

없음. 값을 제공해야 합니다.

IAM 역할 ARN

application-role

애플리케이션이 서비스를 호출 AWS 하기 위해 수임하는 선택적 IAM 역할의 ARN입니다. Beanstalk 클러스터에 대한 권한을(를) 참조하세요.

없음

IAM 역할 ARN

arch

애플리케이션이 실행되는 CPU 아키텍처입니다.

amd64

amd64 | arm64

cpu

애플리케이션의 각 복제본이 예약하는 CPU입니다. Kubernetes 수량 표기법을 사용하므로 500m는 가상 CPU의 절반이고 2는 가상 CPUs.

250m

0.01 로 128또는 10m로 128000m

cpu-limit

애플리케이션의 각 복제본이 사용할 수 있는 최대 CPU입니다. 와 동일한 표기법을 사용합니다cpu.

없음

0.01 로 128또는 10m로 128000m

env-variables

컨테이너의 환경 변수로, 각 변수 이름을 해당 값에 매핑하는 JSON 객체입니다. 이는 변수당 하나의 옵션이 아니라 모든 변수를 포함하는 하나의 옵션입니다. Elastic Beanstalk는 사용자가 제공하는 모든 값을 service-port PORT에서 설정하고 재정의합니다.

{"PORT" : 8080}

JSON 객체

ingress-allowlist-environments

이 환경으로 트래픽을 전송할 수 있는 환경의 이름입니다. Beanstalk 클러스터 환경의 다중 테넌시을(를) 참조하세요.

없음

쉼표로 구분된 환경 이름 목록

ingress-allowlist-groups

환경이이 환경으로 트래픽을 전송할 수 있는 수신 그룹입니다. 나열된 그룹의 모든 환경이 허용됩니다.

없음

쉼표로 구분된 수신 그룹 이름 목록

ingress-groups

이 환경이 속한 수신 그룹입니다. 동일한 그룹의 환경은 서로 연결할 수 있습니다.

없음

쉼표로 구분된 수신 그룹 이름 목록

instance-category

클러스터의 노드가 선택되는 Amazon EC2 인스턴스 범주입니다.

없음

c | d | g | gr | hpc | i | im | is | m | p | r | t | x | z

language

애플리케이션의 런타임 언어로, Elastic Beanstalk가 컨테이너에 추가하는 OpenTelemetry 자동 계측을 선택하여 애플리케이션이 애플리케이션 변경 없이 선택한 관찰성 백엔드로 지표, 로그 및 트레이스를 내보냅니다. 이 옵션은 자동 계측만 선택합니다. 애플리케이션에서 사용할 수 있는 언어는 제한되지 않습니다. 런타임이 나열되지 않았거나 애플리케이션이 자체적으로 OpenTelemetry 데이터를 내보내는 경우 생략합니다.

없음

python | java | dotnet | nodejs

load-balancer-type

트래픽이 애플리케이션에 도달하는 방법. None를 사용하면 Elastic Beanstalk가 로드 밸런서를 생성하지 않습니다. Beanstalk 클러스터 환경을 위한 네트워킹 구성을(를) 참조하세요.

ALB

ALB | None

memory

애플리케이션의 각 복제본이 예약하는 메모리입니다. 512Mi 또는와 같은 Kubernetes 수량 표기법을 사용합니다1.5Gi. 분수 값이 허용됩니다.

512Mi

Kubernetes 메모리 수량

memory-limit

애플리케이션의 각 복제본이 사용할 수 있는 최대 메모리입니다. 와 동일한 표기법을 사용합니다memory.

1Gi

Kubernetes 메모리 수량

node-pool

이 환경의 복제본을 실행하는 노드 풀의 이름입니다. 고유한 값은 환경에 자체 노드를 부여하고 공유 값 그룹은 환경을 공유 노드로 그룹화합니다. Beanstalk 클러스터 환경의 다중 테넌시을(를) 참조하세요.

없음

DNS-1123 레이블

observability-role

환경의 지표, 로그 및 추적을 게시하는 IAM 역할의 ARN입니다. Elastic Beanstalk는 이를 필요로 하며 서브넷이 선택한 클러스터에 등록된 역할과 일치해야 합니다. 기본값은 없으므로 명시적으로 제공합니다. Beanstalk 클러스터에 대한 권한을(를) 참조하세요.

없음. 값을 제공해야 합니다.

IAM 역할 ARN

secrets

컨테이너에 노출할 보안 암호로, 각 이름을 Secrets Manager의 보안 암호 ARN 또는 Systems Manager Parameter Store의 파라미터에 매핑하는 JSON 객체입니다. 와 마찬가지로 env-variables이 옵션은 모든 보안 암호를 보유하는 하나의 옵션입니다. 필수application-role: Elastic Beanstalk는 포드의 자격 증명을 통해 각 보안 암호를 읽습니다.이 자격 증명은 해당 옵션을 설정한 경우에만 존재합니다. 그렇지 않으면 볼륨 마운트가 실패하고 복제본이 시작되지 않습니다.

없음

JSON 객체

service-port

애플리케이션이 수신 대기하는 포트입니다. Elastic Beanstalk는 이를 필요로 하고, 이를 컨테이너에 PORT 환경 변수로 주입하며, 이를 다른 환경과 컨테이너 프로브가 도달하는 포트로 사용합니다.

8080

1~65535

subnets

환경의 서브넷입니다. 클러스터의 노드가 실행되는 위치와 환경이 조인하는 클러스터를 결정합니다. 이를 생략하면 Elastic Beanstalk는 기본 VPC의 퍼블릭 서브넷을 사용합니다. 환경을 생성한 후에는 변경할 수 없습니다. Beanstalk 클러스터 환경을 위한 네트워킹 구성을(를) 참조하세요.

없음

쉼표로 구분된 서브넷 IDs 목록

strategy

배포 전략.는 복제본을 점진적으로 RollingUpdate 교체하고 Recreate 모든 복제본을 다운받아 콘솔이 한 번에 모두 호출하는 전략인 새 버전을 시작합니다. 배포 정책 선택을(를) 참조하세요.

RollingUpdate

RollingUpdate | Recreate

max-surge

Elastic Beanstalk가 배포하는 동안 환경의 현재 복제본 수를 초과하여 시작할 수 있는 복제본 수입니다.

1

와 같은 개수 2또는와 같은 백분율 25%

max-unavailable

배포하는 동안 한 번에 환경의 복제본 수를 사용할 수 없습니다.

0

와 같은 개수 1또는와 같은 백분율 25%

min-replica

환경이 실행하는 애플리케이션의 최소 복제본입니다.

1

1~100

max-replica

환경이 실행하는 애플리케이션의 가장 많은 복제본입니다.

10

1~100

polling-interval

Elastic Beanstalk가 조정 트리거를 평가하는 빈도입니다.

30

1~1000

cooldown-period

마지막 트리거가 활동 보고를 중지한 후 환경을 다시 축소하기 전에 Elastic Beanstalk가 대기하는 시간입니다.

300

이상의 정수 1

cpu-metric-type

CPU 트리거가 예약된 CPU의 백분율(Utilization) 또는 절대 양()을 비교하는지 여부입니다AverageValue.

없음. Elastic Beanstalk는 cpu-value 단독으로 Utilization 설정하거나 트리거를 전혀 설정하지 않은 경우에 적용됩니다.

Utilization | AverageValue

cpu-value

환경이 보관하도록 조정하는 CPU 대상입니다. 의 Utilization경우 값은 예약된 CPU의 60%를 60 의미합니다.

없음. 트리거를 전혀 설정하지 않으면 Elastic Beanstalk80가 적용됩니다.

정수

memory-metric-type

메모리 트리거가 예약된 메모리의 백분율(Utilization) 또는 절대 양()을 비교하는지 여부입니다AverageValue.

없음. 를 memory-value 단독으로 설정하면 Elastic BeanstalkUtilization가 적용됩니다.

Utilization | AverageValue

memory-value

환경이 보관하도록 확장하는 메모리 대상입니다.

없음

정수

scaler-type

이벤트 기반 트리거의 종류입니다.는 일정에 따라 cron 확장되고 Elastic Beanstalk가 사용자가 제공하는 HTTP 엔드포인트에서 읽는 값에 따라 metrics-api 확장됩니다.

없음

cron | metrics-api

scaler-metadata

JSON 객체로서 트리거에 대한 설정입니다. 를 사용하여 cron, timezonestart, 및 end를 제공합니다desiredReplicas. 를 사용하여 metrics-api, 및 urlvalueLocation를 제공합니다targetValue.

없음

JSON 객체

scaler-auth-mode

metrics-api 트리거가 읽는 엔드포인트에 대해 Elastic Beanstalk가 인증하는 방법.

bearer

bearer | basic | apiKey | tls

scaler-auth-secret

엔드포인트에 대한 자격 증명을 보유한 Secrets Manager 보안 암호의 ARN입니다. 가 인 경우에만 설정할 수 scaler-type 있습니다metrics-api. 필수application-role: Elastic Beanstalk는 포드의 자격 증명을 통해 보안 암호를 읽습니다.이 자격 증명은 해당 옵션을 설정한 경우에만 존재합니다. 그렇지 않으면 탑재가 실패하고 복제본이 시작되지 않습니다.

없음

Secrets Manager 보안 암호 ARN

scaleup-period

에 scaleup-value 적용되는 초 단위의 기간입니다.

없음

이상의 정수 1

scaleup-type

scaleup-value가 복제본 수(Pods)인지 아니면 현재 수의 백분율()인지 여부입니다Percent.

없음

Pods | Percent

scaleup-value

환경이 하나의 내에 추가하는 최대 입니다scaleup-period.

없음

정수

scaledown-period

에 scaledown-value 적용되는 초 단위의 기간입니다.

없음

이상의 정수 1

scaledown-type

scaledown-value가 복제본 수(Pods)인지 아니면 현재 수의 백분율()인지 여부입니다Percent.

없음

Pods | Percent

scaledown-value

환경이 한 내에서 제거하는 최대 입니다scaledown-period.

없음

정수

enabled

프로브 실행 여부입니다.

false

true | false

http-path

프로브가 요청하는 경로입니다.

/

URL 경로

http-port

프로브가 요청하는 포트입니다. 이를 생략하면 프로브가를 사용합니다service-port.

없음. 프로브는를 사용합니다service-port.

1~65535

initial-delay-seconds

첫 번째 요청 전에 복제본이 시작된 후 프로브가 대기하는 시간입니다.

0

정수 초

period-seconds

프로브가 실행되는 빈도입니다.

30

1~3600

timeout-seconds

요청이 실패로 계산되기 전에 프로브가 응답을 기다리는 시간입니다.

5

정수 초

success-threshold

프로브가 통과한 연속 성공 횟수입니다.

1

정수

failure-threshold

프로브가 실패하는 연속 실패 횟수입니다.

3

정수

arn

이미 소유한 Application Load Balancer의 ARN으로, Elastic Beanstalk에서 생성하는 ARN 대신 사용됩니다. Elastic Beanstalk는 Network Load Balancer의 ARN을 거부합니다.

없음. Elastic Beanstalk는 로드 밸런서를 생성합니다.

Application Load Balancer ARN

scheme

인터넷에서 로드 밸런서에 연결할 수 있는지 여부입니다. 이를 생략하면 Elastic Beanstalk는 서브넷에서 이를 추출합니다. 퍼블릭 서브넷은 인터넷 경계 로드 밸런서를 제공하고 프라이빗 서브넷은 내부 서브넷을 제공합니다.

없음. 서브넷에서 파생됩니다.

internet-facing | internal

subnets

로드 밸런서를 배치할 서브넷입니다. 이를 생략하면 환경의 서브넷이 사용됩니다.

없음. 환경의 서브넷입니다.

쉼표로 구분된 서브넷 IDs 목록

security-groups

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

없음

쉼표로 구분된 보안 그룹 IDs 목록

manage-backend-security-group-rules

Elastic Beanstalk가 로드 밸런서와 애플리케이션 간에 보안 그룹 규칙을 추가 및 제거할지 여부입니다.

true

true | false

ip-address-type

로드 밸런서가 IPv4만 제공하는지 아니면 IPv4와 IPv6를 모두 제공하는지 여부입니다. Elastic Beanstalk는 기본값을 알리지 않고를 적용합니다ipv4.

ipv4, Elastic Beanstalk에서 적용

ipv4 | dualstack

target-type

로드 밸런서가 복제본의 IP 주소 또는 이를 실행하는 노드로 트래픽을 전송하는지 여부입니다. Elastic Beanstalk는 기본값을 알리지 않고를 적용합니다ip.

ip, Elastic Beanstalk에서 적용

ip | instance

listen-ports

와 같이 리스너당 하나의 객체가 있는 JSON 배열로 열 리스너입니다[{"HTTPS":443},{"HTTP":80}]. 각 포트는 고유해야 합니다. Elastic Beanstalk는 HTTPS 리스너가 존재하는지 확인하고 인증서를 제공합니다. HTTP 리스너는 애플리케이션 트래픽을 처리하는 대신 HTTPS로 리디렉션합니다.

없음. Elastic Beanstalk는 포트 443에서 HTTPS를 구성합니다.

protocol-to-port 객체의 JSON 배열

certificate-arn

예를 들어 사용자 지정 도메인에서 환경을 제공할 때 HTTPS 리스너에 연결할 자체 ACM 인증서의 ARN입니다. HTTPS가 작동하려면이 옵션이 필요하지 않습니다. Elastic Beanstalk는 환경 자체 도메인에 대한 인증서를 생성 및 연결합니다. 설정하면 로드 밸런서에 두 인증서가 모두 포함됩니다.

없음

ACM 인증서 ARN

ssl-policy

HTTPS 리스너에 대한 보안 정책입니다.

없음

Elastic Load Balancing 보안 정책 이름

ssl-redirect

HTTP 요청을 리디렉션할 HTTPS 포트 Elastic Beanstalk를 선택합니다. 값은 구성된 HTTPS 리스너가 사용하는 포트여야 합니다. Elastic Beanstalk는이 옵션을 설정했는지 여부에 관계없이 HTTP 리스너에 도착하는 요청을 리디렉션하므로 대상 포트만 변경합니다.

없음. Elastic Beanstalk는 HTTPS 리스너의 포트로 리디렉션합니다.

1~65535

backend-protocol

로드 밸런서가 애플리케이션에 도달하는 데 사용하는 프로토콜입니다.

없음

HTTP | HTTPS

backend-protocol-version

로드 밸런서가 애플리케이션에 도달하는 데 사용하는 프로토콜 버전입니다. backend-protocol가 설정된 경우에만 적용됩니다.

없음

HTTP2 | GRPC

healthcheck-path

대상 그룹 상태 확인이 요청하는 경로입니다.

/

URL 경로

healthcheck-protocol

대상 그룹 상태 확인에서 사용하는 프로토콜입니다.

HTTP

HTTP | HTTPS

healthcheck-interval-seconds

대상 그룹 상태 확인이 실행되는 빈도입니다.

15

5~300

healthcheck-timeout-seconds

상태 확인이 응답을 기다리는 시간입니다.

5

2~120

success-codes

성공적인 상태 확인으로 계산되는 HTTP 상태 코드입니다.

200

상태 코드, 목록 또는 범위

healthy-threshold-count

대상을 정상으로 만드는 연속 성공 검사 횟수입니다.

2

2~10

unhealthy-threshold-count

대상이 비정상 상태가 되는 연속 실패한 검사 횟수입니다.

2

2~10

wafv2-acl-arn

로드 밸런서와 연결할 AWS WAF 웹 ACL의 ARN입니다.

없음

AWS WAF 웹 ACL ARN

tags

로드 밸런서에 적용할 태그입니다.

없음

태그 키 및 값의 JSON 객체

load-balancer-attributes

해석 없이 Elastic Load Balancing으로 전달되는 로드 밸런서에 적용할 로드 밸런서 속성입니다.

없음

와 같이 쉼표로 구분된 key=value 페어 목록 idle_timeout.timeout_seconds=300,routing.http2.enabled=false

listener-attributes

특정 리스너에 적용할 리스너 속성으로, 해석 없이 Elastic Load Balancing으로 전달됩니다. 여기에 리스너 속성만 제공하고 로드 밸런서 속성은 제공하지 않습니다.

없음

객체의 JSON 배열로, 각 객체는 다음과 같이 쉼표로 구분된 key=value 페어 목록에 리스너를 매핑합니다. [{"HTTPS-8443":"routing.http.response.server.enabled=false"}]

raw-annotation

Elastic Beanstalk가 환경에 대해 생성하는 Kubernetes 수신에 직접 적용할 주석입니다. 이 네임스페이스의 다른 옵션이 다루지 않는 로드 밸런서 동작에 사용합니다.

없음

객체의 JSON 배열로, 각 객체는 수신 주석 키를 해당 값에 매핑합니다. 값의 각 쉼표로 구분된 세그먼트에는 정확히 하나가 포함되어야 합니다. =

metrics-backend

애플리케이션의 지표가 이동하는 위치입니다.는 이를 Amazon Managed Service for Prometheus로 amp 전송하며가 필요합니다metrics-endpoint.

cloudwatch

cloudwatch | amp | custom | none

metrics-endpoint

Amazon Managed Service for Prometheus 원격 쓰기 엔드포인트입니다. metrics-backend가 인 경우에만 설정합니다amp.

없음

원격 쓰기 엔드포인트 URL

logs-backend

애플리케이션의 로그가 이동하는 위치입니다.

cloudwatch

cloudwatch | s3 | custom | none

traces-backend

애플리케이션의 트레이스가 이동하는 위치입니다. 지표 및 로그와 달리 트레이스는 하나를 선택할 때까지 백엔드가 없습니다.

없음

xray | custom | none

custom-config

로 설정한 신호에 사용할 OpenTelemetry 수집기 파이프라인 구성입니다custom. 각 자격 증명을에서 custom-credentials 제공하는 ${NAME} 자리 표시자로 참조합니다. 타사 백엔드로 관찰성 데이터 전송을(를) 참조하세요.

없음

수집기 파이프라인 구성, JSON

custom-credentials

수집기가 custom 백엔드에 도달하는 데 필요한 자격 증명을 보유한 Secrets Manager 보안 암호의 ARN입니다. 보안 암호 값은 키가의 자리 표시자와 일치하는 JSON 객체여야 합니다custom-config. 필수application-role: 수집기는 포드의 자격 증명을 통해 보안 암호를 읽습니다.이 자격 증명은 옵션을 설정한 경우에만 존재하며 해당 역할도 보안 암호를 읽을 수 있어야 합니다.

없음

Secrets Manager 보안 암호 ARN