Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

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:

Terminal window
aggrega scaffold --example mariadb-adminer

Sau đó nó in ra các lệnh cần chạy tiếp theo:

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

Mộ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ừ valuesMapping củ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: 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 }}

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: 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

Chart 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.yaml

Tệ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.