sam local start-lambda

Halaman ini memberikan informasi referensi untuk Antarmuka Baris AWS Serverless Application Model Perintah (AWS SAM CLI) sam local start-lambda subperintah.

• Untuk pengantar AWS SAM CLI, lihat Apa itu AWS SAM CLI?

• Untuk dokumentasi tentang penggunaan AWS SAM CLI sam local start-lambdasubperintah, lihatPengantar pengujian dengan sam local start-lambda.

sam local start-lambdaSubperintah memulai endpoint lokal untuk ditiru. AWS Lambda

Penggunaan

$ sam local start-lambda <options>

Opsi

--add-host LIST

Meneruskan nama host ke pemetaan alamat IP ke file host wadah Docker. Parameter ini dapat dilewatkan beberapa kali.

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

Tidak wajib. Teruskan variabel lingkungan ke kontainer citra saat 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 dari 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.

--debug

Mengaktifkan logging debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.

--debug-args TEXT

Argumen tambahan untuk diteruskan ke debugger.

--debug-function

Tidak wajib. Menentukan fungsi Lambda untuk diberlakukan opsi debug ketika --warm-containers ditentukan. Parameter ini berlaku untuk --debug-port, --debugger-path, dan --debug-args.

--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 akan dipasang ke dalam kontainer Lambda.

--docker-network TEXT

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

--docker-volume-basedir, -v TEXT

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

--env-vars, -n PATH

JSONFile yang berisi nilai untuk variabel lingkungan fungsi Lambda.

--force-image-build

Tentukan apakah CLI harus membangun kembali gambar yang digunakan untuk menjalankan fungsi 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.

--host TEXT

Nama host lokal atau alamat IP untuk diikatkan (default: '127.0.0.1').

--invoke-image TEXT

Gambar URI kontainer yang ingin Anda gunakan untuk pemanggilan fungsi lokal. Secara default, AWS SAM tarik gambar kontainer dari Amazon ECR Public. Gunakan opsi ini untuk menarik citra dari lokasi lain.

Misalnya, sam local start-lambda MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8.

--layer-cache-basedir DIRECTORY

Menentukan lokasi basedir tempat layer yang digunakan templat Anda terunduh.

--log-file, -l TEXT

Berkas log untuk mengirim log waktu aktif.

--parameter-overrides

String yang berisi penggantian AWS CloudFormation parameter yang dikodekan sebagai pasangan kunci-nilai. Gunakan format yang sama dengan AWS Command Line Interface (AWS CLI). The AWS SAM CLI format adalah kunci eksplisit dan kata kunci nilai, setiap penggantian dipisahkan oleh spasi. Berikut adalah dua contoh:

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

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

--port, -p INTEGER

Nomor port lokal untuk didengarkan (default: '3001').

--profile TEXT

Profil spesifik dari file kredensyal Anda yang mendapat AWS kredensyal.

--region TEXT

AWS Wilayah untuk disebarkan. Misalnya, us-east-1.

--save-params

Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM 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 opsi.

--skip-pull-image

Menentukan apakah CLI harus melewatkan menarik gambar Docker terbaru untuk runtime Lambda.

--template, -t PATH

File AWS SAM template.

catatan

Jika Anda menentukan opsi ini, hanya AWS SAM memuat template dan sumber daya lokal yang ditunjuknya. Opsi ini tidak kompatibel dengan--hook-name.

--terraform-plan-file

Jalur relatif atau absolut ke lokal Anda Terraform rencanakan file saat menggunakan AWS SAM CLI dengan Terraform Cloud. Opsi ini mengharuskan --hook-name diatur keterraform.

--warm-containers [EAGER | LAZY]

Tidak wajib. Menentukan bagaimana AWS SAM CLI mengelola kontainer untuk setiap fungsi.

Tersedia dua opsi:

• EAGER: Kontainer untuk semua fungsi dimuat saat pertama dimulai dan terus ada di antara pemanggilan.

• LAZY: Kontainer hanya dimuat ketika setiap fungsi pertama kali dipanggil. Kontainer tersebut terus ada untuk pemanggilan tambahan.