本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用清单启用其他检索功能

AWS AppConfig Agent 还提供以下附加功能来帮助您检索应用程序的配置。

了解代理清单

要启用这些 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 Agent 设置变量的更多信息，请参阅与您的用例相关的主题：

将 AWS AppConfig Agent 配置为从多个账户检索配置

您可以通过在 AWS AppConfig 代理清单中输入凭据覆盖 AWS 账户 来配置 AWS AppConfig 代理以从多个中检索配置。证书覆盖包括 (ARN) 角色的 Amazon 资源名称 AWS Identity and Access Management (IAM)、角色 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（供应商账户）指定的不同角色，然后调用GetLatestConfigurationAPI操作来检索在这些账户中 AWS AppConfig 运行的配置数据：

配置从供应商账户检索配置数据的权限

AWS AppConfig 在检索账户中运行的代理需要权限才能从供应商帐户检索配置数据。您可以通过在每个供应商账户中创建 AWS Identity and Access Management (IAM) 角色来授予代理权限。 AWS AppConfig 检索账户中的代理扮演此角色从供应商账户获取数据。完成本节中的步骤，创建IAM权限策略、IAM角色并将代理替代项添加到清单中。

开始前的准备工作

在中创建权限策略和角色之前，请收集以下信息IAM。

创建权限策略

使用以下过程使用IAM控制台创建权限策略。完成将为检索账户提供配置数据的每个 AWS 账户 步骤中的步骤。

创建IAM角色

使用以下步骤使用IAM控制台创建IAM角色。完成将为检索账户提供配置数据的每个 AWS 账户 步骤中的步骤。

向清单中添加凭证覆盖

在供应商账户中创建IAM角色后，更新取回账户中的清单。具体而言，添加凭证块和ARN用于从供应商账户检索配置数据的IAM角色。以下是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 Agent 配置为以纯文本形式自动将配置副本存储到磁盘。此功能使客户能够使用从磁盘读取配置数据以进行集成的应用程序 AWS AppConfig。

此功能不是为用作配置备份功能而设计的。 AWS AppConfig 代理无法读取复制到磁盘的配置文件。如果要将配置备份到磁盘，请参阅在 Amazon 上使用 AWS AppConfig 代理EC2或在 Amazon BACKUP_DIRECTORY 和 Amazon 上使用 AWS AppConfig 代理的ECS和PRELOAD_BACKUP环境变量EKS。

验证将配置副本写入磁盘是否正常工作

您可以通过查看 AWS AppConfig 代理日志来验证配置副本是否正在写入磁盘。带有 “INFO写入配置” 字样的INFO日志条目application:environment:configuration'到 file_path“表示 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