인스턴스별 레시피 재정의
이 예제는 Manifest의 기능 하나를 다룹니다. 바로 name 매핑 계층으로, 같은 타입의 다른 모든
인스턴스는 일괄 type 계층 Recipe를 유지하면서 단일 컴포넌트 인스턴스에 대해서만
Recipe를 재정의합니다.
보여 주는 내용
Aggregate는 하나의 컴포넌트 타입(example/compute/greeter)에 대해 두 인스턴스를 선언합니다.
components: greeter-default: type: example/compute/greeter greeter-special: type: example/compute/greeter카탈로그는 둘 다 example/compute/greeter를 구현하는 두 Recipes를 제공합니다. greeter-blue
(기본 빌드)와 greeter-green(대체 빌드)입니다. Manifest는
타입을 일괄 매핑하고 인스턴스 하나를 이름으로 재정의합니다.
mappings: components: type: example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 # every greeter instance... name: greeter-special: compose/greeter-green:1.0.0 # ...except this one이름이 타입보다 우선하므로 greeter-special은 greeter-green을 통해 배포되고
greeter-default는 greeter-blue를 통해 배포됩니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example per-instance-recipe-override그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd per-instance-recipe-override빌드
aggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yaml이 예제는 프로바이더로 표준 라이브러리를 사용합니다. compose 프로바이더는 표준 카탈로그에 포함되어 있습니다. 재정의 예제 자체를 위한 장난감인 example/compute/greeter 데모 컴포넌트와 그 두 레시피(greeter-blue / greeter-green)는 오직 인스턴스별 재정의를 눈에 보이게 하려고 존재하며, 표준 라이브러리 엔티티와 함께 공유 카탈로그의 example/ 퍼블리셔 아래에 있습니다. .aggrega-config.yaml은 hub.aggrega.ai를 기본 레지스트리로 선언하므로 엔티티는 허브에서 해석됩니다. 따라서 빌드 명령에는 --catalog 플래그가 필요하지 않습니다.
렌더링된 dist/app/compose/docker-compose.yaml은 재정의가 적용되는 모습을 보여 줍니다.
greeter-default는 image: greeter:blue를, greeter-special은
image: greeter:green을 실행하며, 각 서비스의 aggrega.ai/recipe-uri 출처
레이블은 해당 서비스가 해석된 서로 다른 Recipe를 나타냅니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. Workspace 폴더에 아직 `per-instance-recipe-override` 폴더가 없으면 `example`을 `per-instance-recipe-override`로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `per-instance-recipe-override` 폴더에 예제가 작성됩니다. 그런 다음 `workspace_root`를 `per-instance-recipe-override`로, `release`를 `release.yaml`로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `per-instance-recipe-override/dist/` 아래에 있습니다.이것이 유용한 이유
하나의 컴포넌트 타입에 속한 두 인스턴스에 서로 다른 물리적
구현이 필요한 경우가 있습니다. 예를 들어 기본 데이터베이스는 관리형 클라우드 Recipe를 사용하고
복제본은 클러스터 내 Recipe를 사용하는 경우입니다. name 계층은 컴포넌트 타입을 분기하거나
Aggregate를 복제하지 않고 Manifest에서 이를 인스턴스별로 표현합니다. 둘 이상의 Recipe가 구현하는 타입은
매핑으로 모호성을 해소해야 합니다. 매핑하지 않으면 빌드는 추측하지 않고
중단하며 후보를 알려 줍니다.