Tindakan 'Menyebarkan tumpukan' AWS CloudFormation YAML

Berikut ini adalah YAML definisi dari tindakan AWS CloudFormation tumpukan Deploy. Untuk mempelajari cara menggunakan tindakan ini, lihatMenyebarkan tumpukan AWS CloudFormation.

Definisi tindakan ini ada sebagai bagian dalam file definisi alur kerja yang lebih luas. Untuk informasi selengkapnya tentang file ini, lihatDefinisi alur kerja YAML.

catatan

Sebagian besar YAML properti yang mengikuti memiliki elemen UI yang sesuai di editor visual. Untuk mencari elemen UI, gunakan Ctrl+F. Elemen akan terdaftar dengan YAML properti 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 (_). 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.

Default: aws/cfn-deploy@v1.

UI yang sesuai: Diagram alur DeployCloudFormationStack kerja/_nn/ 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

UI yang sesuai: Tab masukan/Tergantung pada - opsional

Compute

(DeployCloudFormationStack/Compute)

(Opsional)

Mesin komputasi yang 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.

UI yang sesuai: tidak ada

Type

(DeployCloudFormationStack/Compute/Type)

(Diperlukan Compute jika disertakan)

Jenis mesin komputasi. Anda dapat menggunakan salah satu nilai berikut:

EC2(editor visual) atau EC2 (YAMLeditor)

Dioptimalkan untuk fleksibilitas selama aksi berjalan.
Lambda (editor visual) atau Lambda (YAMLeditor)

Kecepatan start-up aksi yang dioptimalkan.

Untuk informasi selengkapnya tentang jenis komputasi, lihatJenis komputasi.

UI yang sesuai: Tab Konfigurasi/Tingkat Lanjut - opsional/Jenis 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

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

Jika Fleet dihilangkan, defaultnya adalah. Linux.x86-64.Large

UI yang sesuai: Tab Konfigurasi/Advanced - armada opsional/Komputasi

Timeout

(DeployCloudFormationStack/Timeout)

(Opsional)

Tentukan jumlah waktu dalam menit (YAMLeditor), atau jam dan menit (editor visual), bahwa tindakan dapat berjalan sebelum CodeCatalyst mengakhiri tindakan. Minimal adalah 5 menit dan maksimum dijelaskan dalamKuota untuk alur kerja di CodeCatalyst. 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 Amazon Akun AWS dan opsional VPC yang ditentukan di lingkungan yang dipilih. Tindakan menggunakan IAM peran default yang ditentukan di lingkungan untuk terhubung ke Akun AWS, dan menggunakan IAM peran yang ditentukan dalam VPCkoneksi Amazon untuk terhubung ke AmazonVPC.

catatan

Jika IAM peran default tidak memiliki izin yang diperlukan oleh tindakan, Anda dapat mengonfigurasi tindakan untuk menggunakan peran yang berbeda. Untuk informasi selengkapnya, lihat Mengubah IAM peran suatu tindakan.

Untuk informasi lebih lanjut tentang lingkungan, lihat Menyebarkan ke Akun AWS dan VPCs danPembuatan lingkungan.

UI yang sesuai: Tab konfigurasi/Lingkungan

Name

(DeployCloudFormationStack/Environment/Name)

(Diperlukan 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 bawahEnvironment.

Jika Anda tidak menentukan koneksi akun:

Tindakan menggunakan Akun AWS koneksi dan IAM peran default yang ditentukan di lingkungan di CodeCatalyst konsol. Untuk informasi tentang menambahkan koneksi akun dan IAM peran default ke lingkungan, lihatPembuatan lingkungan.
IAMPeran default harus menyertakan kebijakan dan izin yang diperlukan oleh tindakan. Untuk menentukan kebijakan dan izin tersebut, lihat deskripsi properti Peran dalam dokumentasi YAML definisi tindakan.

Untuk informasi selengkapnya tentang koneksi akun, lihatMemungkinkan akses ke AWS sumber daya yang terhubung Akun AWS. Untuk informasi tentang menambahkan koneksi akun ke lingkungan, lihatPembuatan lingkungan.

UI yang sesuai: Salah satu dari berikut ini tergantung pada versi tindakan:

(Versi yang lebih baru) Tab konfigurasi/Lingkungan/Apa yang ada my-environment? /menu tiga titik/Beralih peran
(Versi lama) Tab konfigurasi/'lingkungan/akun/peran'/koneksi akun AWS

Name

(DeployCloudFormationStack/Environment/Connections/Name)

(Diperlukan Connections jika disertakan)

Tentukan nama koneksi akun.

UI yang sesuai: Salah satu dari berikut ini tergantung pada versi tindakan:

(Versi yang lebih baru) Tab konfigurasi/Lingkungan/Apa yang ada my-environment? /menu tiga titik/Beralih peran
(Versi lama) Tab konfigurasi/'lingkungan/akun/peran'/koneksi akun AWS

Role

(DeployCloudFormationStack/Environment/Connections/Role)

(Diperlukan Connections jika disertakan)

Tentukan nama IAM peran yang digunakan tindakan AWS CloudFormation tumpukan Deploy untuk mengakses AWS dan AWS CloudFormation layanan. Pastikan Anda telah menambahkan peran ke CodeCatalyst ruang Anda, dan peran tersebut mencakup kebijakan berikut.

Jika Anda tidak menentukan IAM peran, maka tindakan tersebut menggunakan IAM peran default yang tercantum di lingkungan 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.


{
    "Version": "2012-10-17",
    "Statement": [{
    "Action": [
        "cloudformation:CreateStack",
        "cloudformation:DeleteStack",
        "cloudformation:Describe*",
        "cloudformation:UpdateStack",
        "cloudformation:CreateChangeSet",
        "cloudformation:DeleteChangeSet",
        "cloudformation:ExecuteChangeSet",
        "cloudformation:SetStackPolicy",
        "cloudformation:ValidateTemplate",
        "cloudformation:List*",
        "iam:PassRole"
    ],
    "Resource": "*",
    "Effect": "Allow"
}]
}

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:


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service":  [
                   "codecatalyst-runner.amazonaws.com",
                   "codecatalyst.amazonaws.com"
                 ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

catatan

Anda dapat menggunakan CodeCatalystWorkflowDevelopmentRole-spaceName peran dengan tindakan ini, jika Anda mau. Untuk informasi selengkapnya tentang peran ini, silakan lihat Membuat CodeCatalystWorkflowDevelopmentRole-spaceNameperan untuk akun dan ruang Anda. 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) Tab konfigurasi/Lingkungan/Apa yang ada my-environment? /menu tiga titik/Beralih peran
(Versi lama) Tab konfigurasi/'lingkungan/akun/peran'/ Peran

Inputs

(DeployCloudFormationStack/Inputs)

(Opsional)

InputsBagian ini mendefinisikan data yang DeployCloudFormationStack dibutuhkan selama menjalankan alur kerja.

catatan

Maksimal empat input (satu sumber dan tiga artefak) diizinkan per tindakan tumpukan Deploy AWS 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.

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

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.

UI yang sesuai: Tab/Sumber Input - opsional

Artifacts - input

(DeployCloudFormationStack/Inputs/Artifacts)

(Diperlukan jika CloudFormation atau AWS SAM template Anda disimpan dalam artefak keluaran 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, lihatBerbagi artefak dan file antar tindakan.

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

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 JSON atau YAML format, 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 ada di bucket Amazon S3, jalurnya adalah nilai Object URL 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 dan Merujuk file dalam artefak.

UI yang sesuai: Tab/Template Konfigurasi

role-arn

(DeployCloudFormationStack/Configuration/role-arn)

(Diperlukan)

Tentukan Amazon Resource Name (ARN) dari peran stack. CloudFormation menggunakan peran ini untuk mengakses dan memodifikasi sumber daya di tumpukan Anda. Misalnya: 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 menyertakan AWS Lambda fungsi, Anda perlu menambahkan izin yang memberikan akses ke Lambda. Jika Anda mengikuti tutorial yang dijelaskanTutorial: Menyebarkan aplikasi tanpa server, itu termasuk prosedur berjudul, Untuk membuat peran tumpukan 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:


{
    "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 IAM peran dengan koneksi akun, lihatMenambahkan IAM peran ke koneksi akun. 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 tersebut masih ARN dapat ditentukan di role-arn bidang menggunakan YAML editor.

catatan

UI yang sesuai: Tab konfigurasi/Peran tumpukan - opsional

capabilities

(DeployCloudFormationStack/Configuration/capabilities)

(Diperlukan)

Tentukan daftar IAM kemampuan yang diperlukan untuk memungkinkan AWS CloudFormation untuk membuat tumpukan tertentu. Dalam kebanyakan kasus, Anda dapat meninggalkan capabilities dengan nilai defaultCAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND.

Jika Anda melihat ##[error] requires capabilities: [capability-name] log tindakan AWS CloudFormation tumpukan Deploy, lihat Bagaimana cara memperbaiki kesalahan IAM kemampuan? informasi tentang cara memperbaiki masalah.

Untuk informasi selengkapnya tentang IAM kemampuan, lihat Mengakui IAM sumber daya dalam AWS CloudFormation templat di IAMPanduan Pengguna.

UI yang sesuai: Tab Konfigurasi/Lanjutan/Kemampuan

parameter-overrides

(DeployCloudFormationStack/Configuration/parameter-overrides)

(Opsional)

Tentukan parameter dalam AWS 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 di Panduan AWS CloudFormation Pengguna.

parameter-overridesProperti menerima:

JSONFile yang berisi parameter dan nilai.
Daftar parameter dan nilai yang terpisah koma.

Untuk menentukan JSON file

Pastikan JSON file 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 JSON file, lihat JSONSintaks yang didukung di Referensi AWS CLI Perintah.

Tentukan jalur ke JSON file menggunakan salah satu format berikut:

Jika JSON file Anda berada di artefak keluaran dari tindakan sebelumnya, gunakan:

file:///artifacts/current-action-name/output-artifact-name/path-to-json-file

Lihat Contoh 1 untuk detailnya.

Jika JSON file Anda berada di repositori sumber Anda, gunakan:

file:///sources/WorkflowSource/path-to-json-file

Lihat Contoh 2 untuk detailnya.

Contoh 1 - JSON File berada dalam 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 - JSON File 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 AWS CloudFormation template berikut:
```
##My CloudFormation template

Description: My AWS 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. Sebagai 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 konfigurasi/Advanced/Parameter overrides/ Tentukan penggantian menggunakan file
Tab konfigurasi/Advanced/Parameter overrides/ 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 AWS CloudFormation penerapan di Referensi AWS CLI Perintah. Untuk informasi selengkapnya tentang melihat set perubahan, lihat Melihat set perubahan 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 AWS 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 AWS CloudFormation penerapan di Referensi AWS CLI Perintah. Untuk informasi selengkapnya tentang set perubahan, lihat Memperbarui tumpukan menggunakan set perubahan 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 AWS CloudFormation penerapan di Referensi AWS CLI Perintah.

Untuk informasi selengkapnya tentang cara tindakan AWS CloudFormation tumpukan Deploy menangani rollback, lihat. Mengkonfigurasi rollback

Untuk informasi selengkapnya tentang memutar kembali tumpukan, lihat Opsi kegagalan tumpukan di Panduan AWS CloudFormation Pengguna.

UI yang sesuai: Tab Konfigurasi/Lanjutan/Nonaktifkan rollback

termination-protection

(DeployCloudFormationStack/Configuration/termination-protection)

(Opsional)

Tentukan apakah Anda ingin AWS 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. Defaultnya adalah menonaktifkan perlindungan terminasi. Untuk informasi selengkapnya, lihat Melindungi tumpukan agar tidak dihapus 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 keCREATE_FAILED. Jika tidak CloudFormation dapat membuat seluruh tumpukan dalam waktu yang ditentukan, itu gagal pembuatan tumpukan karena batas waktu dan memutar kembali 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 SNS topik Amazon yang CodeCatalyst ingin Anda kirimi pesan notifikasi. Misalnya, arn:aws:sns:us-east-1:111222333:MyTopic. Saat tindakan AWS CloudFormation tumpukan Deploy berjalan, CodeCatalyst berkoordinasi dengan CloudFormation untuk mengirim satu notifikasi per AWS CloudFormation peristiwa yang terjadi selama proses pembuatan atau pembaruan tumpukan. (Peristiwa terlihat di tab Peristiwa AWS CloudFormation konsol untuk tumpukan.) Anda dapat menentukan hingga lima topik. Untuk informasi selengkapnya, lihat Apa itu AmazonSNS? .

UI yang sesuai: Tab Konfigurasi/Lanjutan/Pemberitahuan ARNs

monitor-alarm-arns

(DeployCloudFormationStack/Configuration/monitor-alarm-arns)

(Opsional)

Tentukan Amazon Resource Name (ARN) dari CloudWatch alarm Amazon yang akan digunakan sebagai pemicu rollback. Misalnya, arn:aws:cloudwatch::123456789012:alarm/MyAlarm. Anda dapat memiliki maksimal lima pemicu rollback.

catatan

Jika Anda menentukan CloudWatch alarmARN, Anda juga harus mengonfigurasi izin tambahan untuk mengaktifkan tindakan untuk mengakses CloudWatch. Untuk informasi selengkapnya, lihat Mengkonfigurasi rollback.

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