Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
init sam
Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) sam init perintah.
-
Untuk pengantar AWS SAM CLI, lihat Apa itu AWS SAM CLI?
-
Untuk dokumentasi tentang penggunaan AWS SAM CLI
sam initperintah, lihat Buat aplikasi Anda di AWS SAM.
sam init perintah menyediakan opsi untuk menginisialisasi aplikasi tanpa server baru.
Jangan gunakan sam init dengan template dari sumber yang tidak tepercaya. Template kustom, seperti yang Anda tentukan --location, dapat menjalankan kait di lingkungan lokal Anda selama pembuatan proyek.
Penggunaan
$sam init<options>
Opsi
--app-templateTEXT-
Pengenal templat aplikasi terkelola yang ingin Anda gunakan. Jika Anda tidak yakin, hubungi
sam inittanpa opsi untuk alur kerja interaktif.Parameter ini diperlukan jika
--no-interactiveditentukan dan--locationtidak disediakan.Parameter ini hanya tersedia di AWS SAM CLI versi 0.30.0 dan yang lebih baru. Menentukan parameter ini dengan versi sebelumnya menyebabkan kesalahan.
--application-insights | --no-application-insights-
Aktifkan Amazon CloudWatch Pemantauan Wawasan Aplikasi untuk aplikasi Anda. Untuk mempelajari selengkapnya, lihat Menggunakan CloudWatch Application Insights untuk memantau aplikasi tanpa AWS SAM server Anda.
Opsi default-nya adalah
--no-application-insights. --architecture, -a[ x86_64 | arm64 ]-
Arsitektur set instruksi untuk Lambda Event Functions aplikasi Anda. Tentukan salah satu
x86_64atauarm64. --base-image[ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java17.al2023-base | amazon/java11-base | amazon/java11.al2023-base | amazon/java8.al2023-base | amazon/nodejs26.x-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.15-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby4.0-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]-
Citra dasar dari aplikasi Anda. Opsi ini hanya berlaku jika tipe paketnya adalah
Image.Parameter ini diperlukan jika
--no-interactiveditentukan,--package-typeditentukan sebagaiImage, dan--locationtidak ditentukan. --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.
--debug-
Mengaktifkan pencatatan debug untuk mencetak pesan debug yang AWS SAM CLI menghasilkan, dan untuk menampilkan stempel waktu.
--dependency-manager, -d[ gradle | mod | maven | bundler | npm | cli-package | pip ]-
Manajer dependensi waktu aktif Lambda Anda.
--extra-content-
Mengganti parameter kustom apa pun di template
cookiecutter.jsonkonfigurasi, misalnya,{"customParam1": "customValue1", "customParam2":"customValue2"}. --help, -h-
Menunjukkan pesan ini dan keluar.
--location, -lTEXT-
Template atau lokasi aplikasi (Git, Mercurial, HTTP/HTTPS, file.zip, jalur).
Parameter ini diperlukan jika
--no-interactiveditentukan dan--runtime,--name, dan--app-templatetidak disediakan.Untuk repositori Git, Anda harus menggunakan lokasi root repositori.
Untuk jalur lokal, templatnya harus dalam bentuk antara file. zip atau format Cookiecutter
. --name, -nTEXT-
Nama proyek Anda yang akan dihasilkan sebagai direktori.
Parameter ini diperlukan jika
--no-interactiveditentukan dan--locationtidak disediakan. --no-input-
Menonaktifkan prompt Cookiecutter dan menerima nilai vcfdefault yang ditentukan dalam konfigurasi templat.
--no-interactive-
Nonaktifkan prompt interaktif untuk parameter init, dan gagal jika nilai-nilai yang diperlukan tidak ada.
--output[ text | json ]-
Format output perintah:
-
text- Mencetak output biasa yang dapat dibaca manusia. Ini adalah nilai default. -
json- Mencetak output terstruktur dan dapat dibaca mesin. Gunakan format ini ketika Anda ingin menggunakan output secara terprogram, seperti di CI/CD pipeline, ekstensi IDE, dan AI-assisted alat.
Saat Anda menentukan
--output json, AWS SAM CLI mencetak satu objek JSON setelah perintah selesai. Jika berhasil, objek ini menyertakan bidang seperti direktori proyek dan file template. Anda dapat mengrantai output ke perintah berikutnya sepertisam build. Pada kegagalan, itu termasukerrorobjek yang menggambarkan apa yang salah.catatan--output jsonopsi tidak kompatibel dengan alur kerja interaktif. Untuk menggunakannya, tentukan proses non-interaktif sepenuhnya dengan menyediakan semua opsi yang diperlukan. -
--output-dir, -oPATH-
Lokasi tempat aplikasi diinisialisasi adalah output.
--package-type[ Zip | Image ]-
Tipe paket aplikasi contoh.
Zipmembuat arsip file .zip, danImagemembuat citra kontainer. --runtime, -r[ dotnet8 | dotnet6 | java25 | java21 | java17 | java17.al2023 | java11 | java11.al2023 | java8.al2023 | nodejs26.x | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.15 | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby4.0 | ruby3.4 | ruby3.3 | ruby3.2 ]-
Waktu aktif Lambda aplikasi Anda. Opsi ini hanya berlaku jika tipe paketnya adalah
Zip.Parameter ini diperlukan jika
--no-interactiveditentukan,--package-typeditentukan sebagaiZip, dan--locationtidak ditentukan. --save-params-
Simpan parameter yang Anda berikan di baris perintah ke AWS SAM file konfigurasi.
--tracing | --no-tracing-
Aktifkan AWS X-Ray pelacakan untuk fungsi Lambda Anda.
Contoh
Untuk contoh terperinci dan panduan mendalam tentang penggunaan sam init subcommand, lihat Buat aplikasi Anda di AWS SAM.