Recuperación de datos de configuración mediante la extensión AWS AppConfig Agent Lambda

Una AWS Lambda extensión es un proceso complementario que aumenta las capacidades de una función Lambda. Una extensión puede iniciarse antes de que se invoque una función, ejecutarse en paralelo con una función y continuar ejecutándose después de que se procese la invocación de una función. Una extensión de Lambda es como un cliente que se ejecuta en paralelo a una invocación de Lambda. Este cliente paralelo puede interactuar con su función en cualquier momento de su ciclo de vida.

Si utiliza indicadores de AWS AppConfig características u otros datos de configuración dinámica en una función de Lambda, le recomendamos que añada la extensión Agent AWS AppConfig Lambda como capa a la función de Lambda. Esto simplifica la llamada a los indicadores de funciones y la propia extensión incluye prácticas recomendadas que simplifican su uso y, al mismo AWS AppConfig tiempo, reducen los costes. La reducción de los costos se debe a la reducción de las llamadas a la API al AWS AppConfig servicio y a la reducción de los tiempos de procesamiento de las funciones de Lambda. Para obtener más información sobre las extensiones de Lambda, consulte Extensiones de Lambda en la Guía para desarrolladores de AWS Lambda .

En este tema se incluye información sobre la extensión AWS AppConfig Agent Lambda y el procedimiento para configurar la extensión para que funcione con la función Lambda.

Funcionamiento

Si se utiliza AWS AppConfig para gestionar las configuraciones de una función de Lambda sin extensiones de Lambda, debe configurar la función de Lambda para que reciba las actualizaciones de configuración mediante la integración con las acciones de la API. StartConfigurationSessionGetLatestConfiguration

La integración de la extensión AWS AppConfig Agent Lambda con la función Lambda simplifica este proceso. La extensión se encarga de llamar al AWS AppConfig servicio, administrar una caché local de los datos recuperados, rastrear los identificadores de configuración necesarios para las próximas llamadas al servicio y comprobar periódicamente si hay actualizaciones de configuración en segundo plano. El siguiente diagrama muestra cómo funciona.

Antes de empezar

Antes de activar la extensión AWS AppConfig Agent Lambda, haga lo siguiente:

Añadir la extensión AWS AppConfig Agent Lambda

Para utilizar la extensión AWS AppConfig Agent Lambda, debe añadir la extensión a su Lambda. Esto se puede hacer añadiendo la extensión AWS AppConfig Agent Lambda a la función Lambda como capa o activando la extensión en una función Lambda como imagen contenedora.

Agregar la extensión de Lambda del agente de AWS AppConfig mediante una capa y un ARN

Para usar la extensión AWS AppConfig Agent Lambda, añada la extensión a la función Lambda como una capa. Para obtener información sobre cómo añadir una capa a la función, consulte Configuración de extensiones en la Guía del desarrollador de AWS Lambda . El nombre de la extensión en la AWS Lambda consola es AWS- AppConfig -Extension. Tenga en cuenta también que cuando agregue la extensión como una capa a su Lambda, debe especificar un nombre de recurso de Amazon (ARN). Elija un ARN de una de las siguientes listas que corresponda a la plataforma y al Región de AWS lugar donde creó la Lambda.

Si desea probar la extensión antes de añadirla a la función, puede comprobar que funciona mediante el siguiente ejemplo de código.

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

Para probarlo, cree una función de Lambda nueva para Python, agregue la extensión y ejecute la función de Lambda. Tras ejecutar la función Lambda, la función AWS AppConfig Lambda devuelve la configuración que especificó para la ruta http://localhost:2772. Para obtener información sobre la creación de una función de Lambda, consulte Creación de una función Lambda con la consola en la Guía para desarrolladores de AWS Lambda .

Para añadir la extensión AWS AppConfig Agent Lambda como imagen de contenedor, consulte. Uso de una imagen de contenedor para añadir la extensión AWS AppConfig Agent Lambda

Configuración de la extensión de Lambda del agente de AWS AppConfig

Puede configurar la extensión cambiando las siguientes variables de AWS Lambda entorno. Para obtener más información, consulte Uso de variables de AWS Lambda entorno en la Guía para AWS Lambda desarrolladores.

Recuperación previa de los datos de configuración

La variable de entorno AWS_APPCONFIG_EXTENSION_PREFETCH_LIST puede mejorar el tiempo de inicio de la función. Cuando se inicializa la extensión AWS AppConfig Agent Lambda, recupera la configuración especificada antes de que AWS AppConfig Lambda comience a inicializar la función e invocar el controlador. En algunos casos, los datos de configuración ya están disponibles en la memoria caché local antes de que la función los solicite.

Para utilizar la función de obtención previa, defina el valor de la variable de entorno en la ruta correspondiente a los datos de configuración. Por ejemplo, si la configuración corresponde a una aplicación, un entorno y un perfil de configuración denominados respectivamente "my_application", "my_environment" y "my_configuration_data", la ruta sería /applications/my_application/environments/my_environment/configurations/my_configuration_data. Puede especificar varios elementos de configuración enumerándolos en una lista separada por comas (si tiene un nombre de recurso que incluye una coma, utilice el valor de ID del recurso en lugar de su nombre).

Acceso a los datos de configuración desde otra cuenta

La extensión AWS AppConfig Agent Lambda puede recuperar datos de configuración de otra cuenta especificando un rol de IAM que concede permisos a los datos. Para establecer esta política, siga estos pasos:

"header: value"

Recuperación de una o varias marcas de una configuración de marcas de características

Para las configuraciones de marcas de características (configuraciones de tipo AWS.AppConfig.FeatureFlags), la extensión de Lambda le permite recuperar una sola marca o un subconjunto de marcas de una configuración. Recuperar una o dos marcas es útil si su Lambda solo necesita usar algunas marcas del perfil de configuración. El siguiente ejemplo usa Python.

Puede recuperar los datos de AWS AppConfig configuración de un punto final HTTP local. Para acceder a una marca específica o a una lista de marcas, utilice el parámetro de consulta ?flag=flag_name para un perfil de configuración de AWS AppConfig .

Para acceder a una única marca y sus atributos

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

Para acceder a varias marcas y sus atributos

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

Visualización de los registros de extensiones de AWS AppConfig Agent Lambda

Puede ver los datos de registro de la extensión AWS AppConfig Agent Lambda en los AWS Lambda registros. Las entradas de registro van precedidas de. appconfig agent A continuación se muestra un ejemplo.

[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)