Версия 1.0.0-alpha.1последно
Глава 2.1
Архитектура
Какво притежава всяка услуга в чарта на Nexus и кои хранилища стоят под нея, след това правилата, които ги държат заедно – от идентичността между услугите до пътя, който изминава всяко извикване на модел.
Тази страница е преведена от ИИ от английския оригинал. Ако нещо е неясно, английската страница е референтна. Прочетете тази страница на английски

Когато Tomás Reilly завърши първата инсталация в Harrow Port Authority, kubectl -n nexus get pods показа десет обекта Deployment и седем обекта StatefulSet, плюс три обекта CronJob. Задачите (Jobs) за миграция, които изградиха базата данни, вече бяха изчезнали, тъй като всяка от тях се самоизтрива след успешно приключване. Този списък представлява цялата платформа. Научете го, защото повечето въпроси при ежедневната експлоатация започват с „кое от тези притежава онова?“.
Тази глава дава отговор за всяка част, проследява една заявка през тях, а след това разглежда правилата, на които всички те се подчиняват. Останалата част от Част 2 надгражда върху тази картина.
Услугите и какво притежава всяка от тях
Пакетът представлява един Helm chart, nexus, версия 1.0.0-alpha.1, за Kubernetes 1.33 или по-нова версия. Всяко работно натоварване се изпълнява под собствен ServiceAccount, като потребител без root права, с премахнати всички Linux привилегии (capabilities). Извикванията към услугите, които защитават идентичността и ключовете, преминават през взаимен TLS (Transport Layer Security), а публичният API (application programming interface) споделя един процес с маршрутизатора за ИИ (изкуствен интелект).
| Компонент | Deployment и Service | Порт на Service | Какво притежава |
|---|---|---|---|
| Конзола | nexus-alpha |
3000 | Страниците, които хората виждат; обслужва HTML (Hypertext Markup Language) на хоста на конзолата |
| BFF (бекенд за фронтенд) | nexus-alpha-bff |
8080 | Собствените данни на конзолата, менюто, което всеки човек получава, регистъра на изданията |
| Удостоверяване | nexus-auth |
9101 (взаимен TLS на 8443) | Хора, организации, сесии, токени, API ключове, пула от ключове за модели на организацията |
| Шлюз (Gateway) | nexus-gateway |
9092, WebSocket 8093 | Маршрутизатора на доставчици на ИИ (AI Provider Router) и крайната точка на публичния API за REST (representational state transfer) и MCP (Model Context Protocol) |
| Оркестратор | nexus-orchestrator |
8080 | Диспечеризиране в UNO: приемане на всяка задача и поставянето ѝ в опашка |
| Работни потоци (Workflows) | nexus-workflows |
8081 | Изпълнение в UNO: работният процес (worker), който изпълнява задачите от опашката |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Памет: графът на знанията и извличането на информация от него |
| Probitas | nexus-probitas |
9151 (HTTPS) | Доказателства: записи за управление (governance) и запечатаният регистър (ledger) |
| Машина за умения (Skills engine) | nexus-skills-engine |
8095 | Библиотеката с умения; намиране и изпълнение на умения |
| Ключове (Keys) | nexus-keys |
8080 (HTTPS, взаимен TLS) | Ключове за всяка организация в OpenBao, попечителство (custody), идентичността на инсталацията |
| Плъгини | nexus-plugins |
9111 | Регистърът на плъгините и каталожните записи; изключени по подразбиране |
| Обработка на файлове | nexus-fileprocess |
9109 | Четене на качени документи и изображения; изключена по подразбиране |
Първите десет са задължителни. Последните две са незадължителни и се включват с components.plugins.enabled и components.fileprocess.enabled, когато се използват от инсталация Enterprise или домейн пакет. Още една незадължителна услуга, nexus-alive на порт 8080, има собствен превключвател, components.alive.enabled, и също е изключена по подразбиране. Репликите и ресурсите за всяка от тях се намират под components.<name>.
Конзолата представлява страници, рендерирани на сървъра, без база данни. Тя комуникира с BFF и с nexus-auth вътре в клъстера, никога навън през публичния хост за удостоверяване и обратно вътре. Отказва да стартира без своето издание, което пакетът (chart) подава като NEXUS_EDITION от единствената стойност edition. Всеки член на организацията работи в нея според ролята си. Административните страници са за собственици и администратори, а член, който отвори такава страница, получава страницата „Не сте администратор“ ("Not an administrator").
BFF е сървърната половина на конзолата и е изграден като плъгин на платформата, регистриран като продукта Nexus Alpha. Той държи собствените таблици на конзолата в отделна база данни, nexus_alpha, и решава кои групи от менюто вижда даден човек. Когато конзолата се нуждае от извършване на някаква работа, BFF се обръща към услугата, която отговаря за нея.
nexus-auth е написана на Go и е единствената услуга, която издава токени. Токените за достъп са със срок на валидност 15 минути, а опресняващите токени – 12 часа по подразбиране (auth.accessTokenTTL, auth.refreshTokenTTL). Тя ограничава всеки влязъл потребител до 5,000 заявки в минута, преди да отговори с код 429 (auth.rateLimitPerMinute). Поддържа два слушателя (listeners): обикновен на порт 8080 на контейнера, до който достига публичният Ingress, и такъв с взаимен TLS на порт 8443, който всеки извикващ компонент вътре в клъстера трябва да използва. Тя се доверява на X-Forwarded-For само от междинните възли (hops) в proxy.trustedCIDRs – списък с диапазони за безкласово междудомейново маршрутизиране (Classless Inter-Domain Routing – CIDR), който по подразбиране е 10.42.0.0/16, мрежата за подове на k3s. Ако вашият ingress контролер работи другаде, променете го. В противен случай всяко влизане ще изглежда така, сякаш идва от контролера.
Шлюзът (gateway) има две задачи, които споделят един процес. Вътре в клъстера той е маршрутизаторът на доставчици на ИИ – AI Provider Router (комутаторът за ИИ в Част 1 и на страниците на конзолата), единственият държател на идентификационните данни за моделите на организацията (повече за това по-долу). В периферията (edge) той е това, до което достига api.<domain>: REST клиенти и MCP клиенти, чиито токени носят аудиторията https://<hosts.api>/mcp и идват от сървъра за упълномощаване OAuth 2.1 на хоста за удостоверяване (OAuth е отвореният стандарт за делегирано упълномощаване).
Оркестраторът и работните потоци (workflows) заедно съставляват UNO – машината за работни потоци. Всички изчисления преминават през тях. Оркестраторът приема задача на POST /api/v1/dispatch, отговаря с код 202 с jobId, runId и traceId, и я поставя в опашка. Няма път за директно (inline) изпълнение: клиентът винаги проверява периодично (polls) GET /api/v1/dispatch/{jobId} или приема обратно извикване (callback). Работният процес за работни потоци (workflows worker) изтегля задачи от опашката – по четири наведнъж на реплика по подразбиране (workflows.concurrency) – и има точно един HTTP маршрут, GET /health.
Probitas е услугата за доказателства. Тя сама обслужва TLS чрез сертификат, издаден от пакета (chart), и пази таблиците си в схемата trust с отделна роля за регистъра (ledger). Нейните функции за управление (governance) се превключват чрез probitas.flags. Няколко от тях се доставят в режим shadow: решението се изчислява и записва, но нищо не се блокира, докато не промените флага.
nexus-keys е услугата за ключове на платформата, написана на Go. Тя пази по един ключ за всяка организация в хранилище за ключове OpenBao и ги ротира всяка нощ. Нейните нощни задачи също така унищожават ключове, чиято дата на задържане е настъпила, и експортират разписките ѝ в неин собствен том (volume). Изтриването на ключа на дадена организация прави данните, заключени с него, нечетими завинаги. Тя също така създава идентичността на инсталацията при първоначалното стартиране (bootstrap) под keys.installationName, като това име е постоянно. Изберете го внимателно: пакетът отказва празно име (INSTALLATION_NAME_MISSING) и отказва името от собствените си примерни стойности (INSTALLATION_NAME_EXAMPLE).
Три публични хоста
Пакетът (chart) публикува точно три имена на хостове, които заедно представляват идентичността на инсталацията. Всяка услуга отказва да стартира без тях.
| Ingress | Стойност на хоста | Бекенд |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, порт 3000 |
nexus-api |
hosts.api |
nexus-gateway, порт 9092 |
nexus-auth |
hosts.auth |
nexus-auth, порт 9101 |
Примерите в тази книга използват console.harrow.example, api.harrow.example и auth.harrow.example. Обектите Ingress са обикновени обекти networking.k8s.io/v1 с по едно правило всеки, път /. TLS в периферията следва tls.mode: existing (обект Secret, който сте създали, посочен в tls.existingSecret), cert-manager (обект ClusterIssuer, който поддържате, посочен в tls.clusterIssuer) или none (TLS приключва пред клъстера). Пакетът не добавя собствено пренасочване, така че HTTP предизвикателството на ACME (Automated Certificate Management Environment) достига до вашия решаващ модул (solver) непроменено. Глава 2.11, Вариации: външни хранилища, TLS и ingress, разглежда всеки от режимите.
Нищо друго не е изложено навън. Хранилищата за данни, OpenBao и всяка вътрешна услуга слушат само вътре в пространството от имена (namespace).
Една заявка от край до край
Ето какво се случва, когато Aoife Brennan, ръководител на ИТ отдела в Harrow, отвори конзолата и зададе на асистента въпрос относно графика на корабните места за този месец.
- Нейният браузър зарежда
https://console.harrow.example. Обектът Ingressnexus-consoleго изпраща къмnexus-alphaна порт 3000. - Тя влиза със своя ключ за достъп (passkey). Страниците за влизане комуникират с
nexus-authчрезauth.harrow.example, а nexus-auth ѝ издава токен за достъп, носещ нейния потребител, нейната организация и – когато сесията ѝ има такава – нейното бизнес звено. - Сървърът на конзолата извиква BFF, който проверява нейния токен и пита nexus-auth дали организацията ѝ притежава продукта и дали ролята ѝ има достъп. Той отговаря с групите от менюто, които тя има право да вижда.
- Нейният въпрос отива от BFF към маршрута за диспечеризиране на оркестратора, като организацията и потребителят ѝ се вземат от проверения токен. Оркестраторът отговаря с код 202 и поставя задачата в опашка във Valkey.
- Работен процес за работни потоци (workflows worker) поема задачата. Умението, което той изпълнява, се разрешава от машината за умения (skills engine), а извличането на информация от документите на Harrow отива към GraphRAG, който чете от Neo4j, Qdrant и своята PostgreSQL схема.
- Извикването към модела отива към маршрутизатора на доставчици на ИИ (AI Provider Router) на
/internal/ai/chat. Маршрутизаторът избира доставчика и модела от собствения пул с ключове и политика за маршрутизиране на Harrow, прави извикването с ключа на Harrow и връща генерирания отговор (completion). - Резултатът се записва в реда за изпълнение на задачата. BFF го прочита и конзолата изобразява отговора заедно с цитиранията към него.
Преходите между услугите пренасят проектирани токени за услуги, тези към nexus-auth, nexus-keys и Probitas преминават през TLS от собствения сертифициращ орган на инсталацията, а всеки достъп до данни в стъпки от 4 до 6 е ограничен до организацията на Harrow в самата база данни. Разделите по-долу обясняват и двете неща.
Слоят за данни
Nexus доставя свое собствено подписано копие на всяко хранилище, заедно с предложението за изходния код за всяко от тях в пакета. Всяко хранилище е избрано колкото заради функциите си, толкова и заради лиценза си.
| Хранилище | Версия | Лиценз | Защо е там | Порт | Том по подразбиране |
|---|---|---|---|---|---|
| PostgreSQL с PostGIS и pgvector | PostgreSQL 16, PostGIS 3, pgvector 0.8 | Лиценз PostgreSQL; PostGIS GPL-2.0-or-later | Основната система за записи (system of record) за всяка услуга; PostGIS за картографски данни; pgvector за вектори, съхранявани до редовете | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | Опашките със задачи на UNO и краткотрайните кешове, като например кеша за API ключове на nexus-auth | 6379 | 5 GiB |
| Neo4j Community Edition | 5.26 | GPL-3.0 | Графът на знанията, който GraphRAG изгражда и обхожда | 7687 (Bolt) | 20 GiB |
| Qdrant | 1.15 | Apache-2.0 | Векторно търсене за GraphRAG и машината за умения (skills engine) | 6333 (HTTP), 6334 (gRPC отдалечени процедурни извиквания) | 10 GiB |
| SeaweedFS | 4.48 | Apache-2.0 | Обектно хранилище за файлове, съвместимо с Amazon Simple Storage Service (S3) | 8333 | 50 GiB |
| OpenBao | 2.6 | MPL-2.0 | Хранилището за ключове и неговият инструмент за разпечатване (unsealer), за nexus-keys | 8200 | 5 GiB и 1 GiB |
Някои решения замениха нещо по-познато. Valkey замества Redis 7.4, чиито текущи лицензи изданието не приема. MinIO е с лиценз AGPL-3.0, затова обектното хранилище е SeaweedFS. GraphRAG се свързва с Neo4j Community Edition чрез Bolt (мрежов протокол), а услугите се свързват с PostGIS чрез протокола на PostgreSQL, така че лицензът GPL си остава ограничен до всяко от тях. OpenBao е разклонението (fork) на Vault от Linux Foundation преди промяната на лиценза на Vault.
Всяко хранилище работи с включено удостоверяване и генерирани идентификационни данни: парола за Valkey, API ключ за Qdrant, ключове за достъп за SeaweedFS.
Всяко от петте хранилища под dataTier работи в клъстера (mode: in-cluster, по подразбиране) или е такова, което вие вече поддържате (mode: external, с external.host и обект Secret, посочен чрез external.existingSecret). За външен PostgreSQL задайте sslmode на verify-full или verify-ca и поставете сертификата на сертифициращия орган (CA) на сървъра в този Secret; глава 2.11, Вариации: външни хранилища, TLS и ingress, съдържа подробностите.
# 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 е изключението: тя винаги работи вътре в инсталацията, тъй като задачата (Job) за попечителство (custody) я инициализира там.
Идентичност между услугите
Nexus работи без мрежа от услуги (service mesh). Взаимният TLS идва от локален сертифициращ орган (CA), който пакетът (chart) създава чрез cert-manager, който трябва да бъде инсталиран предварително (тествана е версия v1.21.3).
Самоподписан издател (Issuer) създава един CA сертификат, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, валиден десет години. Втори издател подписва с този CA. Всяко работно натоварване, което извиква TLS сървър вътре в инсталацията, получава свой собствен клиентски сертификат, наречен <service-account>-client-tls, валиден 90 дни и подновяван 15 дни преди изтичането му. Единственото му име е унифициран идентификатор на ресурси (URI) във формата за идентичност SPIFFE:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Всяко работно натоварване намира публичния сертификат на CA като ca.crt в своя собствен обект Secret за сертификати. Никой под не монтира ключа на CA и не ви е необходим trust-manager.
Три услуги проверяват извикващите компоненти чрез сертификат. nexus-auth прави това на втория си слушател, порт 8443, и всеки извикващ компонент вътре в клъстера набира него. nexus-keys го прави на единствения си слушател. Probitas обслужва TLS от своя собствен сертификат, nexus-probitas-tls, който препрочита, когато cert-manager го поднови. Никоя от тях не се доверява на хедър X-Forwarded-Client-Cert.
Всяко работно натоварване получава и едночасови Kubernetes токени в /var/run/secrets/nexus, по един за всяка услуга, която извиква, с тази услуга като аудитория. Обектът ConfigMap nexus-service-identities съпоставя всеки <namespace>/<service-account> с име на услуга или плъгин, а работно натоварване, което липсва в него, няма идентичност и бива отхвърлено. Оркестраторът и Probitas проверяват тези токени чрез Kubernetes API. От работещите услуги само тези две притежават system:auth-delegator или имат монтиран API токен; единственото друго работно натоварване с токен е задачата (Job) за попечителство, която се изпълнява при инсталиране.
Мрежовата политика затваря това, което идентичността не затваря. Пакетът започва със забрана по подразбиране (default deny), след което допуска трафик между собствените подове на инсталацията, DNS (Domain Name System), пространството от имена на ingress контролера (networkPolicy.ingressNamespace, kube-system по подразбиране) към трите публични обекта Service и API сървъра за двата проверяващи токените компонента. Подовете на OpenBao носят различен етикет (label) от останалата част на платформата, така че отвореното правило вътре в пространството от имена не ги достига: само nexus-keys, нейните задачи (Jobs) и задачата за попечителство преминават на порт 8200. Всичко друго, до което дадено работно натоварване трябва да достигне извън пространството от имена, като например вашия пощенски релеен сървър (mail relay), се поставя в networkPolicy.externalEgressCIDRs, който по подразбиране е празен.
Миграции и регистър на схемите
Миграциите се изпълняват като куки (hooks) на Helm, на post-install и pre-upgrade. Куката след инсталиране (post-install hook) се изпълнява след създаването на обектите Deployment на изданието. Така при първа инсталация услугите стартират, докато техните схеми все още не съществуват, и биха влезли в цикъл на сривове (crash-loop) срещу база данни без роля, без парола и без таблици. Nexus избягва това чрез регистър (ledger).
Куките се изпълняват по ред на тежестта (weight), като Helm изчаква всяка задача (Job), преди да започне следващата тежест:
| Тежест | Кука (Hook) | Какво прави |
|---|---|---|
| -30 | nexus-migrations-env и предварителни изисквания |
Създава обекта Secret (само за куката) с идентификационните данни на мигратора и всичко, което задачата за попечителство чете |
| -20 | nexus-db-bootstrap |
Създава базите данни nexus и nexus_alpha, ролята на мигратора, ролята за време на изпълнение (runtime role) на всяка услуга, разширенията и регистъра |
| -15 | nexus-openbao-custody-init |
Инициализира хранилището за ключове и инструмента за разпечатване и създава идентичността на инсталацията |
| -12 | nexus-graphrag-migrations |
Схемата на GraphRAG, която притежава обекти, към които препраща базовата линия на nexus-auth |
| -10 | nexus-auth-migrations |
Схемата за идентичност |
| -5 | Миграции на оркестратора, шлюза и Probitas | Техните схеми; Probitas първо проверява дали таблиците за удостоверяване съществуват |
| 0 | nexus-alpha-bff-migrations |
Собствената база данни на конзолата |
Всяка задача (Job) за миграция има backoffLimit: 0, така че неуспешна миграция проваля инсталацията.
Регистърът представлява една таблица, nexus_release.schema_applied, с по един ред на верига и хеш (digest) на изображение. Всяка кука записва своя ред едва след като нейният изпълнител на миграции е приключил. Всеки обект Deployment, който използва PostgreSQL, носи инициализиращ контейнер (init container), wait-for-schema, който чете тази таблица като роля, на която не е разрешено да чете нищо друго (nexus_ledger_reader), и изчаква, докато всяка верига, от която зависи, покаже ред за изображението на това издание. След това услугата стартира. Работният процес за работни потоци (workflows worker) изчаква веригата на оркестратора, тъй като споделя тази база данни, а машината за умения (skills engine) изчаква само първоначалното стартиране (bootstrap).
Той проверява на всеки 3 секунди (schemaWait.intervalSeconds) и се отказва след 1800 (schemaWait.timeoutSeconds) с ред, посочващ веригите, които все още липсват. Собственият контейнер на услугата никога не стартира срещу грешна схема.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaЕто защо никога не трябва да изпълнявате helm install --wait. С --wait Helm изчаква обектите Deployment, преди да изпълни куките след инсталиране (post-install hooks), а обектите Deployment изчакват куките. Нито едното не помръдва. Инсталирайте без него и изчакайте след това; глава 2.6, Инсталиране на Community върху Kubernetes, дава точната команда.
Изолация по три оси
Всяко четене, запис, извикване на инструмент и диспечеризиране на умение в Nexus е ограничено по обхват (scoped) по три оси.
| Ос | Поле | Какво разделя |
|---|---|---|
| Наемател (Tenant) | organization_id |
Една организация от друга – твърда граница |
| Собственик (Owner) | owner_user_id |
Нещата на един човек от тези на всички останали, дори вътре в една организация |
| Звено (Unit) | business_unit_id |
Подразделение на организацията, незадължително |
Оста на собственика изненадва хората. Пощенска кутия или личен бележник са поверителни за своя собственик дори спрямо колеги в същото звено със същата роля. Администраторът задава политики и не чете съдържание.
Осите идват от удостоверената заявка и от никъде другаде. Никаква променлива на средата, хедър, параметър на заявката или сегмент от пътя не може да ги зададе. Тяло на заявка, което посочва организация, се отхвърля с TENANT_NOT_A_PARAMETER. Повърхност, която не може да посочи към кой наемател, собственик и звено принадлежи даден ред, отказва с код 403 SCOPE_PREDICATE_MISSING, а тялото изброява кои оси са били разрешени и кои не. Системата никога не преминава резервно към по-широко четене.
Това важи едновременно на две места.
В базата данни. Всяка услуга се свързва чрез собствените си роли за време на изпълнение (runtime roles): nexus_auth, auth_app и auth_platform за услугата за идентичност, nexus_probitas и nexus_probitas_ledger за Probitas, и nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app и останалите за другите услуги. Никоя от тях не е суперпотребител (superuser) и няма BYPASSRLS. Никоя не притежава и таблиците, които използва, така че всяка политика за сигурност на ниво ред (row-level security – RLS) се прилага за нея. Ролите споделят група, nexus_runtime, която предоставя право за свързване и използване на схемата, но никакви права върху таблиците; на всяка услуга се предоставят права върху собствените ѝ таблици чрез собствените ѝ миграции. Настройките за наемател, които RLS политиките четат, могат да се задават само чрез функцията bind_scope на всяка услуга, която се изпълнява като неин собственик. Първоначалното стартиране (bootstrap) отнема правата за set_config от всички останали, а оркестраторът и Probitas отказват да стартират, ако тяхната роля за време на изпълнение може да я извика директно (Probitas нарича това DB_ROLE_SETS_SCOPE_DIRECTLY). Единствените връзки като суперпотребител в цялата инсталация принадлежат на задачата за първоначално стартиране и на стъпката за обезпечаване (provisioning) на BFF.
В споделения примитив за заявки с ограничен обхват. Всяко хранилище за данни (repository) в платформата и всеки плъгин, изграден върху SDK (software development kit), наследява една преграда, която изгражда SQL предиката от разрешения обхват. Нейната функция за обхват приема проверената идентичност и няма параметър за организация, така че извикващият не може да подаде такъв и никой маршрут не може да заобиколи това.
Има точно едно пресичане на границата на наемателя и то е тясно: записано разрешение (grant). Двама души в организацията, която държи редовете, записват коя организация кои таблици може да чете и до кога. Всяко четене се изпълнява в транзакция само за четене и се регистрира и при двамата наематели. Собствениците и администраторите никога не четат между организациите, а четящият не може да разшири дадено разрешение.
Пътят на ИИ
Извикващите компоненти изразяват желания. Маршрутизаторът на доставчици на ИИ (AI Provider Router) притежава идентификационните данни и прави окончателния избор.
Всяко извикване към модел в Nexus преминава през маршрутите /internal/ai/* на маршрутизатора, а маршрутизаторът допуска само изрично посочени извикващи компоненти. Пакетът (chart) задава три списъка на шлюза:
| Маршрути | Кой може да извиква |
|---|---|
| Чат и поточно предаване на чат | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Вграждания (Embeddings) и пренареждане (rerank) | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| Всичко останало, включително изпълнение на инструменти | nexus-orchestrator, nexus-workflows |
Извикване без идентичност на извикващия се отхвърля с код 403 MISSING_CALLER_IDENTITY, а извикващ, който не е в списъка – с код 403 UNAUTHORIZED_CALLER. Плъгините не са в никой списък и това е умишлено: извикванията към модели от плъгин се извършват от негово име чрез диспечеризиране в UNO.
Това, което извикващият може да изпрати, е желание: предпочитан доставчик и модел, плюс профил на възможностите, като например минимална дължина на контекста или използване на инструменти. Маршрутизаторът изпълнява желанието само когато организацията има активиран този доставчик и въведени идентификационни данни за него; в противен случай го замества – първо в рамките на същия доставчик, а след това измежду другите доставчици на организацията. Профилът на възможностите само филтрира, а изискването за местоположение на данните (data-residency) в него е задължително. Когато нищо не отговаря на условията, няма резервен модел: извикващият получава код 422 MODEL_CAPABILITY_UNAVAILABLE или 422 NO_PROVIDER_FOR_ROLE с низ за отстраняване на проблема, който конзолата показва на администратора.
Ключовете принадлежат на организацията. Администраторите на всяка организация поставят собствените си ключове за доставчици в нейния пул през конзолата, а маршрутизаторът ги намира по време на извикването. Никой ключ за модел не е стойност в пакета (chart) и никой не се доставя с Nexus. Организация без ключ не получава отговори от ИИ и конзолата го казва ясно; нищо не запълва празнината от другаде.
Две стойности в чарта оформят маршрутизатора. ai.localProvider.baseUrl указва съвместим с OpenAI сървър за модели, който управлявате, маршрутизиран като всеки друг доставчик. ai.installationHosts изброява вашите сървъри за модели с частни имена, които маршрутизаторът отчита като вътрешни за инсталацията. GraphRAG също генерира вграждания (embeddings) през маршрутизатора от името на организацията, чието е съдържанието. Моделът за вграждания по подразбиране работи в клъстера без графична карта; хостваните вграждания са избор на всяка организация.
Без телеметрия
Нищо не напуска инсталацията, освен ако вие не го изпратите. Стойността telemetry.enabled на чарта може да бъде само false; схемата отхвърля всичко останало. Собственото отчитане на слоя за данни също е изключено: отчетите за използване на Neo4j и телеметрията на Qdrant са деактивирани в чарта.
Когато networkPolicy.enabled е включено (по подразбиране), никой под не може да достигне интернет, освен ако не посочите дестинацията в networkPolicy.externalEgressCIDRs. Хостваният доставчик на модели е една такава дестинация, както и вашият пощенски релей (mail relay).
Същото правило промени една настройка по подразбиране, която ще забележите. CAPTCHA проверката на nexus-auth при регистрация изисква интернет услуга, затова в инсталацията тя е изключена, а регистрацията на непознат потребител изчаква одобрение от администратор (403 SIGNUP_REQUIRES_APPROVAL). Филтърът, който блокира регистрации от хостинг мрежи, също е изключен, тъй като изисква лицензирани бази данни, които Nexus не доставя. Губите тази проверка.

