Perbarui template tumpukan Anda - AWS CloudFormation

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

Perbarui template tumpukan Anda

Untuk memodifikasi sumber daya atau properti dalam CloudFormation tumpukan, Anda harus memperbarui template tumpukan. Mulailah dengan template yang ada untuk tumpukan itu dan buat perubahan Anda padanya. Jika Anda memiliki template yang disimpan dalam sistem kontrol sumber, gunakan salinannya sebagai titik awal Anda. Jika tidak, Anda bisa mendapatkan salinan template dari CloudFormation.

Jika Anda hanya ingin mengubah parameter atau pengaturan tumpukan (seperti SNS topik Amazon tumpukan), Anda dapat menggunakan kembali template yang ada tanpa mendapatkan salinannya.

Anda dapat memperbarui template CloudFormation tumpukan dengan menggunakan Komposer Infrastruktur atau editor teks.

Untuk memperbarui template stack yang ada dengan menggunakan Infrastructure Composer

  1. Pada halaman Stacks CloudFormation konsol, pilih nama tumpukan yang ingin Anda perbarui.

  2. Di panel detail tumpukan untuk tumpukan yang dipilih, pilih tab Template, lalu pilih View in Infrastructure Composer.

  3. CloudFormation membuka template di Infrastructure Composer. Di sini, Anda dapat menyeret, melepas, mengonfigurasi, dan menghubungkan sumber daya (kartu) dari palet Sumber Daya. Untuk informasi selengkapnya, lihat Cara menulis. AWS Infrastructure Composer

Untuk memperbarui template tumpukan yang ada dengan menggunakan AWS CLI

  1. Untuk mendapatkan template untuk tumpukan yang ingin Anda perbarui, gunakan perintah get-templateCLI.

  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.

Ingatlah poin-poin berikut saat Anda membuat perubahan pada template Anda:

  • Anda tidak dapat menambahkan, memodifikasi, atau menghapus parameter yang digunakan oleh sumber daya yang tidak mendukung pembaruan.

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

  • Beberapa sumber daya mungkin memiliki kendala tentang nilai apa yang dapat Anda tetapkan untuk properti tertentu. Misalnya, perubahan AllocatedStorage properti untuk instance RDS database harus lebih besar dari nilai saat ini. Jika pembaruan Anda melanggar aturan ini, bagian itu akan gagal.

  • Memperbarui satu sumber daya juga dapat memengaruhi orang lain yang mereferensikannya. Jika Anda menggunakan fungsi seperti Ref atau GetAtt untuk mengatur properti berdasarkan sumber daya lain, CloudFormation akan memperbarui sumber referensi juga ketika referensi berubah.

  • Untuk informasi tentang efek memperbarui properti sumber daya tertentu, lihat Referensi Jenis AWS Sumber Daya. Untuk setiap properti, efek pembaruan akan menjadi salah satu dari berikut:

  • Anda dapat memverifikasi JSON atau YAML sintaks template Anda dengan menggunakan validate-templateCLIperintah atau dengan menentukan template Anda di konsol. Konsol melakukan validasi secara otomatis. Namun, metode ini hanya memverifikasi sintaks template Anda dan tidak memvalidasi nilai properti yang Anda tentukan untuk sumber daya yang valid untuk sumber daya tersebut. Untuk validasi yang lebih kompleks atau untuk memeriksa praktik terbaik, Anda mungkin juga menggunakan alat tambahan seperti CloudFormation Linter (cfn-lint) dan CloudFormation Rain (rain fmt).

catatan

Terkadang CloudFormation tidak mengizinkan perubahan tertentu yang Anda coba buat, dan itu akan memberi tahu Anda bahwa perubahan itu tidak diizinkan. Namun, pesan ini mungkin terjadi secara asinkron, karena sumber daya dibuat dan diperbarui oleh CloudFormation dalam urutan non-deterministik secara default.