Helm Provider
helm sağlayıcısı, GitOps tüketicileri (ArgoCD, Flux) için düz, işlenmiş Kubernetes YAML’ı üretir. Sağlayıcı, birleştirmeyi (path, provider) başına yapar: helm’i hedefleyen her düğümün işlenmiş YAML’ı, sınırın değerlendirilmiş directory: değerinin bileşen başına subDirectory: ile birleştirilmesiyle anahtarlanan birleştiriciye yönlendirilir ve bu birleştirici her Kubernetes kaynağı için bir YAML dosyası üretir. Sonraki araçlar, bir Helm kurulum adımı olmadan dosyaları doğrudan karşılaştırır ve uygular.
Sınırın syncWave: <integer> değeri 0 olmadığında, üretilen her Kubernetes kaynağı bu değeri argocd.argoproj.io/sync-wave: "<N>" ek açıklaması olarak taşır; Helm kancaları ayrıca helm.sh/hook-weight: "<N>" taşır. ArgoCD sync-wave ek açıklamasını, Helm ise bir kancanın ağırlığını okur ve her biri kaynakları buna göre sıralar; varsayılan 0 dalgasındaki bir sınır ikisini de taşımaz ve her iki araç bunu 0 dalgası olarak okur.
Bu sayfa, helm sağlayıcısının yazım başvurusudur. Sağlayıcılar arası girdi birleştirme modeli için bkz. architecture/16-recipe-input-composition.md. Her sağlayıcının hazırlık durumu için bkz. Dilin durumu → Providers.
Desteklenen girdi türleri
helm provider’ı, Recipe girdi türlerinin üçünü de farklı rollerde kabul eder:
- Kaynaklı mod.
source: <chart-path>içeren bir Recipe, diskteki bir Helm chart dizinini gösterir. Helm Go SDK chart’ı yükler, temel işleme değerleri sözlüğü chart’ın varsayılanlarıyla birleştirilir ve chart’ın şablonları düz Kubernetes YAML’ına işlenir. - Workload (sentezlenmiş) modu.
workload:(satır içi ya da$import:ile yüklenmiş) içeren bir Recipe, bir Workload belgesi bildirir. Provider, her düğüm için bir ya da daha fazla Kubernetes kaynağını — Workload’unformdeğerine göre seçilen bir denetleyici nesnesi ile her servis için Service’ler ve her kalıcı birim için PVC’ler — doğrudan Workload belirtiminden sentezler; bkz. Workload (sentezlenmiş) modu. - Yalnızca yapıt modu.
artifacts:içeren ve nesource:ne deworkload:içeren bir Recipe, yazarının yazdığı manifest’leri, derlemenin köken etiketleri ve ek açıklamaları her kaynağın kendi meta verisine eklenmiş olarak üretir.
Üçü bir arada kullanılabilir: bir Recipe bir chart’ı, bir Workload’u ve artifacts: alanını birlikte bildirebilir; her biri düğümün çıktısında yan yana, kendi başına işlenir ve üretilir — bkz. Her provider’ın kabul ettikleri, eksiksiz.
source: anahtar kümesi
helm sağlayıcısının source: alanı bir chart’ı adlandırır ve source: alanının aldığı iki biçimi de kabul eder: yalın bir dosya sistemi yolu dizesi ve konumu url: alanında taşıyan yapılandırılmış bir nesne. Bu konum bir dosya sistemi yolu olduğunda, derlemenin çağrıldığı dizine değil, onu bildiren recipe.yaml dosyasını barındıran dizine bağlanır ve bu dizinin içinde kalmalıdır: dizinin dışına çıkan ya da mutlak olan bir yol reddedilir, çünkü Recipe’in bir yayınının taşıdığı her dosya onun dizininden alınır — bkz. entities/recipe.md “Content paths stay inside the Recipe’s own directory”. Bu şekilde adlandırılan bir chart, Recipe ile birlikte yayımlanır; Recipe sabitlendiğinde kaydedilen yok sayma kurallarının tuttuğu, chart altındaki her dosya da yayımlanır — helm sağlayıcısı sürüm denetimi dizinlerini ve chart’ın templates/ dizini altındaki gizli dosyaları dışarıda bırakır, chart’ın kendi .helmignore dosyasına uyar ve son söz yazarın .aggregaignore dosyasındadır; bu, Bir varlıkla hangi dosyaların gönderildiği bölümünde açıklanır — ancak Recipe’in yanında bulunup bildirdiği hiçbir şeyin adlandırmadığı bir dosya yayımlanmaz. İşleme, yayının taşıdığı dosyaların aynısını okur; bu nedenle bir chart sizin dizininizden de bir kayıt defterinden de aynı şekilde işlenir. Yolu hangi biçimde yazdığınız bunu değiştirmez: url: değeri ./charts/api-server olan yapılandırılmış bir source:, yalın ./charts/api-server dizesiyle tamamen aynı şekilde bağlanır.
spec: capability: helm source: ./charts/api-server # filesystem path to a chart directory valuesMapping: | image: "{{ .values.image }}" replicas: {{ optional .infra `replicas` 2 }}Yapılandırılmış bir source: aynı şeyi adlandırılmış alanlarla söyler ve herhangi bir şeyin getirilip getirilmeyeceğine url: alanının taşıdığı değer karar verir. url: bir aktarım şeması taşıdığında — bir OCI chart’ı için oci://…, doğrudan bir chart arşivi için bir https://….tgz ya da chart: ile eşleştirilmiş bir https:// depo kökü — chart getirilir: tür, URL şemasından ya da açık bir kind: alanından gelir, aggrega pull chart’ı getirip kilit dosyasında sabitler ve derleme onu önbellekten çıkarır. url: bir dosya sistemi yolunu adlandırdığında hiçbir şey getirilmez ve hiçbir şey sabitlenmez — chart diskten okunur ve yukarıdaki yalın dize biçimiyle tamamen aynı şekilde bağlanır.
spec: capability: helm source: kind: helm-oci-chart url: ./charts/api-server # a path, so nothing is fetched and nothing is pinned version: "1.0.0"Bir chart’ın nereden okunacağına yalnızca url: karar verir. Diğer alanlar neyin getirileceğini seçer; bu nedenle bir yol için hiçbir şey seçmezler — yine de Recipe’in kendi şablonlarına .source.* olarak ulaşırlar.
Bir chart’ı yerel olarak dahil etmek, getirmeye bir alternatif olarak desteklenir ve zorunlu değildir. Şema açık bir yapılandırılmış nesne kabul eder.
Kaynak yolundaki chart geçerli bir Chart.yaml içermelidir. Chart’ı yükleyemeyen kaynaklı işlemeler, alttaki Helm SDK hatasını olduğu gibi gösterir. Boş bir source: "" helm’e özgü bir konu değildir: ne kaynaksız ne de kaynaklı modu adlandırır; bu nedenle aldığı ret, Recipe hangi sağlayıcıyı hedeflerse hedeflesin aynıdır ve Recipe okunurken, herhangi bir chart yüklenmeden ve bu sağlayıcı çağrılmadan önce gelir. Bu reddi hangi komutların bildirdiği entities/recipe.md “Source field scheme inventory” ve errors/fatal-halts.md “Recipe source: is an empty string (Recipe kaynağı boş bir dizedir)” bölümlerinde açıklanır.
Kaynaklı mod
source: <chart-path> ve valuesMapping: içeren bir Recipe, temel işleme sırasında aşağıdaki işlem hattını çalıştırır:
<chart-path>konumundaki chart, Helm Go SDK aracılığıyla yüklenir.valuesMappingşablonu, Recipe’nin şablon bağlamına karşı değerlendirilir. YAML çıktısı, chart için bir değer katmanı olarak ele alınır.- Katman, chart’ın
values.yamlvarsayılanlarıyla bir kez birleştirilir; çakışmada katman anahtarları kazanır (Helm’in standarthelm install --valuessemantiği). Katmanınnullolarak ayarladığı bir anahtar, chart’ın o anahtar için varsayılanını kaldırır — üst düzeyde, bir tablonun içinde ya da bir bağımlılığın değerlerinde — tıpkıhelm install --valuesgibi; böylece chart’ın şablonları anahtarı yok olarak okur. Chart’ın varsayılan vermediği bir anahtardakinullise şablonlaranullolarak ulaşır. - Helm SDK, chart’ın şablonlarını birleştirilmiş değerlere karşı işler.
- Aggrega, köken meta verilerini işleme sonrası YAML yeniden yazımıyla işlenmiş manifest’lere ekler; böylece kaynaklı çıktı, workload modu çıktısıyla aynı etiketlemeyi taşır. Kimlik değerleri etiket olur (
app.kubernetes.io/name,aggrega.ai/component-id,aggrega.ai/provider,aggrega.ai/provider-version,aggrega.ai/environmentve — ayarlandığında —aggrega.ai/aggregate-name,aggrega.ai/compiler-version) ve her biri Kubernetes’in etiket değeri olarak kabul ettiği bir biçimde yazılır; bir Kubernetes etiketinin temsil edemediği değerler ise ek açıklama olur (aggrega.ai/recipe-uri,aggrega.ai/boundary-path, dalga0olmadığındaaggrega.ai/sync-waveve değeri yeniden yazılmak zorunda kalan her etiketin birebir değeri —imported/flowadlı bir Aggregate aynı anahtar altındaimported-flowetiketini veimported/flowek açıklamasını alır). Yeniden yazma kuralı, well-known-annotations.md içindeki “Sağlayıcıların ürettiği köken etiketleri” bölümünde belirtilir. - Çıktı dosyaları, Recipe’nin çıktı dizinine düz olarak, işlenen her kaynak için bir tane olmak üzere yerleşir ve
<name-basis>-<kind>[-<namespace>]-<name>.yamlolarak adlandırılır — aşağıdaki sürüm adının türetildiği temelin ardından kaynağın kendi türü, varsa namespace’i ve adı gelir; her biri küçük harfe çevrilir ve diğer karakterlerin her dizisi tek bir kısa çizgiye indirgenir. Sıradan bir bileşen için bu temel, bileşenin kendi kimliğidir; bu aynı zamanda kaynağınaggrega.ai/component-idetiketinin taşıdığı değerdir. Bir Feature ekinin yazarının sağladığı bir chart için temel, ana bileşeninki olarak kalırken etiket ekin kendi kimliğini taşır. Türü veya adı olmayan bir belge bunun yerine şablon yoluna göre adlandırılır. Chart’ın dizin yapısı düzleştirilir: işlenen çıktıdatemplates/alt dizini yoktur ve farklı alt dizinlerde aynı dosya adını paylaşan iki şablon iki ayrı dosya olarak kalır, çünkü ad şablondan değil kaynaktan gelir. Recipe’ninartifacts:bloğunun adlandırdığı bir dosya buraya yerleşmez: bir dizin aşağıda, onu bildiren bileşenin adını taşıyan bir dizinin altında durur; çünkü böyle bir dosya, taşıdığı kaynağa göre değil yazarının yazdığı anahtara göre adlandırılır — bu dizin olmasaydı tek bir Recipe’ye bağlı iki bileşen aynı yola yazar ve hiçbir yazar bunları ayıramazdı.
Chart’ın işlendiği namespace, sınırdan aşağı doğru aktarılan aggrega.ai/namespace ek açıklamasından okunur ve chart’a sürüm namespace’i olarak ulaşır; hiçbir sınır bunu bildirmediğinde chart default’a karşı işlenir. Bir sınır bunu bildirdiğinde, chart’ın namespace olmadan işlediği her namespace kapsamlı kaynak — metadata.namespace yoksa ya da boş veya null yazılmışsa — bildirilen namespace’te üretilir; bu, chart’ı o sürüm namespace’i altında Helm ile kurmanın onu koyacağı yerdir ve dosyası, şablonu bu alanı yazan bir kaynakta olduğu gibi namespace kesimiyle adlandırılır. Şablonu bir namespace yazan kaynak, hangi namespace’i adlandırırsa adlandırsın onu korur. Küme kapsamlı bir kaynak namespace’siz kalır. Bir türün namespace kapsamlı olup olmadığı, API’nin kendisinin sunduğu bir tür için Kubernetes API’sinin kendi kapsamıdır; özel bir tür için ise aynı işlemedeki bir CustomResourceDefinition’ın o tür için bildirdiği scope’tur — chart’ın şablonlarından ya da crds/ dizininden. Bunların hiçbirinin sınıflandırmadığı bir türün kaynağı chart’ın yazdığı gibi bırakılır ve derleme bunu tür başına bir kez, türü ve API grubunu adlandırarak bildirir; öğeleri yerleştirilmeyen bir kind: List belgesi için de aynısı yapılır. Hiçbir sınır namespace bildirmediğinde hiçbir şey yerleştirilmez ve hiçbir şey bildirilmez: chart’ın namespace olmadan yazdığı bir kaynak namespace’siz üretilir ve uygulayan aracın seçtiği yere yerleştirilir.
Bildirim, derleme üzerinde bir uyarıdır; derleme yine de tamamlanır:
warning: node "store" (provider "helm"): resources of kind "Probe" in API group "monitoring.example.org" write no namespace and are left without one rather than placed in namespace "shop": the kind is not one the Kubernetes API serves itself, and no CustomResourceDefinition in this chart's render gives it a single scope, so whether it is namespaced is not known when the build runs, and they land wherever the tool applying the output places themChart’ta türün CustomResourceDefinition’ını işleyen ya da namespace’i kendisi yazan bir değer varsa, bunu Recipe’nin valuesMapping’i aracılığıyla ayarlamak böyle bir kaynağı yerleştirir.
Bir chart’ın render edildiği Kubernetes sürümü
Bir chart’ın şablonları, render edildikleri Kubernetes sürümünü .Capabilities.KubeVersion olarak okur ve birçoğu bir API sürümünü, bir alanı ya da bütün bir mekanizmayı buna göre seçer: örneğin 1.21’den itibaren projeksiyonlu bir service-account token’ı, altında ise birinci taraf bir token. Derlemenin soracağı bir küme yoktur; bu nedenle sürüm, Release’in bir component’in nereye dağıtılacağını söylediği yerde sizin belirttiğiniz bir değerdir: bir boundary üzerindeki ya da bir component üzerindeki aggrega.ai/kubernetes-version ek açıklaması. Component üzerindeki, boundary’sininkine üstün gelir ve aggrega.ai/namespace ile tam olarak aynı şekilde kademeli olarak aktarılır.
spec: boundaries: production: annotations: aggrega.ai/kubernetes-version: "1.31" components: api: {} legacy: annotations: aggrega.ai/kubernetes-version: "1.28" # this component deploys to an older clusterDeğer, helm template --kube-version bayrağını nasıl okuyorsa öyle okunur; dolayısıyla o bayrağın kabul ettiği biçimleri kabul eder ve bir chart, o bayrağın ona vereceği değeri aynen okur: "1.31" v1.31 olarak, "v1.31.2" v1.31.2 olarak okunur ve sayılardan sonraki metin .Capabilities.KubeVersion.Version içinde yazıldığı gibi kalır ("1.29.3-gke.100" v1.29.3-gke.100 olarak okunur); .Capabilities.KubeVersion bütün olarak yazdırıldığında ise sürümü bu metin olmadan okur. .Capabilities.KubeVersion.Version değerini semverCompare ile karşılaştıran bir chart böyle bir son eki ön sürüm olarak okur; bu yüzden ">=1.21" gibi -0 tabanı olmayan bir kısıt onunla eşleşmez. Çevresinde boşluk taşıyan bir değer bu boşlukla okunur (" 1.30 " "v 1.30 " olarak okunur) ve böyle bir karşılaştırmada doğrudan başarısız olur: bir chart’ın sürümü karşılaştırdığı yerde yalın sürümü yazın. Sürüm olmayan bir değer ("one.two", "latest", tek bir sayı), bir plugin’in temsil edemediği bir değer koşulu altında derlemeyi durdurur ve değeri, component’i ve boundary’sini adlandırır; chart hiçbir zaman onun yerine başka bir sürüm için render edilmez. Bkz. A Kubernetes version the helm provider cannot render a chart for (helm provider’ın bir chart’ı render edemediği bir Kubernetes sürümü). Boş bir değer ayarlanmamış sayılır.
Hiçbir ek açıklama bir sürüm belirtmediğinde chart, aynı helm sürümünün standart helm template komutunun render ettiği sürüm için render edilir; bu, provider’ın derlendiği Kubernetes istemci kitaplığının sürümüdür: v0.37 istemci kitaplığıyla derlenmiş bir provider, Kubernetes v1.37.0 için render eder. Böylece bir chart, Aggrega’da kendi yazarlarının helm template komutunun render ettiği gibi render edilir ve varsayılan değer yalnızca provider’ın derlendiği istemci kitaplığı değiştiğinde değişir. Dağıttığınız kümenin sürümü farklı olduğunda her zaman onu belirtin: kümenin çalıştırdığından daha yeni bir sürüm için render edilen bir chart, o kümenin sunmadığı bir API sürümü üretebilir.
Bu yolla yalnızca sürüm ayarlanır. Bir chart’ın okuduğu diğer her yetenek (.Capabilities.APIVersions ve .Capabilities.HelmVersion) helm kitaplığının yerleşik değeridir; bu nedenle bir kümenin kurulu bir CustomResourceDefinition üzerinden sunduğu bir API chart’a bildirilmez. Bir chart’ın kendi Chart.yaml dosyasındaki kubeVersion aralığı sürümle karşılaştırılmaz: helm template, aralığı render ettiği sürümü dışlayan bir chart’ı reddeder; derleme ise onu render eder. Ek açıklama yalnızca kaynaktan render edilen bir chart’ı etkiler, başka hiçbir şeyi etkilemez: sentezlenmiş bir Workload ve bir artifacts: gövdesi hiçbir .Capabilities okumaz ve helm-chart provider’ı chart’ını render etmeden, kurulduğunda render edilmek üzere aktarır.
Render edilen belgeleri dışarıda bırakmak. Bu provider, bir Recipe’nin ya da bir FeatureRecipe’nin bildirdiği omits: girdilerini bu modda dikkate alır, başka hiçbir modda almaz: sentezlenmiş bir Workload ve bir artifacts: gövdesi bunlar olmadan render edilir. Chart’ın render ettiği her belge (bir şablondan ya da crds/ dizinindeki bir dosyadan), derlemeye uygulanan her girdiyle eşleştirilir ve herhangi bir girdinin adlandırdığı belge dışarıda bırakılır. Bir girdi, bir belgeyi belgenin kendisinin taşıdığı sözcüklerle, yani çıktı dosya adının ve render olgularının oluşturulduğu sözcüklerle adlandırır: kind değeri, metadata.name değeri ve yalnızca girdi bir tane belirtiyorsa belgenin bulunduğu namespace; bu, şablonunun yazdığı namespace ya da bu provider’ın belgeyi yukarıda açıklandığı gibi yerleştirdiği durumda boundary’nin bildirdiği namespace’tir. Bu hiçbir zaman chart’ın yalnızca karşısında render edildiği namespace değildir: hiçbir namespace bildirilmediğinde chart default karşısında render edilir, ancak şablonu namespace yazmayan bir belge hiçbir namespace içinde değildir; bu nedenle default adlandıran bir girdi onunla eşleşmez. Kind ya da name taşımayan bir belge hiçbir girdiyle eşleşmez. Dışarıda bırakılan belgeler render edilir ve ardından her dosyanın adı kesinleştiğinde atılır; böylece tutulan her belge, girdiler olmasaydı nasıl adlandırılıp yazılacaksa aynen öyle adlandırılır ve yazılır, dışarıda bırakılan bir belge ise derlemenin sonradan yaptığı hiçbir şeye ulaşmaz: ne bir dosyaya, ne iki katkıcının aynı yere düşmesini reddeden karşılaştırmadaki bir ada, ne bir Feature’ın okuduğu bir render olgusuna, ne de bir pipeline adımına verilen herhangi bir şeye. Provider, her girdinin kaç belgeyle eşleştiğini bildirir ve hiçbir belgeyle eşleşmeyen bir girdi derlemeyi durdurur; bkz. An omits entry left out nothing the source rendered (Bir omits girdisi kaynağın render ettiği hiçbir şeyi dışarıda bırakmadı).
Bir chart’ın altında render edildiği Helm sürümü
Provider, Helm 4 SDK’sı ile, v4.3 sürümünde render eder; bu nedenle bir chart, Helm 4’ün kendi helm template komutunun ona verdiğini okur ve aynı chart ile aynı değerler her derlemede aynı baytları üretir. Helm 3’e göre yazılmış ve denetlenmiş bir chart, Helm 4’ün şu davranışlarını gözlemleyebilir:
.Capabilities.HelmVersion, Helm 4’ün sürümünü,v4.3değerini bildirir.- Varsayılan Kubernetes sürümü v1.37.0’dır, çünkü v4.3 sürümündeki Helm 4, v0.37 istemci kitaplığına göre derlenmiştir ve
.Capabilities.APIVersionso istemci kitaplığının API sürümleri kümesidir. Bir chart’ın render edildiği Kubernetes sürümü bölümünde anlatıldığı gibi, kümenizin çalıştırdığı sürümü belirtin. nullolan bir chart varsayılanı düşürülür. Chart’ınvalues.yamldosyasınınnullolarak ayarladığı bir anahtar (en üst düzeyde ya da bir tablonun içinde), Recipe’nin sağladığı değerler onu ayarlamadıkça.Valuesiçinde yer almaz; bu nedenlehasKeyonu eksik bildirir,toYamlonu dışarıda bırakır ve chart’ınvalues.schema.jsondosyası değerlere o anahtar olmadan karşı denetlenir.- Bir blok skaler,
---öncesindeki son satır sonunu korur. Bir blok skalerle biten ve ardından aynı şablondan başka bir belge gelen bir belge, o skalerin son satır sonunu korur; bu nedenle|-yerine|olarak yazılır. .Chart, alan adıyla anahtarlanmış bir eşlemdir..Chart.Name,.Chart.Version,.Chart.AppVersionve diğer alanlar önceki gibi okunur, ancaktoYaml .Chartya datoJson .Chart.MaintainersanahtarlarıName,AppVersionvb. biçiminde, boş alanlar da dahil olmak üzere yazdırır; chart’ın meta verilerinde bulunmayan bir alan da render’ı başarısız kılmak yerine boş olarak okunur..Capabilities.KubeVersion.Version, bir sürümün metnini yazıldığı gibi korur; bu, yukarıdaaggrega.ai/kubernetes-versionek açıklaması için anlatıldığı gibidir.- Birden çok YAML belgesi içeren bir
values.yamlbütün olarak okunur; sonraki belgeler öncekilerin üzerine birleştirilir. - Boş bir dosyanın
.Files.Linessonucu, render’ı başarısız kılmak yerine hiç satır döndürmez. - Helm 4’ün eklediği şablon işlevleri (
mustToYaml,mustToJson,mustToToml,mustToDurationveduration…dönüşümleri) bir chart’ın şablonlarında kullanılabilir. - İki kez takma ad verilmiş bir bağımlılık, her takma ada o bağımlılığın kendi bağımlılıklarının ayrı bir kopyasını verir.
- Values şeması doğrulaması yalnızca uç durumlarda farklı biçimde kabul eder ya da reddeder: tırnak içindeki bir e-posta yerel kısmı,
NaNve sonsuz sayılar,enumveconstiçinde sayı olmayan bir değerle karşılaştırılan bir sayı ve başarısız olan birpropertyNames,contentSchemaya da sonraki bir dizi öğesi için bildirilen konum.
Motorun kendisinin yürütemediği bir şablon (örneğin eksik bir tablo üzerinden okunan bir değer) Helm 4’ün biçiminde bildirilir: şablonun dosyası, satırı ve sütunu ayrı bir satırda, ardından hatanın geçtiği her şablon için yürütülmekte olan şey ve ileti, girintili olarak. Bir chart’ın kendi fail ya da required çağrısı tek satırlık execution error at (<file>:<line>:<col>): <message> biçimini korur; bir şablon işlevinin döndürdüğü hata da öyle.
Release adının nasıl türetildiği
Kaynaklı bir chart, her şablona .Release.Name olarak ulaşan bir release adına göre işlenir. Chart’lar kaynakları sıklıkla bu ada göre adlandırır; bu nedenle release adı, derleme üzerindeki bir etiket değil, küme içindeki bir kimliktir.
Release adı, işlenen kaynağın çıktı dosya adına önek olarak eklenen tabanın kodlanmış biçimidir; yani ikisi iki kez yazılmış tek bir addır. Bu taban, sıradan bir bileşen için bir instance_id, bir sınıra eklenmiş bir Feature için ise taşıdığı birleşik kimliktir. Bir Feature eklemesinin yazarının sağladığı bir chart için taban, ana bileşenin adıdır: chart’ın kendi şablonları release adına göre işlenir; bu yüzden adı eklemeden türetmek, chart’ın bildirdiği kaynakları zaten dağıtılmış oldukları bir kümede yeniden adlandırırdı. Bu kaynaklar yine de eklemenin kendi kimliğini aggrega.ai/component-id etiketlerinde taşır: burada bir kaynağın ne adla anıldığı ile neye ait olduğu ayrı sorulardır ve yalnızca sıradan bir bileşen için aynı yanıta sahiptir. Bir Helm release adı, bir kimliğin taşıyabileceğinden daha dar bir karakter kümesini kabul eder: küçük harfler, rakamlar, kısa çizgiler ve noktalar; küçük harf ya da rakamla başlayıp biten, en fazla 53 karakter. Türetme, hedefin kabul etmediği bir karakterin yerine başka bir karakter koymak yerine onu açıkça yazar; böylece yalnızca noktalama ya da büyük/küçük harf bakımından farklılaşan iki bileşen kimliği her zaman iki ayrı release adına ulaşır.
- Küçük harfler ve rakamlar tam olarak yazıldığı gibi aktarılır.
- Bir kısa çizgi, ardından gelen karakter doğrudan aktarılıyorsa ve küçük harf
zdeğilse yazıldığı gibi korunur. Ardından küçük harfzgelen bir kısa çizgi bir kaçış dizisi başlatır; bu nedenle o konumda yazılmış bir kısa çizginin kendisi açıkça yazılır:api-zone,api-zhzoneolur ve herhangi bir adın tahmine gerek kalmadan geri okunabilmesini sağlayan budur. Ardından hiçbir şey gelmeyen bir kısa çizgi de aynı nedenle açıkça yazılır; yanidb-,db-zhverir. - Diğer her karakter,
-zve ardından onu adlandıran bir harf olarak yazılır: nokta içind, alt çizgi içinu, yol ayırıcı içins, yukarıdaki kuralın korumadığı bir kısa çizgi içinh. Bunların dışındaki her şey (büyük harfler dahil)xve karakterin altı basamaklı onaltılık kod noktası olarak, hiçbir karakter başlatmayan bir bayt isebve kendi iki basamaklı değeri olarak yazılır. - Boş bir değer
-zeolarak yazılır; bunu boş olmayan hiçbir değer üretemez.
Helm bir release adında noktayı kabul etse de nokta aktarılmak yerine açıkça yazılır; çünkü Helm noktanın her iki yanında küçük harf ya da rakam bulunmasını gerektirir ve türetme kendi kısa çizgilerini yerleştirir.
Tek bir bileşene eklenmiş iki Features da o bileşenin release adına göre işlendiğinden, her biri bir kaynağı .Release.Name ile adlandıran iki chart, aynı adlı iki kaynak üretir. Bu Provider, kendi işlemesinin ürettiği her kaynağın taşıdığı adı, o kaynağın türüyle ve kümenin bir ad alanında tuttuğu türler için ad alanıyla sınırlı olarak bildirir; derleme, ikisinin de uygulanmasının yalnızca sonuncuyu bıraktığı bir çıktı üretmek yerine aynı ada düşen iki katkıyı reddeder; bkz. ../errors/fatal-halts.md “The same name is derived more than once inside the output (Aynı ad çıktı içinde birden fazla kez türetiliyor)”. Kümenin tüm ad alanlarının dışında tuttuğu bir tür (bir ClusterRole, bir CustomResourceDefinition ya da aynı işlemedeki bir CustomResourceDefinition tarafından Cluster kapsamıyla bildirilen özel bir tür) yalnızca türüyle sınırlanır ve tam olarak yukarıdaki ad alanı yerleşiminin sınıflandırdığı gibi sınıflandırılır; bu nedenle bir çıktının, her biri aynı ad altında böyle bir nesne yazan iki bileşeni, Release onları farklı ad alanlarına yerleştirse bile reddedilir. Çözüm adı birleştirmektir; hangi koordinatın gerektiği düzenlemeye bağlıdır. Tek bir bileşen üzerindeki iki ekleme zaten aynı ana bileşeni paylaşır; bu yüzden şablona ulaşması gereken eklemedir: .attachment_name değerini FeatureRecipe’in valuesMapping: alanı üzerinden chart’a geçirin ve chart’ın kaynak adlarının oluşturulduğu kendi değerlerinden hangisiyse ona atayın. İki bileşene eklenmiş tek bir chart ise tersidir: release adı her ana bileşende zaten farklıdır; bu yüzden .Release.Name ile adlandırılan bir kaynak her birinde kendine ait bir ad taşırken sabit bir ad taşımaz. Kaynaklarını artifacts: üzerinden sunan bir FeatureRecipe de aynı koşullarla bildirilir: bu Provider, üretilen her belgenin taşıdığı adı, belge ister bir chart şablonundan ister bir artifacts gövdesinden gelmiş olsun okur; bu nedenle iki bileşene eklenmiş böyle bir gövdedeki sabit bir ad da derlemeyi durdurur. Bir artifacts gövdesi bir şablondur; bu yüzden adı .context.rendered_name (ana bileşenin release adı; her ana bileşende farklıdır ve bir Kubernetes adının izin verdiği karakterlerle yazılır) ve ana bileşen başına ayrı olması gereken yerde .attachment_name ile birleştirin; bir artifact kümesini tek başına yerleştiren ve release adı bildirmeyen bir ana bileşende ise bunun yerine .context.instance_id ile birleştirin. Her ad bildirilmez; bu nedenle durmayan bir derleme, çıktısının sonunda taşıyacağı her şeyi karşılaştırmış değildir. Bir chart yazarken karşılaşmanız en olası olanı, generateName bildiren bir kaynaktır; bu, tamamlanmak üzere kümeye bırakılır ve dolayısıyla henüz karşılaştırılacak bir şeyi yoktur. Yukarıda bağlantısı verilen sayfa tam kümeyi içerir.
Dolayısıyla api değerindeki bir instance_id api release adını, data.main-db data-zdmain-db adını, db_host ise db-zuhost adını verir. Yalnızca küçük harflerden, rakamlardan ve türetmenin koruduğu kısa çizgilerden oluşan bir kimlik tam olarak yazıldığı gibi görünür. Aynı girdi her zaman aynı adı üretir.
Helm’in koşullarından ikisi türetmenin değil tabanın özellikleridir: bir release adı küçük harf ya da rakamla başlamalı ve en fazla 53 karakter olmalıdır. İlk karakteri açıkça yazılan bir taban, adına her kaçış dizisinin başladığı kısa çizgiyle başlar; açıkça yazılan karakterler taşıyan bir taban ise yazıldığından daha uzun kodlanır. Derleme bu Provider’a her ikisini de sorar ve yanıta göre derleme zamanında davranır; reddi uygulama zamanında kümeye bırakmaz; bkz. ../errors/fatal-halts.md “The target will not accept a name derived from an authored identity (Hedef, yazılmış bir kimlikten türetilen adı kabul etmeyecek)”. Yanıtla ne yapıldığı tabanı kimin yazdığına bağlıdır. Sizin yazdığınız bir ad değiştirilmek yerine reddedilir ve ret, yazdığınız alanı ve sahip olduğunuz sınırı belirtir; Aggrega’nın birleştirdiği bir ad ise bu Provider kabul edene kadar kısaltılır.
Küme, bir bileşene göre adlandırılan kaynakları Helm’inkinden daha katı bir kurala tabi tutar: bir Service adı bir harfle başlamalıdır, oysa bir release adı rakamla başlayabilir. Bir chart Service’lerini sıklıkla release adına göre adlandırır ve sentezlenmiş bir iş yükünün Service’leri de onunla başlar; bu nedenle bu Provider, rakamla başlayan bir bileşen adını da reddeder ve onu hedefin kullanamayacağı bir Service name olarak bildirir. Hiçbir uzunluk ilk karakteri düzeltmez; bu yüzden bu ret bir sınır belirtmez. Dolayısıyla bir instance_id değerini küçük harfle başlatın ve kodlanmış biçimi yine sığacak kadar kısa tutun.
Bir release adının türetildiği tabanı değiştirmek, bir chart’ın .Release.Name ile adlandırdığı küme kaynaklarını ve bu Provider’ın bileşen için sentezlediği her kaynağı yeniden adlandırır; Kubernetes ise bir kaynağı yerinde yeniden adlandırmaz. Uygulayan araç kaynağı yeni adıyla oluşturur ve eski adlı olanı kaldırır; bu, durum bilgili kaynaklar için eski ada bağlı depolamanın serbest bırakılması anlamına gelir. Böyle bir değişikliği, dağıtılacak bir güncelleme olarak değil, planlanması gereken (boşaltılan, taşınan ya da zamanlanan) bir değiştirme olarak ele alın.
Workload (sentezlenmiş) modu
workload: içeren (satır içi ya da $import: ile yüklenmiş) bir Recipe, Workload’un soyut niyetinden Kubernetes kaynakları sentezler. Workload şeması entities/workload.md sayfasında belgelenmiştir; bu bölüm helm provider’ının ne ürettiğini ele alır.
Her düğüm için:
- Workload’un
formdeğerine göre seçilen bir denetleyici nesnesi:stateless(ve varsayılan) bir Deployment,statefulbir StatefulSet,daemonbir DaemonSet,taskbir Job,scheduledisespec.scheduledeğeri Workload’unschedulealanı (5 alanlı bir cron ifadesi ya da bir@makrosu) olan bir CronJob üretir; zamanlaması olmayan ya da hatalı biçimli zamanlamaya sahip birscheduledworkload açıkça durur.suspend: truebildiren birscheduledworkload, CronJob’unuspec.suspend: trueile üretir; böylece devam ettirilene kadar zamanlamadan hiçbir çalıştırma başlamaz, ancak CronJob’dan elle bir Job oluşturmak yine de mümkündür; bunu bildirmeyen bir workload hiçsuspendanahtarı üretmez. Deployment ve StatefulSet replika sayısını taşır; DaemonSet, Job ve CronJob taşımaz. BirstatefulWorkload, StatefulSet’i yönetmek için Workload’da bildirilmiş tam olarak birtype: HeadlessService gerektirir; provider, StatefulSet’inserviceNamealanını o Service’in işlenmiş adına bağlar ve hiçbir headless Service bildirilmemişse (ya da birden fazla bildirilmişse) derleme durur. BirpersistentTemplatebirimiform: statefulile birlikte kullanılır; başka bir form üzerinde bildirilmesi, düzeltmeyi belirten bir iletiyle durur. - Workload’daki her
services:girdisi için, hizmet tanımının listelediği adlandırılmış portları açan bir Service. Girdinintypedeğeri Service’in türü olur:ClusterIP,NodePortveLoadBalancerolduğu gibi,HeadlessiseclusterIP: Noneiçeren birClusterIPService olarak. BirLoopbackgirdisi ise düğümü ve hizmeti belirterek derlemeyi durdurur: Kubernetes Service’inin bir ana makinenin loopback adresine bağlanan bir türü yoktur ve birNodePortService’inin hangi düğüm adreslerinde dinleyeceği tüm kümenin bir ayarıdır; bu nedenle girdi, istemediği bir erişimle işlenmek yerine reddedilir. Bkz. A service type the helm provider cannot render (helm provider’ının işleyemediği bir hizmet türü). - Her
persistentbirimi için, birimin tanımından boyutlandırılıp biçimlendirilen bir PersistentVolumeClaim. BirpersistentTemplatebirimi bağımsız bir talep üretmez: StatefulSet’in kendi tanımı içinde birvolumeClaimTemplatesgirdisi olur;form: statefulile birlikte kullanılmasının nedeni budur.
Kaynak adları. Bu modun bir bileşen için ürettiği her kaynak, bileşenin release adına göre adlandırılır (kaynaklı bir chart’ın işlendiği aynı ad; Release adı nasıl türetilir bölümünde anlatıldığı gibi türetilir) ve provider bu adı derlemeye {{ .context.rendered_name }} olarak bildirir. Denetleyici nesnesi release adının kendisini taşır; her Service <release name>-<service key> olur; her bağımsız talep <release name>-<volume> olur ve pod’un birimi tam olarak o talebe başvurur; dosya olarak iletilen bir gizli bilgi, <release name>-secret-<slot> adlı bir pod biriminden bağlanır ve yuva, release adında olduğu gibi kümenin kabul ettiği alfabeyle yazılır; yani server_certificate yuvası <release name>-secret-server-zucertificate biriminden bağlanır ve bir bağlantı üzerinden okunan bir yuvada bağlantı adından sonraki nokta da aynı şekilde yazılır; bir StatefulSet’in serviceName değeri, ürettiği headless Service’in adıdır; yalnızca harici adla açılan bir Workload ise release adını taşıyan tek bir Service üretir. Böylece api bileşeni api adlı bir Deployment ve api-default adlı bir default Service üretir; my_api bileşeni ise my-zuapi ve my-zuapi-default üretir: kimliğin yazıldığı hâlinin kabul edilmeyeceği yerde kümenin kabul ettiği adlar. Bu Service’lerden birinin adresini yayımlayan bir Recipe, ../templates/rendered-resource-names.md sayfasında gösterildiği gibi bu adresi {{ .context.rendered_name }} üzerinden oluşturur; adında alt çizgi ve büyük harf bulunmayan bir bileşen için release adı instance_id değerine eşittir, dolayısıyla adları kimlikle aynı okunur. Tek istisna, bir Feature eklemesinin sentezlediği workload’dur: eklemenin kendi bileşik kimliğine, yani aggrega.ai/component-id etiketinin taşıdığı değere göre adlandırılır; çünkü ekleme kendi ana bileşenine karşı işlenir ve orada türetilen bir release adı, eklemenin workload’unu ana bileşene göre adlandırıp ana bileşenin kendi workload’uyla çakıştırırdı. Bu kimlik hiçbir zaman büyük harf taşımaz: ana bileşenin ya da eklemenin adındaki bir büyük harf, bir kaynak adının reddettiği diğer her karakter gibi bir kaçış dizisi olarak yazılır; böylece myApi bileşeni üzerindeki worker eklemesi cfr--my-zx000041pi--worker adlı bir Deployment ve cfr--my-zx000041pi--worker-default adlı bir default Service üretir ve workload’un taşıdığı her ad kümenin kabul ettiği bir addır.
Workload’a bağlı ad uzunlukları. Bu adlardan ikisi küme tarafından kendi limitlerine tabi tutulur ve derleme, reddi uygulama anında kümeye bırakmak yerine Workload çözümlendiğinde ikisini de denetler. Bir CronJob adı en fazla 52 karakterdir; denetleyici her çalıştırmanın Job’unu sonuna bir sonek ekleyerek CronJob’a göre adlandırdığı için kümenin diğer adlarından daha kısadır; yalnızca scheduled bir Workload için denetlenir. Her Service adı, <release name>-<service key>, en fazla 63 karakterdir. Limitlerden herhangi biri aşıldığında ne olacağı, tıpkı release adında olduğu gibi, adı kimin yazdığına bağlıdır: sizin yazdığınız bir bileşen adı reddedilir; derleme, yazdığınız spec.components anahtarında ad türünü, uzunluğunu ve adınızın sahip olduğu bütçeyi belirterek durur — bkz. ../errors/fatal-halts.md “The target will not accept a name derived from an authored identity (Hedef, yazılmış bir kimlikten türetilen bir adı kabul etmeyecek)”; bir Feature ekinin workload’unun adını aldığı kimlik gibi oluşturulmuş bir kimlik ise her ad sığana kadar kısaltılır. Bir Service adı, bileşen adınızdan ve workload’un bildirdiği bir anahtardan — Recipe’de ya da bir FeatureRecipe’de — oluşturulur; bu nedenle bir ret o anahtarı ve workload’un onu nerede bildirdiğini, spec.workload.services.<key>, adlandırır; hiçbir bileşen adına yer bırakmayan bir anahtarın kendisinin kısaltılması gerekir. Dolayısıyla scheduled bir Workload taşıyan bir bileşenin kodlanmış adı en fazla 52 karakter olabilir ve web adlı bir bileşen en fazla 59 karakterlik Service anahtarları taşıyabilir. Bütün bir sınıra eklenen bir Feature’ın kimliği, Workload’u çözümlenmeden önce belirlenir, çünkü çıktısının nerede birleştirileceği bu kimliğe bağlı olabilir; bu yüzden onun sentezlediği kaynaklar için iki limitten hiçbiri denetlenmez.
Üretilen her kaynak, Aggrega köken etiketlerinin ve açıklamalarının tamamını, ayrıca Deployment/StatefulSet ile Service’leri arasında bağlanan bir seçici çiftini (app: <instance_id>) taşır. Bir etiket değeri kimliği yazıldığı gibi kabul eder; bu nedenle seçici onu korurken yukarıdaki adlar release adını alır. İşlenmiş Deployment’taki container adları, Workload’un container anahtarlarındaki . ve _ karakterlerinin - ile değiştirilmiş hâlidir (Kubernetes ad temizleme).
Port taşıma protokolü. Taşıma protokolü bildiren bir container portu, bunu işlenmiş containerPort üzerinde olduğu gibi protocol: olarak üretir ve o container portunu adlandıran her Service portu aynı değeri taşır: taşıma protokolü bir kez, container portunda bildirilir; dolayısıyla açılan port onunla çelişemez. Taşıma protokolü bildirmeyen bir port, iki kaynakta da protocol anahtarı üretmez ve kümenin varsayılanını geçerli bırakır. Workload’un kabul ettiği üç değerin tümü (TCP, UDP, SCTP) olduğu gibi üretilir; Kubernetes her birini doğrudan ifade ettiği için helm’in herhangi bir indirgemeye ihtiyacı yoktur.
Düğümün ağında çalışma. hostNetwork: true bildiren bir Workload, işlenmiş pod tanımında hostNetwork: true üretir; böylece pod düğümün kendi ağ ad alanında çalışır ve container’larının açtığı portlara düğümün adreslerinden erişilebilir. Kubernetes bu seçimi doğrudan ifade eder, dolayısıyla hiçbir şey indirgenmez. Bildirim yalnızca pod tanımına ulaşır: hiçbir port eklemez, kaldırmaz ya da yeniden yazmaz ve üretilen Service’ler bildirimle de bildirimsiz de aynıdır. Bunu bildirmeyen bir Workload hiç hostNetwork anahtarı üretmez.
Kaynak miktarları. Provider’ın manifest’lere kopyaladığı her miktar olduğu gibi üretilir ve her biri önce Workload → Kaynak miktarları bölümünde belirtilen miktar biçimine göre denetlenir: her container’ın ve init container’ın resources.requests ve resources.limits değerleri (cpu, memory ve nvidia.com/gpu gibi her genişletilmiş kaynak) ile her birimin ephemeral.sizeLimit, persistent.size ve persistentTemplate.size değerleri. Denetim, Workload üzerinde Recipe’nin şablonlarının onu değerlendirdiği hâliyle çalışır; dolayısıyla infra ya da bir Release parametresi üzerinden gelen bir değer, işlendiği sonuca göre değerlendirilir. Biçimin dışındaki bir değer, düğümü, alanın Workload içindeki yolunu ve değeri belirten bir TRANSLATION_ERROR ile derlemeyi durdurur (örneğin containers.main.resources.requests.cpu: "lots" is not a quantity: it does not begin with a number); aksi hâlde chart sorunsuz derlenir ve kurulumda küme tarafından reddedilirdi. Boş bırakılan bir cpu, memory ya da sizeLimit manifest’lerden çıkarılır ve bu nedenle denetlenmez; boş bırakılan bir genişletilmiş kaynak değeri ya da kalıcı boyut yine de üretileceği için reddedilir. Denetim yalnızca biçimi değerlendirir: kümenin bu miktarı zamanlayıp zamanlayamayacağı, provider’ın derleme zamanında bilebileceği bir şey değildir.
Çıktı dosyası adlandırmasının iki biçimi vardır. Denetleyici nesnesi release adına ve türüne 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, taşıdığı kaynağa göre ve tür en sonda olacak şekilde adlandırılır: <release name>-<svcName>-service.yaml ve <release name>-<volName>-pvc.yaml; her biri, entities/workload.md sayfasındaki sentezlenmiş ad uzlaşımına göre o kaynağın kendi metadata.name değerinden alınır. Yalnızca harici adla açılan bir Workload, taşınacak bir hizmet anahtarı olmadığından <release name>-service.yaml üretir.
Render olguları
Bu provider, render ettiği dosyaların yanı sıra her düğüm hakkında dört render olgusu bildirir: yaydığı Kubernetes belgelerinin pod’ları, seçicileri, portları ve her birinin yayıldığı namespace hakkında ne söylediği. Component’e bağlı bir FeatureRecipe, component’in kendi olgularını .context.render_facts üzerinden okur; readsCallerRenderFacts: true ayarlayan bir FeatureRecipe ayrıca .context.used_by içindeki her girdide, ana bileşenine bağlanan bir bileşenin olgularını okur; readsTargetRenderFacts: true ayarlayan bir FeatureRecipe ise .context.uses içindeki her girdide, ana bileşeninin bağlandığı bir bileşenin olgularını okur. Bir Feature, ana bileşenini çağıran bileşenlerin ya da ana bileşeninin ulaştığı bileşenlerin pod’larını — örneğin tam olarak bunları kabul eden bir ağ politikası için — kimsenin bir etiketi elle yeniden yazmasına gerek kalmadan, bu bileşenlerin render’larının gerçekte yaydıklarından bu şekilde adlandırabilir. Aşağıdaki adlar ve girdiler bu provider’ın sözleşmesidir.
| Olgu | Şunun başına bir girdi | Her girdinin taşıdıkları |
|---|---|---|
pod_template_labels | yayılan pod şablonu: bir Deployment’ın, StatefulSet’in, DaemonSet’in, ReplicaSet’in veya Job’ın spec.template’i, bir CronJob’ın job şablonu ve kendi şablonu olan çıplak bir Pod | şablonu taşıyan kaynağın kind, name ve namespace değerleri; labels, şablonun etiketleri |
controller_selectors | yayılan Deployment, StatefulSet, DaemonSet, ReplicaSet, Job ve CronJob | kind, name, namespace; match_labels, seçicisinin matchLabels değeri |
service_selectors | yayılan Service | name, namespace; selector, trafiği gönderdiği etiketler |
container_ports | bir pod şablonunun ports listesi bildiren container’ı, init container’lar dahil | şablonu taşıyan kaynağın kind, name ve namespace değerleri; container, container’ın adı; ports, her port için name, container_port ve protocol içeren bir girdi |
Olgular nasıl okunur:
- Her olgu bir listedir. Bir şablon, tek girdi içerse bile bir olgu üzerinde her zaman yineleme yapar; tek başına okunacak tekil bir değer yoktur.
- Dördü de, her render’da. Her biri, bu provider bir düğümü render ettiğinde bildirilir; render tanımladığı hiçbir şeyi yaymadıysa boş liste olarak — chart’ı yalnızca bir ConfigMap yayan bir bileşen dört boş liste bildirir. Başka bir provider’ın render’ı bu adların hiçbirini bildirmez ve kimsenin bildirmediği bir ad hiçbir şey olarak okunur.
- Her yolda, yayılandan okunur. Olgular, hangi mod üretmiş olursa olsun, render’ın yaydığı belgelerden gelir: bir chart’ın render edilmiş manifest’leri, sentezlenmiş bir Workload’un manifest’leri ve bir yazarın
artifacts:ile yerleştirdiği manifest’ler; bunlar tam olarak o manifest’lerin taşıdıklarını bildirir. Olgular, bu provider’ın derlemenin yinelenen ad denetimi için bildirdiği kaynak adlarıyla aynı geçişte, aynı belgeler üzerinde okunur. Bir kaynağın kendi köken etiketleri taşıdıklarının parçasıdır; bu nedenle çıplak bir Pod’unlabelsdeğeri bunları içerir; bir chart’ın veya bir artifact’ın pod şablonu ise yazarının yazdığı etiketleri korur. - Girdiler bileşenin kendi render’ından ve Features render’larından gelebilir. Bir bileşen birden fazla çağrıyla render edilebilir — örneğin bir chart ve bir
artifacts:yerleşimi — ve bir adın bu çağrılardan aldığı listeler, çağrıların çalıştığı sırayla tek bir listede birleştirilir..context.used_byve.context.usesüzerinde, bir bağlantının öbür ucundaki bileşenin olgularına, o bileşene bağlı Features’ın render ettikleri de kendi olgularından sonra katılır;.context.render_factsyalnızca bileşenin kendi render’ını taşır. - Yayılma sırasıyla. Girdiler, render’ın kaynakları yaydığı sırayı izler. Bir etiket eşlemi, bağlamdaki diğer her eşlem gibi anahtarlı bir eşlemdir; bu nedenle onun üzerinde yineleme yapan bir şablon anahtarlarla anahtar sırasında karşılaşır.
- Belgenin dışarıda bıraktığını girdisi de dışarıda bırakır.
generateNameile adlandırılan bir kaynağınnamedeğeri yoktur;metadata.namespaceyazmayan bir kaynağınnamespacedeğeri yoktur, onu boş veya null yazan bir kaynağın da yoktur, çünkü bu da hiçbir namespace adlandırmaz;matchLabelsolmadan yazılmış bir denetleyicinin — küme tarafından üretilen seçiciye dayanan bir Job gibi —match_labelsdeğeri yoktur; seçicisi olmayan bir Service’inselectordeğeri yoktur; adı veya protokolü olmayan bir portta bunların hiçbiri yoktur. Boş yazılan diğer her parça boş olarak bildirilir.protocolyalnızca belgenin bir tane yazdığı yerde bildirilir; bu nedenle buna ihtiyaç duyan bir şablon, kümenin kendi varsayılanı olanTCPdeğerini kendisi yazar.container_port, belgenin bir tane yazdığı her yerde bir sayıdır. namespacebelgenin yazdığı değerdir, asla bir tahmin değildir. Kaynağın kendimetadata.namespacedeğeridir — bir pod şablonu için onu taşıyan kaynağınki, ki pod’ları orada çalışır; pod şablonunun içinde yazılan bir namespace okunmaz. Sentezlenmiş bir Workload, sınırının bildirdiği namespace’i yaydığı her kaynağa yazar; bu nedenle girdileri o namespace’i taşır. Bir chart’ın girdileri, yaydığı belgelerin yazdığını taşır: bir sınırın namespace bildirdiği yerde o namespace’i — chart’ın şablonları onu yansıtsa da, provider kaynağı ona yerleştirse de (bkz. Kaynaklı mod) — bir şablon kendi namespace’ini sabitlemediği sürece, ki bu durumda girdi onu taşır; hiçbiri bildirilmediğinde, şablonların yansıttığı yerde sürüm namespace’i olandefaultdeğerini, hiç yazmadıkları yerde ise hiçbir şeyi. Hiçbir şeyin yazılmadığı yerde girdi, sınırın veya kümenin varsayılanı yerine hiçnamespacetaşımaz; çünkü böyle bir kaynak, çıktıyı uygulayan aracın onu yerleştirdiği yere düşer ve bu, derleme çalışırken bilinmez. Bir şablon ikisinioptionalile ayırt eder:{{ optional . "namespace" "" }}tam olarak belgenin hiç yazmadığı yerde boştur; böylece bir bileşenin pod’larının yanına bir şey yerleştiren bir Feature, pod’larının namespace’i bilinen bir bileşeni bilinmeyen bir bileşenden ayırt edebilir.- Tür ve API grubuyla tanınır.
PodveServiceçekirdek grupta, dört denetleyiciappsiçinde,JobveCronJobisebatchiçinde, grubun herhangi bir sürümünde okunur. Başka bir gruptan olup bu tür adlarından birini taşıyan özel bir kaynak bu tür olarak okunmaz. Bir seçicininmatchExpressionsdeğerleri bildirilmez; birkind: Listbelgesinin içine sarılmış bir kaynak ya da bir YAML birleştirme anahtarıyla yazılmış bir değer de bildirilmez.
Olguların göremedikleri. Olgular derlemenin yaydığı belgeleri tanımlar, kümenin daha sonra oluşturduğu hiçbir şeyi değil. Bir denetleyicinin çalışma zamanında özel bir kaynaktan oluşturduğu pod’lar — örneğin bir operatörün veritabanı kümesi — yayılan hiçbir belgede yer almaz; bu nedenle doğası gereği yoktur; manifest’ler uygulanırken değiştirici bir admission controller’ın eklediği etiketler de öyle. Bu tür pod’ları kabul etmesi gereken bir Feature, etiketlerini özel kaynağın kendi belgelerinden alır; bir yazarın bu olgular olmadan yapacağı gibi.
Ana bileşeninin pod’larına tam olarak onu çağıran bileşenlerin pod’larını kabul eden ve ana bileşeninin kendi pod’larını ana bileşenin denetleyici seçicisiyle seçen bir FeatureRecipe:
apiVersion: aggrega.ai/v1beta1kind: FeatureRecipemetadata: name: admit-callers version: 1.0.0spec: capability: helm implements: example/admit-callers:1.0.0 readsCallerRenderFacts: true artifacts: allow-callers.yaml: | apiVersion: networking.k8s.io/v1 kind: NetworkPolicy metadata: name: {{ .context.rendered_name }}-allow-callers spec: podSelector: matchLabels: {{- range .context.render_facts.controller_selectors }} {{- range $k, $v := .match_labels }} {{ $k }}: {{ toJson $v }} {{- end }} {{- end }} policyTypes: - Ingress ingress: - from: {{- range .context.used_by }} {{- range .render_facts.pod_template_labels }} - podSelector: matchLabels: {{- range $k, $v := .labels }} {{ $k }}: {{ toJson $v }} {{- end }} {{- end }} {{- end }}Workload’u bu provider tarafından sentezlenen bir web bileşeninin çağırdığı bir api ana bileşeni için politika app: "api" seçer ve web bileşeninin pod şablonunun her etiketini taşıyan bir podSelector kabul eder — yayılan Deployment’ının spec.template.metadata.labels değerinin tuttuğu etiketlerin aynısı. FeatureRecipe anahtarı ayarladığı için eki, her bileşen render edildikten sonra render edilir; böylece derleme api ve web bileşenlerinden hangisine önce ulaşırsa ulaşsın olgular hazırdır; anahtar olmadan, .context.used_by üzerinde render_facts okuyan bir şablon, hiçbir şey render edilmeden derlemeyi durdurur.
Bir politikanın from alanındaki bir podSelector, politikanın kendi namespace’indeki pod’larla eşleşir; bu nedenle yukarıdaki politika, uygulandığı namespace’e yayılan çağıranları kabul eder. Girdileri başka bir namespace taşıyan bir çağıran, onun podSelector değeri, Kubernetes’in her namespace’e ayarladığı o namespace’in kubernetes.io/metadata.name etiketi üzerindeki bir namespaceSelector ile eşleştirilerek kabul edilir.
Provider’a özgü tuhaflıklar
-
Chart indirmeleri yalnızca Helm’in yerleşik işleyicilerini kullanır. Bir Helm deposundan alınan chart, Helm’in kendi yerleşik
httpvehttpsişleyicileriyle indirilir. Bir Helm indirici eklentisine —helmkomutu için kurulmuş olana ya da derlemenin çalıştığı dizinde duran birine — hiçbir zaman başvurulmaz; dolayısıyla o dizindeki içerik bir chart’ın nasıl alındığını değiştiremez. -
Köken bilgisinin eklenmesi. Kaynaklı ve sentezlenmiş yollar aynı etiket ve açıklama (annotation) kümesinde birleşir; kaynaklı render’lar bunları render sonrası YAML yeniden yazımıyla (Helm SDK render işlemini tamamladıktan sonra) ekler, bu nedenle chart yazarlarının Aggrega etiketlerini kendi şablonlarından geçirmesi gerekmez.
-
Ortam sırası — önce Secret’tan okunan girdiler. Sentezlenmiş bir container’ın
envlistesi iki tür girdi taşır:as: envolarak teslim edilen herattachmentsgirdisi değerinivalueFrom.secretKeyRefaracılığıyla bir Secret’tan okur ve hervariablesgirdisi düz birvaluetaşır. Provider, Secret’tan okunan tüm girdileri önce, düz değişkenlerin tümünü ise onlardan sonra yazar; her türü yazıldığı sırada tutar veenvFromkaynaklarını ayrıcaenvFromaltında listeler. Kubernetes, birenvdeğerindeki$(NAME)başvurusunu aynı container’da kendisinden önce listelenen girdilerden genişletir, hiçbir zaman sonra listelenen bir girdiden değil; bu sıra sayesinde düz bir değişken, Secret’tan okunan bir değeri başvuruyla kullanarak oluşturulabilirken gizli değerin kendisi Secret’ta kalır:containers:api:image: "api:1.0"variables:DATABASE_URL: "postgres://app:$(DB_PASSWORD)@db:5432/app"attachments:DB_PASSWORD: { from: db-credentials, as: env }Render edilen container
DB_PASSWORDdeğişkeniniDATABASE_URLdeğişkeninden önce listeler; böylece süreç URL’yi parola yerine yerleşmiş olarak alır. Bir değişken, kendisinden önce yazılmış herhangi bir değişkene de başvurabilir; bu davariablesiçinde yazılış sırasını anlamlı kılar. Init container’lar da aynı sırayı izler. Bir adı hem birvariablesgirdisi hem deas: envolarak teslim edilen birattachmentsgirdisi olarak veren bir container, iki girdiyi birden yazmak yerine derlemeyi durdurur, çünkü aksi hâlde sürecin hangi değeri göreceğine yalnızca bu sıra karar verirdi (bkz. A container gives one environment variable two values (Bir container bir ortam değişkenine iki değer veriyor)). -
Namespace kademesi — iki mod kaynağa farklı biçimde ulaşır. İkisi de
aggrega.ai/namespacedeğerini sınır açıklama kademesinden okur ve hiçbir sınır bir namespace bildirmediğinde ikisi de namespace uydurmaz. Sentezlenmiş modda providermetadata.namespacealanını doğrudan yazar ve kademe bir değer vermediğinde alanı tamamen atlar. Kaynaklı modda provider değeri chart’ın release namespace’i olarak sağlar — kademe değer vermediğindedefault— ve bunu yansıtıp yansıtmayacağına chart’ın kendi şablonu karar verir; bir namespace bildirildiğinde provider bunu, chart’ın namespace olmadan render ettiği her namespace’li kaynağa yazar (bkz. Kaynaklı mod). Dolayısıyla bir namespace bildirildiğinde iki mod da her namespace’li kaynağı ona yerleştirir — chart’ın kendisinin sabitlediği bir namespace ve provider’ın sınıflandıramadığı bir tür hariç. Hiçbiri bildirilmediğinde ayrışırlar: release namespace’ini yansıtan bir chart kaynaklarınıdefaultiçine yerleştirir, oysa sentezlenmiş çıktı hiçbir namespace yazmaz; hiç namespace yazmayan bir chart ise onları hiçbir namespace’e yerleştirmez, böylece kaynaklar manifest’leri uygulayan aracın koyduğu yere düşer. Standart kütüphane FeatureRecipes’in taşıdığı yerel chart’lar ise kademe değerini doğrudan kendivaluesMappingalanları üzerinden okur: bu, hiçbir sınır namespace bildirmediğinde alanı atlamalarını ve sentezlenmiş çıktıyla eşleşmelerini sağlar; release namespace’i hiçbir zaman boş olmadığı için bunu tek başına ifade edemez.
Uygulamalı örnekler
Sourced modu — vendor’lanmış bir chart’a işaret eden Recipe:
apiVersion: aggrega.ai/v1beta1kind: Recipemetadata: name: api-server-helm version: 1.0.0spec: capability: helm implements: core/api-server source: ./vendor/charts/api-server valuesMapping: | image: "{{ .values.image }}" replicaCount: {{ optional .infra `replicas` 2 }} service: type: ClusterIP port: {{ .values.port }} env: LOG_LEVEL: "{{ optional .values `log_level` "info" }}"Workload modu — satır içi bir Workload bildiren Recipe:
apiVersion: aggrega.ai/v1beta1kind: Recipemetadata: name: api-server-workload version: 1.0.0spec: capability: helm implements: core/api-server workload: | apiVersion: aggrega.ai/v1beta1 kind: Workload replicas: {{ optional .infra `replicas` 2 }} containers: api: image: "{{ .values.image }}" ports: web: {{ .values.port }} services: svc: type: ClusterIP ports: web: {{ .values.port }}Çapraz başvurular
entities/recipe.md— Recipe yazım yüzeyi ve üç girdi türü.entities/workload.md— sentezlenmiş mod için Workload şeması.providers/helm-chart.md— düz manifestler yerine bir Helm chart iskeleti üreten kardeş sağlayıcı.providers/well-known-annotations.md— helm sağlayıcısının uyguladığı iyi bilinen ek açıklamalar (aggrega.ai/namespacevb.).architecture/16-recipe-input-composition.md— provider’lar arası Provider yetenek matrisi.10-status.md#providers— güncel hazırlık durumu sınıflandırması.