MySQL — 하나의 Aggregate, 두 개의 타깃
이 간결한 예제는 개발자가 작성한 Aggregate에서 단일 MySQL 데이터베이스를 두 개의 대상으로 컴파일합니다.
- helm 프로바이더의 Workload 합성을 통한 Kubernetes(외부 차트 없이 공식
mysql이미지 위에 직접 렌더링되는 StatefulSet), 그리고 - 로컬 개발용 Docker Compose.
동일한 개발자 의도가 각 타깃을 구동합니다. 타깃마다 달라지는 것은 Manifest가 선택하는 Recipe 계층뿐입니다.
파일
| 파일 | 역할 |
|---|---|
aggregate-helm-synth.yaml | Kubernetes base 변형의 개발자 의도: core/datastore/mysql 타입의 db 컴포넌트 하나, 그 값, 그리고 필수 root_password 자격 증명만 포함합니다. |
aggregate-helm-synth-auth.yaml | Kubernetes full 변형의 개발자 의도: root_password와 user_password 자격 증명 슬롯을 모두 포함합니다. |
manifest-helm-synth.yaml | MySQL 타입을 합성된 helm Recipe(helm/mysql)에, 각 자격 증명을 해당 FeatureRecipe(env-secret, k8s-secret-from-parameter)에 매핑합니다. |
release-helm-synth.yaml | 운영 사이징(engine_version, storage)을 포함한 Kubernetes base 변형의 운영자 레코드입니다. |
release-helm-synth-auth.yaml | Kubernetes full 변형의 운영자 레코드입니다. |
aggregate.yaml | 로컬 Compose 타깃의 개발자 의도: 동일한 db 컴포넌트이며, 두 자격 증명 슬롯 모두 inject-value 자격 증명으로 전달됩니다. |
manifest-compose.yaml | MySQL 타입을 Compose Recipe(mysql)에, 자격 증명을 dotenv-secret에 매핑합니다. |
release-compose.yaml | 정확한 컨테이너 이미지를 고정하는 프로바이더별 infra.overrides 항목을 포함한 로컬 Compose 타깃의 운영자 레코드입니다. |
보여 주는 내용
- 하나의 작성 표면, 여러 타깃. Aggregate는 스택이 무엇인지에 대한 단일 진실 공급원입니다. 각 Manifest는 그것을 어떻게 실현할지 기술합니다.
- Kubernetes에서의 Workload 합성(권장).
helm/mysqlRecipe는form: stateful을 갖는 capability에 구애받지 않는Workload를 선언하며, helm 프로바이더는 StatefulSet, ClusterIP Service, Headless Service (StatefulSet의 안정적인 네트워크 ID), 그리고 데이터 디렉터리용 volumeClaimTemplate을 합성합니다. 컨테이너 환경에는MYSQL_DATABASE,MYSQL_USER,MYSQL_ROOT_PASSWORD,MYSQL_PASSWORD가 포함됩니다. 문자 집합과 콜레이션은mysqld서버 명령줄 인수 (--character-set-server,--collation-server)로 반영되는데, 공식mysql이미지가 이를 환경 변수가 아닌 서버 플래그로 받기 때문입니다. - Compose에서의 Workload 합성. Compose Recipe는
capability에 구애받지 않는
Workload를 선언하며, compose 프로바이더는 MySQL 이미지, 그 환경, 이름이 지정된 데이터 볼륨, 헬스 체크를 갖춘docker-compose.yaml서비스를 합성합니다. - 운영자용 탈출구. Compose release는
infra.overrides.image를 설정합니다. 이는 Component 자체 스키마가 명시하지 않는 provider별 사항을 위한 열린 기둥이며, 렌더링된 서비스는 바로 그 이미지 참조를 실행합니다. Provider별 재정의를 참조하십시오. - 두 슬롯 자격 증명 모델. 비밀번호는 컴포넌트의
features:기둥에 붙는 첨부물로, 각각feature.aggrega.ai/kind: secret레이블이 붙은 Feature이며 애플리케이션values와 분리되어 유지됩니다. Component의featuresSchema는 Black-Boxroot_password슬롯과 투명한user_password슬롯을 선언합니다.
Kubernetes 자격 증명 전달
root_password는 Black-Box 슬롯(inject: [])으로, Recipe가 전달을
제어합니다. 첨부된 inject-value 자격 증명은 값을 컴포넌트의
inject 파이프에 올리고, Recipe는 이를
.context.inject.env.MYSQL_ROOT_PASSWORD로 읽어 일반 컨테이너 환경 변수를 생성합니다.
이를 위한 Kubernetes Secret은 생성되지 않습니다.
user_password는 투명한 슬롯(inject: [env, file])입니다. full
변형은 참조 가능한 자격 증명을 첨부하며, 이 자격 증명은 Kubernetes
Secret을 구체화하고 그 ID를 게시합니다. Recipe는
containers.attachments를 통해 슬롯을 참조하고, 합성기는 이를 env secretKeyRef로 렌더링합니다.
생성된 Secret과 컨테이너의 참조는 둘 다
.features.user_password.provides.name을 읽으므로 같은 리소스를 가리킵니다. user_password를
첨부하지 않는 것(base 변형)도 유효합니다. 이 경우 Recipe는 인라인
개발용 기본값(MYSQL_PASSWORD: apppass)으로 대체하고 Secret은 생성되지 않으므로,
최소 배포도 렌더링되고 실행됩니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example mysql-standalone그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd mysql-standalone빌드
이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다. --auto-pull은 새 클론에 없는 lockfile을 빌드 중에 기록합니다.
# Kubernetes — synthesized helm StatefulSet (base: root credential only)aggrega build --release release-helm-synth.yaml --auto-pull
# Kubernetes — synthesized helm StatefulSet (full: both credential slots)aggrega build --release release-helm-synth-auth.yaml --auto-pull
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull렌더링된 아티팩트는 dist/ 아래에 생성됩니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `mysql-standalone` 폴더가 없으면 `example`에 `mysql-standalone` 값을 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `mysql-standalone` 폴더에 작성됩니다. 그런 다음 각 Release마다 `release-helm-synth.yaml`, `release-helm-synth-auth.yaml`, `release-compose.yaml` 순서로 `build` 도구를 한 번씩 호출하되, 매번 `workspace_root` 값은 `mysql-standalone`, `release` 값은 해당 파일, `auto_pull` 값은 true, `write` 값은 true로 설정하십시오. 각 빌드가 작성한 파일을 알려 주십시오. 파일은 `mysql-standalone/dist/` 아래에 있습니다.운영자 사이징
Kubernetes release는 환경별로 운영자 사이징 기둥을 채웁니다.
컨테이너 이미지 태그는 infra.engine_version(mysql:8.4)에서,
volumeClaimTemplate의 요청량과 스토리지 클래스는 infra.storage에서 옵니다.
개발자의 Aggregate는 이 필드들을 절대 포함하지 않습니다.
Provider별 재정의
사이징 기둥은 이름이 지정된 필드입니다. Component가 engine_version과
storage를 선언하므로, 운영자가 둘 중 하나를 설정하는 것은 Component가
예상한 필드를 채우는 것입니다. infra.overrides는 Component가 예상할 수 없는
것을 위한 기둥으로, 임의의 중첩 구조를 받는 객체로 선언되며,
각 Recipe는 자신이 읽는 키를 문서화합니다.
release-compose.yaml이 이를 사용합니다. Compose Recipe는 image 키 하나를 읽으며,
이 키가 설정되면 컨테이너는 Recipe가 engine_version으로 구성하는 참조 대신
바로 그 참조를 실행합니다.
infra: engine_version: "8.4" overrides: image: "registry.internal.example/library/mysql:8.4"렌더링된 서비스는 오버라이드를 그대로 담습니다.
services: db: image: registry.internal.example/library/mysql:8.4 [… omitted: the service's environment, labels, volume, network and health check]이것이 동일한 서버 버전의 레지스트리 미러 빌드나 다이제스트 고정 빌드로 가는
경로입니다. 이는 Component의 계약이 아니라 타깃 환경에 속하는 배포 사실입니다.
키 집합은 Component별이 아니라 Recipe별이므로, 어떤 키가 적용되는지는
Recipe에서 확인해야 합니다. 여기서 Compose
Recipe는 image를 읽으며, 아무 키도 읽지 않는 Recipe는 그렇다고 명시합니다.