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
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer amacı: kimlik sunucusu modülünü (core/keycloak) içe aktarır. |
manifest-helm-synth.yaml | Sunucu 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.yaml | Kubernetes 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
provideshost, 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
httpolarak 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_passwordparametresi olarak alır vecore/referenced-secretkimlik 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ıncredential’ı 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 üretenk8s-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 okuyank8s-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:
aggrega scaffold --example keycloak-stackArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd keycloak-stackDerleme
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:
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: adminKonteyner, 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.