配置 AWS AppConfig 代理 Lambda 扩展 - AWS AppConfig

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

配置 AWS AppConfig 代理 Lambda 扩展

您可以通过更改以下 AWS Lambda 环境变量来配置扩展。有关更多信息，请参阅《AWS Lambda 开发人员指南》中的使用 AWS Lambda 环境变量。

预取配置数据

环境变量 AWS_APPCONFIG_EXTENSION_PREFETCH_LIST 可以改善函数的启动时间。初始化 A AWS AppConfig gent Lambda 扩展时，它会检索 AWS AppConfig Lambda 开始初始化您的函数并调用您的处理程序之前的指定配置。在某些情况下，在函数请求配置数据之前，配置数据已在本地缓存中可用。

要使用预取功能，请将环境变量的值设置为与配置数据对应的路径。例如，如果您的配置对应于分别名为 “my_application”、“my_environmention” 和 “my_configuration_data” 的应用程序、环境和配置文件，则路径将为 /applications/my_application/environments/my_environment/configurations/my_configuration_data。您可以通过以逗号分隔的列表列出多个配置项目来指定这些配置项目（如果资源名称中包含逗号，请使用资源的 ID 值而不是其名称）。

从其他账户访问配置数据

AWS AppConfig Agent Lambda 扩展可以通过指定向其他账户授予数据权限的IAM角色来检索配置数据。要设置此策略，请按照下列步骤操作：

  1. 在 AWS AppConfig 用于管理配置数据的账户中，创建一个具有信任策略的角色，该策略允许运行 Lambda 函数的账户访问appconfig:StartConfigurationSession和appconfig:GetLatestConfiguration操作以及与 AWS AppConfig 配置资源ARNs对应的部分或完整操作。

  2. 在运行 Lambda 函数的账户中，使用在步骤 1 中创建的角色将AWS_APPCONFIG_EXTENSION_ROLE_ARN环境变量添加到 Lambda 函数中。ARN

  3. （可选）如果需要，可使用 AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID 环境变量指定外部 ID。同样，可使用 AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME 环境变量配置会话名称。

注意

请注意以下信息。

  • AWS AppConfig 代理 Lambda 扩展只能从一个账户检索数据。如果您指定IAM角色，则扩展程序将无法从运行 Lambda 函数的账户中检索配置数据。

  • AWS Lambda 使用亚马逊日志记录有关 AWS AppConfig 代理 Lambda 扩展和 Lambda 函数的信息。 CloudWatch

环境变量 详细信息 默认值

AWS_APPCONFIG_EXTENSION_HTTP_PORT

此环境变量指定托管扩展程序的本地HTTP服务器的端口。

 2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

此环境变量指定将哪些 AWS AppConfig 特定于扩展的日志发送到函数的 Amazon CloudWatch Logs。不区分大小写的有效值包括 debug、info、warn、error 和 none。调试包括有关扩展的详细信息，包括计时信息。

info

AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS

此环境变量配置扩展用于从 AWS AppConfig检索配置的最大连接数。

 3

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

此环境变量控制扩展程序轮询更新配置的频率（以秒 AWS AppConfig 为单位）。

 45

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

此环境变量控制扩展程序在刷新缓存中的数据 AWS AppConfig 时等待响应的最大时间（以毫秒为单位）。如果在指定的时间内 AWS AppConfig 没有响应，则扩展程序会跳过此轮询间隔并返回之前更新的缓存数据。

 3000

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

此环境变量用于指定在函数初始化和处理程序运行之前，扩展开始检索的配置数据。它可以大大缩短函数的冷启动时间。

 无
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS 此环境变量用于指定 AWS_APPCONFIG_EXTENSION_PROXY_URL 环境变量中引用的代理所需的标头。其值是以逗号分隔的标头列表。每个标头使用以下形式：
"header: value"
 无
AWS_APPCONFIG_EXTENSION_PROXY_URL 此环境变量指定用于从 AWS AppConfig 扩展到的连接的代理URL AWS 服务。 HTTPS并HTTPURLs得到支持。 无
AWS_APPCONFIG_EXTENSION_ROLE_ARN 此环境变量指定了与该IAM角色ARN相对应的角色，该角色应由 AWS AppConfig 扩展程序承担以检索配置。 无
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID 此环境变量指定要与代入的角色一起使用的外部 ID ARN。 无
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME 此环境变量指定要与所担任IAM角色的凭据关联的会话名称。 无
AWS_APPCONFIG_EXTENSION_SERVICE_REGION 此环境变量指定了扩展程序在调用 AWS AppConfig 服务时应使用的备用区域。如果未定义，则扩展将使用当前区域中的终端节点。 无

AWS_APPCONFIG_EXTENSION_MANIFEST

此环境变量将 AWS AppConfig Agent 配置为利用其他每个配置的功能，例如多帐户检索和将配置保存到磁盘。您可以输入以下值之一：

  • "app:env:manifest-config"

  • "file:/fully/qualified/path/to/manifest.json"

有关使用这些功能的更多信息，请参阅 使用清单启用其他检索功能。

 true

AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST

此环境变量将 AWS AppConfig Agent 配置为等到清单处理完毕后再完成启动。

 true