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

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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:

  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 de Lambda, agregue la variable de entorno AWS_APPCONFIG_EXTENSION_ROLE_ARN a la función de Lambda con el ARN del rol creado 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 rol de IAM, la extensión no podrá recuperar los datos de configuración de la cuenta en la que se ejecuta la función de Lambda.

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

  • La siguiente tabla incluye una columna de valores de muestra. En función de la resolución del monitor, es posible que tenga que desplazarse hasta la parte inferior de la tabla y, a continuación, hacia la derecha para ver la columna.

Variable de entorno Detalles Valor predeterminado Valores de muestra

AWS_APPCONFIG_EXTENSION_HTTP_PORT

Esta variable de entorno especifica el puerto en el que se ejecuta el servidor HTTP local que aloja la extensión.

2772 2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

Esta variable de entorno especifica el nivel de detalle que registra el agente. Cada nivel incluye el nivel actual y todos los niveles superiores. El valor no distingue entre mayúsculas y minúsculas. Del más detallado al menos detallado, los niveles de registro son: tracedebug,info,warn, errorfatal, ynone. El trace registro incluye información detallada, incluida la información sobre el tiempo, sobre el agente.

info

rastro

depuración

info

aviso

error

fatal

none

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 3

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

Esta variable de entorno controla la frecuencia con la que el agente AWS AppConfig consulta los datos de configuración actualizados. Puede especificar un número de segundos para el intervalo. También puede especificar un número con una unidad de tiempo: s para segundos, m para minutos y h para horas. Si no se especifica una unidad, el agente ejecuta de forma predeterminada los segundos. Por ejemplo, 60, 60s y 1m dan como resultado el mismo intervalo de sondeo.

45

45

45 segundos

5 m

1h

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.

3000 ms

3 000

300 ms

5 s

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

Esta variable de entorno especifica los datos de configuración que solicita el agente en AWS AppConfig cuanto se inicia. Se pueden proporcionar varios identificadores de configuración en una lista separada por comas. La obtención previa de los datos de configuración AWS AppConfig puede reducir considerablemente el tiempo de arranque en frío de la función.

Ninguno

MyApp:MyEnv:MyConfig

abcd123: efgh456: ijkl789

MyApp::Configuración 1, ::Configuración 2 MyEnv MyApp MyEnv

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. Ninguno

encabezado: valor

h1: v1, h2: v2

AWS_APPCONFIG_EXTENSION_PROXY_URL Esta variable de entorno especifica la URL del proxy que se utilizará para las conexiones desde la AWS AppConfig extensión a. Servicios de AWSHTTPSy HTTP URLs son compatibles. Ninguno

http://localhost:7474

https://my-proxy.example.com

AWS_APPCONFIG_EXTENSION_ROLE_ARN Esta variable de entorno especifica el ARN del rol de IAM correspondiente a un rol que la extensión debe asumir para recuperar AWS AppConfig la configuración. Ninguno arn:aws:iam: :123456789012:role/ MyRole
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID Esta variable de entorno especifica el identificador externo que se utilizará junto con el ARN del rol asumido. Ninguno MyExternalId
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 rol de IAM asumido. Ninguno AWSAppConfigAgentSession
AWS_APPCONFIG_EXTENSION_SERVICE_REGION Esta variable de entorno especifica una región alternativa que la extensión debe usar para llamar al servicio. AWS AppConfig Si no se ha definido, la extensión usa el punto de conexión de la región actual. Ninguno

us-east-1

eu-west-1

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. Para obtener más información sobre el uso de estas características, consulte Uso de un manifiesto para habilitar características de recuperación adicionales.

Ninguno

Cuando se utiliza AWS AppConfig la configuración como manifiesto:. MyApp:MyEnv:MyManifestConfig

Al cargar el manifiesto desde el disco: file:/path/to/manifest.json

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

true

false