Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Perutean lintas batas

Halaman ini menjelaskan satu gagasan, yaitu penulisan ulang alamat yang diterima sebuah komponen ketika apa yang dihubunginya berjalan di tempat lain, dan bukan workspace yang dapat dijalankan. Jaringan lintas batas menunjukkannya dalam workspace yang Anda build; tulis ke folder Anda sendiri dengan:

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

Kemudian ia mencetak perintah yang dijalankan berikutnya:

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

Ketika dua komponen ditempatkan di batas yang berbeda, host yang dipublikasikan target adalah string yang tidak dapat ditafsirkan oleh build: build tidak dapat mengetahui apakah string tersebut dapat dijangkau dari sisi lain. Karena itu, perutean lintas batas adalah sebuah Feature yang dipasang pada pemanggil, yang menyatakan variabel terinjeksi mana yang perlu ditulis ulang, dan sebuah FeatureRecipe untuk setiap penyedia, yang menyatakan cara menulis ulangnya. Bagian-bagian penyusunnya memiliki halaman sendiri: injectMapping di entities/featurerecipe.md, anotasi batas di entities/release.md, dan kontrak provides / inject / uses di vocabulary/topology-triad.md.

Operator memasang Feature pada pemanggil

Dalam varian Kubernetes contoh ini, Adminer dan basis datanya berada di dua batas, masing-masing dalam namespace sendiri, dan Adminer menerima alamat basis data di ADMINER_DEFAULT_SERVER. Operator memasang core/k8s-dns-resolver dari pustaka standar pada Adminer di Release dan menyebutkan variabel tersebut; Aggregate tidak berubah. Dari release-helm.yaml, tanpa komentar:

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 menulis ulang variabel sebelum pemanggil di-render

Manifest mengikat Feature ke helm/k8s-dns-resolver. injectMapping-nya berjalan setelah variabel yang dikirim setiap koneksi sudah tersedia dan sebelum Recipe milik pemanggil itu sendiri me-render: ia membaca variabel, menemukan koneksi yang mengirimkannya, membaca namespace target dari anotasi koneksi tersebut, lalu menulis kembali variabel itu dengan kualifikasi namespace, default jika target tidak mendeklarasikannya:

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

Jadi basis data memublikasikan nama layanannya yang polos, dan Adminer menerimanya sebagai db-default.backend. Hanya variabel pemanggil yang ditulis ulang: host yang dipublikasikan target tidak berubah, dan pemanggil di namespace milik target sendiri tetap menjangkaunya dengan nama polos. target_var yang tidak cocok dengan koneksi apa pun tidak menginjeksi apa pun. Varian Docker Compose contoh ini melintasi sambungan yang sama dengan cara lain, dengan core/compose-bridge dari pustaka standar.

Langkah pipeline, dari sisi plugin

injectMapping adalah template yang dievaluasi oleh build itu sendiri. FeatureRecipe atau Recipe juga dapat mendeklarasikan pipeline: yang terdiri atas langkah-langkah, masing-masing dijalankan oleh plugin WebAssembly setelah rendering. Sebuah langkah menerima input with:-nya, yang sudah diproses sebagai template terhadap konteks pemasangan, serta himpunan dokumen ter-render yang berkunci; langkah itu mengembalikan patch RFC 6902 terhadap dokumen-dokumen tersebut, sumber daya apa pun yang ditambahkannya sebagai efek samping, diagnostik dalam bentuk bersama yang digunakan setiap soket untuk melapor, dan output yang dapat dibaca langkah berikutnya. Kedua arah dikirim dalam encoding biner kanonis; kontrak plugin Wasm adalah bentuk persis masing-masing, dan Kapan menggunakan langkah pipeline menjelaskan kapan sebuah langkah merupakan alat yang tepat.