

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

# 매니페스트를 사용하여 추가 검색 기능 활성화
<a name="appconfig-agent-how-to-use-additional-features"></a>

AWS AppConfig 에이전트는 애플리케이션에 대한 구성을 검색하는 데 도움이 되는 다음과 같은 추가 기능을 제공합니다.
+ [여러 계정에서 구성을 검색하도록 AWS AppConfig 에이전트 구성](appconfig-agent-how-to-use-additional-features-multi-account.md): 기본 또는 *검색* AWS 계정 에서 AWS AppConfig 에이전트를 사용하여 여러 공급업체 계정에서 구성 데이터를 검색합니다.
+ [디스크에 구성 복사본을 쓰도록 AWS AppConfig 에이전트 구성](appconfig-agent-how-to-use-additional-features-write-to-disk.md): AWS AppConfig Agent를 사용하여 구성 데이터를 디스크에 기록합니다. 이 기능을 사용하면 디스크에서 구성 데이터를 읽는 애플리케이션을 사용하는 고객이 AWS AppConfig와 연동할 수 있습니다.

## 에이전트 매니페스트 이해
<a name="appconfig-agent-how-to-use-additional-features-about-manifests"></a>

이러한 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:aws: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 확장 구성](appconfig-integration-lambda-extensions-config.md)
+ [Amazon EC2에서 AWS AppConfig 에이전트 사용](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-integration-ec2.html#appconfig-integration-ec2-configuring)
+ [Amazon ECS 및 Amazon EKS에서 AWS AppConfig 에이전트 사용](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-integration-containers-agent.html#appconfig-integration-containers-agent-configuring)