Recipe 입력 종류
이 페이지는 한 가지 개념, 즉 Recipe가 렌더링의 바탕으로 삼는 세 가지 입력과 그것들이 합쳐지는 방식을 설명하며, 실행 가능한 작업 공간이 아닙니다. MariaDB + Adminer — 실행 가능한 이중 대상 예제는 합성된 Recipe, 가져온 차트, 그리고 그 옆의 아티팩트로 하나의 컴포넌트를 구현합니다. 다음 명령으로 자신의 폴더에 작성하십시오:
aggrega scaffold --example mariadb-adminer그런 다음 이어서 실행할 명령을 출력합니다:
cd mariadb-admineraggrega pull --release release-compose.yamlaggrega build --release release-compose.yamlRecipe에는 세 가지 입력이 있으며, 이를 어떤 조합으로든 사용합니다:
- Workload(
workload:): 컨테이너, 포트, 볼륨, 서비스에 대한 빌드 자체의 기술로, 프로바이더가 이를 대상의 리소스로 합성합니다 — Kubernetes에서는 Deployment와 Service, Docker Compose에서는 서비스; - 소스(
source:): 프로바이더가 렌더링하는 차트, 모듈 또는 템플릿으로, Recipe의valuesMapping으로부터 값을 공급받습니다; - 아티팩트(
artifacts:): Recipe가 템플릿 처리 후 그대로 기록하는 파일로, 다른 두 입력이 생성하는 것 옆에 놓입니다.
세 입력이 구성되는 방식은 Recipe 입력 구성에 설명되어 있습니다. Workload 자체의 표면은 entities/workload.md이고, 모든 템플릿이 읽는 컨텍스트 — .values, .infra, .context, .locals, .features — 는 vocabulary/data-pillars.md입니다.
아래의 Recipes는 작업 공간이 스스로 선언하는 Component인 local/compute/api-server를 구현하며, 이것은 values에 image와 port를, infra에 replicas를, 그리고 게시하는 항목에 host, port, protocol을 가집니다.
Workload만 사용하기
source:도 artifacts:도 없으면 Workload가 출력 전체를 결정합니다:
kind: Recipemetadata: name: api-server-helmspec: capability: helm implements: local/compute/api-server:1.0.0 locals: port: "{{ optional .values `port` 8080 }}" provides: host: "{{ .context.rendered_name }}-http" port: "{{ .locals.port }}" protocol: http workload: | apiVersion: aggrega.ai/v1beta1 kind: Workload replicas: {{ optional .infra `replicas` 1 }} containers: main: image: "{{ .values.image }}" variables: {{- range $k, $v := .context.inject.env }} {{ $k }}: "{{ $v }}" {{- end }} ports: web: {{ .locals.port }} services: http: type: ClusterIP ports: web: {{ .locals.port }}api라는 이름의 컴포넌트에 대해 helm 프로바이더는 Deployment와 ClusterIP Service를 작성합니다. 연결이 전달하는 변수는 .context.inject.env에 도착하며 컨테이너에 기록됩니다.
Workload와 아티팩트
아티팩트는 Workload가 참조하는 파일을 추가합니다. ConfigMap을 마운트하는 두 번째 컨테이너가 있는 Workload와, 아티팩트로서의 ConfigMap입니다:
spec: locals: proxy_cm: "proxy-config" workload: | apiVersion: aggrega.ai/v1beta1 kind: Workload containers: main: image: "{{ .values.image }}" ports: web: 8080 proxy: image: envoyproxy/envoy:v1.28 volumeMounts: - name: proxy-config path: /etc/envoy readonly: true volumes: proxy-config: configmap: source: "{{ .context.rendered_name }}-{{ .locals.proxy_cm }}" artifacts: proxy-config.yaml: | apiVersion: v1 kind: ConfigMap metadata: name: {{ .context.rendered_name }}-{{ .locals.proxy_cm }} data: listen-port: "{{ .workload.containers.main.ports.web.port }}"아티팩트는 Workload의 값을 반복하는 대신 .workload에서 Workload를 읽습니다. 컨테이너 포트는 Workload가 어떤 형식으로 작성했든 port 아래에 번호를 담은 객체로 아티팩트에 전달됩니다. ConfigMap의 이름은 .context.rendered_name — helm 프로바이더가 컴포넌트의 리소스에 부여하는 이름 — 뒤에 local이 담고 있는 접미사를 붙인 것입니다. local은 렌더링된 이름을 읽을 수 없으므로 볼륨과 아티팩트가 각각 두 값을 결합하며, 볼륨이 마운트하는 이름은 아티팩트가 기록하는 이름과 같습니다.
소스와 아티팩트
Recipe는 가져온 차트를 렌더링하고 그 옆에 자체 파일을 추가할 수 있습니다. 여기서는 카탈로그의 core/datastore/mariadb를 벤더의 차트로 구현하고, 아티팩트가 Prometheus ServiceMonitor를 추가합니다:
kind: Recipemetadata: name: mariadb-with-monitorspec: capability: helm implements: core/datastore/mariadb:1.0.0 provides: host: "{{ .context.rendered_name }}" port: "{{ .infra.port }}" protocol: mariadb source: kind: helm-oci-chart url: oci://registry-1.docker.io/bitnamicharts/mariadb version: "25.0.8" valuesMapping: | fullnameOverride: "{{ .context.rendered_name }}" auth: database: "{{ .values.database }}" artifacts: servicemonitor.yaml: | apiVersion: monitoring.coreos.com/v1 kind: ServiceMonitor metadata: name: {{ .context.rendered_name }}-monitor spec: selector: matchLabels: app.kubernetes.io/instance: {{ .context.rendered_name }} endpoints: - port: mysql interval: 30s차트는 빌드가 부여한 릴리스 이름으로 리소스에 레이블을 붙이므로, 셀렉터는 .context.rendered_name으로 만듭니다. .context.instance_id로 만든 셀렉터는 이름에 밑줄이나 대문자가 들어간 컴포넌트에 대해 아무것도 일치시키지 못합니다. 아티팩트의 키는 출력 파일 이름이며 작성된 그대로 사용되고, 차트도 같은 이름의 파일을 렌더링하면 빌드가 중단됩니다.
별도 파일에 둔 Workload
workload:와 artifacts: 항목은 각각 텍스트를 인라인으로 담는 대신 파일을 가져올 수 있습니다:
spec: workload: $import: ./workload/workload.yaml artifacts: networkpolicy: $import: ./artifacts/networkpolicy.yaml가져온 Workload 파일은 인라인 Workload와 같은 컨텍스트로 템플릿 처리됩니다. artifacts: 항목이 가져오는 파일은 빌드가 읽기 전에 고정됩니다. aggrega pin <recipe-dir>/recipe.yaml은 Recipe 옆에 파일의 다이제스트를 기록한 entity.lock을 작성하며, 잠금 파일에 해당 파일의 고정값이 없거나 파일이 더 이상 그것과 일치하지 않는 동안에는 빌드가 이 명령을 지목하며 중단됩니다. Workload 라이브러리 가져오기 — $import를 통한 공유 Workload 본문은 Workload를 가져오는 Recipe를 빌드합니다.