İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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:

Terminal window
aggrega scaffold --example mariadb-adminer

Ardından sırada çalıştırılacak komutları yazdırır:

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

Bir 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’nin valuesMapping değ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: 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 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: 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, 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.