Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Định tuyến xuyên ranh giới

Trang này giải thích một ý tưởng, đó là viết lại địa chỉ mà một thành phần nhận được khi thứ nó kết nối tới chạy ở nơi khác, và không phải là một workspace có thể chạy được. Mạng xuyên ranh giới trình bày điều này trong một workspace mà bạn build; hãy ghi nó vào một thư mục của riêng bạn bằng:

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

Sau đó nó in ra các lệnh cần chạy tiếp theo:

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

Khi hai thành phần được đặt trong các ranh giới khác nhau, host mà đích công bố là một chuỗi mà bản build không thể diễn giải: nó không thể biết chuỗi đó có truy cập được từ phía bên kia hay không. Vì vậy, định tuyến xuyên ranh giới là một Feature được gắn vào bên gọi, cho biết biến được tiêm nào cần viết lại, và một FeatureRecipe cho mỗi nhà cung cấp, cho biết cách viết lại biến đó. Các mảnh ghép tạo nên nó có trang riêng: injectMapping trong entities/featurerecipe.md, annotation ranh giới trong entities/release.md, và hợp đồng provides / inject / uses trong vocabulary/topology-triad.md.

Người vận hành gắn Feature vào bên gọi

Trong biến thể Kubernetes của ví dụ, Adminer và cơ sở dữ liệu của nó nằm trong hai ranh giới, mỗi bên trong một namespace riêng, và Adminer nhận địa chỉ của cơ sở dữ liệu trong ADMINER_DEFAULT_SERVER. Người vận hành gắn core/k8s-dns-resolver của thư viện chuẩn vào Adminer trong Release và nêu tên biến đó; Aggregate không thay đổi. Trích từ release-helm.yaml, đã lược bỏ chú thích:

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 viết lại biến trước khi bên gọi được render

Manifest gắn Feature với helm/k8s-dns-resolver. injectMapping của nó chạy sau khi các biến mà mỗi kết nối cung cấp đã vào vị trí và trước khi Recipe riêng của bên gọi render: nó đọc biến, tìm kết nối đã cung cấp biến đó, đọc namespace của đích từ các annotation của kết nối đó, rồi ghi lại biến với namespace làm phần định danh, là default khi đích không khai báo namespace nào:

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 }}

Như vậy, cơ sở dữ liệu công bố tên dịch vụ trần của nó, và Adminer nhận tên đó dưới dạng db-default.backend. Chỉ biến của bên gọi được viết lại: host mà đích công bố không thay đổi, và một bên gọi nằm trong chính namespace của đích vẫn truy cập được nó bằng tên trần. Một target_var không khớp với kết nối nào sẽ không tiêm gì cả. Biến thể Docker Compose của ví dụ vượt qua cùng đường nối đó theo cách khác, bằng core/compose-bridge của thư viện chuẩn.

Một bước pipeline, nhìn từ phía plugin

Một injectMapping là một template mà bản build tự đánh giá. Một FeatureRecipe hoặc một Recipe cũng có thể khai báo một pipeline: gồm các bước, mỗi bước được một plugin WebAssembly chạy sau khi render. Một bước nhận đầu vào with: của nó, đã được xử lý template theo ngữ cảnh của phần gắn kèm, cùng tập tài liệu đã render được đánh khóa; nó trả về các bản vá RFC 6902 trên các tài liệu đó, mọi tài nguyên mà nó thêm vào như tác dụng phụ, các chẩn đoán theo hình dạng chung mà mọi socket dùng để báo cáo, và các đầu ra mà một bước sau có thể đọc. Cả hai chiều đều được truyền bằng mã hóa nhị phân chuẩn tắc; hợp đồng plugin Wasm là hình dạng chính xác của từng chiều, và Khi nào nên dùng một bước pipeline cho biết khi nào một bước là công cụ phù hợp.