기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # AWS AppConfig 에이전트 Lambda 확장 구성 다음 AWS Lambda 환경 변수를 변경하여 확장을 구성할 수 있습니다. 자세한 내용은 *AWS Lambda 개발자 안내서*의 [AWS Lambda 환경 변수 사용을](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html) 참조하세요. **구성 데이터 프리페칭** 환경 변수 `AWS_APPCONFIG_EXTENSION_PREFETCH_LIST`는 함수 시작 시간을 개선할 수 있습니다. AWS AppConfig 에이전트 Lambda 확장이 초기화되면 Lambda가 함수를 초기화하고 핸들러를 호출하기 AWS AppConfig 전에에서 지정된 구성을 검색합니다. 함수가 요청하기 전에 로컬 캐시에서 구성 데이터를 이미 사용할 수 있는 경우도 있습니다. 프리페치 기능을 사용하려면 환경 변수 값을 구성 데이터에 해당하는 경로로 설정하십시오. 예를 들어 구성이 각각 “my\$1application”, “my\$1environment” 및 “my\$1configuration\$1data”라는 이름의 애플리케이션, 환경 및 구성 프로파일에 해당하는 경우 경로는 `/applications/my_application/environments/my_environment/configurations/my_configuration_data`입니다. 여러 구성 항목을 쉼표로 구분된 목록으로 나열하여 지정할 수 있습니다(리소스 이름에 쉼표가 포함된 경우 해당 이름 대신 리소스의 ID 값을 사용하십시오.). **다른 계정에서 구성 데이터에 액세스** AWS AppConfig 에이전트 Lambda 확장은 데이터에 [권한을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_permissions-to-switch.html) 부여하는 IAM 역할을 지정하여 다른 계정에서 구성 데이터를 검색할 수 있습니다. 이를 설정하려면 다음 단계를 수행합니다. 1. AWS AppConfig 가 구성 데이터를 관리하는 데 사용되는 계정에서 구성 AWS AppConfig 리소스에 해당하는 부분 또는 전체 ARNs과 함께 Lambda 함수를 실행하는 계정에 `appconfig:StartConfigurationSession` 및 `appconfig:GetLatestConfiguration` 작업에 대한 액세스 권한을 부여하는 신뢰 정책을 사용하여 역할을 생성합니다. 1. Lambda 함수를 실행하는 계정에서 1단계에서 생성한 역할의 ARN을 사용하여 Lambda 함수에 `AWS_APPCONFIG_EXTENSION_ROLE_ARN` 환경 변수를 추가합니다. 1. (선택 사항) 필요한 경우 `AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID` 환경 변수를 사용하여 [외부 ID](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html)를 지정할 수 있습니다. 마찬가지로 `AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME` 환경 변수를 사용하여 세션 이름을 구성할 수 있습니다. **참고** 다음 정보를 참고하세요. AWS AppConfig 에이전트 Lambda 확장은 한 계정에서만 데이터를 검색할 수 있습니다. IAM 역할을 지정하는 경우 확장은 Lambda 함수가 실행되는 계정에서 구성 데이터를 검색할 수 없습니다. AWS Lambda 는 Amazon CloudWatch Logs를 사용하여 AWS AppConfig 에이전트 Lambda 확장 및 Lambda 함수에 대한 정보를 기록합니다. 다음 표에는 **샘플 값** 열이 포함되어 있습니다. 모니터 해상도에 따라 테이블 하단으로 스크롤한 다음 오른쪽으로 스크롤해야 해당 열이 보일 수도 있습니다. **** | 환경 변수 | 세부 정보 | 기본값 | 샘플 값 | | --- | --- | --- | --- | | `AWS_APPCONFIG_EXTENSION_HTTP_PORT` | 이 환경 변수는 확장을 호스팅하는 로컬 HTTP 서버가 실행되는 포트를 지정합니다. | 2772 | 2772 | | `AWS_APPCONFIG_EXTENSION_LOG_LEVEL` | 이 환경 변수는 에이전트가 기록하는 세부 정보 수준을 지정합니다. 각 레벨에는 현재 레벨과 모든 상위 레벨이 포함됩니다. 이 값은 대소문자를 구분합니다. 가장 세부적인 것부터 로그 수준은 순서대로 `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `none`입니다. `trace` 로그에는 타이밍 정보를 비롯하여 에이전트에 대한 세부 정보가 포함됩니다. | info | 추적 debug info warn 오류 fatal 없음 | | `AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS` | 이 환경 변수는 확장이 AWS AppConfig에서 구성을 검색하는 데 사용하는 최대 연결 수를 구성합니다. | 3 | 3 | | `AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS` | 이 환경 변수는 에이전트가 업데이트된 구성 데이터를 폴링하는 빈도 AWS AppConfig 를 제어합니다. 간격을 초 단위로 지정할 수 있습니다. 시간 단위를 사용하여 숫자를 지정할 수도 있습니다. 초는 s, 분은 m, 시간은 h입니다. 단위를 지정하지 않으면 에이전트의 기본값은 초로 설정됩니다. 예를 들어 60, 60초, 1분은 폴링 간격이 동일합니다. | 45 | 4545s5m1h | | `AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS` | 이 환경 변수는 캐시의 데이터를 새로 고칠 AWS AppConfig 때 확장이의 응답을 기다리는 최대 시간을 밀리초 단위로 제어합니다. AWS AppConfig 가 지정된 시간 내에 응답하지 않으면 확장은이 폴링 간격을 건너뛰고 이전에 업데이트된 캐시된 데이터를 반환합니다. | 3000ms | 3000300ms5s | | `AWS_APPCONFIG_EXTENSION_PREFETCH_LIST` | 이 환경 변수는 에이전트가 시작하는 AWS AppConfig 즉시에서 요청하는 구성 데이터를 지정합니다. 여러 구성 식별자가 쉼표로 구분된 목록으로 제공될 수 있습니다. AWS AppConfig 에서 구성 데이터를 미리 가져오면 함수의 콜드 스타트 시간을 크게 줄일 수 있습니다. | 없음 | MyApp:MyEnv:MyConfigabcd123:efgh456:ijkl789MyApp:MyEnv:Config1,MyApp:MyEnv:Config2 | | AWS\$1APPCONFIG\$1EXTENSION\$1PROXY\$1HEADERS | 이 환경 변수는 AWS\$1APPCONFIG\$1EXTENSION\$1PROXY\$1URL 환경 변수에서 참조되는 프록시에 필요한 헤더를 지정합니다. 값은 쉼표로 구분된 헤더 목록입니다. | 없음 | header: valueh1: v1, h2: v2 | | AWS\$1APPCONFIG\$1EXTENSION\$1PROXY\$1URL | 이 환경 변수는 AWS AppConfig 확장에서 연결에 사용할 프록시 URL을 지정합니다 AWS 서비스. HTTPS 및 HTTP URLs이 지원됩니다. | 없음 | http://localhost:7474https://my-proxy.example.com | | AWS\$1APPCONFIG\$1EXTENSION\$1ROLE\$1ARN | 이 환경 변수는 구성을 검색하기 위해 AWS AppConfig 확장에서 수임해야 하는 역할에 해당하는 IAM 역할 ARN을 지정합니다. | 없음 | arn:aws:iam::123456789012:role/MyRole | | AWS\$1APPCONFIG\$1EXTENSION\$1ROLE\$1EXTERNAL\$1ID | 이 환경 변수는 수임된 역할 ARN과 함께 사용할 외부 ID를 지정합니다. | 없음 | MyExternalId | | AWS\$1APPCONFIG\$1EXTENSION\$1ROLE\$1SESSION\$1NAME | 이 환경 변수는 수임된 IAM 역할의 자격 증명과 연결할 세션 이름을 지정합니다. | 없음 | AWSAppConfigAgentSession | | AWS\$1APPCONFIG\$1EXTENSION\$1SERVICE\$1REGION | 이 환경 변수는 확장이 AWS AppConfig 서비스를 호출하는 데 사용해야 하는 대체 리전을 지정합니다. 정의되지 않은 경우 확장은 현재 지역의 엔드포인트를 사용합니다. | 없음 | us-east-1eu-west-1 | | `AWS_APPCONFIG_EXTENSION_MANIFEST` | 이 환경 변수는 다중 계정 검색과 같은 추가 구성별 기능을 활용하고 구성을 디스크에 저장하도록 AWS AppConfig Agent를 구성합니다. 이러한 기능에 대한 자세한 내용은 [매니페스트를 사용하여 추가 검색 기능 활성화](appconfig-agent-how-to-use-additional-features.md) 섹션을 참조하세요. | 없음 | AWS AppConfig 구성을 매니페스트로 사용하는 경우: `MyApp:MyEnv:MyManifestConfig`.디스크에서 매니페스트를 로드하는 경우: `file:/path/to/manifest.json` | | `AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST` | 이 환경 변수는 시작을 완료하기 전에 매니페스트가 처리될 때까지 기다리도록 AWS AppConfig 에이전트를 구성합니다. | true | truefalse |