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

Aggrega altyapı tabanı (FeatureRecipe) şeması

Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.

Şema kimliği: https://aggrega.ai/schemas/featurerecipe-v1beta1.schema.json

Soyut bir katalog Feature’ını tek bir sağlayıcı yeteneği için somut, sürümlü bir uygulamaya eşleyen, operasyon ekibince yazılan tanımlar. Fiziksel bir provider ve katalog özelliğiyle kesinlikle 1:1 ilişkilidir.

FeatureRecipe varlıklarının yazılmasına ilişkin açıklamalı rehberlik için FeatureRecipe yazım başvurusuna bakın; bu sayfa, o başvurunun anlattığı yapısal şemayı belgeler.

Üst düzey tür: object

Özellikler

ÖzellikTürZorunluAçıklama
apiVersionconst “aggrega.ai/v1beta1”evetSabit: "aggrega.ai/v1beta1"
kindconst “FeatureRecipe”evetSabit: "FeatureRecipe"
metadataobjectevet
specobjectevetBir FeatureRecipe için provider yetenek bağlaması, eşleme, işlem hattı ve inject eşlemesi. Bir Recipe ile aynı üç girdi türünü (sourced, synthesized, artifacts) ve buna ek olarak yalnızca FeatureRecipe’e özgü injectMapping’i taşır; yalnızca capability ve implements bildiren, salt bağlantı amaçlı bir FeatureRecipe geçerlidir ve hiçbir şey işlemez.

Ek özelliklere izin verilmez.

featurerecipe.metadata

ÖzellikTürZorunluAçıklama
namestringevetEn az 1 karakter uzunluğunda.
versionstringevetFeatureRecipe’in katı Anlamsal Sürümlemesi (ör. 1.2.5). Desen: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$.
descriptionstringhayırBu varlığın ne olduğu ve ne işe yaradığı; onu kullanıp kullanmamaya karar veren biri için yazılır. Şeyi adlandıran bir cümleyle başlayın, ardından okurun onu seçmek ve doğru kullanmak için ihtiyaç duyduklarını ekleyin: onu dağıtan Release’ten ne beklediğini ve davranışında şaşırtıcı olan her şeyi. Olağan uzunluk kısa bir paragraftır.
maintainersobject[]hayırBu varlığın sahibi olan bakımcıların listesi.
licensestringhayırBu varlığın tanımladığı yazılımın lisansı için MIT veya AGPL-3.0 gibi bir SPDX tanımlayıcısı. Bu dosyanın koşullarını değil, o yazılımın koşullarını kaydeder.
repositorystringhayırKaynak dosyaların bulunduğu Git deposunun URL’si.
homestringhayırBu varlığın ana sayfasının, wiki’sinin veya belgelerinin URL’si.
keywordsstring[]hayırKullanıcı arayüzünde keşfedilebilirlik için tanımlayıcı anahtar sözcüklerin listesi.

Ek özelliklere izin verilmez.

featurerecipe.metadata.maintainers[]
ÖzellikTürZorunluAçıklama
namestringevet
emailstringhayır
urlstringhayır

Ek özelliklere izin verilmez.

featurerecipe.spec

Bir FeatureRecipe için provider yetenek bağlaması, eşleme, işlem hattı ve inject eşlemesi. Bir Recipe ile aynı üç girdi türünü (sourced, synthesized, artifacts) ve buna ek olarak yalnızca FeatureRecipe’e özgü injectMapping’i taşır; yalnızca capability ve implements bildiren, salt bağlantı amaçlı bir FeatureRecipe geçerlidir ve hiçbir şey işlemez.

ÖzellikTürZorunluAçıklama
capabilitystringevetBu recipe’nin bağlandığı açık provider yeteneği (ör. ‘helm’, ‘terraform’, ‘compose’): onu işleyen provider türü.
implementsstringevetBu recipe’nin hangi katalog Feature türünü uygulayabildiğini bildirir (feature.aggrega.ai/kind: secret etiketli kimlik bilgisi Features dahil; tam sürüm, ana sürümle uyumlu ’^’ aralığı veya sürümsüz). Derleyici bunu Manifest eşlemelerini doğrulamak ve tanılamalarda ve düzenleyici tamamlamada aday önermek için kullanır; hiçbir zaman bir derlemeyi çözümlemez. Manifest eşlemesi, kullanıcının Release’in lockfile’ında sabitlenmiş açık uygulama tercihidir.
localsstring eşlemihayırÖzel Ops Durumu. Yalnızca bu FeatureRecipe’in şablonları içinde ‘.locals.*’ olarak erişilebilen dahili hesaplama sonuçları. Her girdi kendisi bir Go şablonudur ve kendi içinde bağımsız bir bağlama karşı değerlendirilir: ‘.context.instance_id’ (bu eklemenin çözümlendiği HOST COMPONENT; bu başvuru her şablon yüzeyinde bunu ifade eder), ‘.attachment_name’ (çözümlenen ekleme örneği ve bir local’den bu ada ulaşmanın tek yolu), eklemenin kendi ‘.values’ ve ‘.infra’ değerleri ve bu aynı bloğun o ana kadar çözümlenmiş girdileri. Girdiler yazıldıkları sırayla çözümlenir ve bir girdi kendisinin ÜSTÜNDE tanımlanmış bir kardeşini OKUYABİLİR; bu durumda o kardeşin şablon metnini değil, çözümlenmiş değerini alır. Bir girdinin başka bir girdiyi okuduğu her yerde yazım sırası sözleşmenin bir parçasıdır: bir tanımı okuyucusunun altına taşımak derlemeyi bozar ve bir başvurunun çözümlenmesi için blok hiçbir zaman yeniden sıralanmaz. Bu bloğun DAHA SONRA tanımladığı bir girdiye yapılan ‘.locals.’ başvurusu, sıralama hatasını adlandırarak durur; bloğun hiç bildirmediği bir anahtarı adlandıran başvuru ise anahtarı adlandırarak durur. Her iki denetim de tuş vuruşlarını değil, başvurunun ÇÖZÜMLENDİĞİ yolu okur; bu nedenle doğrudan biçimi, bir ’{{ with .locals }}’ bloğu içindeki okumayı, doğrudan ‘.locals’a bağlanmış bir değişken üzerinden yapılan okumayı ve parantez içindeki bloktan okunan bir anahtarı, ‘(.locals).’ veya ’($.locals).’, eşit biçimde kapsar. Kapsamadıkları tek bir yazım vardır: yolunu şablon metninin belirlemediği bir başvuru, yani ‘index .locals’ veya ‘(default dict .locals).’ gibi bir fonksiyon aracılığıyla ya da işlem hattı böyle bir fonksiyon uygulayan bir ‘with’ bloğu veya değişken bağlaması aracılığıyla ulaşılan başvuru; çünkü böyle bir işlem hattının ne verdiği metniyle değil, değerlendirme sırasında belirlenir. Bu yazım analiz edilmez ve bu yolla ulaşılan eksik bir anahtar durmaya yol açmaz: hiçbir şey yerine '' metnini olduğu gibi işler. Tek istisna ‘index’in kendisidir: her şablon yüzeyinde, okuduğu eşlem istenen anahtarı içermediğinde anahtarı adlandırarak durur; bu nedenle ‘index .locals’ aracılığıyla ulaşılan eksik bir anahtar durur. Bu FeatureRecipe’in locals’ı provides’tan ÖNCE çözümlenir; bu nedenle bir provides şablonu ‘.locals’ı okuyabilir ve çözümlenmiş değerleri alır, bu bloğun bildirmediği bir anahtarı adlandıran bir provides şablonu ise durur. Kurallar, bir Recipe’in locals bloğunun izlediği kurallarla aynıdır. executionScope boundary olduğunda blok, sınır eklemesi için bir kez, bir bileşenin bağlamına değil sınır kapsamlı şablon bağlamına karşı değerlendirilir ve eklemenin ulaştığı her bileşen, injectMapping’inin okuduğu ‘.locals’ dahil, bu çözümlenmiş girdileri okur. Fiziksel gerçeklikleri (ör. hedef konteynerler, JSON yolları) aşağı akıştaki Wasm plugin’lerine aktarmak için kullanılır. Çağıranlara hiçbir zaman açılmaz; genel API için provides’ı kullanın.
providesstring eşlemihayırGenel Geliştirici API’si. Aşağı akıştaki Çağıranın inject çözümlemesi için kullanılabilen sözleşmeye bağlı çıktı değişkenleri. executionScope boundary olduğunda provides, sınır eklemesi için bir kez, sınır kapsamlı şablon bağlamına karşı değerlendirilir ve eklemenin ulaştığı her bileşen bu tek değerlendirmeyi ‘.features..provides’ konumunda okur; eklemenin taşıdığı bir bağlantı da öyle; uygulanan Feature’ın bildirdiği provides sözleşmesi bu değerlendirme üzerinde bir kez, sınır eklemesini adlandırarak denetlenir.
sourcestring veya objecthayırAltyapı koduna isteğe bağlı yol. Bir URI dizesi veya açık yapılandırılmış bir nesne kabul eder. valuesMapping ile birlikte verilirse derleyici onu işler ve işlenen belgeler, işlem hattı adımları çalışmadan önce FeatureRecipe’in çıktısına katılır.
valuesMappingstring veya objecthayırİçerik biçimine göre yönlendirme yoluyla üç yazım kipine sahip değer eşleme içeriği. Kip 1 (satır içi): provider’ın beklediği değer biçimini üreten bir Go şablonu dize skaleri. Kip 2 (dosya içe aktarma): yerel bir Go şablonu dosyasını gösteren, tam olarak tek anahtarlı bir YAML eşlemi, $import: ./relative/path.tmpl. Kip 3 (kitaplık içe aktarma): bir MappingLibrary girdisine yalın ad kimliğiyle başvuran, tam olarak tek anahtarlı bir YAML eşlemi, $import: <Library>#/mappings/<entry> (sürüm, Release başına lockfile tarafından sağlanır; başvuruda hiçbir kayıt defteri ana bilgisayarı yer almaz). Nesne biçiminde $import, ^oci:// ile eşleşmemelidir; eşleşen bir değer reddedilir.
workloadstring veya objecthayırİçerik biçimine göre yönlendirme yoluyla üç yazım kipine sahip Workload YAML üreticisi. Kip 1 (satır içi): çıktısı ‘aggrega.ai/v1beta1 Workload’ olarak ayrıştırılan bir Go şablonu dize skaleri. Kip 2 (dosya içe aktarma): yerel bir Go şablonu dosyasını gösteren, tam olarak tek anahtarlı bir YAML eşlemi, $import: ./relative/path.yaml. Kip 3 (kitaplık içe aktarma): bir WorkloadLibrary girdisine yalın ad kimliğiyle başvuran, tam olarak tek anahtarlı bir YAML eşlemi, $import: <Library>#/workloads/<entry> (sürüm, Release başına lockfile tarafından sağlanır; başvuruda hiçbir kayıt defteri ana bilgisayarı yer almaz). Hedef Provider workload sentezini desteklemelidir; standart kitaplık kataloğu, belgelenmiş sözleşme olarak bu tür provider’larda workloadSchema bildirir. Sentez yapamayan bir provider’a bağlı bir workload: FeatureRecipe’i, işleme zamanında açıkça durur. Sentezlenmiş bir FeatureRecipe workload’u, provider’a özgü manifest’lerini feature’ın çıktı dizini altında üretir. Nesne biçiminde $import, ^oci:// ile eşleşmemelidir; eşleşen bir değer reddedilir.
artifactsstring veya object eşlemihayırGirdi adından artifact içeriği yazımına eşleme. Her girdinin değeri, içerik biçimine göre ayrım yoluyla üç moddan birini taşır. Mod 1 (satır içi): çıktısı artifact gövdesi olan bir Go şablonu string skaleri. Mod 2 (dosya içe aktarma): yerel bir Go şablonu dosyasını gösteren, tam olarak tek anahtarlı bir YAML eşlemesi, $import: ./relative/path.yaml. Mod 3 (kütüphane içe aktarma): bir ArtifactLibrary paketine yalın ad kimliğiyle başvuran, tam olarak tek anahtarlı bir YAML eşlemesi, $import: <Library>#/artifacts/<entry> (sürüm, Release başına kilit dosyasından gelir; başvuruda hiçbir kayıt defteri sunucusu yer almaz). Bir paket, her dosya için bir çıktıya açılır ve her biri girdinin anahtarı altında <key>/<filename> olarak yerleştirilir. Anahtar, girdinin çıktısını adlandırır: mod 1 veya mod 2 girdisinin anahtarı, yazıldığı gibi kullanılan çıktı dosya adıdır; mod 2 girdisinin içe aktardığı dosya içeriği sağlar ama çıktıyı adlandırmaz, bu nedenle aynı adı taşıyan farklı dosyaları içe aktaran iki girdi iki ayrı çıktıdır. Kaynak üreten bir FeatureRecipe’in ürettiği yardımcı kaynaklar (ConfigMap, ServiceMonitor, NetworkPolicy, ExternalSecret CRD vb.) artifact biçimindedir; artifacts: temel kaynak üretme mekanizmasıdır. Artifact girdileri, paket dosyaları, kaynak çıktısı ve iş yükü sentezi arasındaki çakışmalar, düğüm işlendiğinde derlemeyi durdurur. artifacts bloğu bir Recipe’te ve bir FeatureRecipe’te aynı biçimde yazılır — aynı üç mod, aynı anahtardan çıktıya kuralı ve aynı çakışma davranışı — bu nedenle bu açıklamanın o bölümü her iki türde de aynıdır; birisi için yazılmış bir örnek diğerine değişmeden aktarılır. Nesne biçiminde $import, ^oci:// ile eşleşmemelidir; eşleşen bir değer reddedilir. Anahtarlar: Anahtar girdinin çıktısını adlandırdığından tek bir dosya adıyla sınırlıdır: bir harf veya rakamla başlar ve harfler, rakamlar, noktalar, kısa çizgiler veya alt çizgilerle devam eder. İlk karakterden sonraki noktalar, artifact anahtarlarının taşıdığı uzantıları korur (main.tf, template.yaml, serviceaccount.yaml). Bir /, bir anahtarın dosya yerine bir yol adlandırmasına yol açar; baştaki bir . ise çıktı dizininin dışında bir konumu adlandıran .. değerine izin verir — ilk karakter sınıfı ikisini de reddeder. Kütüphane içe aktarmada anahtar, paket dosyalarının altına yerleştirildiği dizini adlandırır, bu nedenle aynı sınır geçerlidir. Desen: ^[A-Za-z0-9][A-Za-z0-9._-]*$.
omitsobject[]hayırBu FeatureRecipe’in kaynağının işlediği çıktıdan neyin çıkarılacağı — olduğu gibi alınan ve Release’in yayımlamaması gereken bir şey işleyen bir kaynak için: getirilen bir chart’ın işlediği bir belge (örneğin chart’ın her işlemede yeniden ürettiği bir anahtarı tutan bir Secret), getirilen bir compose dosyasının paketlediği bir service, volume veya config ya da getirilen bir CloudFormation şablonunun bildirdiği bir kaynak. FeatureRecipes’in çoğu buna hiç ihtiyaç duymaz. Her girdi, kaynağın işlediği bir birimi türüne, adına ve girdi belirtiyorsa ad alanına ve geldiği alt chart’a göre adlandırır; her biri kaynağı işleyen sağlayıcının sözcük dağarcığındadır — chart için bir belge kendi kind ve metadata.name değerleriyle; compose dosyası için bir service, volume veya config, services:, volumes: veya configs: altındaki anahtarıyla; CloudFormation şablonu için bir kaynak Type değeri ve mantıksal kimliğiyle. O sağlayıcı, bir girdinin eşleştiği her birimi çıkarır; bir girdinin neyle eşleştiği ve sağlayıcının bir girdi nedeniyle neyi reddettiği, o sağlayıcının kendi belgelenmiş sözleşmesidir. Hiçbir şeyi çıkaramayan bir sağlayıcı, bu anahtarı bildiren bir FeatureRecipe’i herhangi bir şey işlenmeden önce reddeder. Yalnızca source: tarafından işlenen çıktı süzülür — bir workload: veya artifacts: girdisi asla süzülmez — bu nedenle anahtar source gerektirir. Her değer bir şablondur ve valuesMapping hangi bağlama karşı değerlendiriliyorsa o bağlama karşı değerlendirilir. Bir girdinin when değeri önce değerlendirilir ve when değeri yanlış sayılan bir değer üreten girdi bırakılır. Etkin kalan her girdi bir şey çıkarmalıdır: kaynağın işlediği hiçbir şeyle eşleşmeyen etkin bir girdi, girdiyi adlandırarak derlemeyi durdurur. Kaynak yine de tümüyle işlenir — chart’ın her şablonu yine çalışır, bu nedenle başarısız olan bir şablon derlemeyi yine başarısız kılar — ve yalnızca çıktısı dışarıda bırakılır. Anahtar bir Recipe’te ve bir FeatureRecipe’te aynı biçimde yazılır. En az 1 girdi.
injectMappingstringhayırPre-Render Interception aşamasında, eklemenin ulaştığı her bileşen için bir kez, o bileşenin şablon bağlamına karşı değerlendirilen isteğe bağlı satır içi Go şablonu: executionScope ne derse desin bileşenin ‘.context’ ve ‘.features’ değerlerini ve eklemenin ‘.attachment_name’, ‘.values’, ‘.infra’ ve ‘.locals’ değerlerini okur; hiçbir bileşenin bağlamının taşımadığı ‘.boundary’ değerine yapılan bir başvuru derlemeyi durdurur. Go derleyicisinin Caller’ın ‘.context.inject’ bellek kanalının üzerine yerel olarak derinlemesine birleştirdiği bir JSON/YAML sözlüğü üretir. Ortam değişkenlerinin ve teslim sözleşmelerinin Wasm gerektirmeden Caller tarafında değiştirilmesi için kullanılır.
pipelineobject[]hayırİşlemeden sonra işlenmiş belge kümesi üzerinde çalıştırılan sıralı Wasm işlem hattı adımları listesi; her adım RFC 6902 yamaları ve yan etkiler döndürür.
executionScopestring (enum)hayırBu FeatureRecipe’in Resource Generation işleminin bileşen başına mı (varsayılan) yoksa sınır eklemesi başına bir kez mi çalışacağı. Sınır kapsamlı FeatureRecipes, (boundary_path, FeatureRecipe örneği) ile tekilleştirilir ve injectMapping dışındaki her şablon sınır kapsamlı bir şablon bağlamını okur: bileşen başına .context.* sütunları yerine .boundary.* sütunları; .context.* sütunlarına yapılan bir başvuru derlemeyi durdurur. injectMapping, executionScope’tan bağımsız olarak eklemenin ulaştığı her bileşen için bir kez çalışır; bu nedenle o bileşenin bağlamını okur ve .boundary’yi asla okumaz. İzin verilen değerler: "component", "boundary" Varsayılan: "component"
readsCallerRenderFactsbooleanhayırBu FeatureRecipe’in şablonlarının, eklendiği Component’e bağlanan Components’in işlediklerini okuduğunu bildirir: bu çağıranların her birinin sağlayıcısının kendi çıktısı hakkında bildirdiği işleme olguları. True olduğunda ve FeatureRecipe bileşen başına işlendiğinde, her eklemesi eklendiği Component’in hemen ardından değil, derlemedeki her Component işlendikten sonra işlenir; böylece ekleme değerlendirilmeden önce her çağıranın işlemesi tamamlanmış olur. False veya yok olduğunda, ‘.context.used_by’ üzerindeki hiçbir çağıran girdisi işleme olgusu taşımaz, readsTargetRenderFacts true olmadıkça ekleme kendi Component’inin hemen ardından işlenir ve bu FeatureRecipe’te satır içi yazılmış, ‘.context.used_by’ altında bir çağıranın işleme olgularını okuyan bir şablonda derleme durur. Varsayılan: false
readsTargetRenderFactsbooleanhayırBu FeatureRecipe’in şablonlarının, eklendiği Component’in bağlı olduğu Components’in işlediklerini okuduğunu bildirir: bu hedeflerin her birinin sağlayıcısının kendi çıktısı hakkında bildirdiği, ‘.context.uses’ üzerindeki her girdide yer alan işleme olguları. True olduğunda ve FeatureRecipe bileşen başına işlendiğinde, her eklemesi eklendiği Component’in hemen ardından değil, derlemedeki her Component işlendikten sonra işlenir; böylece ekleme değerlendirilmeden önce her hedefin işlemesi tamamlanmış olur. Bu, readsCallerRenderFacts’in neden olduğu aynı geç işlemedir; bu nedenle anahtarlardan birini ya da ikisini birden ayarlamak eklemenin o zaman işlenmesini sağlar. False veya yok olduğunda, ‘.context.uses’ üzerindeki hiçbir girdi işleme olgusu taşımaz, readsCallerRenderFacts true olmadıkça ekleme kendi Component’inin hemen ardından işlenir ve bu FeatureRecipe’te satır içi yazılmış, ‘.context.uses’ altında bir hedefin işleme olgularını okuyan bir şablonda derleme durur. Varsayılan: false
assertionsstring eşlemihayırDerleme zamanında alanlar arası doğrulama. Her girdi adlandırılmış bir doğrulamadır: anahtar, hata iletilerinde gösterilen kararlı bir kural tanımlayıcısıdır; değer, {{ fail "message" }} durdurma semantiğine sahip bir Go şablonu string’idir. Varlık başına birden çok adlandırılmış doğrulama, örnek başına ve yazarın bildirdiği sırayla değerlendirilir; başarısız olan ilk doğrulama derlemeyi durdurur. FeatureRecipe doğrulamaları recipe bağlamasından ve provides değerlendirildikten sonra, işlemeden önce değerlendirilir ve FeatureRecipe’in kaynak olarak aldığı belirli chart’ın veya modülün uygulama değişmezlerini ifade eder. Şablon bağlamı: .values / .infra / .uses / .features / .metadata ile birlikte .provides / .locals / .recipe. Değerlendirici missingkey=error kullanır: tanımsız anahtarlara yapılan başvurular no-such-key tanılamasıyla durur. Yalın başvuru herhangi bir geri dönüş çalışmadan önce durduğundan, düz bir default bu yüzeyde isteğe bağlı alan için geri dönüş sağlamaz — başvuruyu hasKey ile koşula bağlayın ya da varlık denetimini doğrudan yapan optional yardımcısını kullanın. Anahtarı index ile okumak da geri dönüş sağlamaz: index, eşlemenin içermediği bir anahtarda anahtarı adlandırarak durur.

Ek özelliklere izin verilmez.

featurerecipe.spec.omits[]
ÖzellikTürZorunluAçıklama
kindstringevetDışarıda bırakılacak birimin türü, kaynağı işleyen sağlayıcının sözcük dağarcığıyla: bir chart için, işlenen bir belgenin kendi kind değeri, örneğin Secret; bir compose dosyası için service, volume veya config; bir CloudFormation şablonu için bir kaynağın Type değeri, örneğin AWS::S3::Bucket. Kaynağın işlediği bir türü adlandırır ve yapılandırılmış bir source: alanının taşıdığı kind: ile ilgisi yoktur. Bir şablondur.
namestringevetDışarıda bırakılacak birimin adı, kaynağı işleyen sağlayıcının sözcük dağarcığıyla: bir chart için, işlenen bir belgenin kendi metadata.name değeri; bir compose dosyası için, birimin services:, volumes: veya configs: altındaki anahtarı; bir CloudFormation şablonu için, kaynağın mantıksal kimliği, yani Resources altındaki anahtarı. Bir şablondur.
namespacestringhayırGirdinin yalnızca belirli bir ad alanındaki bir birimle eşleşmesi gerektiğinde, dışarıda bırakılacak birimin bulunduğu ad alanı; bir chart’ın işlenen belgelerinde olduğu gibi, çıktısında ad alanları bulunan bir sağlayıcı için geçerlidir. Yoksa veya boş dizgeye işlenirse girdi, ad alanı ne olursa olsun, kendi türünde ve adındaki bir birimle eşleşir. Bir compose dosyasında ve bir CloudFormation şablonunda ad alanı yoktur; bunların sağlayıcıları ad alanı belirten bir girdiyi reddeder. Bir şablondur.
subchartstringhayırÇıkarılacak birimin geldiği alt chart; girdinin yalnızca tek bir alt chart’ın işlediği kopyayla eşleşmesi gerektiğinde kullanılır — bir chart’ın alt chart’larından oluşması gibi, iç içe kaynaklardan oluşturulan bir kaynak için. Bir chart için alt chart’ın kendi adı ya da üst chart’ın bağımlılığının ona verdiği takma ad; iç içe bir alt chart’ın adları en dıştakinden başlayarak / ile birleştirilir: operator veya operator/webhooks. Girdi bu durumda o alt chart’ın kendi templates/ veya crds/ dizininden işlenen bir belgeyle eşleşir; ne chart’ın kendisinin işlediği bir belgeyle ne de onun içine yerleştirilmiş bir alt chart’ın işlediği bir belgeyle eşleşir. Belirtilmediğinde veya boş string olarak işlendiğinde girdi, nereden gelirse gelsin kendi türü ve adındaki bir birimle eşleşir. O adda hiçbir alt chart işlemeyen bir chart, girdiyi adlandırarak derlemeyi durdurur. Bir compose dosyasının ve bir CloudFormation şablonunun alt chart’ı yoktur ve sağlayıcıları alt chart adlandıran bir girdiyi reddeder. Bir şablon.
whenstringhayırGirdinin diğer alanlarından önce değerlendirilen satır içi Go şablonu. Yanlış sayılan bir değere işlendiğinde girdi düşürülür: diğer alanları değerlendirilmez, onun nedeniyle hiçbir şey dışarıda bırakılmaz ve eşleşmesi gerekmez. Boş veya bulunmayan bir when girdiyi korur. Doğruluk, boolean benzeri şablon çıktısı için standart uzlaşımı izler: true/True/TRUE dizgeleri, sıfırdan farklı her sayı ve boş olmayan diğer her dizge doğrudur; false/False/FALSE, boş dizge ve sıfır ise yanlıştır. İşlenemeyen bir when derlemeyi durdurur.

Ek özelliklere izin verilmez.

featurerecipe.spec.pipeline[]
ÖzellikTürZorunluAçıklama
idstringevetBu adım için programatik bir tanımlayıcı; bu işlem hattının adımları arasında benzersizdir: iki adımında aynı kimliği bildiren bir belge okunduğunda reddedilir. Aynı işlem hattının sonraki bir adımı bu adımın çıktılarını .steps.<id>.outputs olarak okur. Desen: ^[a-zA-Z0-9_]+$.
pluginstringevetBu adımın çalıştırdığı Plugin varlığına başvuru; her zaman eklentinin kendi soket türüyle kapsamlandırılır: isteğe bağlı bir sürümle birlikte <pluginType>/<name>, örneğin parser/yaml veya parser/yaml:1.0.0. Kapsam, birkaç biçimden biri değil, zorunludur: kapsamsız bir name:version reddedilir, çünkü iki soket aynı adda bir eklenti barındırabilir ve varlığı çözümlenebilir kılan kapsamdır. Derleme, varlığı içerik adresli .wasm yapıtına çözümler — yapıtın konumu eklentinin kimliğinden ve yapılandırılmış kayıt defterinden bulunur, özeti kilit dosyasında sabitlenir — ve baytları yükler. Çıplak bir .wasm veya yapıt başvurusu burada kabul edilmez.
functionstringevetÇağrılacak dışa aktarılmış Wasm işlevi.
withstringhayırBu eklentinin açık girdi şemasını tam olarak karşılayan bir JSON/YAML eşlemine değerlendirilen satır içi Go şablonu.
optionalbooleanhayırtrue olduğunda, bu adımın bir hatası (bir konuk tuzağı, kümede bulunmayan bir belgeyi hedefleyen bir yama, hatalı biçimlendirilmiş bir yama veya durdurma önem düzeyinde bir tanılama) belirgin bir uyarıya indirgenir: adım öncesi belge kümesi geri yüklenir, bu adımın çıktısı atılır ve işlem hattı devam eder. false olduğunda veya bulunmadığında, herhangi bir adım hatası adım öncesi belge kümesi geri yüklendikten sonra derlemeyi durdurur.
whenstringhayırİşlem hattında ilerlenirken değerlendirilen satır içi Go şablonu. Yanlış sayılan bir değere işlendiğinde adım atlanır ve doğrudan geçiş olur: belge kümesi bir sonraki adıma değişmeden akar; hiçbir yama, yan etki veya adım kaydı eklenmez. Boş veya bulunmayan bir when adımı her zaman çalıştırır. Doğruluk, boolean benzeri şablon çıktısı için standart uzlaşımı izler: true/True/TRUE dizgeleri, sıfırdan farklı her sayı ve boş olmayan diğer her dizge doğrudur; false/False/FALSE, boş dizge ve sıfır ise yanlıştır. when ve optional birbirinden bağımsızdır: bir adım ikisini birden bildirebilir.

Ek özelliklere izin verilmez.