Версія 1.0.0-alpha.1найновіша
Розділ 2.1
Архітектура
За що відповідає кожен сервіс у чарті Nexus і які сховища лежать в його основі, а також правила, що об'єднують їх у єдине ціле — від автентифікації між сервісами до шляху, який проходить кожен виклик моделі.
Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

Коли Tomás Reilly завершив перше встановлення в Harrow Port Authority, kubectl -n nexus get pods показала десять об’єктів Deployment і сім StatefulSet, а також три CronJob. Завдання Job з міграції, які створили базу даних, уже зникли, оскільки кожне з них видаляє себе після успішного виконання. Цей перелік — уся платформа. Вивчіть його, адже більшість питань під час подальшої експлуатації починаються з «який із цих компонентів за це відповідає?»
Цей розділ відповідає на це питання щодо кожного елемента, простежує шлях одного запиту крізь них, а потім описує правила, яким вони всі підпорядковуються. Решта частини 2 спирається на цю картину.
Сервіси та сфера відповідальності кожного з них
Чарт являє собою єдиний чарт Helm, nexus, версії 1.0.0-alpha.1, для Kubernetes 1.33 або новішої версії. Кожне робоче навантаження виконується під власним ServiceAccount, від імені непривілейованого (non-root) користувача, зі скинутими всіма привілеями (capabilities) Linux. Виклики до сервісів, що захищають ідентифікаційні дані та ключі, проходять через взаємний TLS (Transport Layer Security — захист на транспортному рівні), а публічний API (application programming interface — прикладний програмний інтерфейс) використовує спільний процес із маршрутизатором ШІ (штучного інтелекту).
| Компонент | Deployment і Service | Порт сервісу | За що відповідає |
|---|---|---|---|
| Консоль | nexus-alpha |
3000 | Сторінки, які бачать люди; віддає HTML (Hypertext Markup Language — мова гіпертекстової розмітки) на хості консолі |
| BFF (backend for frontend — бекенд для фронтенду) | nexus-alpha-bff |
8080 | Власні дані консолі, меню, яке отримує кожна особа, реєстр релізів |
| Auth | nexus-auth |
9101 (взаємний TLS на 8443) | Люди, організації, сесії, токени, ключі API, пул ключів моделей організації |
| Шлюз | nexus-gateway |
9092, WebSocket 8093 | Маршрутизатор провайдерів ШІ та граничний вузол публічного API для REST (representational state transfer — передача репрезентативного стану) і MCP (Model Context Protocol — протокол контексту моделі) |
| Оркестратор | nexus-orchestrator |
8080 | Диспетчеризація UNO: приймання кожного завдання та постановка його в чергу |
| Робочі процеси (Workflows) | nexus-workflows |
8081 | Виконання UNO: робочий вузол (воркер), який виконує завдання з черги |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Пам'ять: граф знань і пошук у ньому |
| Probitas | nexus-probitas |
9151 (HTTPS) | Доказова база: записи управління та захищений реєстр (ledger) |
| Рушій навичок | nexus-skills-engine |
8095 | Бібліотека навичок; пошук і запуск навичок |
| Ключі | 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 усередині кластера, ніколи не виходячи назовні через публічний хост автентифікації та назад. Вона відмовляється запускатися без указання редакції, яку чарт передає як 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). Він запускає два слухачі: звичайний на порту контейнера 8080, до якого звертається публічний Ingress, і слухач із взаємним TLS на порту 8443, який зобов'язаний використовувати кожен клієнт усередині кластера. Він довіряє заголовку X-Forwarded-For лише від вузлів пересилання, зазначених у proxy.trustedCIDRs — списку діапазонів безкласової міждоменної маршрутизації (CIDR), який за замовчуванням має значення 10.42.0.0/16, що відповідає мережі подів k3s. Якщо ваш контролер Ingress працює в іншому місці, змініть це значення. Інакше кожен вхід у систему виглядатиме так, ніби він надійшов від контролера.
Шлюз виконує два завдання в межах одного процесу. Усередині кластера це маршрутизатор провайдерів ШІ (комутатор ШІ в частині 1 та на сторінках консолі) — єдине місце зберігання облікових даних моделей організації (докладніше про це нижче). На межі кластера це те, до чого звертається api.<domain>: клієнти REST і клієнти MCP, чиї токени містять аудиторію https://<hosts.api>/mcp і надходять від сервера авторизації OAuth 2.1 на хості автентифікації (OAuth — це відкритий стандарт делегованої авторизації).
Оркестратор і робочі процеси (workflows) разом утворюють UNO — рушій робочих процесів. Усі обчислення проходять через них. Оркестратор приймає завдання за адресою POST /api/v1/dispatch, відповідає кодом 202 із полями jobId, runId та traceId і ставить його в чергу. Прямого (inline) шляху виконання немає: клієнт завжди опитує GET /api/v1/dispatch/{jobId} або приймає зворотний виклик (callback). Робочий вузол workflows бере завдання з черги, за замовчуванням по чотири одночасно на кожну репліку (workflows.concurrency), і має лише один маршрут HTTP — GET /health.
Probitas — це сервіс доказової бази. Він сам обслуговує TLS за допомогою сертифіката, який випускає чарт, і зберігає свої таблиці в схемі trust з окремою роллю для реєстру (ledger). Його функції управління перемикаються за допомогою probitas.flags. Кілька з них постачаються в режимі shadow: вердикт обчислюється та записується, але нічого не блокується, доки ви не зміните прапорець.
nexus-keys — це платформний сервіс ключів, написаний мовою Go. Він зберігає окремий ключ для кожної організації в сховищі ключів OpenBao і щоночі проводить їх ротацію. Його нічні завдання також знищують ключі, термін утримання яких настав, і експортують квитанції у власний том. Видалення ключа організації робить дані, зашифровані ним, нечитабельними назавжди. Під час першого початкового завантаження (bootstrap) він також випускає ідентифікатор інсталяції, заданий у keys.installationName, і це ім'я є постійним. Обирайте його уважно: чарт відхиляє порожнє ім'я (INSTALLATION_NAME_MISSING) і відхиляє ім'я зі своїх власних прикладів значень (INSTALLATION_NAME_EXAMPLE).
Три публічні хости
Чарт публікує рівно три імені хостів, які разом становлять ідентифікатор інсталяції. Жоден сервіс не запуститься без них.
| 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 — середовище автоматизованого управління сертифікатами) доходить до вашого обробника без змін. У розділі 2.11 «Варіації: зовнішні сховища, TLS та ingress» розглянуто кожен режим.
Більше нічого назовні не відкривається. Сховища даних, OpenBao та кожен внутрішній сервіс приймають з'єднання лише всередині простору імен.
Наскрізний шлях запиту
Ось що відбувається, коли 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 бере завдання. Навичку, яку він запускає, визначає рушій навичок, а пошук за документами Harrow спрямовується до GraphRAG, який читає дані з Neo4j, Qdrant і своєї схеми PostgreSQL.
- Виклик моделі прямує до маршрутизатора провайдерів ШІ за адресою
/internal/ai/chat. Маршрутизатор обирає провайдера та модель із власного пулу ключів і політики маршрутизації Harrow, здійснює виклик за допомогою ключа Harrow і повертає згенеровану відповідь. - Результат записується в рядок виконання завдання. 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 | Основна система обліку для кожного сервісу; 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 і рушія навичок | 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 | Сховище ключів і його розпечатувач для 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 — це форк 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), який чарт створює через cert-manager; останній має бути встановлений заздалегідь (протестовано версію v1.21.3).
Самопідписаний Issuer створює один сертифікат CA, nexus-local-ca, за алгоритмом ECDSA (Elliptic Curve Digital Signature Algorithm — алгоритм цифрового підпису на еліптичних кривих) P-256, дійсний протягом десяти років. Другий Issuer підписує сертифікати за допомогою цього 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 перевіряють ці токени через API Kubernetes. Із запущених сервісів лише ці два мають system:auth-delegator або змонтований токен API; єдине інше робоче навантаження з токеном — це завдання Job зі зберігання ключів (custody), яке виконується під час встановлення.
Мережева політика закриває те, що не закриває ідентифікація. Чарт починає із заборони за замовчуванням (default deny), а потім дозволяє трафік між власними подами інсталяції, до DNS (Domain Name System — система доменних імен), із простору імен контролера Ingress (networkPolicy.ingressNamespace, за замовчуванням kube-system) до трьох публічних об'єктів Service, а також до сервера API для двох перевіряльників токенів. Поди OpenBao мають іншу мітку, ніж решта платформи, тому відкрите правило всередині простору імен на них не поширюється: доступ до них на порту 8200 мають лише nexus-keys, його завдання Job і завдання Job зі зберігання ключів. Усе інше, до чого робоче навантаження має звертатися за межами простору імен, наприклад ваш поштовий ретранслятор, указується в networkPolicy.externalEgressCIDRs, який за замовчуванням є порожнім.
Міграції та реєстр схем
Міграції виконуються як хуки Helm на етапах post-install та pre-upgrade. Хук post-install запускається після створення об'єктів Deployment релізу. Тому під час першого встановлення сервіси запускаються, коли їхніх схем ще не існує, і вони б циклічно падали (crash-loop) під час звернення до бази даних без ролі, пароля і таблиць. Nexus уникає цього за допомогою реєстру (ledger).
Хуки виконуються в порядку їхньої ваги (weight), і Helm чекає на завершення кожного завдання Job, перш ніж почнеться виконання наступної ваги:
| Вага | Хук | Що він робить |
|---|---|---|
| -30 | nexus-migrations-env та передумови |
Створює доступний лише для хуків об'єкт Secret з обліковими даними мігратора та все, що читає завдання Job зі зберігання ключів |
| -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, з окремим рядком для кожного ланцюжка та дайджесту образу. Кожен хук записує свій рядок лише після того, як його виконавець міграції завершив роботу. Кожен Deployment, який використовує PostgreSQL, містить init-контейнер wait-for-schema, що читає цю таблицю від імені ролі, якій не дозволено читати більше нічого (nexus_ledger_reader), і чекає, доки кожен ланцюжок, від якого він залежить, не покаже рядок для образу цього релізу. Після цього сервіс запускається. Робочий вузол workflows чекає на ланцюжок оркестратора, оскільки використовує ту саму базу даних, а рушій навичок чекає лише на початкове завантаження (bootstrap).
Він опитує базу кожні 3 секунди (schemaWait.intervalSeconds) і припиняє спроби через 1 800 секунд (schemaWait.timeoutSeconds), виводячи рядок із переліком ланцюжків, яких досі бракує. Власний контейнер сервісу ніколи не запускається з неправильною схемою.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaСаме тому в жодному разі не можна запускати helm install --wait. З прапорцем --wait Helm чекає на готовність об'єктів Deployment перед запуском хуків post-install, а об'єкти Deployment чекають на виконання хуків. Жодна зі сторін не рухається з місця. Встановлюйте без нього, а готовності дочекайтеся після цього; точну команду наведено в розділі 2.6 «Встановлення редакції Community у Kubernetes».
Ізоляція за трьома осями
Кожне читання, запис, виклик інструменту та диспетчеризація навички в Nexus обмежуються за трьома осями.
| Вісь | Поле | Що вона розділяє |
|---|---|---|
| Тенант (Tenant) | organization_id |
Одну організацію від іншої, жорстка межа |
| Власник (Owner) | owner_user_id |
Об'єкти однієї особи від об'єктів усіх інших, навіть у межах однієї організації |
| Підрозділ (Unit) | business_unit_id |
Підрозділ організації, необов'язково |
Вісь власника часто дивує людей. Поштова скринька чи особистий записник є приватними для їхнього власника навіть від колег із того самого підрозділу з тією самою роллю. Адміністратор налаштовує політики, але не читає вміст.
Значення осей беруться з автентифікованого запиту і більше нізвідки. Жодна змінна середовища, заголовок, параметр запиту чи сегмент шляху не можуть їх задати. Тіло запиту, в якому вказано організацію, відхиляється з кодом TENANT_NOT_A_PARAMETER. Інтерфейс, який не може визначити, до якого тенанта, власника та підрозділу належить рядок, відповідає відмовою 403 SCOPE_PREDICATE_MISSING, а в тілі відповіді перелічується, які осі вдалося визначити, а які — ні. Система ніколи не переходить до ширшого читання як резервного варіанта.
Це правило діє у двох місцях одночасно.
У базі даних. Кожен сервіс підключається під власними робочими ролями: nexus_auth, auth_app та auth_platform для сервісу ідентифікації, nexus_probitas та nexus_probitas_ledger для Probitas, і nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app та решта для інших сервісів. Жодна з них не є суперкористувачем і не має права BYPASSRLS. Жодна з них також не є власником таблиць, які використовує, тому до неї застосовується кожна політика безпеки на рівні рядків (RLS — row-level security). Ролі входять до спільної групи nexus_runtime, яка надає право на підключення та використання схем, але жодних прав на таблиці; кожному сервісу права на його таблиці надаються його власними міграціями. Параметри тенанта, які зчитують політики RLS, можна встановити лише через функцію bind_scope кожного сервісу, яка виконується від імені свого власника. Початкове завантаження (bootstrap) відкликає право виконання set_config в усіх інших, а оркестратор і Probitas відмовляються запускатися, якщо їхня робоча роль може викликати її напряму (Probitas називає це DB_ROLE_SETS_SCOPE_DIRECTLY). Єдині підключення з правами суперкористувача в усій інсталяції належать завданню Job початкового завантаження та кроку ініціалізації BFF.
У спільному примітиві запитів з обмеженою областю дії. Кожен репозиторій у платформі та кожен плагін, побудований на базі SDK (software development kit — набір засобів розробки ПЗ), успадковує єдиний бар'єр, який формує предикат SQL на основі визначеної області дії (scope). Його функція визначення області дії приймає перевірені ідентифікаційні дані й не має параметра організації, тому клієнт не може передати його ззовні, і жоден маршрут не може обійти це обмеження.
Існує рівно один спосіб перетину межі тенанта, і він вузькоспеціалізований: зафіксований дозвіл (grant). Дві особи в організації, яка володіє рядками, записують, яка організація може читати які таблиці й до якого часу. Кожне читання виконується в транзакції лише для читання і реєструється в журналах обох тенантів. Власники та адміністратори ніколи не читають дані між тенантами, а сторона, що читає, не може розширити наданий дозвіл.
Шлях виклику ШІ
Клієнти висловлюють побажання. Маршрутизатор провайдерів ШІ володіє обліковими даними й ухвалює остаточне рішення.
Кожен виклик моделі в Nexus проходить через маршрути /internal/ai/* маршрутизатора, і маршрутизатор допускає лише явно зазначених клієнтів. Чарт задає на шлюзі три списки:
| Маршрути | Хто може викликати |
|---|---|
| Чат і потокова передача чату | 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 разом із рядком рекомендацій щодо усунення проблеми, який консоль показує адміністратору.
Ключі належать організації. Адміністратори кожної організації додають власні ключі провайдерів до її пулу через консоль, а маршрутизатор визначає їх під час виклику. Жоден ключ моделі не задається як значення чарту і не постачається разом із Nexus. Організація без ключа не отримує відповідей від ШІ, про що консоль прямо повідомляє; ніщо зі сторонніх джерел цю прогалину не заповнює.
Два значення чарту формують маршрутизатор. ai.localProvider.baseUrl задає ім'я сумісного з OpenAI сервера моделей, який ви запускаєте і який маршрутизується як будь-який інший провайдер. ai.installationHosts містить перелік ваших серверів моделей із приватними іменами, які маршрутизатор вважає внутрішніми для інсталяції. GraphRAG також виконує векторне представлення через маршрутизатор від імені організації, якій належить вміст. Модель векторного представлення за замовчуванням працює в кластері без графічної карти; використання хмарних моделей векторного представлення є вибором кожної організації.
Жодної телеметрії
Нічого не залишає межі інсталяції, якщо ви самі цього не надішлете. Значення telemetry.enabled у чарті може бути лише false; схема відхиляє будь-що інше. Власну звітність рівня даних також вимкнено: звіт про використання Neo4j та телеметрію Qdrant вимкнено в чарті.
Коли параметр networkPolicy.enabled увімкнено (за замовчуванням), жоден под не може вийти в інтернет, якщо ви не вкажете пункт призначення в networkPolicy.externalEgressCIDRs. Одним із таких пунктів призначення є хмарний провайдер моделей, а іншим — ваш поштовий ретранслятор.
Це саме правило змінило одне налаштування за замовчуванням, яке ви помітите. CAPTCHA в nexus-auth для реєстрації потребує інтернет-сервісу, тому в інсталяції її вимкнено, і реєстрація стороннього користувача очікує на схвалення адміністратора (403 SIGNUP_REQUIRES_APPROVAL). Фільтр, що блокує реєстрації з хостингових мереж, також вимкнено, оскільки він потребує ліцензованих баз даних, які Nexus не постачає. Ви втрачаєте цю перевірку.

