Oturum açınToplantı planlayın

Bölüm 2.1

Mimari

Nexus paketindeki her servisin neye sahip olduğu ve altında hangi veri depolarının bulunduğu, ardından servisler arası kimlikten her model çağrısının izlediği yola kadar bunları bir arada tutan kurallar.

Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

19 dakikalık okuma

Tomás Reilly, Harrow Port Authority'deki ilk kurulumu tamamladığında, kubectl -n nexus get pods on Deployment ve yedi StatefulSet ile üç CronJob gösterdi. Veritabanını oluşturan taşıma (migration) Job'ları çoktan gitmişti, çünkü her biri başarılı olduğunda kendini siler. Bu liste tüm platformdur. Bunu öğrenin, çünkü ikinci gün sorularının çoğu "bunlardan hangisi şunun sahibi?" ile başlar.

Bu bölüm her bir parça için bu soruyu yanıtlar, bunların üzerinden tek bir isteği takip eder ve ardından hepsinin uyduğu kuralları ele alır. 2. Bölümün geri kalanı bu tablo üzerine inşa edilmiştir.

Servisler ve her birinin sahip oldukları

Chart, Kubernetes 1.33 veya sonraki sürümleri için 1.0.0-alpha.1 sürümünde tek bir Helm chart'ıdır: nexus. Her iş yükü, tüm Linux yetenekleri (capabilities) kaldırılmış olarak, root olmayan bir kullanıcı olarak kendi ServiceAccount'u altında çalışır. Kimliği ve anahtarları koruyan servislere yapılan çağrılar karşılıklı TLS (Taşıma Katmanı Güvenliği) üzerinden çalışır ve genel API (uygulama programlama arayüzü), YZ (yapay zeka) yönlendiricisi ile bir süreci paylaşır.

Bileşen Deployment ve Service Servis bağlantı noktası Sahip oldukları
Konsol nexus-alpha 3000 Kişilerin gördüğü sayfalar; konsol ana bilgisayarında HTML (Hiper Metin İşaretleme Dili) sunar
BFF (ön uç için arka uç) nexus-alpha-bff 8080 Konsolun kendi verileri, her kişinin aldığı menü, sürüm kaydı
Auth nexus-auth 9101 (8443 üzerinde karşılıklı TLS) Kişiler, kuruluşlar, oturumlar, belirteçler (token'lar), API anahtarları, kuruluşun model anahtarı havuzu
Ağ geçidi (Gateway) nexus-gateway 9092, WebSocket 8093 YZ Sağlayıcı Yönlendiricisi (AI Provider Router) ve REST (temsili durum aktarımı) ile MCP (Model Bağlam Protokolü) için genel API ucu
Orkestratör (Orchestrator) nexus-orchestrator 8080 UNO gönderimi: her işi kabul etme ve kuyruğa alma
İş akışları (Workflows) nexus-workflows 8081 UNO yürütmesi: kuyruğa alınmış işleri çalıştıran işçi (worker)
GraphRAG nexus-graphrag 8090, WebSocket 8091 Bellek: bilgi grafiği ve onun üzerinden erişim (retrieval)
Probitas nexus-probitas 9151 (HTTPS) Kanıt: yönetişim kayıtları ve mühürlü kayıt defteri (ledger)
Beceri motoru (Skills engine) nexus-skills-engine 8095 Beceri kitaplığı; becerileri bulma ve çalıştırma
Anahtarlar (Keys) nexus-keys 8080 (HTTPS, karşılıklı TLS) OpenBao'da kuruluş başına anahtarlar, gözetim (custody), kurulum kimliği
Eklentiler (Plugins) nexus-plugins 9111 Eklenti kayıt defteri ve katalog kayıtları; varsayılan olarak kapalıdır
Dosya işleme nexus-fileprocess 9109 Yüklenen belgeleri ve görüntüleri okuma; varsayılan olarak kapalıdır

İlk onu zorunludur. Son ikisi isteğe bağlıdır; bir Enterprise kurulumunun veya bir alan paketinin (domain pack) bunları kullandığı yerlerde components.plugins.enabled ve components.fileprocess.enabled ile açılır. Bir diğer isteğe bağlı servis olan 8080 numaralı bağlantı noktasındaki nexus-alive, kendi anahtarına (components.alive.enabled) sahiptir ve varsayılan olarak o da kapalıdır. Her biri için kopyalar (replicas) ve kaynaklar components.<name> altında yer alır.

Konsol, veritabanı olmayan, sunucu tarafında oluşturulan sayfalardan oluşur. BFF ile ve küme içindeki nexus-auth ile konuşur; asla genel kimlik doğrulama ana bilgisayarından dışarı çıkıp tekrar içeri girmez. Chart'ın tek edition değerinden NEXUS_EDITION olarak ilettiği sürümü (edition) olmadan başlamayı reddeder. Bir kuruluşun her üyesi, kendi rolüne göre bunun içinde çalışır. Yönetim sayfaları sahipler ve yöneticiler içindir; bunlardan birini açan bir üye "Yönetici değil" ("Not an administrator") sayfasıyla karşılaşır.

BFF, konsolun sunucu yarısıdır ve Nexus Alpha ürünü olarak kaydedilmiş bir platform eklentisi olarak oluşturulmuştur. Konsolun kendi tablolarını ayrı bir veritabanında (nexus_alpha) tutar ve bir kişinin hangi menü gruplarını göreceğine karar verir. Konsolun bir işin yapılmasını gerektiğinde, BFF bu işin sahibi olan servisten talepte bulunur.

nexus-auth, Go ile yazılmıştır ve belirteç (token) üreten tek servistir. Varsayılan olarak erişim belirteçleri 15 dakika ve yenileme belirteçleri 12 saat yaşar (auth.accessTokenTTL, auth.refreshTokenTTL). Oturum açmış her kişiyi, 429 yanıtı vermeden önce dakikada 5.000 istekle sınırlar (auth.rateLimitPerMinute). İki dinleyici çalıştırır: genel Ingress'in ulaştığı 8080 numaralı kapsayıcı (container) bağlantı noktasındaki düz dinleyici ve küme içindeki her çağırıcının kullanması gereken 8443 üzerindeki karşılıklı TLS dinleyicisi. X-Forwarded-For bilgisine yalnızca, varsayılan olarak k3s pod ağı olan 10.42.0.0/16 değerine ayarlı Sınıfsız Alanlar Arası Yönlendirme (CIDR) aralıklarının bir listesi olan proxy.trustedCIDRs içindeki atlamalardan (hops) geldiğinde güvenir. Ingress denetleyiciniz başka bir yerde çalışıyorsa bunu değiştirin. Aksi takdirde her oturum açma işlemi denetleyiciden gelmiş gibi görünür.

Ağ geçidinin tek bir süreci paylaşan iki işi vardır. Küme içinde, bir kuruluşun model kimlik bilgilerinin tek sahibi olan YZ Sağlayıcı Yönlendiricisidir (1. Bölümdeki ve konsol sayfalarındaki YZ santrali) (bununla ilgili daha fazla bilgi aşağıdadır). Uçta (edge) ise api.<domain> öğesinin ulaştığı yerdir: belirteçleri https://<hosts.api>/mcp hedef kitlesini (audience) taşıyan ve kimlik doğrulama ana bilgisayarındaki OAuth 2.1 yetkilendirme sunucusundan gelen REST istemcileri ve MCP istemcileri (OAuth, devredilmiş yetkilendirme için açık standarttır).

Orkestratör ve iş akışları birlikte iş akışı motoru olan UNO'yu oluşturur. Tüm bilgi işlem bunların üzerinden çalışır. Orkestratör POST /api/v1/dispatch adresinde bir işi kabul eder, bir jobId, runId ve traceId ile 202 yanıtı verir ve işi kuyruğa alır. Satır içi (inline) yürütme yolu yoktur: bir istemci her zaman GET /api/v1/dispatch/{jobId} adresini yoklar (poll) veya bir geri çağırma (callback) alır. İş akışları işçisi (workflows worker) kuyruktan varsayılan olarak kopya (replica) başına aynı anda dört iş çeker (workflows.concurrency) ve tam olarak tek bir HTTP rotasına sahiptir: GET /health.

Probitas kanıt servisidir. Chart'ın verdiği bir sertifikadan kendisi TLS sunar ve tablolarını kayıt defteri (ledger) için ayrı bir rolle trust şemasında tutar. Yönetişim özellikleri probitas.flags ile değiştirilir. Birçoğu shadow modunda gelir: karar hesaplanır ve kaydedilir, siz bayrağı (flag) değiştirene kadar hiçbir şey engellenmez.

nexus-keys, Go ile yazılmış platform anahtar servisidir. Bir OpenBao anahtar deposunda kuruluş başına bir anahtar tutar ve bunları her gece döndürür (rotate). Gece çalışan işleri ayrıca tutma tarihi gelmiş anahtarları imha eder ve makbuzlarını kendine ait bir birime (volume) dışa aktarır. Bir kuruluşun anahtarını silmek, onun altında kilitli olan verileri kalıcı olarak okunamaz hale getirir. Ayrıca ilk önyüklemede (bootstrap) keys.installationName altında kurulum kimliğini üretir ve bu ad kalıcıdır. Bunu dikkatli seçin: chart boş bir adı (INSTALLATION_NAME_MISSING) ve kendi örnek değerlerindeki adı (INSTALLATION_NAME_EXAMPLE) reddeder.

Bu kurulum (Community)
Bu kurulum (Community)
Bir Community kurulumunun kendi sayfası, sürümünü ve motor sağlığını gösterir. Açıkça hiçbir lisansa gerek olmadığını belirtir. Sayfanın Enterprise bölümleri tanıtım (teaser) olarak çizilir.

Üç genel ana bilgisayar

Chart, birlikte kurulum kimliğini oluşturan tam olarak üç ana bilgisayar adı yayınlar. Her servis bunlar olmadan başlamayı reddeder.

Ingress Ana bilgisayar değeri Arka uç (Backend)
nexus-console hosts.console nexus-alpha, bağlantı noktası 3000
nexus-api hosts.api nexus-gateway, bağlantı noktası 9092
nexus-auth hosts.auth nexus-auth, bağlantı noktası 9101

Bu kitaptaki örnekler console.harrow.example, api.harrow.example ve auth.harrow.example kullanır. Ingress'ler, her biri tek kurallı ve yolu / olan düz networking.k8s.io/v1 nesneleridir. Uçtaki TLS tls.mode öğesini izler: existing (oluşturduğunuz, tls.existingSecret içinde adlandırılan bir Secret), cert-manager (çalıştırdığınız, tls.clusterIssuer içinde adlandırılan bir ClusterIssuer) veya none (TLS kümenin önünde sonlanır). Chart kendi başına bir yönlendirme eklemez, bu nedenle bir ACME (Otomatik Sertifika Yönetimi Ortamı) HTTP doğrulaması (challenge) çözücünüze değişmeden ulaşır. Bölüm 2.11, Çeşitler: harici depolar, TLS ve ingress, her modu ele alır.

Başka hiçbir şey dışarıya açılmaz. Veri depoları, OpenBao ve her dahili servis yalnızca ad alanı (namespace) içinde dinleme yapar.

Üç yatay bant. Üst bant, her biri kendi Service'ine (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101) işaret eden console, api ve auth etiketli üç Ingress kutusuna sahip "Edge" bandıdır. Orta bant "Platform services" bandıdır: nexus-alpha-bff için bir kutu; UNO olarak gruplandırılmış ve etiketlenmiş, nexus-workflows yanındaki nexus-orchestrator; ardından nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; ve isteğe bağlı nexus-plugins ile nexus-fileprocess için iki kesikli kutu. Alt bant, her veri deposu (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS) için bir kutu içeren "Data tier" ve yalnızca nexus-keys tarafından erişilen, openbao ile openbao-unsealer'ı barındıran "Key store" etiketli ayrı, çevrili bir kutudur.
Bir Nexus kurulumunun bileşenleri ve bunların altındaki depolar.

Uçtan uca bir istek

Harrow'da BT başkanı olan Aoife Brennan konsolu açıp asistana bu ayın yanaşma programı hakkında bir soru sorduğunda şunlar olur.

  1. Tarayıcısı https://console.harrow.example adresini yükler. nexus-console Ingress'i bunu 3000 numaralı bağlantı noktasındaki nexus-alpha öğesine gönderir.
  2. Geçiş anahtarıyla (passkey) oturum açar. Oturum açma sayfaları auth.harrow.example aracılığıyla nexus-auth ile konuşur ve nexus-auth ona kullanıcısını, kuruluşunu ve oturumunda varsa iş birimini taşıyan bir erişim belirteci üretir.
  3. Konsolun sunucusu BFF'yi çağırır; BFF onun belirtecini kontrol eder ve nexus-auth'a kuruluşunun ürüne sahip olup olmadığını ve rolünün kabul edilip edilmediğini sorar. Görebileceği menü gruplarıyla yanıt verir.
  4. Sorusu, doğrulanmış belirteçten alınan kuruluşu ve kullanıcısı ile birlikte BFF'den orkestratörün gönderim (dispatch) rotasına gider. Orkestratör 202 yanıtı verir ve işi Valkey'deki bir kuyruğa koyar.
  5. Bir iş akışları işçisi (workflows worker) işi alır. Çalıştırdığı beceri, beceri motoru tarafından çözümlenir ve Harrow'un belgeleri üzerinden erişim (retrieval), Neo4j, Qdrant ve kendi PostgreSQL şemasını okuyan GraphRAG'a gider.
  6. Model çağrısı /internal/ai/chat adresindeki YZ Sağlayıcı Yönlendiricisine gider. Yönlendirici, Harrow'un kendi anahtar havuzundan ve yönlendirme politikasından sağlayıcıyı ve modeli seçer, Harrow'un anahtarıyla çağrıyı yapar ve tamamlamayı (completion) döndürür.
  7. Sonuç, işin çalıştırma satırına (run row) ulaşır. BFF bunu okur ve konsol, alıntılarıyla birlikte yanıtı çizer.

Servisten servise atlamalar yansıtılmış (projected) servis belirteçlerini taşır; nexus-auth, nexus-keys ve Probitas'a gidenler kurulumun kendi sertifika yetkilisinden alınan TLS üzerinden çalışır ve 4'ten 6'ya kadar olan adımlardaki her veri erişimi, bizzat veritabanının içinde Harrow'un kuruluşuyla sınırlandırılır. Aşağıdaki bölümler her ikisini de açıklamaktadır.

Soldan sağa bir akış. Bir tarayıcı kutusu "1 page" öğesini Ingress console'a, ardından nexus-alpha'ya gönderir. Bir yan ok olan "2 sign-in", tarayıcıdan Ingress auth üzerinden nexus-auth'a gider. nexus-alpha, "3 menu" öğesini nexus-alpha-bff'ye gönderir, o da bunu nexus-auth ile kontrol eder. nexus-alpha-bff, "4 dispatch, 202" öğesini bir Valkey kuyruk simgesine yazan nexus-orchestrator'a gönderir. nexus-workflows, kuyruktan "5 job" öğesini çeker ve nexus-skills-engine ile nexus-graphrag'ı (üç veri deposu GraphRAG altında çizilmiştir) çağırır. nexus-workflows, "6 chat" öğesini "AI Provider Router: organisation key pool" etiketli nexus-gateway'e gönderir; bu da küme sınırının dışındaki "model provider"a tek bir ok gönderir. Noktalı bir dönüş oku olan "7 result on run row", nexus-alpha-bff'ye geri döner.
Tarayıcıdan model sağlayıcıya ve geriye bir asistan sorusu.

Veri katmanı

Nexus, paketin içinde her birinin kaynak teklifiyle birlikte, her deponun kendi imzalı kopyasını gönderir. Her biri işlevi kadar lisansı için de seçilmiştir.

Depo Sürüm Lisans Neden orada Bağlantı noktası Varsayılan birim (volume)
PostGIS ve pgvector ile PostgreSQL PostgreSQL 16, PostGIS 3, pgvector 0.8 PostgreSQL Lisansı; PostGIS GPL-2.0-or-later Her servis için kayıt sistemi; harita verileri için PostGIS; satırların yanında tutulan vektörler için pgvector 5432 50 GiB
Valkey 8.1 BSD-3-Clause UNO iş kuyrukları ve nexus-auth'un API anahtarı önbelleği gibi kısa ömürlü önbellekler 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 GraphRAG'ın oluşturduğu ve üzerinde gezindiği bilgi grafiği 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 GraphRAG ve beceri motoru için vektör araması 6333 (HTTP), 6334 (gRPC uzaktan yordam çağrıları) 10 GiB
SeaweedFS 4.48 Apache-2.0 Amazon Simple Storage Service (S3) ile uyumlu, dosyalar için nesne depolama 8333 50 GiB
OpenBao 2.6 MPL-2.0 nexus-keys için anahtar deposu ve mühür açıcısı 8200 5 GiB ve 1 GiB

Bazı seçimler daha tanıdık bir şeyin yerini aldı. Valkey, mevcut lisanslarını sürümün reddettiği Redis 7.4'ün yerine geçer. MinIO AGPL-3.0'dır, bu nedenle nesne deposu SeaweedFS'dir. GraphRAG, bir ağ protokolü olan Bolt üzerinden Neo4j Community Edition'a ulaşır ve servisler PostgreSQL protokolü üzerinden PostGIS'e ulaşır, böylece GPL her birinin kendisinde kalır. OpenBao, Vault'un lisans değişikliğinden önceki halinin Linux Foundation çatallamasıdır (fork).

Her depo kimlik doğrulaması açık olarak ve oluşturulmuş kimlik bilgileriyle çalışır: Valkey için bir parola, Qdrant için bir API anahtarı, SeaweedFS için erişim anahtarları.

dataTier altındaki beş deponun her biri kümede çalışır (mode: in-cluster, varsayılan) veya halihazırda işlettiğiniz bir depodur (mode: external, external.host ve external.existingSecret tarafından adlandırılan bir Secret ile). Harici bir PostgreSQL için sslmode öğesini verify-full veya verify-ca olarak ayarlayın ve sunucunun sertifika yetkilisi (CA) sertifikasını bu Secret'a koyun; bölüm 2.11, Çeşitler: harici depolar, TLS ve ingress, ayrıntıları içerir.

# harrow-values.yaml (Helm values): Harrow's own PostgreSQL, every other store in the cluster
dataTier:
  postgres:
    mode: external
    sslmode: verify-full
    external:
      host: pg.harrow.example
      existingSecret: harrow-postgres

OpenBao çifti istisnadır: her zaman kurulumun içinde çalışır, çünkü gözetim (custody) Job'ı onu orada başlatır.

Servisler arası kimlik

Nexus bir servis ağı (service mesh) olmadan çalışır. Karşılıklı TLS, chart'ın ilk olarak kurulması gereken cert-manager (v1.21.3 test edilmiştir) aracılığıyla oluşturduğu yerel bir sertifika yetkilisinden (CA) gelir.

Kendinden imzalı bir Issuer, on yıl geçerli, ECDSA (Eliptik Eğri Dijital İmza Algoritması) P-256 olan tek bir CA sertifikası (nexus-local-ca) oluşturur. İkinci bir Issuer bu CA ile imzalar. Kurulum içindeki bir TLS sunucusunu çağıran her iş yükü, <service-account>-client-tls adında, 90 gün geçerli ve süresi dolmadan 15 gün önce yenilenen kendi istemci sertifikasını alır. Tek adı, SPIFFE kimlik biçimindeki bir tekdüzen kaynak tanımlayıcısıdır (URI):

spiffe://cluster.local/ns/<namespace>/sa/<service-account>

Her iş yükü, CA'nın açık sertifikasını kendi sertifika Secret'ında ca.crt olarak bulur. Hiçbir pod CA'nın anahtarını bağlamaz (mount) ve trust-manager'a ihtiyacınız yoktur.

Üç servis, çağırıcıları sertifikaya göre doğrular. nexus-auth bunu ikinci dinleyicisi olan 8443 numaralı bağlantı noktasında yapar ve küme içindeki her çağırıcı bunu arar. nexus-keys bunu tek dinleyicisinde yapar. Probitas, cert-manager yenilediğinde yeniden okuduğu kendi sertifikasından (nexus-probitas-tls) TLS sunar. Hiçbiri bir X-Forwarded-Client-Cert üstbilgisine (header) güvenmez.

Her iş yükü ayrıca /var/run/secrets/nexus adresinde, çağırdığı her servis için bir tane olmak üzere, hedef kitlesi (audience) o servis olan bir saatlik Kubernetes belirteçleri alır. nexus-service-identities ConfigMap'i her <namespace>/<service-account> öğesini bir servis veya eklenti adıyla eşler ve burada eksik olan bir iş yükünün kimliği yoktur ve reddedilir. Orkestratör ve Probitas bu belirteçleri Kubernetes API'si ile kontrol eder. Çalışan servislerden yalnızca bu ikisi system:auth-delegator tutar veya bağlanmış (mounted) bir API belirtecine sahiptir; belirtece sahip diğer tek iş yükü kurulumda çalışan gözetim (custody) Job'ıdır.

Kimliğin kapatmadığını ağ politikası kapatır. Chart varsayılan reddetme (default deny) ile başlar, ardından kurulumun kendi pod'ları, DNS (Alan Adı Sistemi), ingress denetleyicisinin ad alanından (networkPolicy.ingressNamespace, varsayılan olarak kube-system) üç genel Service'e ve iki belirteç inceleyicisi için API sunucusuna olan trafiği kabul eder. OpenBao pod'ları platformun geri kalanından farklı bir etiket taşır, bu nedenle ad alanı içi açık kuralı onlara ulaşmaz: 8200 numaralı bağlantı noktasından yalnızca nexus-keys, onun Job'ları ve gözetim (custody) Job'ı geçebilir. Bir iş yükünün ad alanı dışında ulaşması gereken diğer her şey, örneğin posta röleniz (mail relay), varsayılan olarak boş olan networkPolicy.externalEgressCIDRs içine gider.

Taşımalar ve şema kayıt defteri

Taşımalar (migrations), post-install ve pre-upgrade üzerinde Helm kancaları (hooks) olarak çalışır. Kurulum sonrası (post-install) bir kanca, sürümün Deployment'ları oluşturulduktan sonra çalışır. Bu nedenle ilk kurulumda, şemaları henüz mevcut değilken servisler başlar ve rolü, parolası ve tabloları olmayan bir veritabanına karşı çökme döngüsüne (crash-loop) girerlerdi. Nexus bunu bir kayıt defteri (ledger) ile önler.

Kancalar ağırlık (weight) sırasına göre çalışır ve Helm, bir sonraki ağırlık başlamadan önce her Job'ı bekler:

Ağırlık Kanca (Hook) Yaptığı iş
-30 nexus-migrations-env ve önkoşullar Taşıyıcının (migrator) kimlik bilgileriyle yalnızca kancaya özel Secret'ı ve gözetim (custody) Job'ının okuduğu her şeyi oluşturur
-20 nexus-db-bootstrap nexus ve nexus_alpha veritabanlarını, taşıyıcı rolünü, her servisin çalışma zamanı (runtime) rolünü, uzantıları ve kayıt defterini oluşturur
-15 nexus-openbao-custody-init Anahtar deposunu ve mühür açıcıyı başlatır ve kurulum kimliğini üretir
-12 nexus-graphrag-migrations nexus-auth'un temelinin (baseline) başvurduğu nesnelere sahip olan GraphRAG şeması
-10 nexus-auth-migrations Kimlik şeması
-5 orkestratör, ağ geçidi ve Probitas taşımaları Onların şemaları; Probitas önce auth tablolarının mevcut olup olmadığını kontrol eder
0 nexus-alpha-bff-migrations Konsolun kendi veritabanı

Her taşıma Job'ı backoffLimit: 0 değerine sahiptir, bu nedenle başarısız bir taşıma kurulumu başarısız kılar.

Kayıt defteri, zincir ve imaj özeti (digest) başına bir satır içeren tek bir tablodur: nexus_release.schema_applied. Her kanca kendi satırını yalnızca taşıma çalıştırıcısı döndükten sonra yazar. PostgreSQL kullanan her Deployment, bu tabloyu başka hiçbir şeyi okumasına izin verilmeyen bir rol olarak (nexus_ledger_reader) okuyan wait-for-schema adlı bir başlatma kapsayıcısı (init container) taşır ve bağımlı olduğu her zincir bu sürümün imajı için bir satır gösterene kadar bekler. Ardından servis başlar. İş akışları işçisi, aynı veritabanını paylaştığı için orkestratörün zincirini bekler ve beceri motoru yalnızca önyüklemeyi (bootstrap) bekler.

Her 3 saniyede bir yoklar (schemaWait.intervalSeconds) ve 1.800 saniye sonra (schemaWait.timeoutSeconds) hala eksik olan zincirleri adlandıran bir satırla vazgeçer. Servisin kendi kapsayıcısı asla yanlış bir şemaya karşı başlamaz.

kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schema

İşte bu yüzden asla helm install --wait çalıştırmamalısınız. --wait ile Helm, kurulum sonrası kancaları çalıştırmadan önce Deployment'ları bekler ve Deployment'lar da kancaları bekler. İkisi de hareket etmez. Onsuz kurun ve sonrasında bekleyin; bölüm 2.6, Kubernetes üzerine Community Kurulumu, tam komutu verir.

Üç eksende izolasyon

Nexus'taki her okuma, yazma, araç çağrısı ve beceri gönderimi üç eksende kapsamlandırılır (scoped).

Eksen Alan Ayırdığı şey
Kiracı (Tenant) organization_id Bir kuruluşu diğerinden; katı bir sınır
Sahip (Owner) owner_user_id Tek bir kuruluş içinde bile bir kişinin öğelerini diğer herkesinkinden
Birim (Unit) business_unit_id Bir kuruluşun alt bölümü, isteğe bağlı

Sahip ekseni insanları şaşırtır. Bir posta kutusu veya kişisel bir not defteri, aynı birimde aynı role sahip iş arkadaşlarından bile sahibine özeldir. Bir yönetici politika belirler ve içeriği okumaz.

Eksenler kimliği doğrulanmış istekten gelir, başka hiçbir yerden gelmez. Hiçbir ortam değişkeni, üstbilgi, sorgu parametresi veya yol segmenti bunları ayarlayamaz. Bir kuruluşu adlandıran bir istek gövdesi TENANT_NOT_A_PARAMETER ile reddedilir. Bir satırın hangi kiracıya, sahibe ve birime ait olduğunu belirtemeyen bir yüzey 403 SCOPE_PREDICATE_MISSING ile reddeder ve gövde hangi eksenlerin çözümlendiğini ve hangilerinin çözümlenmediğini listeler. Asla daha geniş bir okumaya geri dönmez.

Bu durum aynı anda iki yerde geçerlidir.

Veritabanında. Her servis kendi çalışma zamanı rolleri olarak bağlanır: kimlik servisi için nexus_auth, auth_app ve auth_platform, Probitas için nexus_probitas ve nexus_probitas_ledger ve diğerleri için nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app ve geri kalanlar. Hiçbiri ayrıcalıklı kullanıcı (superuser) değildir veya BYPASSRLS yetkisine sahip değildir. Hiçbiri kullandığı tabloların sahibi de değildir, bu nedenle her satır düzeyinde güvenlik (RLS) politikası onun için geçerlidir. Roller, bağlantı ve şema kullanımı sağlayan ve hiçbir tablo hakkı vermeyen nexus_runtime adlı bir grubu paylaşır; her servise kendi tabloları kendi taşımaları (migrations) tarafından verilir. RLS politikalarının okuduğu kiracı ayarları yalnızca her servisin, sahibi olarak çalışan bind_scope işlevi aracılığıyla ayarlanabilir. Önyükleme (bootstrap) diğer herkesten set_config yetkisini geri alır ve orkestratör ile Probitas, çalışma zamanı rolleri bunu doğrudan çağırabiliyorsa başlamayı reddeder (Probitas bunu DB_ROLE_SETS_SCOPE_DIRECTLY olarak adlandırır). Tüm kurulumdaki tek ayrıcalıklı kullanıcı (superuser) bağlantıları önyükleme Job'ına ve BFF'nin sağlama (provisioning) adımına aittir.

Paylaşılan kapsamlı sorgu ilkelinde (scoped-query primitive). Platformdaki her depo (repository) ve SDK (yazılım geliştirme kiti) üzerine inşa edilen her eklenti, çözümlenmiş bir kapsamdan SQL koşulunu (predicate) oluşturan tek bir sınırı (fence) devralır. Kapsam işlevi doğrulanmış kimliği alır ve kuruluş parametresi yoktur, bu nedenle bir çağırıcı bunu içeri aktaramaz ve hiçbir rota bunun dışında kalamaz.

Kiracı sınırının tam olarak tek bir geçişi vardır ve o da dardır: kayıtlı bir yetki (grant). Satırları tutan kuruluştaki iki kişi, hangi kuruluşun hangi tabloları ne zamana kadar okuyabileceğini kaydeder. Her okuma salt okunur bir işlemde (transaction) çalışır ve her iki kiracıda da günlüğe kaydedilir. Sahipler ve yöneticiler asla karşı tarafı okumaz ve okuyucu bir yetkiyi genişletemez.

YZ yolu

Çağırıcılar isteklerini ifade eder. YZ Sağlayıcı Yönlendiricisi kimlik bilgisine sahiptir ve son seçimi yapar.

Nexus'taki her model çağrısı yönlendiricinin /internal/ai/* rotalarından geçer ve yönlendirici yalnızca adlandırılmış çağırıcıları kabul eder. Chart, ağ geçidinde üç liste ayarlar:

Rotalar Kimler çağırabilir
Sohbet ve sohbet akışı (streaming) nexus-orchestrator, nexus-workflows, nexus-skills-engine
Yerleştirmeler (embeddings) ve yeniden sıralama (rerank) nexus-graphrag, nexus-skills-engine, nexus-workflows
Araç yürütme dahil diğer her şey nexus-orchestrator, nexus-workflows

Çağırıcı kimliği olmayan bir çağrı 403 MISSING_CALLER_IDENTITY ile, listede olmayan bir çağırıcı ise 403 UNAUTHORIZED_CALLER ile reddedilir. Eklentiler hiçbir listede yoktur ve bu kasıtlıdır: bir eklentinin model çağrıları UNO gönderimi (dispatch) aracılığıyla onun adına gerçekleşir.

Bir çağırıcının gönderebileceği şey bir istektir: tercih edilen bir sağlayıcı ve model, artı minimum bağlam uzunluğu veya araç kullanımı gibi bir yetenek profili. Yönlendirici bir isteği yalnızca kuruluşun o sağlayıcıyı etkinleştirmiş ve kimlik bilgilerini tanımlamış olması durumunda yerine getirir; aksi takdirde, önce aynı sağlayıcı içinde, ardından kuruluşun diğer sağlayıcıları arasında ikame yapar. Bir yetenek profili yalnızca filtreleme yapar ve içindeki veri yerleşimi (data-residency) gereksinimi katıdır. Hiçbir şey uymadığında, yedek (fallback) model yoktur: çağırıcı, konsolun bir yöneticiye gösterdiği bir düzeltme dizesiyle birlikte 422 MODEL_CAPABILITY_UNAVAILABLE veya 422 NO_PROVIDER_FOR_ROLE alır.

Anahtarlar kuruluşa aittir. Her kuruluşun yöneticileri konsoldan kendi sağlayıcı anahtarlarını havuzuna koyar ve yönlendirici bunları çağrı zamanında çözümler. Hiçbir model anahtarı bir chart değeri değildir ve hiçbiri Nexus ile birlikte gelmez. Anahtarı olmayan bir kuruluş hiçbir YZ yanıtı almaz ve konsol bunu açıkça söyler; hiçbir şey bu boşluğu başka bir yerden doldurmaz.

İki chart değeri yönlendiriciyi şekillendirir. ai.localProvider.baseUrl, çalıştırdığınız ve diğer herhangi bir sağlayıcı gibi yönlendirilen OpenAI uyumlu bir model sunucusunu adlandırır. ai.installationHosts, yönlendiricinin kurulumun içinde saydığı özel adlardaki model sunucularınızı listeler. GraphRAG de, içeriğin sahibi olan kuruluş adına yönlendirici üzerinden gömme (embedding) işlemi yapar. Varsayılan gömme modeli, kümede grafik kartı olmadan çalışır; barındırılan gömmeler ise her kuruluşun kendi tercihidir.

Telemetri yok

Siz göndermediğiniz sürece hiçbir şey kurulumdan dışarı çıkmaz. Chart'ın telemetry.enabled değeri yalnızca false olabilir; şema başka her şeyi reddeder. Veri katmanının kendi raporlaması da kapalıdır: Neo4j'nin kullanım raporu ve Qdrant'ın telemetrisi chart içinde devre dışı bırakılmıştır.

Varsayılan olarak networkPolicy.enabled açıkken, hedefi networkPolicy.externalEgressCIDRs içinde listelemediğiniz sürece hiçbir pod internete erişemez. Barındırılan bir model sağlayıcısı bu tür bir hedeftir; posta aktarım sunucunuz (mail relay) da öyle.

Aynı kural, fark edeceğiniz bir varsayılan ayarı değiştirdi. Kayıtlar için nexus-auth'un CAPTCHA'sı bir internet hizmetine ihtiyaç duyar; bu nedenle kurulumda kapalıdır ve yabancı birinin kaydı yönetici onayını bekler (403 SIGNUP_REQUIRES_APPROVAL). Barındırma ağlarından gelen kayıtları engelleyen filtre de kapalıdır, çünkü Nexus'un birlikte sunmadığı lisanslı veritabanlarına ihtiyaç duyar. Bu filtrelemeyi kaybedersiniz.

Kurulumun durumu
Kurulumun durumu
Enterprise sürümünde sağlık sayfası, Nexus altındaki kümeyi gösterir: her bir parçanın ne kadar meşgul olduğu ve ne kadar kapasite kaldığı, her uyarının yanında ne yapılması gerektiğiyle birlikte yer alır.