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

추가 검색 기능

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 환경 변수를 설정해야 합니다.

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

다중 계정 검색

AWS AppConfig 에이전트 매니페스트에 자격 증명 재정의를 AWS 계정 입력하여 여러 구성에서 구성을 검색하도록 에이전트를 구성할 수 있습니다. AWS AppConfig 자격 증명 재정의에는 (IAM) 역할의 Amazon 리소스 이름 AWS Identity and Access Management (ARN), 역할 ID, 세션 이름, 에이전트가 역할을 맡을 수 있는 기간이 포함됩니다.

매니페스트의 “자격 증명” 섹션에 이러한 세부 정보를 입력합니다. “자격 증명” 섹션은 다음 형식을 사용합니다.

{
    "application_name:environment_name:configuration_name": {
        "credentials": {
            "roleArn": "arn:partition:iam::account_ID:role/roleName",
            "roleExternalId": "string",
            "roleSessionName": "string",
            "credentialsDuration": "time_in_hours" 
        }
    }
}

예:

{
    "My2ndApp:Beta:MyEnableMobilePaymentsFeatureFlagConfiguration": {
        "credentials": {
            "roleArn": "arn:us-west-1:iam::123456789012:role/MyTestRole",
            "roleExternalId": "00b148e2-4ea4-46a1-ab0f-c422b54d0aac",
            "roleSessionName": "AWSAppConfigAgent",
            "credentialsDuration": "2h" 
        }
    }
}

구성을 검색하기 전에 에이전트는 매니페스트에서 구성에 대한 자격 증명 세부 정보를 읽은 다음 해당 구성에 지정된 IAM 역할을 맡습니다. 단일 매니페스트에서 여러 구성에 대해 서로 다른 자격 증명 재정의 세트를 지정할 수 있습니다. 다음 다이어그램은 AWS AppConfig 에이전트가 계정 A (검색 계정) 에서 실행되는 동안 계정 B와 C (공급업체 계정) 에 지정된 별도의 역할을 맡은 다음 GetLatest구성 API 작업을 호출하여 해당 계정에서 실행되는 구성 데이터를 검색하는 방법을 보여줍니다. AWS AppConfig

공급업체 계정에서 구성 데이터를 검색할 수 있는 권한을 구성합니다.

AWS AppConfig 검색 계정에서 실행되는 에이전트는 공급업체 계정에서 구성 데이터를 검색할 수 있는 권한이 필요합니다. 각 공급업체 계정에서 AWS Identity and Access Management (IAM) 역할을 생성하여 에이전트에게 권한을 부여합니다. AWS AppConfig 검색 계정의 에이전트는 이 역할을 맡아 공급업체 계정으로부터 데이터를 가져옵니다. 이 섹션의 절차를 완료하여 IAM 권한 정책, IAM 역할을 생성하고 매니페스트에 에이전트 재정의를 추가하세요.

시작하기 전 준비 사항

IAM에서 권한 정책과 역할을 생성하기 전에 다음 정보를 수집하십시오.

권한 정책 생성

다음 절차를 사용하여 IAM 콘솔을 사용하여 권한 정책을 생성합니다. 검색 계정의 구성 데이터를 AWS 계정 제공하는 각 절차를 완료하십시오.

IAM 역할 생성

다음 절차를 사용하여 IAM 콘솔을 사용하여 IAM 역할을 생성합니다. 검색 계정의 구성 데이터를 AWS 계정 제공하는 각 절차를 완료하십시오.

매니페스트에 자격 증명 재정의를 추가합니다.

공급업체 계정에서 IAM 역할을 생성한 후 검색 계정에서 매니페스트를 업데이트하십시오. 특히 공급업체 계정에서 구성 데이터를 검색하기 위한 자격 증명 블록과 IAM 역할 ARN을 추가합니다. JSON 형식은 다음과 같습니다.

{
    "vendor_application_name:vendor_environment_name:vendor_configuration_name": {
        "credentials": {
            "roleArn": "arn:partition:iam::vendor_account_ID:role/name_of_role_created_in_vendor_account",
            "roleExternalId": "string",
            "roleSessionName": "string",
            "credentialsDuration": "time_in_hours" 
        }
    }
}

예:

{
    "My2ndApp:Beta:MyEnableMobilePaymentsFeatureFlagConfiguration": {
        "credentials": {
            "roleArn": "arn:us-west-1:iam::123456789012:role/MyTestRole",
            "roleExternalId": "00b148e2-4ea4-46a1-ab0f-c422b54d0aac",
            "roleSessionName": "AwsAppConfigAgent",
            "credentialsDuration": "2h" 
        }
    }
}

다중 계정 검색이 제대로 작동하는지 확인

에이전트 로그를 검토하여 해당 에이전트가 여러 계정에서 구성 데이터를 검색할 수 있는지 확인할 수 있습니다. AWS AppConfig 'YourApplicationName:YourEnvironmentName: YourConfigurationName '에 대해 검색된 초기 데이터의 INFO 레벨 로그는 성공적인 검색을 위한 최상의 지표입니다. 검색이 실패하는 경우 실패 이유를 나타내는 ERROR 레벨 로그가 표시됩니다. 공급업체 계정에서 성공적으로 검색한 예는 다음과 같습니다.

[appconfig agent] 2023/11/13 11:33:27 INFO AppConfig Agent 2.0.x
[appconfig agent] 2023/11/13 11:33:28 INFO serving on localhost:2772
[appconfig agent] 2023/11/13 11:33:28 INFO retrieved initial data for 'MyTestApplication:MyTestEnvironment:MyDenyListConfiguration' in XX.Xms

구성 사본을 디스크에 쓰기

구성 사본을 디스크에 일반 텍스트로 자동 저장하도록 AWS AppConfig 에이전트를 구성할 수 있습니다. 이 기능을 사용하면 디스크에서 구성 데이터를 읽는 애플리케이션을 사용하는 고객이 통합할 수 AWS AppConfig있습니다.

이 기능은 구성 백업 기능으로 사용하도록 설계되지 않았습니다. AWS AppConfig 에이전트는 디스크에 복사된 구성 파일을 읽지 않습니다. 구성을 디스크에 백업하려면 Amazon EC2에서 에이전트 사용 또는 Amazon ECS BACKUP_DIRECTORY 및 Amazon EKS에서 AWS AppConfigAWS AppConfig 에이전트 사용에 대한 및 PRELOAD_BACKUP 환경 변수를 참조하십시오.

디스크에 구성 복사본 쓰기가 제대로 작동하는지 확인합니다.

AWS AppConfig 에이전트 로그를 검토하여 구성 사본이 디스크에 기록되고 있는지 확인할 수 있습니다. “정보 작성 구성 '애플리케이션: 환경: 구성' to file_path”라는 구문이 있는 INFO 로그 항목은 AWS AppConfig 에이전트가 구성 복사본을 디스크에 기록했음을 나타냅니다.

예:

[appconfig agent] 2023/11/13 11:33:27 INFO AppConfig Agent 2.0.x
[appconfig agent] 2023/11/13 11:33:28 INFO serving on localhost:2772
[appconfig agent] 2023/11/13 11:33:28 INFO retrieved initial data for 'MobileApp:Beta:EnableMobilePayments' in XX.Xms
[appconfig agent] 2023/11/13 17:05:49 INFO wrote configuration 'MobileApp:Beta:EnableMobilePayments' to /tmp/configs/your-app/your-env/your-config.json