Invoque funciones Lambda localmente con AWS SAM

La invocación local de una función de Lambda antes de probarla o implementarla en la nube puede tener diversas ventajas. 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 sam local invoke 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 formatos de mensajes de eventos de distintos AWS servicios, consulte Utilización AWS Lambda con otros servicios en la Guía para AWS Lambda desarrolladores.

nota

El sam local invoke comando corresponde al comando AWS Command Line Interface (AWS CLI) aws lambda invoke. Puedes utilizar cualquiera de los comandos para invocar una función de Lambda.

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:

1. Cree un archivo JSON que contenga las variables de entorno que desee anular.

2. Usa el argumento --env-vars para anular los valores definidos en sus plantillas.

Declaración de variables de entorno

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:

1. logical_id

2. function_id

3. function_name

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

Anulación de valores de variables de entorno

Para anular las variables de entorno por las definidas en el archivo JSON, utiliza el argumento --env-vars con los comandos invoke o start-api. Por ejemplo:

sam local invoke --env-vars env.json

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 el Módulo 2: Ejecutar localmente en The Complete AWS SAM Workshop.