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

# (선택 사항) 환경 변수를 사용하여 Amazon ECS 및 Amazon EKS용 AWS AppConfig 에이전트 구성
<a name="appconfig-integration-containers-agent-configuring"></a>

 AWS AppConfig 에이전트 컨테이너에 대해 다음 환경 변수를 변경하여 에이전트를 구성할 수 있습니다.

**참고**  
다음 표에는 **샘플 값** 열이 포함되어 있습니다. 모니터 해상도에 따라 테이블 하단으로 스크롤한 다음 오른쪽으로 스크롤해야 해당 열이 보일 수도 있습니다.


****  

| 환경 변수 | 세부 정보 | 기본값  | 샘플 값 | 
| --- | --- | --- | --- | 
| `ACCESS_TOKEN` | 이 환경 변수는 에이전트 HTTP 서버에 구성 데이터를 요청할 때 제공해야 하는 토큰을 정의합니다. 토큰 값은 권한 부여 유형이 `Bearer`인 HTTP 요청 승인 헤더에서 설정해야 합니다. 다음 예를 참고하세요<pre>GET /applications/my_app/...<br />                  Host: localhost:2772<br />                  Authorization: Bearer <token value></pre> | 없음 | MyAccessToken | 
| `BACKUP_DIRECTORY` | 이 환경 변수를 사용하면 AWS AppConfig 에이전트가 검색하는 각 구성의 백업을 지정된 디렉터리에 저장할 수 있습니다. 디스크에 백업된 구성은 암호화되지 않습니다. 구성에 민감한 데이터가 포함된 경우는 파일 시스템 권한으로 최소 권한 원칙을 연습할 것을 AWS AppConfig 권장합니다. 자세한 내용은 [의 보안 AWS AppConfig](appconfig-security.md) 단원을 참조하십시오.  | 없음 | /path/to/backups | 
| `HTTP_PORT` | 이 환경 변수는 에이전트의 HTTP 서버가 실행되는 포트를 지정합니다. | 2772 | 2772 | 
| `HTTP_HOST` | HTTP\_HOST 변수는 AWS AppConfig 에이전트가 네트워크 인터페이스에 결합하는 방식을 제어합니다. 바인딩 동작은 최적의 보안 및 접근성을 보장하기 위해 런타임 환경에 따라 다릅니다. |  ECS, EKS [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html)<br />EC2 및 온프레미스[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html) | 사용자 지정 구성 옵션. 다음 값을 사용하여 기본 동작을 재정의할 수 있습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html) | 
| `LOG_LEVEL` | 이 환경 변수는 에이전트가 기록하는 세부 정보 수준을 지정합니다. 각 레벨에는 현재 레벨과 모든 상위 레벨이 포함됩니다. 이 값은 대소문자를 구분합니다. 가장 세부적인 것부터 로그 수준은 순서대로 `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `none`입니다. `trace` 로그에는 타이밍 정보를 비롯하여 에이전트에 대한 세부 정보가 포함됩니다. | info | 추적<br />debug<br />info<br />warn<br />오류<br />fatal<br />없음 | 
| `LOG_PATH` | 로그가 기록되는 디스크 위치. 지정하지 않으면 로그가 stderr에 기록됩니다. | 없음 | /path/to/logs/agent.log | 
| `MANIFEST` | 이 환경 변수는 다중 계정 검색과 같은 추가 구성별 기능을 활용하고 구성을 디스크에 저장하도록 AWS AppConfig Agent를 구성합니다. 이러한 기능에 대한 자세한 내용은 [매니페스트를 사용하여 추가 검색 기능 활성화](appconfig-agent-how-to-use-additional-features.md) 섹션을 참조하세요. | 없음 |  AWS AppConfig 구성을 매니페스트로 사용하는 경우: `MyApp:MyEnv:MyManifestConfig`.<br />디스크에서 매니페스트를 로드하는 경우: `file:/path/to/manifest.json` | 
| `MAX_CONNECTIONS` | 이 환경 변수는 에이전트가 AWS AppConfig에서 구성을 검색하는 데 사용하는 최대 연결 수를 구성합니다. | 3 | 3 | 
| `POLL_INTERVAL` | 이 환경 변수는 에이전트가 업데이트된 구성 데이터를 AWS AppConfig 폴링하는 빈도를 제어합니다. 간격을 초 단위로 지정할 수 있습니다. 시간 단위를 사용하여 숫자를 지정할 수도 있습니다. 초는 s, 분은 m, 시간은 h입니다. 단위를 지정하지 않으면 에이전트의 기본값은 초로 설정됩니다. 예를 들어 60, 60초, 1분은 폴링 간격이 동일합니다. | 45초 | 45<br />45s<br />5m<br />1h | 
| `PREFETCH_LIST` | 이 환경 변수는 에이전트가 시작하는 AWS AppConfig 즉시에서 요청하는 구성 데이터를 지정합니다. 여러 구성 식별자가 쉼표로 구분된 목록으로 제공될 수 있습니다. | 없음 | MyApp:MyEnv:MyConfig<br />abcd123:efgh456:ijkl789<br />MyApp:MyEnv:Config1,MyApp:MyEnv:Config2 | 
| `PRELOAD_BACKUPS` | 로 설정하면 `true` AWS AppConfig 에이전트는에 있는 구성 백업을 메모리`BACKUP_DIRECTORY`로 로드하고 서비스에서 최신 버전이 존재하는지 즉시 확인합니다. `false`로 설정하면 AWS AppConfig Agent는 네트워크에 문제가 있는 경우와 같이 서비스에서 구성 데이터를 검색할 수 없는 경우에만 구성 백업에서 콘텐츠를 로드합니다. | true | true<br />false | 
| PROXY\_HEADERS | 이 환경 변수는 PROXY\_URL 환경 변수에서 참조되는 프록시에 필요한 헤더를 지정합니다. 값은 쉼표로 구분된 헤더 목록입니다. | 없음 | header: value<br />h1: v1, h2: v2 | 
| PROXY\_URL | 이 환경 변수는 AWS AppConfigHTTPS 및 URL을 AWS 서비스포함하여 에이전트에서 로의 연결에 사용할 프록시 HTTP URLs 지정합니다. | 없음 | http://localhost:7474<br />https://my-proxy.example.com | 
| `REQUEST_TIMEOUT` | 이 환경 변수는 에이전트가 응답을 기다리는 시간을 제어합니다 AWS AppConfig. 서비스가 응답하지 않으면 요청이 실패합니다.<br />초기 데이터 검색을 위한 요청인 경우 에이전트는 애플리케이션에 오류를 반환합니다.<br />업데이트된 데이터에 대한 백그라운드 확인 중에 제한 시간이 초과되면 에이전트는 오류를 기록하고 잠시 후 다시 시도합니다.<br />제한 시간을 밀리초로 지정할 수 있습니다. 시간 단위로 숫자를 지정할 수도 있습니다. 밀리초는 ms이고 초는 s입니다. 단위를 지정하지 않으면 에이전트의 기본값은 밀리초로 설정됩니다. 예를 들어 5000, 5000ms 및 5s의 경우 요청 제한 시간 값이 동일합니다. | 3000ms | 3000<br />3000ms<br />5s | 
| ROLE\_ARN | 이 환경 변수는 IAM 역할의 Amazon 리소스 이름(ARN)을 지정합니다. AWS AppConfig 에이전트는이 역할을 수임하여 구성 데이터를 검색합니다. | 없음 | arn:aws:iam::123456789012:role/MyRole | 
| ROLE\_EXTERNAL\_ID | 이 환경 변수는 수임된 역할 ARN과 함께 사용할 외부 ID를 지정합니다. | 없음 | MyExternalId | 
| ROLE\_SESSION\_NAME | 이 환경 변수는 수임된 IAM 역할의 자격 증명과 연결할 세션 이름을 지정합니다. | 없음 | AWSAppConfigAgentSession | 
| SERVICE\_REGION | 이 환경 변수는 에이전트 AWS 리전 가 AWS AppConfig AWS AppConfig 서비스를 호출하는 데 사용하는 대안을 지정합니다. 정의되지 않은 상태로 두면 에이전트는 현재 리전을 확인하려고 시도합니다. 그렇게 할 수 없는 경우 에이전트가 시작되지 않습니다. | 없음 | us-east-1<br />eu-west-1 | 
| `WAIT_ON_MANIFEST` | 이 환경 변수는 시작을 완료하기 전에 매니페스트가 처리될 때까지 기다리도록 AWS AppConfig 에이전트를 구성합니다. | true | true<br />false |