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

Bir derlemenin dosyaları

Bu sayfa tek bir fikri, bir derlemenin hangi dosyasının neyi söylediğini açıklar ve çalıştırılabilir bir çalışma alanı değildir. Adım adım kurulan, PostgreSQL’li bir web uygulaması bunu derlediğiniz bir çalışma alanında gösterir; şu komutla kendi klasörünüze yazın:

Terminal window
aggrega scaffold --example quickstart-web

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

Terminal window
cd quickstart-web
cd 1
aggrega build --release release.yaml --auto-pull
export QUICKSTART_DB_PASSWORD=choose-a-password
docker compose -p quickstart-web -f dist/compose/docker-compose.yaml up -d --wait
# then open http://127.0.0.1:8080/ in your browser

Beş tür dosya, her birinin tek bir yazarı

Bir derleme beş tür dosya okur. Her biri tek bir şey söyler ve tipik bir ekipte her birinin kendi yazarı vardır:

  • bir Component, bir bileşen türünün ne olduğunu söyler: bir geliştiricinin ayarlayabileceği değerler, bir operatörün ayarlayabileceği altyapı ayarları, kendisine bağlanan bileşenlere yayımladıkları ve üzerinden bağlandığı soketler. Standart kütüphane kataloğu, çoğu uygulamanın ihtiyaç duyduğu core/datastore/postgres ve core/compute/server gibi Components’i içerir; bu yüzden bir çalışma alanı genellikle hiçbirini yazmaz;
  • bir Aggregate geliştiriciye aittir: uygulamanın hangi bileşenlere sahip olduğu ve her birinin neye bağlandığı;
  • bir Recipe, bir bileşen türünü tek bir araç için dosyalara dönüştürür — bir Compose hizmeti, bir Helm chart’ı, bir Terraform modülü;
  • bir Manifest, tek bir hedef için her bileşen türünü hangi Recipe’nin gerçekleştireceğini seçer;
  • bir Release, bir Aggregate ve bir Manifest adlandırır ve bir ortamın ayarlarını verir. Derlediğiniz şey budur: aggrega build --release release.yaml.

Bu ayrım bir yönlendirmedir: tek bir kişi beşini de yazabilir ve derleme, her biri geçerli olduğu sürece herhangi birini kabul eder.

Aggregate: bileşenler ve bağlantıları

Örnekteki ilk adım bir web uygulaması ve veritabanıdır. Aggregate’i, yorumları çıkarılmış hâliyle 1/aggregate.yaml dosyasından:

spec:
components:
web:
type: core/compute/server
features:
db_password:
type: core/secret-value
values:
key: PGPASSWORD
origin: "${QUICKSTART_DB_PASSWORD}"
uses:
database:
db:
target: db
inject:
env:
- in: PGHOST
from: host
- in: PGPORT
from: port
- in: PGUSER
from: user
- in: PGDATABASE
from: database
db:
type: core/datastore/postgres
features:
password:
type: core/secret-value
values:
key: POSTGRES_PASSWORD
origin: "${QUICKSTART_DB_PASSWORD}"

Burada hiçbir şey bir port, bir host, bir ad alanı ya da bir araç adlandırmaz. web, database soketi üzerinden db’ye bağlanır ve inject listesi, veritabanının yayımladığı her girdiyi uygulamanın hangi değişkeninin aldığını söyler: from: girdiyi, in: değişkeni adlandırır.

Bir bağlantı, boru hattından geçirilen bir dizedir

Veritabanının Recipe’si, bağlantının okuması için host, port, user ve database yayımlar. host değerinin hangi adresi tuttuğu, Manifest’in seçtiği Recipe’ye bağlıdır: veritabanı uygulamanın yanında çalışıyorsa bir hizmetin adı, yönetilen bir veritabanı için bir hazırlama aracının çözümlediği bir işaretçi dizesi ya da zaten var olan bir sunucunun adresi. Derleme, yayımlanan her dizeyi Aggregate’in adlandırdığı değişkene kopyalar ve onu yorumlamaz: hiçbir zaman bir adresi çözümlemez ya da erişilebilir olup olmadığını denetlemez.

Manifest ve Release

1/manifest.yaml dosyasındaki Manifest, her bileşen türünü ve parola eklerini, onu Docker Compose üzerinde gerçekleştiren Recipe’ye bağlar:

spec:
mappings:
components:
type:
core/compute/server:1.1.0: compose/server:2.0.0
core/datastore/postgres:1.0.0: compose/postgres:1.0.0
features:
type:
core/secret-value:1.0.0: compose/dotenv-secret:1.0.0

1/release.yaml dosyasındaki Release, Aggregate’i ve Manifest’i adlandırır ve yalnızca bir ortamın bildiğini verir; burada uygulamanın çalıştırdığı imaj, dinlediği port ve Docker Compose’un onu makinenizin geri döngü adresinde yayımladığı port (imajın özeti kısaltılmıştır):

spec:
aggregate: quickstart-web
manifest: quickstart-web-compose
components:
web:
infra:
image: hub.aggrega.ai/tools/quickstart-web:1.1.0@sha256:…
port: 8080
published_port: 8080
db: {}

Örnekteki sonraki adımlar onu büyütür: veritabanının yanında bir Redis önbelleği, ardından Terraform aracılığıyla AWS üzerinde aynı bileşenler, ardından veritabanının yedekleri.

Parametreler: tek Aggregate, çok ortam

Ortamlar arasında farklılık gösteren bir değer, Aggregate’te türü belirtilmiş bir parametre olarak bildirilir, kullanıldığı yerde başvurulur ve her Release tarafından verilir. İsteğe bağlı çalıştırılan bir görev örneğinde Aggregate, raporunun zamanlamasını bildirir:

spec:
parameters:
report_schedule:
type: string
default: ""
components:
report:
type: core/compute/task
values:
schedule: "{{ .parameters.report_schedule }}"

ve bir Release onu karşılar:

spec:
parameters:
report_schedule: "30 2 * * 1-5"

Derleme, şablonu doldurmadan önce bir Release’in verdiği her değeri parametrenin türüne göre denetler. Bir Release bir bileşenin values alanını hiçbir zaman kendisi yazmaz: Aggregate’in sunduğu parametreleri karşılar; böylece hangi değerlerin ortama göre değiştiğini söyleyen tek yer Aggregate olarak kalır. Bir Release parametrelerini kendilerine ait bir dosyadan da okuyabilir: parameters: { $import: ./env/prod-values.yaml }.