AWS AppConfig 에이전트 Lambda 확장 프로그램을 사용하여 구성 데이터 검색

AWS Lambda 확장은 Lambda 함수의 기능을 보강하는 동반 프로세스입니다. 확장은 함수가 간접적으로 호출되기 전에 시작되어 함수와 병렬로 실행되고 함수 호출이 처리된 후에도 계속 실행될 수 있습니다. 기본적으로, Lambda 확장은 Lambda 호출과 병렬로 실행되는 클라이언트와 같습니다. 이 병렬 클라이언트는 수명 주기 중 언제든지 함수와 연결될 수 있습니다.

Lambda 함수에서 AWS AppConfig 기능 플래그 또는 기타 동적 구성 데이터를 사용하는 경우, Lambda 함수에 AWS AppConfig 에이전트 Lambda 확장 프로그램을 계층으로 추가하는 것이 좋습니다. 이렇게 하면 기능 플래그를 더 간단하게 호출할 수 있으며 확장 프로그램 자체에는 사용을 단순화하는 동시에 비용을 절감하는 모범 사례가 포함됩니다. AWS AppConfig AWS AppConfig 서비스에 대한 API 호출이 줄어들고 Lambda 함수 처리 시간이 단축되어 비용이 절감됩니다. Lambda 확장에 대한 자세한 내용은 AWS Lambda 개발자 안내서의 Lambda 확장 을 참조하십시오.

이 주제에는 AWS AppConfig 에이전트 Lambda 확장 프로그램에 대한 정보와 Lambda 함수와 함께 작동하도록 확장 프로그램을 구성하는 방법에 대한 절차가 포함되어 있습니다.

작동 방식

Lambda 확장 프로그램이 없는 Lambda 함수의 구성을 관리하는 AWS AppConfig 데 사용하는 경우, 세션 및 구성 API 작업과 통합하여 구성 업데이트를 수신하도록 Lambda 함수를 구성해야 합니다. StartConfiguration GetLatest

AWS AppConfig 에이전트 Lambda 확장 프로그램을 Lambda 함수와 통합하면 이 프로세스가 간소화됩니다. 확장 프로그램은 서비스를 호출하고, 검색된 데이터의 로컬 캐시를 관리하고, 다음 AWS AppConfig 서비스 호출에 필요한 구성 토큰을 추적하고, 백그라운드에서 구성 업데이트를 정기적으로 확인합니다. 다음 다이어그램은 작동 방식을 보여 줍니다.

시작하기 전 준비 사항

AWS AppConfig 에이전트 Lambda 확장 프로그램을 활성화하기 전에 다음을 수행하십시오.

AWS AppConfig 에이전트 Lambda 확장 프로그램 추가

AWS AppConfig 에이전트 Lambda 확장 프로그램을 사용하려면 Lambda에 확장 프로그램을 추가해야 합니다. Lambda 함수에 AWS AppConfig 에이전트 Lambda 확장 프로그램을 계층으로 추가하거나 Lambda 함수에서 확장을 컨테이너 이미지로 활성화하여 이 작업을 수행할 수 있습니다.

계층과 ARN을 사용하여 AWS AppConfig 에이전트 Lambda 확장 추가

AWS AppConfig 에이전트 Lambda 확장 프로그램을 사용하려면 확장 프로그램을 Lambda 함수에 계층으로 추가합니다. 함수에 계층을 추가하는 방법에 대한 자세한 내용은 AWS Lambda 개발자 안내서의 확장 구성을 참조하십시오. AWS Lambda 콘솔에 있는 확장 프로그램의 이름은 - -Extension입니다.AWS AppConfig 또한 Lambda에 확장을 계층으로 추가하는 경우 Amazon 리소스 이름(ARN)을 지정해야 합니다. 다음 목록 중 플랫폼 및 Lambda를 생성한 AWS 리전 위치에 해당하는 ARN을 선택하십시오.

함수에 추가하기 전에 확장을 테스트하려는 경우 다음 코드 예제를 사용하여 확장이 작동하는지 확인할 수 있습니다.

import urllib.request
                

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name'
    config = urllib.request.urlopen(url).read()
    return config

테스트하려면 Python용 Lambda 함수를 새로 생성하고 확장을 추가한 다음 Lambda 함수를 실행하십시오. Lambda 함수를 실행한 후 AWS AppConfig Lambda 함수는 http://localhost:2772 경로에 지정된 구성을 반환합니다. Lambda 함수 생성에 관한 정보는 AWS Lambda 개발자 안내서의 콘솔로 Lambda 함수 생성을 참조하십시오.

AWS AppConfig Agent Lambda 확장 프로그램을 컨테이너 이미지로 추가하려면 을 참조하십시오. 컨테이너 이미지를 사용하여 AWS AppConfig 에이전트 Lambda 확장 프로그램 추가

AWS AppConfig 에이전트 Lambda 확장 구성

다음 AWS Lambda 환경 변수를 변경하여 확장을 구성할 수 있습니다. 자세한 내용은 AWS Lambda 개발자 안내서의 AWS Lambda 환경 변수 사용을 참조하십시오.

구성 데이터 프리페칭

환경 변수 AWS_APPCONFIG_EXTENSION_PREFETCH_LIST는 함수 시작 시간을 개선할 수 있습니다. AWS AppConfig Agent Lambda 확장 프로그램이 초기화되면 Lambda가 함수를 초기화하고 핸들러를 AWS AppConfig 호출하기 시작하기 전부터 지정된 구성을 검색합니다. 함수가 요청하기 전에 로컬 캐시에서 구성 데이터를 이미 사용할 수 있는 경우도 있습니다.

프리페치 기능을 사용하려면 환경 변수 값을 구성 데이터에 해당하는 경로로 설정하십시오. 예를 들어 구성이 각각 “my_application”, “my_environment” 및 “my_configuration_data”라는 이름의 애플리케이션, 환경 및 구성 프로파일에 해당하는 경우 경로는 /applications/my_application/environments/my_environment/configurations/my_configuration_data입니다. 여러 구성 항목을 쉼표로 구분된 목록으로 나열하여 지정할 수 있습니다(리소스 이름에 쉼표가 포함된 경우 해당 이름 대신 리소스의 ID 값을 사용하십시오.).

다른 계정에서 구성 데이터에 액세스

AWS AppConfig Agent Lambda 확장 프로그램은 데이터에 권한을 부여하는 IAM 역할을 지정하여 다른 계정에서 구성 데이터를 검색할 수 있습니다. 이를 설정하려면 다음 단계를 수행합니다.

"header: value"

기능 플래그 구성에서 하나 이상의 플래그 검색

기능 플래그 구성(AWS.AppConfig.FeatureFlags 유형의 구성)의 경우, Lambda 확장을 사용하면 구성에서 단일 플래그 또는 플래그의 하위 집합을 검색할 수 있습니다. Lambda가 구성 프로필에서 몇 개의 플래그만 사용해야 하는 경우 하나 또는 두 개의 플래그를 검색하는 것이 유용합니다. 다음 예에서는 Python을 사용합니다.

로컬 HTTP 엔드포인트에서 AWS AppConfig 구성 데이터를 검색할 수 있습니다. 특정 플래그 또는 플래그 목록에 액세스하려면 AWS AppConfig 구성 프로필의 ?flag=flag_name 쿼리 파라미터를 사용하십시오.

단일 플래그와 해당 속성에 액세스하려면

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name'
    config = urllib.request.urlopen(url).read()
    return config

여러 플래그와 해당 속성에 액세스하려면

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two'
    config = urllib.request.urlopen(url).read()
    return config

AWS AppConfig 에이전트 Lambda 확장 로그 보기

로그에서 AWS AppConfig 에이전트 Lambda 확장 프로그램의 로그 데이터를 볼 수 있습니다. AWS Lambda 로그 항목 앞에는 가 붙습니다. appconfig agent 다음은 그 예입니다.

[appconfig agent] 2024/05/07 04:19:01 ERROR retrieve failure for 'SourceEventConfig:SourceEventConfigEnvironment:SourceEventConfigProfile': StartConfigurationSession: api error AccessDenied: User: arn:aws:sts::0123456789:assumed-role/us-east-1-LambdaRole/extension1 is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::0123456789:role/test1 (retry in 60s)