Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# sam deploy
<a name="sam-cli-command-reference-sam-deploy"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam deploy`.
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI `sam deploy` perintah, lihat[Pengantar penerapan dengan AWS SAM](using-sam-cli-deploy.md).

`sam deploy`Perintah menyebarkan aplikasi untuk AWS Cloud menggunakan AWS CloudFormation.

## Penggunaan
<a name="ref-sam-cli-deploy-usage"></a>

```
$ <environment variables> sam deploy <options>
```

## Variabel-variabel lingkungan
<a name="ref-sam-cli-deploy-env"></a>

`SAM_CLI_POLL_DELAY`  <a name="ref-sam-cli-deploy-env-sam-cli-poll-delay"></a>
Atur variabel `SAM_CLI_POLL_DELAY` lingkungan dengan nilai detik di shell Anda untuk mengonfigurasi seberapa sering AWS SAM CLI memeriksa status CloudFormation tumpukan, yang berguna saat melihat pelambatan dari. CloudFormation Variabel env ini digunakan untuk polling panggilan `describe_stack` API, yang dibuat saat berjalan. `sam deploy`   
Berikut ini adalah contoh dari variabel ini:  

```
$ SAM_CLI_POLL_DELAY=5 sam deploy
```

## Opsi
<a name="ref-sam-cli-deploy-options"></a>

`--capabilities LIST`  <a name="ref-sam-cli-deploy-options-capabilities"></a>
Daftar kemampuan yang harus Anda tentukan CloudFormation untuk memungkinkan membuat tumpukan tertentu. Beberapa templat tumpukan mungkin menyertakan sumber daya yang memengaruhi izin di Anda Akun AWS, misalnya, dengan membuat pengguna baru AWS Identity and Access Management (IAM). Untuk tumpukan tersebut, Anda harus secara eksplisit menerima kemampuannya dengan menentukan opsi ini. Nilai yang valid adalah hanya `CAPABILITY_IAM` dan `CAPABILITY_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 menentukan`CAPABILITY_NAMED_IAM`. Jika Anda tidak menentukan opsi ini, maka operasi mengembalikan `InsufficientCapabilities` kesalahan.  
Ketika Anda menyebarkan aplikasi yang berisi aplikasi bersarang, Anda harus menggunakan `CAPABILITY_AUTO_EXPAND` untuk mengakui aplikasi berisi aplikasi bersarang. Untuk informasi selengkapnya, lihat [Men-deploy aplikasi nest](serverless-sam-template-nested-applications.md#serverless-sam-templates-nested-applications-deploying).

`--config-env TEXT`  <a name="ref-sam-cli-deploy-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-deploy-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="ref-sam-cli-deploy-options-confirm-changeset"></a>
Prompt untuk mengonfirmasi apakah AWS SAMCLI penerapan set perubahan yang dihitung.

`--debug`  <a name="ref-sam-cli-deploy-options-debug"></a>
Aktifkan logging debug untuk mencetak pesan debug yang AWS SAMCLI dihasilkan dan untuk menampilkan stempel waktu.

`--disable-rollback | --no-disable-rollback`  <a name="ref-sam-cli-deploy-options-disable-rollback"></a>
Tentukan apakah akan memutar kembali CloudFormation tumpukan Anda jika terjadi kesalahan selama penerapan. Secara default, jika ada kesalahan selama penerapan, CloudFormation tumpukan Anda akan kembali ke status stabil terakhir. Jika Anda menentukan `--disable-rollback` dan terjadi kesalahan selama penerapan, maka sumber daya yang dibuat atau diperbarui sebelum kesalahan terjadi tidak dibatalkan.

`--fail-on-empty-changeset | --no-fail-on-empty-changeset`  <a name="ref-sam-cli-deploy-options-fail-on-empty-changeset"></a>
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`  <a name="ref-sam-cli-deploy-options-force-upload"></a>
Tentukan opsi ini untuk mengunggah artefak bahkan jika artefak itu cocok dengan artefak yang ada di bucket Amazon S3. Mencocokkan artefak dibatalkan.

`--guided, -g`  <a name="ref-sam-cli-deploy-options-guided"></a>
Tentukan opsi ini untuk memiliki petunjuk AWS SAMCLI penggunaan untuk memandu Anda melalui penerapan.

`--help`  <a name="ref-sam-cli-deploy-options-help"></a>
Tampilkan pesan ini dan keluar.

`--image-repositories TEXT`  <a name="ref-sam-cli-deploy-options-image-repositories"></a>
Pemetaan fungsi ke URI repositori Amazon ECR mereka. Fungsi referensi dengan ID logisnya. Berikut ini adalah contohnya:  

```
$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Anda dapat menentukan opsi ini beberapa kali dalam satu perintah.

`--image-repository TEXT`  <a name="ref-sam-cli-deploy-options-image-repository"></a>
Nama repositori Amazon ECR tempat perintah ini mengunggah gambar fungsi Anda. Opsi ini diperlukan untuk fungsi yang dideklarasikan dengan jenis `Image` paket.

`--kms-key-id TEXT`  <a name="ref-sam-cli-deploy-options-kms-key-id"></a>
ID kunci AWS Key Management Service (AWS KMS) yang digunakan untuk mengenkripsi artefak yang diam di bucket Amazon S3. Jika Anda tidak menentukan opsi ini, AWS SAM gunakan kunci enkripsi yang dikelola Amazon S3.

`--metadata`  <a name="ref-sam-cli-deploy-options-metadata"></a>
Peta metadata untuk melampirkan ke semua artefak yang direferensikan dalam templat Anda.

`--no-execute-changeset`  <a name="ref-sam-cli-deploy-options-no-execute-changeset"></a>
Menunjukkan apakah akan menerapkan changeset. Tentukan opsi ini jika Anda ingin melihat perubahan tumpukan Anda sebelum menerapkan set perubahan. Perintah ini membuat CloudFormation changeset dan kemudian keluar tanpa menerapkan changeset. Untuk menerapkan changeset, jalankan perintah yang sama tanpa opsi ini.

`--no-progressbar`  <a name="ref-sam-cli-deploy-options-no-progressbar"></a>
Jangan tampilkan baris progres saat mengunggah artefak ke Amazon S3.

`--notification-arns LIST`  <a name="ref-sam-cli-deploy-options-notification-arns"></a>
Daftar ARNs topik Amazon Simple Notification Service (Amazon SNS) CloudFormation yang terkait dengan tumpukan.

`--on-failure [ROLLBACK | DELETE | DO_NOTHING]`  <a name="ref-sam-cli-deploy-options-on-failure"></a>
Tentukan tindakan yang akan diambil saat tumpukan gagal dibuat.  
Pilihan berikut tersedia:  
+ `ROLLBACK`— Menggulung kembali tumpukan ke keadaan baik yang diketahui sebelumnya.
+ `DELETE`— Menggulung kembali tumpukan ke keadaan baik yang diketahui sebelumnya, jika ada. Jika tidak, menghapus tumpukan.
+ `DO_NOTHING`— Tidak memutar kembali atau menghapus tumpukan. Efeknya sama dengan efek`--disable-rollback`.
Perilaku bawaannya adalah `ROLLBACK`.  
Anda dapat menentukan `--disable-rollback` opsi atau `--on-failure` opsi, tetapi tidak keduanya.

`--parameter-overrides LIST`  <a name="ref-sam-cli-deploy-options-parameter-overrides"></a>
String yang berisi penggantian CloudFormation parameter yang dikodekan sebagai pasangan kunci-nilai. Setiap override menggunakan format`ParameterKey=name,ParameterValue=value`. Beberapa penggantian dipisahkan oleh spasi. Berikut adalah dua contoh:  

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2
```

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana
```

`--profile TEXT`  <a name="ref-sam-cli-deploy-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="ref-sam-cli-deploy-options-region"></a>
 Wilayah AWS Untuk menyebarkan ke. Misalnya, us-east-1.

`--resolve-image-repos`  <a name="ref-sam-cli-deploy-options-resolve-image-repos"></a>
Secara otomatis membuat repositori Amazon ECR untuk digunakan untuk pengemasan dan penerapan untuk penerapan yang tidak dipandu. Opsi ini hanya berlaku untuk fungsi dan lapisan dengan `PackageType: Image` ditentukan. Jika Anda menentukan `--guided` opsi, maka AWS SAMCLI mengabaikan. `--resolve-image-repos`  
Jika AWS SAM secara otomatis membuat repositori ECR Amazon untuk fungsi atau lapisan dengan opsi ini, dan Anda kemudian menghapus fungsi atau lapisan tersebut dari AWS SAM templat Anda, maka repositori ECR Amazon yang sesuai akan dihapus secara otomatis.

`--resolve-s3`  <a name="ref-sam-cli-deploy-options-resolve-s3"></a>
Buat bucket Amazon S3 secara otomatis untuk digunakan untuk pengemasan dan penerapan untuk penerapan yang tidak dipandu. Jika Anda menentukan `--guided` opsi, maka AWS SAM CLI mengabaikan. `--resolve-s3` Jika Anda menentukan opsi `--s3-bucket` dan `--resolve-s3` opsi, maka terjadi kesalahan.

`--role-arn TEXT`  <a name="ref-sam-cli-deploy-options-role-arn"></a>
Nama Sumber Daya Amazon (ARN) dari peran IAM yang CloudFormation diasumsikan saat menerapkan kumpulan perubahan.

`--s3-bucket TEXT`  <a name="ref-sam-cli-deploy-options-s3-bucket"></a>
Nama bucket Amazon S3 tempat perintah ini mengunggah template Anda. CloudFormation Jika template Anda lebih besar dari 51.200 byte, maka `--s3-bucket` opsi atau opsi diperlukan`--resolve-s3`. Jika Anda menentukan opsi `--s3-bucket` dan `--resolve-s3` opsi, maka terjadi kesalahan.

`--s3-prefix TEXT`  <a name="ref-sam-cli-deploy-options-s3-prefix"></a>
Prefiks ditambahkan ke nama artefak yang diunggah ke bucket Amazon S3. Nama prefiks adalah nama jalur (nama folder) untuk bucket Amazon S3.

`--save-params`  <a name="ref-sam-cli-deploy-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--signing-profiles LIST`  <a name="ref-sam-cli-deploy-options-signing-profiles"></a>
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-name TEXT`  <a name="ref-sam-cli-deploy-options-stack-name"></a>
(Wajib) Nama CloudFormation tumpukan yang Anda gunakan. Jika Anda menentukan tumpukan yang ada, maka perintah memperbarui tumpukan. Jika Anda menentukan tumpukan baru, maka perintah membuatnya.

`--tags LIST`  <a name="ref-sam-cli-deploy-options-tags"></a>
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, -t PATH`  <a name="ref-sam-cli-deploy-options-template-file"></a>
Path dan nama file tempat AWS SAM template Anda berada.  
Jika Anda menentukan opsi ini, maka AWS SAM gunakan hanya templat dan sumber daya lokal yang ditunjukkannya.

`--use-json`  <a name="ref-sam-cli-deploy-options-use-json"></a>
Output JSON untuk CloudFormation template. Output default-nya adalah YAML.

## Contoh
<a name="sam-cli-command-reference-sam-deploy-examples"></a>

Untuk contoh terperinci dan panduan mendalam tentang penggunaan `sam deploy` subperintah, lihat. [Pengantar penerapan dengan AWS SAM](using-sam-cli-deploy.md)