Edit template secara visual dengan template studio

Template studio adalah editor template di CloudFormation konsol. Ini menunjukkan template Anda sebagai teks di samping diagram sumber daya yang dinyatakan template. Saat Anda mengedit template, diagram menggambar ulang agar sesuai. Anda dapat memvalidasi template, mengonversinya antara YAMB dan JSON, dan menyimpannya ke Amazon S3 tanpa meninggalkan konsol.

Teks template bersifat otoritatif. Diagram adalah representasi visual dari teks itu, bukan permukaan yang dapat diedit terpisah. Anda membuat semua perubahan dalam template.

Pertimbangan-pertimbangan

Ingatlah hal berikut saat Anda bekerja di studio template:

• Anda menulis di template, bukan pada diagram. Diagram menunjukkan sumber daya yang dideklarasikan template Anda dan bagaimana mereka merujuk satu sama lain; Anda tidak dapat menambahkan atau mengonfigurasi sumber daya dengan mengedit diagram.

• Suntingan Anda tidak disimpan secara otomatis. Template studio meminta konfirmasi sebelum Anda menavigasi dengan perubahan yang belum disimpan. Jika Anda meninggalkan atau menyegarkan halaman, perubahan yang belum disimpan akan dibuang. Simpan ke Amazon S3, atau salin atau unduh templat, sebelum Anda pergi.

• Mengonversi template dari YAMAL ke JSON membuang komentarnya, karena JSON tidak memiliki sintaks untuk mereka. Mengonversi kembali ke YAMAL tidak memulihkannya.

• CloudFormation validasi di studio template saat ini tidak tersedia untuk draf yang lebih besar dari 51.200 byte (50 KiB). Tindakan Validasi saat ini mengirimkan draf melalui TemplateBody parameter, yang memiliki batas ini. Ini bukan batas ukuran template keseluruhan. Anda masih dapat menyimpan template dan menggunakannya dalam operasi tumpukan, tunduk pada CloudFormation kuota. Untuk informasi selengkapnya, lihat Memvalidasi template.

• Menyimpan menulis template ke ember di akun Anda, jadi templat yang Anda simpan ditagih dengan tarif Amazon S3 standar. Untuk informasi selengkapnya, lihat Harga Amazon S3.

• Anda dapat mengunduh diagram sumber daya hanya ketika kanvas ditampilkan di tampilan Canvas atau Keduanya.

Izin diperlukan untuk studio template

Izin yang Anda butuhkan bergantung pada sumber template dan tindakan yang Anda lakukan:

cloudformation:GetTemplate

Diperlukan untuk membuka template stack yang ada. Berikan akses ke tumpukan yang templatnya ingin Anda edit.

s3:GetObject

Diperlukan untuk membaca template dari Amazon S3 menggunakan kredensil Anda. Berikan akses ke objek template sumber. URL presigned menggunakan otorisasi yang disertakan dalam URL.

cloudformation:ValidateTemplate

Diperlukan untuk memilih Validasi.

s3:PutObject

Diperlukan untuk menyimpan template. Cakupan izin ini ke objek di bucket tujuan, misalnya,arn:aws:s3:::destination-bucket/*, bukan semua sumber daya.

s3:CreateBucket

Diperlukan hanya saat konsol membuat bucket tujuan yang hilang. Ini bisa berupa bucket yang dikelola konsol atau nama bucket yang Anda tentukan. Menggunakan kembali bucket yang ada tidak memerlukan izin ini.

s3:ListBucket

Diperlukan saat menyimpan ke bucket yang sudah ada yang Anda tentukan. Studio templat digunakan HeadBucket untuk memverifikasi akses, pemilik bucket yang diharapkan, dan bucket Wilayah AWS sebelum mengunggah.

Untuk bucket yang dikelola konsol, izin ini bersifat opsional. Tanpa itu, dialog simpan masih menampilkan nama bucket. Menyimpan membutuhkan s3:PutObject dan, jika ember harus dibuat,s3:CreateBucket.

Buka studio templat

Di mana Anda membuka studio template dari menentukan apa yang dibuka dengan, dan apa yang terjadi setelah Anda menyimpan.

Untuk memulai template baru

1. Buka konsol CloudFormation .

2. Pada bilah navigasi di bagian atas layar, pilih yang ingin Wilayah AWS Anda gunakan.

3. Di panel navigasi, pilih Template studio.

Untuk membangun template sambil membuat tumpukan

1. Pada halaman Buat tumpukan, pilih Build with template studio.

2. Buat template, lalu pilih Simpan dan lanjutkan.

3. Stack wizard berlanjut dengan template yang Anda simpan, jadi Anda tidak perlu mengunggahnya secara terpisah.

Untuk mengedit template dari tumpukan yang ada

1. Pada halaman Stacks, pilih nama tumpukan.

2. Baik memperbarui tumpukan secara langsung atau membuat set perubahan.

3. Pada halaman Siapkan template, pilih Buka di studio template. Template stack saat ini terbuka.

4. Pilih Simpan dan terus kembali ke pembaruan atau ubah set dengan templat yang telah diedit.

Di tempat lain di konsol, di mana pun templat ditampilkan, Anda dapat memilih Buka di studio templat untuk mengerjakannya.

Bekerja dengan template dan diagram

Template studio terbuka dengan template dan diagram berdampingan. Gunakan kontrol tampilan untuk memilih apa yang ada di layar:

Template

Template saja, dengan lebar penuh. Gunakan ini untuk membaca atau menulis templat tanpa diagram.

Kanvas

Diagram saja, dengan lebar penuh. Gunakan ini untuk template besar di mana diagram membutuhkan lebar penuh.

Keduanya

Template dan diagram bersama-sama. Seret pembagi di antara mereka untuk memberi kedua sisi lebih banyak ruang.

Diagram mengelompokkan sumber daya terkait dan menarik koneksi di mana pun satu sumber daya merujuk ke sumber lain melalui RefFn::GetAtt,Fn::Sub,, atauDependsOn. Sumber daya yang tidak ada referensi muncul dengan sendirinya, yang membuat sumber daya yang terputus secara tidak sengaja mudah dikenali.

catatan

Misalnya, tiga fungsi dapat mengasumsikan peran IAM yang sama. Diagram menunjukkan peran di dalam setiap fungsi, tetapi template hanya menyatakan satu peran. Periksa template untuk melihat berapa banyak sumber daya yang ada.

Konversi antara YAMAL dan JSON

Format yang Anda simpan menentukan nama file dan jenis konten objek yang ditulis studio template ke Amazon S3.

Untuk mengonversi template yang Anda edit

1. Pilih kontrol format, yang memberi nama format yang Anda gunakan saat ini.

2. Pilih format lainnya.

3. Mengonversi dari YAMB ke JSON meminta Anda untuk mengonfirmasi, karena komentar tidak dapat dibawa. Pilih Konversi untuk melanjutkan.

penting

JSON tidak memiliki sintaks untuk komentar. Saat Anda mengonversi template YAMAL yang berisi komentar ke JSON, komentar tersebut akan dihapus, dan mengonversi kembali ke YAMAL tidak akan memulihkannya. Salin apa pun yang ingin Anda simpan sebelum Anda mengonversi.

Kontrol format tidak tersedia sementara template tidak dapat dibaca, karena tidak ada yang cukup lengkap untuk dikonversi. Perbaiki template terlebih dahulu.

Masalah sintaks saat Anda mengetik

Editor memeriksa sintaks template saat Anda menulisnya dan menggarisbawahi apa yang tidak dapat dibaca: braket yang tidak tertutup, indentasi yang salah tempat, kunci duplikat. Arahkan kursor ke garis bawah untuk melihat masalahnya. Di mana satu baris memiliki beberapa masalah, mereka diberi nomor sehingga Anda dapat membedakannya.

Ini adalah pemeriksaan sintaks template, bukan isinya. Editor tidak tahu jenis sumber daya mana yang ada atau properti mana yang mereka ambil, jadi templat yang dibentuk dengan sempurna YAMAL masih bisa salah dengan cara yang hanya CloudFormation dapat memberi tahu Anda. Pilih Validasi untuk itu.

Validasi template

Validasi memeriksa sintaks template dengan editor dan memeriksa template dengan CloudFormation sebelum Anda menggunakannya dalam operasi stack. Kedua pemeriksaan menggunakan draf saat ini, termasuk perubahan yang belum Anda simpan. CloudFormation Pemeriksaan yang berhasil tidak mengesampingkan kesalahan sintaks yang dilaporkan oleh editor.

catatan

Template studio mengirimkan draf ke ValidateTemplateAPI menggunakan TemplateBody parameter. Parameter ini memiliki batas 51.200-byte (50 KiB).

Untuk draf di atas batas ini, studio template tidak mengirim CloudFormation permintaan. CloudFormation Cek tidak tersedia, tetapi ini tidak berarti template tidak valid. Editor masih dapat melaporkan kesalahan sintaks.

API yang sama mendukung template hingga 1 MBTemplateURL. Studio templat tidak mengunggah draf yang diedit untuk URL-based validasi. Anda dapat menyimpan template ke Amazon S3 dan memvalidasinya melalui operasi tumpukan, tunduk pada kuota. CloudFormation

Untuk memvalidasi template yang Anda edit

1. Pilih Validasi.

2. Template yang melewati kedua cek dilaporkan sebagai Valid.

3. Jika salah satu cek menemukan kesalahan, tinjau mereka dalam pesan validasi. Kesalahan editor termasuk nomor baris dan kolom. Perbaiki kesalahan di editor dan validasi lagi.

Simpan template ke Amazon S3

CloudFormation membaca template untuk operasi tumpukan dari Amazon S3, jadi menyimpan adalah apa yang membuat template Anda tersedia untuk seluruh konsol.

Gunakan referensi dinamis ke rahasia yang disimpan di Secrets Manager atau string aman di Systems Manager Parameter Store alih-alih menyertakan rahasia plaintext dalam template yang disimpan. Untuk informasi selengkapnya, lihat Dapatkan nilai yang disimpan di layanan lain menggunakan referensi dinamis.

Untuk menyimpan template yang Anda edit

1. Jangan pilih Save and continue (Simpan dan lanjutkan).

2. Periksa tujuan. Secara default, template masuk ke bucket Amazon S3 yang CloudFormation mengelola template yang diunggah saat ini. Wilayah AWS Jika bucket itu belum ada, CloudFormation buat saat Anda menyimpan dan menggunakannya kembali untuk template yang Anda simpan nanti.

   1. Untuk memilih tujuan Anda sendiri, pilih Gunakan ember yang berbeda dan masukkan nama Bucket. Bucket dibuat jika belum ada.

3. Pilih Konfirmasi dan lanjutkan.

catatan

Template yang disimpan di Amazon S3 ditagih dengan tarif Amazon S3 standar, ember mana pun yang menahannya. Untuk informasi selengkapnya, lihat Harga Amazon S3.

Menyimpan tidak memerlukan hasil validasi yang sukses. Ketika validasi menemukan kesalahan, studio template meminta Anda untuk mengonfirmasi bahwa Anda tetap ingin menyimpan. Menyimpan tidak memperbaiki kesalahan tersebut; tinjau dan perbaiki sebelum menggunakan template dalam operasi tumpukan.

Salin atau unduh templat atau diagram

Pilih tindakan Template untuk mengeluarkan templat atau diagram dari konsol:

Salin template

Salin template seperti yang muncul di editor ke clipboard Anda.

Unduh Template

Menyimpan template sebagai file, dalam format yang sedang Anda edit.

Unduh diagram sumber daya

Menyimpan diagram sebagai gambar PNG. Karena gambar adalah tangkapan diagram, ini hanya tersedia ketika diagram ada di layar.