Các loại đầu vào của Recipe
Trang này giải thích một ý tưởng, ba đầu vào mà một Recipe dựa vào để render và cách chúng cộng lại với nhau, và không phải là một không gian làm việc có thể chạy. MariaDB + Adminer — một ví dụ hai đích có thể chạy hiện thực một thành phần bằng một Recipe tổng hợp, một chart được tải về và các artifact bên cạnh chúng; hãy ghi nó vào một thư mục của riêng bạn bằng:
aggrega scaffold --example mariadb-adminerSau đó nó in ra các lệnh cần chạy tiếp theo:
cd mariadb-admineraggrega pull --release release-compose.yamlaggrega build --release release-compose.yamlMột Recipe có ba đầu vào, và dùng bất kỳ tổ hợp nào của chúng:
- một Workload (
workload:), mô tả riêng của bản build về container, cổng, volume và dịch vụ, mà provider tổng hợp thành các tài nguyên của đích — một Deployment và một Service trên Kubernetes, một dịch vụ trên Docker Compose; - một nguồn (
source:), một chart, một module hoặc một template mà provider render, được cấp dữ liệu từvaluesMappingcủa Recipe; - các artifact (
artifacts:), các tệp mà Recipe ghi nguyên trạng, sau khi xử lý template, bên cạnh những gì hai đầu vào kia tạo ra.
Cách ba đầu vào kết hợp được trình bày trong Kết hợp đầu vào của Recipe; bề mặt riêng của Workload là entities/workload.md, và ngữ cảnh mà mọi template đọc — .values, .infra, .context, .locals, .features — là vocabulary/data-pillars.md.
Các Recipes dưới đây hiện thực một Component mà không gian làm việc tự khai báo, local/compute/api-server, với một image và một port trong số các values của nó, replicas trong infra của nó, và host, port và protocol trong số những gì nó công bố.
Chỉ một Workload
Khi không có source: và không có artifacts:, Workload quyết định toàn bộ đầu ra:
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 }}Với một thành phần tên api, helm provider ghi ra một Deployment và một ClusterIP Service. Các biến mà các kết nối chuyển tới sẽ đến .context.inject.env và được ghi vào container.
Một Workload và các artifact
Các artifact thêm những tệp mà Workload tham chiếu tới. Một Workload với một container thứ hai mount một ConfigMap, và ConfigMap đó dưới dạng artifact:
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 }}"Một artifact đọc Workload tại .workload thay vì lặp lại các giá trị của nó: một cổng container đến với artifact dưới dạng một đối tượng chứa số hiệu của nó dưới port, bất kể Workload đã viết nó ở dạng nào. ConfigMap được đặt tên theo .context.rendered_name, tên mà helm provider đặt cho các tài nguyên của thành phần, theo sau là một hậu tố do một local mang; một local không thể đọc tên đã render, vì vậy volume và artifact mỗi bên tự ghép hai phần này, và tên mà volume mount chính là tên mà artifact ghi ra.
Một nguồn và các artifact
Một Recipe có thể render một chart được tải về và thêm các tệp của riêng nó bên cạnh. Ở đây core/datastore/mariadb của danh mục được hiện thực bằng chart của một nhà cung cấp, và một artifact thêm một 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: 30sChart gắn nhãn các tài nguyên của nó bằng tên release mà bản build cấp cho nó, nên selector được dựng từ .context.rendered_name; một selector dựng từ .context.instance_id sẽ không khớp với gì cả đối với một thành phần có tên chứa dấu gạch dưới hoặc chữ hoa. Khóa của một artifact là tên tệp đầu ra của nó, được dùng đúng như đã viết, và bản build dừng lại nếu chart cũng render một tệp có tên đó.
Một Workload được giữ trong một tệp riêng
workload: và một mục artifacts: đều có thể nhập một tệp thay vì chứa văn bản trực tiếp:
spec: workload: $import: ./workload/workload.yaml artifacts: networkpolicy: $import: ./artifacts/networkpolicy.yamlTệp Workload được nhập được xử lý template với cùng ngữ cảnh như một Workload viết trực tiếp. Một tệp mà một mục artifacts: nhập vào được ghim trước khi bản build đọc nó: aggrega pin <recipe-dir>/recipe.yaml ghi một entity.lock cạnh Recipe, ghi lại digest của tệp, và bản build dừng lại, nêu tên lệnh đó, chừng nào tệp khóa chưa ghi bản ghim cho tệp hoặc tệp không còn khớp với bản ghim đó. Nhập thư viện Workload — một phần thân Workload dùng chung qua $import build một Recipe có Workload được nhập.