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 IAM rol que concede permisos a los datos. Para establecer esta política, siga estos pasos:

1. En la cuenta en la que AWS AppConfig se administran los datos de configuración, cree un rol con una política de confianza que conceda a la cuenta que ejecuta la función Lambda acceso a las appconfig:GetLatestConfiguration acciones appconfig:StartConfigurationSession y, además, a las acciones parciales o totales ARNs correspondientes a los recursos de AWS AppConfig configuración.

2. En la cuenta que ejecuta la función Lambda, añada la variable de AWS_APPCONFIG_EXTENSION_ROLE_ARN entorno a la función Lambda con la ARN función creada en el paso 1.

3. (Opcional) Si es necesario, se puede especificar un ID externo mediante la variable de entorno AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID. Del mismo modo, se puede configurar un nombre de sesión mediante la variable de entorno AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME.

nota

Observe la siguiente información.

• La extensión AWS AppConfig Agent Lambda solo puede recuperar datos de una cuenta. Si especifica un IAM rol, la extensión no podrá recuperar los datos de configuración de la cuenta en la que se ejecuta la función Lambda.

• AWS Lambda registra información sobre la extensión AWS AppConfig Agent Lambda y la función Lambda mediante Amazon Logs. CloudWatch

Variable de entorno	Detalles	Valor predeterminado
AWS_APPCONFIG_EXTENSION_HTTP_PORT	Esta variable de entorno especifica el puerto en el que se ejecuta el HTTP servidor local que aloja la extensión.	2772
AWS_APPCONFIG_EXTENSION_LOG_LEVEL	Esta variable de entorno especifica qué registros AWS AppConfig específicos de la extensión se envían a Amazon CloudWatch Logs para una función. Los valores válidos que no distinguen entre mayúsculas y minúsculas son debug, info, warn, error y none. La depuración incluye información detallada, incluida la información sobre el tiempo y la extensión.	info
AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS	Esta variable de entorno configura el número máximo de conexiones que la extensión utiliza para recuperar configuraciones de AWS AppConfig.	3
AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS	Esta variable de entorno controla la frecuencia con la que la extensión AWS AppConfig busca una configuración actualizada en cuestión de segundos.	45
AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS	Esta variable de entorno controla el tiempo máximo, en milisegundos, durante el que la extensión espera una respuesta AWS AppConfig al actualizar los datos de la caché. Si AWS AppConfig no responde en el período de tiempo especificado, la extensión omite este intervalo de sondeo y devuelve los datos almacenados en caché previamente actualizados.	3 000
AWS_APPCONFIG_EXTENSION_PREFETCH_LIST	Esta variable de entorno especifica los datos de configuración que la extensión comienza a recuperar antes de que la función se inicialice y se ejecute el controlador. Puede reducir considerablemente el tiempo de inicio en frío de la función.	Ninguna
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS	Esta variable de entorno especifica los encabezados requeridos por el proxy al que se hace referencia en la variable de entorno AWS_APPCONFIG_EXTENSION_PROXY_URL. El valor es una lista de encabezados separados por comas. Todos los encabezados utilizan el siguiente formulario: "header: value"	Ninguna
AWS_APPCONFIG_EXTENSION_PROXY_URL	Esta variable de entorno especifica el proxy URL que se utilizará para las conexiones desde la AWS AppConfig extensión a. Servicios de AWSHTTPSy HTTP URLs son compatibles.	Ninguna
AWS_APPCONFIG_EXTENSION_ROLE_ARN	Esta variable de entorno especifica la IAM función ARN correspondiente a una función que debe asumir la AWS AppConfig extensión para recuperar la configuración.	Ninguna
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID	Esta variable de entorno especifica el identificador externo que se debe utilizar junto con el rol asumidoARN.	Ninguna
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME	Esta variable de entorno especifica el nombre de la sesión que se va a asociar a las credenciales del IAM rol asumido.	Ninguna
AWS_APPCONFIG_EXTENSION_SERVICE_REGION	Esta variable de entorno especifica una región alternativa que la extensión debe usar para llamar al AWS AppConfig servicio. Si no se ha definido, la extensión usa el punto de conexión de la región actual.	Ninguna
AWS_APPCONFIG_EXTENSION_MANIFEST	Esta variable de entorno configura el AWS AppConfig Agente para que aproveche las funciones adicionales por configuración, como las recuperaciones de varias cuentas y el almacenamiento de la configuración en el disco. Puede introducir uno de los siguientes valores: "app:env:manifest-config" "file:/fully/qualified/path/to/manifest.json" Para obtener más información sobre el uso de estas características, consulte Usar un manifiesto para habilitar funciones de recuperación adicionales.	true
AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST	Esta variable de entorno configura el AWS AppConfig agente para que espere hasta que se procese el manifiesto antes de completar el inicio.	true