View a markdown version of this page

Infrastruktur komponen sebagai file kode - AWS Proton
Menggunakan parameter dengan komponenMenulis file IaC yang kuat

Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, dukungan AWS akan berakhir untuk AWS Proton. Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses AWS Proton konsol atau AWS Proton sumber daya. Infrastruktur yang Anda gunakan akan tetap utuh. Untuk informasi selengkapnya, lihat Panduan AWS Proton Penghentian Layanan dan Migrasi.

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

Infrastruktur komponen sebagai file kode

Infrastruktur komponen sebagai file kode (IAc) mirip dengan yang untuk AWS Proton sumber daya lainnya. Pelajari di sini tentang beberapa detail yang khusus untuk komponen. Untuk informasi lengkap tentang pembuatan file IaC untuk AWS Proton, lihat. Menulis template dan membuat bundel untuk AWS Proton

Menggunakan parameter dengan komponen

Namespace AWS Proton parameter mencakup beberapa parameter yang dapat dirujuk oleh file IAC layanan untuk mendapatkan nama dan output komponen terkait. Namespace juga menyertakan parameter yang dapat dirujuk oleh file IaC komponen untuk mendapatkan input, output, dan nilai sumber daya dari lingkungan, layanan, dan instance layanan yang terkait dengan komponen tersebut.

Komponen tidak memiliki input sendiri—ia mendapatkan inputnya dari instance layanan yang dilampirkan. Komponen juga dapat membaca output lingkungan.

Untuk informasi selengkapnya tentang menggunakan parameter dalam komponen dan file iAc layanan terkait, lihatDetail dan contoh parameter file CloudFormation iAc komponen. Untuk informasi umum tentang AWS Proton parameter dan referensi lengkap dari namespace parameter, lihatAWS Proton parameter.

Menulis file IaC yang kuat

Sebagai administrator, saat Anda membuat versi template layanan, Anda dapat memutuskan apakah Anda ingin mengizinkan instance layanan yang dibuat dari versi template memiliki komponen yang dilampirkan. Lihat ComponentSources parameter yang didukung dari tindakan CreateServiceTemplateVersion API di Refer AWS Proton ensi API. Namun, untuk instance layanan di masa mendatang, orang yang membuat instance, memutuskan apakah akan melampirkan komponen ke dalamnya atau tidak, dan (dalam kasus komponen yang ditentukan secara langsung) penulis komponen IaC biasanya orang yang berbeda — pengembang yang menggunakan template layanan Anda. Oleh karena itu, Anda tidak dapat menjamin bahwa komponen akan dilampirkan ke instance layanan. Anda juga tidak dapat menjamin keberadaan nama keluaran komponen tertentu atau validitas dan keamanan nilai output ini.

AWS Proton dan sintaks Jinja membantu Anda mengatasi masalah ini dan membuat template layanan kuat yang dirender tanpa kegagalan dengan cara berikut:

  • AWS Proton filter parameter — Saat Anda merujuk ke properti keluaran komponen, Anda dapat menggunakan filter parameter —pengubah yang memvalidasi, memfilter, dan memformat nilai parameter. Untuk informasi selengkapnya dan contoh tambahan, lihat Filter parameter untuk CloudFormation file IAc.

  • Default properti tunggal — Saat Anda merujuk ke properti sumber daya atau keluaran tunggal komponen, Anda dapat menjamin bahwa rendering template layanan Anda tidak akan gagal dengan menggunakan default filter, dengan atau tanpa nilai default. Jika komponen, atau parameter output tertentu yang Anda maksud, tidak ada, nilai default (atau string kosong, jika Anda belum menentukan nilai default) dirender sebagai gantinya, dan rendering berhasil. Untuk informasi selengkapnya, lihat Berikan nilai default untuk referensi yang tidak ada.

    Contoh:

    • {{ service_instance.components.default.name | default("") }}

    • {{ service_instance.components.default.outputs.my-output | default("17") }}

    catatan

    Jangan bingung .default bagian namespace, yang menunjuk komponen yang ditentukan secara langsung, dengan default filter, yang memberikan nilai default ketika properti yang direferensikan tidak ada.

  • Referensi objek keseluruhan — Ketika Anda merujuk ke seluruh komponen, atau ke kumpulan output komponen, AWS Proton mengembalikan objek kosong{}, dan karenanya menjamin bahwa rendering template layanan Anda tidak akan gagal. Anda tidak perlu menggunakan filter apa pun. Pastikan untuk membuat referensi dalam konteks yang dapat mengambil objek kosong, atau menggunakan {{ if .. }} kondisi untuk menguji objek kosong.

    Contoh:

    • {{ service_instance.components.default }}

    • {{ service_instance.components.default.outputs }}