Recipe girdi türleri
Bu sayfa tek bir fikri, bir Recipe’nin işlemede kullandığı üç girdiyi ve bunların nasıl toplandığını açıklar ve çalıştırılabilir bir çalışma alanı değildir. MariaDB + Adminer — çalıştırılabilir çift hedefli bir örnek, sentezlenmiş bir Recipe, getirilmiş bir chart ve bunların yanındaki yapıtlarla tek bir bileşeni gerçekleştirir; şu komutla kendi klasörünüze yazın:
aggrega scaffold --example mariadb-adminerArdından sırada çalıştırılacak komutları yazdırır:
cd mariadb-admineraggrega pull --release release-compose.yamlaggrega build --release release-compose.yamlBir Recipe’nin üç girdisi vardır ve bunların herhangi bir birleşimini kullanır:
- bir Workload (
workload:), derlemenin kapsayıcılar, bağlantı noktaları, birimler ve hizmetler hakkındaki kendi tanımı; sağlayıcı bunu hedefin kaynaklarına sentezler — Kubernetes’te bir Deployment ve bir Service, Docker Compose’da bir hizmet; - bir kaynak (
source:), sağlayıcının işlediği bir chart, modül veya şablon; Recipe’ninvaluesMappingdeğeriyle beslenir; - yapıtlar (
artifacts:), Recipe’nin şablon işlemeden sonra olduğu gibi, diğer ikisinin ürettiklerinin yanına yazdığı dosyalar.
Üçünün nasıl birleştiği Recipe girdi birleştirmesi sayfasında anlatılır; Workload’un kendi yüzeyi entities/workload.md, her şablonun okuduğu bağlam — .values, .infra, .context, .locals, .features — ise vocabulary/data-pillars.md sayfasıdır.
Aşağıdaki Recipes, çalışma alanının kendisi için bildirdiği bir Component’i, local/compute/api-server öğesini uygular; bu öğenin values içinde bir image ve bir port, infra içinde replicas, yayımladıkları arasında ise host, port ve protocol bulunur.
Yalnızca bir Workload
source: ve artifacts: olmadığında, çıktının tamamını Workload belirler:
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 adlı bir bileşen için helm sağlayıcısı bir Deployment ve bir ClusterIP Service yazar. Bağlantıların ilettiği değişkenler .context.inject.env konumuna ulaşır ve kapsayıcıya yazılır.
Bir Workload ve yapıtlar
Yapıtlar, Workload’un başvurduğu dosyaları ekler. Bir ConfigMap bağlayan ikinci bir kapsayıcıya sahip bir Workload ve yapıt olarak 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 }}"Bir yapıt, Workload’un değerlerini tekrarlamak yerine Workload’u .workload konumunda okur: bir kapsayıcı bağlantı noktası ona, Workload onu hangi biçimde yazmış olursa olsun, numarasını port altında tutan bir nesne olarak ulaşır. ConfigMap, .context.rendered_name — helm sağlayıcısının bileşenin kaynaklarına verdiği ad — ve ardından bir local’in taşıdığı bir sonek ile adlandırılır; bir local işlenmiş adı okuyamaz, bu nedenle birim ve yapıt ikisini ayrı ayrı birleştirir ve birimin bağladığı ad, yapıtın yazdığı addır.
Bir kaynak ve yapıtlar
Bir Recipe, getirilmiş bir chart’ı işleyebilir ve yanına kendi dosyalarını ekleyebilir. Burada kataloğun core/datastore/mariadb öğesi bir satıcının chart’ıyla gerçekleştirilir ve bir yapıt bir Prometheus ServiceMonitor ekler:
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, kaynaklarını derlemenin ona verdiği release adıyla etiketler, bu nedenle seçici .context.rendered_name üzerinden kurulur; .context.instance_id üzerinden kurulan bir seçici, adında alt çizgi veya büyük harf bulunan bir bileşen için hiçbir şeyle eşleşmez. Bir yapıtın anahtarı, yazıldığı gibi kullanılan çıktı dosya adıdır ve chart da bu adda bir dosya işlerse derleme durur.
Kendi dosyasında tutulan bir Workload
workload: ve bir artifacts: girdisi, metni satır içinde tutmak yerine her biri bir dosya içe aktarabilir:
spec: workload: $import: ./workload/workload.yaml artifacts: networkpolicy: $import: ./artifacts/networkpolicy.yamlİçe aktarılan Workload dosyası, satır içi olanla aynı bağlama göre şablon olarak işlenir. Bir artifacts: girdisinin içe aktardığı dosya, bir derleme onu okumadan önce sabitlenir: aggrega pin <recipe-dir>/recipe.yaml, Recipe’nin yanına dosyanın özetini kaydeden bir entity.lock yazar ve kilit dosya için bir sabitleme kaydetmediği ya da dosya artık onunla eşleşmediği sürece derleme bu komutu adlandırarak durur. Workload kitaplığı içe aktarımı — $import ile paylaşılan bir Workload gövdesi, Workload’u içe aktarılan bir Recipe derler.