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

Recipe 입력 종류

이 페이지는 한 가지 개념, 즉 Recipe가 렌더링의 바탕으로 삼는 세 가지 입력과 그것들이 합쳐지는 방식을 설명하며, 실행 가능한 작업 공간이 아닙니다. MariaDB + Adminer — 실행 가능한 이중 대상 예제는 합성된 Recipe, 가져온 차트, 그리고 그 옆의 아티팩트로 하나의 컴포넌트를 구현합니다. 다음 명령으로 자신의 폴더에 작성하십시오:

Terminal window
aggrega scaffold --example mariadb-adminer

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

Terminal window
cd mariadb-adminer
aggrega pull --release release-compose.yaml
aggrega build --release release-compose.yaml

Recipe에는 세 가지 입력이 있으며, 이를 어떤 조합으로든 사용합니다:

  • 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: Recipe
metadata:
name: api-server-helm
spec:
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: Recipe
metadata:
name: mariadb-with-monitor
spec:
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를 빌드합니다.