Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
deploy sam
Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) sam deploy perintah.
-
Untuk pengantar AWS SAM CLI, lihat Apa itu AWS SAM CLI?
-
Untuk dokumentasi tentang penggunaan AWS SAM CLI
sam deployperintah, lihat Pengantar penerapan dengan AWS SAM.
sam deploy perintah menyebarkan aplikasi ke AWS Cloud memakai AWS CloudFormation.
Jangan lari sam deploy pada kode yang tidak dipercaya. Perintah ini menggunakan AWS kredenSIAL untuk membuat sumber daya yang ditetapkan template, termasuk peran dan kebijakan IAM, dan mengunggah file lokal yang direferensikan template. Ini juga menerapkan opsi dalam file konfigurasi proyek seperti yang ditulis. Tinjau template dan file konfigurasi sebelum Anda menyebarkan proyek yang tidak Anda buat.
Penggunaan
$<environment variables>sam deploy<options>
Variabel lingkungan
SAM_CLI_POLL_DELAY-
Atur
SAM_CLI_POLL_DELAYvariabel lingkungan dengan nilai detik di shell Anda untuk mengonfigurasi seberapa sering AWS SAM CLI memeriksa CloudFormation status tumpukan, yang berguna saat melihat pelambatan dari CloudFormation. Variabel env ini digunakan untuk pollingdescribe_stackPanggilan API, yang dilakukan saat berjalansam deploy.Berikut ini adalah contoh dari variabel ini:
$SAM_CLI_POLL_DELAY=5sam deploy
Opsi
--capabilitiesLIST-
Daftar kemampuan yang harus Anda tentukan untuk mengizinkan CloudFormation untuk membuat tumpukan tertentu. Beberapa template tumpukan mungkin menyertakan sumber daya yang memengaruhi izin di Akun AWS Misalnya, dengan membuat yang baru AWS Identity and Access Management (IAM) pengguna. Untuk tumpukan tersebut, Anda harus secara eksplisit menerima kemampuannya dengan menentukan opsi ini. Nilai yang valid adalah hanya
CAPABILITY_IAMdanCAPABILITY_NAMED_IAM. Jika Anda memiliki sumber daya IAM, maka Anda dapat menentukan salah satu kemampuan. Jika Anda memiliki sumber daya IAM dengan nama khusus, maka Anda harus menentukanCAPABILITY_NAMED_IAM. Jika Anda tidak menentukan opsi ini, maka operasi mengembalikanInsufficientCapabilitieskesalahan.Saat Anda menerapkan aplikasi yang berisi aplikasi bersarang, Anda harus menggunakan
CAPABILITY_AUTO_EXPANDuntuk mengakui aplikasi berisi aplikasi bersarang. Untuk informasi selengkapnya, lihat Men-deploy aplikasi nest. --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.tomldi root direktori proyek. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi. --confirm-changeset | --no-confirm-changeset-
Minta untuk mengkonfirmasi apakah AWS SAM CLI menyebarkan set perubahan yang dihitung.
--debug-
Aktifkan pencatatan debug untuk mencetak pesan debug yang AWS SAM CLI menghasilkan dan menampilkan stempel waktu.
--disable-rollback | --no-disable-rollback-
Tentukan apakah akan memutar kembali CloudFormation menumpuk jika terjadi kesalahan selama penerapan. Secara default, jika terjadi kesalahan selama penerapan, CloudFormation tumpukan bergulir kembali ke keadaan stabil terakhir. Jika Anda menentukan
--disable-rollbackdan kesalahan terjadi selama penerapan, maka sumber daya yang dibuat atau diperbarui sebelum kesalahan terjadi tidak dipulihkan kembali. --express | --no-express-
Menentukan apakah akan digunakan CloudFormation Mode ekspres. Saat aktif, operasi tumpukan selesai setelah konfigurasi sumber daya diterapkan. Sumber daya terus menjadi siap di latar belakang. Waktu penerapan dapat dikurangi hingga 4x.
The AWS SAM CLI meneruskan perilaku rollback ke CloudFormation
DeploymentConfigparameter ketika Anda juga menentukan--disable-rollback.Nilai default-nya adalah
--no-express. --fail-on-empty-changeset | --no-fail-on-empty-changeset-
Tentukan apakah akan mengembalikan kode keluar bukan nol jika tidak ada perubahan yang harus dilakukan pada tumpukan. Perilaku default-nya adalah mengembalikan kode keluar nonkosong.
--force-upload-
Tentukan opsi ini untuk mengunggah artefak bahkan jika artefak itu cocok dengan artefak yang ada di bucket Amazon S3. Mencocokkan artefak dibatalkan.
--guided, -g-
Tentukan opsi ini untuk memiliki AWS SAM CLI gunakan petunjuk untuk memandu Anda melalui penerapan.
--help-
Tampilkan pesan ini dan keluar.
--image-repositoriesTEXT-
Pemetaan fungsi ke URI repositori Amazon ECR mereka. Referensi fungsi dengan ID logisnya. Berikut ini adalah contohnya:
$sam deploy --image-repositoriesFunction1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repoAnda dapat menentukan opsi ini beberapa kali dalam satu perintah.
--image-repositoryTEXT-
Nama repositori Amazon ECR tempat perintah ini mengunggah gambar fungsi Anda. Opsi ini diperlukan untuk fungsi yang dideklarasikan dengan
Imagejenis paket. --kms-key-idTEXT-
ID dari sebuah AWS Key Management Service (AWS KMS) kunci yang digunakan untuk mengenkripsi artefak yang diam di bucket Amazon S3. Jika Anda tidak menentukan opsi ini, maka AWS SAM menggunakan Amazon S3-managed kunci enkripsi.
Untuk
AWS::Serverless::WebFunctiondiunggah ke bucket yang Anda tentukan--s3-bucket, kuncinya harus berupa kunci yang dikelola pelanggan yang kebijakan kuncinya memungkinkanlambda.amazonaws.com.rproxy.goskope.comuntuk meneleponkms:Decrypt. --metadata-
Peta metadata untuk melampirkan ke semua artefak yang direferensikan dalam templat Anda.
--no-execute-changeset-
Menunjukkan apakah akan menerapkan set perubahan. Tentukan opsi ini jika Anda ingin melihat perubahan tumpukan Anda sebelum menerapkan set perubahan. Perintah ini menciptakan CloudFormation changeset dan kemudian keluar tanpa menerapkan changeset. Untuk menerapkan changeset, jalankan perintah yang sama tanpa opsi ini.
--no-progressbar-
Jangan tampilkan baris progres saat mengunggah artefak ke Amazon S3.
--notification-arnsLIST-
Daftar ARN topik Amazon Simple Notification Service (Amazon SNS) yang CloudFormation berasosiasi dengan tumpukan.
--on-failure [ROLLBACK | DELETE | DO_NOTHING]-
Tentukan tindakan yang akan diambil ketika tumpukan gagal dibuat.
Pilihan berikut tersedia:
-
ROLLBACK— Mengembalikan tumpukan ke keadaan baik yang diketahui sebelumnya. -
DELETE— Mengembalikan tumpukan ke keadaan baik yang diketahui sebelumnya, jika ada. Jika tidak, hapus tumpukan. -
DO_NOTHING— Tidak memutar kembali atau menghapus tumpukan. Efeknya sama dengan--disable-rollback.
Perilaku bawaannya adalah
ROLLBACK.catatanAnda dapat menentukan salah satu
--disable-rollbackopsi atau--on-failurepilihan, tetapi tidak keduanya. -
--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.
Penerapan berjalan selama periode waktu tertentu. Saat Anda menentukan
--output json, AWS SAM CLI mencetak aliran objek JSON, satu per baris, saat penerapan berlangsung. Setiap objek termasuktypebidang yang mengidentifikasi jenis informasi yang dikandungnya, seperti changeset, peristiwa penerapan, output tumpukan, dan hasil akhir. Pada kegagalan, objek terakhir termasukerrorobjek yang menggambarkan apa yang salah.catatan--output jsonopsi tidak kompatibel dengan opsi yang memerlukan petunjuk interaktif, seperti--guideddan--confirm-changeset. -
--parameter-overridesLIST-
Sebuah string yang berisi CloudFormation parameter mengganti yang dikodekan sebagai pasangan kunci-nilai. Setiap override menggunakan format
ParameterKey=name,ParameterValue=value. Beberapa penggantian dipisahkan oleh spasi. Berikut adalah dua contohnya:$sam deploy --parameter-overridesParameterKey=value1,ParameterValue=value2$sam deploy --parameter-overridesParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana --profileTEXT-
Profil spesifik dari file kredensi Anda yang didapat AWS kredenSIAL.
--regionTEXT-
Yang Wilayah AWS untuk menyebarkan ke. Misalnya, us-east-1.
--resolve-image-repos-
Buat repositori Amazon ECR secara otomatis untuk digunakan untuk pengemasan dan penerapan untuk penerapan yang tidak dipandu. Opsi ini hanya berlaku untuk fungsi dan lapisan dengan
PackageType: Imageditentukan. Jika Anda menentukan--guidedpilihan, maka AWS SAM CLI abaikan--resolve-image-repos.catatanJika AWS SAM secara otomatis membuat repositori Amazon ECR untuk fungsi atau lapisan dengan opsi ini, dan Anda kemudian menghapus fungsi atau lapisan tersebut dari AWS SAM template, maka repositori Amazon ECR yang sesuai dihapus secara otomatis.
--resolve-s3-
Buat bucket Amazon S3 secara otomatis untuk digunakan untuk pengemasan dan penerapan untuk penerapan tanpa panduan. Jika Anda menentukan
--guidedpilihan, maka AWS SAM CLI mengabaikan--resolve-s3. Jika Anda menentukan keduanya--s3-bucketdan--resolve-s3opsi, maka terjadi kesalahan.Dengan opsi ini atau
--guided, kode dariAWS::Serverless::WebFunctiondiunggah ke bucket kode milik tumpukan, bukan ke bucket yang dikelola. Untuk informasi selengkapnya, lihat Membangun dan menerapkan Lambda Web Functions. --role-arnTEXT-
Nama Sumber Daya Amazon (ARN) dari peran IAM yang CloudFormation mengasumsikan saat menerapkan changeset.
--s3-bucketTEXT-
Nama bucket Amazon S3 tempat perintah ini mengunggah CloudFormation templat. Jika template Anda lebih besar dari 51.200 byte, maka salah satu
--s3-bucketopsi atau--resolve-s3opsi diperlukan. Jika Anda menentukan keduanya--s3-bucketdan--resolve-s3opsi, maka terjadi kesalahan.Kode dari sebuah
AWS::Serverless::WebFunctionjuga diunggah ke bucket ini, yang harus mengaktifkan pembuatan versi dan memungkinkan Lambda membaca kode. Untuk informasi selengkapnya, lihat Membangun dan menerapkan Lambda Web Functions. --s3-prefixTEXT-
Prefiks ditambahkan ke nama artefak yang diunggah ke bucket Amazon S3. Nama prefiks adalah nama jalur (nama folder) untuk bucket Amazon S3.
--save-params-
Simpan parameter yang Anda berikan di baris perintah ke AWS SAM file konfigurasi.
--signing-profilesLIST-
Daftar profil penandatanganan untuk menandatangani paket deployment Anda. Opsi ini mengambil daftar pasangan kunci-nilai, dengan penjelasan kunci adalah nama fungsi atau lapisan untuk menandatangani, dan nilai adalah profil penandatanganan, dengan pemilik profil opsional yang dibatasi dengan
:. Misalnya,FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner. --stack-nameTEXT-
(Diperlukan) Nama CloudFormation tumpukan yang Anda gunakan. Jika Anda menentukan tumpukan yang ada, maka perintah memperbarui tumpukan. Jika Anda menentukan tumpukan baru, maka perintah membuatnya.
-
Daftar tag untuk dikaitkan dengan tumpukan yang dibuat atau diperbarui. CloudFormation juga menyebarkan tag ini ke sumber daya di tumpukan yang mendukungnya.
--template-file, --template, -tPATH-
Jalur dan nama file tempat Anda AWS SAM Template terletak.
catatanJika Anda menentukan opsi ini, maka AWS SAM menyebarkan hanya template dan sumber daya lokal yang ditunjuk.
--use-json-
Keluaran JSON untuk CloudFormation templat. Output default-nya adalah YAML.
Contoh
Untuk contoh terperinci dan panduan mendalam tentang penggunaan sam deploy subcommand, lihat Pengantar penerapan dengan AWS SAM.