appliesTo ve seçiciler
Değiştirici sistemi, bir Feature’ın hangi düğümlere bağlanacağını belirler. Bir Feature etiket seçicileri bildirir; derleyicinin yerleşik etiket eşleştirme motoru bunları statik analiz aşamasında her hedef Component’in metadata.labels alanına karşı değerlendirir. Aynı motor ve aynı seçici dilbilgisi, düğümler arası tür güvenliği için usesSchema soket seçicilerini de değerlendirir; böylece dildeki her seçici yüzeyine tek bir sözcük dağarcığı hizmet eder.
İki zarf
Bir Feature spec’i en fazla iki seçici alanı taşır:
appliesTo— VE bileşimi yüzeyi. Tek bir Kubernetes tarzı etiket seçici dizesidir; bağlamanın geçerli olması için virgülle ayrılmış her gereksinimin sağlanması gerekir.appliesToAnyOf— VEYA bileşimi yüzeyi. Seçici öğelerinden oluşan bir listedir; eşleşen herhangi tek bir öğe bağlamayı karşılar. Her öğe ya dize biçiminde bir seçicidir (appliesToile aynı dilbilgisi; dizenin içindeki gereksinimler VE ile birleşir) ya da yalnızca eşitlikle eşleştirilen düz bir anahtar-değer eşlemidir.
Bir Feature ikisini de bildirdiğinde sonuçlar zarflar arasında VE ile birleşir: appliesTo dizesi sağlanmalı ve en az bir appliesToAnyOf öğesi eşleşmelidir. Atlanmış ya da boş bir seçici hiçbir kısıt bildirmez ve her etiket kümesiyle eşleşir; iki alandan hiçbirini taşımayan bir Feature, geliştiricinin onu koyduğu her yere bağlanır.
spec: appliesTo: "compliance.aggrega.ai/scope in (pci), tier notin (dev, staging)" appliesToAnyOf: - { component.aggrega.ai/type: stateful-server } - "datastore.aggrega.ai/engine in (relational, document, vector)"Dize dilbilgisi
Seçici dizesi, kubectl get -l komutunun kabul ettiği etiket seçici sözdizimini izler: virgülle ayrılmış, VE ile birleşen ve her biri altı biçimden birinde olan gereksinimler:
| Biçim | Anlam |
|---|---|
key=value | etiket tam olarak bu değerle mevcuttur |
key!=value | etiket yoktur ya da farklı bir değerle mevcuttur |
key in (v1, v2) | etiketin değeri kümedekilerden biridir |
key notin (v1, v2) | etiket yoktur ya da değeri kümenin dışındadır |
key | etiket mevcuttur (herhangi bir değerle) |
!key | etiket yoktur |
Anahtarlar DNS tarzı önekler taşıyabilir (team.aggrega.ai/owner). İşleç dağarcığı altı öğeli kapalı bir kümedir; motor düzenli ifade, alt dize ya da sayısal karşılaştırma desteklemez.
appliesTo: "component.aggrega.ai/type in (server, worker), !legacy.aggrega.ai/exempt"Altı biçimin dışındaki bir gereksinim reddedilir, asla tahmin edilmez:
- Boş bir gereksinim — baştaki, sondaki ya da yinelenen bir virgül veya yalnızca ayırıcılardan oluşan bir dize.
"tier=frontend,"ve" , , "daha az gereksinim ya da hiç gereksinim yokmuş gibi okunmaz, reddedilir. - Boşluk ya da dilbilgisinin kendi karakterlerinden birini taşıyan bir anahtar —
=,!,(,)ve virgül; bunlar bir biçimi diğerinden ayıran karakterlerdir.!yalnızca bir etiket anahtarını adlandırır, bu yüzden!tier=frontendreddedilir: ön yüzleri dışlamak için yazılmış olsa da aksi hâlde “tier=frontendadlı etiket yoktur” olarak okunurdu ve bunu her bileşen karşılar. Bir değertier!=frontendile dışlanır. Aynı şekildetier in frontendreddedilir (bir kümetier in (frontend)olarak yazılır),tier: frontendde reddedilir. - Kapatılmamış bir küme —
)olmadanin (ya danotin (.
Bir değer herhangi bir karakter kümesine bağlı tutulmaz: işleçten sonraki metindir, çevresindeki boşluklar kaldırılır ve etiketin yazıldığı hâliyle değeriyle karşılaştırılır. Dolayısıyla tier==frontend, değeri =frontend olan bir etiket ister; == eşitliğin ikinci bir yazımı değildir. Yukarıdaki anahtar kuralının ötesinde ne anahtar ne de değer değerlendirilir; etiketler, motorun karşılaştırdığı opak dizelerdir.
Doğrulamanın yeri
Bir seçiciyi, bilerek farklı katılıkta olan iki katman denetler:
- JSON Schema
patterngevşek bir dış kapıdır. Feature şemasıappliesToalanını (ve dize biçimindekiappliesToAnyOföğelerini), yalnızca açıkça bozuk biçimleri reddeden sınırlayıcı bir desenle dize olarak bildirir. Bilerek hoşgörülüdür; şema, motorun değerlendireceği bir seçiciyi asla reddetmez. - Ayrıştırıcı doğrulayıcıdır. Dilbilgisi derleyicinin seçici ayrıştırıcısına aittir: reddettiği bir seçici (yukarıdaki biçimlerden herhangi biri), seçiciyi, onu bildiren Feature’ı, soketi ya da yuvayı ve okuyamadığı gereksinimi adlandıran bir tanılamayla derlemeyi durdurur. Ayrıştırma hataları yüksek sesli ve belirgindir, asla sessizce atlanmaz. Bir derlemede ayrıştırıcı, bir seçicinin değerlendirildiği yerde çalışır (bir Feature’ın her bağlanmasında, bir soket üzerinden bağlanan her kenarda, bir yuvanın her doldurulmasında).
aggrega validate, tüm katalog ya da tek bir Component veya Feature üzerinde, varlığın belgesinin bildirdiği her soket ve yuva seçicisini de okur; bu yüzden hiçbir şeyin kullanmadığı bir soket veya yuva üzerindeki bozuk bir seçici orada, bir derlemenin kullandığı kod ve sözcüklerle reddedilir. Hiçbir şeyin bağlanmadığı bir Feature üzerindeki bozuk birappliesTo, bir şey ona bağlanana dek bildirilmez.
Ayrıştırılan ama eşleşmeyen bir seçici kendi başına bir hata değildir; karşılanmamış bir kısıttır. Statik analizde, hedef etiketleri Feature’ın seçicilerini karşılamayan her Feature bağlaması; özellik örneğini, hedef düğümü, etiketlerini ve kısıtı adlandıran bir ihlal tanılaması üretir. Çözümleyici durmadan önce tüm ihlalleri toplar, böylece tek bir derleme hepsini ortaya çıkarır.
Derleyicinin yapmadıkları
Derleyici etiket anlamlarından bağımsızdır. Bulduğu etiket dizeleri ne olursa olsun değerlendirir; component.aggrega.ai/type anahtarını özel olarak tanımaz, bir kategori değerinin standart kataloğun kapalı kümesine ait olduğunu doğrulamaz ve anahtar adlarından anlam çıkarmaz. Etiket dağarcığının kendisi (operasyonel tür sözleşmesi, bilişsel kategori ekseni, rol başına yetenek etiketleri), derleyici tarafından değil, katalog yazarları ve yayımlama denetleyicisi tarafından sürdürülen bir standart kütüphane uzlaşımıdır. Kendi kataloglarını yazan kuruluşlar kendi etiket dağarcıklarını tanımlamakta özgürdür; seçici motoru onu aynı şekilde değerlendirir. Standart kataloğun kullandığı üç eksenli etiket şeması için bkz. architecture/13-catalog-and-registry.md; etiket başına anlatım için bkz. architecture/09-ai-features.md §1.2.
Dil genelinde seçici akrabalığı
usesSchema soket seçicileri (selector: "component.aggrega.ai/type=stateful-server") ve bunlardan sentezlenen x-aggrega-selector: açıklamaları, Feature appliesTo ile aynı dilbilgisini ve aynı motoru kullanır. Yazım bilgisi bire bir aktarılır: soket seçicisi olarak çalışan bir dize, bağlama seçicisi olarak da çalışır. Soket tarafındaki anlatım için bkz. topology-triad.md ve entities/component.md.
Feature tarafındaki yazım yüzeyi (spec alanları, işlenmiş bağlama örnekleri ve extends kalıtımıyla etkileşim) için bkz. entities/feature.md §Label-Based Attachment.