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

Sınırlar arası yönlendirme

Bu sayfa tek bir fikri açıklar: bir bileşenin bağlandığı şey başka bir yerde çalıştığında bileşenin aldığı adresin yeniden yazılması; bu sayfa çalıştırılabilir bir çalışma alanı değildir. Sınırlar arası ağ bunu derlediğiniz bir çalışma alanında gösterir; bunu kendi klasörünüze şu komutla yazın:

Terminal window
aggrega scaffold --example cross-boundary-networking

Ardından sırada çalıştırılacak komutları yazdırır:

Terminal window
cd cross-boundary-networking
aggrega pull --release release-compose.yaml --catalog catalog-compose
aggrega build --release release-compose.yaml --catalog catalog-compose
aggrega pull --release release-helm.yaml --catalog catalog-helm
aggrega build --release release-helm.yaml --catalog catalog-helm

İki bileşen farklı sınırlara yerleştirildiğinde, hedefin yayımladığı host, derlemenin yorumlayamadığı bir dizedir: derleme, dizenin diğer taraftan erişilebilir olup olmadığını anlayamaz. Bu nedenle sınırlar arası yönlendirme, hangi enjekte edilen değişkenin yeniden yazılması gerektiğini söyleyen, çağırana eklenmiş bir Feature ile bunun nasıl yeniden yazılacağını söyleyen, her sağlayıcı için bir FeatureRecipe’dir. Onu oluşturan parçaların kendi sayfaları vardır: entities/featurerecipe.md içinde injectMapping, entities/release.md içinde sınır ek açıklamaları ve vocabulary/topology-triad.md içinde provides / inject / uses sözleşmesi.

Operatör Feature’ı çağırana ekler

Bu örneğin Kubernetes varyantında Adminer ve veritabanı, her biri kendi ad alanında olmak üzere iki sınırda bulunur ve Adminer veritabanının adresini ADMINER_DEFAULT_SERVER içinde alır. Operatör, standart kütüphanenin core/k8s-dns-resolver öğesini Release’te Adminer’a ekler ve o değişkeni adlandırır; Aggregate değişmez. Yorumları çıkarılmış release-helm.yaml dosyasından:

spec:
boundaries:
frontend:
directory: frontend
annotations:
aggrega.ai/namespace: "frontend"
components:
adminer:
features:
dns-resolver:
type: core/k8s-dns-resolver:1.0.0
infra:
target_var: ADMINER_DEFAULT_SERVER
backend:
directory: backend
annotations:
aggrega.ai/namespace: "backend"

FeatureRecipe, değişkeni çağıran oluşturulmadan önce yeniden yazar

Manifest, Feature’ı helm/k8s-dns-resolver öğesine bağlar. Onun injectMapping alanı, her bağlantının ilettiği değişkenler yerine oturduktan sonra ve çağıranın kendi Recipe’si oluşturmadan önce çalışır: değişkeni okur, onu ileten bağlantıyı bulur, hedefin ad alanını o bağlantının ek açıklamalarından okur ve değişkeni ad alanıyla nitelenmiş olarak geri yazar; hedef hiçbirini bildirmediğinde default kullanılır:

spec:
capability: helm
implements: core/k8s-dns-resolver:1.0.0
injectMapping: |
{{- $base_host := optional .context.inject.env .infra.target_var "" }}
{{- $target_edge := dict }}
{{- range $alias, $edge := .context.uses }}
{{- if hasKey $edge.inject.env $.infra.target_var }}
{{- $target_edge = $edge }}
{{- end }}
{{- end }}
{{- $ns := "default" }}
{{- if $target_edge.annotations }}
{{- $raw := optional (optional (default dict $target_edge.annotations) "release" dict) "aggrega.ai/namespace" (optional (optional (default dict $target_edge.annotations) "aggregate" dict) "aggrega.ai/namespace" "") }}
{{- if $raw }}{{- $ns = $raw }}{{- end }}
{{- end }}
{{- if and $target_edge $base_host }}
env:
"{{ .infra.target_var }}": "{{ $base_host | replace "\\" "\\\\" | replace "\"" "\\\"" }}.{{ $ns }}"
{{- end }}

Böylece veritabanı yalın hizmet adını yayımlar ve Adminer onu db-default.backend olarak alır. Yalnızca çağıranın değişkeni yeniden yazılır: hedefin yayımlanan host değeri değişmez ve hedefin kendi ad alanındaki bir çağıran ona hâlâ yalın adla ulaşır. Hiçbir bağlantıyla eşleşmeyen bir target_var hiçbir şey enjekte etmez. Bu örneğin Docker Compose varyantı aynı birleşim noktasını başka bir yoldan, standart kütüphanenin core/compose-bridge öğesiyle aşar.

Eklenti tarafından bakıldığında bir işlem hattı adımı

Bir injectMapping, derlemenin kendisinin değerlendirdiği bir şablondur. Bir FeatureRecipe ya da bir Recipe, her biri oluşturmadan sonra bir WebAssembly eklentisi tarafından çalıştırılan adımlardan oluşan bir pipeline: da bildirebilir. Bir adım, eklemenin bağlamına göre önceden şablonu işlenmiş with: girdisini ve oluşturulmuş belgelerin anahtarlı kümesini alır; bu belgelere karşı RFC 6902 yamalarını, yan etki olarak eklediği tüm kaynakları, her soketin raporlama yaptığı ortak biçimdeki tanılamaları ve sonraki bir adımın okuyabileceği çıktıları döndürür. Her iki yön de kanonik ikili kodlamayla taşınır; Wasm eklenti sözleşmesi her birinin tam biçimidir ve Bir işlem hattı adımına ne zaman başvurulmalı bir adımın ne zaman doğru araç olduğunu söyler.