Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
mulai-lambda lokal sam
Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) sam local start-lambda subkomando.
-
Untuk pengantar AWS SAM CLI, lihat Apa itu AWS SAM CLI?
-
Untuk dokumentasi tentang penggunaan AWS SAM CLI
sam local start-lambdasubperintah, lihat Pengantar pengujian dengan mulai-lambda lokal sam.
sam local start-lambda subcommand memulai titik akhir lokal untuk ditiru AWS Lambda.
Jangan gunakan sam local start-lambda dengan kode yang tidak tepercaya, karena titik akhir lokal menjalankan kode fungsi di lingkungan lokal Anda. Untuk isolasi lengkap, panggil kode di layanan Lambda sebagai gantinya.
Penggunaan
$sam local start-lambda<options>
Opsi
--add-hostLIST-
Meneruskan nama host ke pemetaan alamat IP ke file host container Docker. Parameter ini dapat dilewati beberapa kali.
contoh
Contoh:
--add-hostexample.com:127.0.0.1 --beta-features | --no-beta-features-
Izinkan atau tolak fitur beta.
--config-envTEXT-
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-filePATH-
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-hostTEXT-
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 menentukanhost.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-interfaceTEXT-
Alamat IP dari antarmuka jaringan host tempat kontainer port harus terikat. Nilai default-nya adalah
127.0.0.1. Gunakan0.0.0.0untuk mengikat ke semua antarmuka. --container-dnsTEXT-
Menentukan server DNS khusus untuk wadah Docker. Parameter ini dapat dilewatkan beberapa kali untuk menentukan beberapa server DNS.
contoh
Contoh:
--container-dns8.8.8.8 --debug-
Mengaktifkan pencatatan debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAM CLI dan menampilkan stempel waktu.
--debug-argsTEXT-
Argumen tambahan untuk diteruskan ke debugger.
--debug-function-
Tidak wajib. Menentukan Lambda Event Function untuk menerapkan opsi debug ke kapan
--warm-containersditentukan. Parameter ini berlaku untuk--debug-port,--debugger-path, dan--debug-args. --debug-port, -dTEXT-
Ketika ditentukan, mulai kontainer fungsi Lambda dalam modus debug, dan ekspos port ini pada host lokal.
--debugger-pathTEXT-
Jalur host ke debugger yang akan dipasang ke dalam kontainer Lambda.
--docker-networkTEXT-
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, -vTEXT-
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 ubah nilai ini agar sesuai dengan mesin jarak jauh.
--env-vars, -nPATH-
JSON atau
.envfile yang berisi nilai untuk variabel lingkungan fungsi Lambda. Format file terdeteksi secara otomatis. --force-image-build-
Tentukan apakah CLI harus membangun kembali gambar yang digunakan untuk memanggil fungsi dengan lapisan.
--help-
Menunjukkan pesan ini dan keluar.
--hook-nameTEXT-
Nama kait yang digunakan untuk memperpanjang AWS SAM CLI fungsionalitas.
Nilai yang diterima:
terraform. --hostTEXT-
Nama host lokal atau alamat IP untuk diikatkan (default: '127.0.0.1').
--invoke-imageTEXT-
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 citra kontainer dari Amazon ECR Publik. Gunakan opsi ini untuk menarik citra dari lokasi lain.Untuk fungsi Lambda dengan
PackageType: Image, ini mengesampingkanImageUridari 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 start-lambda --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 start-lambda --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-basedirDIRECTORY-
Menentukan lokasi basedir tempat layer yang digunakan templat Anda terunduh.
--log-file, -lTEXT-
Berkas log untuk mengirim log waktu aktif.
--no-memory-limit-
Menghapus batasan memori dalam wadah selama pemanggilan lokal, bahkan ketika memori dikonfigurasi di AWS SAM templat.
--no-watch-
Menonaktifkan menonton file saat digunakan dengan
--warm-containers. Jika ditentukan, AWS SAM CLI tidak memantau kode sumber atau template Anda untuk perubahan, dan wadah hangat tidak secara otomatis dimulai ulang pada modifikasi kode. Untuk mengambil perubahan lokal, hentikan dan jalankan kembali perintah.Gunakan opsi ini saat menonton file menyebabkan CPU tinggi atau I/O overhead, seperti di monorepos besar, lingkungan dengan pemindaian perangkat lunak antivirus, atau proyek di mana beberapa fungsi Lambda berbagi
CodeUri.Opsi ini diabaikan jika
--warm-containerstidak ditentukan. --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
--port, -pINTEGER-
Nomor port lokal untuk didengarkan (default: '3001').
--profileTEXT-
Profil spesifik dari file kredensi Anda yang didapat AWS kredenSIAL.
--regionTEXT-
Yang AWS Wilayah untuk digunakan. Misalnya, us-east-1.
--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-namepilihan. --skip-pull-image-
Menentukan apakah CLI harus melewatkan menarik gambar Docker terbaru untuk runtime Lambda.
--template, -tPATH-
The AWS SAM berkas templat.
catatanJika Anda menentukan opsi ini, AWS SAM memuat hanya template dan sumber daya lokal yang ditunjuk. Opsi ini tidak kompatibel dengan
--hook-name. --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-namediatur 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.
-
Contoh
Untuk contoh terperinci dan panduan mendalam tentang penggunaan sam local start-lambda subcommand, lihat Pengantar pengujian dengan mulai-lambda lokal sam.