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-bridgeFeature’ının compose FeatureRecipe’i, bu dikişi aşmak için biraggrega-gwağ 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üketicinincore/k8s-dns-resolveryö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/postgresTek 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:
aggrega scaffold --example cross-boundary-networkingArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd cross-boundary-networkingDerleme
Her varyant, kendi katalog dizinine karşı derlenen bir Release’dir; her çalıştırmada bir Release:
aggrega pull --release release-compose.yaml --catalog catalog-composeaggrega build --release release-compose.yaml --catalog catalog-composeaggrega pull --release release-helm.yaml --catalog catalog-helmaggrega build --release release-helm.yaml --catalog catalog-helmBir 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ü
aggrega pull --release release-compose.yaml --catalog catalog-composeaggrega 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 nginxstreamyapılandırmasını yazar; bu yapılandırma bağlanmış bir compose config olarak teslim edilir (üst düzeyconfigs:,/etc/nginx/nginx.confkonumuna bağlanır); birresolverve kenar başına değişkenli birproxy_passiç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çidininx-aggrega-networks-ofalanı 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üketicininADMINER_DEFAULT_SERVERdeğeriniaggrega-gw:5432olarak yeniden yazar. Yeniden yazma, adminer’ın kendidatabasesbağ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
cd dist/bridge/composedocker compose uphttp://localhost:8080 adresini açın (sunucu aggrega-gw:5432 olarak önceden doldurulmuştur) ve oturum açın:
| Alan | Değer |
|---|---|
| Sistem | PostgreSQL |
| Sunucu | aggrega-gw:5432 (önceden doldurulmuş) |
| Kullanıcı adı | appuser |
| Parola | apppass |
| 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
aggrega pull --release release-helm.yaml --catalog catalog-helmaggrega build --release release-helm.yaml --catalog catalog-helmAynı 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: frontenddist/frontend/helm/adminer-default-service.yaml # metadata.namespace: frontenddist/backend/helm/db-statefulset.yaml # metadata.namespace: backenddist/backend/helm/db-default-service.yaml # metadata.namespace: backenddist/backend/helm/db-headless-service.yaml # metadata.namespace: backendaggrega-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:
- 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şi | ayrı 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ümlenir | aggrega-gw:5432 (yeniden yazılmış) | db-default.backend (çağıran tarafında nitelenmiş) |
| ek kaynak | aggrega-gw servisi + yapılandırması | yok |
aynı aggrega.ai/namespace şunu belirler | compose ağı yerleşimi | k8s 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.