Pengiriman kredensial — `secretKeyRef` secara menyeluruh
Satu basis data PostgreSQL yang kata sandinya disediakan oleh subsistem
kredensial, ditampilkan per provider. Slot password yang sama pada
core/datastore/postgres menerima salah satu dari kedua keluarga kredensial; keluarga yang
dilampirkan pengembang menentukan cara kata sandi dikirimkan, dan Recipe
basis data membaca slot tersebut dengan cara yang didukung provider-nya.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example credential-secretkeyrefKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd credential-secretkeyrefBuild
Contoh ini memiliki tiga release. Bangun satu per eksekusi:
aggrega build --release release-helm.yaml --auto-pullaggrega build --release release-compose.yaml --auto-pullaggrega build --release release-negative.yaml --auto-pull # expected to fail (see below)Setiap release me-resolve entitas katalognya melalui .aggrega-config.yaml milik workspace ini, dari registry hub yang disebutnya sebagai default, sehingga flag --catalog tidak diperlukan, dan --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `credential-secretkeyref`, panggil alat `scaffold` sekali dengan `example` diatur ke `credential-secretkeyref` dan tanpa `dir`: alat ini menulis contoh ke dalam folder `credential-secretkeyref` yang baru. Lalu panggil alat `build` sekali untuk setiap Release, dengan urutan ini — `release-helm.yaml`, `release-compose.yaml` — setiap kali dengan `workspace_root` diatur ke `credential-secretkeyref`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `write` diatur ke true. Lalu panggil alat `build` dengan cara yang sama dengan `release` diatur ke `release-negative.yaml`: build ini memang dimaksudkan untuk ditolak, jadi bacakan penolakannya kepada saya. Beri tahu saya file mana yang ditulis oleh setiap build; file tersebut berada di bawah `credential-secretkeyref/dist/`.Helm — Secret yang dapat direferensikan + secretKeyRef
aggregate-helm.yaml melampirkan core/referenced-secret ke slot password.
Manifest memetakannya ke k8s-secret-from-parameter, yang mewujudkan sebuah
Secret Kubernetes dan memublikasikan identitas Secret tersebut sebagai provides {name, key}.
Recipe helm postgres mereferensikan slot tersebut melalui containers.attachments, yang
dirender oleh synthesizer sebagai env secretKeyRef.
aggrega build --release release-helm.yaml --auto-pullSecret yang dihasilkan (dist/helm/helm/db--password--db-secret-db-password.yaml) dan
secretKeyRef milik basis data (dist/helm/helm/db-statefulset.yaml) menamai resource yang sama,
karena keduanya membaca .features.password.provides.name — tidak ada
penurunan ulang dan tidak ada konvensi yang perlu disepakati kedua sisi:
[… omitted: the apiVersion and the Secret kind]metadata: name: db-password [… omitted: the labels and annotations every rendered document carries]stringData: POSTGRES_PASSWORD: "dev-pw-change-me"
# db-statefulset.yaml (container env)- name: POSTGRES_PASSWORD valueFrom: secretKeyRef: name: db-password # == the Secret's metadata.name key: POSTGRES_PASSWORD # == the Secret's data keyCompose — kredensial inject-value
aggregate-compose.yaml melampirkan core/secret-value. Compose tidak memiliki primitif Secret-resource / secretKeyRef, sehingga Manifest memetakan kredensial ke dotenv-secret, yang mengirimkan nilainya melalui pipa inject di bawah kunci yang disebut lampiran dalam values.key, di sini POSTGRES_PASSWORD, dan Recipe compose postgres membacanya di bawah kunci itu.
aggrega build --release release-compose.yaml --auto-pull# dist/compose/compose/docker-compose.yaml → POSTGRES_PASSWORD: dev-pw-change-meNegatif — pengisian yang tidak dapat direferensikan ditolak dari sebuah referensi
aggregate-negative.yaml melampirkan core/secret-value jenis inject-value ke slot
password, lalu melakukan build pada helm, tempat Recipe postgres mereferensikan
slot tersebut melalui containers.attachments (sebuah secretKeyRef). Sebuah secretKeyRef memerlukan resource
Secret untuk dirujuk, tetapi kredensial inject-value tidak memublikasikannya — sehingga build
berhenti secara eksplisit:
aggrega build --release release-negative.yaml --auto-pull# [… omitted: the pull's lines, which carry the same halt, and two lint notices]# [CATALOG_ERROR E0212] instance db# rendering node "db"# [… omitted: the cause, "workload attachment slot is not referenceable", naming the Recipe and its path in your catalog, then one line each for the "name" and the "key" the slot's provides does not expose]Release ini memang diharapkan gagal — penghentian itulah pelajarannya. Build keluar dengan 1 alih-alih melaporkan keberhasilan, sehingga pengaman ini terlihat oleh pembaca dan oleh skrip mana pun yang menjalankannya.
Ada dua perbaikan. Lampirkan kredensial yang dapat direferensikan (core/referenced-secret), seperti pada aggregate-helm.yaml; atau pertahankan lampiran core/secret-value dan petakan di Manifest ke k8s-secret-from-value, realisasi Helm dari core/secret-value yang menulis nilai ke dalam Secret yang dihasilkannya dan memublikasikan nama dan kunci Secret tersebut, sehingga referensi memiliki sumber daya untuk ditunjuk. Jika diikat ke env-secret, kredensial inject-value justru mencapai container melalui pipa inject, tidak pernah melalui referensi containers.attachments.