Mengubah templat tumpukan

Jika ingin mengubah sumber daya dan properti yang dinyatakan dalam templat tumpukan, Anda harus mengubah templat tumpukan. Untuk memastikan bahwa Anda memperbarui hanya sumber daya yang diinginkan, gunakan templat untuk tumpukan yang sudah ada sebagai titik awal dan buat pembaruan untuk templat tersebut. Jika Anda mengelola templat dalam sistem kontrol sumber, gunakan salinan templat tersebut sebagai titik awal. Jika tidak, Anda bisa mendapatkan salinan templat tumpukan dari AWS CloudFormation.

Jika Anda ingin memodifikasi hanya parameter atau pengaturan tumpukan (seperti topik Amazon SNS tumpukan), Anda dapat menggunakan kembali template tumpukan yang ada. Anda tidak perlu mendapatkan salinan templat tumpukan atau membuat perubahan pada templat tumpukan.

catatan

Jika template Anda menyertakan perubahan yang tidak didukung, akan AWS CloudFormation menampilkan pesan yang mengatakan bahwa perubahan tersebut tidak diizinkan. Namun, pesan ini mungkin terjadi secara asinkron, karena sumber daya dibuat dan diperbarui oleh AWS CloudFormation dalam urutan non-deterministik secara default.

Memperbarui templat tumpukan (konsol)

1. Di halaman Tumpukan dari KonsolAWS CloudFormation, klik nama tumpukan yang akan diperbarui.

2. Di panel detail tumpukan untuk tumpukan yang dipilih, pilih panel Templat, lalu klik Lihat di Designer.

   AWS CloudFormation membuka salinan template stack di AWS CloudFormation Designer.

3. Mengubah templat.

   Anda dapat menggunakan drag-and-drop antarmuka AWS CloudFormation Designer atau editor JSON dan YAMAL terintegrasi untuk memodifikasi template. Untuk informasi selengkapnya tentang menggunakan AWS CloudFormation Designer, lihatApa itu AWS CloudFormation Desainer?.

   Mengubah hanya sumber daya yang ingin Anda perbarui. Gunakan nilai yang sama sebagai konfigurasi tumpukan saat ini untuk sumber daya dan properti yang tidak diperbarui. Anda dapat mengubah templat dengan menyelesaikan salah satu tindakan berikut:

   • Menambahkan sumber daya baru, atau menghapus sumber daya yang sudah ada.

     Untuk sebagian besar sumber daya, mengubah nama logis dari sumber daya setara dengan menghapus sumber daya tersebut dan menggantinya dengan yang baru. Sumber daya lainnya yang bergantung pada sumber daya yang diganti namanya juga perlu diperbarui dan dapat menyebabkan mereka diganti. Sumber daya lain mengharuskan Anda untuk memperbarui properti (bukan hanya nama logis) untuk memulai pembaruan.

   • Menambahkan, mengubah, atau menghapus properti sumber daya yang sudah ada.

     Lihat Referensi Jenis Sumber DayaAWS untuk informasi tentang efek memperbarui atribut sumber daya tertentu. Untuk setiap properti, efek pembaruan akan menjadi salah satu dari berikut:

     • Pembaruan membutuhkan: Tidak ada gangguan

     • Pembaruan membutuhkan: Beberapa gangguan

     • Pembaruan membutuhkan: Penggantian

   • Menambahkan, mengubah, atau menghapus atribut untuk sumber daya (Metadata, DependsOn, CreationPolicy, UpdatePolicy, dan DeletionPolicy).

     penting

     Anda tidak dapat memperbarui UpdatePolicy atribut CreationPolicy or dengan sendirinya. Anda hanya dapat memperbarui atribut jika menyertakan perubahan yang menambah, mengubah, atau menghapus sumber daya. Misalnya, Anda dapat menambahkan atau mengubah atribut metadata sumber daya.

   • Menambahkan, mengubah, atau menghapus deklarasi parameter. Namun, Anda tidak dapat menambahkan, mengubah, atau menghapus parameter yang digunakan oleh sumber daya yang tidak mendukung pembaruan.

   • Menambahkan, mengubah, atau menghapus deklarasi pemetaan.

     penting

     Jika nilai dalam pemetaan tidak digunakan oleh tumpukan, Anda tidak dapat memperbarui pemetaan dengan sendirinya. Anda harus menyertakan perubahan yang menambahkan, mengubah, atau menghapus sumber daya. Misalnya, Anda dapat menambahkan atau mengubah atribut metadata sumber daya. Jika Anda memperbarui nilai pemetaan yang digunakan tumpukan, Anda tidak perlu membuat perubahan lain untuk memulai pembaruan.

   • Menambahkan, mengubah, atau menghapus deklarasi syarat.

     penting

     Anda tidak dapat memperbarui syarat dengan sendirinya. Anda hanya dapat memperbarui syarat jika menyertakan perubahan yang menambahkan, mengubah, atau menghapus sumber daya. Misalnya, Anda dapat menambahkan atau mengubah atribut metadata sumber daya.

   • Menambahkan, mengubah, atau menghapus deklarasi nilai output.

   Beberapa sumber daya atau properti mungkin memiliki batasan pada nilai properti atau perubahan pada nilai tersebut. Misalnya, perubahan ke properti AllocatedStorage dari sumber daya AWS::RDS::DBInstance harus lebih besar dari pengaturan saat ini. Jika nilai yang ditentukan untuk pembaruan tidak memenuhi batasan tersebut, pembaruan untuk sumber daya gagal. Untuk batasan tertentu pada perubahan AllocatedStorage, lihat ModifyDBInstance.

   Pembaruan untuk sumber daya dapat memengaruhi properti sumber daya lainnya. Jika Anda menggunakan fungsi Ref atau Fn::GetAtt fungsi untuk menentukan atribut dari sumber daya yang diperbarui sebagai bagian dari nilai properti di sumber daya lain dalam templat, AWS CloudFormation juga memperbarui sumber daya yang berisi referensi ke properti yang telah berubah. Misalnya, jika Anda memperbarui MasterUsername properti AWS::RDS::DBInstance sumber daya dan Anda memiliki sumber AWS::AutoScaling::LaunchConfiguration daya yang memiliki UserData properti yang berisi referensi ke nama instans DB menggunakan Ref fungsi, AWS CloudFormation akan membuat ulang instans DB dengan nama baru dan juga memperbarui LaunchConfiguration sumber daya.

4. Untuk memeriksa kesalahan sintaks dalam template Anda, dari toolbar AWS CloudFormation Designer, pilih Validasi template ().

   Tampilkan dan perbaiki kesalahan dalam panel Pesan, lalu validasi templat lagi. Jika tidak melihat kesalahan, templat Anda valid secara sintaksis.

5. Dari toolbar AWS CloudFormation Designer, pilih menu File ( ) lalu Simpan untuk menyimpan template di bucket S3 atau secara lokal.

6. Gunakan template yang diubah untuk memperbarui tumpukan secara langsung atau memperbarui tumpukan menggunakan set perubahan.

Mendapatkan dan memperbarui templat untuk tumpukan (CLI)

1. Untuk mendapatkan templat untuk tumpukan yang ingin diperbarui, gunakan perintah aws cloudformation get-template.

2. Salin templat, tempelkan ke file teks, ubah, dan simpan. Salin hanya templat. Perintah membungkus templat dalam tanda kutip, tetapi tidak menyalin tanda kutip di sekitar templat. Templat itu sendiri diawali dengan kurung buka dan diakhiri dengan kurung tutup. Tentukan perubahan pada sumber daya tumpukan dalam file ini.

3. Gunakan template yang diubah untuk memperbarui tumpukan secara langsung atau memperbarui tumpukan menggunakan set perubahan.