provides, inject, uses
Kontrak injeksi dan peta yang telah diresolusi sebelumnya
Karena Aggrega adalah kompiler statis Ahead-of-Time (AOT), tidak ada data yang mengalir balik dari infrastruktur yang sedang berjalan selama kompilasi. Secara mekanis, kompiler tidak mungkin secara aktif mengambil kredensial fisik (seperti secret AWS) lalu meneruskannya “kembali” ke lingkungan kontainer Developer.
Sebagai gantinya, platform mengandalkan inversi kontrol sejati. Ketika developer menulis inject: { env: [{ in: ORACLE_PASSWORD, from: "password" }] }, ia tidak memulai pengambilan data; ia menetapkan kontrak yang ketat kepada infrastruktur.
- Intent (Domain 1): Developer mendeklarasikan antarmuka abstrak: “Saya memerlukan sebuah secret. Saya tidak tahu di mana letaknya. Injeksikan saja ke lingkungan saya sebagai
ORACLE_PASSWORDyang dipetakan ke kuncipasswordmilik katalog.” - Transfer kompiler (saat rendering): Kompiler Go mengambil entri
{ in: ORACLE_PASSWORD, from: "password" }dan menyerahkannya ke Recipe Ops. Tidak ada secret fisik yang diambil. - Output Plugin (Domain 3): Pipeline Wasm milik FeatureRecipe kredensial menghasilkan artefak yang saling terkait secara tepat sesuai yang dibutuhkan infrastruktur target. Misalnya, di Kubernetes, pipeline ini menghasilkan CRD
ExternalSecret(yang menginstruksikan klaster untuk mengambil data vault) DAN menjalankan JSONPatch terhadap Pod target untuk memetakan Secret K8s lokal yang dihasilkan secara khusus ke variabel lingkungan"ORACLE_PASSWORD"yang diminta developer. - Realitas runtime: Saat runtime, sebuah operator di dalam klaster cukup menjalankan artefak yang dihasilkan ini—mengambil kredensial dan memasangnya secara fisik ke dalam kontainer—sehingga mekanisme keamanan fisik sepenuhnya terpisah dari kompiler AOT.
Untuk menghadirkan realitas fisik ini ke aplikasi tanpa melanggar pemisahan tanggung jawab (Separation of Concerns), Aggrega menggunakan kontrak injeksi. Namun, kontrak ini secara tegas membedakan antara kode aplikasi kustom dan infrastruktur Commercial Off-The-Shelf (COTS):
- White-Box (kode kustom): Komponen tersebut adalah worker generik (misalnya, agen Python kustom). Kompiler Go dan Recipe Ops sama sekali tidak tahu variabel apa yang diharapkan oleh skrip kustom developer. Oleh karena itu, di mana pun kode membaca nama yang tidak dikirimkan Recipe-nya secara default, Developer menetapkan cara pengiriman melalui blok
inject:— baik untuk dependensi lintas komponen (melaluiuses[].injectdenganfrom:yang merujuk keprovidesmilik target) maupun untuk nilai milik komponen itu sendiri (melaluiinjecttingkat komponen dengan literalvalue:ataufrom:yang merujuk keprovidesmiliknya sendiri). Mekanisme yang diizinkan dideklarasikan per permukaan, dan kedua deklarasi itu terpisah: nilai milik komponen sendiri diatur oleh allowlistspec.inject(misalnya,inject: ["env", "file"]), sedangkan edgeuses:diatur oleh allowlist pada socket yang dilaluinya,spec.usesSchema.<socket>.inject. Menetapkan mekanisme yang tidak disebutkan oleh allowlist yang berlaku akan menghentikan build pada kedua permukaan. - Black-Box (komputasi terpaket): Komponen tersebut adalah sistem tertutup (misalnya, Redis, API Gateway terkelola). Recipe Ops sudah tahu persis bagaimana sistem tersebut mengonsumsi datanya. Oleh karena itu, entitas katalog Component menghilangkan allowlist, yang melarang penetapan sama sekali alih-alih mempersempitnya — menghilangkan
spec.injectmelarang self-inject tingkat komponen, dan socket yang dideklarasikan tanpa allowlistinject:melarang blokinject:apa pun pada edge yang melaluinya. Developer cukup menyediakan target dependensi melaluiuses, dan platform menangani wiring internal secara native melaluivaluesMappingmilik Recipe.
Aturan pengalamatan deterministik (fisika jaringan internal)
Pipe .context.uses milik Aggrega secara dinamis menginjeksikan string target ke dalam kontainer pada waktu kompilasi. Karena kompiler Go inti sepenuhnya agnostik terhadap jaringan fisik, apa yang dianggap sebagai string alamat yang valid sepenuhnya bergantung pada kontrak sosial yang dijunjung oleh Platform Ops, bukan fungsi kompiler — kompiler menyalurkan string pointer deterministik apa pun yang dihasilkan Recipe Ops ke dalam konteks template hilir tanpa interpretasi.
Aturannya: Recipe Ops harus mengekspor pointer alamat yang deterministik dan stabil. Provider tidak menghitung IP. Sebagai gantinya, Recipe Ops milik target sebaiknya merumuskan string yang dapat diprediksi dan mengeksposnya melalui kontrak provides: miliknya (misalnya, memublikasikan provides.internal_host: "http://agent-b.namespace.svc.cluster.local" di Kubernetes, atau string interpolasi seperti "${module.db.endpoint}" di Terraform, di mana modul mendeklarasikan output yang sesuai untuk nilai tersebut).
Mengandalkan kompiler untuk mengambil IP dinamis pasca-provisioning secara langsung melanggar model eksekusi AOT. Karena kompiler mengevaluasi topologi sebelum cloud menyediakan komputasi apa pun yang sebenarnya, kompiler secara fisik tidak dapat mengambil data yang belum ada. Jika sebuah layanan memerlukan IP acak yang baru dihasilkan setelah komputasi menyala, kompiler secara fisik tidak dapat mengambilnya. Satu-satunya tugas kompiler adalah menyalurkan string pointer deterministik yang disediakan oleh Recipe Ops, apa adanya, ke dalam variabel lingkungan kontainer pemanggil, dan menyerahkan resolusi akhirnya kepada DNS klaster atau pengelola state IaC yang aktif.
Menerapkan pengalamatan deterministik secara native menyelesaikan dependensi siklik (misalnya, Agent A mendelegasikan ke Agent B, dan Agent B mendelegasikan kembali ke Agent A). Karena URL stabil atau pointer IaC dapat dihitung sebagai string sebelum kedua kontainer benar-benar berjalan, kompiler dengan aman menghubungkan kedua agen tanpa menimbulkan race condition temporal.
(Catatan: Aturan ini juga berlaku untuk ingress eksternal. Jika sebuah arsitektur mengekspos API Gateway publik dan memerlukan URL tersebut untuk diinjeksikan kembali ke kontainer internal, kompiler Go tidak dapat mengambil URL acak yang dihasilkan cloud (misalnya, xyz123.execute-api.aws.com) karena URL itu belum ada pada waktu kompilasi. Ops harus menyusun Recipe mereka untuk memetakan domain kustom yang deterministik (misalnya, api.enterprise.com) atau mengekspor string interpolasi IaC native, sehingga kompiler AOT memiliki referensi yang diketahui untuk diinjeksikan dengan aman).
Mekanisme implementasi (katalog sebagai kontrak API) Untuk mengimplementasikan hal ini tanpa mengikat Developer secara erat ke Ops, Aggrega menggunakan Platform Catalog (Domain 2) sebagai kontrak API yang ketat, dengan tiga lapisan validasi yang berbeda:
- Skema Feature kredensial (berlabel
feature.aggrega.ai/kind: secret): Memvalidasi HANYA kueri vault (path,key). Skema ini sepenuhnya agnostik terhadap cara kontainer mengonsumsi data. - Skema
Component(allowlistspec.inject): Menegakkan aturan Black-Box/White-Box melalui fieldspec.inject. Jikaspec.injectada (misalnya,inject: ["env", "file"]), developer dapat menggunakan self-inject tingkat komponen dengan mekanisme pengiriman tersebut. Jikaspec.injectdihilangkan, kompiler secara struktural melarang self-inject — komponen Black-Box sepenuhnya mengandalkanvaluesMappingmilik Recipe untuk wiring internal. Build menegakkannya saat meresolusi Aggregate, dengan menolak blokinject:milik komponen dan menyebutkan mekanismenya, berbeda dari validasi konten per pilar di bawahschema:. - Map
featuresSchema: Didefinisikan di Component Catalog, map ini secara eksplisit mendeklarasikan slot kredensial yang harus (atau boleh) digunakan Developer. Setiap entri menetapkanrequired(defaultfalse), allowlistinject([]= blackbox,[env, file]= transparan), dandescription. Karena kunci-kunci ini stabil dan dijamin secara kontraktual, Ops Engineer dapat langsung mengandalkannya untuk menetapkan target deterministik secara andal dalam template Go mereka (misalnya,existingSecret: "{{ .context.rendered_name }}-{{ .locals.secret_target_admin_password }}"pada targethelm), dengan secara eksplisit mengekspor sufiks nama melalui.locals— sebuah local tidak dapat membaca.context.rendered_name— sehingga FeatureRecipe kredensial hilir menggabungkan kedua bagian yang sama dan memenuhi kebutuhan tersebut tanpa melanggar urutan eksekusi AOT. Lihatentities/component.mduntuk desainfeaturesSchemaselengkapnya.
Aturan penempatan yang ketat: Mekanisme inject: tersedia di tiga lokasi dalam Aggregate milik Developer:
- Self-inject tingkat komponen: Sebagai sibling langsung dari
values:pada instans komponen. Menyuntikkan nilai literal milik komponen itu sendiri atau kunciprovidesmiliknya sendiri ke dalam pipa pengiriman. Hanya diizinkan jika katalog Component mendeklarasikanspec.injectdengan mekanisme yang sesuai. - Cross-inject tingkat uses: Di dalam definisi target eksplisit dalam blok
uses:. Menyuntikkan kunciprovidesmilik target dependensi ke dalam pipa pengiriman. - Inject tingkat Feature/Secret: Sebagai saudara dari
values:saat melampirkan fitur dan secret. Menyuntikkan kunciprovidesmilik lampiran itu sendiri yang telah diresolusi — kredensial yang telah diresolusi untuk sebuah secret, atau nilai yang disediakan oleh sebuah fitur — ke dalam pipa pengiriman.
Ketiga bentuk mengisi pipa .context.inject yang sama. Recipe membaca satu pipa terpadu, berapa pun jumlah sumber yang berkontribusi padanya.
Skema inject mendefinisikan enum standar (env, file, arg) untuk tooling, tetapi membiarkan additionalProperties terbuka, sehingga mekanisme kustom dapat dinamai (misalnya, ssm_param untuk AWS Systems Manager Parameter Store). Satu nama sudah dipakai: all adalah tampilan gabungan dari setiap mekanisme yang dibaca Recipe di .context.inject.all, sehingga blok inject yang menamai sebuah mekanisme all menghentikan build pada amplop dokumen, dengan menyatakan hal tersebut.
Sintaks entri inject: Di bawah blok inject, setiap mekanisme pengiriman — env, file, arg, atau mekanisme kustom — adalah daftar entri, dan setiap penempatan menggunakan bentuk entri yang sama. Kata kunci yang dibawa sebuah entri, bukan penempatan tempat entri itu berada, yang menentukan arti string-nya, sehingga sebuah entri dibaca dengan cara yang sama di mana pun ia muncul. Mekanisme yang ditulis sebagai map alih-alih daftar, atau entri yang membawa kedua kata kunci, menghentikan build pada amplop dokumen Aggregate, dengan menyebutkan path di dalam Aggregate tempat bentuknya salah.
Kata kunci entri (from: dan value:): Setiap entri menggunakan kata kunci in untuk pengenal lokal — nama variabel lingkungan, path berkas, flag argumen — ditambah tepat satu dari from: (referensi kunci provides) atau value: (string literal). Sebuah from: di-resolve terhadap provides milik node yang disebut oleh penempatannya: milik komponen itu sendiri di component.inject, milik target di uses[target].inject, dan milik lampiran itu sendiri di features[<name>].inject:
| Kata kunci | Arti | Diizinkan dalam component.inject | Diizinkan dalam uses[].inject | Diizinkan di features[<name>].inject |
|---|---|---|---|---|
from: | Di-resolve terhadap provides | ✅ provides milik node sendiri | ✅ provides milik node target | ✅ provides milik lampiran itu sendiri |
value: | String literal (mendukung template Go) | ✅ | ❌ (value: tidak valid dalam uses[].inject; gunakan inject tingkat komponen untuk self-inject) | ❌ (value: menghentikan build dalam inject milik lampiran; gunakan inject tingkat komponen untuk self-inject) |
Contoh:
# Component-level self-inject (White-Box custom code)components: my-worker: type: core/python-worker:1.0.0 values: app_token: "xyz" inject: env: - in: MY_TOKEN value: "xyz" # Literal value - in: LOG_LEVEL value: "debug" # Literal value - in: CALLBACK_HOST from: "host" # From own provides (already evaluated) - in: APP_VERSION value: '{{"{{"}} .values.app_token }}' # Go template expanding own values uses: databases: my_db: target: postgres-db inject: env: - in: DB_HOST from: "host" # Provides key from target - in: DB_PORT from: "port" # Provides key from target - in: DB_URL from: "dsn" # From target's providesTemplate dalam value: milik APP_VERSION diawali dengan {{"{{"}}, bukan {{: seluruh teks Aggregate dibaca sekali sebagai template, untuk interpolasi parameter, sebelum resolusi self-inject berjalan, dan .values belum ada pada saat itu, sehingga escape tersebut mengembalikan {{ untuk dievaluasi oleh resolusi self-inject. Lihat Teks yang membawa kurung kurawal gandanya sendiri.
Catatan khusus Provider (compose). Ketika edge uses: diresolusi di antara node yang menargetkan compose, provider compose menurunkan entri depends_on dari edge tersebut. Entri tersebut selalu menggunakan semantik service_started terlepas dari blok health: milik target mana pun; penahanan entri tersebut berdasarkan kesehatan target tidak diimplementasikan. Lihat providers/compose.md untuk aturan inferensi selengkapnya.
Aturan tabrakan kunci inject: Developer yang meminta kunci pengiriman yang sama (misalnya, nama variabel env yang sama) dari dua sumber berbeda merupakan kesalahan fatal, bukan penggabungan. Compiler mendeteksi tabrakan tersebut dan menghentikan build:
| Sumber A | Sumber B | Hasil |
|---|---|---|
component.inject | uses[].inject | ❌ penghentian fatal — kunci pengiriman duplikat |
uses[target_A].inject | uses[target_B].inject | ❌ penghentian fatal — kunci pengiriman duplikat |
component.inject | features[<name>].inject | ❌ penghentian fatal — kunci pengiriman duplikat |
uses[].inject | features[<name>].inject | ❌ penghentian fatal — kunci pengiriman duplikat |
features[A].inject | features[B].inject | ❌ penghentian fatal — kunci pengiriman duplikat |
component.inject (kunci yang sama dua kali) | — | ❌ penghentian fatal — kunci pengiriman duplikat |
injectMapping FeatureRecipe milik features[A] | injectMapping FeatureRecipe milik features[B] | ❌ penghentian fatal — kunci pengiriman duplikat di antara dua lampiran |
features[A].inject | injectMapping FeatureRecipe milik features[B] | ❌ penghentian fatal — kunci pengiriman duplikat di antara dua lampiran |
component.inject atau uses[].inject | injectMapping FeatureRecipe | ✅ Sah — intersepsi memang dirancang demikian: nilai mapping menggantikan entri tersebut |
Tabel ini membaca setiap Feature yang dilampirkan dengan cara yang sama, di mana pun ia dilampirkan — pada komponen, pada boundary subsistem atau Release, melalui ekspansi anotasi, atau pada koneksi. injectMapping milik FeatureRecipe di-render setelah setiap blok inject: selesai mengirim, sehingga ia selalu menjadi klaim yang lebih akhir dari dua klaim: ia boleh menulis ulang apa yang dikirim komponen atau salah satu koneksinya, dan ia boleh menulis ulang apa yang dikirim blok inject: milik lampirannya sendiri, tetapi kunci yang sudah dikirim oleh Feature terlampir lain menghentikan build, dengan menyebutkan keduanya.
Feature yang dilampirkan pada boundary Release yang FeatureRecipe-nya di-render sekali untuk boundary tersebut (executionScope: boundary) menjangkau komponen-komponen yang dimuat boundary melalui jalur yang sama: injectMapping-nya berjalan sekali untuk masing-masing komponen, dalam konteks komponen tersebut, dan tunduk pada baris-baris tabel di atas seperti mapping lainnya. Bridge compose yang menulis ulang variabel host milik konsumen agar mencapai targetnya melalui gateway target adalah salah satu mapping seperti itu, sehingga Feature terlampir lain yang telah mengirim variabel yang sama menghentikan build, dengan menyebutkan keduanya.
Untuk mencegah boilerplate template Go dalam Recipes, compiler menyediakan keduanya:
.context.uses: Map edge topologis yang diperkaya (untuk logika kompleks, referensi secret, dan pelacakan asal)..context.inject: Dictionary datar yang telah di-resolve sebelumnya, tempat compiler telah me-resolve semua sumber inject (literal self-inject, referensi provides self-inject, dan referensi provides lintas komponen) menjadi nilai string akhir, lalu menerapkan intersepsiinjectMappingFeatureRecipe.
Konteks injeksi dua status (keamanan null vs. kemurnian intent) Saat menghasilkan konfigurasi untuk Modifier (FeatureRecipe yang terikat pada lampiran apa pun, kredensial atau lainnya), compiler harus menyeimbangkan keamanan null-pointer untuk template Go, perutean jaringan dinamis, dan pelestarian graf yang agnostik terhadap kapabilitas. Untuk mencapainya, compiler menyediakan konteks dua status bagi template:
.inject_raw(intent yang tidak dapat diubah): Merepresentasikan blokinject:milik komponen itu sendiri persis seperti yang ditulis developer di Domain 1. Nilai ini tidak dapat diubah. Jika developer menghilangkan blok tersebut, nilainyanull. Ops menggunakannya khusus untuk pemeriksaan logis (misalnya,{{ if not .inject_raw }}untuk menerapkan perilaku fallback). Karena tidak dapat diubah, nilai ini melindungi template Ops dari false positive jika feature perutean mengintersepsi dan memutasi pipa pengiriman fisik..context.inject(pipa yang telah dihidrasi sebelumnya dan diintersepsi): Struct paralel yang dihasilkan compiler, yang merepresentasikan realitas pengiriman fisik. Struct ini dimulai sebagai map yang telah dihidrasi sebelumnya (misalnya, memetakanAPI_HOSTke string dasar target"backend-instance"). Yang terpenting, pipa ini dirancang untuk diintersepsi dan di-deep-merge oleh Features (misalnya perutean jaringan) menggunakan blokinjectMapping. Pada saat Base Recipe di-render, pipa ini berisi string yang telah diformat sepenuhnya dan benar secara fisik (misalnya nama jaringan lengkap yang benar seperti"backend-instance.backend-zone.svc.cluster.local"). Isinya disusun sebagaienv,file,arg(ditambah mekanisme pengiriman kustom apa pun yang diizinkan oleh allowlist inject milik Component), dengan dictionary.allyang telah digabung sebelumnya, yang menggabungkan semua mekanisme untuk memudahkan serialisasi seluruh pipa..context.self_inject(Nilai sendiri mana yang dikirim setiap nama): Dibaca dari blokinject:tingkat komponen yang sama dengan.inject_raw, dalam bentuk yang digunakan.context.uses.<alias>.injectuntuk memberikan nama-nama sebuah koneksi: per mekanisme, setiap nama yang ditulis pengembang dipetakan ke kunci milik komponen itu sendiri yang dikirim oleh entrinya —provides.<key>untuk entrifrom:,values.<key>untuk templatevalue:yang membaca tepat satu nilai milik komponen itu sendiri dan tidak membaca apa pun selain itu, serta string kosong untuk hal lainnya (literal, dua nilai, pembacaan apa pun selain nilai). Ini memungkinkan sebuah Recipe yang menjalankan image milik pengembang sendiri memperlakukan nama-nama variabelnya sendiri sebagai default — mengirim nilai miliknya sendiri di bawah nama default-nya hanya jika belum ada entri yang dipetakan kevalues.<key>, sehingga pengembang yang mengganti nama satu nilai tetap mempertahankan semua default lainnya. Itu adalah konvensi katalog pustaka standar, bukan aturan kompiler; katalog perusahaan dapat mengirimkan nilai milik komponennya sendiri dengan cara apa pun yang dipilihnya.
Ops menggunakan struct .context.inject secara eksklusif untuk serialisasi yang aman (misalnya, {{ toJson .context.inject.all }}) dan pembuatan perutean, sehingga infrastruktur fisik menerima koordinat yang telah di-resolve sepenuhnya sementara intent asli developer tetap utuh sepenuhnya di .inject_raw.
Contoh YAML developer (map granular):
uses: databases: my-postgres-cluster: target: db-main inject: ssm_param: # Agnostic injection paradigm (AWS Systems Manager) - in: MY_DB_HOST # Local identifier from: "host" # Target provides keyCompiler me-resolve ini pada waktu kompilasi (memetakan ke string statis atau nama DNS internal) dan meneruskan kedua objek tersebut ke Recipe:
"context": { "uses": { ... raw graph ... }, "inject": { "all": { "MY_DB_HOST": "db-main.internal" }, "ssm_param": { "MY_DB_HOST": "db-main.internal" } }}Konfigurasi berlingkup koneksi (values dan infra). Selain mengirimkan provides milik target melalui inject, sebuah edge dapat membawa konfigurasinya sendiri — pengaturan per koneksi yang dibaca oleh Recipe konsumen dari pipa topologi yang diperkaya:
.context.uses.<alias>.values— ditulis oleh pengembang, dideklarasikan dalam entriusesverbose milik Aggregate, divalidasi terhadapvalueSchemamilik soket..context.uses.<alias>.infra— ditulis oleh operator, dideklarasikan dalam Release, divalidasi terhadapinfraSchemamilik soket.
Soket (usesSchema[<socket>]) adalah kontrak Architect tentang koneksi mana yang mungkin dan konfigurasi apa yang dapat dibawanya; values dan infra membagi konfigurasi tersebut berdasarkan domain penulisan, mencerminkan pembagian values/infra pada komponen. Jadi sebuah edge memiliki dua penulis: pengembang menyambungkan topologi dan menyetelnya dengan values di Aggregate, sedangkan operator menetapkan infra per koneksi di Release dalam batas soket yang dideklarasikan Architect. Release juga dapat menyambungkan edge pada soket yang dideklarasikan tetapi belum terikat ke komponen yang sudah ada; Release tidak dapat mengubah target edge yang dideklarasikan pengembang — lihat entities/release.md §“Per-edge connection configuration”.
Konfigurasi per edge berlingkup konsumen: konfigurasi ini hanya muncul dalam konteks node yang menulis edge tersebut (sumber koneksi), tidak pernah dalam konteks target. Dengan demikian, keluaran yang dirender milik target sendiri tidak berubah terhadap konsumen yang terhubung kepadanya. Feature yang dilampirkan pada target adalah satu-satunya tempat koneksi tersebut terlihat: FeatureRecipe-nya membaca komponen mana yang menggunakan target di .context.used_by — identitas masing-masing, soket, provides yang dipublikasikan, namespace dan batas tempatnya ditempatkan, serta, untuk FeatureRecipe yang mendeklarasikan bahwa ia membacanya, fakta render yang dilaporkan penyedianya — tetapi tidak pernah values atau infra milik koneksi itu sendiri. Feature yang dilampirkan pada konsumen membaca, dengan cara yang sama, apa yang dilaporkan oleh render setiap targetnya, pada entri koneksi tersebut di .context.uses.<alias>.render_facts, jika FeatureRecipe-nya mendeklarasikan bahwa ia membacanya.
Lampiran koneksi (features). Sebuah koneksi juga dapat membawa lampirannya sendiri — misalnya kredensial yang diberikan konsumen kepada komponen yang dijangkau koneksi ini — di bawah features: pada entrinya, dengan kunci berupa slot yang dideklarasikan soket dalam featuresSchema-nya. Kedua penulis yang sama membaginya: pengembang melampirkan pada entri koneksi Aggregate dengan type dan values, dan operator menentukan ukuran lampiran tersebut dengan infra, atau melampirkan lampirannya sendiri dengan type dan infra, pada entri Release. Lampiran pada koneksi tidak membawa blok inject sendiri, itulah sebabnya lampiran ini tidak ada dalam aturan penempatan di atas: lampiran ini bukan salah satu tempat pengembang menentukan pengiriman.
Masing-masing menjadi lampiran dari komponen konsumen dengan nama <alias>.<slot>, sehingga berlingkup konsumen persis seperti konfigurasi per edge: FeatureRecipe-nya dirender di sisi konsumen, dan keluaran target tidak berubah karenanya. Lampiran ini tidak dimasukkan ke .features milik Recipe konsumen, yang hanya memuat lampiran yang dideklarasikan oleh blok komponen itu sendiri; Recipe membacanya di bawah koneksinya, di .context.uses.<alias>.features.<slot>. Koneksi yang ditarik oleh lampiran Feature tidak membawa lampiran. Lihat entities/aggregate.md §“A connection’s own attachments” dan entities/component.md §“Topology Sockets”.
A. Variabel lingkungan (env) & resolusi tujuan dinamis
Mekanisme pengiriman standar untuk aplikasi cloud-native modern. Untuk edge topologi eksplisit (misalnya, Agent yang berkomunikasi dengan Database), Aggrega menggunakan .context.uses untuk menyuntikkan pemetaan variabel lingkungan.
- Kasus penggunaan: Menerima nama DNS internal yang deterministik, string interpolasi Infrastructure-as-Code (misalnya,
${module.db.endpoint}), atau penunjuk Vault statis. Compiler menyambungkan referensi statis ini secara AOT sehingga infrastruktur runtime atau pengendali GitOps dapat meresolusi nilai aktualnya.
B. Mount file (file)
Banyak framework AI perusahaan mengharapkan config.json terstruktur atau sertifikat .pem berada di path tertentu pada disk, alih-alih mengandalkan variabel lingkungan.
-
Kasus penggunaan: Menyuntikkan konfigurasi JSON yang kompleks atau memenuhi SDK lama yang membaca dari disk.
-
Maksud Dev:
features:openai_key:type: core/aws-secrets-managervalues:path: /prod/ai/openaikey: "api_token"inject:file:- in: "/etc/secrets/openai.json" # Local pathfrom: "api_token" # The attachment's provides key -
Realitas Ops: Ops Recipe secara dinamis membuat
Volume,VolumeMount, danExternalSecretKubernetes yang diperlukan untuk menarik data vault secara aman dan me-mount-nya ke/etc/secrets/openai.json.
C. Argumen baris perintah (arg)
Biner yang telah dikompilasi (seperti node worker Rust atau Go) sering kali sama sekali tidak menggunakan variabel lingkungan, dan mengharapkan nilai diteruskan sebagai flag runtime dalam perintah eksekusinya.
-
Kasus penggunaan: Menambahkan realitas fisik ke perintah startup kontainer.
-
Maksud Dev:
features:public-ingress:type: core/external-ingressinject:arg:- in: "--callback-url=" # Local flagfrom: "hostname" # The attachment's provides key -
Realitas Ops: Hostname adalah nama komponen di lingkungan tersebut, sehingga operator menuliskannya,
api.enterprise.com, dalaminfralampiran ini pada entri Release untuk komponen tersebut. Plugin Wasm milik Feature menerima URL publik yang telah diresolusi melalui Injection Contract dan menghasilkan JSONPatch untuk secara dinamis menambahkan ke arrayargsKubernetes:["/app/binary", "--callback-url=https://api.enterprise.com"], sepenuhnya melewati Base Recipe milik Component.