İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

dosyayerel hedefdepo hedefi
aggregate.yamlaynı dosyaaynı dosya
Manifestmanifest-local.yamlmanifest-store.yaml
Releaserelease-local.yamlrelease-store.yaml

İki Manifest yalnızca kendi adlarında ve tek bir eşleme girdisinde farklılık gösterir:

Terminal window
$ diff manifest-local.yaml manifest-store.yaml
7c7
< name: credential-shape-local-manifest
---
> name: credential-shape-store-manifest
16c16
< 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:

Terminal window
$ diff release-local.yaml release-store.yaml
7c7
< name: credential-shape-local
---
> name: credential-shape-store
12c12
< manifest: credential-shape-local-manifest
---
> manifest: credential-shape-store-manifest

Her 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-password

core/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: v1
kind: Secret
metadata:
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/v1
kind: ExternalSecret
metadata:
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):

Terminal window
$ diff -r local store
Only in store/helm/helm: db--app-zuuser-zupassword--db-externalsecret-db-app-user-password.yaml
Only in local/helm/helm: db--app-zuuser-zupassword--db-secret-db-app-user-password.yaml
Only in store/helm/helm: db--password--db-externalsecret-db-password.yaml
Only in local/helm/helm: db--password--db-secret-db-password.yaml

Dö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_PASSWORD

Aynı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-parameter onu materyal olarak Secret’a yazar.
  • k8s-external-secret onu 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-password

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

Terminal window
aggrega scaffold --example credential-shape-per-target

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd credential-shape-per-target

Derleme

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

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

Terminal window
aggrega build --release release-local.yaml --verify-determinism
aggrega build --release release-store.yaml --verify-determinism

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-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/postgres türünde tek bir db bileşeni; her iki kimlik bilgisi yuvası core/referenced-secret ile 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şturan k8s-secret-from-parameter öğesine bağlar.
  • manifest-store.yaml — aynı Feature’ı, depo girdisini adlandıran bir ExternalSecret oluşturan k8s-external-secret öğesine bağlar. Kendi adı ve o tek satır dışında manifest-local.yaml ile 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.