View a markdown version of this page

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.

pemanggilan lokal sam

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) sam local invoke subkomando.

sam local invoke subcommand memulai pemanggilan satu kali dari AWS Lambda Fungsi acara secara lokal.

penting

Jangan gunakan sam local invoke dengan kode yang tidak dipercaya. Untuk memiliki isolasi lengkap dari lingkungan lokal Anda, jalankan kode di layanan Lambda secara langsung.

catatan

Untuk fungsi tahan lama, sam local invoke mendukung eksekusi stateful dengan checkpointing otomatis dan replay. Wadah tetap berjalan selama eksekusi fungsi yang tahan lama untuk menangani persistensi status dan dimulainya kembali.

Penggunaan

$ sam local invoke <arguments> <options>
catatan

Jika Anda memiliki lebih dari satu fungsi yang ditentukan dalam AWS SAM template, berikan fungsi ID logis yang ingin Anda panggil.

Argumen

ID Sumber Daya

ID fungsi Lambda untuk dipanggil.

Argumen ini opsional. Jika aplikasi Anda berisi fungsi Lambda tunggal, AWS SAM CLI akan memintanya. Jika aplikasi Anda berisi beberapa fungsi, berikan ID fungsi untuk dipanggil.

Nilai yang valid: ID logis sumber daya atau ARN sumber daya.

Opsi

--add-host LIST

Meneruskan nama host ke pemetaan alamat IP ke file host container Docker. Parameter ini dapat dilewati beberapa kali.

contoh

Contoh: --add-host example.com:127.0.0.1

--beta-features | --no-beta-features

Izinkan atau tolak fitur beta.

--config-env TEXT

Nama lingkungan yang menentukan nilai parameter default dalam file konfigurasi yang akan digunakan. Nilai default-nya adalah “default”. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi.

--config-file PATH

Jalur dan nama file dari file konfigurasi yang berisi nilai parameter default yang akan digunakan. Nilai default-nya adalah ”samconfig.toml“ di root direktori proyek. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi.

--container-env-vars

(Opsional) Teruskan variabel lingkungan untuk kontainer citra fungsi Lambda ketika debugging lokal.

--container-host TEXT

Host kontainer Lambda yang teremulasi secara lokal. Nilai default-nya adalah localhost. Jika Anda ingin berlari AWS SAM CLI dalam wadah Docker di macOS, Anda dapat menentukan host.docker.internal. Jika Anda ingin menjalankan wadah pada host yang berbeda dari AWS SAM CLI, Anda dapat menentukan alamat IP host jarak jauh.

--container-host-interface TEXT

Alamat IP dari antarmuka jaringan host tempat kontainer port harus terikat. Nilai default-nya adalah 127.0.0.1. Gunakan 0.0.0.0 untuk mengikat ke semua antarmuka.

--container-dns TEXT

Menentukan server DNS khusus untuk wadah Docker. Parameter ini dapat dilewatkan beberapa kali untuk menentukan beberapa server DNS.

contoh

Contoh: --container-dns 8.8.8.8

--debug

Mengaktifkan pencatatan debug untuk mencetak pesan debug yang AWS SAM CLI menghasilkan, dan untuk menampilkan stempel waktu.

--debug-args TEXT

Argumen tambahan untuk meneruskan ke debugger.

--debug-port, -d TEXT

Ketika ditentukan, mulai kontainer fungsi Lambda dalam modus debug dan ekspos port ini pada host lokal.

--debugger-path TEXT

Jalur host ke debugger yang dipasang ke kontainer Lambda.

--docker-network TEXT

Nama atau ID jaringan Docker yang ada yang harus terhubung dengan kontainer Docker Lambda, bersama dengan jaringan bridge default. Jika tidak ditentukan, kontainer Lambda hanya terhubung ke jaringan Docker bridge default.

--docker-volume-basedir, -v TEXT

Lokasi direktori dasar di mana AWS SAM file ada. Jika Docker berjalan pada mesin jarak jauh, Anda harus memasang jalur di mana AWS SAM file ada di mesin Docker dan memodifikasi nilai ini agar sesuai dengan mesin jarak jauh.

--durable-execution-name TEXT

Nama untuk eksekusi tahan lama (hanya untuk fungsi tahan lama)

--env-vars, -n PATH

JSON atau .env file yang berisi nilai untuk variabel lingkungan fungsi Lambda. Format file terdeteksi secara otomatis. Untuk informasi selengkapnya tentang file variabel lingkungan, lihat File variabel lingkungan.

--event, -e PATH

File JSON yang berisi data peristiwa yang diteruskan ke fungsi Lambda ketika dipanggil. Jika Anda tidak menentukan opsi ini, tidak ada peristiwa yang diterima. Untuk meng-input JSON dari stdin, Anda harus meneruskan nilai '-'. Untuk detail tentang format pesan acara dari yang berbeda AWS layanan, lihat Bekerja dengan layanan lain di AWS Lambda Panduan Pengembang.

--force-image-build

Menentukan apakah AWS SAM CLI harus membangun kembali gambar yang digunakan untuk memanggil fungsi Lambda dengan lapisan.

--help

Menunjukkan pesan ini dan keluar.

--hook-name TEXT

Nama kait yang digunakan untuk memperpanjang AWS SAM CLI fungsionalitas.

Nilai yang diterima: terraform.

--invoke-image TEXT

URI gambar kontainer yang ingin Anda gunakan untuk pemanggilan fungsi lokal.

Untuk fungsi Lambda dengan PackageType: Zip, ini mengesampingkan gambar dasar runtime. Secara default, AWS SAM menarik gambar wadah dari Amazon ECR Public (yang tercantum di Repositori gambar untuk AWS SAM). Gunakan opsi ini untuk menarik citra dari lokasi lain.

Untuk fungsi Lambda dengan PackageType: Image, ini mengesampingkan ImageUri dari template yang dibangun. Gunakan ini untuk memanggil gambar aplikasi yang berbeda secara lokal tanpa memodifikasi template Anda.

Anda dapat menentukan opsi ini beberapa kali. Setiap instans dari opsi ini dapat mengambil baik string atau pasangan kunci-nilai. Jika Anda menentukan string, itu adalah URI dari image container yang akan digunakan untuk semua fungsi dalam aplikasi Anda. Misalnya, sam local invoke --invoke-image public.ecr.aws/sam/emu-python3.13. Jika Anda menentukan pasangan kunci-nilai, kuncinya adalah nama sumber daya, dan nilainya adalah URI citra kontainer untuk digunakan untuk sumber daya tersebut. Misalnya, sam local invoke --invoke-image public.ecr.aws/sam/emu-python3.13 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.13. Dengan pasangan kunci-nilai, Anda dapat menentukan citra kontainer yang berbeda untuk sumber daya yang berbeda.

--layer-cache-basedir DIRECTORY

Menentukan lokasi direktori dasar tempat layer yang digunakan templat Anda diunduh.

--log-file, -l TEXT

Berkas log untuk mengirim log waktu aktif.

Memastikan AWS SAM CLI selalu memasang symlink yang ada dalam file untuk dibangun atau dipanggil. Ini hanya berlaku untuk symlink di direktori tingkat atas (yaitu, symlink yang langsung di root fungsi). Secara default, symlink tidak dipasang kecuali yang diperlukan untuk digunakan build-in-source untuk node_modules di NodeJS.

--no-event

Memanggil fungsi dengan peristiwa kosong.

--no-memory-limit

Menghapus batasan memori dalam wadah selama pemanggilan lokal, bahkan ketika memori dikonfigurasi di AWS SAM templat.

--parameter-overrides

Sebuah string yang berisi CloudFormation parameter mengganti yang dikodekan sebagai pasangan kunci-nilai. Gunakan format yang sama dengan AWS Command Line Interface (AWS CLI). Yang AWS SAM CLI format adalah kunci eksplisit dan kata kunci nilai, setiap override dipisahkan oleh spasi. Berikut adalah dua contohnya:

  • --parameter-overrides ParameterKey=hello,ParameterValue=world

  • --parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana

--profile TEXT

Profil spesifik dari file kredensi Anda yang didapat AWS kredenSIAL.

--region TEXT

Yang AWS Wilayah untuk digunakan. Misalnya, us-east-1.

--runtime TEXT

Menggunakan runtime yang ditentukan untuk memanggil fungsi Lambda secara lokal. Ini mengesampingkan runtime yang ditentukan dalam template.yml berkas. Ini juga memungkinkan pengujian fungsi Lambda dengan runtime yang berbeda tanpa memodifikasi konfigurasi fungsi asli.

--save-params

Simpan parameter yang Anda berikan di baris perintah ke AWS SAM file konfigurasi.

--shutdown

Mengemulasi peristiwa shutdown setelah pemanggilan selesai, untuk menguji penanganan ekstensi perilaku shutdown.

--skip-prepare-infra

Melewati tahap persiapan jika tidak ada perubahan infrastruktur yang dilakukan. Gunakan dengan --hook-name pilihan.

--skip-pull-image

Secara default, AWS SAM CLI memeriksa lingkungan runtime jarak jauh terbaru Lambda dan memperbarui gambar lokal Anda secara otomatis agar tetap sinkron.

Tentukan opsi ini untuk melewatkan menarik yang terbaru Docker gambar untuk lingkungan runtime Lambda Anda.

--template, -t PATH

The AWS SAM berkas templat.

Opsi ini tidak kompatibel dengan --hook-name.

catatan

Jika Anda menentukan opsi ini, AWS SAM memuat hanya template dan sumber daya lokal yang ditunjuk.

--tenant-id TEXT

ID penyewa untuk fungsi Lambda multi-tenant. Digunakan untuk memastikan isolasi komputasi antara penyewa yang berbeda. Diperlukan saat memanggil fungsi yang dikonfigurasi dengan mode isolasi penyewa.

--terraform-plan-file

Jalur relatif atau absolut ke lokal Anda Terraform file rencana saat menggunakan AWS SAM CLI bersama Terraform Cloud. Opsi ini mengharuskan --hook-name diatur ke terraform.

Contoh

Contoh berikut menggunakan peristiwa yang dihasilkan untuk pengujian lokal dengan menggunakan s3.json acara untuk memanggil fungsi Lambda secara lokal

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

Contoh berikut menguji fungsi HelloWorldFunction menggunakan runtime Python 3.11

$ sam local invoke --runtime python3.11 HelloWorldFunction

Contoh berikut menguji fungsi HelloWorldFunction dengan nama eksekusi yang tahan lama

$ sam local invoke HelloWorldFunction --durable-execution-name my-execution