使用 Amazon AppConfig 代理 Lambda 扩展检索配置数据

Amazon Lambda 扩展是一个配套流程，用于增强 Lambda 函数的功能。可以在调用函数之前启动扩展，与函数并行运行，并在处理函数调用后继续运行。实际上，Lambda 扩展类似于与 Lambda 调用并行的客户端。此并行客户端可以在其生命周期中的任何时刻与您的函数交互。

如果您在 Lambda 函数中使用 Amazon AppConfig 功能标志或其他动态配置数据，那么我们建议您将代理 Lam Amazon AppConfig bda 扩展作为一个层添加到您的 Lambda 函数中。这使得调用功能标志变得更加简单，而且扩展本身包含了在降低成本的 Amazon AppConfig 同时简化使用的最佳实践。由于减少了对该 Amazon AppConfig 服务的 API 调用，缩短了 Lambda 函数的处理时间，从而降低了成本。有关 Lambda 扩展的更多信息，请参阅《Amazon Lambda 开发人员指南》中的Lambda 扩展。

本主题包括有关 A Amazon AppConfig gent Lambda 扩展的信息，以及如何配置该扩展以与您的 Lambda 函数配合使用的过程。

工作方式

如果您使用 Amazon AppConfig 管理没有 Lambda 扩展的 Lamb da 函数的配置，则必须通过与和 API 操作集成，将 Lambda 函数配置为接收配置更新。StartConfigurationSessionGetLatestConfiguration

将 Lambda Amazon AppConfig 代理扩展与您的 Lambda 函数集成可简化此过程。该扩展负责调用 Amazon AppConfig 服务、管理检索到的数据的本地缓存、跟踪下一次服务调用所需的配置令牌以及定期在后台检查配置更新。下图显示了它的工作方式。

开始前的准备工作

在启用 Amazon AppConfig 代理 Lambda 扩展之前，请执行以下操作：

添加 Amazon AppConfig 代理 Lambda 扩展

要使用 Amazon AppConfig 代理 Lambda 扩展，您需要将扩展程序添加到您的 Lambda 中。这可以通过将 Amazon AppConfig 代理 Lambda 扩展作为层添加到您的 Lambda 函数中，或者在 Lambda 函数上启用该扩展作为容器映像来实现。

使用层和 ARN 添加 Amazon AppConfig 代理 Lambda 扩展

要使用 Amazon AppConfig 代理 Lambda 扩展，您需要将该扩展作为一个层添加到 Lambda 函数中。有关如何向函数添加层的信息，请参阅《Amazon Lambda 开发者指南》中的配置扩展。 Amazon Lambda 控制台中扩展的名称是 Amazon-AppConfig- Extension。另请注意，当您将扩展作为层添加到 Lambda 时，您必须指定 Amazon 资源名称（ARN）。从以下列表中选择一个 ARN，该列表与平台和您创建 Lambda 的 Amazon Web Services 区域 位置相对应。

如果您想在将扩展添加到函数中之前对其进行测试，可以使用以下代码示例来验证其是否有效。

import urllib.request
                

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name'
    config = urllib.request.urlopen(url).read()
    return config

要对其进行测试，请为 Python 创建一个新的 Lambda 函数，添加扩展，然后运行 Lambda 函数。运行 Lambda 函数后，Lambd Amazon AppConfig a 函数会返回您为 http://localhost:2772 路径指定的配置。有关如何创建 Lambda 函数的信息，请参阅 Amazon Lambda 《 Lambda 开发人员指南》中的 使用控制台创建 Lambda 函数。

要将 Amazon AppConfig Agent Lambda 扩展添加为容器映像，请参阅。使用容器镜像添加 Amazon AppConfig 代理 Lambda 扩展

配置 Amazon AppConfig 代理 Lambda 扩展

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

预取配置数据

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

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

从其他账户访问配置数据

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

"header: value"

从功能标志配置中检索一个或多个标志

对于功能标志配置（类型 AWS.AppConfig.FeatureFlags 的配置），Lambda 扩展使您能够检索配置中的单个标志或标志子集。如果您的 Lambda 只需要使用配置文件中的几个标志，则检索一个或两个标志非常有用。下面的示例使用了 Python。

您可以从本地 HTTP 端点检索 Amazon AppConfig 配置数据。要访问特定标志或标志列表，请使用 Amazon AppConfig 配置文件的 ?flag=flag_name 查询参数。

访问单个标志及其属性

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name'
    config = urllib.request.urlopen(url).read()
    return config

访问多个标志及其属性

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two'
    config = urllib.request.urlopen(url).read()
    return config

查看 Amazon AppConfig 代理 Lambda 扩展日志

您可以在日志中查看 Ag Amazon AppConfig ent Lambda 扩展程序的 Amazon Lambda 日志数据。日志条目开头为。appconfig agent以下为示例。

[appconfig agent] 2024/05/07 04:19:01 ERROR retrieve failure for 'SourceEventConfig:SourceEventConfigEnvironment:SourceEventConfigProfile': StartConfigurationSession: api error AccessDenied: User: arn:aws:sts::0123456789:assumed-role/us-east-1-LambdaRole/extension1 is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::0123456789:role/test1 (retry in 60s)