View a markdown version of this page

init sam - AWS Serverless Application Model
PenggunaanOpsiContoh

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 perintah Command Line Interface (AWS SAMCLI)sam init.

sam initPerintah ini menyediakan opsi untuk menginisialisasi aplikasi tanpa server baru.

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 dalam AWS SAMCLI versi 0.30.0 dan yang lebih baru. Menentukan parameter ini dengan versi sebelumnya menyebabkan kesalahan.

--application-insights | --no-application-insights

Aktifkan pemantauan Amazon CloudWatch Application Insights 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 atauarm64.

--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/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-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 logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]

Manajer dependensi waktu aktif Lambda Anda.

--extra-content

Ganti parameter kustom apa pun dalam cookiecutter.json konfigurasi template, misalnya,{"customParam1": "customValue1", "customParam2":"customValue2"}.

--help, -h

Menunjukkan pesan ini dan keluar.

--location, -l TEXT

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

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 reguler yang dapat dibaca manusia. Ini adalah nilai default.

  • json— Mencetak terstruktur, output yang dapat dibaca mesin. Gunakan format ini saat Anda ingin menggunakan output secara terprogram, seperti di CI/CD pipeline, ekstensi IDE, dan alat. AI-assisted

Saat Anda menentukan--output json, AWS SAMCLI mencetak objek JSON tunggal setelah perintah selesai. Pada keberhasilan, objek ini mencakup bidang-bidang seperti direktori proyek dan file template. Anda dapat merantai output ke perintah berikutnya sepertisam build. Pada kegagalan, itu termasuk error objek yang menggambarkan apa yang salah.

catatan

--output jsonOpsi ini tidak kompatibel dengan alur kerja interaktif. Untuk menggunakannya, tentukan proses yang sepenuhnya non-interaktif 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 | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | 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 pada baris perintah ke file AWS SAM konfigurasi.

--tracing | --no-tracing

Aktifkan AWS X-Ray penelusuran untuk fungsi Lambda Anda.

Contoh

Untuk contoh terperinci dan panduan mendalam tentang penggunaan sam init subperintah, lihat. Buat aplikasi Anda di AWS SAM