Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

CloudFormation Provider

Provider cloudformation merender Aggrega Recipes menjadi templat stack AWS CloudFormation. Setiap komponen yang dirender ke direktori keluaran yang sama di bawah provider ini dirakit menjadi satu stack, yang dihasilkan sebagai satu templat JSON murni yang menggunakan intrinsik bentuk panjang. Karena itu, dalam kasus biasa satu batas menjadi satu stack — dan dua batas yang directory:-nya mengarah ke path yang sama dirakit bersama menjadi satu stack, dengan berbagi nama-nama templat tersebut. Seperti setiap provider Aggrega, provider ini bersifat offline dan hermetis — build Aggrega adalah kompilasi ahead-of-time, sehingga provider tidak pernah memanggil AWS, tidak pernah me-resolve pengenal yang dihasilkan oleh akun, dan tidak pernah menjalankan CloudFormation. Nilai yang hanya ada saat runtime tetap berupa referensi intrinsik CloudFormation (Fn::GetAtt, Fn::ImportValue, Fn::GetStackOutput) yang di-resolve oleh CloudFormation pada saat deploy.

Recipe fragmen yang dirakit menjadi satu stack

Sebuah Recipe cloudformation menulis sebuah fragmen — sumber daya CloudFormation yang disumbangkan oleh satu komponen — alih-alih seluruh template. Ketika komponen-komponen suatu batas dirender, provider merakit setiap fragmen dalam grup dispatch menjadi satu template stack: sumber daya digabungkan di bawah satu peta Resources, nilai provides setiap komponen muncul sebagai Outputs stack, dan bagian tingkat atas lain dari template dijelaskan satu per satu di Bagian tingkat atas dalam stack yang dirakit. Dua bentuk penulisan diterima:

  • Masukan fragmen (artefak). Sebuah Recipe menulis fragmen sumber daya secara langsung; provider menormalkannya menjadi intrinsik bentuk panjang JSON murni dan menggabungkannya ke dalam stack yang dirakit.
  • Masukan bersumber. Sebuah Recipe merujuk template CloudFormation yang sudah ada (YAML atau JSON); provider menormalkannya menjadi JSON bentuk panjang dan memvalidasi strukturnya sebelum perakitan, mengisi parameter yang dideklarasikan template dari valuesMapping milik Recipe tersebut — lihat Nilai untuk parameter template bersumber — dan menghilangkan setiap sumber daya yang disebut oleh entri omits: milik Recipe tersebut — lihat Menghilangkan sumber daya dari template bersumber.

Template yang dirakit berupa JSON murni. Intrinsik dikeluarkan apa adanya dan tidak pernah dievaluasi saat build — compiler tidak dapat me-resolve nilai yang baru ada setelah stack di-deploy, dan mengevaluasinya akan melanggar kontrak ahead-of-time.

Feature yang dilampirkan ke komponen berkontribusi pada stack yang sama

Sebuah Feature yang dilampirkan ke komponen menyumbangkan sumber dayanya ke stack tempat komponen induknya dirakit, dengan ketentuan yang sama seperti Recipe milik komponen induk itu sendiri. Tidak ada template terpisah di sampingnya: stack yang dirakit adalah keseluruhan yang dikeluarkan provider ini untuk satu direktori keluaran, sehingga sumber daya Feature yang dilampirkan berada di stack tersebut atau tidak di-deploy sama sekali. Melepas Feature tersebut menghapus tepat sumber daya itu dan membiarkan sumber daya milik komponen induk tidak tersentuh.

Karena sumber daya tersebut masuk ke stack yang dirakit, sumber daya tersebut berbagi nama-nama stack itu. ID logis sumber daya dari Feature yang dilampirkan berada di ruang yang sama dengan milik komponen induk dan milik setiap Feature lain yang dilampirkan bersamanya, sehingga Nama dalam stack yang dirakit berlaku untuknya tanpa perubahan. Ketika dua kontributor bertemu pada satu nama, penghentian menyebutkan komponen dan kunci tempat Feature dilampirkan, sehingga kedua ujung tabrakan dapat dicari di berkas Anda sendiri.

Output Feature yang dilampirkan diterbitkan dengan nama komponen induknya, sedangkan ID logis sumber dayanya tidak. Kedua bagian stack diberi nama dengan aturan yang berbeda, sehingga keduanya menjawab hal ini secara berbeda. ID logis sumber daya dikeluarkan persis seperti yang ditulis FeatureRecipe, sama seperti pada Recipe mana pun. Sebuah output diberi nama berdasarkan komponen penerbit dan entrinya sekaligus — dan untuk Feature yang dilampirkan ke komponen, komponen penerbitnya adalah induk: Feature yang dilampirkan ke payments-db yang menerbitkan alarm menghasilkan paymentsXzhdbXXalarm, nama yang sama yang akan dihasilkan jika komponen induk menerbitkan entri itu sendiri. Jadi, nama entri yang juga diterbitkan oleh induk bertemu dengan milik lampiran pada satu nama output, dan build berhenti dengan menyebutkan komponen dan kunci tempat Feature dilampirkan bersama komponen itu sendiri. Memilih nama entri yang terbaca sebagai milik Feature itu sendiri — backup-alarm alih-alih alarm — menjauhkannya dari milik induk.

Setiap sumber daya yang disumbangkan sebuah Feature mempertahankan identitas yang disusun untuk lampiran tersebut dalam provenance yang ditulis build ke sumber daya itu, bukan identitas komponen induk, sehingga keduanya tetap dapat dibedakan di dalam stack yang disumbang oleh keduanya. Label dan anotasi menjelaskan cara identitas tersebut dibangun.

Bagian tingkat atas dalam stack yang dirakit

Beberapa komponen dirakit menjadi satu stack, sehingga setiap bagian tingkat atas yang diterima templat CloudFormation harus diperhitungkan oleh perakitan — termasuk Globals dan Hooks, dua bagian yang ditambahkan ke bahasa templat oleh transform yang di-host CloudFormation. Masing-masing masuk ke tepat satu dari kelompok di bawah ini, dan kunci tingkat atas yang ditulis suatu komponen tetapi sama sekali bukan bagian akan mendapat peringatan yang menyebutkan komponen dan kunci tersebut, sehingga tidak ada yang dibuang tanpa diberitahukan.

Dirakit dengan nama yang dicakup oleh provider, atau dibaca sebagaimana ditulis. Resources dan Outputs, yang dibahas lengkap dalam Nama dalam stack yang dirakit. AWSTemplateFormatVersion ditulis oleh provider alih-alih dibaca dari komponen mana pun: bahasa templat hanya menerima satu nilai untuknya, sehingga tidak ada yang perlu diputuskan oleh komponen.

Dibawa dengan nama persis seperti yang Anda tulis. Parameters, Mappings, Conditions, Metadata dan Rules. Masing-masing adalah map dengan kunci berupa nama yang Anda pilih, sehingga entri setiap komponen sampai ke stack yang dirakit dengan nama tersebut, tanpa ditulis ulang — inilah yang memungkinkan Condition: suatu resource, Fn::FindInMap, atau Ref ke suatu parameter di-resolve terhadap deklarasi yang datang bersamanya. Masing-masing dibawa secara terpisah, karena masing-masing ditulis secara terpisah: sebuah rule menegaskan sesuatu atas parameter dari dokumen yang sama, sebuah condition bisa saja tidak mereferensikan parameter apa pun, dan CloudFormation tidak mengizinkan referensi parameter di dalam mapping.

Satu kata di sini mencakup dua tempat yang berbeda, dan hanya yang pertama milik Anda. Metadata dalam daftar di atas adalah bagian tingkat atas milik templat itu sendiri, sebuah map berisi nama yang Anda pilih. Setiap resource juga membawa atribut Metadata miliknya sendiri, dan di situlah build menulis provenance — di bawah satu kunci aggrega.ai/ yang dicadangkan, ditambahkan di samping apa pun yang Anda tulis di sana alih-alih menggantikannya. Jadi entri provenance yang muncul di dalam suatu resource bukanlah sesuatu yang Anda tulis dan bukan sesuatu yang dibawa oleh bagian tingkat atas.

Parameters, Mappings, Conditions dan Rules menamai entrinya dengan logical ID. Karena provider membawa nama persis seperti yang Anda tulis, alfabet yang diterima logical ID juga berlaku untuk bagian-bagian ini: nama dalam salah satu dari keempatnya yang memuat apa pun selain huruf dan angka akan menghentikan build — lihat Nama bagian yang dibawa di luar alfabet menghentikan build. Provider tidak menerapkan alfabet tersebut pada nama di bagian Metadata tingkat atas: nama-nama itu menamai informasi yang Anda simpan, bukan sesuatu yang dirujuk oleh templat.

Dua komponen yang mendeklarasikan nama berbeda dalam salah satu bagian ini sama-sama masuk. Dua yang mendeklarasikan satu nama dengan konten identik digabung menjadi satu entri dan build berlanjut. Dua yang mendeklarasikan satu nama dengan konten berbeda menghentikan build, dengan menyebutkan bagian, nama, dan kedua komponen — karena jika tidak, salah satu dari kedua isi akan dibuang, sehingga komponen yang menulisnya memiliki deklarasi yang tidak dibawa oleh stack. Itu adalah rekonsiliasi yang sama dengan yang diikuti nama resource dan output, dan mengganti nama salah satunya akan menyelesaikannya.

Disebutkan alih-alih dibawa. Description adalah satu pernyataan tentang keseluruhan templat, bukan map berisi nama yang Anda pilih, sehingga perakitan yang mengambil dari beberapa komponen tidak memiliki jawaban untuknya: dua deskripsi adalah dua jawaban untuk satu pertanyaan dan tidak satu pun milik stack. Hooks hanya dibaca oleh transform AWS::CodeDeployBlueGreen, yang tidak pernah dibawa oleh stack yang dirakit (lihat di bawah). Karena itu stack yang dirakit tidak membawa keduanya, dan setiap komponen yang menulis salah satunya mendapat peringatan yang menyebutkan komponen dan bagian tersebut. Begitu pula komponen yang menulis Globals tanpa mendeklarasikan transform AWS::Serverless-2016-10-31 yang membacanya. Peringatan ini bersifat anjuran dan di luar jalur: templat yang dihasilkan sama persis byte demi byte dengan templat tanpa peringatan itu, dan --no-unsupported-field-warnings membungkamnya bersama peringatan lain dalam kelas tersebut.

Transform dibangun dari milik setiap komponen. Transform adalah makro yang dijalankan CloudFormation atas seluruh templat sebelum men-deploy apa pun, sehingga Transform milik stack yang dirakit adalah gabungan transform yang dideklarasikan komponennya — baik dari templat bersumber maupun dari fragmen — dalam urutan yang didokumentasikan CloudFormation: makro yang didefinisikan akun Anda sebelum transform yang di-host CloudFormation, dan AWS::LanguageExtensions sebelum AWS::Serverless-2016-10-31. Urutan masing-masing komponen dipertahankan, dan dua transform yang tidak diurutkan oleh apa pun dijalankan dalam urutan komponen pertama kali mendeklarasikannya, sehingga komponen yang sama menghasilkan stack yang sama. Satu transform ditulis sebagai string dan beberapa sebagai list. Stack dengan hanya satu komponen, yang mendeklarasikan Transform-nya dalam satu templat atau fragmen, mempertahankannya persis seperti yang ditulis di mana pun tabel di bawah membawanya, dan stack yang komponennya tidak mendeklarasikan apa pun tidak membawa apa pun. Transform suatu komponen tidak memunculkan peringatan: transform itu dibawa, atau build berhenti dengan menyebutkannya.

Karena transform memproses seluruh templat, membawa satu transform mengubah cara konten setiap komponen lain di-deploy kecuali apa yang dilakukannya terbatas pada konten yang ditulis untuknya. Jadi setiap transform mendapat perlakuan yang didukung oleh dokumentasi CloudFormation sendiri tentang transform tersebut, dan kombinasi yang tidak dapat dibawa stack akan menghentikan build, dengan menyebutkan transform dan setiap komponen dalam stack:

transformdalam stack yang dirakit
AWS::Serverless-2016-10-31dibawa, bersama Globals dari komponen yang mendeklarasikannya. Build berhenti jika Globals tersebut akan menjangkau resource serverless komponen lain, dan jika sumber event salah satu resource-nya menyebutkan resource yang dideklarasikan komponen lain, karena transform menulis ulang resource yang disebutkan suatu event.
AWS::LanguageExtensionsdibawa sendirian, atau di samping AWS::Serverless-2016-10-31 dari komponen yang sama. Build berhenti jika berada di samping konten serverless komponen lain, karena transform serverless menamai apa yang dihasilkannya secara berbeda setelah language extensions me-resolve nilainya.
AWS::SecretsManager-2020-07-23, AWS::SecretsManager-2024-09-16dibawa: transform ini hanya memproses rotation schedule yang memintanya.
AWS::ServiceCatalogdibawa untuk stack dengan hanya satu komponen. Di samping komponen lain mana pun build berhenti, karena transform ini menyubstitusi pola referensinya di mana saja dalam templat.
AWS::CodeDeployBlueGreenbuild berhenti, bahkan jika sendirian: CloudFormation menolak Outputs dan Fn::ImportValue di mana pun dalam templat yang mendeklarasikannya, sedangkan stack yang dirakit membawa output yang dipublikasikan komponennya.
AWS::Includebuild berhenti, bahkan jika sendirian: transform ini menyisipkan konten yang diambil dari S3 saat stack di-deploy, yang tidak dapat dibaca oleh build.
makro yang didefinisikan akun Andadibawa untuk stack dengan hanya satu komponen. Di samping komponen lain mana pun build berhenti, karena apa yang dilakukannya terhadap bagian templat lainnya tidak diketahui oleh build.

Dua komponen yang mendeklarasikan satu pasang transform dalam urutan berlawanan juga menghentikan build, dengan menyebutkan kedua urutan dan kedua komponen, karena stack menjalankannya dalam satu urutan. Komponen yang membutuhkan transform yang tidak dapat dibawa stack ditempatkan dalam boundary tersendiri.

Nama dalam stack hasil perakitan

Logical ID CloudFormation bersifat unik dalam satu template dan hanya menerima huruf dan angka, dan setiap komponen yang dirakit ke dalam template tersebut berbagi nama-namanya — termasuk komponen dari boundary kedua, ketika keduanya mengarah ke direktori keluaran yang sama. Karena itu, setiap nama yang digunakan stack untuk merujuk sesuatu harus berbeda di antara semua komponen yang menyumbangkannya, dan himpunan penyumbang tidak selalu berupa satu boundary.

Logical ID resource berasal dari Recipe. Provider menghasilkannya persis seperti yang ditulis dan tidak menulis ulang satu pun, sehingga nama yang Anda baca dalam template hasil perakitan adalah nama yang ditulis Recipe. Recipes CloudFormation pustaka standar menurunkannya dari nama instans komponen itu sendiri, dengan membaca pemisah dalam nama tersebut sebagai batas kata: instans payments-db menamai resource-nya PaymentsDb. Karena itu, dua instans dari tipe yang sama mendeskripsikan dua resource alih-alih memperebutkan satu.

Nama output dicakup oleh komponen yang menerbitkannya. Setiap entri provides muncul sebagai output yang dinamai menurut gabungan komponen penerbit dan entri tersebut — komponen payments-db yang menerbitkan host muncul sebagai paymentsXzhdbXXhost — sehingga dua komponen yang menerbitkan entri yang sama menghasilkan dua output terpisah, dan makna sebuah output tidak berubah ketika komponen lain bergabung ke stack. Konsumen lintas-stack dalam akun dan Region yang sama mengimpor berdasarkan nama export, bukan berdasarkan nama ini, sehingga nama export tidak terpengaruh; pembacaan lintas akun atau lintas Region menyebut output ini, sebagaimana provider menuliskannya untuk Anda (lihat Penyambungan lintas-stack).

Cara nama output dibentuk

Logical ID tidak menerima karakter pemisah apa pun, sehingga nama yang dibentuk dari sesuatu yang Anda tulis harus membawa pemisah Anda dengan suatu cara. Membuangnya akan menghilangkan informasi: payments-db dan payments_db adalah dua komponen, dan nama yang membuang tanda bacanya tidak akan mengidentifikasi keduanya. Karena itu, provider justru mengodekan apa yang ditolak alfabet, dengan menuliskan setiap karakter yang ditolak menggunakan karakter yang diterima alfabet.

Skema ini mencadangkan satu karakter untuk membuka escape — huruf kapital X — dan menulis semua hal lain persis seperti yang Anda ketik, termasuk huruf kapital. Hanya huruf kapitalnya yang dicadangkan, sehingga huruf kecil x dalam nama seperti nginx-proxy diteruskan seperti yang Anda tulis:

yang Anda tulishasilnyaalasan
huruf atau angka, kecuali Xdirinya sendirialfabet menerimanya
-Xzhalfabet menolak tanda hubung
_Xzualfabet menolak garis bawah
.Xzdalfabet menolak titik
/Xzsalfabet menolak garis miring, yang dibawa oleh identitas komponen bersarang
XXzx000058dicadangkan untuk membuka escape, sehingga dituliskan berdasarkan code point-nya
lainnyaXzx dan code point karakter tersebutsatu aturan mencakup semua karakter lainnya
pertemuan kedua bagianXXdua pembuka berturut-turut, yang tidak dapat dimuat oleh bagian mana pun

Membacanya kembali tidak ambigu, dan justru itulah intinya, bukan sekadar kelebihan. Sebuah X dipertahankan sebagai dirinya sendiri hanya jika karakter sesudahnya diterima alfabet, sehingga bagian yang dikodekan tidak pernah diakhiri dengannya dan tidak pernah memuat dua berturut-turut — yang membuat XX bebas untuk berarti sambungan, dan hanya sambungan.

Jadi, tiga nama yang hanya berbeda pada letak tanda bacanya tetap terpisah:

component payments-db publishing host → paymentsXzhdbXXhost
component payments_db publishing host → paymentsXzudbXXhost
component payments publishing db-host → paymentsXXdbXzhhost

Nama-nama ini lebih panjang dan kurang mudah dibaca dibandingkan nama komponen yang Anda tulis, dan itulah kompromi yang diambil. Nama yang mengidentifikasi tepat satu entri lebih berharga daripada nama yang lebih pendek tetapi tidak mengidentifikasi satu pun dari dua entri — dan Anda merujuk output melalui nama export, bukan dengan mengetik nama ini, sehingga biayanya hanyalah perlu melihat dua kali saat membaca template yang dihasilkan.

Logical ID resource mengikuti aturan yang berbeda, karena provider tidak membentuknya: provider menghasilkan apa yang ditulis Recipe. Recipes CloudFormation pustaka standar menurunkannya dengan membaca pemisah dalam nama instans sebagai batas kata — instans payments-db menamai resource-nya PaymentsDb — dan penurunan tersebut membuang pemisah, sehingga dua nama instans yang hanya berbeda dalam tanda baca, atau hanya dalam huruf besar-kecil, tetap menghasilkan satu nama resource. Build berhenti dengan menyebutkan setiap instans yang menghasilkan nama tersebut beserta nama yang dihasilkan, alih-alih menghasilkan satu resource padahal dua komponen dideklarasikan. Semuanya disebutkan, bukan hanya sebagian, karena tidak ada apa pun dalam tabrakan yang menjadikan penurunan satu instans sebagai yang dimaksud. Mengganti nama semuanya kecuali satu akan menyelesaikannya.

Logical ID resource di luar alfabet menghentikan build

Keunikan dan alfabet adalah dua persyaratan terpisah, dan sekumpulan nama dapat memenuhi yang pertama tetapi gagal memenuhi yang kedua. Karena provider menghasilkan logical ID resource persis seperti yang ditulis Recipe, ID yang ditulis Recipe harus dapat dimuat oleh template CloudFormation dengan sendirinya: huruf dan angka, tidak ada yang lain.

Di sinilah nama turunan dan nama yang diteruskan berpisah jalan. Nama output dibentuk oleh provider, yang mengodekan komponen penerbit dan entrinya, sehingga nama output berada di dalam alfabet bagaimana pun Anda mengeja kedua bagiannya. Logical ID resource diteruskan apa adanya, sehingga apa pun yang ditulis Recipe itulah yang diterima template.

Hal ini juga menjadi batasan bagi nama komponen, setiap kali Recipe menulis nama instans komponen langsung ke dalam logical ID. Nama komponen boleh memuat tanda hubung atau garis bawah; logical ID tidak. Karena itu, komponen yang Anda targetkan ke provider ini melalui Recipe semacam itu dinamai hanya dengan huruf dan angka — paymentsdb, bukan payments-db — dan apa pun selain itu menghentikan build.

Penghentian ini menyebutkan penyumbang yang Recipe-nya menulis ID tersebut, ID itu sendiri, dan setiap karakter di dalamnya yang tidak diperbolehkan, serta menyebutkan apa yang dapat Anda tulis sebagai gantinya. Ada dua cara untuk menyelesaikannya, dan cara pertama selalu tersedia bagi Anda:

  • Buat Recipe menulis logical ID-nya sendiri alih-alih meneruskan nama secara langsung. Recipes CloudFormation pustaka standar menempuh cara ini — membaca pemisah dalam nama instans sebagai batas kata, sehingga instans payments-db menamai resource-nya PaymentsDb dan Anda tetap menggunakan nama komponen yang Anda pilih. Menurunkan ID dengan cara ini menukar penghentian ini dengan aturan tabrakan di atas: dua nama instans yang hanya berbeda dalam tanda baca menghasilkan satu nama resource.
  • Jika Recipe memang meneruskan nama secara langsung, ganti nama apa pun yang diteruskannya dengan hanya huruf dan angka. Untuk Recipe milik komponen itu sendiri, yang diganti adalah nama komponen. Feature yang dilampirkan ke komponen menamai resource-nya dari FeatureRecipe miliknya sendiri, sehingga mengganti nama komponen host tidak menjangkaunya — ID yang ditulis Recipe tersebutlah yang harus diubah.

Provider menolak; provider tidak memperbaiki secara diam-diam. Menulis ulang ID atas nama Anda mungkin tampak membantu, padahal tidak. Logical ID adalah cara CloudFormation mengidentifikasi resource di seluruh pembaruan, sehingga mengubahnya bukan sekadar penggantian nama — itu merujuk resource yang berbeda. ID yang diganti oleh provider akan menunjuk ke tempat lain selain resource yang sudah di-deploy dengan ID yang Anda tulis, dan penggantian itu tidak pernah Anda minta dan harus Anda temukan sendiri dari template yang dihasilkan. Build yang berhenti menyebutkan masalahnya selagi masih dapat Anda perbaiki.

Nama bagian yang dibawa di luar alfabet menghentikan build

ID logis resource bukan satu-satunya nama yang dibawa provider persis seperti yang Anda tulis. Parameters, Mappings, Conditions dan Rules juga menamai entrinya dengan ID logis, dan masing-masing dari keempatnya mencapai stack yang dirakit dengan nama yang dipilih penulisnya. Jadi persyaratannya sama, pada empat permukaan lagi: nama tersebut harus dapat ditampung sendiri oleh template CloudFormation — huruf dan angka, tidak ada yang lain — dan apa pun selain itu menghentikan build.

Ada satu konsekuensi di luar bagian yang membawa nama tersebut, dan itulah alasan hal ini menghentikan build alih-alih memberi peringatan. Nama-nama ini adalah tempat Condition: milik suatu resource, sebuah Fn::FindInMap, atau sebuah Ref ke parameter di-resolve. Karena itu, nama yang tidak diterima alfabet mengeluarkan referensi yang menunjuk kepadanya dari template yang dapat di-deploy bersama deklarasinya sendiri, sehingga satu nama yang ditulis membuat keduanya tidak terjangkau sekaligus — dan tanpa penghentian, hal itu baru ditemukan saat deploy, oleh siapa pun yang melakukan deploy, bukan oleh yang menulis nama tersebut.

Penghentian tersebut menyebutkan kontributor yang Recipe-nya menulis nama itu, bagian tempat nama itu ditulis, nama itu sendiri, dan setiap karakter di dalamnya yang tidak boleh ada di sana. Bagian itulah istilah yang perlu dicari di Recipes Anda: nama-nama ini dibawa tepat di bawah bagian tempat Anda menulisnya, sehingga itulah satu-satunya kata yang muncul baik di pesan maupun di berkas Anda sendiri. Mengganti nama entri dengan huruf dan angka saja akan menyelesaikannya, dan itulah seluruh solusinya — ID logis resource menawarkan alternatif berupa membiarkan Recipe menurunkan ID alih-alih meneruskan nama, sedangkan di sini tidak ada yang dapat diturunkan, karena nama di bagian tersebut adalah apa yang Anda tulis.

Hanya nama milik bagian itu sendiri yang harus mengikuti alfabet, tidak pernah kunci di dalam sebuah entri. Kunci tingkat kedua sebuah mapping bebas Anda pilih — us-east-1 di bawah map RegionCidr adalah kasus biasa, dan mencapai template yang dihasilkan tanpa diubah. Kunci di dalam badan parameter, kondisi, atau rule menamai atribut, asersi, dan intrinsik, bukan sesuatu yang dialamatkan stack: Assertions milik sebuah rule, dan Fn::Contains yang ditulis di dalamnya, adalah kunci jenis itu. Tidak satu pun dari mereka adalah ID logis, dan tidak satu pun diperiksa.

Dua nama entri yang Anda tulis berbeda tetap terpisah

Tiga jenis nama entri cukup berdekatan untuk bertemu pada satu nama output, dan tidak satu pun dari mereka yang langka. Karena kedua bagian dikodekan alih-alih dilipat, dan bertemu pada urutan yang tidak dapat dimuat oleh bagian mana pun, ketiganya mencapai nama masing-masing:

  • Entri yang hanya berbeda dalam tanda baca. Sebuah component yang memublikasikan db-host dan db_host sekaligus mencapai dbXzhhost dan dbXzuhost.
  • Entri yang hanya berbeda dalam huruf besar-kecil. host dan Host mencapai host dan Host, karena huruf dibawa dalam bentuk huruf besar-kecil yang Anda tulis.
  • Entri yang bertemu melintasi sambungan. Component payments-db yang memublikasikan host mencapai paymentsXzhdbXXhost; component payments yang memublikasikan db-host mencapai paymentsXXdbXzhhost.

Dua entri tetap bertemu jika memang menamai satu hal yang sama. Nama output dibangun dari component yang memublikasikan dan entrinya, sehingga apa pun yang berbagi keduanya mencapai satu nama bagaimanapun pengodeannya. Kasus yang paling mungkin Anda temui adalah satu Feature yang dipasang dua kali pada satu component: sebuah pemasangan memublikasikan di bawah host-nya, sehingga dua pemasangan satu Feature pada satu component sama-sama memublikasikan alarm-id dari payments-db, dan tidak ada apa pun dalam pasangan itu untuk membedakannya. Build berhenti alih-alih menghasilkan satu output padahal dua yang ditulis, dengan menyebutkan component dan kunci pemasangan yang dibawa tiap sisi, sehingga kedua ujungnya dapat dicari di berkas Anda sendiri. Pasang Feature tersebut sekali saja, atau gunakan Feature yang nama entri publikasinya terbaca sebagai milik pemasangan itu sendiri.

Hal ini berlaku baik kedua entri membawa nilai yang sama maupun tidak. Dua entri dengan nilai yang sama tetap menggambarkan dua output yang diminta penulis, sehingga menggabungkannya menjadi satu akan membuat salah satu dari dua output yang ditulis tidak ada di stack.

Nama yang disusun Recipe dalam template tidak tercakup oleh hal ini

Pengodean di atas adalah milik provider, dan berlaku untuk nama output yang dibangun provider. Pengodean ini tidak tersedia bagi Anda di dalam template Recipe, sehingga nama yang disusun template Anda tidak membawa jaminan apa pun darinya. Menyatakannya secara gamblang penting karena bahayanya tidak terlihat dari dalam template: fungsi lipat yang tersedia di sana membaca argumennya sebagai kata-kata dan membuang semua yang ada di antaranya, sehingga menggabungkan dua nilai sebelum melipat menghilangkan sambungan bersama tanda bacanya.

FeatureRecipe yang menamai resource dari sebuah instance dan kunci pemasangan, digabungkan dengan spasi lalu dilipat, adalah bentuk yang perlu diwaspadai — app dengan cache dan app-cache tanpa apa pun sama-sama terlipat menjadi AppCache, dan keduanya bertabrakan sebelum sifat apa pun dari pelipatan berlaku. Dua hal menjaga nama seperti itu tetap berbeda, dan keduanya menjadi tanggung jawab Anda, bukan provider:

  • Pertahankan bagian-bagian yang disusun dalam huruf dan angka, sehingga tidak ada yang dibuang dan tidak ada yang perlu dibedakan.
  • Jangan gabungkan dua nilai yang masing-masing dapat memuat pemisah milik yang lain. Jika sebuah nama harus membawa dua bagian, jadikan salah satunya literal tetap yang tidak dapat dimuat oleh yang lain.

Jika nama yang disusun memang bertabrakan, tabrakannya terjadi sebagai ID logis resource, bukan sebagai nama output, sehingga penghentian yang Anda temui adalah penghentian nama resource di atas.

Kunci yang ditulis dua kali dalam satu mapping menghentikan build

Fragmen CloudFormation dibaca sebagai mapping, dan mapping menampung satu nilai per kunci, sehingga kunci yang ditulis dua kali akan mempertahankan badan mana pun yang muncul terakhir dan membuang yang lain. Jika mapping tersebut adalah blok Resources atau Outputs, badan yang dibuang adalah resource atau output yang telah ditulis dan begitu saja tidak akan ada di stack.

Sebagai gantinya build berhenti, dengan menyebutkan kunci yang berulang dan kedua baris tempat kunci itu ditulis. Ini adalah aturan untuk seluruh fragmen, bukan aturan tentang nama-nama stack: aturan ini berlaku untuk mapping mana pun dalam fragmen, termasuk Properties milik resource. Cara paling umum untuk mencapainya adalah Recipe yang menurunkan ID logis dari nilai yang ditulis, ketika dua nilai yang ditulis hanya berbeda dalam tanda baca — app-cache dan app_cache sama-sama menurunkan AppCache, sehingga fragmen menulis AppCache dua kali.

Nama kunci yang muncul kembali di tempat berbeda dalam dokumen adalah hal biasa dan tidak diubah: Type muncul sekali per resource, dan Value sekali per output, berapa pun banyaknya resource dan output yang dibawa fragmen. Hanya pengulangan di dalam satu mapping yang menghilangkan sebuah badan.

Satu component dapat mengklaim satu nama dua kali. Sebuah Recipe menyumbangkan beberapa fragmen — beberapa entri artifacts:, atau direktori sumber yang memuat beberapa template — dan semuanya dirakit ke dalam stack yang sama, sehingga fragmen-fragmen milik satu component berbagi nama stack satu sama lain persis seperti berbagi nama antar-component. Dua fragmen yang memberi satu nama dua badan berbeda menghentikan build, dan penghentian itu menyebutkan ruang kunci tempat nama itu berada — ID logis resource atau nama output — beserta component dan nama itu sendiri. Kedua ruang dapat dicapai dengan cara ini: dua fragmen dapat menulis satu ID logis resource untuk resource yang berbeda, dan sebuah component mencapai nama output-nya melalui dua jalur, blok Outputs: eksplisit dan entri provides:-nya, sehingga entri dari masing-masing yang membawa satu nama juga bertemu di sana.

Menyatakan ulang sebuah nama bukanlah konflik dengan sendirinya. Nama yang ditulis lebih dari sekali dengan konten identik tetap mengalamatkan satu hal, sehingga pernyataan ulang itu digabungkan menjadi satu entri dan build berlanjut — pengulangan biasa tidak menimbulkan biaya. Yang menghentikan build adalah kasus yang menghilangkan konten: salah satu dari dua badan harus dibuang, dan resource atau output yang dideklarasikan Recipe kemudian akan hilang dari stack. Mengganti nama salah satunya akan menyelesaikannya.

Validasi struktural input

Template CloudFormation yang bersumber divalidasi secara struktural sebelum dirender: provider mengurai template dan menormalkan intrinsiknya, lalu menghentikan build dengan pesan jelas yang menyebut node yang bermasalah ketika sebuah template tidak valid. Penguraian memeriksa bentuk, bukan semantik — penguraian tidak menghubungi AWS, tidak me-resolve referensi, dan tidak mengevaluasi intrinsik.

Template yang berhasil diurai tidak dengan sendirinya dibawa utuh. Penguraian menyatakan bahwa dokumen tersebut terbentuk dengan benar; apa yang mencapai stack hasil perakitan ditentukan secara terpisah dan per bagian, sesuai Bagian tingkat atas dalam stack hasil perakitan — template yang bersumber melalui perhitungan yang sama dengan sebuah fragmen.

Penguraian juga tidak memeriksa apakah referensi dalam template dapat di-resolve. Apakah sebuah Ref menyebut sebuah parameter, atau sebuah Fn::FindInMap menyebut sebuah map, adalah pertanyaan tentang stack hasil perakitan, bukan tentang satu dokumen input tertentu, dan CloudFormation yang menjawabnya pada saat deploy. Build menyatakan apa yang tidak dibawanya alih-alih menilai apa yang dirujuk oleh hasilnya. Referensi yang dinilainya adalah referensi yang dibuat menggantung oleh build itu sendiri: referensi ke parameter yang diisi oleh binding template bersumber, yang dibahas di bagian berikutnya, dan referensi ke resource yang dikeluarkan dari template oleh entri omits:, yang dibahas di bagian setelahnya.

Nilai untuk parameter templat bersumber

Templat bersumber menerima nilai dengan cara yang sama seperti CloudFormation sendiri memberi nilai kepada templat: melalui Parameters yang dideklarasikannya. valuesMapping dari apa pun yang menjadi sumbernya — Recipe sebuah komponen, atau FeatureRecipe dari Feature yang dilampirkan — menulis satu kunci per parameter yang diisinya, dan provider mengikat masing-masing di setiap templat sumber tersebut — setiap Ref ke parameter itu di Resources, Outputs, Conditions, Rules, dan Globals milik SAM menjadi nilai tersebut, setiap Fn::Sub yang menyebut parameter itu sebagai variabel menerima nilai melalui peta variabelnya, dan parameter itu dikeluarkan dari Parameters setiap templat yang mendeklarasikannya. Parameter yang tidak disebut oleh kunci mana pun dibiarkan persis seperti yang ditulis templat, untuk nilai yang diberikan saat stack di-deploy atau untuk Default-nya.

Sumber adalah unit yang mendeklarasikan parameter. Templat-templat dari sumber direktori dirakit menjadi satu stack, sehingga satu templat dapat mereferensikan parameter yang dideklarasikan oleh templat lain dari sumber yang sama. Mengisi parameter juga mengisinya di sana: templat yang hanya mereferensikannya menerima nilai sebagaimana dikonversi oleh templat pertama dari sumber yang mendeklarasikannya, dan tidak ada bagian sumber yang dibiarkan mereferensikan parameter yang deklarasinya telah dihapus oleh pengikatan.

Tidak ada hal lain dalam stack yang dapat mereferensikan parameter yang telah diisi. Konten di luar sumber — fragmen atau templat bersumber milik komponen lain dalam stack yang sama — yang menyebut parameter yang diisi oleh pengikatan sumber, melalui Ref, variabel Fn::Sub, atau Fn::ValueOf milik sebuah aturan, akan menyebut sesuatu yang tidak lagi dideklarasikan oleh stack yang dirakit, dan CloudFormation menolaknya saat stack di-deploy. Karena itu build berhenti, dengan menyebut setiap komponen, templatnya, dan parameternya, serta komponen yang valuesMapping-nya mengisi parameter itu — milik Recipe, atau milik FeatureRecipe dari Feature yang dilampirkan; Feature yang dilampirkan pada komponen disebut dengan nama komponen tersebut, dan yang dilampirkan pada boundary disebut dengan identitas yang dibawa sumber dayanya sebagai aggrega.ai/component-id, yang disusun dari path boundary dan nama lampiran (bfr--stack--aux untuk lampiran aux pada boundary stack). Fragmen komponen tempat Feature dilampirkan, atau fragmen komponen dalam boundary tempat Feature dilampirkan, yang mereferensikan parameter yang diisi oleh pengikatan lampiran tersebut juga menghentikan build. Nama yang masih dideklarasikan stack tidak terpengaruh: jika komponen lain sendiri mendeklarasikan parameter dengan nama itu, atau sebuah sumber daya membawanya sebagai logical ID, referensinya diselesaikan ke deklarasi tersebut dan dibiarkan seperti yang ditulis. Untuk meneruskan nilai, minta komponen pengisi memublikasikannya, deklarasikan parameter di templat yang mereferensikannya, atau hapus kunci dari valuesMapping.

spec:
capability: cloudformation
implements: core/delivery-stream:1.0.0
source:
kind: git-repository
url: https://github.com/aws-cloudformation/aws-cloudformation-templates.git
ref: a0f43bc6d20813052892546f445037cf84c75b54
module_subdir: DataFirehose
valuesMapping: |
CloudWatchLogGroupRetention: {{ .values.retention_days }}
DestinationBucketName: "{{ .context.inject.env.BUCKET_NAME }}"

Hanya valuesMapping yang mengisi parameter. Kunci yang ditulisnya adalah nama parameter yang Anda maksudkan untuk templat, sehingga masing-masing harus menyebut parameter yang dideklarasikan oleh salah satu templat sumber: kunci yang tidak menyebut parameter apa pun menghentikan build, dengan menyebut kunci tersebut dan parameter yang memang dideklarasikan oleh setiap templat — kegagalan yang akan dilaporkan CloudFormation untuk parameter yang tidak dikenal, dilaporkan selagi Anda masih dapat memperbaikinya. Recipe atau FeatureRecipe yang tidak mendeklarasikan valuesMapping tidak mengisi apa pun: nilai milik komponen atau lampiran itu sendiri mencapai provider dengan namanya sendiri, ditulis untuk input lainnya, dan tidak dibaca.

Jenis nilai menentukan apa yang mencapai templat.

  • Literal — string, angka, boolean, atau daftar darinya — ditulis ke dalam templat, dikonversi dengan cara yang sama seperti CloudFormation mengonversi nilai yang sama yang diberikan untuk Type parameter saat stack di-deploy: Number menjadi string yang dihasilkan oleh Ref kepadanya, sehingga 7 tiba sebagai "7"; tipe CommaDelimitedList atau List<…> menjadi daftar string, dengan menerima daftar atau string yang dipisahkan koma yang anggotanya dipangkas; setiap tipe lain menerima satu string. Literal diperiksa terhadap AllowedValues, AllowedPattern, MinLength, MaxLength, MinValue, dan MaxValue milik parameter itu sendiri, dan literal yang ditolak oleh batasan tersebut menghentikan build, dengan menyebut parameter dan batasannya, sehingga mengisi parameter tidak menghapus pemeriksaan apa pun yang dideklarasikan templat. Pola yang ditulis dalam sintaks ekspresi reguler yang tidak dapat dibaca build dibiarkan untuk diperiksa CloudFormation saat stack di-deploy.
  • Nilai yang seluruhnya berupa satu intrinsik CloudFormation mencapai lokasi referensi sebagai intrinsik tersebut, untuk dievaluasi CloudFormation saat stack di-deploy: mapping bentuk panjang seperti {"Fn::GetAtt": [Queue, Arn]}, atau string yang persis merupakan satu bentuk pendek — !GetAtt Queue.Arn, !Ref Bucket, !Sub …, dan bentuk lain yang didefinisikan CloudFormation. Dengan cara itulah referensi yang dipublikasikan komponen lain mencapai parameter: Recipes CloudFormation dalam katalog memublikasikan referensi semacam itu sebagai teks bentuk pendek, dan valuesMapping yang membacanya dari konteks injeksi meneruskannya. Referensi yang disisipkan dibaca sama, baik dengan tanda kutip maupun tanpa. Dengan tanda kutip — "{{ .context.inject.env.BUCKET_NAME }}" — mapping meneruskan string !GetAtt Queue.Arn; tanpa tanda kutip, YAML milik mapping itu sendiri membaca !GetAtt Queue.Arn sebagai tag, dan tag tersebut dipertahankan bersama argumennya, bukan dibuang. Keduanya mencapai parameter sebagai intrinsik. Nilai yang hanya diawali tanda seru, atau yang tidak menyebut bentuk pendek CloudFormation apa pun, tetap berupa teks.
  • Referensi dinamis — {{resolve:ssm:…}}, {{resolve:ssm-secure:…}}, atau {{resolve:secretsmanager:…}} — mencapai lokasi referensi seperti yang ditulis, untuk diselesaikan CloudFormation saat stack di-deploy, sehingga nilai yang disebutnya tidak pernah berada di dalam templat.
  • Nilai yang dipublikasikan komponen lain dari stack yang berbeda mencapai templat sebagai referensi lintas stack, yaitu Fn::ImportValue atau Fn::GetStackOutput yang sama dengan yang diterima fragmen (lihat Pengkabelan lintas stack), di setiap tempat templat mereferensikan parameter tersebut.

Parameter yang tipenya dibaca CloudFormation dari Parameter Store — AWS::SSM::Parameter::Value<…> — tidak memiliki literal yang dapat mereproduksi apa yang akan dilakukan CloudFormation terhadapnya, sehingga literal yang diikat padanya menghentikan build; ikat referensi {{resolve:ssm:…}} atau intrinsik, atau biarkan tidak terikat. Daftar yang diikat pada parameter yang disebut templat sebagai variabel Fn::Sub juga menghentikan build, karena variabel menyubstitusi satu string. Kunci yang ditetapkan valuesMapping ke null juga menghentikan build, dengan menyebut parameternya, karena parameter menerima nilai dan null bukan nilai; untuk membiarkan parameter bagi nilai yang diberikan saat stack di-deploy atau bagi Default-nya, hilangkan kuncinya dari mapping.

Aturan yang membaca parameter berdasarkan nama membuat parameter itu tetap tidak terikat. Fn::ValueOf dalam Rules sebuah templat menyebut parameter yang dideklarasikan berdasarkan logical ID-nya alih-alih melalui Ref, dan mengisi parameter menghapus deklarasinya, sehingga mengikat parameter yang dibaca aturan dengan cara itu menghentikan build, dengan menyebut aturan dan parameternya.

Literal yang mungkin membawa rahasia ditolak; intrinsik ditulis apa adanya. Nilai yang ditulis ke dalam templat dapat dibaca oleh siapa pun yang dapat membaca templat stack:

  • Parameter yang dideklarasikan templat sebagai NoEcho menerima referensi dinamis atau intrinsik, dan literal yang diikat padanya menghentikan build.
  • Jika valuesMapping membaca nilai yang dideklarasikan sensitif oleh penulis, tidak satu pun outputnya dapat dilacak kembali ke nilai asalnya, sehingga setiap literal yang diikatnya menghentikan build. Referensi dinamis dan intrinsik yang diikatnya ditulis apa adanya — termasuk teks di dalam intrinsik. Karena itu, rahasia yang disisipkan mapping ke dalam teks Fn::Sub, misalnya, mencapai templat sebagai teks tersebut: hanya referensi dinamis yang menjaga rahasia itu sendiri tetap di luar templat. Jika build semacam itu berlanjut, build juga mencetak satu peringatan per leaf yang dideklarasikan, baik untuk mapping milik Recipe maupun untuk mapping milik FeatureRecipe dari Feature yang dilampirkan pada komponen, dengan menyebut leaf tersebut dan entitas pemilik mapping — lihat A declared-sensitive value reaches the target through a values mapping (Nilai yang dideklarasikan sensitif mencapai target melalui values mapping).
  • Referensi dinamis menghentikan build jika parameternya dirujuk dalam properti UserData sebuah resource, dalam metadata AWS::CloudFormation::Init, atau dalam Outputs: CloudFormation tidak meresolusi referensi dinamis dalam user data EC2 atau dalam metadata tersebut, dan menampilkan Outputs kepada siapa pun yang membaca stack.

Setiap penolakan semacam itu menyebutkan parameternya, dan tidak mengutip nilai apa pun.

Mengecualikan resource dari templat bersumber

Resource milik templat bersumber adalah miliknya sendiri: nilai hanya mencapainya melalui parameter yang dideklarasikannya, sehingga templat yang diambil dari repositori git yang mendeklarasikan resource yang tidak boleh dibuat oleh Release — bucket yang sudah disediakan operator, kunci yang dikelola platform di tempat lain — tidak dapat diubah oleh sebuah nilai. Untuk itulah entri omits: pada Recipe atau FeatureRecipe digunakan. Provider ini mematuhinya pada templat bersumber dan tidak pada hal lain: fragmen yang ditulis oleh entri artifacts: dirender tanpanya.

spec:
capability: cloudformation
implements: core/store:1.0.0
source:
kind: git-repository
url: https://git.example.com/platform/templates.git
ref: v3.2.0
module_subdir: store
omits:
# The template bundles an access-log bucket; this Release logs elsewhere.
- kind: AWS::S3::Bucket
name: StoreLogs

Sebuah entri menamai satu resource berdasarkan Type dan ID logisnya. kind entri adalah Type resource, seperti AWS::S3::Bucket, dan name-nya adalah ID logis resource, yaitu kuncinya di bawah Resources; keduanya dibandingkan persis seperti yang ditulis, dan keduanya harus cocok, sehingga entri yang Type-nya benar tetapi ID logisnya tidak, tidak mengecualikan apa pun. Templat tidak memiliki namespace, sehingga entri yang membawa namespace menghentikan build saat komponen dirender, dengan menyebut entri tersebut; setiap entri diperiksa sebelum apa pun dikecualikan.

Setiap templat dari sumber dicocokkan. Sumber berkas tunggal memiliki satu templat. Sumber direktori — sumber yang diambil dari repositori git selalu berupa direktori — memiliki setiap berkas yang berakhiran .yaml, .yml, .json, atau .template, dan sebuah entri mengecualikan setiap resource yang dinamainya di salah satu berkas tersebut; berkas yang dibawa bersama templat tidak pernah dibaca. Provider melaporkan berapa banyak resource yang dikecualikan setiap entri di seluruh berkas tersebut, dan entri yang tidak mengecualikan apa pun menghentikan build; lihat An omits entry left out nothing the source rendered (Entri omits tidak mengecualikan apa pun yang dirender sumber).

Resource yang dikecualikan sudah hilang sebelum hal lain membaca templat. Resource tersebut tidak dicap dengan provenans, tidak dihitung di antara nama yang dibawa stack — sehingga komponen lain dapat menyumbangkan resource dengan ID logis yang sama tanpa keduanya bertabrakan — dan tidak pernah mencapai stack yang dirakit. Semua hal lain dalam templat ditulis persis seperti jika templat itu ditulis tanpa resource tersebut, dan templat yang seluruh resource-nya dikecualikan tetap memiliki bagian Resources yang kosong.

Resource yang dikecualikan tidak boleh tetap dinamai oleh yang tersisa, karena CloudFormation menolak templat yang menamai resource yang tidak dideklarasikannya. Setelah resource dihapus, setiap referensi yang masih dibuat templat yang tersisa ke salah satunya menghentikan build, dan pesannya menyebut templat, resource, cara referensi menamainya, dan letak referensi sebagai path dari akar templat — misalnya /Resources/Store/Properties/LoggingConfiguration/DestinationBucketName. Referensi adalah apa yang didefinisikan oleh referensi templat CloudFormation sebagai penamaan resource berdasarkan ID logisnya, yang dibaca di badan setiap resource — termasuk properti, metadata, dan kebijakannya — dan di setiap output:

  • Ref, dengan ID logis sebagai argumennya;
  • Fn::GetAtt, sebagai daftar yang item pertamanya adalah ID logis, atau sebagai satu string — !GetAtt StoreLogs.Arn — yang teks sebelum titik pertamanya adalah ID logis;
  • DependsOn milik resource, sebagai satu ID logis atau daftar ID logis;
  • setiap variabel Fn::Sub, dalam bentuk string dan bentuk daftarnya: ${StoreLogs} dan ${StoreLogs.Arn} keduanya menamai StoreLogs.

Beberapa nilai hanya tampak seperti referensi dan tidak dibaca sebagai referensi. ${!StoreLogs} adalah teks literal, dan variabel yang dinamai oleh map pada bentuk daftar adalah nilai map tersebut. Condition milik resource dan argumen pertama Fn::If menamai kondisi, Fn::FindInMap menamai mapping, Fn::ImportValue menamai ekspor stack lain, dan Fn::GetAZs menamai region. Bagian Conditions, Mappings, Parameters, dan Rules tidak dapat menamai resource, dan bagian Metadata tingkat atas milik templat itu sendiri adalah informasi yang disimpan CloudFormation alih-alih dibaca, sehingga tidak satu pun diperiksa. Ref atau Fn::GetAtt yang ID logisnya sendiri ditulis sebagai fungsi intrinsik hanya valid di bawah transform AWS::LanguageExtensions, yang menyelesaikannya saat stack di-deploy (lihat Bagian tingkat atas dalam stack yang dirakit), sehingga tidak menamai resource yang dapat dibaca pemeriksaan dan dibiarkan apa adanya; begitu pula referensi ke resource yang tidak pernah dideklarasikan sumber.

Pemeriksaan membaca templat milik Recipe atau FeatureRecipe yang mendeklarasikan, secara bersama-sama. Templat-templat tersebut dirakit menjadi satu stack, sehingga referensi ke ID logis yang masih dideklarasikan oleh templat lain di antaranya tidak dihentikan. Tidak ada hal lain yang dibaca: referensi ke resource yang dikecualikan menghentikan build meskipun komponen lain mendeklarasikan resource dengan ID logis tersebut, dan referensi yang dibuat oleh hal lain yang dirakit ke dalam stack — komponen lain, Feature yang dilampirkan, atau entri artifacts: milik Recipe itu sendiri — tidak terlihat oleh pemeriksaan ini, sehingga CloudFormation menolak stack saat di-deploy. Untuk mempertahankan referensi, pertahankan resource-nya. Nilai yang diikat ke parameter hanya menggantikan referensi ke parameter tersebut, sehingga referensi ke resource adalah milik templat sendiri dan tidak dapat diubah oleh nilai: kecualikan juga resource yang membuatnya, atau hapus entri tersebut. Output bukan resource dan tidak ada entri yang menamainya, sehingga resource yang dinamai oleh Outputs templat tidak dapat dikecualikan darinya: mengecualikannya menghentikan build.

Anotasi target cloud

Tiga anotasi boundary memberi tahu provider tempat sebuah stack di-deploy, sehingga provider dapat menyambungkan referensi lintas-stack dengan benar:

  • aggrega.ai/aws-account — akun AWS tempat stack di-deploy.
  • aggrega.ai/aws-region — region AWS tempat stack di-deploy.
  • aggrega.ai/aws-assume-role-arn — ARN role IAM yang diasumsikan oleh pembacaan stack lintas-akun untuk menjangkau nilai yang diekspor oleh stack mitra.

Anotasi ini buram bagi compiler — compiler meneruskan nilainya ke provider tanpa menafsirkannya (lihat well-known-annotations.md). Anotasi ini ditulis pada boundary produsen — stack yang memiliki nilai yang diekspor. Pembacaan lintas-akun mengasumsikan role ke dalam akun produsen, sehingga akun, region, dan role yang menjelaskan pembacaan tersebut semuanya berasal dari anotasi boundary produsen, bukan dari konsumen.

Referensi intra-stack

Ketika sebuah edge uses menghubungkan dua komponen yang berada dalam boundary yang sama — stack yang sama — nilai yang dikonsumsi dihubungkan sebagai Fn::GetAtt terhadap logical ID resource produsen di dalam satu template tersebut. Nilai provides milik produsen mengalir ke input konsumen yang dirender sebagai referensi intra-stack native; tidak diperlukan export maupun import. Fragmen konsumen dapat menulis nilai seperti itu secara polos — Value: {{ .context.inject.env.DB_HOST }} — atau di dalam tanda kutip — Value: "{{ .context.inject.env.DB_HOST }}": dengan cara mana pun, template membaca !GetAtt Db.Endpoint.Address sebagai intrinsic, karena string yang persis berupa satu bentuk pendek sampai ke stack sebagai intrinsic tersebut di dalam fragmen sebagaimana di dalam valuesMapping. Contoh aws-rds-and-ecs-service menunjukkannya pada task definition Amazon ECS yang membaca alamat instance RDS dalam satu stack.

Pengkabelan lintas stack

Ketika sebuah edge uses melintas dari satu boundary ke boundary lain — kedua komponen dirakit ke dalam stack yang berbeda — referensi tidak dapat berupa nilai biasa, karena nilai yang dihasilkan belum ada sampai stack produsen di-deploy. Provider menghubungkannya sebagai referensi lintas stack CloudFormation. Stack produsen menerbitkan nilai tersebut sebagai Output stack dengan Export di bawah nama ekspor yang deterministik (diturunkan dari release, boundary, komponen, dan kunci yang disediakan). Stack konsumen membacanya dengan salah satu dari dua intrinsic, yang dipilih dengan membandingkan penempatan yang dideklarasikan oleh kedua boundary:

  • Fn::ImportValue — kasus akun yang sama dan region yang sama. CloudFormation me-resolve impor terhadap nama ekspor yang cocok di dalam akun dan region tersebut.
  • Fn::GetStackOutput — pembacaan yang benar-benar lintas akun atau lintas region. Konsumen membaca output stack produsen secara langsung, dengan mengambil peran aws-assume-role-arn milik boundary produsen ke akun dan region produsen.

Semantik deteksi. Provider mengarahkan ke Fn::GetStackOutput hanya ketika kedua endpoint mendeklarasikan penempatan (akun/region) dan penempatan tersebut berbeda. Dalam semua kasus lain — tidak ada yang mendeklarasikan, hanya satu yang mendeklarasikan, atau keduanya mendeklarasikan penempatan yang sama — provider menggunakan Fn::ImportValue. Ini adalah aturan konservatif: pembacaan lintas stack dalam akun yang sama tetap berupa impor biasa, dan intrinsic pembacaan langsung dicadangkan untuk lompatan lintas akun atau lintas region yang sesungguhnya.

Stack produsen selalu menerbitkan Export, bahkan ketika konsumen tertentu membacanya lintas akun melalui Fn::GetStackOutput. Ekspor yang tidak digunakan bersifat inert, dan menerbitkannya tanpa syarat menjaga template produsen tetap independen dari cara setiap konsumen memilih untuk membaca nilai tersebut.

Beberapa konsumen dari satu nilai membaca satu ekspor. Ketika lebih dari satu komponen membaca nilai yang disediakan yang sama melintasi boundary — dua konsumen dalam satu stack, atau konsumen di beberapa stack — stack produsen menerbitkan Export nilai tersebut satu kali, dan setiap konsumen membaca satu nama itu: setiap Fn::ImportValue mengimpor ekspor yang sama, dan konsumen yang ditempatkan di akun atau region lain membaca output yang sama melalui Fn::GetStackOutput. Konsumen yang juga membaca nilai yang tidak dibaca konsumen lain hanya menambahkan ekspor nilai tersebut.

Contoh aws-rds-and-ecs-service membangun kasus akun yang sama: stack instans RDS mengekspor setiap entri yang dikonsumsi oleh edge server, dan stack server membaca kembali masing-masing dengan Fn::ImportValue.

Catatan versi. Fn::GetStackOutput adalah intrinsic bawaan CloudFormation. Referensi lintas akun yang dirender dengannya memerlukan perangkat CloudFormation yang mengenali intrinsic tersebut. Jalur akun yang sama menggunakan Fn::ImportValue, yang tersedia secara universal.

Nilai yang dibaca dari koneksi alih-alih diinjeksikan

Recipe milik konsumen dapat membaca nilai produsen langsung dari koneksi, melalui .context.uses.<alias>.provides, alih-alih menerimanya melalui blok inject milik koneksi. Melintasi batas stack, pembacaan seperti itu dihubungkan dengan cara yang sama seperti nilai yang diinjeksikan:

  • Nilai yang merupakan intrinsic CloudFormation — tag bentuk pendek seperti !GetAtt Db.Endpoint.Address, atau pemetaan Ref atau Fn:: bentuk panjang — menamai sesuatu yang hanya dideklarasikan oleh stack produsen, sehingga konsumen menerima referensi lintas stack yang sama seperti nilai yang diinjeksikan: stack produsen menerbitkan Export untuk kunci tersebut, dan konsumen membacanya dengan Fn::ImportValue, atau dengan Fn::GetStackOutput jika kedua boundary mendeklarasikan penempatan yang berbeda.
  • Nilai yang berupa teks biasa — port, protokol, nama database — bermakna sama di stack mana pun, sehingga konsumen menerima nilai itu sendiri dan tidak ada export yang diterbitkan untuknya. Nilai tersebut mendarat dalam bentuk yang dibaca oleh CloudFormation: nilai yang ditulis utuh dirender seperti tanpa batas, dan nilai berbentuk angka yang ditulis di dalam tanda kutip mendarat sebagai angka.

Apakah sebuah nilai merupakan intrinsic ditentukan oleh provider ini, dengan membaca nilai tersebut seperti cara ia membaca blok provides milik produsen sendiri. Compiler menyerahkan nilai tersebut sebagaimana ditulis oleh Recipe milik produsen dan tidak menafsirkannya.

Template hanya dapat menyalin nilai seperti itu. Template dapat menulis nilai tersebut secara utuh, atau di dalam string yang lebih panjang, atau meneruskannya melalui fungsi yang membiarkannya apa adanya, seperti quote. Perbandingan, percabangan, panjang, atau fungsi yang mengubah nilai — eq, if, len, upper — akan diputuskan terhadap sesuatu selain nilai itu, karena pada koneksi seperti itu template diberi pengganti sementara yang akan diganti oleh provider setelah kedua stack dirakit. Sebagai gantinya build berhenti, dengan menyebutkan template dan setiap nilai yang dibacanya, beserta koneksi tempat nilai itu dibaca dan komponen di setiap ujungnya; lakukan percabangan berdasarkan nilai milik komponen konsumen sendiri. Hal yang sama berlaku untuk injectMapping milik FeatureRecipe yang terpasang dan untuk FeatureRecipe berlingkup boundary yang membaca koneksi boundary. Nilai yang ditulis di dalam string yang lebih panjang juga menghadapi batasan provider sendiri: referensi lintas stack hanya dapat berdiri sebagai nilai utuh, sehingga intrinsic yang ditulis di dalam string yang lebih panjang menghentikan build, sama seperti untuk nilai yang diinjeksikan.

Cara nama ekspor dibentuk

Keempat bagian digabungkan dengan tanda hubung ganda, dan setiap bagian ditulis ke dalam huruf, angka, dan tanda hubung yang menyusun nama ekspor. Huruf atau angka diteruskan sebagaimana ditulis, begitu pula tanda hubung di dalam suatu bagian — payments-db tetap payments-db. Karakter lain apa pun ditulis sebagai escape pendek yang diawali -z: garis miring sebagai -zs, garis bawah sebagai -zu, titik sebagai -zd. Bagian yang sama sekali tidak memiliki nilai ditulis -ze. Nama stack dibentuk dengan cara yang sama dari release dan boundary.

Jadi, ekspor yang menerbitkan host dari komponen db, dalam boundary yang direktori output-nya di bawah dist/ adalah stack-a/cloudformation, dari release orders, adalah:

aggrega--orders--stack-a-zscloudformation--db--host

Membacanya kembali tidak ambigu, dan justru itulah tujuannya, bukan sekadar nilai tambah: karena suatu bagian tidak pernah memuat dua tanda hubung berturut-turut dan tidak pernah diakhiri dengan tanda hubung, tanda hubung ganda selalu merupakan penggabung. Oleh karena itu, dua kumpulan bagian yang berbeda selalu menghasilkan dua nama yang berbeda. payments-db dan payments_db mencapai dua ekspor terpisah alih-alih menyatu menjadi satu, dan tanda hubung di tepi suatu bagian tidak dapat dibaca sebagai milik bagian di sebelahnya.

Terhadap apa nama ekspor bersifat unik, dan di mana hal itu berhenti

Dalam satu build, nama ekspor mengidentifikasi tepat satu release, boundary, komponen, dan kunci yang disediakan — tidak ada dua di antaranya yang menyatu menjadi satu nama, sehingga build tidak dapat kehilangan satu nilai yang diekspor di balik nilai lain.

CloudFormation juga mensyaratkan nama ekspor unik di antara semua yang sudah di-deploy ke akun dan region tempat stack berada. Itu adalah properti deployment, bukan properti build, dan hal itu berada di luar jangkauan derivasi apa pun pada waktu build: compiler tidak melakukan autentikasi terhadap AWS, tidak melakukan kueri ke sana, dan tidak dapat membaca output build lain, sehingga tidak ada yang dihitung di muka yang dapat mengamati apa yang sudah di-deploy di sana.

Yang membawa pembedaan melintasi batas itu adalah identitas release yang mengawali setiap nama ekspor dan nama stack. Dua deployment yang berbagi akun dan region menjaga ekspornya tetap terpisah dengan dirilis di bawah nama yang berbeda — itulah tuas yang Anda pegang, dan itulah alasan identitas release mengawali nama alih-alih mengikutinya di belakang.

Entri Outputs dapat mendeklarasikan nama ekspornya sendiri

Blok Outputs: milik sebuah Recipe adalah CloudFormation yang ditulis oleh penulis, dan sebuah entri di dalamnya boleh membawa Export: sendiri dengan Name:. Nama tersebut mencapai stack yang dirakit persis seperti yang ditulis — provider tidak menulis ulang nama itu, tidak memberinya awalan, dan tidak mengharuskannya menyerupai nama turunan.

Biasanya tidak ada lagi yang perlu dikatakan tentang hal itu. Nama ekspor yang ditulis penulis dan tidak cocok dengan nama mana pun yang diturunkan provider akan dipublikasikan bersama nama-nama turunan dan tidak pernah dikomentari. Penulisannya didukung; hanya satu kebetulan yang tidak.

Build berhenti ketika nama ekspor yang ditulis penulis sama dengan nama yang diturunkan provider untuk tautan lintas batas dalam build yang sama. Kedua deklarasi akan mencapai templat yang dirakit, sehingga satu nama ekspor dideklarasikan dua kali dalam satu stack — dan nama ekspor harus unik, sehingga keduanya tidak dapat sama-sama berlaku. Penghentian ini menampilkan nama ekspor turunan beserta empat bagian pembentuknya, sehingga Anda dapat melihat tautan mana yang menghasilkannya, dan menyebutkan output stack tempat deklarasi yang ditulis penulis berada, yang ditandai sebagai nama yang dirakit provider, bukan nama yang ditulis sebuah Recipe. Nama ekspor itulah istilah yang perlu Anda cari di Recipes Anda. Entri yang ditulis penulis mengejanya persis seperti yang ditampilkan penghentian — kesamaan itulah yang menjadikan keduanya tabrakan — sehingga itulah satu-satunya string yang muncul baik di pesan maupun di berkas Anda sendiri. Mengganti nama ekspor yang dideklarasikan entri tersebut akan menghilangkan penghentian, begitu pula menghapus blok Export: entri tersebut dan membiarkan penyambungan lintas stack memublikasikan ekspor itu sendiri.

Pemeriksaan ini berlingkup build, dan lingkupnya adalah satu stack. Pemeriksaan ini membandingkan nama-nama ekspor yang dideklarasikan sebuah stack yang dirakit dengan nama-nama yang diturunkan provider untuk tautan lintas batas yang memublikasikan ke stack yang sama itu — perbandingan yang dapat dilakukan build dari apa yang telah dirakitnya. Dua stack tidak dibandingkan satu sama lain. Adapun apa yang ditemui sebuah nama yang ditulis penulis di antara ekspor yang sudah di-deploy ke suatu akun dan region merupakan properti deployment, yang berada di luar jangkauan derivasi apa pun pada waktu build, dengan alasan yang dijelaskan di bawah Terhadap apa nama ekspor bersifat unik, dan di mana hal itu berhenti: kompiler tidak melakukan autentikasi ke AWS, tidak mengkueri AWS, dan tidak dapat membaca output dari build lain. Nama ekspor yang ditulis sebagai intrinsic, bukan sebagai string biasa, berada di sisi seberang batas yang sama — nama itu di-resolve pada waktu deploy, dan tidak ada bagian di sini yang mengevaluasi intrinsic, sehingga tidak ada nama yang dapat dibandingkan oleh build.

Build juga berhenti ketika output tempat sebuah tautan lintas batas memublikasikan sudah membawa Export yang tidak ditulis oleh tautan tersebut. Output itu adalah output yang dirakit provider untuk kunci yang disediakan yang dibaca oleh konsumen, sehingga Recipe yang blok Outputs:-nya menulis entri di bawah kunci yang sama, dengan Export: miliknya sendiri, menempatkan ekspornya tepat di tempat ekspor tautan seharusnya berada. Kecuali nama ekspor tersebut persis sama dengan nama yang diturunkan provider — dalam hal ini ekspor itu adalah ekspor milik tautan sendiri dan setiap konsumen mengimpornya — keduanya tidak dapat sama-sama berada di sana: menulis ekspor tautan akan menimpa ekspor Anda, dan mempertahankan ekspor Anda akan membuat setiap konsumen mengimpor nama yang tidak dipublikasikan oleh tautan. Penghentian ini menampilkan nama ekspor turunan beserta empat bagian pembentuknya, dan menyebutkan apa yang ditemukannya pada output tersebut: nama ekspor yang dideklarasikan entri, nama yang ditulis sebagai intrinsic, blok Export: yang tidak menamai apa pun, atau Export: yang ditulis sebagai nilai biasa alih-alih sebagai blok. Menghapus blok Export: entri tersebut akan menghilangkan penghentian, dan penyambungan lintas stack kemudian memublikasikan ekspor yang diimpor oleh setiap konsumen.

Urutan deployment

Nilai syncWave: pada batas Release mengurutkan provisioning stack tempat batas tersebut dirakit. Setiap komponen dalam batas mewarisi wave batas tersebut, dan apabila beberapa batas mengarah ke direktori keluaran yang sama — sehingga fragmennya dirakit menjadi satu templat — stack tersebut memuat lebih dari satu wave dan provider menyatakan urutan di antara wave-wave itu sebagai DependsOn.

Setiap resource menyebut setiap resource dari wave tepat sebelumnya yang memiliki resource, dan tidak menyebut wave yang lebih awal dari itu. CloudFormation merangkai sisanya: resource pada wave 2 bergantung pada wave 1, yang bergantung pada wave 0, sehingga seluruh urutan terjaga sementara daftar milik setiap resource tetap seukuran satu wave, bukan seukuran seluruh stack. Wave tidak harus berurutan tanpa celah, dan nilai negatif adalah hal biasa — -1 merupakan pilihan umum untuk bucket atau role yang dibaca oleh bagian lain stack. Wave terendah tidak menyebut apa pun, karena tidak ada yang mendahuluinya.

Arti urutan ini: urutan pembuatan, dan sebaliknya, urutan penghapusan. CloudFormation memproses resource secara paralel sejauh mungkin, dan DependsOn mengesampingkan paralelisme tersebut untuk memproses resource yang disebut dalam urutan yang dinyatakan. Atribut ini mengatur kedua arah, sehingga wave yang membuat suatu resource lebih awal juga menghapusnya lebih akhir — urutan pembongkaran yang benar ikut tersedia bersama urutan ini tanpa memerlukan hal lain.

Ini bukan urutan kesiapan. Templat stack tidak mengenal konsep resource yang siap melayani, sehingga tidak ada yang menunggu suatu resource menjadi siap — hanya menunggu CloudFormation selesai membuatnya. Ini merupakan perbedaan nyata dengan wave yang sama pada compose, tempat sebuah service yang mendeklarasikan healthcheck ditunggu hingga melaporkan status sehat: compose memiliki primitif kesiapan untuk dijadikan gerbang, sedangkan templat stack tidak memilikinya. Urutan pembuatan adalah yang ditawarkan target ini, dan menyatakannya secara lugas lebih berguna daripada catatan yang dilekatkan pada janji yang tidak dapat dipenuhi.

DependsOn yang ditulis sendiri diperluas, tidak pernah diganti. Fragmen yang mendeklarasikan batasan urutannya sendiri tetap mempertahankannya: entri yang ditulisnya tetap berada di depan, dalam urutan penulisannya, dan entri wave menyusul. Kedua persyaratan berlaku dan tidak ada yang menutupi yang lain. Logical ID tunggal maupun daftar sama-sama dibaca, dan nilai gabungannya dihasilkan sebagai daftar, yaitu satu-satunya penulisan yang berlaku berapa pun jumlah entri yang dihasilkan penggabungan.

Stack yang semua resource-nya membawa satu wave tidak mendapatkan apa pun dari hal ini. Demikian pula Release yang sama sekali tidak mendeklarasikan syncWave: setiap kontributor membawa nilai bawaan field tersebut, yaitu 0, templat yang dirakit memuat satu wave, dan keluarannya persis sama seperti jika provider tidak menyatakan urutan wave sama sekali.

Urutan antara dua stack tidak dapat dinyatakan, dan tidak didekati. DependsOn menyebut resource di dalam templat yang sama, dan komponen yang dirakit ke stack lain berada di luarnya. Jadi, sebuah wave mengurutkan setiap resource dalam stack tempat wave itu dirakit dan tidak lebih dari itu. Mengurutkan dua stack adalah urusan operator, sama seperti referensi lintas stack merupakan resolusi saat deployment, bukan saat build.

Urutan yang tidak dinyatakan oleh wave tetap menjadi urusan CloudFormation sendiri, dan referensi antar-resource sudah membawa sebagian besarnya: Fn::GetAtt terhadap resource produsen memberi tahu CloudFormation untuk membuat resource tersebut terlebih dahulu. Fragmen yang memerlukan batasan yang tidak tersirat dari referensi maupun wave menulis DependsOn sendiri, yaitu kasus yang dipertahankan oleh penggabungan di atas.

Determinisme

Dengan masukan yang sama, provider menghasilkan templat stack yang identik byte demi byte di setiap eksekusi: ID logis, kunci output, nama ekspor, dan urutan sumber daya semuanya deterministik, sehingga diff templat stack CloudFormation tetap bersih dalam peninjauan GitOps.