Dil başvurusu
Aggrega’nın “ne” ve “nasıl kullanılır” kısmı. Sözdizimi, CLI çağrısı, hata kataloğu, ayrıntılı örnekler.
İlk kez anlamak için aşağıdaki bölümleri sırayla okuyun. Başvuru alt dizinleri ilgili bölümlerinin altında listelenmiştir; belirli bir varlığı, anahtar sözcüğü, provider’ı, CLI komutunu veya hatayı ararken doğrudan oraya geçin.
Bölüm sırasını okumadan önce, güncel hazırlık durumu için Dilin durumu sayfasına başvurun: hangi dil yüzeylerinin bugün kullanılabilir olduğu, hangilerinin kabul edilip henüz derleyici tarafından işlenmediği ve hangilerinin gelecek yinelemeler için planlandığı. Uyumluluk, bir sürümün şemalar, komut satırı, asistan araçları, hata kodları ve eklenti kitleri için neyi vaat ettiğini belirtir.
Varlık katmanı modeli
Aggrega’nın yazım varlık türleri, benimseme ilerleyişini yansıtan üç katmanda düzenlenmiştir (aşağıda). Bunların yanında platformun sahip olduğu Workload yer alır; bu, kendi başına bir yazım türü değildir — bir Recipe’nin sentezlenen girdisinin aldığı biçimdir ve hesaplama biçimini form: söz varlığıyla (stateless, stateful, daemon, scheduled, task, reference) ifade eder. Katmanlama bir çalışma zamanı kısıtı değil, bir belgeleme ve alıştırma mekanizmasıdır: her varlık türü dilin birinci sınıf bir öğesidir; derleyici hepsini aynı şekilde ele alır; açık kaynaklı Aggrega tüm katmanları lisanslama ya da özellik kısıtlaması olmadan destekler. Katman işaretleri yetenek değil, gezinme için “ileri düzey; gerekmiyorsa atlayın” anlamını taşır.
| Katman | Varlık türleri | Ne zaman benimsenmeli |
|---|---|---|
| Katman 1 — asgari uygulanabilir yüzey | Aggregate, Component, Recipe, Manifest, Release | 1. gün — tek başına çalışan kurucular ve küçük ekipler yalnızca Katman 1 ile çalışan yazılım yayımlar. Zihinsel model: “Bir uygulamam var; onu dağıtmak istiyorum; işte nasıl.” |
| Katman 2 — rol ayrımı | Feature, FeatureRecipe, Plugin | 30. gün — rollerin ayrıldığı küçük ekipler (geliştirici + Ops + bazen Güvenlik). Katman 2; sağlayıcı işleme Plugins (Ops, Helm, helm-chart, Compose, Terraform ve CloudFormation arasından seçim yapar), Features (Güvenlik, kimlik bilgilerini uygulama yapılandırmasından ayrı yönetir) ve FeatureRecipes (sağlayıcı başına bağlama zamanı özelleştirmesi) aracılığıyla devreye girer. |
| Katman 3 — Component’ler arası yeniden kullanım | SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary | 365. gün — ortak biçimlerin birçok varlıkta yinelendiği olgun kataloglar. Eşik resmî değildir: bir biçim (ör. PodResources) 5’ten fazla Components içinde göründüğünde ve güncellemeleri eşgüdümlemek sürtünme yarattığında, bir SchemaLibrary girdisi kendini haklı çıkarır. |
Her ilerleme isteğe bağlıdır. Tek başına çalışan bir kurucu hiçbir zaman Katman 3’e bakmaya zorlanmaz; bir kurumsal katalog ise gerektiğinde Katman 3’e tam erişime sahiptir. Katman 1, tek başına çalışan kurucu kullanım durumu için eksiksizdir — bir geliştirici yalnızca Katman 1 varlıklarını kullanarak çalışan uygulamalar yayımlayabilir. Bu güçlü bir tasarım özelliğidir: Katman 1 “derlenen bir alt küme” değil, “yazılım yayımlayan bir alt küme”dir.
Beş varlıklı Katman 1 yüzeyinin bir giriş maliyeti vardır — Aggregate + Component + Recipe + Manifest + Release, “bir YAML dosyası bırak, çalışan bir hizmet al” yaklaşımından daha fazla formalite gerektirir. Bu maliyet, Aggrega’yı ham Helm’den veya ham Terraform’dan farklı kılan dört alanlı yazım ayrımının (Geliştirici Niyeti / Platform Kataloğu / Platform Operasyonları / Yönlendirme) bedelidir. Katman 1 öğreticileri beş varlıklı kurulumu açıkça adım adım anlatır.
Katman 3 içinde, spec.templates / $instantiate: mekaniği (SchemaLibrary’deki parametrik yardımcılar) daha da ileri düzey bir alt özellik olarak belgelenmiştir. Katman 3’ü benimseyenlerin çoğu başlangıçta spec.templates mekaniğine başvurmaz; eşik “kitaplığınızda parametreli yapıyı paylaşan 6’dan fazla şema olduğunda”dır.
Okuma sırası
- Bu başvuru kaynağı nasıl kullanılır
- Adlandırma uzlaşımları
- Varlık başvurusuna genel bakış
- Katman 1: aggregate, component, recipe, manifest, release
- Katman 2: feature, featurerecipe, plugin
- Katman 3: schemalibrary, mappinglibrary, workloadlibrary, artifactlibrary
- Katmanlar arası: workload (Recipe
workload:içinde tüketilen, platformun sahip olduğu derleyici türü)
- Söz dağarcığına genel bakış
- Söz dağarcığı başvurusu: topology-triad (provides, inject, uses), data-pillars (values, infra, parameters, locals), inheritance-and-interface (extends, implements), modifier-system (appliesTo, selectors), compact-form-authoring, cross-document-ref, labels-and-annotations, publishing-surface, social-contracts, validation-surface, output-composition, uri-grammar, version-resolution
- Şablonlara genel bakış
- Providers genel bakışı
- Providers başvurusu: architecture, well-known-annotations, reference-matrix, helm, helm-chart, compose, terraform, cloudformation
- CLI’ya genel bakış
- CLI başvurusu: aggrega-build, aggrega-inspect, aggrega-pull, aggrega-lint, aggrega-auth, aggrega-cache, aggrega-config, aggrega-deprecate, aggrega-edit-document, aggrega-explain, aggrega-get-schema, aggrega-import ve içe aktarma yanıt dosyası, aggrega-login, aggrega-logout, aggrega-mcp, aggrega-pin, aggrega-plugin, aggrega-push, aggrega-push-artifact, aggrega-registry, aggrega-scaffold, aggrega-search, aggrega-serve, aggrega-sign, aggrega-skills, aggrega-validate, aggrega-version, global-flags, configuration, environment-variables, workspace-boundary
- Hatalara genel bakış
- Hata başvurusu: fatal-halts, warnings, sentinels, error-translation
- Örneklere genel bakış
- Örnek başvurusu: 01-getting-started, 02-data-model, 03-features-and-policies, 04-secrets, 05-credential-features, 06-composition, 07-input-kinds, 08-advanced-patterns, 09-cross-boundary-routing; çalıştırılabilir çalışma alanları: Çalıştırılabilir örnekler
Plugin yazma başvurusu
Wasm plugin yüzeyi bölüm dizisinin içinde değil, yanında yer alır: bir plugin yazarı onu varlık yazma yolundan bağımsız olarak okur. plugin varlık sayfası katalog yazma yüzeyini ele alır; aşağıdaki sayfalar soketleri, yükleri ve yazar iş akışını ele alır.
- plugin-contract — bir plugin’in bağlandığı soketler, bunların işlem hattındaki yerleri ve her soketin girdi ve çıktı biçimleri.
- plugin-developer-guide — uçtan uca yazar iş akışı:
describe(), yetenek bildirimleri, çalışma zamanı sınırları, publish/pull/build yaşam döngüsü, imzalama, sürümleme. - policy-socket — yönetişim soketi ayrıntılı olarak: dört rolü, karar önem düzeyleri, operatör girdi kanalı ve derleyicinin içinde gelen iki motordan herhangi biri için politika yazma.
- governance-attachment-facts — bir yönetişim politikasının derleme grafiğinden okuduğu bağlantı başına olgular; hassasiyet işaretlemesinin üç birimi ve işaretlemenin bulunmamasının neden izin anlamına gelmediği dahil.
- when-to-use-a-pipeline-step — bir işlem hattı adımı ile şablonlu bir FeatureRecipe arasında seçim yapma.
- embedded-plugins — derleyici ikili dosyasının içinde gelen plugin’ler.
- tagging-plugins — bir politika olmadan etiket yazan iki yerleşik yönetişim eklentisi,
governance/label-injectorvegovernance/selector-tagger: ayarları ve her birinin ne yazdığı. - core-importers — Langflow, Flowise ve n8n’den Compose, MCP ve ajan çatılarına kadar derleyicinin on içe aktarıcısı: her birinin ne okuduğu ve ne taslak hazırladığı, ayarları ve her derleyici sürümüyle birlikte yayımlanmaları.
- authoring-a-provider-walkthrough — boş bir dizinden, sağlayıcının işlediği dosyaları yazan bir derlemeye kadar, bir sağlayıcı konuk modülü yazmanın uygulamalı anlatımı.
- writing-a-governance-plugin — eklenti setinin bağdaştırıcı iskeletinden kendi yönetişim eklentinizi yazmak: tek bir kural, her rolün dışa aktarımının elle çalıştırılması, çalışma alanı kataloğunda bir
Pluginvarlığı ve eklentinin reddettiği bir derleme. - compatibility — eklenti kitlerinin nasıl sürümlendiği: bir kitin yama sürümünün ve ikincil sürümünün neleri değiştirebileceği ve derlenmiş bir eklentinin yüklenmeye devam etmesini neyin sağladığı.