Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

其他检索功能

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

关于代理清单

要启用这些 Amazon AppConfig 代理功能，您需要创建清单。清单是您提供的一组配置数据，用于控制代理可以执行的操作。清单是用 JSON 编写的。它包含一组顶级密钥，这些密钥对应于您部署的不同配置 Amazon 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) 不使用任何 Amazon 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"
            }
        }
    }

如何提供代理清单

您可以将清单作为文件存储在 Amazon AppConfig 代理可以读取的位置。或者，您可以将清单存储为 Amazon AppConfig 配置并将代理指向它。要提供代理清单，必须使用以下值之一设置MANIFEST环境变量：

有关为 Amazon AppConfig Agent 设置变量的更多信息，请参阅与您的用例相关的主题：

多账号检索

您可以通过在 Amazon AppConfig 代理清单中输入凭据覆盖 Amazon Web Services 账户 来配置 Amazon AppConfig 代理以从多个中检索配置。证书覆盖包括 (IAM) 角色的 Amazon 资源名称 Amazon 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 角色。您可以在单个清单中为不同的配置指定一组不同的凭据替换。下图显示 Amazon AppConfig 代理在账户 A（检索账户）中运行时，如何扮演为账户 B 和账户 C（供应商账户）指定的不同角色，然后调用 GetLatestConfigurationAPI 操作来检索在这些账户中 Amazon AppConfig 运行的配置数据：

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

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

开始前的准备工作

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

创建权限策略

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

创建 IAM 角色

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

向清单中添加凭证覆盖

在供应商账户中创建 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" 
        }
    }
}

验证多账户检索是否有效

您可以通过查看代理日志来验证该代理是否能够从多个账户检索配置数据。 Amazon 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

将配置副本写入磁盘

您可以将 Amazon AppConfig Agent 配置为以纯文本形式自动将配置副本存储到磁盘。此功能使客户能够使用从磁盘读取配置数据以进行集成的应用程序 Amazon AppConfig。

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

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

您可以通过查看 Amazon AppConfig 代理日志来验证配置副本是否正在写入磁盘。带有 “INFO 将配置' 应用程序：环境：配置 '写入 f ile_path” 的INFO日志条目表示 Amazon 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