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.
Invoque localmente funciones de eventos de Lambda con AWS SAM
Invocar localmente una función de eventos de Lambda antes de probarla o implementarla en la nube puede tener varios beneficios. Le permite probar la lógica de la función con mayor rapidez. Probar primero a nivel local reduce la probabilidad de identificar problemas al realizar las pruebas en la nube o durante la implementación, lo que puede ayudarle a evitar costos innecesarios. Además, las pruebas locales facilitan la depuración.
Puede invocar la función de Lambda de forma local mediante el comando invocar sam local y proporcionando el ID lógico de la función y un archivo de eventos. sam local invoke también acepta stdin como evento. Para más información, consulta Evento en la Guía para desarrolladores de AWS Lambda . Para obtener información sobre los diferentes formatos de mensajes de eventos AWS servicios, consulte Utilizando AWS Lambda con otros servicios en el AWS Lambda Guía para desarrolladores.
Las invocaciones locales ejecutan el código de función en su entorno local. Para el código que no escribiste ni revisaste, usa el servicio Lambda, que lo ejecuta de forma aislada de tu máquina.
El sam local invoke el comando corresponde al AWS Command Line Interface (AWS CLI) comando aws lambda invoke
Debes ejecutar el comando sam local invoke en el directorio del proyecto que contiene la función que desea invocar.
Ejemplos:
# Invoking function with event file $ sam local invoke "Ratings" -e event.json # Invoking function with event via stdin $ echo '{"message": "Hey, are you there?" }' | sam local invoke --event - "Ratings" # For more options $ sam local invoke --help
Archivo de variables de entorno
Para declarar localmente las variables de entorno que anulan los valores definidos en las plantillas, haga lo siguiente:
-
Crea un JSON o
.envarchivo que contiene las variables de entorno que se van a anular. -
Usa el argumento
--env-varspara anular los valores definidos en sus plantillas.
El --env-vars la opción admite dos formatos de archivo. El formato del archivo se detecta automáticamente en función del contenido del archivo.
Declaración de variables de entorno con JSON
Para declarar variables de entorno que se apliquen globalmente a todos los recursos, especifica un objeto Parameters como el siguiente:
{ "Parameters": { "TABLE_NAME": "localtable", "BUCKET_NAME": "amzn-s3-demo-bucket", "STAGE": "dev" } }
Para declarar variables de entorno diferentes para cada recurso, especifica objetos para cada recurso de la siguiente manera:
{ "MyFunction1": { "TABLE_NAME": "localtable", "BUCKET_NAME": "amzn-s3-demo-bucket", }, "MyFunction2": { "TABLE_NAME": "localtable", "STAGE": "dev" } }
Al especificar objetos para cada recurso, puede utilizar los siguientes identificadores, enumerados en orden de mayor a menor prioridad:
-
logical_id -
function_id -
function_name -
Identificador de ruta completo
Puedes utilizar los dos métodos anteriores para declarar variables de entorno juntos en un único archivo. Al hacerlo, las variables de entorno que haya proporcionado para recursos específicos tienen prioridad sobre las variables de entorno globales.
Guarde las variables de entorno en un archivo JSON, como env.json.
Declarar variables de entorno con archivos.env
También puedes usar un .env archivo para declarar variables de entorno. Variables declaradas en un .env el archivo se aplica globalmente a todas las funciones, equivalentes a Parameters objeto en formato JSON.
TABLE_NAME=localtable BUCKET_NAME=amzn-s3-demo-bucket STAGE=dev
El .env el formato admite comentarios (líneas que comienzan por #) y valores entre comillas.
El .env el formato solo admite variables de entorno globales. Para declarar variables de entorno específicas de una función, utilice el formato JSON.
Anulación de valores de variables de entorno
Para reemplazar las variables de entorno con las definidas en su archivo de variables de entorno, utilice el --env-vars argumento con el invoke o start-api comandos. Por ejemplo:
# Using a JSON file sam local invoke --env-vars env.json # Using a .env file sam local invoke --env-vars .env
Capas
Si tu aplicación incluye capas, para obtener información sobre cómo depurar los problemas con las capas de su host local, consulta Aumente la eficiencia con las capas Lambda con AWS SAM.
Más información
Para ver un ejemplo práctico de cómo invocar funciones localmente, consulte Módulo 2: Ejecute localmente