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

Sınırlar arası ağ iletişimi — tek niyet, iki dağıtım

İki bileşenli bir yığın — bir Adminer veritabanı arayüzü ve bir PostgreSQL veritabanı — iki sınıra bölünmüştür ve Adminer’ın veritabanına sınır dikişinin ötesinden ulaşması gerekir. Aynı geliştirici niyeti iki şekilde dağıtılır ve asıl ders bu karşıtlıktır:

  • Yerel (Docker Compose): her sınır kendi compose ağıdır ve birindeki bir servis diğerindeki bir servise adıyla ulaşamaz. Standart kütüphanedeki core/compose-bridge Feature’ının compose FeatureRecipe’i, bu dikişi aşmak için bir aggrega-gw ağ geçidi üretir.
  • Kubernetes (Helm): her sınır kendi namespace’idir ve birindeki bir pod başka birindeki bir Service’e yerel namespace’ler arası DNS ile ulaşır (db-default.backend) — köprü yoktur. Veritabanı yalın bir servis adı yayımlar; tüketicinin core/k8s-dns-resolver yönlendirme özelliği bu adı hedef namespace ile niteler.

compose-bridge, Kubernetes namespace’lerinin + namespace’ler arası DNS’in size yerel olarak sağladığı şeydir. Dikişin aşılması, hedefe göre değişen bir Ops/Operatör konusudur; geliştirici niyeti değişmez. Aynı aggrega.ai/namespace sınır ek açıklaması, bir varyantta compose ağı yerleşimini, diğerinde ise Kubernetes namespace yerleşimini yönlendirir.

Ortak geliştirici niyeti

aggregate.yaml her iki varyant için de aynıdır:

components:
adminer:
type: core/devtool/adminer
uses:
databases:
primary:
target: db
inject:
env:
- in: ADMINER_DEFAULT_SERVER # rewritten/resolved per variant
from: host # ← the target db's provides.host
db:
type: core/datastore/postgres

Tek uses kenarı, veritabanının host değerini ADMINER_DEFAULT_SERVER içine enjekte eder. Bu host’un neye çözümlendiği, Aggregate’in altında karar verilen bir Ops konusudur; bu yüzden aynı kenar, compose altında aggrega-gw:5432, helm altında ise db-default.backend sonucunu verir ve geliştirici niyetinde hiçbir değişiklik gerekmez.

Örneği oluşturun

Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.

Örneği, adını taşıyan yeni bir klasöre yazın:

Terminal window
aggrega scaffold --example cross-boundary-networking

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd cross-boundary-networking

Derleme

Her varyant, kendi katalog dizinine karşı derlenen bir Release’dir; her çalıştırmada bir Release:

Terminal window
aggrega pull --release release-compose.yaml --catalog catalog-compose
aggrega build --release release-compose.yaml --catalog catalog-compose
aggrega pull --release release-helm.yaml --catalog catalog-helm
aggrega build --release release-helm.yaml --catalog catalog-helm

Bir yapay zekâ asistanıyla

Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.

Yalnızca Aggrega araçlarını kullanın ve kendiniz klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `cross-boundary-networking` klasörü yoksa `scaffold` aracını `example` değeri `cross-boundary-networking` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `cross-boundary-networking` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `cross-boundary-networking`, `release` değeri `release-compose.yaml`, `catalog_dirs` değeri `catalog-compose` içeren bir liste, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Ardından `build` aracını aynı şekilde, `release` değeri `release-helm.yaml` ve `catalog_dirs` değeri `catalog-helm` içeren bir liste olacak biçimde çağırın. Her derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `cross-boundary-networking/dist/` altındadır.

Varyant A — yerel (Docker Compose): köprü

Terminal window
aggrega pull --release release-compose.yaml --catalog catalog-compose
aggrega build --release release-compose.yaml --catalog catalog-compose

Üst düzey bir bridge sınırı iki alt sınır barındırır: frontend (adminer) ve backend (db); bunlar tek bir dizini paylaşır, böylece tek bir dist/bridge/compose/docker-compose.yaml dosyasında birleşir. Her alt sınırın aggrega.ai/namespace ek açıklaması bir compose ağına dönüşür. Üst sınıra (sınır kapsamında) bağlanan core/compose-bridge, ağlar arası uses kenarından bir aggrega-gw ağ geçidi türetir. Standart kütüphanedeki FeatureRecipe’i, sınır için bir kez, köprülenecek kenarların bir tablosunu hesaplar — iki ucu da bu tek compose dosyasında, farklı ağlarda — ve aşağıdaki her şey kendi şablonları tarafından bu tablodan okunur:

  • onun valuesMapping’i ağ geçidinin nginx stream yapılandırmasını yazar; bu yapılandırma bağlanmış bir compose config olarak teslim edilir (üst düzey configs:, /etc/nginx/nginx.conf konumuna bağlanır); bir resolver ve kenar başına değişkenli bir proxy_pass içerir, böylece upstream bağlantı anında çözümlenir (Compose’un değişken yerleştirmesi nginx için dokunmadan bıraksın diye $, $$ olarak kaçışlanır);
  • aynı valuesMapping, ağ geçidinin x-aggrega-networks-of alanı altında iki ucu da adlandırır; compose sağlayıcısı bunu çözümler, böylece ağ geçidi köprülenen iki ağa da katılır;
  • adminer için çalıştırılan injectMapping’i, tüketicinin ADMINER_DEFAULT_SERVER değerini aggrega-gw:5432 olarak yeniden yazar. Yeniden yazma, adminer’ın kendi databases bağlantısının teslim ettiği değerin yerini alır; bu değişkeni adminer’a bağlı başka bir Feature teslim etmiş olsaydı, derleme onu değiştirmek yerine ikisini de adlandırarak dururdu.

Böylece trafik adminer → aggrega-gw:5432 → proxy_pass db:5432 şeklinde akar ve ağ sınırını ağ geçidi üzerinden geçer.

Çalıştırın

Terminal window
cd dist/bridge/compose
docker compose up

http://localhost:8080 adresini açın (sunucu aggrega-gw:5432 olarak önceden doldurulmuştur) ve oturum açın:

AlanDeğer
SistemPostgreSQL
Sunucuaggrega-gw:5432 (önceden doldurulmuş)
Kullanıcı adıappuser
Parolaapppass
Veritabanıappdb

Kimlik bilgileri yalnızca tanıtım amaçlıdır (yığın kutudan çıktığı gibi çalışsın diye db recipe’inde satır içinde ayarlanmıştır); gerçek bir dağıtım kimlik bilgisi alt sistemini kullanır.

Varyant B — Kubernetes (Helm): ad alanları + ad alanları arası DNS

Terminal window
aggrega pull --release release-helm.yaml --catalog catalog-helm
aggrega build --release release-helm.yaml --catalog catalog-helm

Aynı Aggregate, Kubernetes’e dağıtılmış hâliyle. Her biri, her kaynağa metadata.namespace olarak aktarılan ayrı bir aggrega.ai/namespace ek açıklaması taşıyan iki kardeş sınır:

dist/frontend/helm/adminer-deployment.yaml # metadata.namespace: frontend
dist/frontend/helm/adminer-default-service.yaml # metadata.namespace: frontend
dist/backend/helm/db-statefulset.yaml # metadata.namespace: backend
dist/backend/helm/db-default-service.yaml # metadata.namespace: backend
dist/backend/helm/db-headless-service.yaml # metadata.namespace: backend

aggrega-gw yoktur. Helm db tarifi, provides.host içinde yalın bir servis adı yayımlar — helm sağlayıcısı sentezlenen Service’i ad alanı olmadan <rendered_name>-<service-key> (db-default) olarak adlandırır. Tüketici core/k8s-dns-resolver yönlendirme özelliğini ekler (Release onu ADMINER_DEFAULT_SERVER değişkenine yönlendirir) ve özellik bu yalın ana bilgisayar adını tüketicinin kendi tarafında hedefin ad alanıyla niteler; böylece Adminer işlenmeden önce ad alanları arası DNS adı db-default.backend üretilir. Ana bilgisayar adı üreticiye elle yazılmaz, türetilir:

dist/frontend/helm/adminer-deployment.yaml
- name: ADMINER_DEFAULT_SERVER
value: db-default.backend # == the rendered db Service <name>.<namespace>

Bu değer, işlenen db Service’inin metadata.name + metadata.namespace değerleriyle bayt bayt eşleşir ve kanıtın tamamı budur: Kubernetes ad alanları arası DNS belirlenimci bir sözleşmedir; dolayısıyla işlenen ana bilgisayar adı işlenen Service kimliğine eşitse çalışma zamanında çözümlenir — bağlantıyı doğrulamak için ne ağ geçidine ne de canlı bir kümeye gerek vardır.

İkilik

compose (Varyant A)helm (Varyant B)
sınır dikişiayrı compose ağlarıayrı namespace’ler
geçiş mekanizmasıcore/compose-bridge ağ geçidi (aggrega-gw)yerel namespace’ler arası DNS
ADMINER_DEFAULT_SERVER şuna çözümleniraggrega-gw:5432 (yeniden yazılmış)db-default.backend (çağıran tarafında nitelenmiş)
ek kaynakaggrega-gw servisi + yapılandırmasıyok
aynı aggrega.ai/namespace şunu belirlercompose ağı yerleşimik8s namespace yerleşimi

Tek bir geliştirici niyeti; dikiş geçişi ise provider’a özgü Ops/Operator mekanizmasıdır. Compose köprüsü, düz bir compose ağında namespace kapsamlı DNS olmadığı için vardır; Kubernetes bunu size yerel olarak sağlar.

İki uç farklı sağlayıcılar altında işlendiğinde

Yukarıdaki iki varyant da tek bir geliştirici niyetini korur ve geçişin bir deterministik işaretçi dizesi üzerinden yürümesine izin verir: veritabanının provides.host değeri sınır dikişinden kararlı bir işaretçi olarak geçer ve her hedef bu işaretçiyi kendi yoluyla çözümler — bir compose ağ geçidi adresi ya da ad alanları arası bir DNS adı. İşaretçi her zaman geçer, çünkü derleyici dizeleri bir üretici ile bir tüketici arasında yorumlamadan aktarır.

Bir sağlayıcı daha ileri gidip dikişin iki yanındaki kendi birleştirilmiş yapıtlarından ikisi arasında bir yerel çapraz başvuru kurabilir — o sağlayıcının kendi sözcük dağarcığında, hedef platformun dağıtım zamanında çözümlediği bir başvuru. CloudFormation sağlayıcısı bunu yığınlar arasında geçen bir uses kenarı için yapar: üretici yığın bir Export yayımlar ve tüketici yığın bunu Fn::ImportValue ile okur (bkz. providers/cloudformation.md). Yerel çapraz başvuru, aynı sağlayıcıya özgü bir iyileştirmedir — iki uç da aynı yapıt sözcük dağarcığını konuştuğu için çalışır; böylece bir taraf, diğer tarafın nasıl çözümleyeceğini bildiği bir başvuru yayımlayabilir.

Bir uses kenarı iki farklı sağlayıcı arasındaki bir sınırı geçtiğinde — üretici bir sağlayıcı altında, tüketici ise başka bir sağlayıcı altında birleştirildiğinde — yerel çapraz başvuru mümkün değildir. Bir sağlayıcının sözcük dağarcığında üretilen başvuru diğeri için hiçbir anlam taşımaz ve derleyici bunlar arasında çeviri yapmaz: dizeleri aktarır, anlam çıkarmaz ya da bir sağlayıcının başvurusunu diğerinin biçimine yeniden yazmaz. Bu nedenle üreticinin deterministik işaretçisi dikişi değişmeden geçer; iki sağlayıcıdan herhangi biri CloudFormation’ın yaptığı gibi kendi yerel çapraz başvurularını bağlıyorsa, derleyici iki uç noktayı, iki sağlayıcı adını ve soketi belirten bir uyarı verir; ve derleme bu işaretçiyle tamamlanır. Derleyici yazara güvenir ve durmaz: yazarın sağladığı deterministik bir işaretçi dikiş boyunca pekâlâ çözümlenebilir olabilir — kararlı bir DNS adı ya da bir altyapı enterpolasyon dizesi — ve hedef topolojiyi yalnızca yazar bilir.

Bu, dikiş geçişini ait olduğu yerde tutar. Sağlayıcılar arası bir işaretçinin kullanılabilir olup olmadığı, yazarın sahiplendiği bir dağıtım konusudur; bir sağlayıcının yerel başvurusunu başka bir sağlayıcının tüketici biçimine çevirmek, tarafsız çekirdeğin dışında yer alan, belirli bir görüşe dayanan ve sağlayıcıya özgü bir iştir.

Düzen

cross-boundary-networking/
├── .aggrega-config.yaml # marks this folder as the workspace root; names the hub registry
├── aggregate.yaml # SHARED developer intent (both variants)
├── release-compose.yaml # Variant A: parent bridge boundary + two networks
├── manifest-compose.yaml
├── catalog-compose/ # local adminer compose recipe (the component + the rest from standard)
├── release-helm.yaml # Variant B: two namespace boundaries, no bridge
├── manifest-helm.yaml
└── catalog-helm/ # local adminer helm recipe (the components + the rest from standard)

Bu örnek standart kütüphaneyi kullanır. Her varyant, kendi yerel dizini olan --catalog catalog-<variant> ile derlenir ve bu dizinin bildirmediğini .aggrega-config.yaml dosyasının adlandırdığı varsayılan kayıt defteri olan hub.aggrega.ai’den çözümler; böylece yerel varlıklar paylaşılanlardan önce çözümlenir. core/datastore/postgres, paylaşılan core/devtool/adminer arayüz bileşeni, compose ve helm FeatureRecipes’iyle birlikte core/compose-bridge ve core/k8s-dns-resolver Features’ı ve compose/helm sağlayıcıları standart katalogdan gelir. Yerel kalan, örneğe özgü öğretici içeriktir: hedefe özgü Adminer tarifleri. Helm db tarifi, standart kütüphanenin helm/postgres tarifidir ve provides.host değeri yalın, kendi içinde yeterli bir servis adıdır. Tüketici, bu adı standart kütüphanedeki core/k8s-dns-resolver yönlendirme özelliği aracılığıyla çağıran tarafta hedef ad alanıyla nitelendirir; böylece tarif hiçbir sınır ad alanını sabit olarak kodlamaz.

Derlenmiş bir varyantta iki dosya kategorisi bir araya gelir: yazılan girdiler (yukarıdaki her şey) ve dist/ altındaki derleyici tarafından üretilen çıktı (birleştirilmiş docker-compose.yaml ya da ad alanı başına helm manifestleri) — bunlardan hiçbirini siz yazmazsınız. dist/, aggrega build tarafından yeniden üretilir ve gitignore ile yok sayılır.