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

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.

  1. Intent (Domain 1): Developer mendeklarasikan antarmuka abstrak: “Saya memerlukan sebuah secret. Saya tidak tahu di mana letaknya. Injeksikan saja ke lingkungan saya sebagai ORACLE_PASSWORD yang dipetakan ke kunci password milik katalog.”
  2. Transfer kompiler (saat rendering): Kompiler Go mengambil entri { in: ORACLE_PASSWORD, from: "password" } dan menyerahkannya ke Recipe Ops. Tidak ada secret fisik yang diambil.
  3. 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.
  4. 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 (melalui uses[].inject dengan from: yang merujuk ke provides milik target) maupun untuk nilai milik komponen itu sendiri (melalui inject tingkat komponen dengan literal value: atau from: yang merujuk ke provides miliknya sendiri). Mekanisme yang diizinkan dideklarasikan per permukaan, dan kedua deklarasi itu terpisah: nilai milik komponen sendiri diatur oleh allowlist spec.inject (misalnya, inject: ["env", "file"]), sedangkan edge uses: 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.inject melarang self-inject tingkat komponen, dan socket yang dideklarasikan tanpa allowlist inject: melarang blok inject: apa pun pada edge yang melaluinya. Developer cukup menyediakan target dependensi melalui uses, dan platform menangani wiring internal secara native melalui valuesMapping milik 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:

  1. Skema Feature kredensial (berlabel feature.aggrega.ai/kind: secret): Memvalidasi HANYA kueri vault (path, key). Skema ini sepenuhnya agnostik terhadap cara kontainer mengonsumsi data.
  2. Skema Component (allowlist spec.inject): Menegakkan aturan Black-Box/White-Box melalui field spec.inject. Jika spec.inject ada (misalnya, inject: ["env", "file"]), developer dapat menggunakan self-inject tingkat komponen dengan mekanisme pengiriman tersebut. Jika spec.inject dihilangkan, kompiler secara struktural melarang self-inject — komponen Black-Box sepenuhnya mengandalkan valuesMapping milik Recipe untuk wiring internal. Build menegakkannya saat meresolusi Aggregate, dengan menolak blok inject: milik komponen dan menyebutkan mekanismenya, berbeda dari validasi konten per pilar di bawah schema:.
  3. Map featuresSchema: Didefinisikan di Component Catalog, map ini secara eksplisit mendeklarasikan slot kredensial yang harus (atau boleh) digunakan Developer. Setiap entri menetapkan required (default false), allowlist inject ([] = blackbox, [env, file] = transparan), dan description. 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 target helm), 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. Lihat entities/component.md untuk desain featuresSchema selengkapnya.

Aturan penempatan yang ketat: Mekanisme inject: tersedia di tiga lokasi dalam Aggregate milik Developer:

  1. Self-inject tingkat komponen: Sebagai sibling langsung dari values: pada instans komponen. Menyuntikkan nilai literal milik komponen itu sendiri atau kunci provides miliknya sendiri ke dalam pipa pengiriman. Hanya diizinkan jika katalog Component mendeklarasikan spec.inject dengan mekanisme yang sesuai.
  2. Cross-inject tingkat uses: Di dalam definisi target eksplisit dalam blok uses:. Menyuntikkan kunci provides milik target dependensi ke dalam pipa pengiriman.
  3. Inject tingkat Feature/Secret: Sebagai saudara dari values: saat melampirkan fitur dan secret. Menyuntikkan kunci provides milik 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 kunciArtiDiizinkan dalam component.injectDiizinkan dalam uses[].injectDiizinkan 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 provides

Template 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 ASumber BHasil
component.injectuses[].inject❌ penghentian fatal — kunci pengiriman duplikat
uses[target_A].injectuses[target_B].inject❌ penghentian fatal — kunci pengiriman duplikat
component.injectfeatures[<name>].inject❌ penghentian fatal — kunci pengiriman duplikat
uses[].injectfeatures[<name>].inject❌ penghentian fatal — kunci pengiriman duplikat
features[A].injectfeatures[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].injectinjectMapping FeatureRecipe milik features[B]❌ penghentian fatal — kunci pengiriman duplikat di antara dua lampiran
component.inject atau uses[].injectinjectMapping 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 intersepsi injectMapping FeatureRecipe.

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 blok inject: milik komponen itu sendiri persis seperti yang ditulis developer di Domain 1. Nilai ini tidak dapat diubah. Jika developer menghilangkan blok tersebut, nilainya null. 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, memetakan API_HOST ke string dasar target "backend-instance"). Yang terpenting, pipa ini dirancang untuk diintersepsi dan di-deep-merge oleh Features (misalnya perutean jaringan) menggunakan blok injectMapping. 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 sebagai env, file, arg (ditambah mekanisme pengiriman kustom apa pun yang diizinkan oleh allowlist inject milik Component), dengan dictionary .all yang telah digabung sebelumnya, yang menggabungkan semua mekanisme untuk memudahkan serialisasi seluruh pipa.
  • .context.self_inject (Nilai sendiri mana yang dikirim setiap nama): Dibaca dari blok inject: tingkat komponen yang sama dengan .inject_raw, dalam bentuk yang digunakan .context.uses.<alias>.inject untuk 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 entri from:, values.<key> untuk template value: 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 ke values.<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 key

Compiler 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 entri uses verbose milik Aggregate, divalidasi terhadap valueSchema milik soket.
  • .context.uses.<alias>.infra — ditulis oleh operator, dideklarasikan dalam Release, divalidasi terhadap infraSchema milik 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-manager
    values:
    path: /prod/ai/openai
    key: "api_token"
    inject:
    file:
    - in: "/etc/secrets/openai.json" # Local path
    from: "api_token" # The attachment's provides key
  • Realitas Ops: Ops Recipe secara dinamis membuat Volume, VolumeMount, dan ExternalSecret Kubernetes 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-ingress
    inject:
    arg:
    - in: "--callback-url=" # Local flag
    from: "hostname" # The attachment's provides key
  • Realitas Ops: Hostname adalah nama komponen di lingkungan tersebut, sehingga operator menuliskannya, api.enterprise.com, dalam infra lampiran 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 array args Kubernetes: ["/app/binary", "--callback-url=https://api.enterprise.com"], sepenuhnya melewati Base Recipe milik Component.