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

구성

이 페이지는 한 가지 개념, 즉 하나의 컴포넌트보다 큰 부분들로 애플리케이션을 구성하는 방법을 설명하며, 실행 가능한 작업 공간이 아닙니다. 모듈 경계 라우팅 — 하위 모듈 전체를 경계에 배치하기는 직접 빌드하는 작업 공간에서 이를 보여 줍니다. 다음 명령으로 자신의 폴더에 작성하십시오:

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

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

Terminal window
cd module-boundary-routing
aggrega build --release release.yaml --auto-pull

모듈: 다른 Aggregate가 가져오는 Aggregate

Aggregate는 aggregates: 아래에서 다른 Aggregate를 모듈로 가져올 수 있습니다. 모듈은 자체 컴포넌트를 구성하고 자체 엣지를 연결하므로, 그 내부는 모듈을 가져오는 Aggregate에 전혀 나타나지 않습니다. 이 예제는 표준 라이브러리 카탈로그에서 두 모듈을 가져옵니다. aggregate.yaml에서 발췌:

spec:
aggregates:
metrics:
type: core/thanos
documents:
type: core/ferretdb

모듈의 exportedComponents 블록은 모듈의 공개 인터페이스입니다. 즉, 모듈 외부의 무언가가 연결할 수 있는 컴포넌트를 각각 내보내는 이름으로 나타냅니다. core/ferretdb는 자신의 proxy 컴포넌트를 mongo로 내보내므로, 가져오는 쪽 Aggregate의 컴포넌트는 점으로 구분된 경로 documents.mongo로 여기에 도달합니다:

uses:
database:
main:
target: documents.mongo

모듈은 자체 매개변수를 선언할 수 있으며, 가져오는 쪽 Aggregate가 가져오기의 parameters:에서 이를 채웁니다.

모듈 배치

Release는 모듈 이름을 키로 하는 aggregates: 항목으로 모듈 전체를 경계에 배치하며, 모듈에 포함된 모든 컴포넌트가 함께 배치됩니다. Release는 모듈의 컴포넌트를 구성할 수도 있으며, 각 컴포넌트는 모듈 안에서의 이름으로 지정합니다. release.yaml에서 주석을 제외하고 발췌:

spec:
boundaries:
observability:
directory: observability
annotations:
aggrega.ai/namespace: observability
aggregates:
metrics:
components:
query:
infra:
compute:
cpu: 500m
memory: 1Gi
data:
directory: data
annotations:
aggrega.ai/namespace: data
aggregates:
documents: {}

모듈 자체의 어노테이션은 Aggregate의 어노테이션이 자신의 컴포넌트에 도달하는 것과 똑같이 모듈 자체의 컴포넌트에 도달하므로, 모듈은 자신이 선언한 네임스페이스에 컴포넌트를 배치할 수 있습니다. 가져오는 쪽 Aggregate는 모듈 안으로 도달하는 것을 아무것도 선언하지 않습니다. 그것은 Release가 하며, 같은 키에서는 Release의 값이 우선합니다.

빌드가 프로비저닝하지 않는 서비스

이미 존재하는 서버도 여전히 그래프의 노드입니다. 연결, 정책, 그리고 소비자가 받는 것에 참여하며, 이 서버를 위해서는 아무것도 프로비저닝되지 않습니다. 그 Manifest는 아무것도 프로비저닝하지 않는 Recipe를 바인딩하고, Release가 주소를 제공합니다. 하나의 계약, 세 가지 구현에서 manifest-external.yaml Manifest는 core/datastore/postgres를 ExternalName Service만 내보내는 helm/postgres-external에 바인딩하고, Release가 주소를 제공합니다. release-external.yaml에서 발췌:

db:
infra:
overrides:
host: postgres.data.example.net

주소는 포인터 문자열입니다. 빌드는 이를 해석하지 않고 그대로 전달하며, 애플리케이션이 실행될 때 그 이름으로 응답하는 것이 곧 애플리케이션이 도달하는 대상입니다. Aggregate는 예제의 세 Releases 모두에 대해 같은 파일입니다.

서브시스템: 하나의 Aggregate 안에서 그룹화하기

서브시스템은 Aggregate 안에서 컴포넌트를 그룹화합니다. 서브시스템에 선언된 어노테이션은 서브시스템이 포함하는 모든 컴포넌트에 도달하며, 서브시스템에 부착된 Feature는 그 각 컴포넌트에 부착됩니다:

spec:
subsystems:
billing:
annotations:
team.aggrega.ai/owner: billing-squad
aggrega.ai/namespace: billing
features:
metrics:
type: core/prometheus-exporter
components:
invoice-api:
type: core/compute/server
payment-worker:
type: core/compute/worker

빌드는 서브시스템 트리를 평탄화합니다. invoice-api와 payment-worker는 각각 metrics 부착과 두 어노테이션을 모두 가지며, Recipe는 이를 {{ index .context.annotations.aggregate "team.aggrega.ai/owner" }}로 읽습니다. aggrega.ai/namespace는 프로바이더 어노테이션이므로 두 컴포넌트를 billing 네임스페이스에도 배치합니다. Release는 서브시스템이 부여한 이름으로 각 컴포넌트의 항목 아래에서 부착의 infra를 구성하며, Release가 설정한 네임스페이스는 그것이 적용되는 컴포넌트에 대해 서브시스템의 네임스페이스를 재정의합니다.

자체 연결 대상을 가진 부착

부착은 자체 uses: 블록을 가질 수 있으며, 부착된 컴포넌트가 아니라 부착 자체에서 엣지를 그립니다. 모든 대상에서 백업되는 데이터 저장소에서 운영자는 core/backup을 데이터베이스에 부착하고, 그 부착을 백업이 저장되는 버킷에 연결합니다. release-helm-velero.yaml에서 발췌:

spec:
components:
db:
features:
backup:
type: core/backup
infra:
schedule: "30 2 * * *"
retention_days: 14
uses:
store:
bucket:
target: backups

데이터베이스 자체의 연결은 바뀌지 않습니다. backups로 향하는 엣지는 부착에 속하고, 부착이 그린 것으로 기록되며, 다른 모든 엣지와 마찬가지로 정책의 검사를 받습니다. 운영용 Feature와 자격 증명용 Feature도 같은 방식으로 부착되며, 어느 쪽이든 uses: 블록을 가질 수 있습니다.