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

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:

La --env-vars opción admite dos formatos de archivo. El formato del archivo se detecta automáticamente en función del contenido del archivo.

Declarar 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:

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 puede usar un .env archivo para declarar variables de entorno. Las variables declaradas en un .env archivo se aplican globalmente a todas las funciones, lo que equivale al Parameters objeto en formato JSON.

TABLE_NAME=localtable
BUCKET_NAME=amzn-s3-demo-bucket
STAGE=dev

El .env formato admite comentarios (líneas que comienzan por#) y valores entre comillas.

Anulación de valores de variables de entorno

Para sustituir las variables de entorno por las definidas en el archivo de variables de entorno, utilice el --env-vars argumento con los invoke comandos o. start-api 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 de forma local, consulte el Módulo 2: Ejecutar de forma local en The Complete Workshop. AWS SAM