Rahasia
Halaman ini menjelaskan satu gagasan, yaitu bagaimana kredensial mencapai komponen yang membutuhkannya, dan bukan ruang kerja yang dapat dijalankan. Platform lanjutan — platform Kubernetes dengan banyak batas menunjukkan kedua model pengiriman dalam ruang kerja yang Anda bangun; tuliskan ke folder milik Anda sendiri dengan:
aggrega scaffold --example advanced-platformKemudian ia mencetak perintah yang dijalankan berikutnya:
cd advanced-platformaggrega pull --release release.yamlaggrega build --release release.yamlDaftar periksa pengiriman secret
Sebuah kredensial melewati enam permukaan sebelum mencapai kontainer yang sedang berjalan. Berikut titik sentuh yang perlu diperiksa saat menghubungkan kredensial baru:
| Langkah | Permukaan | Tindakan |
|---|---|---|
| 1 | Component featuresSchema: | Deklarasikan slot kredensial: namanya, apakah slot tersebut required, dan allowlist inject: miliknya — mekanisme pengiriman yang boleh disebut oleh attachment, [env] atau [env, file] untuk slot transparan, [] untuk slot buram. |
| 2 | Feature kredensial schema: | Definisikan apa yang disediakan penulis: Features kredensial dari pustaka standar membawa label feature.aggrega.ai/kind: secret dan menerima lokator kredensial sebagai origin, serta kunci data sebagai key. |
| 3 | Aggregate features: | Minta kredensial, di bawah kata kunci features: yang sama seperti Feature lainnya: type miliknya, values miliknya, dan, hanya pada slot transparan, blok inject: yang menyatakan bagaimana aplikasi membacanya. |
| 4 | FeatureRecipe | Wujudkan untuk target: tulis nilai di tempat komponen membacanya, render sumber daya yang menyimpannya, atau render sumber daya yang mengambilnya dari penyimpanan rahasia. |
| 5 | Manifest mappings.features.type | Ikat Feature kredensial ke FeatureRecipe-nya, di tingkat yang sama dengan setiap Feature lainnya. |
| 6 | Recipe | Baca, pada slot buram: Recipe milik komponen membaca lokator yang dipublikasikan kredensial, .features.<slot>.provides.name, dan menyerahkannya ke mekanisme milik produk itu sendiri, seperti existingSecret pada sebuah chart. |
Slot transparan menggunakan lima yang pertama; slot buram menggunakan keenamnya, yang merupakan kasus umum untuk infrastruktur terpaket seperti chart dari vendor.
Slot transparan dan buram
Slot transparan memungkinkan pengembang menyatakan bagaimana aplikasi membaca kredensial. Slot buram menyerahkan pengiriman kepada Recipe, dan attachment yang menuliskan blok inject: padanya menghentikan build. Dalam contoh, core/datastore/mariadb mendeklarasikan masing-masing satu, dan Aggregate mengisi keduanya, dari aggregate.yaml dengan komentarnya dihilangkan:
db: type: core/datastore/mariadb features: root_password: type: core/secret-value values: key: MARIADB_ROOT_PASSWORD origin: dev-root-pw-change-me user_password: type: core/secret-provided values: origin: dev-app-pw-change-me inject: env: - in: MARIADB_PASSWORD from: valueroot_password bersifat buram: core/secret-value mengirimkan nilai di bawah kunci yang disebut oleh attachment, tempat Recipe milik basis data membacanya. user_password bersifat transparan: core/secret-provided memublikasikan nilai sebagai value, dan blok inject: milik attachment itu sendiri mengirimkannya ke MARIADB_PASSWORD. Blok inject: yang menyebut mekanisme yang tidak tercantum pada slot menghentikan build, begitu pula blok yang menyebut kunci yang tidak dipublikasikan atau dibaca oleh apa pun.
Untuk slot buram yang diisi oleh kredensial yang dapat direferensikan, Recipe milik komponen membaca lokator yang dipublikasikan alih-alih menurunkan sebuah nama, existingSecret: "{{ .features.root_password.provides.name }}", sehingga Secret yang diterbitkan sebuah FeatureRecipe dan referensi kepadanya adalah satu string yang sama. MariaDB (chart Bitnami) — satu Secret kredensial multi-kunci membangun alur tersebut pada chart dari vendor.
Mewujudkan kredensial: sebuah sumber daya, atau pipeline dua langkah
Realisasi Kubernetes dari pustaka standar merender sumber daya kredensial dari chart kecil di samping FeatureRecipe: helm/k8s-secret-from-parameter merender Secret yang menyimpan nilai yang diberikan penulis, dan helm/k8s-external-secret merender ExternalSecret yang direkonsiliasi oleh External Secrets Operator dari penyimpanan rahasia. Features kredensial membahas masing-masing.
Sebagai gantinya, FeatureRecipe dapat mewujudkan kredensial dengan pipeline: dua langkah, yang masing-masing berupa plugin. Langkah pertama, pengambil, menulis sumber daya khusus penyimpanan — misalnya sebuah ExternalSecret — yang menyebut entri penyimpanan yang diberikan oleh nilai attachment. Langkah kedua, penyuntik, menambal beban kerja komponen yang telah dirender untuk me-mount Secret yang dihasilkan ke dalam kontainernya, pada variabel atau berkas yang disebut oleh blok inject: milik attachment, yang dibaca langkah tersebut di .inject. Beralih ke penyimpanan rahasia lain mengganti pengambil; penyuntik tetap. Sebuah langkah mengembalikan sumber daya yang ditambahkannya sebagai efek samping dan perubahannya pada dokumen yang dirender sebagai patch; kontrak plugin Wasm adalah bentuk keduanya.
Kredensial milik Feature sendiri
Sebuah Feature dapat memerlukan kredensialnya sendiri: proxy pengaman yang melakukan autentikasi ke layanan hulu, pengirim log dengan token ingest. Feature mendeklarasikan slot di dalam featuresSchema miliknya sendiri, persis seperti yang dilakukan sebuah Component, dan FeatureRecipe yang terikat padanya membaca apa yang mengisi slot tersebut saat merender beban kerja milik Feature itu.
Attachment tidak bersarang. Kredensial dilampirkan di samping Feature, pada komponen yang sama, dengan nama yang dideklarasikan oleh slot Feature; nama slot itulah yang mengaitkan keduanya. Feature penjaga dan komponen di bawah ini adalah entitas milik ruang kerja itu sendiri; core/referenced-secret berasal dari pustaka standar.
# The Feature declares the slotkind: Featuremetadata: name: local/guardspec: appliesTo: "component.aggrega.ai/type in (server, worker)" featuresSchema: guard_api_key: selector: "feature.aggrega.ai/kind=secret" sensitive: true inject: [env]---# The Aggregate fills it beside the Featurespec: components: finance-agent: type: local/compute/guarded-worker features: ai-guard: type: local/guard guard_api_key: type: core/referenced-secret values: origin: dev-guard-key-change-me key: api-keyFeatureRecipe milik penjaga merender beban kerja yang kontainernya mereferensikan slot tersebut, attachments: { GUARD_API_KEY: { from: guard_api_key, as: env } }, sehingga referensi itu ditempatkan pada kontainer penjaga dan tidak pada kontainer lain. Recipe milik komponen host tidak dapat mereferensikan slot tersebut, karena slot itu milik Feature: beban kerja yang mencoba menjangkaunya menghentikan build dengan menyebut slot tersebut. Entri beban kerja yang menyebut slot yang tidak diisi oleh apa pun juga menghentikan build, karena tidak ada lokator terpublikasi yang dapat di-resolve.
Hal yang sama berlaku untuk koneksi yang dibuat oleh sebuah Feature: koneksi di dalam blok uses: milik Feature sendiri tidak membawa attachment, sehingga kredensial yang diperlukan oleh koneksi semacam itu merupakan slot yang dideklarasikan oleh Feature, yang diisi di samping Feature.
Kredensial milik koneksi sendiri
Sebuah gateway yang menjangkau dua model dapat menyajikan kunci yang berbeda ke masing-masing model, atau kunci ke satu model dan tidak ada kunci ke model lainnya. Slot pada gateway menampung satu kredensial untuk seluruh komponen, sehingga kredensial ditempatkan pada koneksi sebagai gantinya: socket gateway mendeklarasikan slot yang boleh diisi oleh setiap koneksi yang melaluinya, dan setiap koneksi mengisinya, atau tidak, secara mandiri.
spec: components: router: type: core/gateway/litellm uses: models: gpt: target: gpt features: credential: # a slot the models socket declares type: core/referenced-secret values: key: api-keyRecipe milik gateway membaca attachment dari koneksinya, di .context.uses.gpt.features.credential, sehingga gateway yang menjangkau beberapa model membaca kunci milik setiap model; core/gateway/litellm mengirimkan masing-masing sebagai variabel tersendiri, yang disebut oleh entri koneksi dalam tabel peruteannya. Attachment dengan nama yang slotnya tidak dideklarasikan oleh socket menghentikan build, dengan menyebut slot yang memang dideklarasikan socket tersebut. Manifest dapat mewujudkan kredensial satu koneksi secara berbeda dari yang lain, dengan kunci <connection>.credential di tingkat per-instans miliknya. Kredensial pada koneksi — satu kunci per koneksi, dan satu kunci di kedua ujung membangun hal ini; sebuah Release juga dapat menghubungkan koneksi semacam itu dan menyebut rahasianya di infra milik attachment, sebagaimana dijelaskan dalam Features kredensial.