Tek geliştirici niyeti, iki kimlik bilgisi teslim biçimi
Bir kimlik bilgisinin çalışan bir konteynere nasıl ulaştığı uygulamanın değil, nereye dağıttığınızın bir özelliğidir. Bir kümede gizli bilgi deposu yoktur; bu nedenle dağıtım, materyalin kendisini bir Kubernetes Secret içinde taşır. Bir diğeri bir gizli bilgi deposu operatörü çalıştırır; bu nedenle dağıtım yalnızca bir işaretçi taşır ve küme materyali uzlaştırma (reconcile) sırasında getirir.
Bu çalışma alanı bir Aggregate içerir ve onu iki hedef için derler. Aggregate bu hedefler arasında değişmez. Veritabanının parolasına yaptığı başvuru da değişmez. Değişen, bir Manifest içindeki tek bir satırdır.
Ne değişir, ne sabit tutulur
| dosya | yerel hedef | depo hedefi |
|---|---|---|
aggregate.yaml | aynı dosya | aynı dosya |
| Manifest | manifest-local.yaml | manifest-store.yaml |
| Release | release-local.yaml | release-store.yaml |
İki Manifest yalnızca kendi adlarında ve tek bir eşleme girdisinde farklılık gösterir:
$ diff manifest-local.yaml manifest-store.yaml7c7< name: credential-shape-local-manifest---> name: credential-shape-store-manifest16c16< core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0---> core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0İki Release yalnızca kendi adlarında ve hangi Manifest’i gösterdiklerinde farklılık gösterir:
$ diff release-local.yaml release-store.yaml7c7< name: credential-shape-local---> name: credential-shape-store12c12< manifest: credential-shape-local-manifest---> manifest: credential-shape-store-manifestHer iki Releases de aynı environment değerini bildirir. Bu bilinçlidir: ortam adı, oluşturulan her belgeye bir etiket olarak işlenir; bu nedenle onu sabit tutmak, değişebilecek tam olarak tek bir şey bırakır: Manifest’in bağladığı FeatureRecipe. Gerçek bir Releases çifti elbette kendi ortamlarını adlandırır ve kimlik bilgisi biçimleri tam olarak aynı şekilde farklılaşır.
Geliştiricinin tarafı, bir kez
aggregate.yaml, PostgreSQL Component’inin her iki kimlik bilgisi yuvasını aynı başvurulabilir kimlik bilgisi Feature’ı ile doldurur:
features: password: type: core/referenced-secret values: key: POSTGRES_PASSWORD origin: postgres-superuser-password app_user_password: type: core/referenced-secret values: key: APP_USER_PASSWORD origin: postgres-app-passwordcore/referenced-secret, FeatureRecipe’inin çıktısının oluşturduğu ya da zaten var olan bir gizli bilgi kaynağını adlandırır ve o kaynağın konum belirleyicisini (name değerini ve içindeki veri key değerini) provides sözleşmesi aracılığıyla yayımlar. Tüketen Recipe bu konum belirleyiciyi okur. Hiçbir zaman kendi kaynak adını türetmez ve onu hangi FeatureRecipe’in ürettiğini hiçbir zaman sormaz.
Her hedef ne üretir
Her derleme altı dosya yazar. Bunlardan dördü (StatefulSet, her iki Service ve başlatma ConfigMap’i) her iki hedeften bayt düzeyinde aynı çıkar. Diğer ikisi, doldurulan her yuva için bir tane olmak üzere kimlik bilgisi kaynaklarıdır ve hedeflerin farklılaştığı yer bunlardır.
Yerel hedef, k8s-secret-from-parameter kaynağından,
dist/helm/helm/db--password--db-secret-db-password.yaml konumunda:
apiVersion: v1kind: Secretmetadata: name: db-password [… omitted: the labels and annotations naming the aggregate, component, environment, compiler and provider versions, boundary and Recipe — the same set every rendered document carries]stringData: POSTGRES_PASSWORD: "postgres-superuser-password"Depo hedefi, k8s-external-secret kaynağından,
dist/helm/helm/db--password--db-externalsecret-db-password.yaml konumunda:
apiVersion: external-secrets.io/v1kind: ExternalSecretmetadata: name: db-password [… omitted: the same label and annotation set as above]spec: refreshInterval: "1h" secretStoreRef: name: platform-secret-store kind: ClusterSecretStore target: name: db-password creationPolicy: Owner data: - secretKey: POSTGRES_PASSWORD remoteRef: key: "postgres-superuser-password"Farklı API grubu, farklı tür, farklı gövde. Yerel hedefte kimlik bilgisi materyali oluşturulan belgededir ve dağıtımı okuyabilen herkes tarafından okunabilir; bu biçimin üretim kümesinden çok yerel ve geliştirme kümelerine uygun olmasının nedeni budur. Depo hedefinde oluşturulan belge yalnızca girdi adını taşır; materyal depoda kalır ve operatör onu db-password adlı bir Secret’a uzlaştırır.
İki çıktı ağacını karşılaştırmak farkı ve farkın nerede bittiğini gösterir (local/ ve store/ dizinlerini üreten komutlar aşağıdaki Derleme bölümündedir):
$ diff -r local storeOnly in store/helm/helm: db--app-zuuser-zupassword--db-externalsecret-db-app-user-password.yamlOnly in local/helm/helm: db--app-zuuser-zupassword--db-secret-db-app-user-password.yamlOnly in store/helm/helm: db--password--db-externalsecret-db-password.yamlOnly in local/helm/helm: db--password--db-secret-db-password.yamlDört satır, hepsi tek bir dizinde; çünkü bu hedefte bir ekin dosyaları bir alt dizinde değil, bileşenin kendi dosyalarının yanında yer alır. İki koordinatı taşıyan dosya adıdır: db--password--, db üzerindeki password ekidir; db--app-zuuser-zupassword-- ise app_user_password ekidir. Alt çizgi -zu olarak kodlanır, çünkü burada koordinat ile dosyanın kendi adı tek bir dizeyi paylaşır.
Dört satır ve başka hiçbir şey: iki kimlik bilgisi kaynağı yalnızca yerel hedefin ağacında, ikisi yalnızca depo hedefinin ağacında bulunur. diff -r, iki ağacın paylaştığı hiçbir dosyada içerik farkı bildirmez; dolayısıyla dört ortak belge yalnızca benzer değil, aynıdır.
Değişmeyen başvuru
Veritabanı konteyneri her iki kimlik bilgisini de bir secretKeyRef ile desteklenen ortam değişkenleri olarak okur. Bu blok her iki hedefte bayt düzeyinde aynıdır:
- name: POSTGRES_PASSWORD valueFrom: secretKeyRef: name: db-password key: POSTGRES_PASSWORD- name: APP_USER_PASSWORD valueFrom: secretKeyRef: name: db-app-user-password key: APP_USER_PASSWORDAynıdır, çünkü tüketen Recipe dallanmaz. Yuvadan yayımlanmış name ve key değerlerini ister ve bunları yazar. Her iki FeatureRecipe de aynı iki anahtarı yayımlar, çünkü Feature bunları bildirir; bu nedenle ikisinden herhangi biri tüketiciyi karşılar. Depo hedefinde ise başvuru, operatör ExternalSecret’ı bu ad altında bir Secret’a uzlaştırdığında çözümlenir.
İki biçimi birbirinin yerine kullanılabilir kılan bu değişmezliktir. Tüketen taraf Secret adını kendisi türetmiş olsaydı, bağlamayı değiştirmek onu artık o ad altında var olmayan bir kaynağa işaret eder durumda bırakırdı.
origin, FeatureRecipe’in ona verdiği anlama gelir
core/referenced-secret, origin alanını materyalin geldiği yer olarak bildirir ve yorumunu FeatureRecipe’e bırakır:
k8s-secret-from-parameteronu materyal olarak Secret’a yazar.k8s-external-secretonu depodan getirilecek anahtar olarak okur.
Derleyici dizeyi değiştirmeden aktarır; belirli bir dizenin bunlardan hangisi olduğundan bağımsızdır. Tek bir ekin, geliştiricinin tarafında hiçbir düzenleme yapılmadan her iki biçime de hizmet etmesini sağlayan budur; ve bir bağlamayı değiştirmeden önce denetlenmesi gereken şey de budur, çünkü yazılan aynı dize, onu okuyan FeatureRecipe hangisiyse ona anlamlı gelmelidir.
Yayımlanan ad ve bir yuva adındaki alt çizgi
Component, ikinci kimlik bilgisi yuvasını app_user_password olarak adlandırır. Bir Kubernetes nesne adı alt çizgi içeremez; bu nedenle yayımlanan provides.name alt çizgileri kısa çizgiye dönüştürür ve kaynak db-app-user-password olarak oluşur:
- name: APP_USER_PASSWORD valueFrom: secretKeyRef: name: db-app-user-passwordHer iki FeatureRecipe de aynı şekilde normalleştirir; bağlamayı değiştirmenin tüketicinin başvurusunu değiştirmemesinin nedeni budur. Ad, üreten tarafta bir kez yayımlanır; üretilen kaynak da tüketicinin başvurusu da bu tek yayımlanmış değerden çözümlenir.
Depo hedefinin kümeden beklentileri
ExternalSecret özel bir kaynaktır. Depo hedefinin çıktısını bir kümeye uygulamak için orada bir gizli bilgi deposu operatörünün çalışıyor olması ve platform-secret-store adlı bir ClusterSecretStore bulunması gerekir. Bu çalışma alanındaki hiçbir şey bunlardan herhangi birini kurmaz: örnek, böyle bir kümenin tükettiği şeyi oluşturur ve biçimin nasıl seçildiğini öğretir.
Bir kümenin hangi depoyu hangi ad altında çalıştırdığı uygulamanın değil, hedefin bir özelliğidir; bu nedenle k8s-external-secret bunun için bir yazım anahtarı taşımaz. Deposu farklı adlandırılmış bir kümeye, o depoyu adlandıran bir FeatureRecipe hizmet eder.
Ö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-shape-per-targetArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd credential-shape-per-targetDerleme
aggrega build --release release-local.yaml --auto-pullaggrega build --release release-store.yaml --auto-pull--auto-pull, ilk derlemede kataloğu Release’in yanındaki bir kilit dosyasına çözümler; aynı Release’in sonraki derlemeleri bayrak gerektirmez.
Her iki hedef de dist/ dizinine yazar ve aggrega build onu temizlemez; bu nedenle ikisini karşılaştırmak için her çalıştırmanın çıktısını ayrı tutun:
out=$(mktemp -d)rm -rf dist && aggrega build --release release-local.yaml --auto-pull && cp -r dist "$out/local"rm -rf dist && aggrega build --release release-store.yaml --auto-pull && cp -r dist "$out/store"( cd "$out" && diff -r local store )Her hedefin belirlenimci biçimde oluşturduğunu doğrulamak için --verify-determinism ekleyin: her düğüm iki kez oluşturulur ve herhangi bir düğümün iki çıktısı farklıysa derleme durur.
aggrega build --release release-local.yaml --verify-determinismaggrega build --release release-store.yaml --verify-determinismBir 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-shape-per-target` klasörü yoksa `scaffold` aracını `example` değeri `credential-shape-per-target` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `credential-shape-per-target` klasörüne yazar. Ardından `build` aracını her Release için bir kez, şu sırayla çağırın — `release-local.yaml`, `release-store.yaml` — her seferinde `workspace_root` değeri `credential-shape-per-target`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde. Her derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `credential-shape-per-target/dist/` altındadır.Dosyalar
aggregate.yaml— geliştirici niyeti:core/datastore/postgrestüründe tek birdbbileşeni; her iki kimlik bilgisi yuvasıcore/referenced-secretile doldurulmuştur. Her iki Release tarafından da değiştirilmeden kullanılır.manifest-local.yaml—core/referenced-secretöğesini, yazılan materyalden bir Kubernetes Secret oluşturank8s-secret-from-parameteröğesine bağlar.manifest-store.yaml— aynı Feature’ı, depo girdisini adlandıran bir ExternalSecret oluşturank8s-external-secretöğesine bağlar. Kendi adı ve o tek satır dışındamanifest-local.yamlile aynıdır.release-local.yaml,release-store.yaml— iki Release. Kendi adları ve her birinin hangi Manifest’i gösterdiği dışında aynıdır..aggrega-config.yaml— katalog varlıklarının çözümlendiği hub kayıt defterini adlandırır.
Buradaki origin değerleri yer tutuculardır. Herhangi bir gerçek hizmet için kimlik bilgisi değildirler ve yerel hedefte her ikisi de çıktıya açık metin olarak yazılır.