데이터 모델
이 페이지는 하나의 개념, 즉 누가 컴포넌트에 관한 어떤 데이터를 작성하는지를 설명하며, 실행 가능한 작업 공간이 아닙니다. 하나의 계약, 세 가지 구현에서 직접 빌드하는 작업 공간으로 이를 보여 줍니다. 다음 명령으로 자신의 폴더에 작성하십시오:
aggrega scaffold --example postgres-three-realizations그런 다음 이어서 실행할 명령을 출력합니다:
cd postgres-three-realizationsaggrega build --release release-selfhosted.yaml --auto-pullaggrega build --release release-managed.yaml --auto-pullaggrega build --release release-managed-dns.yaml --auto-pullaggrega build --release release-external.yaml --auto-pullvalues와 infra: 두 개의 네임스페이스, 두 명의 작성자
Component는 두 개의 분리된 설정 집합을 선언합니다. values는 개발자의 것으로 Aggregate에 작성됩니다. 애플리케이션에 필요한 것으로, 모든 환경에서 동일합니다. infra는 운영자의 것으로 Release에 작성됩니다. 크기 조정과 배치로, 환경마다 다릅니다. 스키마는 이 둘을 분리합니다. Aggregate 스키마에는 컴포넌트에 infra가 없고 Release 스키마에는 values가 없으므로, 어느 작성자도 상대방의 필드를 설정할 수 없습니다. Recipe는 둘 모두를 .values와 .infra라는 두 개의 분리된 객체로 받습니다.
예제에서 개발자는 aggregate.yaml에서 데이터베이스와 그 로그인 역할의 이름을 지정합니다:
spec: components: db: type: core/datastore/postgres values: database: appdb user: appuser그리고 관리형 인스턴스를 빌드하는 Release는 주석을 생략한 release-managed.yaml에서 그 크기를 정합니다:
spec: boundaries: stack: directory: stack components: db: infra: engine_version: "16" storage: size: 100Gi type: gp3 ha: enabled: true read_replicas: 0예제의 다른 두 Releases는 같은 Aggregate를 클러스터 안에서, 그리고 이미 존재하는 서버를 대상으로 빌드하며, 각각 고유한 infra를 가집니다. Aggregate는 바뀌지 않습니다.
그래도 환경에 따라 달라져야 하는 값은 끌어올립니다. Aggregate가 매개변수를 선언해 값에 써 넣고, 각 Release가 그 매개변수를 충족합니다(빌드의 파일 참조).
다른 Release를 기반으로 구축한 Release
Release는 extends:로 다른 Release를 기본 Release로 지정하고 다른 부분만 변경할 수 있습니다. 자식은 기본 Release의 경계, 배치, 매개변수를 상속하며, extends:와 함께 aggregate:를 선언하면 Release 스키마에 의해 거부됩니다. 자식은 기본 Release와 같은 Aggregate를 빌드해야 하기 때문입니다. 자식은 자체 Manifest를 지정하거나, manifest:를 생략하고 기본 Release의 것을 상속할 수 있습니다.
# release-prod.yaml: the base gives every other settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500Gi경계의 directory:는 다른 설정과 마찬가지로 상속되므로, 리터럴 디렉터리를 상속한 자식은 기본 Release와 같은 위치에 렌더링됩니다. 디렉터리를 매개변수에 기반해 작성해야 각 Release의 출력이 각자의 위치로 보내집니다. 복합 Release와 extends 상속을 참조하십시오.
다른 Manifest를 기반으로 구축한 Manifest
Manifest도 같은 방식으로 다른 Manifest를 확장할 수 있으며, 그 항목은 같은 키에 대한 기본 Manifest의 항목을 대체합니다. 개발용 Manifest는 프로덕션용 Manifest의 바인딩을 모두 유지하면서 자격 증명이 구현되는 방식을 바꿀 수 있습니다. 여기서 core/referenced-secret 첨부는 프로덕션에서는 시크릿 저장소에서 가져오고, 개발에서는 작성자가 제공한 값으로 Secret에 기록됩니다.
spec: mappings: components: type: core/datastore/postgres:1.0.0: helm/postgres:1.0.0 features: type: core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0---# manifest-dev.yamlspec: extends: ./manifest-prod.yaml mappings: features: type: core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0두 구현은 Secret의 이름을 같은 방식으로 게시하므로, 자격 증명을 읽는 컴포넌트는 어느 Manifest에서든 같은 참조를 렌더링합니다. 하나의 개발자 의도, 두 가지 자격 증명 전달 형태에서 두 가지를 모두 빌드하고 비교합니다.
두 개의 레이블: 타입과 카테고리
모든 Component는 예약된 component.aggrega.ai/type 레이블에 닫힌 집합의 값 하나를 가집니다. server는 장기 실행 엔드포인트, worker는 백그라운드 소비자, stateful-server는 자체 영구 데이터를 보관하는 것, task는 완료될 때까지 실행되는 것, function은 이벤트 기반 함수, 그리고 resource는 자체 컴퓨팅을 실행하지 않는 관리형 클라우드 리소스입니다. 이 값은 카탈로그 엔티티에 있으며, Aggregate의 인스턴스에는 결코 있지 않습니다.
타입은 인프라가 컴포넌트를 어떻게 다뤄야 하는지를 나타내며, 컴포넌트가 무엇을 위한 것인지를 나타내지 않습니다. 자체 디스크를 가진 메시지 브로커는 데이터베이스와 똑같이 stateful-server입니다. core/messaging/kafka와 core/datastore/postgres는 같은 타입을 가집니다. 독자가 탐색에 사용하는 것은 다른 레이블인 component.aggrega.ai/category이며 — 브로커는 messaging, 데이터베이스는 datastore — 이는 엔티티가 위치한 카탈로그 디렉터리이기도 합니다. 한 레이블에 대해 작성된 셀렉터는 다른 레이블과는 절대 일치하지 않습니다.