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

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:

Terminal window
aggrega scaffold --example advanced-platform

Kemudian ia mencetak perintah yang dijalankan berikutnya:

Terminal window
cd advanced-platform
aggrega pull --release release.yaml
aggrega build --release release.yaml

Daftar periksa pengiriman secret

Sebuah kredensial melewati enam permukaan sebelum mencapai kontainer yang sedang berjalan. Berikut titik sentuh yang perlu diperiksa saat menghubungkan kredensial baru:

LangkahPermukaanTindakan
1Component 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.
2Feature 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.
3Aggregate 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.
4FeatureRecipeWujudkan untuk target: tulis nilai di tempat komponen membacanya, render sumber daya yang menyimpannya, atau render sumber daya yang mengambilnya dari penyimpanan rahasia.
5Manifest mappings.features.typeIkat Feature kredensial ke FeatureRecipe-nya, di tingkat yang sama dengan setiap Feature lainnya.
6RecipeBaca, 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: value

root_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 slot
kind: Feature
metadata:
name: local/guard
spec:
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 Feature
spec:
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-key

FeatureRecipe 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-key

Recipe 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.