Timpa parameter pada instans tumpukan

Dalam kasus tertentu, Anda mungkin ingin instans tumpukan di Wilayah atau akun tertentu memiliki nilai properti yang berbeda dari yang ditentukan dalam set tumpukan itu sendiri. Misalnya, Anda mungkin ingin menentukan nilai yang berbeda untuk parameter yang diberikan berdasarkan apakah akun digunakan untuk pengembangan atau produksi. Untuk situasi ini, AWS CloudFormation mengizinkan Anda untuk menimpa nilai parameter dalam instans tumpukan oleh akun dan Wilayah. Anda dapat menimpa nilai parameter templat ketika Anda pertama kali membuat instans tumpukan, dan Anda dapat menimpa nilai parameter untuk instans tumpukan yang ada. Anda hanya dapat mengatur parameter yang sebelumnya telah Anda timpa dalam instans tumpukan kembali ke nilai yang ditentukan dalam set tumpukan.

Penimpaan nilai parameter berlaku untuk instans tumpukan di akun dan Wilayah yang Anda pilih. Selama pembaruan set tumpukan, nilai parameter apa pun yang diganti untuk instance tumpukan tidak diperbarui, tetapi mempertahankan nilai yang diganti.

Anda hanya dapat menimpa nilai parameter yang ditentukan dalam set tumpukan; untuk menambah atau menghapus parameter itu sendiri, Anda perlu memperbarui templat set tumpukan. Jika Anda menambahkan parameter ke templat set tumpukan, maka sebelum Anda dapat menimpa nilai parameter tersebut dalam instans tumpukan Anda harus terlebih dahulu memperbarui semua instans tumpukan dengan parameter dan nilai baru yang ditentukan dalam set tumpukan. Setelah semua instans tumpukan telah diperbarui dengan parameter baru, Anda kemudian dapat menimpa nilai parameter dalam instans tumpukan individu seperti yang diinginkan.

Untuk mempelajari cara menimpa nilai parameter set tumpukan ketika Anda membuat instans tumpukan, lihat Tambahkan tumpukan ke set tumpukan.

Ganti parameter pada instance tumpukan menggunakan AWS Management Console

1. Buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation.

2. Dari panel navigasi, pilih StackSets. Pada StackSets halaman, pilih kumpulan tumpukan yang Anda buatBuat set tumpukan. Dalam panduan tersebut, kita membuat set tumpukan bernama my-awsconfig-stackset.

3. Dengan set tumpukan yang dipilih, pilih Override StackSet parameter dari menu Actions.

   

4. Pada halaman Atur opsi deployment, berikan akun dan Wilayah untuk instans tumpukan yang parameternya ingin Anda timpa.

   AWS CloudFormation akan menerapkan tumpukan di akun yang ditentukan dalam Wilayah pertama, lalu beralih ke yang berikutnya, dan seterusnya, asalkan kegagalan penerapan Wilayah tidak melebihi toleransi kegagalan yang ditentukan.

   1. [Izin yang dikelola sendiri] Untuk Target deployment pilih Deploy tumpukan di akun. Tempelkan beberapa atau semua ID akun target yang Anda gunakan untuk membuat set tumpukan Anda di Buat set tumpukan.

      [Izin yang dikelola layanan] Untuk Target deployment, pilih akun di organisasi Anda untuk men-deploy.

      • Pilih Deploy ke unit organisasi (OU). Pilih satu atau lebih OU target yang Anda gunakan untuk membuat set tumpukan Anda di Buat set tumpukan. Nilai parameter yang ditimpa hanya berlaku untuk akun yang saat ini berada di OU target dan OU anak. Akun yang ditambahkan ke OU target dan OU anak di masa mendatang akan menggunakan nilai default set tumpukan dan bukan nilai yang ditimpa.

        

      • Pilih Deploy ke akun. Tempelkan beberapa atau semua ID OU target atau ID akun yang Anda gunakan untuk membuat set tumpukan Anda di Buat set tumpukan.

        

   2. Untuk Wilayah deployment, tambahkan satu atau lebih Wilayah tempat Anda telah men-deploy instans tumpukan untuk set tumpukan ini.

      Jika Anda menambahkan beberapa Wilayah, urutan Wilayah dalam Tentukan wilayah menentukan urutan deployment mereka.

   3. Untuk Opsi deployment:

      • Untuk Akun bersamaan maksimum, jaga agar nilai default tetap Angka dan 1.

        Ini berarti bahwa AWS CloudFormation menyebarkan tumpukan Anda hanya dalam satu akun pada satu waktu.

      • UntukToleransi kegagalan, jaga agar default tetap Angka dan 0.

        Ini berarti bahwa maksimum satu penyebaran tumpukan dapat gagal di salah satu Wilayah yang Anda tentukan sebelum AWS CloudFormation menghentikan penerapan di Wilayah saat ini, dan membatalkan penerapan di Wilayah yang tersisa.

      Pilih Selanjutnya.

5. Pada halaman Specify Overrides, periksa parameter Frekuensi lalu pilih Override StackSet value dari menu Edit override value.

   

6. Dalam Ganti nilai StackSet parameter, pilih 6 jam untuk parameter Frekuensi, dan pilih Simpan perubahan. Anda menginstruksikan AWS CloudFormation untuk menimpa nilai parameter Frekuensi dan menggunakan 6jam untuk semua instans tumpukan untuk akun tertentu di Wilayah tertentu. Pilih Selanjutnya.

   catatan

   Untuk menyetel parameter yang diganti kembali menggunakan nilai yang ditentukan dalam kumpulan tumpukan, periksa semua parameter dan pilih Set to StackSet value dari menu Edit override value. Melakukannya menghapus semua nilai yang ditimpa setelah Anda memperbarui instans tumpukan.

7. Pada halaman Tinjau, tinjau pilihan Anda. Perhatikan bahwa parameter Frekuensi menampilkan nilai dalam kolom Timpa nilai, menunjukkan bahwa nilainya telah ditimpa di tingkat tumpukan.

   Sebelum Anda dapat mengganti parameter untuk instance tumpukan ini, Anda harus mengisi kotak centang di area Kemampuan untuk mengetahui bahwa beberapa sumber daya yang Anda buat dengan kumpulan tumpukan mungkin memerlukan sumber daya dan izin IAM baru. Untuk informasi selengkapnya tentang izin yang berpotensi diperlukan, lihatMengakui IAM sumber daya dalam templat AWS CloudFormation. Saat Anda siap, pilih Kirim.

8. AWS CloudFormation mulai memperbarui instance tumpukan Anda. Lihat kemajuan dan status instans tumpukan di halaman detail set tumpukan yang terbuka saat Anda memilih Kirim.

Ganti parameter pada instance tumpukan menggunakan AWS CLI

Saat bertindak sebagai administrator yang didelegasikan, Anda harus mengatur --call-as parameter untuk DELEGATED_ADMIN setiap kali Anda menjalankan StackSets perintah.

--call-as DELEGATED_ADMIN

Jalankan update-stack-instances AWS CLI perintah, tentukan. --parameter-overrides Untuk informasi selengkapnya tentang menentukan--parameter-overrides, lihat Parameterdi Referensi AWS CloudFormation API, dan update-stack-instancesdi Referensi AWS CLI Perintah.

Dalam perintah contoh yang ditunjukkan di sini, kita mengubah frekuensi pengiriman snapshot default untuk konfigurasi saluran pengiriman dari TwentyFour_Hours ke Twelve_Hours untuk instance stack yang ditentukan.

1. Jalankan perintah berikut. Untuk--stack-set-name, tentukan nama set tumpukan my-awsconfig-stackset.

   Atur toleransi kegagalan dan akun bersamaan maksimum dengan mengatur FailureToleranceCount ke 0, dan MaxConcurrentCount ke 1 dalam parameter --operation-preferences, seperti yang ditunjukkan dalam contoh berikut. Untuk menerapkan persentase, gunakan FailureTolerancePercentage atau MaxConcurrentPercentage. Untuk panduan ini, kita menggunakan jumlah, bukan persentase.

   catatan

   Nilai MaxConcurrentCount tergantung pada nilai FailureToleranceCount. MaxConcurrentCount paling banyak satu lebih dari FailureToleranceCount.

   [Izin yang dikelola sendiri] Berikan ID akun yang ingin Anda timpa nilai parameternya pada instans tumpukan.

   aws cloudformation update-stack-instances --stack-set-name my-awsconfig-stackset --parameter-overrides ParameterKey=MaximumExecutionFrequency,ParameterValue=TwentyFour_Hours\\,Twelve_Hours --operation-preferences FailureToleranceCount=0,MaxConcurrentCount=1 --accounts '["012345678901"]' --regions '["eu-west-1", "us-west-2"]'

   [Izin yang dikelola layanan] Berikan ID root organisasi, ID OU, atau ID AWS Organizations akun yang ingin Anda ganti parameternya pada instance tumpukan. Dalam contoh ini, kita menimpa nilai parameter untuk instans tumpukan di semua akun di OU dengan ID ou-rcuk-1x5j1lwo.

   Nilai parameter yang ditimpa hanya berlaku untuk akun yang saat ini di OU target dan OU anaknya. Akun yang ditambahkan ke OU target dan OU anaknya di masa mendatang akan menggunakan nilai default set tumpukan dan bukan nilai yang ditimpa.

   aws cloudformation update-stack-instances --stack-set-name my-awsconfig-stackset --parameter-overrides ParameterKey=MaximumExecutionFrequency,ParameterValue=TwentyFour_Hours\\,Twelve_Hours --operation-preferences FailureToleranceCount=0,MaxConcurrentCount=1 --deployment-targets OrganizationalUnitIds='["ou-rcuk-1x5j1lwo"]' --regions '["eu-west-1", "us-west-2"]'

2. Verifikasi bahwa nilai parameter Anda berhasil diganti pada instance tumpukan dengan menjalankan describe-stack-set-operation perintah untuk menampilkan status dan hasil operasi pembaruan Anda. Untuk --operation-id, gunakan ID operasi yang dikembalikan oleh perintah update-stack-instances Anda.

   aws cloudformation describe-stack-set-operation --operation-id operation_ID