View a markdown version of this page

init 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.

init sam

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) sam init perintah.

sam init perintah menyediakan opsi untuk menginisialisasi aplikasi tanpa server baru.

penting

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-template TEXT

Pengenal templat aplikasi terkelola yang ingin Anda gunakan. Jika Anda tidak yakin, hubungi sam init tanpa opsi untuk alur kerja interaktif.

Parameter ini diperlukan jika --no-interactive ditentukan dan --location tidak 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_64 atau arm64.

--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-interactive ditentukan, --package-type ditentukan sebagai Image, dan --location tidak ditentukan.

--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.

--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.json konfigurasi, misalnya, {"customParam1": "customValue1", "customParam2":"customValue2"}.

--help, -h

Menunjukkan pesan ini dan keluar.

--location, -l TEXT

Template atau lokasi aplikasi (Git, Mercurial, HTTP/HTTPS, file.zip, jalur).

Parameter ini diperlukan jika --no-interactive ditentukan dan --runtime, --name, dan --app-template tidak disediakan.

Untuk repositori Git, Anda harus menggunakan lokasi root repositori.

Untuk jalur lokal, templatnya harus dalam bentuk antara file. zip atau format Cookiecutter.

--name, -n TEXT

Nama proyek Anda yang akan dihasilkan sebagai direktori.

Parameter ini diperlukan jika --no-interactive ditentukan dan --location tidak 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 seperti sam build. Pada kegagalan, itu termasuk error objek yang menggambarkan apa yang salah.

catatan

--output json opsi tidak kompatibel dengan alur kerja interaktif. Untuk menggunakannya, tentukan proses non-interaktif sepenuhnya dengan menyediakan semua opsi yang diperlukan.

--output-dir, -o PATH

Lokasi tempat aplikasi diinisialisasi adalah output.

--package-type [ Zip | Image ]

Tipe paket aplikasi contoh. Zip membuat arsip file .zip, dan Image membuat 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-interactive ditentukan, --package-type ditentukan sebagai Zip, dan --location tidak 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.