콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

경계 간 라우팅

이 페이지는 하나의 개념, 즉 컴포넌트가 연결하는 대상이 다른 곳에서 실행될 때 컴포넌트가 받는 주소를 다시 쓰는 것을 설명하며, 실행 가능한 워크스페이스가 아닙니다. 경계 간 네트워킹은 빌드할 수 있는 워크스페이스에서 이를 보여 줍니다. 다음 명령으로 자신의 폴더에 작성합니다:

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

그런 다음 이어서 실행할 명령을 출력합니다:

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

두 컴포넌트가 서로 다른 경계에 배치되면, 대상이 게시하는 host는 빌드가 해석할 수 없는 문자열입니다. 빌드는 그 문자열이 다른 쪽에서 도달 가능한지 알 수 없습니다. 따라서 경계 간 라우팅은 어떤 주입 변수를 다시 써야 하는지 알려 주는, 호출자에 연결된 Feature와, 그것을 어떻게 다시 쓰는지 알려 주는, 프로바이더마다 하나씩 있는 FeatureRecipe로 이루어집니다. 이를 구성하는 요소에는 각각 별도의 페이지가 있습니다. injectMapping은 entities/featurerecipe.md, 경계 어노테이션은 entities/release.md, provides / inject / uses 계약은 vocabulary/topology-triad.md에 있습니다.

운영자는 Feature를 호출자에 연결합니다

예제의 Kubernetes 변형에서 Adminer와 그 데이터베이스는 각각 자체 네임스페이스에 있는 두 경계에 놓이며, Adminer는 데이터베이스의 주소를 ADMINER_DEFAULT_SERVER로 받습니다. 운영자는 Release에서 표준 라이브러리의 core/k8s-dns-resolver를 Adminer에 연결하고 그 변수를 지정합니다. Aggregate는 바뀌지 않습니다. 주석을 생략한 release-helm.yaml에서:

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는 호출자가 렌더링되기 전에 변수를 다시 씁니다

Manifest는 Feature를 helm/k8s-dns-resolver에 바인딩합니다. 그 injectMapping은 각 커넥션이 전달하는 변수가 자리 잡은 뒤, 호출자 자체의 Recipe가 렌더링되기 전에 실행됩니다. 변수를 읽고, 그 변수를 전달한 커넥션을 찾고, 그 커넥션의 어노테이션에서 대상의 네임스페이스를 읽은 다음, 네임스페이스로 한정한 변수를 다시 기록합니다. 대상이 네임스페이스를 선언하지 않으면 default를 사용합니다:

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

따라서 데이터베이스는 한정되지 않은 서비스 이름을 게시하고, Adminer는 이를 db-default.backend로 받습니다. 호출자의 변수만 다시 쓰입니다. 대상이 게시한 host는 바뀌지 않으며, 대상과 같은 네임스페이스에 있는 호출자는 여전히 한정되지 않은 이름으로 대상에 도달합니다. 어떤 커넥션과도 일치하지 않는 target_var는 아무것도 주입하지 않습니다. 예제의 Docker Compose 변형은 표준 라이브러리의 core/compose-bridge로 같은 이음매를 다른 방식으로 넘습니다.

플러그인 쪽에서 본 파이프라인 단계

injectMapping은 빌드가 직접 평가하는 템플릿입니다. FeatureRecipe나 Recipe는 단계로 이루어진 pipeline:도 선언할 수 있으며, 각 단계는 렌더링 후 WebAssembly 플러그인이 실행합니다. 단계는 연결의 컨텍스트에 대해 이미 템플릿 처리된 with: 입력과, 렌더링된 문서의 키 지정 집합을 받습니다. 그리고 그 문서에 대한 RFC 6902 패치, 부수 효과로 추가하는 리소스, 모든 소켓이 보고에 사용하는 공통 형태의 진단, 이후 단계가 읽을 수 있는 출력을 반환합니다. 두 방향 모두 정규 바이너리 인코딩으로 전달됩니다. 각각의 정확한 형태는 Wasm 플러그인 계약에 있으며, 파이프라인 단계를 사용해야 할 때는 단계가 적합한 도구인 경우를 설명합니다.