Role göre varlıklar
Her varlık türünün onu genellikle yazan bir rolü vardır. Bu sayfa eksiksiz haritadır: ilgi alanınızı bildiğiniz ama hangi dosyaya ait olduğunu henüz bilmediğiniz durumlarda başvurun. Rol ataması bir yol göstericidir, derleyicinin zorladığı bir şey değildir (bkz. Personalar); iyi ayrıştırılmış bir yapıda bir türün genellikle kime ait olduğunu belirtir.
Bir bakışta harita
| Rol | Varlık türleri | İlgi alanı |
|---|---|---|
| Geliştirici | Aggregate | Uygulama amacı: uygulamanın ne olduğu ve neye ihtiyaç duyduğu |
| Platform mimarı | Component, Feature | Yeniden kullanılabilir, sürümlü katalog sözleşmesi |
| Platform operasyonları | Recipe, FeatureRecipe, sağlayıcı işleyen Plugin | Provider’a özgü, işlenmiş altyapıya çeviri |
| Platform operatörü | Manifest, Release | Yönlendirme ve dağıtım bağlantıları |
| Kesişen destek | SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, Workload | Paylaşılan şekiller, uzantı kodu ve platformun sahip olduğu derleyici türü |
Geliştirici
Aggregate — geliştiricinin tek yazım yüzeyi ve uygulama topolojisinin tek doğruluk kaynağı. Uygulamanın oluştuğu bileşenleri, her birinin aldığı values değerlerini, davranışı uygulama amacı olan Features öğelerini (values değerleriyle birlikte), ortama göre değişiklik için açılan parameters değerlerini ve bileşenleri birbirine bağlayan uses kenarlarını bildirir. Fiziksel altyapıdan bilinçli olarak bağımsız kalır: Aggregate’te hiçbir şey bir bulutu, bir kümeyi veya bir sağlayıcıyı adlandırmaz. Tek bir Aggregate’in her yerde dağıtılabilmesini sağlayan, bu yetenekten bağımsızlıktır.
Platform mimarı
Component — tek bir yapı taşı türü için yeniden kullanılabilir, sürümlü bir sözleşme. Bir JSON Schema aracılığıyla, bir geliştiricinin sağlayabileceği values değerlerini, tüketicilere aktardığı provides çıktılarını ve bağlantı için açtığı usesSchema soketlerini bildirir. Components, ilkeyi ve işlemeyi yönlendiren anlamsal etiketleri taşır. Mimar, geliştiricilerin ona güvenebilmesi için Component’in sözleşmesini kararlı tutar.
Feature — bir geliştiricinin veya operatörün bir bileşene ekleyebileceği iliştirilebilir bir yetenek: bir metrik dışa aktarıcı, bir yapay zekâ ağ geçidinde hassas metnin maskelenmesi, bir kimlik bilgisi bağlaması. Bir Feature neye ihtiyaç duyduğunu ve neyle uyumsuz olduğunu bildirir; nasıl gerçekleştirildiği — ürettiği kaynaklar veya bileşeninin zaten işlediği şeye yazdığı ayarlar — FeatureRecipe’inde yer alır.
Platform operasyonları
Recipe — bir Component’in sağlayıcıya özgü gerçekleştirimi. Component’in bildirdiği değerleri şablonlar aracılığıyla somut bir sağlayıcının çıktısına — bir Helm release’i, bir Compose hizmeti, bir Terraform modülü — eşler ve provides değerlerini tüketicilere aktarır. Bir Recipe, bir Component’in bildirdiği geliştiriciye yönelik değerleri asla değiştirmez; yalnızca bunların nasıl işleneceğine karar verir.
FeatureRecipe — bir Feature’ın bağlama sırasında uygulanan, sağlayıcıya özgü gerçekleştirimi. Bir Feature iliştirmesinin belirli bir sağlayıcı için gerektirdiği kaynakları üretir veya gerektirdiği ayarları iliştirildiği bileşenin zaten işlediği şeye yazar.
Provider işleyen Plugin — bir provider, bir Recipe’in girdisini provider’a özgü manifestlere dönüştüren Wasm konuğudur. pluginType: provider değerine sahip, işlediği provider adını (adlarını) ve provider soketi sözleşmesini bildiren bir Plugin olarak sunulur. Operasyon ekibi (ya da bir plugin yazarı), Recipes’in karşısında işlenebileceği bir provider bulunsun diye provider’ları sağlar. Birlikte gelen provider’lar ve sözleşmeleri için Providers genel bakışı sayfasına bakın.
Bir Recipe’de kimlik bilgisini güvenli biçimde okuma
Bir kimlik bilgisi Recipe’ye inject kanalı .context.inject.env üzerinden, yazarının seçtiği metin ne ise o olarak ulaşır; bu nedenle bir şablonun YAML’a olduğu gibi yazamayacağı karakterler içerebilir. Çift tırnaklı bir skalerin içinde çift tırnak değeri erken bitirir, ters eğik çizgi ise bir kaçış dizisi başlatır: derleme durur ya da ters eğik çizgi sessizce kaybolur. Değerin yazıldığı yerde ikisini de kaçışlayın:
variables: {{- $env := optional (default dict .context.inject) "env" dict }} DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"optional, anahtarı kanalın eşlemesinden boş bir yedek değerle okur; böylece hiçbir şeyin teslim etmediği bir parola boş metin olarak işlenir. İki replace çağrısı önce ters eğik çizgiyi, ardından tırnağı kaçışlar; tırnağın kendi kaçışı yeniden kaçışlanmasın diye bu sırayla yapılır ve diğer her karakter olduğu gibi bırakılır. Anahtar yokken duran index ile okunan bir değere de aynı iki replace çağrısı olduğu gibi uygulanır.
Bu biçimin taşımadığı bir karakter satır sonudur. YAML, çift tırnaklı bir skalerin içindeki satır sonunu bir boşluğa katlar; bu nedenle satır sonu içeren bir kimlik bilgisi, satır sonunun bulunduğu yerde bir boşlukla teslim edilir. Bir kimlik bilgisini kendi injectMapping alanına yazan bir FeatureRecipe, onu bunun yerine tırnağı, ters eğik çizgiyi ve satır sonunu aynı şekilde taşıyan toJson üzerinden yazar; FeatureRecipe başvurusu bunu gösterir.
O FeatureRecipe, kimlik bilgisini Recipe’nin onu okuduğu mekanizmanın altına yazar — .context.inject.env için env:, file:, arg: ya da bileşenin kendi adı altındaki kendi mekanizması. .context.inject.all bir eşlemenin çıktısından asla oluşturulmaz, her zaman bu mekanizmalardan oluşturulur; dolayısıyla all: altına yazan bir eşleme hiçbir şey teslim etmezdi; bunun yerine derleme bu durumda bağlamayı, anahtarı ve FeatureRecipe’yi adlandırarak durur.
Platform operatörü
Manifest — yönlendirme katmanı. Derleyiciye, belirli bir hedef için her Component’i hangi Recipe’in gerçekleştireceğini bildirir; böylece aynı Aggregate, geliştiricinin dosyasında hiçbir değişiklik yapılmadan ortamlar arasında farklı gerçekleştirimlere yönlendirilebilir — üretim için bir bulut Recipe’i, yerel test için bir Compose Recipe’i.
Release — bir ortamın ne derlediğini kaydeden tek derleme girdisi. Aggregate’e ve Manifest’e işaret eder, geliştiricinin açtığı parameters değerlerini karşılar, girdileri operasyonel olan Features öğelerini iliştirir, geliştiricinin iliştirdiklerini infra ile boyutlandırır ve mimarın bildirdiği soketler içinde kendi kenarlarını bağlar. Bir Release, açılmış değişim noktalarını karşılar; yeni uygulama values değerleri veya yeni hesaplama kaynakları ekleyemez — bunlar yalnızca Aggregate’ten gelir.
Kesişen destek türleri
Bu türler tek bir role ait olmak yerine roller arasında yazarlara hizmet eder.
SchemaLibrary — birçok Components ve Features arasında yinelenen şema şekillerinden oluşan paylaşılan bir kütüphane. Aynı yapı (örneğin bir pod kaynakları bloğu) birçok varlıkta göründüğünde, bir mimar onu bir kez tanımlanıp güncellenmesi için bir SchemaLibrary girdisine ayırır.
MappingLibrary — Recipes ve FeatureRecipes’in yararlandığı yeniden kullanılabilir eşleme mantığından oluşan paylaşılan bir kütüphane; böylece ortak çeviri kalıpları kopyalanmak yerine tek kaynaktan yönetilir.
WorkloadLibrary — yeniden kullanılabilir Workload içeriğinden oluşan paylaşılan bir kütüphane; böylece birçok Recipes arasında yinelenen bir dağıtım şekli bir kez bildirilir ve her workload: bloğuna içe aktarılır.
ArtifactLibrary — yeniden kullanılabilir yapıt paketlerinden oluşan paylaşılan bir kütüphane: birbirine ait yardımcı çıktı dosyalarının adlandırılmış kümeleri, örneğin RBAC’ıyla birlikte bir CRD. Bir Recipe veya FeatureRecipe, bir paketi tek bir artifacts: girdisinde içe aktarır ve içindeki her dosyayı üretir.
Plugin — uzantı türü. Sağlayıcı işlemenin ötesinde Plugins, alana özgü zekâyı sağlayan WebAssembly kodunu paketler — ilke doğrulama, değiştirme, lint denetimi ve diğer soketler. Plugin yazımı, diğer tüm rolleri destekleyen bir platform ekibi ilgi alanıdır.
Workload — platformun sahip olduğu bir derleyici türüdür; bir geliştiricinin veya operatörün üst düzey bir varlık olarak elle yazdığı bir dosya değildir. Bir Recipe’in workload: bloğu içinde tüketilir; burada Recipe’in işlemede kullandığı sağlayıcı, normalleştirilmiş iş yükü şeklini kendi yerel biçimine çevirir. Recipe yazarları onunla bu blok aracılığıyla etkileşir; şekli Workload başvurusu belgeler.
Sonraki
- Aggrega dosyalarını yazma — baştan sona yazım döngüsü.
- Personalar — bu haritanın ardındaki roller.