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

모듈 경계 라우팅 — 하위 모듈 전체를 경계에 배치하기

이 예제는 Developer가 작성한 하나의 Aggregate에서 두 가지 기능, 즉 오브젝트 스토리지 위의 Thanos 메트릭 읽기 계층과 MongoDB 와이어 프로토콜을 사용하는 문서 데이터베이스를 컴파일하고, Release에서 각각을 자체 경계에 배치합니다.

두 기능은 모두 모듈입니다. 모듈은 각각 여러 단일 워크로드 컴포넌트를 구성하고 자체 내부 엣지를 연결하는 재사용 가능한 하위 aggregate입니다. Aggregate는 두 모듈의 이름만 지정하며 실행 위치에 대해서는 아무것도 지정하지 않습니다. Release는 경계마다 하나의 aggregates: 항목으로 각 모듈 전체를 배치합니다. 운영자는 모듈 내부에 무엇이 있는지 추적하거나 다시 기술하지 않고도 기능이 실행될 위치를 결정합니다.

파일

파일역할
aggregate.yaml개발자 의도: 메트릭 모듈(core/thanos)과 문서 데이터베이스 모듈(core/ferretdb)을 가져옵니다.
manifest.yaml두 모듈이 제공하는 모든 컴포넌트 유형을 해당 synth helm Recipe에, 메트릭 모듈이 연결하는 자격 증명 Feature를 모듈의 두 키 매개변수 각각으로부터 Secret을 생성하는 구현에, 그리고 scrape Feature를 해당 FeatureRecipe에 매핑합니다.
release.yaml운영자 기록: 각 모듈을 자체 경계로 라우팅하고, 한 모듈의 컴포넌트 하나의 크기를 지정하며, 그 컴포넌트에 scrape Feature를 연결합니다.

보여 주는 내용

  • 모듈 전체를 경계로 라우팅하기. 경계의 aggregates: 항목은 Aggregate 내 모듈 이름을 키로 사용합니다. 이 항목은 모듈에 포함된 모든 컴포넌트를 배치하므로, 세 메트릭 컴포넌트의 생성된 아티팩트는 모두 observability 경계 아래에, 두 문서 데이터베이스 컴포넌트의 아티팩트는 data 아래에 생성됩니다.
  • 컴포넌트를 전혀 지정하지 않는 것이 기본 형태입니다. data 경계는 빈 documents: {}로 문서 데이터베이스 모듈을 라우팅합니다. 모듈 안의 모든 컴포넌트가 배치되고 각자의 스키마 기본값을 사용합니다. Release에 필요한 것은 모듈의 이름뿐이며 그 밖의 정보는 필요하지 않습니다.
  • 라우팅된 컴포넌트를 로컬 이름으로 구성하기. 라우팅 항목은 라우팅하는 모듈의 개별 컴포넌트를 구성할 수도 있으며, 이때 각 컴포넌트가 해당 모듈 안에서 갖는 로컬 이름으로 지정합니다. 모듈 안에서는 그것이 유일한 이름이므로 metrics.query가 아니라 query입니다. 한 컴포넌트를 지정해도 다른 컴포넌트에는 영향이 없습니다. 여기서는 query의 크기를 지정하고 scrape 대상을 부여하는 반면, 오브젝트 스토어와 스토어 게이트웨이는 기본값으로 라우팅됩니다.
  • 라우팅된 컴포넌트는 해당 경계의 컴포넌트입니다. 라우팅된 컴포넌트는 다른 컴포넌트와 마찬가지로 경계의 어노테이션 캐스케이드를 상속하며, 이 때문에 라우팅된 모듈의 모든 리소스가 경계의 aggrega.ai/namespace 값을 갖게 됩니다. 라우팅 항목이 전혀 언급하지 않는 컴포넌트도 마찬가지입니다.
  • 라우팅은 배치이며, 다른 종류의 소속이 아닙니다. 아무것도 지정하지 않고 라우팅된 컴포넌트는 같은 컴포넌트를 해당 경계에 빈 본문으로 직접 지정한 경우와 똑같이 렌더링됩니다. 두 표기법은 컴포넌트가 속하는 위치를 나타내는 두 가지 방법일 뿐, 서로 다른 두 동작이 아닙니다.

예제 생성하기

아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.

예제 이름을 딴 새 폴더에 예제를 씁니다:

Terminal window
aggrega scaffold --example module-boundary-routing

그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:

Terminal window
cd module-boundary-routing

빌드

이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다. --auto-pull은 새 클론에 없는 lockfile을 빌드 중에 기록합니다.

Terminal window
aggrega build --release release.yaml --auto-pull

렌더링된 아티팩트는 dist/ 아래에 생성됩니다. Kubernetes 대상은 오프라인으로 일반 매니페스트를 렌더링하므로 차트를 가져올 필요가 없습니다.

AI 어시스턴트 사용

Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.

Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `module-boundary-routing` 폴더가 없으면 `example`에 `module-boundary-routing` 값을 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `module-boundary-routing` 폴더에 작성됩니다. 그런 다음 `workspace_root` 값은 `module-boundary-routing`, `release` 값은 `release.yaml`, `auto_pull` 값은 true, `write` 값은 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `module-boundary-routing/dist/` 아래에 있습니다.

배치된 스택의 모습

각 경계의 directory는 그 경계에 배치된 모든 것의 아티팩트 루트이므로, 두 모듈의 컴포넌트는 이를 라우팅한 경계에 따라 디스크에서 분리됩니다.

dist/observability/helm/ metrics-zdobjstore, metrics-zdstore, metrics-zdquery
dist/data/helm/ documents-zdproxy, documents-zdbackend

파일 이름에는 모듈 구분자를 풀어 쓴 각 컴포넌트의 식별자가 들어갑니다. 점은 모든 리소스 이름에 사용할 수 있는 문자가 아니기 때문입니다. Aggregate의 metrics.store는 클러스터에서 metrics-zdstore가 됩니다. 식별자에 구분자를 넣는 것은 모듈 구성뿐이므로, 직접 지정한 컴포넌트는 두 곳에서 같은 철자로 표기됩니다.

모든 리소스는 라우팅한 경계의 네임스페이스를 가지며 어느 경계가 자신을 배치했는지 기록합니다. 스토어 게이트웨이는 라우팅 항목에서 한 번도 지정되지 않지만 두 가지를 모두 상속합니다.

metadata:
name: metrics-zdstore
namespace: observability
[… omitted: the labels every rendered document carries]
annotations:
aggrega.ai/boundary-path: observability
[… omitted: the annotation naming the Recipe that rendered it]

메트릭 모듈의 자격 증명 Feature가 오브젝트 스토어의 키 쌍과 스토어 게이트웨이가 이에 제시하는 키 쌍에 대해 생성하는 네 Secret도 마찬가지입니다. 각 Secret은 해당 네임스페이스와 함께 observability 아래, 이를 읽는 워크로드 옆에 생성됩니다.

라우팅된 query 컴포넌트에 연결된 scrape Feature는 같은 경계 아래에 자체 아티팩트를 렌더링하며, 이 아티팩트에는 운영자의 scrape 설정이 담깁니다.

apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
name: metrics-zdquery-scrape
[… omitted: the namespace, labels and annotations every rendered document carries]
spec:
selector:
matchLabels:
app.kubernetes.io/name: metrics-zdquery
endpoints:
- port: http
interval: 30s
path: /metrics