View a markdown version of this page

Pengantar pengujian dengan pemanggilan lokal sam - AWS Serverless Application Model

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pengantar pengujian dengan pemanggilan lokal sam

Gunakan AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) sam local invoke subperintah untuk memulai pemanggilan satu kali AWS Lambda Fungsi acara secara lokal.

penting

sam local invoke menjalankan kode fungsi dengan akses ke lingkungan lokal Anda. Memanggil kode dari sumber yang tidak dikenal di layanan Lambda, yang mengisolasinya dari mesin Anda.

catatan

sam local invoke mendukung fungsi tahan lama dengan kemampuan checkpointing dan replay otomatis. Saat memanggil fungsi tahan lama secara lokal, status eksekusi dikelola secara otomatis.

Untuk menggunakan sam local invoke, instal AWS SAM CLI dengan menyelesaikan yang berikut ini:

Sebelum menggunakan sam local invoke, kami merekomendasikan pemahaman dasar tentang hal-hal berikut:

Memanggil Fungsi Peristiwa Lambda secara lokal

Saat Anda berlari sam local invoke, AWS SAM CLI mengasumsikan bahwa direktori kerja Anda saat ini adalah direktori root proyek Anda. The AWS SAM CLI pertama-tama akan mencari template.[yaml|yml] berkas dalam sebuah .aws-sam subfolder. Jika tidak ditemukan, AWS SAM CLI akan mencari template.[yaml|yml] file dalam direktori kerja Anda saat ini.

Untuk memanggil Lambda Event Function secara lokal
  1. Dari direktori root proyek Anda, jalankan yang berikut ini:

    $ sam local invoke <options>
  2. Jika aplikasi Anda berisi lebih dari satu fungsi, berikan ID logis fungsi tersebut. Berikut ini adalah contohnya:

    $ sam local invoke HelloWorldFunction
  3. The AWS SAM CLI membangun fungsi Anda dalam wadah lokal menggunakan Docker. Kemudian memanggil fungsi Anda dan mengeluarkan respons fungsi Anda.

    Berikut ini adalah contohnya:

    $ sam local invoke Invoking app.lambda_handler (python3.9) Local image is out of date and will be updated to the latest runtime. To skip this, pass in the parameter --skip-pull-image Building image.................................................................................................................... Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/.../sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container START RequestId: 64bf7e54-5509-4762-a97c-3d740498d3df Version: $LATEST END RequestId: 64bf7e54-5509-4762-a97c-3d740498d3df REPORT RequestId: 64bf7e54-5509-4762-a97c-3d740498d3df Init Duration: 1.09 ms Duration: 608.42 ms Billed Duration: 609 ms Memory Size: 128 MB Max Memory Used: 128 MB {"statusCode": 200, "body": "{\"message\": \"hello world\"}"}%

Mengelola log

Saat menggunakan sam local invoke, output runtime fungsi Lambda (misalnya, log) adalah output ke stderr, dan hasil fungsi Lambda adalah output ke stdout.

Berikut ini adalah contoh fungsi dasar Lambda:

def handler(event, context): print("some log") # this goes to stderr return "hello world" # this goes to stdout

Anda dapat menyimpan output standar ini. Berikut ini adalah contohnya:

$ sam local invoke 1> stdout.log ... $ cat stdout.log "hello world" $ sam local invoke 2> stderr.log ... $ cat stderr.log Invoking app.lambda_handler (python3.9) Local image is up-to-date Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/.../sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container START RequestId: 0b46e646-3bdf-4b58-8beb-242d00912c46 Version: $LATEST some log END RequestId: 0b46e646-3bdf-4b58-8beb-242d00912c46 REPORT RequestId: 0b46e646-3bdf-4b58-8beb-242d00912c46 Init Duration: 0.91 ms Duration: 589.19 ms Billed Duration: 590 ms Memory Size: 128 MB Max Memory Used: 128 MB

Anda dapat menggunakan output standar ini untuk lebih mengotomatiskan proses pengembangan lokal Anda.

Opsi

Luluskan acara khusus untuk memanggil Lambda Event Function

Untuk meneruskan suatu peristiwa ke fungsi Lambda, gunakan --event pilihan. Berikut ini adalah contohnya:

$ sam local invoke --event events/s3.json S3JsonLoggerFunction

Anda dapat membuat acara dengan sam local generate-event subkomando. Untuk mempelajari selengkapnya, lihat Pengantar pengujian dengan hasilkan-peristiwa lokal sam.

Lewati variabel lingkungan saat memanggil Lambda Event Function

Jika fungsi Lambda Anda menggunakan variabel lingkungan, Anda dapat melewatinya selama pengujian lokal dengan --env-vars pilihan. Ini adalah cara yang bagus untuk menguji fungsi Lambda secara lokal dengan layanan di aplikasi Anda yang sudah diterapkan di cloud. Berikut ini adalah contohnya:

$ sam local invoke --env-vars locals.json

Tentukan template atau fungsi

Untuk menentukan template untuk AWS SAM CLI Untuk referensi, gunakan --template pilihan. Yang AWS SAM CLI akan memuat hanya itu AWS SAM template dan sumber daya yang ditunjuk.

Untuk memanggil fungsi aplikasi atau tumpukan bersarang, berikan ID logis aplikasi atau tumpukan bersama dengan ID logis fungsi. Berikut ini adalah contohnya:

$ sam local invoke StackLogicalId/FunctionLogicalId

Uji Fungsi Peristiwa Lambda dari Terraform proyek

Gunakan --hook-name opsi untuk menguji fungsi Lambda secara lokal dari Anda Terraform proyek. Untuk mempelajari selengkapnya, lihat Menggunakan AWS SAM CLI dengan Terraform untuk debugging dan pengujian lokal.

Berikut ini adalah contohnya:

$ sam local invoke --hook-name terraform --beta-features

Praktik Terbaik

Jika aplikasi Anda memiliki .aws-sam direktori dari berjalan sam build, pastikan untuk berlari sam build setiap kali Anda memperbarui kode fungsi Anda. Lalu, jalankan sam local invoke untuk menguji kode fungsi Anda yang diperbarui secara lokal.

Pengujian lokal adalah solusi hebat untuk pengembangan dan pengujian cepat sebelum menerapkan ke cloud. Namun, pengujian lokal tidak memvalidasi semuanya, seperti izin antara sumber daya Anda di cloud. Sebisa mungkin, uji aplikasi Anda di cloud. Kami merekomendasikan memakai sam sync untuk mempercepat alur kerja pengujian cloud Anda.

Contoh

Buat acara sampel Amazon API Gateway dan gunakan untuk memanggil Lambda Event Function secara lokal

Pertama, kami menghasilkan payload peristiwa API Gateway HTTP API dan menyimpannya ke events folder.

$ sam local generate-event apigateway http-api-proxy > events/apigateway_event.json

Selanjutnya, kami memodifikasi fungsi Lambda kami untuk mengembalikan nilai parameter dari acara.

def lambda_handler(event, context): print("HelloWorldFunction invoked") return { "statusCode": 200, "body": json.dumps({ "message": event['queryStringParameters']['parameter2'], }), }

Selanjutnya, kami secara lokal memanggil fungsi Lambda kami dan menyediakan acara khusus kami.

$ sam local invoke --event events/apigateway_event.json Invoking app.lambda_handler (python3.9) Local image is up-to-date Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/...sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container START RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 Version: $LATEST some log END RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 REPORT RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 Init Duration: 1.63 ms Duration: 564.07 ms Billed Duration: 565 ms Memory Size: 128 MB Max Memory Used: 128 MB {"statusCode": 200, "body": "{\"message\": \"value\"}"}%

Lewati variabel lingkungan saat memanggil Lambda Event Function secara lokal

Aplikasi ini memiliki fungsi Lambda yang menggunakan variabel lingkungan untuk nama tabel Amazon DynamoDB. Berikut ini adalah contoh fungsi yang didefinisikan dalam AWS SAM Templat:

AWSTemplateFormatVersion: 2010-09-09 Transform: AWS::Serverless-2016-10-31 ... Resources: getAllItemsFunction: Type: AWS::Serverless::Function Properties: Handler: src/get-all-items.getAllItemsHandler Description: get all items Policies: - DynamoDBReadPolicy: TableName: !Ref SampleTable Environment: Variables: SAMPLE_TABLE: !Ref SampleTable ...

Kami ingin menguji fungsi Lambda kami secara lokal sambil berinteraksi dengan tabel DynamoDB kami di cloud. Untuk melakukan ini, kami membuat file variabel lingkungan kami dan menyimpannya di direktori root proyek kami sebagai locals.json. Nilai yang diberikan di sini untuk SAMPLE_TABLE mereferensikan tabel DynamoDB kami di cloud.

{ "getAllItemsFunction": { "SAMPLE_TABLE": "dev-demo-SampleTable-1U991234LD5UM98" } }

Selanjutnya, kita lari sam local invoke dan meneruskan variabel lingkungan kita dengan --env-vars pilihan.

$ sam local invoke getAllItemsFunction --env-vars locals.json Mounting /Users/...sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container START RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 Version: $LATEST some log END RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 REPORT RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 Init Duration: 1.63 ms Duration: 564.07 ms Billed Duration: 565 ms Memory Size: 128 MB Max Memory Used: 128 MB {"statusCode":200,"body":"{}"}

Pelajari selengkapnya

Untuk daftar semua sam local invoke opsi, lihat pemanggilan lokal sam.

Untuk demo penggunaan sam local, lihat AWS SAM untuk pembangunan lokal. Pengujian AWS Cloud sumber daya dari lingkungan pembangunan lokal di Sesi Tanah Tanpa Server dengan seri SAM aktif YouTube.