Provider mimarisi
Bir provider, bir Recipe’in girdi türlerini provider’a özgü manifest dosyalarına dönüştürür. Bir Recipe capability: helm, capability: compose ya da başka herhangi bir provider adı bildirdiğinde, derleyici işlemeyi o adı sunan provider’a yönlendirir. Bu bölüm, bir provider’ın provider-rendering Plugin olarak nasıl gerçekleştirildiğini, yönlendirmenin nasıl işlediğini ve derleyiciyi her provider’a bağlayan plugin soketi sözleşmesini ele alır.
Bu bölümün ele almadığı konu: bir Recipe’in çıktısını üretmek için kullandığı üç girdi türlü bileşim modeli (source: + valuesMapping:, workload:, artifacts: — her biri satır içi içerik ya da $import: kabul eder). Bu model tüm provider’ları kesen ortak bir konudur ve her provider’ın hangi girdi türünü desteklediğini eşleyen Provider Yetenek Matrisi de dahil olmak üzere ../../architecture/16-recipe-input-composition.md içinde yer alır.
provider-rendering Plugin’i
Provider işleme, pluginType: provider değerine sahip bir Plugin tarafından sağlanır. provider-rendering Plugin’i:
- bir veya daha fazla provider adına hizmet verir — bu adlar
spec.provider.capabilitiesiçinde bildirilir. Bir Recipe’in belirttiği provider adı (spec.capability: helm),spec.provider.capabilitieslistesi o adı içeren provider-rendering Plugin’ine bağlanır. Aynı hedefe birden fazla Plugin hizmet verdiğinde, çalışma alanı aralarında.aggrega-config.yamliçindeki bir provider bağlamasıyla seçim yapar; bu bağlamaaggrega pullsırasında çözümlenir ve kilit dosyasına kaydedilir. Bağlama yoksa ve tam olarak bir aday varsa o aday kullanılır; bağlama yoksa ve birden fazla aday varsa derleme, aday plugin’leri adlandırarak açıkça durur. - provider soketi meta verilerini aynı blokta taşır —
spec.provider, yukarıdaki yetenek listesini provider’ın diğer bildirimleriyle birlikte tutar.spec.provider.workloadSchema, platformun sahip olduğu Workload türünün bu provider’ın yerel çıktısına nasıl dönüştürüldüğünü belgeleyen bir JSON Schema 2020-12 bildirimidir; standart kütüphane kataloğu bunu, sentezleme yapan provider’larda belgelenmiş dönüşüm sözleşmesi olarak bildirir.spec.provider.wellKnownAnnotations, provider’ın okuduğuaggrega.ai/sınır açıklamalarını listeler. Sentezlenmiş girdi (workload:) desteği, provider’ın bir özelliğidir ve işleme zamanında uygulanır —workloadSchema’nın varlığıyla belirlenmez.
spec.provider bloğu dahil olmak üzere Plugin varlığının alan düzeyindeki tüm yazım yüzeyi için ../entities/plugin.md sayfasına bakın.
Provider başına yönlendirme
Her Recipe, spec alanının en üstünde tam olarak bir capability: bildirir. Derleyici bu alanı okur ve işlemeyi bu adı sunan sağlayıcıya yönlendirir. Bir Recipe aynı anda birden fazla sağlayıcıyı hedefleyemez. Çok sağlayıcılı birleştirme Release düzeyinde gerçekleşir: bir sınır, farklı sağlayıcılara ait bileşenleri barındırabilir ve her sağlayıcının, sınırın değerlendirilmiş birleştirme yolundaki katkıda bulunanları bağımsız olarak birleştirilir — her (path, provider) çifti için bir birleştirme.
Tek bir düğüm için yönlendirme yolu:
- Derleyici, bu düğümün Recipe URI’sini hedef sağlayıcının eşleme bölümü altında Manifest’in üç katmanlı aramasıyla çözümler. “Aynı Component, farklı sağlayıcılar için farklı Recipes” kalıbını doğal kılan, Manifest’in sağlayıcı ekseninde gruplamasıdır.
- Çözümlenen Recipe’in
spec.capabilityalanı, yönlendirilecek sağlayıcı adını belirtir. - Derleyici bu ad için sağlayıcıyı bağlar:
spec.provider.capabilitieslistesi bu adı içeren sağlayıcı işleme Plugin’ini çözümler ve işlemeyi o Plugin’in konuğu üzerinden yapar. İşleme yalnızca Wasm ile yapılır — geri dönülebilecek ana makine içi bir işleyici yoktur; bu nedenle onu sunan hiçbir Plugin’e çözümlenmeyen bir sağlayıcı adı, yönlendirme sırasında derlemeyi açıkça durdurur. - Sağlayıcı, düğüm başına işleme bağlamıyla (sütun değerleri,
.context.*izdüşümleri, Recipe’in girdi türleri) çağrılır. - Sağlayıcı işlenmiş çıktıyı döndürür. Derleyici işlenmiş dosyaları, sınırın değerlendirilmiş
directory:değeriyle bileşen başınasubDirectory:değerinin birleşimine göre anahtarlanan(path, provider)başına birleştiriciye yönlendirir. Aynı sağlayıcı altında aynı yola değerlendirilen iki sınır bir birleştiriciyi paylaşır — standart kalıp, bir üst sınır iledirectory: "{{ .parent_boundary.directory }}"kullanan ve tek bir birleşik derlemede toplanan iki alt sınırdır.
Manifest’in sağlayıcı eksenli yönlendirme yapısı için ../entities/manifest.md, Recipe tarafındaki tek sağlayıcı bildirimi için ../entities/recipe.md sayfasına bakın. (path, provider) başına birleştirme modeli ve değerlendirilmiş yolları denetleyen yol şablonu değişkeni izin listesi ../path-template-variables.md sayfasında belgelenmiştir.
Wasm eklenti sözleşmesi
Provider işleme, bir WebAssembly korumalı alanı içinde çalışır. Go derleyicisi ana makinedir (host); provider-rendering Plugin’i ise misafirdir (guest). Derleyici her düğüm için eklentiye düğümün işleme bağlamını verir, eklenti de işlediği dosyaları döndürür. Bu sözleşme her provider için aynıdır:
- Her iki yönde kanonik bir ikili kodlama. Derleyici işleme bağlamını (düğümün değerleri ve ekleri, ayrıştırılmış
.workload, değerlendirilmiş yapıt girdileri, çözümlenmiş bir.sourceiçin yalnızca adlardan oluşan liste ve sınır meta verileri) kanonik CBOR (RFC 8949 §4.2.1) olarak kodlar ve eklentiye verir. Eklenti aynı kodlamayla, işlediği dosyaların listesini (her biri düğümün çıktı köküne göreli bir yol ve oraya yazılacak baytların tam kendisi, isteğe bağlı olarak dosyanın biçimiyle birlikte) olası tanılamaların yanında döndürür. Soketin tek bir düğümü işlemekten bir sınırı birleştirmeye ve sınırlar arası bir bağlantıyı kurmaya kadar her dışa aktarımı bu kodlamayı her iki yönde taşır ve her dilin eklenti geliştirme kiti bunu eklenti için çözer ve kodlar. Bu kodlamada dışa aktarımın çıktı biçiminde olmayan bir yanıt derlemeyi durdurur. Her dışa aktarımın yükü eklenti sözleşmesinde belgelenmiştir. - Dosya sistemi erişimi yok. Plugins, ana makinenin dosya sisteminden rastgele dosya okuyamaz. Bir Recipe’in adlandırdığı bir kaynak (bir kayıt defterindeki bir chart, bir depodaki bir modül) eklenti çalışmadan önce derleyici tarafından çözümlenir; eklenti bu kaynağın yalnızca adlardan oluşan bir listesini alır ve seçtiği dosyaları derleyiciden bir ana makine işleviyle ister; bu işlev yalnızca o düğümün kaynağı altındaki dosyalar için yanıt verir.
- Ağ erişimi yok. Plugins deterministik ve hermetiktir; kendi başlarına bağlantı açmazlar. Bir eklentinin işleme sırasında ihtiyaç duyduğu harici bir girdi (bir chart’ın değerlerinin başvurduğu uzak bir şema) derleyicinin harici girdi ana makine işlevi aracılığıyla istenir; bu işlev, çalışma alanının o başvuru için sabitlediği içerikten yanıt verir.
- Deterministik çıktı. Aynı girdi ve aynı eklenti sürümü verildiğinde bir eklenti bayt düzeyinde aynı çıktıyı üretmelidir. Derleyicinin bayt düzeyinde aynı çıktı garantisinin eklenti katmanı boyunca uçtan uca geçerli olmasını sağlayan sözleşme budur.
--verify-determinismile çalıştırılan bir derleme her düğümü iki kez işler ve bir düğümün iki işlemesi farklı olduğunda durur.
Derleme hattındaki diğer Wasm soketleri (yönetişim soketinin dönüştürme ve karar rolleri) dahil olmak üzere, daha geniş genişletilebilirlik düzeyindeki eklenti soketi mimarisi ../../architecture/14-extensibility.md sayfasında yer alır.
Aggrega’nın standart kütüphane sağlayıcıları
helm, helm-chart, compose, terraform ve cloudformation sağlayıcıları birlikte standart kütüphane sağlayıcı kümesini oluşturur. Kurumsal ekiplerin kendi sağlayıcılarını yazmasını gerektirmeden yaygın dağıtım hedeflerini kapsarlar.
helm üç girdi türünün tümünü destekler: sourced (Helm SDK aracılığıyla getirilen ve Recipe’in valuesMapping çıktısını chart’ın geçersiz kılma değerleri olarak kullanan bir upstream Helm chart’ı), synthesized (ayrıştırılmış bir Workload’dan üretilen düz Kubernetes YAML’ı — Workload’ın form değerine göre seçilen bir denetleyici nesnesi (Deployment, StatefulSet, DaemonSet, Job veya CronJob) ile Service’ler ve PVC’ler) ve artifacts (chart çıktısının yanında yer alan bağımsız YAML dosyaları). Üç türden hangilerini kabul ettiği için ../../architecture/16-recipe-input-composition.md içindeki Provider Capability Matrix’e (Provider yetenek matrisi) bakın.
helm-chart, kaynaklı modu (şemsiye chart birleşimi: sınır başına bir chart, bileşen başına bir alt chart) ve her iki yazım biçiminde de onunla birlikte gelen artifacts: girdisini destekler. $import: ile yüklenen bir artifacts: girdisi önce Aggrega tarafından Go şablonuyla işlenir, ardından render öncesinde chart’ın templates/ dizinine enjekte edilir; satır içi içerikli bir artifacts: girdisi ise aynı şekilde değerlendirilir ve hiçbir köken bilgisi eklenmeden alt chart köküne yerleştirilir; chart’ın kendi şablonları onu Helm’in .Files.Get / .Files.Glob işlevleriyle okur. Bağımsız, yalnızca artifacts içeren bir Recipe, bildirdiği türlerden biri değildir; sentezlenmiş tür de değildir: şemsiye chart alt chart’ları düzenler, Workload türü ise her alt chart’ın içine ait bir yaprak kavramdır (helm sağlayıcısının alanı).
compose şunları destekler: kaynaklı (bir compose dosyası yükler ve valuesMapping katmanını derinlemesine birleştirir), sentezlenmiş (stateless ve stateful biçimleri için ayrıştırılmış bir Workload’dan compose services: + volumes: + networks: üretir; persistentTemplate için birim işleme kısıtlıdır — replika başına PVC’ler bir uyarıyla tek bir paylaşılan adlandırılmış birime indirgenir; daemon, scheduled ve task biçimlerinin compose eşlemesi yoktur ve açıkça durdurulur) ve artifacts (üst düzey anahtarları services: / networks: / volumes: / configs: sınır başına birleştirilmiş docker-compose.yaml dosyasına katılan compose parçaları). Artifacts diğer iki türden herhangi birinin yanında yer alabilir; bağımsız, yalnızca artifacts içeren bir Recipe — source: ve workload: olmadan artifacts: — da bu sağlayıcının bildirdiği bir türdür: parçaları aynı kurallarla birleşir, böylece düğüm tam olarak bildirdiğini katar ve sahip olmadığı hesaplama için yerine geçecek bir Workload gerektirmez.
terraform şunları destekler: kaynaklı (bir Terraform modülünü olduğu gibi projeye dahil eder ve valuesMapping çıktısını, sınırın kök yapılandırmasındaki o bileşenin module bloğunun argümanları olarak sağlar) ve artifacts (yazılmış bir HCL veya .tf.json gövdesini, şablonu değerlendirildiği haliyle, yeniden yazmadan üretir). Sentezlenmiş girdi türünü sunmaz — platform Workload türünden rastgele Terraform kaynaklarına sadık bir eşleme yoktur. Sağlayıcı yapılandırma üretir ve Terraform’u hiçbir zaman çalıştırmaz; çalışma zamanına bağlı değerler, Terraform çalışma zamanının apply sırasında çözdüğü ${ ... } enterpolasyon dizeleri olarak kalır.
cloudformation bir sınırı tek bir AWS CloudFormation yığın şablonuna render eder: bileşenlerinin yazdığı kaynak parçalarını tek bir saf JSON şablonunda birleştirir, her bileşenin provides değerini yığın Outputs olarak sunar ve uses kenarlarını bir yığın içinde Fn::GetAtt, yığınlar arasında ise Fn::ImportValue / Fn::GetStackOutput olarak bağlar. Kaynaklı ve artifacts girdisini destekler ve CloudFormation’ı hiçbir zaman çalıştırmadan yapılandırma üretir; yalnızca çalışma zamanında bilinen değerler CloudFormation iç işlevleri olarak kalır.
Sağlayıcı başvuru dizini sizi her sağlayıcının kendi başvuru sayfasına yönlendirir; her birinin hangi girdi türlerini kabul ettiği sorusunu ../../architecture/16-recipe-input-composition.md içindeki yetenek matrisi yanıtlar.
Özel sağlayıcılar
Kendi sağlayıcılarını yazan kurumsal ekipler standart kütüphaneyle aynı kalıbı izler: hizmet verdiği sağlayıcı adını (veya adlarını) spec.provider meta verilerinin geri kalanıyla birlikte spec.provider.capabilities içinde bildiren bir sağlayıcı işleme Plugin’i (pluginType: provider) yazın, ardından yukarıdaki işleme sözleşmesini uygulayan Wasm yapıtını yayımlayın. Derleyici, özel sağlayıcıları standart kütüphane sağlayıcılarıyla aynı şekilde ele alır; sağlayıcı başına yönlendirme, Recipe’nin bildirdiği sağlayıcı adı üzerinden çalışır.
Sağlayıcı yazmak ertelenmiş değil, belgelenmiştir. Sağlayıcı yazma, çalışan bir sağlayıcı konuğunu baştan sona oluşturur: describe() öz bildirimi, derleme, Plugin varlığı, bağlama ve çıktısını okuyabileceğiniz bir işleme. Wasm eklenti geliştirici kılavuzu varlık ve yayımlama yaşam döngüsü için başvuru kaynağıdır; eklenti sözleşmesi ise her soketin yük ve sonuç biçimlerini belgeler. Konuklar, eklenti geliştirme kitine karşı Go, Rust veya TypeScript ile yazılır.