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

Çıktı bileşimi

Tek bir Aggrega derlemesi, dist/ altındaki sınır başına dizinlere altı ayrı mekanizma aracılığıyla çıktı dosyaları üretir: kaynaklı işleme, workload sentezi, FeatureRecipe kaynak üretimi, FeatureRecipe plugin hattı yamaları, Release düzeyinde bileşim ve doğrudan yapıt yayımı. Mekanizmalar tanımlı bir sırayla çalışır; iki mekanizma aynı sınır dizininde aynı ada sahip bir dosya ürettiğinde çıktılar deterministik olarak çakışır; bir çakışma algılandığında derleme, yayımdan önce, çakışma kuralının adlandırdığı kategori altında her katkıda bulunanı adlandırarak durur.

Bu sayfa altı mekanizmayı tek bir yerde belgeler ve aralarındaki işleme sırasını adlandırır. Bölüm başına ve varlık başına başvurular kendi yüzeylerini kapsar; altısının tümüne ilişkin çakışma algılama kuralları ise burada yer alır.

Çıktı üreten altı mekanizma

Her mekanizma belirli bir Recipe / FeatureRecipe yazım yüzeyinde yer alır ve dosyaları belirli adlandırma uzlaşımlarıyla üretir. Mekanizmalar düğüm başına birikir: tek bir bileşen örneği aynı anda birden çok mekanizmayı çalıştırabilir (kaynaklı bir temel Recipe + Workload ile sentezlenmiş eşlik eden bir dosya + FeatureRecipe tarafından üretilmiş bir ExternalSecret CRD’si + sentezlenmiş Deployment’a uygulanan bir plugin hattı yaması).

1 — Recipe kaynaklı işleme (source: + valuesMapping:)

Yazım yüzeyi. Recipe, source: <path> ile birlikte valuesMapping: bildirir (alan satır içi Go şablonu, dosya $import:’u ya da bir MappingLibrary girdisine kütüphane $import:’u kabul eder; bkz. entities/recipe.md “The valuesMapping field — three authoring modes”). Kaynak, diskteki bir Helm chart’ını, bir docker-compose YAML dosyasını ya da sağlayıcıya özgü başka bir yapıtı gösterir.

Hattaki yeri. Temel işleme; Recipe’nin locals ve provides değerleri çözümlendikten sonra.

Çıktı biçimi. Provider’a özgü:

  • helm sağlayıcısı — önce bileşen kimliğine, ardından kaynağın kendisine göre adlandırılan düz Kubernetes YAML dosyaları: <component-id>-<kind>[-<namespace>]-<name>.yaml; kind ya da name taşımayan bir belge ise bunun yerine şablon yoluna göre adlandırılır. Ad şablondan değil kaynaktan geldiği için, farklı alt dizinlerde aynı dosya adını paylaşan iki şablon iki ayrı dosya olarak kalır. Helm SDK, chart’ı birleştirilmiş değerlerle işler; Aggrega, köken etiketlerini ve açıklamalarını işlemeden sonra ekler.
  • helm-chart sağlayıcısı — charts/<instance_id>/ altına kopyalanan alt chart dosyaları; chart’ın kendi name değeri dışında olduğu gibi kopyalanır. Şemsiye chart bu değeri örneğin kodlanmış kimliğine ayarlar; böylece aynı adı bildiren chart’ları içeren iki bileşen birbirinden ayırt edilebilir kalır (bkz. providers/helm-chart.md); bunların yanında sınır başına bir şemsiye Chart.yaml + values.yaml üretilir.
  • compose sağlayıcısı — Release düzeyinde birleştirmeye (mekanizma 5) akan ara <nodeID>.compose-fragment.yaml dosyaları.

2 — Recipe Workload sentezi (workload:)

Yazım yüzeyi. Recipe, bir Workload belgesi taşıyan workload: bildirir. Alan, satır içi içerik (blok skaler) ya da $import: (dosya yolu) kabul eder.

Hattaki yeri. Temel işleme; Recipe’nin valuesMapping değeri çözümlendikten sonra (Workload gövdesinin kendisi, tam şablon bağlamıyla değerlendirilen Go şablonlu bir dizedir).

Çıktı biçimi. Provider’a özgü:

  • helm sağlayıcısı — Workload’un form değerine göre seçilen bir denetleyici nesnesi (stateless için Deployment, stateful için StatefulSet, daemon için DaemonSet, task için Job, scheduled için CronJob) + hizmet başına Service + her persistent birim için bir PVC. İki adlandırma biçimi vardır ve bunlar aynı değildir: denetleyici nesnesi düğümün release adına ve kind’ına göre adlandırılır — <release name>-deployment.yaml, <release name>-statefulset.yaml, <release name>-daemonset.yaml, <release name>-job.yaml, <release name>-cronjob.yaml — kaynak başına bir dosya ise taşıdığı kaynağa göre, kind en sonda olacak şekilde adlandırılır: <release name>-<svcName>-service.yaml ve <release name>-<volName>-pvc.yaml; çünkü her biri o kaynağın kendi metadata.name değerinden adlandırılır. Release adı, düğümün kimliğinin bir Kubernetes adının kabul ettiği alfabeyle yazılmış hâlidir; bu nedenle düğüm kimliği alt çizgi ve büyük harf içermediği her yerde onunla aynıdır: my_api düğümü my-zuapi-deployment.yaml yazar (bkz. entities/workload.md “Synthesized-name convention”). Tek erişime açılma biçimi harici bir ad olan bir Workload, taşınacak hizmet anahtarı olmadığından bunun yerine <release name>-service.yaml üretir.
  • compose sağlayıcısı — Release düzeyinde birleştirmeye akan ara <nodeID>.compose-fragment.yaml dosyaları.
  • helm-chart sağlayıcısı — desteklenmez; helm-chart’ın rolü yalnızca kaynaklı kipte chart birleştirmedir. helm-chart’ı hedefleyen ve workload: içeren bir Recipe işleme sırasında reddedilir (helm-chart sağlayıcısı sentez yeteneği bildirmez).

3 — FeatureRecipe kaynak üretimi (FeatureRecipes için kaynaklı kip)

Yazım yüzeyi. FeatureRecipe, source: ile birlikte valuesMapping: (ya da eşdeğerini) bildirir; Recipe kaynaklı işlemeyle aynı kalıptır, ancak birincil Components yerine Feature eklentileri içindir.

Hattaki yeri. Temel işleme; üst Component için yapılan temel Recipe işlemesiyle birlikte. Her Feature eklentisi kendi FeatureRecipe işleme geçişini çalıştırır.

Çıktı biçimi. Üst Component’in sağlayıcısı belirler, çünkü eklentinin çıktısı kendine ait bir gruba değil, o Component’in derleme grubuna katılır; ve bu, o sağlayıcının grubu nasıl birleştirdiğinden çıkar, çünkü bir eklentinin konabileceği bir yer olup olmadığını söyleyen budur. Her birleştirme yolu için bir tane olmak üzere üç biçim vardır:

  • Her katkıda bulunana kendine ait bir konum veren bir sağlayıcı — katkıda bulunan başına bir chart tutan tek bir chart, katkıda bulunan başına bir modül tutan tek bir kök yapılandırma — bir eklentiye de kendine ait bir konum verir; bu konum eklendiği bileşenin içinde değil, yanındadır. İki koordinat, o konumun tek dizin bölümünü oluşturur: <component-id>--<feature-instance-id>; böylece aux eklentisini taşıyan bir api bileşeni, o sağlayıcının katkıda bulunanları için belirlediği dizin hangisiyse onun altında, api’nin yanında api--aux olarak yer alır. İçinde değil yanında, çünkü böyle bir sağlayıcının hedefi katkıda bulunanlarını onlara verdiği konumlarda keşfeder: bu konumlardan birinin bir düzey altındaki bir dizin, kendi başına bir katkıda bulunan değil, o katkıda bulunana ait içeriktir; bu yüzden hiçbir şey onu adreslemez ve okumaz. Sınır üzerinde bildirilen bir eklentinin adlandırılacak bir ana bileşeni yoktur; bu yüzden bölümü yalnızca örnek adından oluşur. Her koordinat, ikisi birleştirilmeden önce kodlanır; böylece kendisi birleştirme dizisini içeren bir koordinat birleştirme yeri sanılamaz.
  • Her belgeyi doğrudan sınır dizinine yazan bir sağlayıcının böyle bir yeri yoktur, çünkü hedefi hakkında bildirdiği tam olarak budur: yalnızca doğrudan bir dizinde duran dosyalar okunur. Bu yüzden aynı iki koordinat dizin bölümlerinden çıkıp dosya adına geçer ve eklentinin dosyaları bileşenin kendi dosyalarının yanına <component-id>--<feature-instance-id>--<file> olarak yerleşir. Dosya adının başvurabileceği bir ayırıcı olmadığından iki koordinat kodlanır ve hiçbir kodlanmış koordinatın içeremeyeceği iki karakterlik bir sınırda dosyanın kendi adıyla birleştirilir; aynı dosya adını üreten iki eklentiyi iki ayrı dosyada tutan da budur.
  • Grubunun katkıda bulunanlarını tek bir belgede birleştiren bir sağlayıcı, eklentinin çıktısını da o belgeye katar; orada her kaynak eklentinin kendi kimliğini taşır, böylece neyin nereden geldiği okunabilir kalır. Böyle bir sağlayıcı farklı bir hedef için işlenmiş bir eklenti taşıdığında, bu içerik ait olmadığı bir belgeye katılamaz; bu yüzden aynı nedenle yukarıdaki dosya adı öneki biçiminde, derlenen belgenin yanına yazılır.

Yaygın biçimler:

  • Bir kimlik bilgisi FeatureRecipe’sinin Fetcher’ı tarafından üretilen bir ExternalSecret / VaultSecret CRD’si.
  • Bir gözlemlenebilirlik Feature’ı tarafından üretilen bir ServiceMonitor / PrometheusRule CRD’si.
  • Bir yönlendirme Feature’ı tarafından üretilen bir HTTPRoute / Gateway CRD’si.

4 — FeatureRecipe plugin hattı (RFC 6902 yamaları + kaynak üretimi)

Yazım yüzeyi. FeatureRecipe, pipeline: bildirir — bir Wasm plugin adımları dizisi (İki Parçalı Plugin İlkesi: kimlik bilgisi Features için Fetcher + Injector; kimlik bilgisi dışındaki Features için rastgele plugin hatları).

Hattaki yeri. Temel işleme ve FeatureRecipe kaynaklı işleme tamamlandıktan sonra, plugin hattı.

Çıktı biçimi. Plugin’e özgü. Bir adım iki çıktı sınıfı döndürür:

  • Uygulama motorunun işlenmiş kümedeki hedeflenen belgelere uyguladığı RFC 6902 yamaları (ör. bir sidecar konteyneri eklemek, bir gizli birim bağlamak, sentezlenmiş Deployment üzerindeki bir ortam değişkenini yeniden yazmak).
  • Yan etkiler — bir adımın side_effects alanı aracılığıyla yamanın yanında üretilen tam yeni kaynaklar (genellikle Fetcher’ın, Injector’ın ardından başvurduğu vault-fetch CRD’si).

Bugünkü durum: Dilin durumu → Derleme hattı aşamaları uyarınca kullanılabilir. Bildirilen her adım aggrega build sırasında çalışır: ana sistem, adımın Wasm plugin’ini işlenmiş kümeye karşı çalıştırır, döndürülen yamaları uygular ve adımın yan etkilerini üretir. Plugin sözleşmesi yüzeyi için plugins/plugin-contract.md sayfasına bakın.

5 — Release düzeyinde birleştirme (sağlayıcı başına sınır birleştirmesi)

Yazım yüzeyi. Release biçimi tarafından yönlendirilir — Recipe başına yazım yoktur. Bir sınırı birleştiren bir yetenek bunu, o sınırdaki her düğüm işlendikten sonra bir kez yapar: compose yeteneği tüm düğüm başına parçaları sınır başına tek bir docker-compose.yaml dosyasında toplar, helm-chart yeteneği ise düğüm başına alt chart kopyalarını sınır başına tek bir şemsiye chart’ta toplar.

Hattaki yeri. Temel işlemeden sonra, her düğümün Recipe başına çıktısı sınır için biriktiğinde.

Çıktı biçimi. Sağlayıcıya göre:

  • compose sağlayıcısı — sınır kökünde, katkıda bulunan her düğümün servislerini, birimlerini ve ağlarını bir araya getiren tek bir docker-compose.yaml. Ara <nodeID>.compose-fragment.yaml dosyaları (mekanizma 1 + 2) tek çıktıda birleştirilir; parçalar son sınır dizininde görünmez.
  • helm-chart sağlayıcısı — sınır kökünde tek bir şemsiye Chart.yaml + values.yaml, ayrıca charts/<instance_id>/ altında düğüm başına alt chart dizinleri.

6 — Recipe doğrudan yapıt üretimi (artifacts:)

Yazım yüzeyi. Recipe, artifacts: alanını adlandırılmış girdilerden oluşan bir eşlem olarak bildirir; her girdi ya satır içi içeriktir (dosya gövdesini taşıyan şablonlu bir dize) ya da bir şablon dosyası yoluna $import: başvurusudur — bir sağlayıcıdan geçmeden doğrudan dosya üretimi.

Hattaki yeri. Temel işleme içinde, yapıt değerlendirmesi.

Çıktı biçimi. Yapıt girdisi başına bir dosya; adı, girdinin artifacts: eşlemindeki anahtarına göre verilir. Dosya adını ve içeriği doğrudan Recipe yazarı belirler.

Bugünkü durum: Dilin durumu → Recipe girdi türleri uyarınca kullanılabilir. Her girdi, iş yükü sentezi ve kaynak çözümlemesinden sonra tam şablon bağlamıyla değerlendirilir ve ortaya çıkan dosya girdinin anahtarı altında üretilir. Bir hedefin üretilen bir yapıtla ne yaptığı yeteneğe bağlıdır: bağımsız bir yapıtı kabul eden bir sağlayıcı onu kendi dosyası olarak üretir; yapıtları yalnızca başka bir girdi türüyle birlikte kabul eden bir sağlayıcı ise girdiyi birleştirdiği şeyin içine katar — bu nedenle o birleştiricinin beklediği biçimde olmayan bir gövde, olduğu gibi üretilmek yerine TRANSLATION_ERROR kategorisi altında durur. Bir yetenek için yapıt yazmadan önce architecture/16-recipe-input-composition.md adresindeki yetenek başına tabloyu inceleyin.

İşleme sırası

Altı mekanizma, aşağı akıştaki mekanizmaların yukarı akıştaki çıktıları okuyabilmesi için tanımlı bir sırayla çalışır. Sıra şöyledir:

  1. Provides değerlendirmesi — her düğüm için önce Recipe’in locals: bloğu, yazarın verdiği sırayla çözümlenir; her girdi kendisinden önceki girdileri okur. Ardından düğümün provides: şablonları kendi aralarında herhangi bir sırayla değerlendirilir (kendi içinde yeterli: .context.instance_id, düğümün provider’ı bildiriyorsa .context.rendered_name, .values, .infra, çözümlenmiş .locals, statik metin). Bir provides: girdisinin bir local’i okuyup çözümlenmiş bir değer almasını sağlayan, local’lerin provides’tan önce gelmesidir.
  2. Local’lerin yayımlanması ve kaynak çözümlemesi — bu local’ler .locals üzerine yayımlanır ve Recipe’in source: URI şablonu bunlara göre değerlendirilir (şablonluysa kaynak işaretçisi çözümlenir). Kaynak yüzeyi local bağlamını paylaşır; bu nedenle .provides’ı değil .locals’ı okur.
  3. Inject eşlemesi — FeatureRecipe injectMapping: blokları değerlendirilir (inject borusu, Recipe işlemesinden önce yakalanır).
  4. Değer eşlemesi — Recipe valuesMapping: değerlendirilir (kaynaklı mod ve kaynaksız mod değer sözlükleri üretir).
  5. Workload sentezi — Recipe Workload sentezi (mekanizma 2, sentezlenmiş mod için manifest’ler üretir).
  6. Artifact değerlendirmesi — Recipe artifacts: değerlendirmesi (mekanizma 6).
  7. Provider işlemesi — provider işler (mekanizma 1 — kaynaklı mod düz manifest’ler, kaynaksız mod üretken manifest’ler üretir).
  8. Feature işlemesi — düğümdeki her Feature eklentisi için FeatureRecipe işlemesi (mekanizma 3 + 4 — kaynak üretimi burada çalışır; plugin hattı daha sonra, 9. adımda çalışır).
  9. Plugin hattı — işleme sonrası değişiklik: FeatureRecipe pipeline: plugin adımları RFC 6902 yamalarını uygular ve ek kaynaklar üretir (mekanizma 4).
  10. Release düzeyinde birleştirme — yeteneğin sınır birleştirmesi, düğüm başına parçaları sınır başına çıktılarda toplar (mekanizma 5).

Sıra önemlidir, çünkü aşağı akıştaki mekanizmalar yukarı akıştaki çıktıları okuyabilir — örneğin bir plugin hattı adımı, provider tarafından işlenmiş bir Deployment’a yama uygulayabilir; Release düzeyindeki bir birleştirici de provider işlemesinin, feature işlemesinin ve plugin hattının ürettiği parçaları birleştirebilir.

Çakışma algılama kural kümesi

İki mekanizma aynı sınır dizininde aynı ada sahip bir dosya ürettiğinde derleme, tüm katkıda bulunanları adlandırarak, aşağıdaki her kuralın adlandırdığı kategori altında durur. Kural kümesi:

Recipe biçim kuralı: artifacts: girdi anahtarı çakışması

Bir Recipe, artifacts: altında aynı anahtara sahip iki girdi bildirir (girdinin gövdesi ister satır içinde yazılsın ister $import: ile yüklensin, anahtar üretilen dosya adını belirler). Recipe yükleme zamanında errors/fatal-halts.md “artifacts: entry keys must be unique (girdi anahtarları benzersiz olmalıdır)” uyarınca algılanır.

Recipe biçim kuralı: Girdi türleri arası üretim zamanı çakışması

Bir Recipe’in üç girdi türü (kaynaklı, sentezlenmiş ve artifacts) dosyalarını aynı sınır dizinine üretir. Kaynaktan işlenen, workload ile sentezlenen veya artifact olarak üretilen çıktı, adını başka bir girdi türünün de ürettiği bir dosya üretirse derleme üretim aşamasında durur. Üretim zamanında errors/fatal-halts.md “Emission-time filename collision across input kinds (Girdi türleri arasında üretim zamanı dosya adı çakışması)” uyarınca algılanır.

Compose hizmet adı çakışması (Release düzeyi)

İki farklı düğüm (herhangi bir sınır birleşiminde) birleştirilmiş compose çıktısına aynı ada sahip hizmetler kattığında compose sağlayıcısı, sınırı oluştururken TRANSLATION_ERROR kategorisi altında, katkıda bulunan her (boundary, node, serviceName) demetini adlandırarak durur. Release düzeyindeki birleştirme sırasında providers/compose.md Release düzeyi çıktı bölümü uyarınca algılanır.

Bir hizmet, iki düğümün ne bildirdiği karşılaştırılmadan yalnızca adı nedeniyle reddedilir. Bir compose hizmeti tek bir çalışan kapsayıcıdır; bu nedenle her biri bir tane isteyen iki düğüm aralarında tek bir tane alır ve iki tanım ne kadar aynı olursa olsun bir katkıda bulunanın amacı kaybolur.

Compose birim adı ve yapılandırma adı çakışması (Release düzeyi)

İki farklı düğüm birleştirilmiş compose çıktısına aynı ada sahip üst düzey bir volumes: veya configs: girdisi kattığında ve iki bildirim farklı olduğunda compose sağlayıcısı, TRANSLATION_ERROR kategorisi altında girdiyi ve katkıda bulunan her (boundary, node) demetini adlandırarak durur. Release düzeyindeki birleştirme sırasında providers/compose.md Release düzeyi çıktı bölümü uyarınca algılanır.

Yukarıdaki hizmet kuralından farklı olarak bu kural bildirimleri karşılaştırır ve katkıda bulunanlar uyuştuğunda ortak bir ad meşrudur. Adlandırılmış bir birim veya yapılandırma tek bir nesnedir; bu nedenle onu aynı biçimde bildiren iki düğüm, birleştirilmiş belgenin sonunda içereceği girdinin tam olarak aynısını istemiştir ve hiçbir şey kaybolmaz. Onu farklı biçimde bildiren iki düğüm ise o tek nesne üzerinde anlaşmazlık içindedir ve bildirimlerden birini korumak, aksi hâlde başarılı olacak bir derlemeden diğerini atmak anlamına gelir. İki bildirim, birleştirilmiş dosyada aynı girdiyi tanımladıklarında uyuşmuş sayılır; dolayısıyla boş bir eşleme olarak yazılmış bir gövde ile tamamen atlanmış bir gövde uyuşur.

Helm-chart alt chart takma adı ve dizini

Bir helm-chart alt chart’ı charts/<instance_id>/ konumunda bulunur ve değerleri, takma ad konumu için kodlanmış örnek kimliği olan takma adı altında kapsamlanır. İki örnek, örnek kimlikleri aynı dize olmadıkça tek bir takma ada ulaşamaz; çünkü kodlama, bir takma adın kabul etmediği karakterlerin yerine başka karakter koymak yerine onları açıkça yazar. Bu nedenle bir takma ad tam olarak tek bir alt chart’ı tanımlar ve altına yazılan değerler yalnızca o alt chart’a ulaşır. Örnek kimlikleri de Aggregate düzleştirme kuralları gereği her sınırda benzersizdir; dolayısıyla dizin de çakışamaz. Her iki yarı da yapısaldır: hiçbiri bir denetime dayanmaz.

Helm işlenmiş kaynak adı çakışması

Bir sınır içinde aynı Kubernetes kaynak adına işlenen iki düğüm, çakışan metadata.name alanlarına sahip iki YAML dosyası üretir. Dosya adları farklıdır, çünkü her biri kendi adlandırma temeliyle öneklenir; ancak içlerindeki metadata.name yine de çakışabilir. Bu nedenle derleme, işlenen kaynakların taşıdığı adları denetler; bir ad alanında bir kind için aynı adı türeten iki katkıda bulunan, herhangi bir şey yazılmadan önce derlemeyi TRANSLATION_ERROR kategorisi altında durdurur ve bu adı ve onu türeten her bileşeni ve her eklemeyi adlandırır (bkz. errors/fatal-halts.md).

En büyük durum denetlenmek yerine yapı gereği kapatılmıştır. Kaynaklarını release adına göre adlandıran kaynaklı bir chart artık iki bileşen arasında bunu üretemez, çünkü herhangi bir şekilde farklı olan iki adlandırma temeli iki farklı release adına ulaşır; bkz. providers/helm.md “How the release name is derived”. Geriye iki durum kalır ve yukarıdaki denetimin bildirdiği de bunlardır. Bunlardan biri, şablonlarına bir kaynak adını doğrudan yazan bir chart’tır ve hiçbir türetme böyle bir adı başka herhangi bir sabit değerden ayırt edemez. Diğeri, tek bir bileşen üzerinde her biri yazarının yazdığı bir chart’ı sağlayan iki Feature eklemesidir: ikisi de tasarım gereği o bileşenin release adına göre işlenir; bu nedenle bir kaynağı .Release.Name ile adlandıran iki chart orada çakışır. İki chart’ın kaynaklarına ayrı adlar verin veya onları farklı bileşenlere ekleyin.

Sentezlenen her ad düğümün kendi kimliğiyle başlar: denetleyici nesnesininki ve kaynak başına her ad, sentezlenmiş Service adı uzlaşımı <release name>-<svcName> aracılığıyla (entities/workload.md “Synthesized-name convention” uyarınca). Bu, düğümler arası çakışmaları yapı gereği imkânsız kılar. Derlemesi bir Deployment / Service adında duran yazarlar önce iki farklı Recipes’in farklı işleme yolları üzerinden aynı adlı kaynaklar üretip üretmediğine bakmalıdır (örneğin, kaynaklı bir chart’ın templates/deployment.yaml dosyasının workload ile sentezlenmiş bir Deployment’ın metadata.name alanıyla çakışması).

Mekanizmalar arası etkileşim kalıpları

Workload ile sentezlenen çıktı + plugin hattı yaması

Standart kalıp: mekanizma 2 (workload sentezi) temel bir Deployment üretir; mekanizma 4 (Injector plugin’i) Deployment’a bir secret birimi bağlayan bir RFC 6902 yaması uygular. İki mekanizma birlikte çalışır: Deployment aynı K8s kaynağıdır ve yama, ConfigMap / Secret başvurularını sentezlenen temelin üzerine katman olarak ekler.

Bu, sentezlenen iş yüklerinde kimlik bilgisi enjeksiyonu için baskın kalıptır. Fetcher (mekanizma 3, Resource Generation), kümenin çalışma zamanında getirdiği bir ExternalSecret CRD’si üretir; Injector (mekanizma 4, bir plugin hattı yaması) ise ortaya çıkan K8s Secret’ını bağlamak için Deployment’ı değiştirir.

Farklı sınırlarda kaynaklı çıktı + Workload sentezi

Tek bir Aggregate’te, A sınırında kaynaklı bir helm Recipe’ine (mekanizma 1) bağlı bir bileşen ve B sınırında Workload sentezleyen bir helm Recipe’ine (mekanizma 2) bağlı kardeş bir bileşen bulunabilir. Her sınırın dizini uygun çıktı biçimini taşır; sınır başına dist/ dizinleri kardeş olarak yalıtıldığından sınırlar arası dosya adlandırması çakışmaz.

Çıktı dizini başına Compose Release düzeyinde birleştirme

Compose yeteneğinin birleştirmesi, dizini aynı yola değerlendirilen her sınırın düğüm başına parçalarını o yoldaki tek bir docker-compose.yaml içinde toplar; tek bir Release içindeki compose hedefli iki sınır, dizinleri farklı olduğunda iki dosya, bir dizini paylaştıklarında ise birleştirilmiş tek bir dosya yazar.

Bu nedenle servis adı çakışmaları, yukarıdaki kurala göre dosya başına, o dosyanın Release düzeyindeki birleştirmesinde tespit edilir. Farklı dizinlerde bulunan ve her biri api adlı bir servis bildiren compose hedefli iki sınır çakışmaz: her sınırın dosyası kendi servisini taşır. Bir dizini paylaşan iki sınır tek bir dosya yazar ve derleme iki katkıda bulunanı da adlandırarak durur.

Çapraz başvurular

  • entities/recipe.md — Recipe yazım yüzeyi (1 + 2 + 6 numaralı mekanizmalar Recipe içeriğinden çıktı üretir).
  • entities/featurerecipe.md — FeatureRecipe yazım yüzeyi (3 + 4 numaralı mekanizmalar FeatureRecipe içeriğinden çıktı üretir).
  • providers/helm.md — helm provider’ının mekanizma başına çıktı biçimleri ve adlandırma uzlaşımları.
  • providers/helm-chart.md — helm-chart provider’ının şemsiye + alt chart birleşimi (5 numaralı mekanizma).
  • providers/compose.md — compose provider’ının düğüm başına parçalaması + Release düzeyinde birleşimi (5 numaralı mekanizma).
  • errors/fatal-halts.md — benzersiz artifacts: girdi anahtarlarına ve girdi türleri arası dosya adı çakışmasına ilişkin Recipe biçim kuralları.
  • templates/expansion-matrix.md — işleme sırası boyunca şablon konumu başına değerlendirme zamanlaması.
  • plugins/plugin-contract.md — plugin işlem hattı sözleşme yüzeyi (4 numaralı mekanizma).
  • 10-status.md — 6 numaralı mekanizma (artifacts:) ve 4 numaralı mekanizmanın plugin işlem hattı çalışma zamanı için güncel hazırlık durumu.
  • architecture/10-compilation-pipeline.md — işleme aşamalarının sırası dahil tam derleme işlem hattı.
  • architecture/16-recipe-input-composition.md — üç Recipe girdi türü (1 + 2 + 6 numaralı mekanizmaların üst düzey çerçevesi).