Kimlik bilgisi teslimi — uçtan uca `secretKeyRef`
Parolası kimlik bilgisi alt sistemi tarafından sağlanan tek bir PostgreSQL veritabanı, her provider için ayrı gösterilmiştir. core/datastore/postgres üzerindeki aynı password yuvası her iki kimlik bilgisi ailesini de kabul eder; geliştiricinin bağladığı aile parolanın nasıl teslim edileceğini belirler ve veritabanı Recipe’i yuvayı kendi provider’ının desteklediği şekilde okur.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example credential-secretkeyrefArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd credential-secretkeyrefDerleme
Bu örnekte üç release vardır. Her çalıştırmada birini derleyin:
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)Her release, katalog varlıklarını bu çalışma alanının .aggrega-config.yaml dosyası üzerinden, bu dosyanın varsayılan olarak adlandırdığı hub kayıt defterinden çözümler; bu nedenle --catalog bayrağına gerek yoktur ve --auto-pull, yeni bir klonda eksik olan kilit dosyasını derleme sırasında yazar.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `credential-secretkeyref` klasörü yoksa `scaffold` aracını `example` değeri `credential-secretkeyref` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `credential-secretkeyref` klasörüne yazar. Ardından `build` aracını her Release için bir kez, şu sırayla çağırın — `release-helm.yaml`, `release-compose.yaml` — her seferinde `workspace_root` değeri `credential-secretkeyref`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde. Ardından `build` aracını aynı şekilde, `release` değeri `release-negative.yaml` olacak biçimde çağırın: bu derlemenin reddedilmesi amaçlanmıştır, bu yüzden ret mesajını bana okuyun. Her derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `credential-secretkeyref/dist/` altındadır.Helm — başvurulabilir bir Secret + secretKeyRef
aggregate-helm.yaml, core/referenced-secret öğesini password yuvasına bağlar. Manifest bunu k8s-secret-from-parameter ile eşler; bu da bir Kubernetes Secret oluşturur ve Secret’ın kimliğini provides {name, key} olarak yayımlar. Postgres helm Recipe’i yuvaya containers.attachments aracılığıyla başvurur ve sentezleyici bunu bir env secretKeyRef olarak işler.
aggrega build --release release-helm.yaml --auto-pullÜretilen Secret (dist/helm/helm/db--password--db-secret-db-password.yaml) ve veritabanının secretKeyRef değeri (dist/helm/helm/db-statefulset.yaml) aynı kaynağı adlandırır, çünkü ikisi de .features.password.provides.name değerini okur — yeniden türetme yoktur ve iki tarafın üzerinde anlaşması gereken bir uzlaşım yoktur:
[… 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 — inject-value kimlik bilgisi
aggregate-compose.yaml, core/secret-value öğesini bağlar. Compose’da Secret kaynağı / secretKeyRef temel öğesi yoktur, bu nedenle Manifest kimlik bilgisini dotenv-secret ile eşler; bu da değeri inject hattı üzerinden, bağlamanın values.key içinde adlandırdığı anahtar altında, burada POSTGRES_PASSWORD, teslim eder ve postgres compose Recipe’i onu bu anahtar altında okur.
aggrega build --release release-compose.yaml --auto-pull# dist/compose/compose/docker-compose.yaml → POSTGRES_PASSWORD: dev-pw-change-meNegatif — başvurulamayan bir dolgunun bir başvurudan reddedilmesi
aggregate-negative.yaml, inject-value core/secret-value öğesini password yuvasına bağlar, ardından helm üzerinde derler; burada postgres Recipe’i yuvaya containers.attachments (bir secretKeyRef) aracılığıyla başvurur. Bir secretKeyRef, işaret edeceği bir Secret kaynağına ihtiyaç duyar, ancak inject-value kimlik bilgisi hiçbir kaynak yayımlamaz — bu nedenle derleme açıkça durur:
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]Bu release’in başarısız olması beklenir — ders durmanın kendisidir. Derleme, başarı bildirmek yerine 1 ile çıkar; böylece koruma mekanizması okuyucu ve onu çalıştıran herhangi bir betik tarafından görülebilir.
İki çözüm vardır. aggregate-helm.yaml dosyasında olduğu gibi başvurulabilir bir kimlik bilgisi (core/referenced-secret) bağlayın; ya da core/secret-value ekini koruyun ve onu Manifest içinde k8s-secret-from-value’ya eşleyin; bu, core/secret-value’nun, değeri ürettiği bir Secret’e yazan ve o Secret’in adını ve anahtarını yayımlayan Helm gerçekleştirmesidir; böylece başvurunun işaret edeceği bir kaynak olur. env-secret’e bağlandığında ise inject-value kimlik bilgisi konteynere hiçbir zaman bir containers.attachments başvurusuyla değil, inject hattı üzerinden ulaşır.