Introducción a las pruebas con sam local start-lambda

Usa el AWS SAM CLI subcomando sam local start-lambda para invocar la función Lambda mediante y. AWS CLI SDKs Este comando inicia un punto de conexión local que emula .

• Para una introducción a la AWS SAM CLI, consulte ¿Qué es la AWS SAM CLI?

• Para ver una lista de opciones de comandos sam local start-lambda, consulta sam local start-lambda.

Requisitos previos

Para usarlosam local start-lambda, instale el AWS SAM CLI completando lo siguiente:

• AWS SAM requisitos previos.

• Instala la AWS SAM CLI.

Antes de usar sam local start-lambda, se recomienda tener conocimientos básicos de lo siguiente:

• Configuración de la AWS SAM de CLI.

• Creación de una aplicación AWS SAM.

• Introducción a la construcción con AWS SAM.

• Introducción a la implementación con AWS SAM.

Utilizando sam local start-lambda

Cuando corressam local start-lambda, el AWS SAM CLI asume que el directorio de trabajo actual es el directorio raíz del proyecto. El AWS SAM CLI buscará primero un template.[yaml|yml] archivo dentro de una .aws-sam subcarpeta. Si no lo encuentra, el AWS SAM CLI buscará un template.[yaml|yml] archivo en su directorio de trabajo actual.

Para usar sam local start-lambda

1. Desde el directorio raíz del proyecto, ejecuta lo siguiente:

   $ sam local start-lambda <options>

2. El AWS SAM CLI crea sus funciones Lambda en un entorno local Docker contenedor. A continuación, envía la dirección local al punto final HTTP del servidor. A continuación, se muestra un ejemplo:

   $ sam local start-lambda
   Initializing the lambda functions containers.
   Local image is up-to-date
   Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64.
   
   Mounting /Users/.../sam-app/hello_world as /var/task:ro,delegated, inside runtime container
   Containers Initialization is done.
   Starting the Local Lambda Service. You can now invoke your Lambda Functions defined in your template through the endpoint.
   2023-04-13 07:25:43 WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
    * Running on http://127.0.0.1:3001
   2023-04-13 07:25:43 Press CTRL+C to quit

3. Utilice AWS CLI o SDKs para invocar la función Lambda localmente.

   A continuación, se muestra un ejemplo mediante la AWS CLI:

   $ aws lambda invoke --function-name "HelloWorldFunction" --endpoint-url "http://127.0.0.1:3001" --no-verify-ssl out.txt
       
   StatusCode: 200
   (END)

   A continuación se muestra un ejemplo en el que se utiliza la AWS SDK for Python:

   import boto3
   from botocore.config import Config
   from botocore import UNSIGNED
   
   lambda_client = boto3.client('lambda',
                                endpoint_url="http://127.0.0.1:3001",
                                use_ssl=False,
                                verify=False,
                                config=Config(signature_version=UNSIGNED,
                                              read_timeout=1,
                                              retries={'max_attempts': 0}
                                              )
                               )
   lambda_client.invoke(FunctionName="HelloWorldFunction")

Opciones

Especificar plantilla

Para especificar una plantilla para el AWS SAM CLI como referencia, utilice la --template opción. El AWS SAM CLI cargará solo esa AWS SAM plantilla y los recursos a los que apunta. A continuación, se muestra un ejemplo:

$ sam local start-lambda --template myTemplate.yaml

Prácticas recomendadas

Si la aplicación tiene un directorio .aws-sam desde el que se ejecuta sam build, asegúrese de ejecutar sam build cada vez que actualice el código de la función. A continuación, ejecuta sam local start-lambda para probar localmente el código de función actualizado.

El testeo local son una excelente solución para desarrollar y probar rápidamente antes de implementarlas en la nube. Sin embargo, las testeo local no lo validan todo, como los permisos entre los recursos de la nube. En la medida de lo posible, pruebe sus aplicaciones en la nube. Te recomendamos que utiliza sam sync para acelerar los flujos de trabajo de pruebas en la nube.

Más información

Para obtener una lista de todas las opciones sam local start-lambda, consulta sam local start-lambda.