Introducción a las pruebas en la nube con sam remote test-event

Utilice el AWS Serverless Application Model comando Command Line Interface (AWS SAM CLI) sam remote test-event para acceder a los eventos de prueba que se pueden compartir para sus AWS Lambda funciones y gestionarlos.

Para obtener más información sobre los eventos de prueba compartibles, consulte Eventos de prueba compartibles en la Guía para desarrolladores de AWS Lambda .

Requisitos previos

Para usar sam remote test-event, complete lo siguiente para instalar la CLI de AWS SAM:

• AWS SAM requisitos previos.

• Instale la CLIAWS SAM.

Si ya lo tiene AWS SAM CLI instalado, le recomendamos que lo actualice a la última versión de la AWS SAMCLI versión. Para obtener más información, consulte Actualización de la CLI de AWS SAM.

Antes de usar sam remote test-event, se recomienda tener conocimientos básicos de lo siguiente:

• Configuración de la AWS SAM de CLI.

• Crea tu aplicación con el sam init comando.

• Introducción a la construcción con el sam build comando.

• Introducción a la implementación con el sam deploy comando.

• Introducción al uso sam sync de la sincronización con Nube de AWS.

Configure la CLI de AWS SAM para utilizar sam remote test-event.

Complete los siguientes pasos de configuración para usar el AWS SAM CLI sam remote test-event comando:

1. Configure el AWS SAM CLI para usar su Cuenta de AWS: los usuarios pueden acceder y administrar los eventos de prueba de Lambda que se pueden compartir dentro del mismo. Cuenta de AWS Para configurarlos AWS SAM CLI para que usen los suyos Cuenta de AWS, consulte. Configuración de la AWS SAM de CLI

2. Configurar los permisos para los eventos de prueba compartibles: para acceder a los eventos de prueba compartibles y gestionarlos, debe tener los permisos adecuados. Para obtener más información, consulte los Eventos de prueba que se puedan compartir en la Guía para desarrolladores de AWS Lambda .

Uso del comando sam remote test-event

El AWS SAM CLI sam remote test-event comando proporciona los siguientes subcomandos que puede utilizar para acceder a los eventos de prueba que se pueden compartir y gestionarlos:

• delete— Eliminar un evento de prueba que se pueda compartir del registro de EventBridge esquemas de Amazon.

• get— Obtenga un evento de prueba que se pueda compartir del registro de EventBridge esquemas.

• list— Listar los eventos de prueba que se pueden compartir existentes para una función del registro del EventBridge esquema.

• put— Guarda un evento de un archivo local en el registro del EventBridge esquema.

Para enumerar estos subcomandos mediante el AWS SAM CLI, ejecute lo siguiente:

$ sam remote test-event --help

Eliminación de eventos de prueba compartibles

Puede eliminar un evento de prueba compartible usando el subcomando delete junto con lo siguiente:

• Proporcione el nombre del evento de prueba compartible que se va a eliminar.

• Proporcione un ID aceptable de la función de Lambda asociada al evento.

• Si proporciona el identificador lógico de la función Lambda, también debe proporcionar el nombre de la AWS CloudFormation pila asociada a la función Lambda.

A continuación, se muestra un ejemplo:

$ sam remote test-event delete HelloWorldFunction --stack-name sam-app --name demo-event

Para obtener una lista de las opciones que se pueden usar con el subcomando delete, consulte sam remote test-event delete. También puede ejecutar lo siguiente desde: AWS SAM CLI

$ sam remote test-event delete --help

Obtención de eventos de prueba compartibles

Puede obtener un evento de prueba que se pueda compartir del registro del EventBridge esquema mediante el get subcomando junto con lo siguiente:

• Proporcione el nombre del evento de prueba compartible que se desea obtener.

• Proporcione un ID aceptable de la función de Lambda asociada al evento.

• Si proporciona el identificador lógico de la función Lambda, también debe proporcionar el nombre de la AWS CloudFormation pila asociada a la función Lambda.

A continuación se muestra un ejemplo en el que se obtiene un evento de prueba compartible llamado demo-event que está asociado a la función de Lambda HelloWorldFunction de la pila de sam-app. Este comando imprimirá el evento en la consola.

$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event

Para obtener un evento de prueba compartible y guardarlo en su equipo local, utilice la opción --output-file y proporcione una ruta de archivo y un nombre. A continuación se muestra un ejemplo que guarda demo-event como demo-event.json en el directorio de trabajo actual:

$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

Para obtener una lista de las opciones que se pueden usar con el subcomando get, consulte sam remote test-event get. También puede ejecutar lo siguiente desde: AWS SAM CLI

$ sam remote test-event get --help

Enumeración de eventos de prueba compartibles

Puede enumerar todos los eventos de prueba compartibles para una función de Lambda concreta desde el registro de esquemas. Utilice el subcomando list junto con lo siguiente:

• Proporcione un ID aceptable de la función de Lambda asociada a los eventos.

• Si proporciona el identificador lógico de la función Lambda, también debe proporcionar el nombre de la AWS CloudFormation pila asociada a la función Lambda.

A continuación se muestra un ejemplo en el que se obtiene una lista de todos los eventos de prueba compartibles asociados con la función de Lambda HelloWorldFunction de la pila de sam-app.

$ sam remote test-event list HelloWorldFunction --stack-name sam-app

Para obtener una lista de las opciones que se pueden usar con el subcomando list, consulte sam remote test-event list. También puede ejecutar lo siguiente desde: AWS SAM CLI

$ sam remote test-event list --help

Almacenamiento de eventos de prueba compartibles

Puede guardar los eventos de prueba que se pueden compartir en el registro de EventBridge esquemas. Utilice el subcomando put junto con lo siguiente:

• Proporcione un identificador aceptable de la función de Lambda asociada al evento de prueba compartible.

• Proporcione un nombre para el evento de prueba compartible.

• Proporcione la ruta del archivo y el nombre del evento local que desee cargar.

El siguiente es un ejemplo que guarda el evento demo-event.json local como demo-event y lo asocia a la función de Lambda HelloWorldFunction de la pila de sam-app:

$ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json

Si existe un evento de prueba que se pueda compartir con el mismo nombre en el registro del EventBridge esquema, no AWS SAM CLI lo sobrescribirá. Para sobrescribir, añada la opción --force a su comando.

Para obtener una lista de las opciones que se pueden usar con el subcomando put, consulte sam remote test-event put. También puede ejecutar lo siguiente desde: AWS SAM CLI

$ sam remote test-event put --help

Uso de eventos de prueba compartibles

Utilice eventos de prueba que se puedan compartir para probar las funciones de Lambda en Nube de AWS el comando with sam remote invoke the. Para obtener más información, consulte Transfiera eventos de prueba que se puedan compartir a una función de Lambda en la nube.

Gestion de eventos de prueba compartibles

Este tema contiene ejemplos sobre cómo administrar y usar los eventos de prueba compartibles.

Obtenga un evento de prueba compartible, modifíquelo y úselo

Puede obtener un evento de prueba que se pueda compartir del registro del EventBridge esquema, modificarlo localmente y usar el evento de prueba local con la función Lambda en. Nube de AWS A continuación, se muestra un ejemplo:

1. Recuperar el evento de prueba compartible: utilice el subcomando sam remote test-event get para recuperar un evento de prueba compartible para una función de Lambda específica y guárdelo localmente:

   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

2. Modifique el evento de prueba compartible: utilice un editor de texto de su elección para modificar el evento de prueba compartible.

3. Usar el evento de prueba compartible: use el sam remote invoke comando y proporcione la ruta del archivo y el nombre del evento con: --event-file

   $ sam remote invoke HelloWorldFunction --stack-name sam-app --event-file demo-event.json

Obtenga un evento de prueba compartible, modifíquelo, cárguelo y úselo

Puede obtener un evento de prueba que se pueda compartir del registro del EventBridge esquema, modificarlo localmente y cargarlo. A continuación, puede pasar el evento de prueba compartible directamente a la función de Lambda en la Nube de AWS. A continuación, se muestra un ejemplo:

1. Recuperar el evento de prueba compartible: utilice el subcomando sam remote test-event get para recuperar un evento de prueba compartible para una función de Lambda específica y guárdelo localmente:

   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

2. Modifique el evento de prueba compartible: utilice un editor de texto de su elección para modificar el evento de prueba compartible.

3. Cargue el evento de prueba que se puede compartir: utilice el sam remote test-event put subcomando para cargar y guardar el evento de prueba que se puede compartir en el registro del esquema. EventBridge En este ejemplo, utilizamos la opción --force para sobrescribir una versión anterior de nuestra prueba compartible.

   $ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json --force

4. Pase el evento de prueba compartible a la función de Lambda: utilice el comando sam remote invoke para pasar el evento de prueba compartible directamente a la función de Lambda en la Nube de AWS:

   $ sam remote invoke HelloWorldFunction --stack-name sam-app --test-event-name demo-event