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

# Beanstalk 클러스터 환경의 구성 옵션
<a name="command-options-general-eks"></a>

Beanstalk 클러스터 환경은이 페이지의 12개 네임스페이스를 통해 구성됩니다. Beanstalk 클러스터 환경에서 허용하는 유일한 네임스페이스입니다. 의 클래식 네임스페이스는 Beanstalk Standard 환경을 [Beanstalk Standard 환경의 구성 옵션](command-options-general.md) 구성하고 적용되지 않으며,이 중 하나를 Beanstalk 클러스터 환경에 전달하면 무시되지 `InvalidParameterValueException` 않고이 반환됩니다.

이러한 옵션을 설정하는 방법과 Elastic Beanstalk가 옵션을 해결하는 방법은 섹션을 참조하세요[구성 옵션](command-options.md).

**참고**  
**기본** 열은가 옵션에 대해 `DescribeConfigurationOptions` 알리는 값을 제공합니다. Elastic Beanstalk가 기본값을 알리지 않더라도 값을 적용하는 경우 설명에 그렇게 표시됩니다.

**Topics**
+ [aws:elasticbeanstalk:eks](#command-options-eks-base)
+ [aws:elasticbeanstalk:eks:environment](#command-options-eks-environment)
+ [aws:elasticbeanstalk:eks:environment:deployment](#command-options-eks-deployment)
+ [aws:elasticbeanstalk:eks:environment:deployment:strategy:rolling](#command-options-eks-deployment-rolling)
+ [aws:elasticbeanstalk:eks:environment:autoscaling](#command-options-eks-autoscaling)
+ [aws:elasticbeanstalk:eks:environment:autoscaling:trigger](#command-options-eks-autoscaling-trigger)
+ [aws:elasticbeanstalk:eks:environment:autoscaling:behavior](#command-options-eks-autoscaling-behavior)
+ [컨테이너 프로브 네임스페이스](#command-options-eks-probes)
+ [aws:elasticbeanstalk:eks:alb](#command-options-eks-alb)
+ [aws:elasticbeanstalk:eks:observability](#command-options-eks-observability)

## aws:elasticbeanstalk:eks
<a name="command-options-eks-base"></a>

환경을 실행하는 Amazon EKS 클러스터의 IAM 역할을 구성합니다. 두 역할을 모두 제공하면 환경을 생성할 때 Elastic Beanstalk에 역할이 필요합니다. 선택한 서브넷은 환경이 조인하는 클러스터를 결정하며, Elastic Beanstalk는 이러한 역할이 해당 클러스터에 등록된 역할과 일치하지 않는 경우 요청을 거부합니다. 콘솔이 생성하는 역할 이름, 신뢰할 수 있는 서비스 및 정책은 섹션을 참조하세요[Beanstalk 클러스터에 대한 권한](beanstalk-cluster-permissions.md).

또한 환경에는 관찰성 역할이 필요하며 선택적 애플리케이션 역할을 맡을 수 있습니다. 두 설정 모두이 설정이 아닌 `aws:elasticbeanstalk:eks:environment` 네임스페이스에 있습니다. [aws:elasticbeanstalk:eks:environment](#command-options-eks-environment)을(를) 참조하세요.


**네임스페이스: `aws:elasticbeanstalk:eks`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `cluster-role` | Amazon EKS가 클러스터에 대해 수임하는 IAM 역할의 ARN입니다. | 없음. 값을 제공해야 합니다. | IAM 역할 ARN | 
| `node-role` | 클러스터의 Amazon EC2 노드가 수임하는 IAM 역할의 ARN입니다. | 없음. 값을 제공해야 합니다. | IAM 역할 ARN | 

## aws:elasticbeanstalk:eks:environment
<a name="command-options-eks-environment"></a>

애플리케이션 컨테이너, 애플리케이션 컨테이너가 예약하는 컴퓨팅, 네트워크 배치 및 애플리케이션 컨테이너가 사용하는 역할을 구성합니다.


**네임스페이스: `aws:elasticbeanstalk:eks:environment`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `application-role` | 애플리케이션이 서비스를 호출 AWS 하기 위해 수임하는 선택적 IAM 역할의 ARN입니다. [Beanstalk 클러스터에 대한 권한](beanstalk-cluster-permissions.md)을(를) 참조하세요. | 없음 | 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 클러스터 환경의 다중 테넌시](beanstalk-cluster-multi-tenancy.md)을(를) 참조하세요. | 없음 | 쉼표로 구분된 환경 이름 목록 | 
| `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 클러스터 환경을 위한 네트워킹 구성](configuring-cluster-networking.md)을(를) 참조하세요. | `ALB` | `ALB` \| `None` | 
| `memory` | 애플리케이션의 각 복제본이 예약하는 메모리입니다. `512Mi` 또는와 같은 Kubernetes 수량 표기법을 사용합니다`1.5Gi`. 분수 값이 허용됩니다. | `512Mi` | Kubernetes 메모리 수량 | 
| `memory-limit` | 애플리케이션의 각 복제본이 사용할 수 있는 최대 메모리입니다. 와 동일한 표기법을 사용합니다`memory`. | `1Gi` | Kubernetes 메모리 수량 | 
| `node-pool` | 이 환경의 복제본을 실행하는 노드 풀의 이름입니다. 고유한 값은 환경에 자체 노드를 부여하고 공유 값 그룹은 환경을 공유 노드로 그룹화합니다. [Beanstalk 클러스터 환경의 다중 테넌시](beanstalk-cluster-multi-tenancy.md)을(를) 참조하세요. | 없음 | DNS-1123 레이블 | 
| `observability-role` | 환경의 지표, 로그 및 추적을 게시하는 IAM 역할의 ARN입니다. Elastic Beanstalk는 이를 필요로 하며 서브넷이 선택한 클러스터에 등록된 역할과 일치해야 합니다. 기본값은 없으므로 명시적으로 제공합니다. [Beanstalk 클러스터에 대한 권한](beanstalk-cluster-permissions.md)을(를) 참조하세요. | 없음. 값을 제공해야 합니다. | 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 클러스터 환경을 위한 네트워킹 구성](configuring-cluster-networking.md)을(를) 참조하세요. | 없음 | 쉼표로 구분된 서브넷 IDs 목록 | 

## aws:elasticbeanstalk:eks:environment:deployment
<a name="command-options-eks-deployment"></a>

새 애플리케이션 버전을 배포할 때 Elastic Beanstalk가 애플리케이션의 실행 중인 복제본을 대체하는 방법을 선택합니다.


**네임스페이스: `aws:elasticbeanstalk:eks:environment:deployment`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `strategy` | 배포 전략.는 복제본을 점진적으로 `RollingUpdate` 교체하고 `Recreate` 모든 복제본을 다운받아 콘솔이 한 번에 모두 호출하는 전략인 새 버전을 시작합니다. [배포 정책 선택](using-features.deploy-existing-version.md#deployments-scenarios)을(를) 참조하세요. | `RollingUpdate` | `RollingUpdate` \| `Recreate` | 

## aws:elasticbeanstalk:eks:environment:deployment:strategy:rolling
<a name="command-options-eks-deployment-rolling"></a>

롤링 배포가 환경이 실행 중인 복제본 수 앞이나 뒤에서 실행될 수 있는 거리를 바인딩합니다. 이러한 옵션은 `strategy`가 인 경우에 적용됩니다`RollingUpdate`.


**네임스페이스: `aws:elasticbeanstalk:eks:environment:deployment:strategy:rolling`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `max-surge` | Elastic Beanstalk가 배포하는 동안 환경의 현재 복제본 수를 초과하여 시작할 수 있는 복제본 수입니다. | `1` | 와 같은 개수 `2`또는와 같은 백분율 `25%` | 
| `max-unavailable` | 배포하는 동안 한 번에 환경의 복제본 수를 사용할 수 없습니다. | `0` | 와 같은 개수 `1`또는와 같은 백분율 `25%` | 

## aws:elasticbeanstalk:eks:environment:autoscaling
<a name="command-options-eks-autoscaling"></a>

Elastic Beanstalk가 애플리케이션에 대해 실행하는 복제본 수와 해당 수를 변경할지 여부를 평가하는 빈도를 설정합니다.

트리거를 구성하지 않으면 Elastic Beanstalk는 `min-replica`에서 사이의 목표 80%로 CPU 사용률에 따라 환경을 조정합니다`max-replica`. 다른 것을 조정하려면 트리거를 설정합니다. [aws:elasticbeanstalk:eks:environment:autoscaling:trigger](#command-options-eks-autoscaling-trigger)을(를) 참조하세요.


**네임스페이스: `aws:elasticbeanstalk:eks:environment:autoscaling`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `min-replica` | 환경이 실행하는 애플리케이션의 최소 복제본입니다. | `1` | `1`\~`100` | 
| `max-replica` | 환경이 실행하는 애플리케이션의 가장 많은 복제본입니다. | `10` | `1`\~`100` | 
| `polling-interval` | Elastic Beanstalk가 조정 트리거를 평가하는 빈도입니다. | `30` | `1`\~`1000` | 
| `cooldown-period` | 마지막 트리거가 활동 보고를 중지한 후 환경을 다시 축소하기 전에 Elastic Beanstalk가 대기하는 시간입니다. | `300` | 이상의 정수 `1`  | 

## aws:elasticbeanstalk:eks:environment:autoscaling:trigger
<a name="command-options-eks-autoscaling-trigger"></a>

환경 규모를 조정하는 요소를 선택합니다. 복제본이 사용하는 CPU 또는 메모리를 확장할 수 있으며, 일정에 따라 또는 자체 엔드포인트가 보고하는 지표에 따라 확장할 수 있습니다. 이러한 옵션에는 알려진 기본값이 없습니다. 아무 것도 설정하지 않으면 Elastic Beanstalk는가 로, `Utilization`가 로 `cpu-metric-type` 설정된 CPU 트리거`cpu-value`를 제공합니다`80`.


**네임스페이스: `aws:elasticbeanstalk:eks:environment:autoscaling:trigger`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `cpu-metric-type` | CPU 트리거가 예약된 CPU의 백분율(`Utilization`) 또는 절대 양()을 비교하는지 여부입니다`AverageValue`. | 없음. Elastic Beanstalk는 `cpu-value` 단독으로 `Utilization` 설정하거나 트리거를 전혀 설정하지 않은 경우에 적용됩니다. | `Utilization` \| `AverageValue` | 
| `cpu-value` | 환경이 보관하도록 조정하는 CPU 대상입니다. 의 `Utilization`경우 값은 예약된 CPU의 60%를 `60` 의미합니다. | 없음. 트리거를 전혀 설정하지 않으면 Elastic Beanstalk`80`가 적용됩니다. | 정수 | 
| `memory-metric-type` | 메모리 트리거가 예약된 메모리의 백분율(`Utilization`) 또는 절대 양()을 비교하는지 여부입니다`AverageValue`. | 없음. 를 `memory-value` 단독으로 설정하면 Elastic Beanstalk`Utilization`가 적용됩니다. | `Utilization` \| `AverageValue` | 
| `memory-value` | 환경이 보관하도록 확장하는 메모리 대상입니다. | 없음 | 정수 | 
| `scaler-type` | 이벤트 기반 트리거의 종류입니다.는 일정에 따라 `cron` 확장되고 Elastic Beanstalk가 사용자가 제공하는 HTTP 엔드포인트에서 읽는 값에 따라 `metrics-api` 확장됩니다. | 없음 | `cron` \| `metrics-api` | 
| `scaler-metadata` | JSON 객체로서 트리거에 대한 설정입니다. 를 사용하여 `cron`, `timezone``start`, 및 `end`를 제공합니다`desiredReplicas`. 를 사용하여 `metrics-api`, 및 `url``valueLocation`를 제공합니다`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 | 

다음 예시에서는 UTC 기준 평일 근무 시간 동안 환경을 복제본 5개로 조정합니다.

```
$ cat schedule.json
[
  {
    "Namespace": "aws:elasticbeanstalk:eks:environment:autoscaling:trigger",
    "OptionName": "scaler-type",
    "Value": "cron"
  },
  {
    "Namespace": "aws:elasticbeanstalk:eks:environment:autoscaling:trigger",
    "OptionName": "scaler-metadata",
    "Value": "{\"timezone\":\"UTC\",\"start\":\"0 8 * * 1-5\",\"end\":\"0 18 * * 1-5\",\"desiredReplicas\":\"5\"}"
  }
]
$ aws elasticbeanstalk update-environment \
    --environment-name {{my-cluster-env}} \
    --option-settings file://schedule.json
```

`scaler-metadata` 값은 그 자체로 JSON 문서이므로 명령줄이 아닌 파일에 설정이 저장됩니다.

## aws:elasticbeanstalk:eks:environment:autoscaling:behavior
<a name="command-options-eks-autoscaling-behavior"></a>

트리거가 실행되면 환경에서 복제본을 추가하거나 제거하는 속도를 제한합니다. 각 방향에는 기간, 단위 및 양이 필요합니다. 각 기간 내에 환경은 사용자가 설정한 최대 양만큼 복제본 수를 변경합니다.


**네임스페이스: `aws:elasticbeanstalk:eks:environment:autoscaling:behavior`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `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`. | 없음 | 정수 | 

## 컨테이너 프로브 네임스페이스
<a name="command-options-eks-probes"></a>

세 개의 네임스페이스는 컨테이너 프로브를 구성하며, 각 네임스페이스는 동일한 9가지 옵션을 사용합니다.
+ `aws:elasticbeanstalk:eks:environment:readiness-probe`는 복제본이 트래픽을 수신할 준비가 된 시점을 결정합니다. 실패한 복제본은 다시 시작하지 않고 서비스에서 제외됩니다.
+ `aws:elasticbeanstalk:eks:environment:liveness-probe`는 복제본이 비정상인 시기를 결정합니다. 실패한 복제본이 다시 시작됩니다.
+ `aws:elasticbeanstalk:eks:environment:startup-probe`는 다른 두 프로브가 시작되기 전에 느린 시작 복제본을 초기화할 시간을 제공합니다.

활성화할 때까지 모든 프로브가 꺼집니다. 프로브가 환경 상태와 어떤 관련이 있는지는 섹션을 참조하세요[Beanstalk 클러스터 환경 모니터링](monitoring-cluster-environments.md).


**네임스페이스: `aws:elasticbeanstalk:eks:environment:readiness-probe`, `aws:elasticbeanstalk:eks:environment:liveness-probe`및 `aws:elasticbeanstalk:eks:environment:startup-probe`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `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` | 정수 | 

## aws:elasticbeanstalk:eks:alb
<a name="command-options-eks-alb"></a>

애플리케이션, 리스너 및 TLS, 대상 그룹의 상태 확인 앞에 Application Load Balancer를 구성합니다. 이러한 옵션은 `load-balancer-type`가 일 때 적용됩니다`ALB`. 네트워크 설정, 이미 소유한 로드 밸런서 제공 및 HTTPS 리스너를 관리하는 규칙은 섹션을 참조하세요[Beanstalk 클러스터 환경을 위한 네트워킹 구성](configuring-cluster-networking.md).


**네임스페이스: `aws:elasticbeanstalk:eks:alb`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `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 배열로, 각 객체는 수신 주석 키를 해당 값에 매핑합니다. 값의 각 쉼표로 구분된 세그먼트에는 정확히 하나가 포함되어야 합니다. `=`  | 

**참고**  
`load-balancer-attributes`, 및 `listener-attributes`는 값을 해석하지 않고 로드 밸런서에 `raw-annotation` 전달하므로 Elastic Beanstalk는 개별 속성 또는 주석의 의미를 검증하지 않습니다. 환경을 생성할 때 잘못된 값을 사용하면 로드 밸런서가 생성되지 않으므로 오류가 표시됩니다. 환경을 업데이트할 때 Elastic Beanstalk는 로드 밸런서가 조정될 때까지 기다리지 않으므로 변경 사항이 적용되기 전에 작업이 성공할 수 있습니다. 로드 밸런서 자체의 변경 사항을 확인합니다.

## aws:elasticbeanstalk:eks:observability
<a name="command-options-eks-observability"></a>

애플리케이션의 지표, 로그 및 추적이 이동하는 위치를 선택합니다. Elastic Beanstalk는 컬렉션 구성 요소를 프로비저닝하고 운영하며, 사용자는 애플리케이션을 계측하고 선택한 대상에 액세스할 책임이 있습니다. [Beanstalk 클러스터 환경 모니터링](monitoring-cluster-environments.md)을(를) 참조하세요.


**네임스페이스: `aws:elasticbeanstalk:eks:observability`**  

| **이름** | **설명** | **기본값** | **유효값** | 
| --- | --- | --- | --- | 
| `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}}}` 자리 표시자로 참조합니다. [타사 백엔드로 관찰성 데이터 전송](monitoring-cluster-environments.md#monitoring-cluster-environments-custom-backend)을(를) 참조하세요. | 없음 | 수집기 파이프라인 구성, JSON | 
| `custom-credentials` | 수집기가 `custom` 백엔드에 도달하는 데 필요한 자격 증명을 보유한 Secrets Manager 보안 암호의 ARN입니다. 보안 암호 값은 키가의 자리 표시자와 일치하는 JSON 객체여야 합니다`custom-config`. 필수`application-role`: 수집기는 포드의 자격 증명을 통해 보안 암호를 읽습니다.이 자격 증명은 옵션을 설정한 경우에만 존재하며 해당 역할도 보안 암호를 읽을 수 있어야 합니다. | 없음 | Secrets Manager 보안 암호 ARN |