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

Keycloak yığını — modül olarak oluşturulmuş, veritabanı destekli bir kimlik sunucusu

Bu örnek, küçük ama gerçek bir yığını — veritabanı destekli bir kimlik sunucusunu — Developer tarafından yazılmış tek bir Aggregate’ten sentezlenmiş Kubernetes manifestlerine derler.

Kimlik sunucusu tek bir bileşen değildir. Bir modüldür: tek iş yüklü iki bileşeni bir araya getiren, yeniden kullanılabilir bir alt aggregate —

  • hesap konsolunu ve token uç noktalarını HTTP portunda sunan ve yerel durum tutmayan bir sunucu ve
  • sunucunun realm’lerini, istemcilerini ve kullanıcılarını tutan ve bunları bir birimde kalıcı olarak saklayan bir arka uç, PostgreSQL.

Modül, sunucudan arka uca giden kendi iç kenarını bağlar ve sunucuyu http genel uç noktası olarak dışa aktarır. Üst düzey Aggregate modülü adıyla içe aktarır ve oluşturulan yığını render eder; operatör modülün iç bileşenlerini Release’te boyutlandırır.

Dosyalar

DosyaRol
aggregate.yamlDeveloper amacı: kimlik sunucusu modülünü (core/keycloak) içe aktarır.
manifest-helm-synth.yamlSunucu ve arka uç türlerini synth helm Recipes’e, modülün eklediği kimlik bilgisi Feature’ını da modülün kimlik bilgisi parametrelerinden bir Secret üreten gerçekleştirmeye eşler.
release-helm-synth.yamlKubernetes hedefi için operatör kaydı. Modülün iç bileşenlerini modül kapsamlı kimlikleriyle boyutlandırır; şema varsayılanlarına bırakılan her şey kendi kendine yeterli olarak render edilir.

Neyi gösteriyor

  • Modül olarak bileşim. Çok iş yüklü bir yetenek — aslında bir sunucu ile bir yapılandırma veritabanından oluşan bir kimlik sunucusu — tek parça bir bileşen olarak değil, tek iş yüklü iki bileşeni bir araya getiren bir alt aggregate olarak paketlenir. Modül adıyla içe aktarılır ve bir kimlik sunucusu gereken her yerde yeniden kullanılır.
  • Modül içinde bir iç kenar. Sunucu, arka ucu kullandığını bildirir; arka uç Recipe’inin provides host, port, kullanıcı ve veritabanı değerleri sunucuya aktarılır ve veritabanı bağlantısında birleştirilir. Derleyici dizeleri yorumlamadan yönlendirir.
  • Genel bir uç nokta. Modül, sunucusunu http olarak dışa aktarır; bu, bir tüketicinin bağlandığı kararlı genel addır — modülün iç bileşen adlarından ayrıdır.
  • İç bileşenlerin operatör tarafından boyutlandırılması. Release, işlem kaynaklarını ayarlamak için modülün iç bileşenlerine modül kapsamlı kimlikleriyle (server.backend, server.server) başvurur; geliştiricinin Aggregate’inin fiziksel boyutlandırmayı yeniden belirtmesi gerekmez.
  • Kendi kendini taşıyan şema. Sunucu, başlangıçta kendi şemasını arka uç üzerinde oluşturur ve taşır; böylece ayrı bir taşıma adımı olmadan hazır bir şemayla başlar.
  • Başvuruyla alınan paylaşılan bir kimlik bilgisi. Sunucu PostgreSQL arka ucunda kimlik doğrular, bu nedenle ikisi tek bir parolayı paylaşır. Modül bu parolayı db_password parametresi olarak alır ve core/referenced-secret kimlik bilgisi Feature’ını onunla iki kez ekler: arka ucun kendi kimlik bilgisi yuvasına ve sunucunun arka uca olan bağlantısının, yani sunucunun parolayı sunduğu bağlantının credential’ı olarak. Her iş yükü parolayı satır içinde taşımak yerine bir Secret’tan okur; ilk yönetici hesabının parolası ikinci bir parametredir, admin_password. Modül bu Feature’ı eklediği için Manifest onu eşler. Bu örnek her iki parametreyi modülün geliştirme varsayılanlarında bırakır ve Feature’ı her değeri taşıyan bir Secret üreten k8s-secret-from-parameter’a eşler; böylece yığın kendi kendine yeterli çalışır. Gerçek trafik taşıyan bir Release için Aggregate kendi parametrelerini bildirir ve bunları aggregates.server.parameters üzerinden aşağıya aktarır, Release bunları karşılar ve Manifest, Feature’ı her parametreyi namespace’te zaten var olan bir Secret’ın adı olarak okuyan k8s-existing-secret’a eşler.
  • Yeniden üretilebilir imajlar. Hem sunucu hem arka uç açık imaj etiketlerini sabitler; böylece render edilen manifestler kararlı imajlara başvurur.

Ö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 keycloak-stack

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

Terminal window
cd keycloak-stack

Derleme

Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur; --auto-pull, yeni bir klonda eksik olan kilit dosyasını derleme sırasında yazar:

Terminal window
aggrega build --release release-helm-synth.yaml --auto-pull

İşlenen yapıtlar dist/ altına yerleşir. Kubernetes hedefi düz manifestleri çevrimdışı işler — chart çekmek gerekmez.

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 `keycloak-stack` klasörü yoksa `scaffold` aracını `example` değeri `keycloak-stack` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `keycloak-stack` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `keycloak-stack`, `release` değeri `release-helm-synth.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `keycloak-stack/dist/` altındadır.

Oluşturulan yığın nasıl görünür

Sunucu, durumsuz bir Deployment ile HTTP portunda bir ClusterIP Service olarak render edilir. Konteyneri, arka uç kenarından oluşturulan bağlantıyı — arka ucun küme içi Service adı, kullanıcısı ve veritabanı — ayrıca kendi kendine yeterli HTTP ayarlarını, etkinleştirilip yönetim portunda sunulan sağlık uç noktalarını ve ilk yönetici hesabını taşır; her iki parola da Secret’lardan okunur:

env:
- name: KC_DB_PASSWORD
valueFrom:
secretKeyRef:
name: server-zdserver-db.credential
key: db-password
- name: KC_BOOTSTRAP_ADMIN_PASSWORD
valueFrom:
secretKeyRef:
name: server-zdserver-admin-password
key: admin-password
- name: KC_DB
value: postgres
- name: KC_DB_URL_HOST
value: server-zdbackend-default
- name: KC_DB_URL_PORT
value: "5432"
- name: KC_DB_URL_DATABASE
value: keycloak
- name: KC_DB_USERNAME
value: keycloak
- name: KC_HTTP_ENABLED
value: "true"
- name: KC_HOSTNAME_STRICT
value: "false"
- name: KC_HEALTH_ENABLED
value: "true"
- name: KC_HTTP_MANAGEMENT_PORT
value: "9000"
- name: KC_BOOTSTRAP_ADMIN_USERNAME
value: admin

Konteyner, HTTP portunun yanında yönetim portunu, 9000’i bildirir ve Deployment sunucuyu orada yoklar: /health/started üzerindeki başlangıç yoklaması sunucu önyüklenirken diğerlerini bekletir, /health/ready üzerindeki hazırlık yoklaması sunucu yanıt verene kadar trafiği uzak tutar ve /health/live üzerindeki canlılık yoklaması sunucu durursa onu yeniden başlatır. Service yine yalnızca HTTP portunu yönlendirir.

Arka uç, /var/lib/postgresql/data konumuna bağlanmış kalıcı bir birime sahip bir StatefulSet ile bir ClusterIP Service ve bir headless Service olarak render edilir. POSTGRES_PASSWORD değeri aynı veritabanı parolasını kendine ait bir Secret’tan, server-zdbackend-password’den okur. Üç Secret, modülün eklediği her kimlik bilgisi için bir tane olmak üzere iş yüklerinin yanında üretilir ve her biri modülün geliştirme varsayılanını taşır.