매니페스트를 사용하여 추가 검색 기능 활성화

AWS AppConfig 에이전트는 애플리케이션의 구성을 검색하는 데 도움이 되는 다음과 같은 추가 기능을 제공합니다.

• 여러 계정에서 구성을 검색하도록 AWS AppConfig Agent 구성: 기본 또는 검색 AWS 계정 에서 AWS AppConfig 에이전트를 사용하여 여러 공급업체 계정에서 구성 데이터를 검색합니다.

• 구성 복사본을 디스크에 쓰도록 AWS AppConfig Agent 구성: AWS AppConfig Agent를 사용하여 구성 데이터를 디스크에 기록합니다. 이 기능을 사용하면 디스크에서 구성 데이터를 읽는 애플리케이션을 사용하는 고객이 AWS AppConfig와 연동할 수 있습니다.

에이전트 매니페스트 이해

이러한 AWS AppConfig 에이전트 기능을 활성화하려면 매니페스트를 생성합니다. 매니페스트는 에이전트가 수행할 수 있는 작업을 제어하기 위해 제공하는 구성 데이터 세트입니다. 매니페스트는 JSON으로 작성됩니다. 여기에는 배포한 다양한 구성에 해당하는 최상위 키 세트가 포함되어 있습니다 AWS AppConfig.

매니페스트에는 여러 구성이 포함될 수 있습니다. 또한 매니페스트의 각 구성은 지정된 구성에 사용할 하나 이상의 에이전트 기능을 식별할 수 있습니다. 매니페스트의 콘텐츠는 다음 형식을 사용합니다.

{
    "application_name:environment_name:configuration_name": {
        "agent_feature_to_enable_1": {
            "feature-setting-key": "feature-setting-value"
        },
        "agent_feature_to_enable_2": {
            "feature-setting-key": "feature-setting-value"
        }
    }
}

다음은 두 가지 구성이 있는 매니페스트의 JSON 예제입니다. 첫 번째 구성(MyApp)은 AWS AppConfig 에이전트 기능을 사용하지 않습니다. 두 번째 구성(My2ndApp)은 디스크에 구성 복사본 쓰기와 다중 계정 검색 기능을 사용합니다.

{
        "MyApp:Test:MyAllowListConfiguration": {},
        
        "My2ndApp:Beta:MyEnableMobilePaymentsFeatureFlagConfiguration": {
            "credentials": {
                "roleArn": "arn:us-west-1:iam::123456789012:role/MyTestRole",
                "roleExternalId": "00b148e2-4ea4-46a1-ab0f-c422b54d0aac",
                "roleSessionName": "AwsAppConfigAgent",
                "credentialsDuration": "2h"
            },
            "writeTo": {
                "path": "/tmp/aws-appconfig/my-2nd-app/beta/my-enable-payments-feature-flag-configuration.json"
            }
        }
    }

에이전트 매니페스트를 제공하는 방법

매니페스트를 AWS AppConfig 에이전트가 읽을 수 있는 위치에 파일로 저장할 수 있습니다. 또는 매니페스트를 AWS AppConfig 구성으로 저장하고 에이전트가 해당 매니페스트를 가리키도록 할 수 있습니다. 에이전트 매니페스트를 제공하려면 다음 값 중 하나로 MANIFEST 환경 변수를 설정해야 합니다.

매니페스트 위치	환경 변수 값	사용 사례
파일	file:/path/to/agent-manifest.json	매니페스트가 자주 변경되지 않는 경우 이 방법을 사용합니다.
AWS AppConfig 구성	application-name:environment-name:configuration-name	동적 업데이트에는 이 방법을 사용합니다. 다른 AWS AppConfig 구성을 저장하는 것과 동일한 방식으로에 저장된 매니페스트를 업데이트하고 구성 AWS AppConfig 으로 배포할 수 있습니다.
환경 변수	매니페스트 콘텐츠(JSON)	매니페스트가 자주 변경되지 않는 경우 이 방법을 사용합니다. 이 방법은 파일을 노출하는 것보다 환경 변수를 설정하는 것이 더 쉬운 컨테이너 환경에서 유용합니다.

AWS AppConfig 에이전트에 대한 변수 설정에 대한 자세한 내용은 사용 사례에 대한 관련 주제를 참조하세요.

• AWS AppConfig 에이전트 Lambda 확장 구성

• Amazon EC2에서 AWS AppConfig 에이전트 사용

• Amazon ECS 및 Amazon EKS에서 AWS AppConfig 에이전트 사용