Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tindakan 'Menyebarkan CloudFormation tumpukan' YAMAL
Berikut ini adalah definisi YAMAL dari tindakan ** CloudFormation tumpukan Deploy**. Untuk mempelajari cara menggunakan tindakan ini, lihat[Menyebarkan tumpukan CloudFormation](deploy-action-cfn.md).
Definisi tindakan ini ada sebagai bagian dalam file definisi alur kerja yang lebih luas. Untuk informasi lebih lanjut tentang file ini, lihat[Alur kerja definisi YAMAL](workflow-reference.md).
**catatan**
Sebagian besar properti YAMAL yang mengikuti memiliki elemen UI yang sesuai di editor visual. Untuk mencari elemen UI, gunakan **Ctrl\$1F**. Elemen akan terdaftar dengan properti YAMLnya yang terkait.
```
# The workflow definition starts here.
# See Properti tingkat atas for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
DeployCloudFormationStack:
Identifier: aws/cfn-deploy@v1
DependsOn:
- build-action
Compute:
Type: EC2 | Lambda
Fleet: fleet-name
Timeout: timeout-minutes
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: DeployRole
Inputs:
Sources:
- source-name-1
Artifacts:
- CloudFormation-artifact
Configuration:
name: stack-name
region: us-west-2
template: template-path
role-arn: arn:aws:iam::123456789012:role/StackRole
capabilities: CAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND
parameter-overrides: KeyOne=ValueOne,KeyTwo=ValueTwo | path-to-JSON-file
no-execute-changeset: 1|0
fail-on-empty-changeset: 1|0
disable-rollback: 1|0
termination-protection: 1|0
timeout-in-minutes: minutes
notification-arns: arn:aws:sns:us-east-1:123456789012:MyTopic,arn:aws:sns:us-east-1:123456789012:MyOtherTopic
monitor-alarm-arns: arn:aws:cloudwatch::123456789012:alarm/MyAlarm,arn:aws:cloudwatch::123456789012:alarm/MyOtherAlarm
monitor-timeout-in-minutes: minutes
tags: '[{"Key":"MyKey1","Value":"MyValue1"},{"Key":"MyKey2","Value":"MyValue2"}]'
```
## DeployCloudFormationStack
(Diperlukan)
Tentukan nama tindakan. Semua nama tindakan harus unik dalam alur kerja. Nama aksi terbatas pada karakter alfanumerik (a-z, A-Z, 0-9), tanda hubung (-), dan garis bawah (\$1). Spasi tidak diizinkan. Anda tidak dapat menggunakan tanda kutip untuk mengaktifkan karakter dan spasi khusus dalam nama tindakan.
Default: `DeployCloudFormationStack_nn`.
UI yang sesuai: Tab **konfigurasi/Nama tampilan tindakan**
## Identifier
(*DeployCloudFormationStack*/**Identifier**)
(Diperlukan)
Mengidentifikasi tindakan. Jangan mengubah properti ini kecuali Anda ingin mengubah versi. Untuk informasi selengkapnya, lihat [Menentukan versi tindakan yang akan digunakan](workflows-action-versions.md).
Default: `aws/cfn-deploy@v1`.
**UI yang sesuai: Diagram alur DeployCloudFormationStack kerja/\$1nn/ aws/cfn-deploy @v1 label**
## DependsOn
(*DeployCloudFormationStack*/**DependsOn**)
(Opsional)
Tentukan tindakan, grup tindakan, atau gerbang yang harus berjalan dengan sukses agar tindakan ini berjalan.
Untuk informasi selengkapnya tentang fungsionalitas 'tergantung pada', lihat. [Tindakan pengurutan](workflows-depends-on.md)
UI yang sesuai: Tab **masukan/Tergantung pada** - opsional
## Compute
(*DeployCloudFormationStack*/**Compute**)
(Opsional)
Mesin komputasi digunakan untuk menjalankan tindakan alur kerja Anda. Anda dapat menentukan komputasi baik di tingkat alur kerja atau di tingkat tindakan, tetapi tidak keduanya. Ketika ditentukan pada tingkat alur kerja, konfigurasi komputasi berlaku untuk semua tindakan yang ditentukan dalam alur kerja. Pada tingkat alur kerja, Anda juga dapat menjalankan beberapa tindakan pada instance yang sama. Untuk informasi selengkapnya, lihat [Berbagi komputasi di seluruh tindakan](compute-sharing.md).
UI yang sesuai: *tidak ada*
## Type
(*DeployCloudFormationStack*/Compute/**Type**)
(Diperlukan [Compute](#deploy.action.cfn.computename) jika disertakan)
Jenis mesin komputasi. Anda dapat menggunakan salah satu nilai berikut:
+ **EC2** (editor visual) atau `EC2` (editor YAMAL)
Dioptimalkan untuk fleksibilitas selama aksi berjalan.
+ **Lambda** (editor visual) atau `Lambda` (editor YAMAL)
Kecepatan start-up aksi yang dioptimalkan.
Untuk informasi selengkapnya tentang jenis komputasi, lihat[Jenis komputasi](workflows-working-compute.md#compute.types).
**UI yang sesuai: Konfigurasi tab/Advanced - tipe opsional/Komputasi**
## Fleet
(*DeployCloudFormationStack*/Compute/**Fleet**)
(Opsional)
Tentukan mesin atau armada yang akan menjalankan alur kerja atau tindakan alur kerja Anda. Dengan armada sesuai permintaan, ketika suatu tindakan dimulai, alur kerja menyediakan sumber daya yang dibutuhkan, dan mesin dihancurkan ketika tindakan selesai. Contoh armada sesuai permintaan:`Linux.x86-64.Large`,. `Linux.x86-64.XLarge` Untuk informasi lebih lanjut tentang armada sesuai permintaan, lihat. [Properti armada sesuai permintaan](workflows-working-compute.md#compute.on-demand)
Dengan armada yang disediakan, Anda mengonfigurasi satu set mesin khusus untuk menjalankan tindakan alur kerja Anda. Mesin-mesin ini tetap menganggur, siap untuk memproses tindakan segera. Untuk informasi lebih lanjut tentang armada yang disediakan, lihat. [Properti armada yang disediakan](workflows-working-compute.md#compute.provisioned-fleets)
Jika `Fleet` dihilangkan, defaultnya adalah. `Linux.x86-64.Large`
**UI yang sesuai: Konfigurasi tab/Advanced - armada opsional/Komputasi**
## Timeout
(*DeployCloudFormationStack*/**Timeout**)
(Opsional)
Tentukan jumlah waktu dalam menit (editor YAMG), atau jam dan menit (editor visual), bahwa tindakan dapat berjalan sebelum CodeCatalyst mengakhiri tindakan. Minimal adalah 5 menit dan maksimum dijelaskan dalam[Kuota untuk alur kerja di CodeCatalyst](workflows-quotas.md). Batas waktu default sama dengan batas waktu maksimum.
UI yang sesuai: Tab konfigurasi/Batas **waktu dalam hitungan menit** - opsional
## Environment
(*DeployCloudFormationStack*/**Environment**)
(Diperlukan)
Tentukan CodeCatalyst lingkungan yang akan digunakan dengan tindakan. Tindakan terhubung ke Akun AWS dan VPC Amazon opsional yang ditentukan di lingkungan yang dipilih. Tindakan ini menggunakan peran IAM default yang ditentukan di lingkungan untuk terhubung ke Akun AWS, dan menggunakan peran IAM yang ditentukan dalam [koneksi VPC Amazon untuk terhubung ke VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) Amazon.
**catatan**
Jika peran IAM default tidak memiliki izin yang diperlukan oleh tindakan, Anda dapat mengonfigurasi tindakan untuk menggunakan peran yang berbeda. Untuk informasi selengkapnya, lihat [Mengubah peran IAM dari suatu tindakan](deploy-environments-switch-role.md).
Untuk informasi lebih lanjut tentang lingkungan, lihat [Menyebarkan ke dalam Akun AWS dan VPCs](deploy-environments.md) dan[Pembuatan lingkungan](deploy-environments-creating-environment.md).
**UI yang sesuai: Tab konfigurasi/Lingkungan**
## Name
(*DeployCloudFormationStack*/Environment/**Name**)
(Diperlukan [Environment](#deploy.action.cfn.environment) jika disertakan)
Tentukan nama lingkungan yang ada yang ingin Anda kaitkan dengan tindakan.
**UI yang sesuai: Tab konfigurasi/Lingkungan**
## Connections
(*DeployCloudFormationStack*/Environment/**Connections**)
(Opsional dalam versi tindakan yang lebih baru; diperlukan dalam versi yang lebih lama)
Tentukan koneksi akun untuk dikaitkan dengan tindakan. Anda dapat menentukan maksimum satu koneksi akun di bawah`Environment`.
Jika Anda tidak menentukan koneksi akun:
+ Tindakan menggunakan Akun AWS koneksi dan peran IAM default yang ditentukan di lingkungan di CodeCatalyst konsol. Untuk informasi tentang menambahkan koneksi akun dan peran IAM default ke lingkungan, lihat[Pembuatan lingkungan](deploy-environments-creating-environment.md).
+ Peran IAM default harus menyertakan kebijakan dan izin yang diperlukan oleh tindakan. Untuk menentukan kebijakan dan izin tersebut, lihat deskripsi properti **Peran** dalam dokumentasi definisi YAMAL tindakan.
Untuk informasi selengkapnya tentang koneksi akun, lihat[Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md). Untuk informasi tentang menambahkan koneksi akun ke lingkungan, lihat[Pembuatan lingkungan](deploy-environments-creating-environment.md).
UI yang sesuai: Salah satu dari berikut ini tergantung pada versi tindakan:
+ (Versi yang lebih baru) Konfigurasi tab/Environment/What masuk? *my-environment* **/menu tiga titik/Beralih peran**
+ **(Versi lama) Tab konfigurasi/' Environment/account/role AWS '/ koneksi akun**
## Name
(*DeployCloudFormationStack*/Environment/Connections/**Name**)
(Diperlukan [Connections](#deploy.action.cfn.environment.connections) jika disertakan)
Tentukan nama koneksi akun.
UI yang sesuai: Salah satu dari berikut ini tergantung pada versi tindakan:
+ (Versi yang lebih baru) Konfigurasi tab/Environment/What masuk? *my-environment* **/menu tiga titik/Beralih peran**
+ **(Versi lama) Tab konfigurasi/' Environment/account/role AWS '/ koneksi akun**
## Role
(*DeployCloudFormationStack*/Environment/Connections/**Role**)
(Diperlukan [Connections](#deploy.action.cfn.environment.connections) jika disertakan)
Tentukan nama peran IAM yang digunakan tindakan ** CloudFormation tumpukan Deploy** untuk mengakses AWS dan layanan. CloudFormation Pastikan Anda telah [menambahkan peran ke CodeCatalyst ruang Anda](ipa-connect-account-addroles.md), dan peran tersebut mencakup kebijakan berikut.
Jika Anda tidak menentukan peran IAM, maka tindakan tersebut menggunakan peran IAM default yang tercantum di [lingkungan](deploy-environments.md) di CodeCatalyst konsol. Jika Anda menggunakan peran default di lingkungan, pastikan itu memiliki kebijakan berikut.
+ Kebijakan izin berikut:
**Awas**
Batasi izin untuk yang ditampilkan dalam kebijakan berikut. Menggunakan peran dengan izin yang lebih luas dapat menimbulkan risiko keamanan.
**catatan**
Pertama kali peran digunakan, gunakan wildcard berikut dalam pernyataan kebijakan sumber daya dan kemudian cakup kebijakan dengan nama sumber daya setelah tersedia.
```
"Resource": "*"
```
+ Kebijakan kepercayaan khusus berikut:
**catatan**
Anda dapat menggunakan `CodeCatalystWorkflowDevelopmentRole-spaceName` peran dengan tindakan ini, jika Anda mau. Untuk informasi selengkapnya tentang peran ini, silakan lihat [Membuat **CodeCatalystWorkflowDevelopmentRole-*spaceName***peran untuk akun dan ruang Anda](ipa-iam-roles.md#ipa-iam-roles-service-create). Memahami bahwa `CodeCatalystWorkflowDevelopmentRole-spaceName` peran tersebut memiliki izin akses penuh yang dapat menimbulkan risiko keamanan. Kami menyarankan Anda hanya menggunakan peran ini dalam tutorial dan skenario di mana keamanan kurang menjadi perhatian.
UI yang sesuai: Salah satu dari berikut ini tergantung pada versi tindakan:
+ (Versi yang lebih baru) Konfigurasi tab/Environment/What masuk? *my-environment* **/menu tiga titik/Beralih peran**
+ **(Versi lama) Tab konfigurasi/' '/ Environment/account/role Peran**
## Inputs
(*DeployCloudFormationStack*/**Inputs**)
(Opsional)
`Inputs`Bagian ini mendefinisikan data yang `DeployCloudFormationStack` dibutuhkan selama menjalankan alur kerja.
**catatan**
Maksimal empat input (satu sumber dan tiga artefak) diizinkan per tindakan tumpukan **Deploy CloudFormation **.
Jika Anda perlu merujuk ke file yang berada di input yang berbeda (katakanlah sumber dan artefak), input sumber adalah input utama, dan artefak adalah input sekunder. Referensi ke file dalam input sekunder mengambil awalan khusus untuk menyisihkannya dari primer. Lihat perinciannya di [Contoh: Merujuk file dalam beberapa artefak](workflows-working-artifacts-ex.md#workflows-working-artifacts-ex-ref-file).
UI yang sesuai: **Tab input**
## Sources
(*DeployCloudFormationStack*/Inputs/**Sources**)
(Diperlukan jika CloudFormation atau AWS SAM template Anda disimpan dalam repositori sumber)
Jika AWS SAM template CloudFormation atau Anda disimpan dalam repositori sumber, tentukan label repositori sumber tersebut. Saat ini, satu-satunya label yang didukung adalah`WorkflowSource`.
Jika Anda CloudFormation atau AWS SAM template tidak terkandung dalam repositori sumber, itu harus berada dalam artefak yang dihasilkan oleh tindakan lain, atau dalam bucket Amazon S3.
Untuk informasi selengkapnya tentang sumber, lihat [Menghubungkan repositori sumber ke alur kerja](workflows-sources.md).
UI yang sesuai: **Tab/Sumber** Input - opsional
## Artifacts - input
(*DeployCloudFormationStack*/Inputs/**Artifacts**)
(Diperlukan jika CloudFormation atau AWS SAM template Anda disimpan dalam [artefak keluaran](workflows-working-artifacts-output.md) dari tindakan sebelumnya)
Jika AWS SAM templat CloudFormation atau yang ingin Anda terapkan terkandung dalam artefak yang dihasilkan oleh tindakan sebelumnya, tentukan artefak tersebut di sini. Jika CloudFormation template Anda tidak terkandung dalam artefak, itu harus berada di repositori sumber Anda atau di bucket Amazon S3.
Untuk informasi selengkapnya tentang artefak, termasuk contoh, lihat[Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md).
UI yang sesuai: Tab **konfigurasi/Artefak** - opsional
## Configuration
(*DeployCloudFormationStack*/**Configuration**)
(Diperlukan)
Bagian di mana Anda dapat menentukan properti konfigurasi tindakan.
UI yang sesuai: Tab **konfigurasi**
## name
(*DeployCloudFormationStack*/Configuration/**name**)
(Diperlukan)
Tentukan nama untuk CloudFormation tumpukan yang dibuat atau diperbarui oleh tindakan ** CloudFormation tumpukan Deploy**.
UI yang sesuai: Tab konfigurasi/Nama **tumpukan**
## region
(*DeployCloudFormationStack*/Configuration/**region**)
(Diperlukan)
Tentukan Wilayah AWS ke mana tumpukan akan digunakan. Untuk daftar kode Wilayah, lihat [Titik akhir Regional](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes).
UI yang sesuai: Tab konfigurasi/Wilayah **tumpukan**
## template
(*DeployCloudFormationStack*/Configuration/**template**)
(Diperlukan)
Tentukan nama dan jalur ke file CloudFormation atau AWS SAM template Anda. Template dapat dalam format JSON atau YAMG, dan dapat berada di repositori sumber, artefak dari tindakan sebelumnya, atau bucket Amazon S3. Jika file template berada dalam repositori sumber atau artefak, jalurnya relatif terhadap sumber atau akar artefak. Jika template berada di bucket Amazon S3, jalurnya adalah nilai **URL Objek** template.
Contoh:
`./MyFolder/MyTemplate.json`
`MyFolder/MyTemplate.yml`
`https://MyBucket.s3.us-west-2.amazonaws.com/MyTemplate.yml`
**catatan**
Anda mungkin perlu menambahkan awalan ke jalur file template untuk menunjukkan artefak atau sumber mana yang akan menemukannya. Untuk informasi selengkapnya, lihat [Merujuk file repositori sumber](workflows-sources-reference-files.md) dan [Mereferensikan file dalam artefak](workflows-working-artifacts-refer-files.md).
**UI yang sesuai: Tab/Template Konfigurasi**
## role-arn
(*DeployCloudFormationStack*/Configuration/**role-arn**)
(Diperlukan)
Tentukan Nama Sumber Daya Amazon (ARN) dari peran tumpukan. CloudFormation menggunakan peran ini untuk mengakses dan memodifikasi sumber daya di tumpukan Anda. Sebagai contoh: `arn:aws:iam::123456789012:role/StackRole`.
Pastikan peran tumpukan meliputi:
+ Satu atau beberapa kebijakan izin. Kebijakan tergantung pada sumber daya yang Anda miliki di tumpukan Anda. Misalnya, jika tumpukan Anda menyertakan AWS Lambda fungsi, Anda perlu menambahkan izin yang memberikan akses ke Lambda. Jika Anda mengikuti tutorial yang dijelaskan[Tutorial: Menyebarkan aplikasi tanpa server](deploy-tut-lambda.md), itu termasuk prosedur berjudul, [Untuk membuat peran tumpukan](deploy-tut-lambda.md#deploy-tut-lambda-cfn-roles-stack) yang mencantumkan izin yang dibutuhkan peran tumpukan jika Anda menerapkan tumpukan aplikasi tanpa server yang khas.
**Awas**
Batasi izin untuk yang diperlukan oleh CloudFormation layanan untuk mengakses sumber daya di tumpukan Anda. Menggunakan peran dengan izin yang lebih luas dapat menimbulkan risiko keamanan.
+ Kebijakan kepercayaan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "cloudformation.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
Secara opsional, kaitkan peran ini dengan koneksi akun Anda. Untuk mempelajari lebih lanjut tentang mengaitkan peran IAM dengan koneksi akun, lihat. [Menambahkan peran IAM ke koneksi akun](ipa-connect-account-addroles.md) Jika Anda tidak mengaitkan peran tumpukan dengan koneksi akun, maka peran tumpukan tidak akan muncul di daftar drop-down **peran Stack** di editor visual; namun, peran ARN masih dapat ditentukan di `role-arn` bidang menggunakan editor YAMG.
**catatan**
Anda dapat menggunakan `CodeCatalystWorkflowDevelopmentRole-spaceName` peran dengan tindakan ini, jika Anda mau. Untuk informasi selengkapnya tentang peran ini, silakan lihat [Membuat **CodeCatalystWorkflowDevelopmentRole-*spaceName***peran untuk akun dan ruang Anda](ipa-iam-roles.md#ipa-iam-roles-service-create). Memahami bahwa `CodeCatalystWorkflowDevelopmentRole-spaceName` peran tersebut memiliki izin akses penuh yang dapat menimbulkan risiko keamanan. Kami menyarankan Anda hanya menggunakan peran ini dalam tutorial dan skenario di mana keamanan kurang menjadi perhatian.
UI yang sesuai: Tab **konfigurasi/Peran tumpukan -** opsional
## capabilities
(*DeployCloudFormationStack*/Configuration/**capabilities**)
(Diperlukan)
Tentukan daftar kemampuan IAM yang diperlukan untuk memungkinkan CloudFormation untuk membuat tumpukan tertentu. Dalam kebanyakan kasus, Anda dapat meninggalkan `capabilities` dengan nilai default`CAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND`.
Jika Anda melihat `##[error] requires capabilities: [capability-name]` di log tindakan ** CloudFormation tumpukan Deploy**, lihat [Bagaimana cara memperbaiki kesalahan kemampuan IAM?](troubleshooting-workflows.md#troubleshooting-workflows-capabilities) informasi tentang cara memperbaiki masalah.
*Untuk informasi selengkapnya tentang kemampuan IAM, lihat [Mengakui sumber daya IAM dalam CloudFormation templat di Panduan Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities) IAM.*
**UI yang sesuai: Tab Konfigurasi/Lanjutan/Kemampuan**
## parameter-overrides
(*DeployCloudFormationStack*/Configuration/**parameter-overrides**)
(Opsional)
Tentukan parameter dalam CloudFormation atau AWS SAM templat yang tidak memiliki nilai default, atau yang ingin Anda tentukan nilai non-default. Untuk informasi selengkapnya tentang parameter, lihat [Parameter](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) di *Panduan AWS CloudFormation Pengguna*.
`parameter-overrides`Properti menerima:
+ File JSON yang berisi parameter dan nilai.
+ Daftar parameter dan nilai yang terpisah koma.
**Untuk menentukan file JSON**
1. Pastikan file JSON menggunakan salah satu sintaks berikut:
```
{
"Parameters": {
"Param1": "Value1",
"Param2": "Value2",
...
}
}
```
Atau...
```
[
{
"ParameterKey": "Param1",
"ParameterValue": "Value1"
},
...
]
```
(Ada sintaks lain, tetapi tidak didukung oleh CodeCatalyst pada saat penulisan.) *Untuk informasi selengkapnya tentang menentukan CloudFormation parameter dalam file JSON, lihat [Sintaks JSON yang didukung di Referensi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/deploy/index.html#supported-json-syntax) Perintah.AWS CLI *
1. Tentukan jalur ke file JSON menggunakan salah satu format berikut:
+ Jika file JSON Anda berada dalam artefak keluaran dari tindakan sebelumnya, gunakan:
`file:///artifacts/current-action-name/output-artifact-name/path-to-json-file`
Lihat **Contoh 1** untuk detailnya.
+ Jika file JSON Anda berada di repositori sumber Anda, gunakan:
`file:///sources/WorkflowSource/path-to-json-file`
Lihat **Contoh 2** untuk detailnya.
**Contoh 1** - File JSON berada di artefak keluaran
```
##My workflow YAML
...
Actions:
MyBuildAction:
Identifier: aws/build@v1
Outputs:
Artifacts:
- Name: ParamArtifact
Files:
- params.json
Configuration:
...
MyDeployCFNStackAction:
Identifier: aws/cfn-deploy@v1
Configuration:
parameter-overrides: file:///artifacts/MyDeployCFNStackAction/ParamArtifact/params.json
```
**Contoh 2** - File JSON berada di repositori sumber Anda, dalam folder bernama `my/folder`
```
##My workflow YAML
...
Actions:
MyDeployCloudFormationStack:
Identifier: aws/cfn-deploy@v1
Inputs:
Sources:
- WorkflowSource
Configuration:
parameter-overrides: file:///sources/WorkflowSource/my/folder/params.json
```
**Untuk menggunakan daftar parameter yang terpisah koma**
+ Tambahkan pasangan nama-nilai parameter di `parameter-overrides` properti menggunakan format berikut:
`param-1=value-1,param-2=value-2`
Misalnya, dengan asumsi CloudFormation template berikut:
```
##My CloudFormation template
Description: My CloudFormation template
Parameters:
InstanceType:
Description: Defines the Amazon EC2 compute for the production server.
Type: String
Default: t2.micro
AllowedValues:
- t2.micro
- t2.small
- t3.medium
Resources:
...
```
... Anda dapat mengatur `parameter-overrides` properti sebagai berikut:
```
##My workflow YAML
...
Actions:
...
DeployCloudFormationStack:
Identifier: aws/cfn-deploy@v1
Configuration:
parameter-overrides: InstanceType=t3.medium,UseVPC=true
```
**catatan**
Anda dapat menentukan nama parameter tanpa nilai yang sesuai menggunakan `undefined` sebagai nilai. Contoh:
`parameter-overrides: MyParameter=undefined`
Efeknya adalah bahwa selama pembaruan tumpukan, CloudFormation menggunakan nilai parameter yang ada untuk nama parameter yang diberikan.
UI yang sesuai:
+ **Tab konfigurasi/Lanjutan/Parameter menimpa**
+ tab/Advanced/ParameterPenggantian **konfigurasi/Tentukan penggantian menggunakan file**
+ tab/Advanced/ParameterPenggantian **konfigurasi/Tentukan penggantian menggunakan set nilai**
## no-execute-changeset
(*DeployCloudFormationStack*/Configuration/**no-execute-changeset**)
(Opsional)
Tentukan apakah Anda CodeCatalyst ingin membuat set CloudFormation perubahan dan kemudian berhenti sebelum menjalankannya. Ini memberi Anda kesempatan untuk meninjau perubahan yang ditetapkan di CloudFormation konsol. Jika Anda menentukan bahwa set perubahan terlihat bagus, nonaktifkan opsi ini dan kemudian jalankan kembali alur kerja sehingga CodeCatalyst dapat membuat dan menjalankan set perubahan tanpa henti. Defaultnya adalah membuat dan menjalankan set perubahan tanpa henti. Untuk informasi selengkapnya, lihat parameter CloudFormation [penerapan](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deploy/index.html) di *Referensi AWS CLI Perintah*. Untuk informasi selengkapnya tentang melihat set perubahan, lihat [Melihat set perubahan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets-view.html) di *Panduan AWS CloudFormation Pengguna*.
**UI yang sesuai: Tab konfigurasi/Lanjutan/Tidak ada set perubahan eksekusi**
## fail-on-empty-changeset
(*DeployCloudFormationStack*/Configuration/**fail-on-empty-changeset**)
(Opsional)
Tentukan apakah Anda CodeCatalyst ingin gagal dalam tindakan ** CloudFormation tumpukan Deploy** jika set CloudFormation perubahan kosong. (Jika set perubahan kosong, itu berarti tidak ada perubahan yang dibuat pada tumpukan selama penerapan terbaru.) Defaultnya adalah mengizinkan tindakan untuk melanjutkan jika set perubahan kosong, dan mengembalikan `UPDATE_COMPLETE` pesan meskipun tumpukan tidak diperbarui.
Untuk informasi selengkapnya tentang setelan ini, lihat parameter CloudFormation [penerapan](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deploy/index.html) di *Referensi AWS CLI Perintah*. Untuk informasi selengkapnya tentang set perubahan, lihat [Memperbarui tumpukan menggunakan set perubahan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html) di *Panduan AWS CloudFormation Pengguna*.
**UI yang sesuai: Tab konfigurasi/Lanjutan/Gagal pada set perubahan kosong**
## disable-rollback
(*DeployCloudFormationStack*/Configuration/**disable-rollback**)
(Opsional)
Tentukan apakah Anda CodeCatalyst ingin memutar kembali penerapan tumpukan jika gagal. Rollback mengembalikan tumpukan ke keadaan stabil terakhir yang diketahui. Defaultnya adalah mengaktifkan rollback. Untuk informasi selengkapnya tentang setelan ini, lihat parameter CloudFormation [penerapan](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deploy/index.html) di *Referensi AWS CLI Perintah*.
Untuk informasi selengkapnya tentang cara tindakan ** CloudFormation tumpukan Deploy** menangani rollback, lihat. [Mengkonfigurasi rollback](deploy-consumption-enable-alarms.md)
Untuk informasi selengkapnya tentang memutar kembali tumpukan, lihat [Opsi kegagalan tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-failure-options.html) di *Panduan AWS CloudFormation Pengguna*.
**UI yang sesuai: Tab Konfigurasi/Lanjutan/Nonaktifkan rollback**
## termination-protection
(*DeployCloudFormationStack*/Configuration/**termination-protection**)
(Opsional)
Tentukan apakah Anda ingin ** CloudFormation tumpukan Deploy** menambahkan perlindungan terminasi ke tumpukan yang disebarkan. Jika pengguna mencoba menghapus tumpukan dengan perlindungan pengakhiran diaktifkan, penghapusan gagal dan tumpukan, termasuk statusnya, tetap tidak berubah. Standarnya adalah menonaktifkan perlindungan terminasi. Untuk informasi selengkapnya, lihat [Melindungi tumpukan agar tidak dihapus](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html) di *Panduan AWS CloudFormation Pengguna*.
**UI yang sesuai: Tab Konfigurasi/Perlindungan lanjutan/Penghentian**
## timeout-in-minutes
(*DeployCloudFormationStack*/Configuration/**timeout-in-minutes**)
(Opsional)
Tentukan jumlah waktu, dalam menit, yang CloudFormation harus dialokasikan sebelum mengatur waktu operasi pembuatan tumpukan dan mengatur status tumpukan ke`CREATE_FAILED`. Jika CloudFormation tidak dapat membuat seluruh tumpukan dalam waktu yang diberikan, pembuatan tumpukan akan gagal karena waktu habis dan mengembalikan tumpukan.
Secara default, tidak ada waktu habis untuk pembuatan tumpukan. Namun, sumber daya individu mungkin memiliki waktu habis sendiri berdasarkan sifat layanan yang diterapkan. Misalnya, jika waktu sumber daya individual di tumpukan Anda habis, waktu pembuatan tumpukan juga akan habis meskipun waktu habis yang Anda tentukan untuk pembuatan tumpukan belum tercapai.
**UI yang sesuai: Tab konfigurasi/lanjutan/batas waktu CloudFormation**
## notification-arns
(*DeployCloudFormationStack*/Configuration/**notification-arns**)
(Opsional)
Tentukan ARN dari topik Amazon SNS yang CodeCatalyst ingin Anda kirimi pesan notifikasi. Misalnya, `arn:aws:sns:us-east-1:111222333:MyTopic`. Saat tindakan ** CloudFormation tumpukan Deploy** berjalan, CodeCatalyst berkoordinasi dengan CloudFormation untuk mengirim satu notifikasi per CloudFormation peristiwa yang terjadi selama proses pembuatan atau pembaruan tumpukan. (Peristiwa terlihat di tab **Peristiwa CloudFormation ** konsol untuk tumpukan.) Anda dapat menentukan hingga lima topik. Untuk informasi lebih lanjut, lihat [Apa itu Amazon SNS?](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) .
**UI yang sesuai: Tab Konfigurasi/Lanjutan/Pemberitahuan ARNs**
## monitor-alarm-arns
(*DeployCloudFormationStack*/Configuration/**monitor-alarm-arns**)
(Opsional)
Tentukan Nama Sumber Daya Amazon (ARN) dari CloudWatch alarm Amazon untuk digunakan sebagai pemicu rollback. Misalnya, `arn:aws:cloudwatch::123456789012:alarm/MyAlarm`. Anda dapat memiliki maksimal lima pemicu rollback.
**catatan**
Jika Anda menentukan ARN CloudWatch alarm, Anda juga harus mengonfigurasi izin tambahan untuk mengaktifkan tindakan untuk mengakses. CloudWatch Untuk informasi selengkapnya, lihat [Mengkonfigurasi rollback](deploy-consumption-enable-alarms.md).
**UI yang sesuai: Tab konfigurasi/Alarm lanjutan/Monitor ARNs**
## monitor-timeout-in-minutes
(*DeployCloudFormationStack*/Configuration/**monitor-timeout-in-minutes**)
(Opsional)
Tentukan jumlah waktu, dari 0 hingga 180 menit, di mana CloudFormation memantau alarm yang ditentukan. Pemantauan dimulai *setelah* semua sumber daya tumpukan telah digunakan. Jika alarm terjadi dalam waktu pemantauan yang ditentukan, maka penerapan gagal, dan CloudFormation memutar kembali seluruh operasi tumpukan.
Default: 0. CloudFormation hanya memonitor alarm saat sumber daya tumpukan sedang digunakan, bukan setelahnya.
**UI yang sesuai: Tab konfigurasi/Lanjutan/Waktu pemantauan**
## tags
(*DeployCloudFormationStack*/Configuration/**tags**)
(Opsional)
Tentukan tag untuk dilampirkan ke CloudFormation tumpukan Anda. Tag adalah pasangan nilai kunci arbitrer yang dapat Anda gunakan untuk mengidentifikasi tumpukan Anda untuk tujuan seperti alokasi biaya. Untuk informasi lebih lanjut tentang apa itu tanda dan bagaimana cara penggunaannya, lihat [Menandai sumber daya Anda](https://docs.aws.amazon.com/) di *Panduan Pengguna Amazon EC2*. Untuk informasi selengkapnya tentang penandaan CloudFormation, lihat [Menyetel opsi CloudFormation tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-add-tags.html) di *Panduan AWS CloudFormation Pengguna*.
Sebuah kunci dapat memiliki karakter alfanumerik atau spasi, dan dapat memiliki hingga 127 karakter. Nilai dapat memiliki karakter alfanumerik atau spasi, dan dapat memiliki hingga 255 karakter.
Anda dapat menambahkan hingga 50 tag unik untuk setiap tumpukan.
**UI yang sesuai: Tab Konfigurasi/Lanjutan/Tag**