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

Yerleşik etiketleme eklentileri

CLI’ye derlenmiş, yazılacak bir politika olmadan bir derlemenin düğümlerine etiket yazan iki yönetişim eklentisi: her birinin ne okuduğu, ne yazdığı ve her birinin yazdığı etiketlerle birlikte bir bağlama örneği.

CLI, yazılacak bir politika dili olmadan yalnızca yapılandırmayla etiketleri şekillendiren iki yönetişim eklentisi içerir:

PluginYazdığı
governance/label-injectorbir kural listesinin, etiketleri kurala uyan her düğümde ayarladığı etiketler
governance/selector-taggertek bir etiket, tag; değerini her düğüme bir Component adları eşlemi verir

Her ikisi de herhangi bir yönetişim eklentisi gibi, çalışma alanı yapılandırmasındaki plugins.governance üzerinden bağlanır (bkz. Bir politikayı bağlama) ve her ikisi de gömülü eklentiler arasında listelenir. Bu sayfadaki bağlamalar 0.9.0 sürümünü belirtir; bu, her eklentinin standart kütüphane kataloğundaki Plugin varlığının sürümüdür. Derleme, CLI’ye derlenmiş eklentiyi kullanır.

İkisinin ortak noktaları

Yalnızca label-transform rolüne hizmet ederler. Her biri etiket değişikliklerini etiket şekillendirme rolünde, derleme grafiği oluşturulduktan sonra ve değerlendirilmeden önce bildirir (bkz. dönüşüm rolleri). Başka bir role bağlandığında, o rol için bir dışa aktarım bildirmediğinden ikisi de çalışmadan önce reddedilir. ir-verdict rolünde derleme şu iletiyle durur:

[E0085]
ir-verdict: plugin "governance/label-injector:0.9.0": call "verdict_ir": wasm: plugin "label-injector" does not declare export "verdict_ir" in describe(): wasm: plugin rejected by the sandbox
[E0085]
ir-verdict: plugin "governance/selector-tagger:0.9.0": call "verdict_ir": wasm: plugin "selector-tagger" does not declare export "verdict_ir" in describe(): wasm: plugin rejected by the sandbox

render-verdict ve annotation-transform rollerinde ret aynı E0085 hatasıdır; yalnızca bunun yerine verdict_render ve transform_annotations adlarını verir.

Bir düğümün etiketlerini ve Component’ini okurlar, başka hiçbir şeyi okumazlar. Bir düğümün etiketleri, eklenti çalıştığında taşıdığı etiketlerdir: Component’inin kendi etiketleri ve ondan önce listelenen dönüşümlerin yazdıkları. Düğümün Component’i, Aggregate’in type: alanının ona verdiği addır; örneğin core/datastore/mariadb. İki eklenti de bir düğümün değerlerini, Release’i ya da onun ortamını okumaz: ikisinden birinin bir düğüme yazdığı şey yalnızca o düğümün etiketlerinden ve Component’inden çıkar.

Etiket yazarlar, yalnızca etiket. İki eklentiden birinin bildirdiği her değişiklik, derlemenin bir düğümündeki tek bir etiketi dize değeriyle adlandırır. Düğümün zaten taşıdığı bir etiketi yazmak değerini değiştirir — bir Component’in kendi etiketi de buna dahildir. İkisi de bir etiketi kaldırmaz; bir değeri, bir düğümün Component’ini veya sürümünü ya da düğüm kümesini değiştiremez: etiket şekillendirme rolü bu türden bir değişiklik sunmaz (bkz. Etiketleri şekillendirme).

Ayarları çalışmadan önce denetlenmez. İkisi de settings için bir şema bildirmez, bu nedenle derleme ayarları yazıldığı gibi eklentiye verir. Eklentinin okumadığı bir anahtar yok sayılır — yanlış yazılmış bir rules hiçbir şey ayarlamaz ve derleme tamamlanır — oysa eklentinin okuduğu bir anahtar başka türde bir değer taşıyorsa derleme, eklentiyi, ardından decode settings: ifadesini ve nedeni belirten bir iletiyle durur.

sources altındaki dosyaları dosya adı sırasıyla YAML olarak okurlar. Bağlama dosyaları hangi sırayla listelerse listelesin eklenti, dosyaları dosya adına göre sıralanmış olarak alır. Geçerli YAML olmayan bir dosya derlemeyi, eklentiyi, ardından parse source "<file>": ifadesini ve ayrıştırıcının nedenini belirten bir iletiyle durdurur; içeriği eklentinin okuduğu biçimde olmayan bir dosya ise derlemeyi decode source "<file>": ve nedenle durdurur.

Bir derlemenin uyguladığı girdileri kilit dosyası tutar. Bir Release’in kilit dosyasını çözümleyen pull — aggrega pull ya da --auto-pull ile bir derleme — her bağlamanın ayarlarını ve her dosyasının içeriğini kaydeder; derleme de kaydedileni uygular. Bir bağlamanın ayarlarını veya dosyalarından birini düzenledikten sonra kilit dosyasını yeniden çözümleyin; bunu yapmayan bir derleme, kaydedilmiş girdilerin verdiği etiketleri yazmaya devam eder.

with: bloğu olmadan bağlandığında ikisi de hiçbir şey yazmaz ve derleme tamamlanır.

label-transform rolündeki birden çok bağlama listelendikleri sırayla çalışır ve her biri öncekilerin yazdığı etiketleri okur; böylece bir kural, daha önceki bir bağlamanın ayarladığı bir etikete uyabilir. examples/policy-label-transform/, her iki eklentiyi bir Rego politikasından sonra bağlar ve üçünün yazdıklarını okuyan bir hüküm de bağlar.

governance/label-injector

Etiket enjektörü, etiketleri bir kurala uyan her düğüme etiket ekler.

Etiket enjektörünün ayarları

AyarTürVarsayılanEtki
rulesbir kural listesiyokher düğüme uygulanan kurallar; kural yoksa eklenti hiçbir şey yazmaz

Her kural, etiket anahtarlarından dize değerlerine iki eşlem taşır:

AnahtarVarsayılanEtki
matchçift yokbir düğüm, listelenen her çifti, her birini o değerle taşıdığında uyar; çifti olmayan bir kural her düğüme uyar
setçift yokkuralın uyduğu her düğüme her çift yazılır

Düğümün taşımadığı bir etiket boş dize olarak karşılaştırılır; bu nedenle değeri "" olan bir match çifti, o anahtarı taşımayan bir düğüme de uyar.

Kurallar her düğüme listelendikleri sırayla uygulanır ve sonraki bir kuralın yazdığı etiket, aynı anahtar için önceki bir kuralın yazdığı değerin yerini alır.

Kuralların kaynağı

Eklenti, ayarlar en az bir kural içerdiğinde rules alanını ayarlarından okur. Hiç kural içermediğinde sources altındaki dosyaları dosya adı sırasıyla okur ve üst düzey rules listesi en az bir kural içeren ilk dosyanın kurallarını aynı biçimde alır:

rules:
- match: {}
set:
ops.example.com/owner: shop-team

Daha sonraki hiçbir dosyanın kuralları okunmaz. Ondan önce gelen ve ayrıştırılamayan bir dosya derlemeyi durdurur.

Bağlanmış etiket enjektörü ve yazdığı etiketler

Bu bağlama her düğüme bir sahip, ardından datastore kategorisindeki düğümlere bir yedekleme takvimi ve farklı bir sahip atar:

plugins:
governance:
- uri: governance/label-injector:0.9.0
role: label-transform
with:
settings:
rules:
- match: {}
set:
ops.example.com/owner: shop-team
- match:
component.aggrega.ai/category: datastore
set:
backup.example.com/schedule: nightly
ops.example.com/owner: data-team

examples/policy-label-transform/ örneğinin Aggregate’ine tek başına bağlandığında — db, core/datastore/mariadb; cache, core/datastore/redis; web, core/devtool/adminer — aggrega build --release release-production.yaml --auto-pull --ir-graph, düğümleri şunları taşıyan bir derleme grafiği yazdırır:

"db": {
"labels": {
"component.aggrega.ai/type": "stateful-server",
"component.aggrega.ai/category": "datastore",
"component.aggrega.ai/upstream-licensing": "osi-approved",
"backup.example.com/schedule": "nightly",
"ops.example.com/owner": "data-team"
},
[… omitted: the node's Component, its version and the rest of the node]
},
"cache": {
"labels": {
"component.aggrega.ai/type": "server",
"component.aggrega.ai/category": "datastore",
"datastore.aggrega.ai/engine": "kv",
"component.aggrega.ai/hosting": "mixed",
"component.aggrega.ai/upstream-licensing": "mixed",
"backup.example.com/schedule": "nightly",
"ops.example.com/owner": "data-team"
},
[… omitted: the node's Component, its version and the rest of the node]
},
"web": {
"labels": {
"component.aggrega.ai/type": "server",
"component.aggrega.ai/category": "devtool",
"component.aggrega.ai/upstream-licensing": "osi-approved",
"ops.example.com/owner": "shop-team"
},
[… omitted: the node's Component, its version and the rest of the node]
}

Her düğüm ilk kurala uydu ve shop-team değerini aldı; datastore kategorisindeki db ve cache ikinci kurala da uydu ve bu kural değeri data-team ile değiştirdi. Diğer her etiket Component’in kendi etiketidir.

governance/selector-tagger

Seçici etiketleyici her düğüme bir tag etiketi yazar; değeri düğümün Component’ine göre aranır.

Seçici etiketleyicinin eşlemi ve ayarları

Her zaman tag anahtarını yazar; anahtar yapılandırılamaz.

Eşlem, sources altındaki dosyalardan gelir. Her dosya, bir Component adından onun düğümlerinin aldığı etikete giden bir YAML eşlemidir:

core/datastore/mariadb: orders
core/datastore/redis: sessions

Her dosya dosya adı sırasıyla okunur ve sonraki bir dosyadaki girdi, önceki bir dosyadaki aynı Component’in girdisinin yerini alır. Her etiket bir dizedir: YAML’ın 3 gibi başka bir tür olarak okuduğu bir değer derlemeyi durdurur, bu yüzden onu tırnak içine alın — "3".

AyarTürVarsayılanEtki
defaultstringboşeşlem bir düğümün Component’ini listelemediğinde o düğümün aldığı etiket; boşsa böyle bir düğüm tag olmadan kalır

sources yoksa her düğüm default değerini alır.

Bağlanmış seçici etiketleyici ve yazdığı etiketler

Bu bağlama, veritabanını ve önbelleği yukarıdaki eşlem olan tags.yaml dosyasına göre, diğer her düğümü ise untagged olarak etiketler:

plugins:
governance:
- uri: governance/selector-tagger:0.9.0
role: label-transform
with:
sources:
- tags.yaml
settings:
default: untagged

Aynı Aggregate’e tek başına bağlandığında aggrega build --release release-production.yaml --auto-pull --ir-graph, düğümleri şunları taşıyan bir derleme grafiği yazdırır:

"db": {
"labels": {
"component.aggrega.ai/type": "stateful-server",
"component.aggrega.ai/category": "datastore",
"component.aggrega.ai/upstream-licensing": "osi-approved",
"tag": "orders"
},
[… omitted: the node's Component, its version and the rest of the node]
},
"cache": {
"labels": {
"component.aggrega.ai/type": "server",
"component.aggrega.ai/category": "datastore",
"datastore.aggrega.ai/engine": "kv",
"component.aggrega.ai/hosting": "mixed",
"component.aggrega.ai/upstream-licensing": "mixed",
"tag": "sessions"
},
[… omitted: the node's Component, its version and the rest of the node]
},
"web": {
"labels": {
"component.aggrega.ai/type": "server",
"component.aggrega.ai/category": "devtool",
"component.aggrega.ai/upstream-licensing": "osi-approved",
"tag": "untagged"
},
[… omitted: the node's Component, its version and the rest of the node]
}

core/devtool/adminer eşlemde olmadığından web, default değerini aldı. default ayarı olmadan web hiçbir tag taşımaz, diğer ikisi ise yukarıdaki gibi etiketlenir.

Derleyicinin yorumlamadığı yerler

Ne eklenti ne de derleyici bir sahibin, bir yedekleme takviminin veya bir etiketin ne anlama geldiğini bilir. Etiket anahtarları ve değerleri bağlamanın sağladığı dizelerdir; derleyici her eklentiye düğümleri verir, bildirdiği etiketleri uygular ve bunları derleme grafiğinde taşır; orada onlara anlamlarını, onları okuyan bir politika verir.