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

Tek sözleşme, üç gerçekleştirim

Bir PostgreSQL veritabanı ve onu okuyan uygulama, değişmeyen tek bir Aggregate’ten üç farklı şekilde dağıtılır: kümede çalışan PostgreSQL, yönetilen bir bulut örneği olarak PostgreSQL ve bu Release dağıtılmadan önce zaten var olan bir PostgreSQL sunucusu.

Ders, neyin değişmediğidir. Uygulama, veritabanından istediği anahtarları ve bunlara ne ad verileceğini bir kez belirtir. Üçünden hangisinin yanıt verdiğini hiçbir zaman öğrenmez. Derleyici de öğrenmez: seçilen Recipe’in yayımladığı anahtarları okur ve dizeleri yönlendirir.

Değişen tek şey

.-- helm/postgres ---------- a StatefulSet in the cluster
/
core/datastore/postgres --- terraform/postgres-rds -- an RDS instance in Terraform
one Component \
one contract '- helm/postgres-external -- a server that already exists

Üç Recipes aynı Component’i uygular. Her biri aynı provides anahtarlarını yayımlar — host, port, user, database, protocol ve bir kazıyıcının veritabanının metriklerini nerede bulacağını söyleyen, üçünde de boş olan anahtarlar. Hangisinin çalışacağı Manifest’teki tek bir satırdır.

Dosyalar

  • aggregate.yaml — geliştirici amacı ve üç dağıtımın tümü için aynı belge: core/datastore/postgres türünde bir db bileşeni, onu uses ile kullanan bir app ve uygulamanın istediği beş anahtar. Burada hiçbir şey bir hedefi, bir bulutu ya da bir Recipe’i adlandırmaz.
  • manifest-selfhosted.yaml, manifest-managed.yaml, manifest-external.yaml — Ops eşlemeleri. Her biri gerçekleştirimini tek bir satırda seçer: PostgreSQL bileşen türünün hangi Recipe’e bağlandığı. Yönetilen eşleme, Releases’inin eklediği yedekleme Feature’ını da bağlar.
  • release-selfhosted.yaml, release-managed.yaml, release-external.yaml — operatörün her Release’teki boyutlandırması: küme içi dağıtım için depolama ve motor sürümü, yönetilen dağıtım için depolama, HA ve bir core/backup eki, başvurulan dağıtım için ise mevcut sunucunun adresi.
  • release-managed-dns.yaml — yönetilen Release bir kez daha, operatörün örneğe verdiği DNS adıyla birlikte; böylece uygulamaya çözümleyebileceği bir ad verilir.
  • catalog/ — uygulamanın kendi Component’i ve onu işleyen tek Recipe. Veritabanı tarafındaki her şey standart kitaplıktan değiştirilmeden gelir.

Ö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 postgres-three-realizations

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

Terminal window
cd postgres-three-realizations

Derleme

Terminal window
aggrega build --release release-selfhosted.yaml --auto-pull
aggrega build --release release-managed.yaml --auto-pull
aggrega build --release release-managed-dns.yaml --auto-pull
aggrega build --release release-external.yaml --auto-pull

--auto-pull, her Release’in kilit dosyasını ilk derlemesinde yazar; sonraki derlemeler bayrağa ihtiyaç duymaz. Her biri dist/ dizinine yazar ve bir derleme, öncekinin bıraktıklarını temizlemek yerine kendi dosyalarını ekler. Bir gerçekleştirimin çıktısını tek başına okumak için çalıştırmalar arasında dist/ dizinini silin:

Terminal window
rm -rf dist && aggrega build --release release-managed.yaml

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 hiçbir klasör oluşturmayın. Workspace klasöründe henüz `postgres-three-realizations` klasörü yoksa, `scaffold` aracını `example` değeri `postgres-three-realizations` olacak şekilde ve `dir` olmadan bir kez çağırın: örneği yeni bir `postgres-three-realizations` klasörüne yazar. Ardından `build` aracını her Release için birer kez, şu sırayla çağırın — `release-selfhosted.yaml`, `release-managed.yaml`, `release-managed-dns.yaml` ve `release-external.yaml` — her seferinde `workspace_root` değeri `postgres-three-realizations`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde. Her derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `postgres-three-realizations/dist/` altındadır.

Her birinin ürettiği çıktı

Kendi kendine barındırılan — sunucuyu dağıtımın kendisi çalıştırır

helm/postgres veritabanını küme içinde sentezler: bir StatefulSet, bir ClusterIP Service ve bir headless Service. provides.host bu Service’in yalın adıdır, bu yüzden uygulama ona küme içi DNS ile ulaşır.

dist/stack/helm/app-deployment.yaml
- name: DB_HOST
value: db-default

Yönetilen — sunucuyu bir bulut sağlayıcısı çalıştırır

terraform/postgres-rds Terraform HCL olarak bir aws_db_instance üretir ve operatörün ha boyutlandırması ile core/backup eki örneğin yerel ayarlarına eşlenir: ekin retention_days: 14 değeri örneğin backup_retention_period = 14 değeri olur. Uygulama yine Kubernetes’e işlenir: bu dağıtımın iki tarafı ortak bir hedefte değil, veritabanının yayımlanmış sözleşmesinde buluşur.

dist/stack/helm/app-deployment.yaml
- name: DB_HOST
value: ${module.db.address}

Bu değer bir ana makine adı değildir ve bu derlemedeki hiçbir şey onu bir ana makine adına dönüştürmez. Bir RDS örneğinin adresi, örnek oluşturulana kadar var olmaz; bu yüzden önceden çalışan bir derleyicinin arayabileceği bir şey yoktur. Recipe’in yayımladığı şey, veritabanının kendi modülünün bir çıktısına yönelik bir Terraform başvurusudur; derleyici onu kenar boyunca dokunmadan aktarır, uygulamanın Recipe’i onu olduğu gibi alır ve Kubernetes manifest’ine yukarıda gösterilen karakterlerle aynen işlenir. Konteynere bu metin verilir.

DB_PORT farklıdır: "5432" olarak işlenir, çünkü Recipe örneğin portunu Release’ten ayarlar ve aynı değeri yayımlar; bu değer herhangi bir şey var olmadan önce bilinir.

İki bileşen arasındaki yerel bağlantı, bir hedefin kendi çıktısı içinde yaptığı bir şeydir; bu yüzden burada yapılacak bir bağlantı yoktur. Bu kenarın iki ucu farklı hedefler üzerinden işlenir — veritabanı Terraform HCL’ye, uygulama bir Kubernetes manifest’ine — ve bir Terraform başvurusu yalnızca bir Terraform yapılandırması içinde anlam taşır. Bu sınırı geçerken yayımlanan değer, diğer her dize gibi metin olarak teslim edilir. Veritabanıyla aynı kök yapılandırmada, Terraform üzerinde bir source: Recipe’i olarak işlenen bir tüketici, aynı başvuruyu modülünün argümanlarından biri olarak alır ve orada Terraform onu çözümler.

Bu, RDS için özel bir durum değil, genel kuraldır: çalışan bir sistemin durumuna bağlı olan her şey, derleyicinin getirdiği bir değer olarak değil, çalışma zamanının çözümlediği deterministik bir işaretçi olarak ifade edilir. Derleyicinin payı, işaretçiyi değiştirmeden teslim etmektir. Ulaştığı yerde çözümlenmesini sağlamak Recipe yazarının işidir: tüketen tarafın kullanabileceği bir adres yayımlayın ya da her iki bileşene aynı hedefe işlenen Recipes verin.

Örneğe uygulamanın çözümleyebileceği bir ad vermek

terraform/postgres-rds bunlardan ilkini operatörün ayarladığı bir seçenek olarak alır. release-managed-dns.yaml, tek bir eklemeyle yönetilen Release’tir: operatörün örneğe verdiği DNS adı:

db:
infra:
overrides:
host: db.internal.example.net

Recipe bu adı Terraform başvurusu yerine host olarak yayımlar ve uygulama onu alır:

dist/stack/helm/app-deployment.yaml
- name: DB_HOST
value: db.internal.example.net
değişkenrelease-managed.yamlrelease-managed-dns.yaml
DB_HOST${module.db.address}db.internal.example.net
DB_PORT54325432

Çıktıda değişen tek satır budur. Recipe bu ad için hiçbir DNS kaydı ve hiçbir takma ad üretmez ve derleme onu aramaz: derleyici onu, başvuruyu aktardığı gibi aynen aktarır. Örnek var olduğunda db.internal.example.net adını örneğe yönlendirmek — operatörün kendi DNS bölgesinde, örneğin adresini hedefleyen bir kayıt — Release’in dışında, operatörün işidir. Anahtar, aşağıdaki başvurulan gerçekleştirmenin aynı adres için okuduğu anahtardır; bu Recipe onu yalın bir ad ya da IP sabiti olarak alır ve şema, yol, kullanıcı veya port içeren bir değer derlemeyi durdurur, çünkü port Release’in infra.port değeridir ve tüketici bağlantısını bu ikisinden oluşturur.

Veritabanıyla aynı Terraform yapılandırmasına işlenen bir tüketici de adı alır ve bununla birlikte başvurunun ona sağladığı sıralamayı kaybeder: Terraform bir modül üzerinde, başvurduğu bir modülden sonra işlem yapar ve bir ad hiçbir şeye başvurmaz. Bu tüketiciyi, veritabanının directory: değerini paylaşan ve daha sonraki bir syncWave: taşıyan kendine ait bir sınıra yerleştirmek sıralamayı geri getirir.

Harici — bu dağıtımda sunucuyu kimse çalıştırmaz

helm/postgres-external hiçbir şey sağlamaz. Tüm çıktısı, küme içi bir adı Release’in sağladığı adrese eşleyen tek bir Service’tir:

dist/stack/helm/db-service.yaml
[… omitted: the Service's apiVersion, kind and metadata — its name, db, and the labels and annotations every rendered document carries]
spec:
type: ExternalName
externalName: postgres.data.example.net
ports:
- port: 5432

StatefulSet yok, birim yok, konteyner yok — sunucunun yaşam döngüsü tamamen bu dağıtımın dışındadır. Adres Release’ten gelir:

db:
infra:
overrides:
host: postgres.data.example.net
dist/stack/helm/app-deployment.yaml
- name: DB_HOST
value: postgres.data.example.net

Bir sunucuya başvurmak, onu devralmakla aynı şey değildir. Bu Recipe, harici olarak sahiplenilmeye devam eden bir sunucuya ulaşır; buradaki hiçbir şey onu dağıtımın yönetimine almaz ve buradaki hiçbir şey onu değiştirmez.

Adresi dışarıda bırakırsanız derleme durur ve bunu bildirir. Başvurulan bir sunucunun ya bir adresi vardır ya da hiçbir şeyi yoktur; bu yüzden Recipe boş bir ada takma ad veren bir Service üretmek yerine reddeder:

[… omitted: what resolving the lockfile prints, the same halt among it, then [CATALOG_ERROR E0033], the Recipe's assertion external_host_supplied, its template position and source, and "error calling fail:"]
assertion failed: the Manifest selects the referenced realization of
PostgreSQL, which addresses a server it does not provision, but no address was
supplied: set infra.overrides.host on this component in the Release to the DNS
name or IP literal the existing server answers on

Asıl önemli olan karşılaştırma

Uygulamanın oluşturulan ortamı, üçü yan yana:

değişkenkendi barındırılanyönetilenharici
POOL_SIZE101010
DB_HOSTdb-default${module.db.address}postgres.data.example.net
DB_NAMEappdbappdbappdb
DB_PORT543254325432
DB_PROTOCOLpostgrespostgrespostgres
DB_USERappuserappuserappuser

Her seferinde aynı değişkenler, aynı sıra. Yalnızca birinin arkasındaki dize değişir. Uygulamanın Recipe’i DB_ değişkenlerinin hiçbirini adlandırmaz: uses kenarı neyi çözümlediyse onu üretir; tek bir Recipe’in üç veritabanına karşı da değişmeden oluşturulmasının nedeni budur.

Üstelik derleyici bu dizelerin ne olduğunu bilmez. db-default bir Kubernetes Service adıdır, ${module.db.address} bir Terraform referansıdır, postgres.data.example.net bir DNS adıdır; derleyici için bunlar, bir Recipe’in host anahtarı altında yayımladığı ve bir kenarın DB_HOST olarak teslim edilmesini istediği üç dizedir. Derleyici bunlardan herhangi birinin yönlendirilebilir olduğunu, bir portun sayı olduğunu ya da db adlı bir bileşenin veritabanı olduğunu denetlemez. Kenarı Component’in taşıdığı etikete göre eşleştirmiş, sözleşmenin bildirdiği anahtarı okumuş ve metni taşımıştır.

Ayrım noktası nerede

Üç dağıtımın her biri bir Ops eşlemesiyle seçildi ve geliştirici belgesi bu seçimden etkilenmedi. Bu örneğin tamamı, tam da bu ayrımı somutlaştırmak için vardır:

  • geliştirici uygulamanın bir veritabanından neye ihtiyaç duyduğunu söyler;
  • Ops bir veritabanının nelerden oluştuğunu söyler — her gerçekleştirme için bir Recipe;
  • operatör bu dağıtıma hangisinin verileceğini söyler ve onu boyutlandırır.

Yarın dördüncü bir gerçekleştirme ekleyin — farklı bir bulut, farklı bir operatör, yerel çalışma için bir Compose servisi — ve bu, aynı anahtarları yayımlayan bir Recipe daha artı bir Manifest satırından ibarettir. Bu dizindeki aggregate.yaml dosyası değişmez.