Sözcük dağarcığına genel bakış
Aggrega’nın varlıklarında küçük bir anahtar sözcük kümesi tekrar tekrar karşınıza çıkar. Sözcük dağarcığı bölümleri, bunları her varlık sayfasında yeniden açıklamak yerine, her anahtar sözcük ailesi için anlatımı tek bir yerde toplar. Bu anahtar sözcüklerden birini kabul eden her varlık, bunu bu bölüm kümesinin belirttiği anlamla aynı şekilde yapar.
Sözcük dağarcığı dört aileye ayrılır: düğümler arasında açık topolojik kenarlar kuran ve derleyicinin aktardığı enjeksiyon sözleşmesini taşıyan topoloji üçlüsü (provides, inject, uses); dört veri kaygısını — geliştirici niyeti, fiziksel boyutlandırma, ortama özgü ayarlar ve Recipe’e özel durum — birbirinden ayıran veri sütunları (values, infra, parameters, locals); katalog varlıklarını birleştiren ve bir Recipe’nin hangi Component’i uyguladığını bildiren kalıtım ve arayüz anahtar sözcükleri (extends, implements); ve bir Feature’ın etiket seçicileri aracılığıyla hangi düğümlere eklendiğini belirleyen değiştirici sistemi (appliesTo, appliesToAnyOf). Sütunların kaygıları nasıl ayırdığına ilişkin kavramsal çerçeve ../architecture/06-data-taxonomy-and-composition.md sayfasında; topoloji çözümleme mekanizması ise ../architecture/07-dependency-resolution.md sayfasında yer alır.
Konu bazında başvuru
- Topoloji üçlüsü:
provides,inject,uses— enjeksiyon sözleşmesi ve açık topolojik kenar bildirimleri. Kısa ve ayrıntılı inject sözdizimini, şablonların okuduğu.context.inject/.context.usesaktarım biçimlerini ve Ops’u nil işaretçi paniklerinden koruyan çift durumlu bağlamı kapsar. - Veri sütunları:
values,infra,parameters,locals— dört veri sütunu ve bunların sahipliği. Geliştiriciye aitvaluesveparameters, Ops’a aitinfra, Recipe’e özellocalsve ortama özgü farklılıklar için parametre yukarı taşıma örüntüsü. - Kalıtım ve arayüz:
extends,implements—extendsaracılığıyla katalog varlığı kalıtımı (Components ve Features için ortak olan YAML zarfı derin birleştirmesi, genişleten bir Component’in temelinden bütün olarak devraldığı veri sütunları ve bir Feature’ın şemasının geçtiği JSON Schema 2020-12 bileşimi) ve Recipe’ten Component’e bildirim olanimplements(tam, sürüm aralıklı ve sürümsüz biçimler); Manifest’in eşlemesi bu bildirime göre denetlenir —implementsasla bir Recipe seçmez. - Değiştirici sistemi:
appliesTove seçiciler — Feature ekleme seçicileri, yerel Go etiket eşleştirme motoru, dize biçimli seçici dilbilgisi ve VEYA ile birleştirenappliesToAnyOfvaryantı. - Dört ailenin dışında: kompakt biçimde yazım, belgeler arası başvurular, etiketler ve ek açıklamalar, yayımlama yüzeyi, toplumsal sözleşmeler, doğrulama yüzeyi, çıktı bileşimi, URI dilbilgisi ve sürüm çözümleme.