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

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:

Terminal window
aggrega scaffold --example credential-secretkeyref

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd credential-secretkeyref

Build

Contoh ini memiliki tiga release. Bangun satu per eksekusi:

Terminal window
aggrega build --release release-helm.yaml --auto-pull
aggrega build --release release-compose.yaml --auto-pull
aggrega 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.

Terminal window
aggrega build --release release-helm.yaml --auto-pull

Secret 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:

db--password--db-secret-db-password.yaml
[… 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 key

Compose — 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.

Terminal window
aggrega build --release release-compose.yaml --auto-pull
# dist/compose/compose/docker-compose.yaml → POSTGRES_PASSWORD: dev-pw-change-me

Negatif — 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:

Terminal window
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.