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

Aggrega Catalog (Feature) şeması

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

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

Bileşenlere dinamik olarak bağlanan modüler bir operasyonel özellik.

Feature varlıklarının yazımına ilişkin açıklayıcı rehberlik için Feature yazım başvurusuna bakın; bu sayfa, o başvurunun tanımladığı yapısal şemayı belgeler.

Üst düzey tür: object

Özellikler

ÖzellikTürZorunluAçıklama
apiVersionconst “aggrega.ai/v1beta1”evetSabit: "aggrega.ai/v1beta1"
kindconst “Feature”evetSabit: "Feature"
metadataobjectevet
specobjectevetBir katalog Feature’ı için doğrulama, hedefleme ve birlikte çalışabilirlik sözleşmesi: şema aracılığıyla yazılan serbest biçimli sütunlar (values, infra, provides), sabit biçimli sütunlar (usesSchema bağımlılık soketleri, featuresSchema ekleme yuvaları), bileşen hedefleme (appliesTo ve appliesToAnyOf) ve birlikte çalışabilirlik denetimleri.

Ek özelliklere izin verilmez.

feature.metadata

ÖzellikTürZorunluAçıklama
namestringevetEn az 1 karakter uzunluğunda.
versionstringevetÖzelliğin katı Anlamsal Sürümlemesi (ör. 1.0.0). 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.
labelsobjecthayırFeature için ördek tiplemesi etiketleri. ‘secret’ değerini taşıyan ayrılmış ‘feature.aggrega.ai/kind’ etiketi, bunu yazar ve onu gösteren araçlar için bir kimlik bilgisi Feature’ı olarak işaretler. Bir kimlik bilgisi Feature’ı ile sıradan bir Feature aynı şekilde, aynı ekleme yüzeyi altında eklenir; bir eklemenin ne ürettiğine etiket değil, Manifest’in onun türünü eşlediği FeatureRecipe karar verir.
annotationsstring eşlemihayırPlatform Mimarı tarafından Alan 2’de yazılan, değiştirilemez, özelliğe içkin nitelikler. .context.annotations.catalog kovasına doğru aşağı aktarılır.

Ek özelliklere izin verilmez.

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

Ek özelliklere izin verilmez.

feature.metadata.labels

Feature için ördek tiplemesi etiketleri. ‘secret’ değerini taşıyan ayrılmış ‘feature.aggrega.ai/kind’ etiketi, bunu yazar ve onu gösteren araçlar için bir kimlik bilgisi Feature’ı olarak işaretler. Bir kimlik bilgisi Feature’ı ile sıradan bir Feature aynı şekilde, aynı ekleme yüzeyi altında eklenir; bir eklemenin ne ürettiğine etiket değil, Manifest’in onun türünü eşlediği FeatureRecipe karar verir.

ÖzellikTürZorunluAçıklama
feature.aggrega.ai/kindstring (enum)hayırFeature türü etiketi. ‘secret’ değeri bunu bir kimlik bilgisi Feature’ı olarak işaretler. İzin verilen değerler: "secret"

feature.spec

Bir katalog Feature’ı için doğrulama, hedefleme ve birlikte çalışabilirlik sözleşmesi: şema aracılığıyla yazılan serbest biçimli sütunlar (values, infra, provides), sabit biçimli sütunlar (usesSchema bağımlılık soketleri, featuresSchema ekleme yuvaları), bileşen hedefleme (appliesTo ve appliesToAnyOf) ve birlikte çalışabilirlik denetimleri.

ÖzellikTürZorunluAçıklama
extendsstringhayırBu Feature’ın kalıtım aldığı temel Feature’a başvuru. Temeli, Feature’ın yayımlandığı kayıt koordinatıyla değil metadata.name değeriyle adlandırır ve her katalog başvurusunun aldığı üç sürüm biçimini alır: mevcut en yüksek sürüm için yalın (core/queue), tam (core/queue:1.0.0) veya şapka aralığı (core/queue:^1.0.0). Kalıtılan şey metadata’dan fazlasıdır: temelin metadata.labels ve metadata.annotations alanları, appliesTo ve appliesToAnyOf seçicileri, interoperability bloğu, usesSchema ve featuresSchema alanlarının tümü aşağıya doğru birleşir ve schema üzerindeki JSON Schema 2020-12 bildirimleri otomatik olarak birleştirilir. Ortak bir anahtarda alt öğenin kendi değeri geçerli olur ve kimlik alanları hiçbir zaman kalıtılmaz.
featuresSchemaobject eşlemihayırBildirimsel ekleme yuvası tanımları: bu Feature’ın başka bir Feature’ın eklenmesini beklediği adlandırılmış bağlama noktaları. Bir yuva, onu hangi dolgunun bağlayabileceğini (selector) ve dolgunun malzemesinin nasıl iletilebileceğini (inject) kısıtlar; dolgunun values ve infra sözleşmesi dolgunun kendi Feature’ına aittir. Bir yuva bildirmek ekleme bloğunu asla kapatmaz — bir yazar, hiçbir yuvanın bildirmediği bir ad altında Feature ekleyebilir. Yuva bir bağımlılık soketi değil, bir bağlama noktasıdır: ayrı topoloji yüzeyini usesSchema bildirir.
appliesTostringhayırComponents ile eşleşen, Kubernetes tarzı etiket seçici dizesi. Virgülle ayrılmış gereksinimlerin tümü sağlanmalıdır (AND). Desteklenen biçimler: key=value, key!=value, key in (v1, v2), key notin (v1, v2), yalın key (etiket mevcut), !key (etiket yok). Örnek: “tier in (critical, production), !legacy”. Boş veya bulunmayan bir seçici hiçbir kısıt bildirmez. Seçici, bu Feature’ın her eklemesi değerlendirildiğinde bu biçimlere göre okunur ve bunların dışındaki bir gereksinim, onu adlandırarak derlemeyi durdurur: boş bir gereksinim (baştaki, sondaki veya çift virgül) ya da boşluk veya = ! ( ) karakterlerinden herhangi birini ya da virgülü taşıyan bir anahtar — bu nedenle “!tier=frontend” reddedilir ve bir değer tier!=frontend ile dışlanır. Değer, taşıdığı karakterler ne olursa olsun, işlecinden sonraki metindir. Bu alandaki desen, herhangi bir ekleme değerlendirilmeden önce yalnızca birkaç hatalı biçimi reddeder. Desen: ^(?:[^()]*[()][\s\S]*|[ \t]*(?:![ \t]*[^,]*[^ \t,][^,]*|[^ \t,!][^,]*)?(?:,[ \t]*(?:![ \t]*[^,]*[^ \t,][^,]*|[^ \t,!][^,]*)?)*)$.
appliesToAnyOfstring veya string[] eşlemesihayırSeçicilerin listesi; öğelerden HERHANGİ biri eşleşirse Feature uygulanır (OR mantığı). Her öğe ya bir etiket seçici dizesidir (appliesTo ile aynı dilbilgisi; dize içindeki gereksinimler AND ile birleşir) ya da her çiftin eşleşmesi gereken düz bir anahtar-değer eşlemesidir (yalnızca eşitlik).
interoperabilityobjecthayırGelişmiş operasyonel güvenlik ve birlikte çalışabilirlik denetimleri.
usesSchemaobject eşlemihayırBu varlığın bildirdiği, soket adıyla anahtarlanan bağımlılık soketleri; bir soket üzerinden kurulan her bağlantı o soketin bildirimine — seçicisine ve izin verdiği inject mekanizmalarına — göre denetlenir. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi ya da kısa çizgi. Noktaya izin verilmez. Desen: ^[a-zA-Z0-9_-]+$.
schemaobjecthayırSerbest biçimli sütunları kapsayan JSON Schema 2020-12 içeriği: values (Geliştiricinin alanı — Geliştiricinin Aggregate içindeki her Feature eklemesi için yapılandırdığı uygulama biçimli parametreler); infra (Operatörün alanı — Release tarafından sağlanan fiziksel boyutlandırma ayarları) ve provides (bu Feature’ın topoloji kanalı aracılığıyla tüketicilere sunduğu aşağı akış bağlam anahtarları). İçerik biçimine göre yönlendirme ile üç yazım kipini kabul eder: (1) satır içi içerik (kompakt biçim, JSON Schema YAML veya karışık içerik taşıyan bir YAML eşlemesi); (2) {$import: } ile dosya değiştirme; tüm sözleşmeyi tek bir dosyadan sağlamak için spec.schema konumunda veya yalnızca o sütunu sağlamak için tek bir sütunda yazılır; göreli yol, onu bildiren varlığı barındıran dizine göre okunur; (3) {$ref: #/schemas/} ile yalın ad kimliğine göre bir SchemaLibrary girdisine belgeler arası başvuru (sürümü Release başına kilit dosyası sağlar; başvuruda hiçbir kayıt ana makinesi yer almaz). Eşlik eden usesSchema ve featuresSchema alanları sabit biçimli sütunları (bağımlılık soketleri, ekleme yuvaları) kapsar; derleyici bu üçünü, bir örneğin doğrulandığı tek şemada bir araya getirir.
assertionsstring eşlemihayırDerleme zamanında alanlar arası doğrulama. Her girdi adlandırılmış bir onaylamadı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 şablon dizesidir. Varlık başına birden çok adlandırılmış onaylama, örnek başına yazarın bildirdiği sırayla değerlendirilir; başarısız olan ilk onaylama derlemeyi durdurur. Feature onaylamaları çözümleme ve statik analizden sonra, işlemeden önce değerlendirilir ve sözleşmenin mimari değişmezlerini ifade eder. Şablon bağlamı: .values / .infra / .uses / .features / .metadata. Değerlendirici missingkey=error kullanır: tanımsız anahtarlara başvurular no-such-key tanılamasıyla durur. Yalın başvuru herhangi bir yedek çalışmadan önce durduğundan, düz bir default bu yüzeyde isteğe bağlı alan yedeği sağlamaz — başvuruyu hasKey ile koşula bağlayın veya varlık denetimini doğrudan yapan optional yardımcısını kullanın. Anahtarı index ile okumak da bunu sağlamaz: index, eşlemenin içermediği bir anahtarda, anahtarı adlandırarak durur.

Ek özelliklere izin verilmez.

feature.spec.interoperability

Gelişmiş operasyonel güvenlik ve birlikte çalışabilirlik denetimleri.

ÖzellikTürZorunluAçıklama
conflictsWithstring[]hayırBu Feature’ın bir bileşene birlikte ulaşamayacağı Features’ın adları; her biri, bir eklemenin türünün bir Feature’ı adlandırdığı şekilde yazılır. Bir bileşen bu Feature’ı ve burada adı geçen bir Feature’ı birlikte taşır hale geldiğinde derleme, işlemeden önce durur — her biri bileşenin üzerinde, onu barındıran bir alt sistem veya sınır üzerinde, bir Release bileşen girdisinde ya da açıklama güdümlü genişletmeyle eklenmiş olsun. Tek bir bildirim yeterlidir: durdurma için diğer Feature’ın bunu listelemesi gerekmez. Adlar sürüm çıkarılarak karşılaştırılır; bu nedenle bir girdi, adlandırdığı Feature’ın her sürümüyle eşleşir. Ortak bileşeni olmayan kardeş sınırlara eklenmiş iki Features hiçbir zaman karşılaşmaz ve durdurmaya yol açmaz.

Ek özelliklere izin verilmez.