View a markdown version of this page

Introduzione ai test con sam local start-lambda - AWS Serverless Application Model

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Introduzione ai test con sam local start-lambda

Usa il AWS SAM CLI sottocomando sam local start-lambda per richiamare la tua Lambda Event Function tramite AWS CLI e SDK. Questo comando avvia un endpoint locale che emula Lambda.

Importante

L'endpoint locale esegue il codice funzionale sulla macchina, non nel servizio Lambda. Per mantenere il codice non attendibile isolato dall'ambiente locale, richiamalo nel servizio Lambda.

Nota

sam local start-lambda supporta funzioni durevoli con funzionalità di checkpoint e replay automatici. Le funzioni durevoli funzionano perfettamente con l'endpoint Lambda locale.

Da usare sam local start-lambda, installa AWS SAM CLI completando quanto segue:

Prima dell'uso sam local start-lambda, si consiglia una conoscenza di base di quanto segue:

Utilizzando sam local start-lambda

Quando corri sam local start-lambda, il AWS SAM CLI presuppone che la directory di lavoro corrente sia la directory principale del progetto. Il AWS SAM CLI cercherò prima un template.[yaml|yml] file all'interno di un .aws-sam sottocartella. Se non viene trovato, AWS SAM CLI cercherà un template.[yaml|yml] file all'interno della cartella di lavoro corrente.

Per usare sam local start-lambda
  1. Dalla directory principale del progetto, esegui quanto segue:

    $ sam local start-lambda <options>
  2. Il AWS SAM CLI costruisce le tue funzioni Lambda in locale Docker contenitore. Quindi invia l'indirizzo locale all'endpoint del server HTTP. Di seguito è riportato un esempio:

    $ 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. Usa il AWS CLI o SDK per richiamare la tua funzione Lambda localmente.

    Di seguito è riportato un esempio di utilizzo di AWS CLI:

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

    Di seguito è riportato un esempio di utilizzo di AWS SDK per 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")

Opzioni

Specifica un modello

Per specificare un modello per AWS SAM CLI per fare riferimento, usa --template opzione. La AWS SAM CLI caricherà proprio quello AWS SAM modello e le risorse a cui punta. Di seguito è riportato un esempio:

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

Per ulteriori informazioni su AWS SAM modelli, vedi AWS SAM anatomia del modello.

Best practice

Se la tua applicazione ha un .aws-sam directory in esecuzione sam build, assicurati di correre sam build ogni volta che aggiorni il codice funzione. Quindi, corri sam local start-lambda per testare localmente il codice funzione aggiornato.

I test locali sono un'ottima soluzione per uno sviluppo e un test rapidi prima dell'implementazione nel cloud. Tuttavia, i test locali non convalidano tutto, ad esempio le autorizzazioni tra le risorse nel cloud. Per quanto possibile, testa le tue applicazioni nel cloud. Ti consigliamo utilizzando sam sync per velocizzare i flussi di lavoro di test sul cloud.

Ulteriori informazioni

Per un elenco di tutti sam local start-lambda opzioni, vedi sam local start-lambda.