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/postgrestüründe birdbbileşeni, onuusesile kullanan birappve 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 bircore/backupeki, 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:
aggrega scaffold --example postgres-three-realizationsArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd postgres-three-realizationsDerleme
aggrega build --release release-selfhosted.yaml --auto-pullaggrega build --release release-managed.yaml --auto-pullaggrega build --release release-managed-dns.yaml --auto-pullaggrega 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:
rm -rf dist && aggrega build --release release-managed.yamlBir 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.
- name: DB_HOST value: db-defaultYö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.
- 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.netRecipe bu adı Terraform başvurusu yerine host olarak yayımlar
ve uygulama onu alır:
- name: DB_HOST value: db.internal.example.net| değişken | release-managed.yaml | release-managed-dns.yaml |
|---|---|---|
DB_HOST | ${module.db.address} | db.internal.example.net |
DB_PORT | 5432 | 5432 |
Çı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:
[… 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: 5432StatefulSet 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- name: DB_HOST value: postgres.data.example.netBir 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 ofPostgreSQL, which addresses a server it does not provision, but no address wassupplied: set infra.overrides.host on this component in the Release to the DNSname or IP literal the existing server answers onAsıl önemli olan karşılaştırma
Uygulamanın oluşturulan ortamı, üçü yan yana:
| değişken | kendi barındırılan | yönetilen | harici |
|---|---|---|---|
POOL_SIZE | 10 | 10 | 10 |
DB_HOST | db-default | ${module.db.address} | postgres.data.example.net |
DB_NAME | appdb | appdb | appdb |
DB_PORT | 5432 | 5432 | 5432 |
DB_PROTOCOL | postgres | postgres | postgres |
DB_USER | appuser | appuser | appuser |
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.