CreationPolicyatribut - AWS CloudFormation

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

CreationPolicyatribut

Kaitkan CreationPolicy atribut dengan sumber daya untuk mencegah statusnya mencapai create complete hingga AWS CloudFormation menerima sejumlah sinyal sukses tertentu atau periode batas waktu terlampaui. Untuk memberi sinyal sumber daya, Anda dapat menggunakan skrip pembantu sinyal cfn atau. SignalResourceAPI CloudFormation menerbitkan sinyal yang valid ke peristiwa tumpukan sehingga Anda melacak jumlah sinyal yang dikirim.

Kebijakan pembuatan hanya dipanggil saat CloudFormation membuat sumber daya terkait. Saat ini, satu-satunya CloudFormation sumber daya yang mendukung kebijakan pembuatan adalah:

Gunakan atribut CreationPolicy ketika Anda ingin menunggu pada tindakan konfigurasi sumber daya sebelum pembuatan tumpukan dilanjutkan. Misalnya, jika Anda menginstal dan mengkonfigurasi aplikasi perangkat lunak pada sebuah EC2 instance, Anda mungkin ingin aplikasi tersebut berjalan sebelum melanjutkan. Dalam kasus tersebut, Anda dapat menambahkan atribut CreationPolicy ke instans, dan kemudian mengirim sinyal sukses ke instans setelah aplikasi diinstal dan dikonfigurasi. Untuk contoh terperinci, lihat Menyebarkan aplikasi di Amazon EC2.

AppStream 2.0 kebijakan pembuatan

AppStream Konfigurasi Amazon untuk kebijakan pembuatan.

Sintaks

JSON

{ "CreationPolicy": { "StartFleet": { "Type": "Boolean" } } }

YAML

CreationPolicy: StartFleet: Type: Boolean
StartFleet

Mulai armada yang ditentukan.

Wajib: Tidak

Properti pembuatan EC2 Auto Scaling Amazon

Konfigurasi EC2 Auto Scaling Amazon untuk kebijakan pembuatan.

Sintaks

JSON

"CreationPolicy" : { "AutoScalingCreationPolicy" : { "MinSuccessfulInstancesPercent" : Integer }, "ResourceSignal" : { "Count" : Integer, "Timeout" : String } }

YAML

CreationPolicy: AutoScalingCreationPolicy: MinSuccessfulInstancesPercent: Integer ResourceSignal: Count: Integer Timeout: String

Properti pembuatan EC2 Auto Scaling Amazon

Konfigurasi EC2 Auto Scaling Amazon untuk kebijakan pembuatan.

AutoScalingCreationPolicy

Untuk grup EC2 Auto Scaling Amazon baru, tentukan jumlah instans yang harus menandakan keberhasilan sebelum menyetel status grup. CREATE_COMPLETE

MinSuccessfulInstancesPercent

Menentukan persentase instans dalam Auto EC2 Scaling Amazon yang harus menandakan keberhasilan sebelum menyetel status grup. CREATE_COMPLETE Anda dapat menentukan nilai dari 0 ke100. CloudFormation putaran ke sepersepuluh persen terdekat. Misalnya, jika Anda membuat lima instance dengan persentase keberhasilan minimum50, tiga instance harus menandakan keberhasilan. Jika sebuah instance tidak mengirim sinyal dalam waktu yang ditentukan oleh Timeout properti, CloudFormation asumsikan bahwa instance tidak dibuat.

Default: 100

Tipe: Integer

Wajib: Tidak

ResourceSignal

Saat CloudFormation membuat sumber daya terkait, mengonfigurasi jumlah sinyal keberhasilan yang diperlukan dan lamanya waktu yang CloudFormation menunggu sinyal tersebut.

Count

Jumlah sinyal keberhasilan CloudFormation harus diterima sebelum menetapkan status sumber daya sebagaiCREATE_COMPLETE. Jika sumber daya menerima sinyal kegagalan atau tidak menerima jumlah sinyal yang ditentukan sebelum periode batas waktu berakhir, pembuatan sumber daya gagal dan CloudFormation memutar tumpukan kembali.

Default: 1

Tipe: Integer

Wajib: Tidak

Timeout

Lamanya waktu yang CloudFormation menunggu jumlah sinyal yang ditentukan dalam Count properti. Periode batas waktu dimulai setelah CloudFormation menstabilkan sumber daya, dan batas waktu berakhir tidak lebih cepat dari waktu yang Anda tentukan tetapi dapat terjadi segera setelahnya. Waktu maksimum yang dapat Anda tentukan adalah 12 jam.

Nilai harus dalam format durasi ISO86 01, dalam bentuk:PT#H#M#S, di mana masing-masing # adalah jumlah jam, menit, dan detik, masing-masing. Untuk hasil terbaik, tentukan periode waktu yang memberikan instans Anda banyak waktu untuk bangun dan berjalan. Batas waktu yang lebih pendek dapat menyebabkan rollback.

Default: PT5M (5 menit)

Tipe: String

Wajib: Tidak

Contoh

Grup Auto Scaling

Contoh berikut menunjukkan cara menambahkan kebijakan pembuatan ke grup EC2 Auto Scaling Amazon. Kebijakan pembuatan membutuhkan tiga sinyal berhasil dan habis waktu setelah 15 menit.

Agar instance menunggu pemeriksaan kesehatan Elastic Load Balancing sebelum sinyal berhasil, tambahkan verifikasi pemeriksaan kesehatan dengan menggunakan skrip pembantu cfn-init. Sebagai contoh, lihat verify_instance_health perintah dalam contoh template untuk pembaruan bergulir Amazon EC2 Auto Scaling di repositori kamiGitHub .

JSON
"AutoScalingGroup": { "Type": "AWS::AutoScaling::AutoScalingGroup", "Properties": { "VPCZoneIdentifier":[ "subnetIdAz1", "subnetIdAz2", "subnetIdAz3" ], "LaunchTemplate":{ "LaunchTemplateId":{ "Ref":"logicalName" }, "Version":{ "Fn::GetAtt":[ "logicalName", "LatestVersionNumber" ] } }, "MinSize": "1", "MaxSize": "4" }, "CreationPolicy": { "ResourceSignal": { "Count": "3", "Timeout": "PT15M" } } }
YAML
AutoScalingGroup: Type: AWS::AutoScaling::AutoScalingGroup Properties: VPCZoneIdentifier: - subnetIdAz1 - subnetIdAz2 - subnetIdAz3 LaunchTemplate: LaunchTemplateId: !Ref logicalName Version: !GetAtt logicalName.LatestVersionNumber MinSize: '1' MaxSize: '4' CreationPolicy: ResourceSignal: Count: '3' Timeout: PT15M

WaitCondition

Contoh berikut menunjukkan cara menambahkan kebijakan pembuatan ke suatu kondisi menunggu.

JSON
"WaitCondition" : { "Type" : "AWS::CloudFormation::WaitCondition", "CreationPolicy" : { "ResourceSignal" : { "Timeout" : "PT15M", "Count" : "5" } } }
YAML
WaitCondition: Type: AWS::CloudFormation::WaitCondition CreationPolicy: ResourceSignal: Timeout: PT15M Count: 5