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:
aggrega scaffold --example cross-boundary-networkingArdından sırada çalıştırılacak komutları yazdırır:
cd cross-boundary-networkingaggrega pull --release release-compose.yaml --catalog catalog-composeaggrega build --release release-compose.yaml --catalog catalog-composeaggrega pull --release release-helm.yaml --catalog catalog-helmaggrega 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.