バージョン 1.0.0-alpha.1最新
第 2.1 章
アーキテクチャ
Nexusチャート内の各サービスが何を所有し、その下にどのストアが配置されているか、そしてサービス間のアイデンティティからすべてのモデル呼び出しが通る経路まで、それらをまとめ上げるルールについて説明します。
このページは英語の原文から AI によって翻訳されました。不明な点がある場合は、英語のページを正としてご参照ください。 このページを英語で読む

Tomás ReillyがHarrow Port Authorityでの最初のインストールを終えたとき、kubectl -n nexus get podsには10個のDeploymentと7個のStatefulSet、さらに3個のCronJobが表示されました。データベースを構築したマイグレーションJobは、成功するとそれぞれ自分自身を削除するため、すでに消えていました。この一覧がプラットフォームのすべてです。これを覚えておいてください。なぜなら、運用開始後(Day 2)の疑問のほとんどは「これらのうち、どれがあれを所有しているのか?」から始まるからです。
この章では、各要素についてその疑問に答え、それらを通過する1つのリクエストを追跡し、最後にそれらすべてが従うルールについて説明します。第2部の残りの部分は、この全体像の上に成り立っています。
各サービスとそれぞれが所有するもの
チャートはKubernetes 1.33以降を対象とした1つのHelmチャート、nexus(バージョン1.0.0-alpha.1)です。すべてのワークロードは独自のServiceAccountの下で非rootユーザーとして実行され、すべてのLinuxケーパビリティが削除されています。IDとキーを保護するサービスへの呼び出しは相互TLS(Transport Layer Security)を介して実行され、パブリックAPI(アプリケーションプログラミングインターフェース)はAI(人工知能)ルーターとプロセスを共有します。
| コンポーネント | DeploymentおよびService | サービスポート | 所有するもの |
|---|---|---|---|
| コンソール | nexus-alpha |
3000 | ユーザーが目にするページ。コンソールホストでHTML(Hypertext Markup Language)を提供します |
| BFF(Backend for Frontend) | nexus-alpha-bff |
8080 | コンソール固有のデータ、各ユーザーに表示されるメニュー、リリースレジスター |
| Auth | nexus-auth |
9101(8443での相互TLS) | ユーザー、組織、セッション、トークン、APIキー、組織のモデルキープール |
| ゲートウェイ | nexus-gateway |
9092、WebSocket 8093 | The AI Provider Router, and the public API edge for REST (representational state transfer) and MCP (Model Context Protocol) |
| オーケストレーター | nexus-orchestrator |
8080 | UNOディスパッチ:すべてのジョブを受け入れ、キューに入れる |
| ワークフロー | nexus-workflows |
8081 | UNO実行:キューに入れられたジョブを実行するワーカー |
| GraphRAG | nexus-graphrag |
8090、WebSocket 8091 | メモリ:ナレッジグラフとそれに対する検索 |
| Probitas | nexus-probitas |
9151 (HTTPS) | エビデンス:ガバナンス記録と封印された台帳 |
| スキルエンジン | nexus-skills-engine |
8095 | スキルライブラリ。スキルの検索と実行 |
| Keys | nexus-keys |
8080(HTTPS、相互TLS) | OpenBao内の組織ごとのキー、カストディ、インストレーションID |
| プラグイン | nexus-plugins |
9111 | プラグインレジストリとカタログ記録。デフォルトではオフ |
| ファイル処理 | nexus-fileprocess |
9109 | アップロードされたドキュメントや画像の読み取り。デフォルトではオフ |
最初の10個は必須です。最後の2つはオプションであり、Enterpriseインストールやドメインパックでそれらを使用する場合にcomponents.plugins.enabledとcomponents.fileprocess.enabledでオンにします。もう1つのオプションサービスであるポート8080のnexus-aliveには専用のスイッチcomponents.alive.enabledがあり、これもデフォルトではオフになっています。それぞれのレプリカとリソースはcomponents.<name>の下にあります。
コンソールはデータベースを持たないサーバーレンダリングページです。クラスター内のBFFおよびnexus-authと通信し、パブリックなauthホストを経由して外部に出てから戻ることは決してありません。エディションがないと起動を拒否します。このエディションは、チャートが単一のedition値からNEXUS_EDITIONとして渡します。組織のすべてのメンバーは、自分のロールに従ってコンソール内で作業します。管理ページはオーナーと管理者用であり、メンバーが開くと「管理者ではありません(Not an administrator)」ページが表示されます。
BFFはコンソールのサーバー側半分であり、製品Nexus Alphaとして登録されたプラットフォームのプラグインとして構築されています。コンソール固有のテーブルを別のデータベースnexus_alphaに保持し、どのメニューグループをユーザーに表示するかを決定します。コンソールで作業を実行する必要がある場合、BFFはそれを所有するサービスに依頼します。
nexus-authはGoで記述されており、トークンを発行する唯一のサービスです。デフォルトでは、アクセストークンの有効期間は15分、リフレッシュトークンは12時間です(auth.accessTokenTTL、auth.refreshTokenTTL)。サインインしている各ユーザーを1分あたり5,000リクエストに制限し、それを超えると429を返します(auth.rateLimitPerMinute)。2つのリスナーを実行します。パブリックIngressが到達するコンテナポート8080のプレーンなリスナーと、クラスター内のすべての呼び出し元が使用しなければならない8443の相互TLSリスナーです。proxy.trustedCIDRs内のホップからのX-Forwarded-Forのみを信頼します。これはCIDR(Classless Inter-Domain Routing)範囲のリストであり、デフォルトはk3sポッドネットワークである10.42.0.0/16です。Ingressコントローラーが別の場所で実行されている場合は、これを変更してください。そうしないと、すべてのサインインがコントローラーから来たように見えます。
ゲートウェイには、1つのプロセスを共有する2つの役割があります。クラスター内では、AI Provider Router(第1部およびコンソールページにおけるAIスイッチボード)であり、組織のモデル認証情報の唯一の保持者です(詳細は後述)。エッジでは、api.<domain>が到達する先です。つまり、RESTクライアント、およびトークンがオーディエンスhttps://<hosts.api>/mcpを持ち、authホストのOAuth 2.1認可サーバーから発行されるMCPクライアントです(OAuthは委任された認可のためのオープンスタンダードです)。
オーケストレーターとワークフローは、合わせてワークフローエンジンであるUNOを構成します。すべてのコンピュートはこれらを通じて実行されます。オーケストレーターはPOST /api/v1/dispatchでジョブを受け入れ、jobId、runId、traceIdを伴う202を返し、キューに入れます。インラインの実行パスはありません。クライアントは常にGET /api/v1/dispatch/{jobId}をポーリングするか、コールバックを受け取ります。ワークフローワーカーは、デフォルトでレプリカごとに一度に4つずつ(workflows.concurrency)キューからジョブを取得し、ただ1つのHTTPルートGET /healthを持ちます。
Probitasはエビデンスサービスです。チャートが発行する証明書からTLS自体を提供し、台帳用の個別のロールを使用してテーブルをtrustスキーマに保持します。そのガバナンス機能はprobitas.flagsによって切り替えられます。いくつかはshadowモードで出荷されます。判定は計算されて記録されますが、フラグを変更するまでは何もブロックされません。
nexus-keysはGoで記述されたプラットフォームキーサービスです。OpenBaoキーストアに組織ごとのキーを保持し、毎晩ローテーションします。また、夜間のジョブでは、保持期限が来たキーを破棄し、そのレシートを独自のボリュームにエクスポートします。組織のキーを消去すると、その下でロックされているデータは永久に読み取り不能になります。また、最初のブートストラップ時にkeys.installationNameの下でインストレーションIDを発行し、その名前は永続的になります。慎重に選択してください。チャートは空の名前(INSTALLATION_NAME_MISSING)を拒否し、独自のサンプル値にある名前(INSTALLATION_NAME_EXAMPLE)も拒否します。
3つの公開ホスト
チャートは正確に3つのホスト名を公開し、それらが合わさってインストレーションIDとなります。すべてのサービスは、それらがないと起動を拒否します。
| 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オブジェクトであり、それぞれにパス/のルールが1つずつあります。エッジでのTLSはtls.modeに従います。existing(作成したSecretで、tls.existingSecretで指定)、cert-manager(実行しているClusterIssuerで、tls.clusterIssuerで指定)、またはnone(TLSはクラスターの前で終端)です。チャートは独自のリダイレクトを追加しないため、ACME(Automated Certificate Management Environment)のHTTPチャレンジは変更されずにソルバーに到達します。第2.11章「バリエーション:外部ストア、TLS、およびIngress」で各モードについて説明しています。
他に公開されるものはありません。データストア、OpenBao、およびすべての内部サービスは、名前空間の内部でのみリッスンします。
リクエストのエンドツーエンドの流れ
HarrowのIT責任者であるAoife Brennanがコンソールを開き、アシスタントに今月のバーススケジュールについて質問したときに何が起こるかを以下に示します。
- 彼女のブラウザは
https://console.harrow.exampleを読み込みます。nexus-consoleIngressはそれをポート3000のnexus-alphaに送信します。 - 彼女はパスキーでサインインします。サインインページは
auth.harrow.exampleを介してnexus-authと通信し、nexus-authは彼女のユーザー、組織、およびセッションにビジネスユニットがある場合はそのビジネスユニットを含むアクセストークンを発行します。 - コンソールのサーバーはBFFを呼び出し、BFFは彼女のトークンをチェックして、彼女の組織がその製品を保持しているかどうか、および彼女のロールが許可されているかどうかをnexus-authに尋ねます。nexus-authは、彼女が表示できるメニューグループを返します。
- 彼女の質問は、検証されたトークンから取得された組織とユーザーとともに、BFFからオーケストレーターのディスパッチルートに送られます。オーケストレーターは202を返し、Valkeyのキューにジョブを入れます。
- ワークフローワーカーがジョブを受け取ります。実行するスキルはスキルエンジンによって解決され、Harrowのドキュメントに対する検索はGraphRAGに送られます。GraphRAGはNeo4j、Qdrant、およびそのPostgreSQLスキーマを読み取ります。
- モデル呼び出しは
/internal/ai/chatのAI Provider Routerに送られます。ルーターはHarrow独自のキープールとルーティングポリシーからプロバイダーとモデルを選択し、Harrowのキーを使用して呼び出しを行い、補完結果を返します。 - 結果はジョブの実行行に格納されます。BFFがそれを読み取り、コンソールが引用とともに回答を描画します。
サービス間のホップは投影されたサービストークンを運び、nexus-auth、nexus-keys、およびProbitasへのホップはインストレーション独自の認証局からのTLSを介して実行され、ステップ4から6のすべてのデータアクセスはデータベース自体の中でHarrowの組織に制限(フェンス)されます。以下のセクションでその両方について説明します。
データ層
Nexusはすべてのストアの署名済みコピーを独自に出荷し、バンドルにはそれぞれのソース提供が含まれています。各ストアは、その機能と同様にライセンスも重視して選択されました。
| ストア | バージョン | ライセンス | 存在する理由 | ポート | デフォルトボリューム |
|---|---|---|---|---|---|
| PostGISおよびpgvectorを備えたPostgreSQL | PostgreSQL 16, PostGIS 3, pgvector 0.8 | PostgreSQL Licence; PostGIS GPL-2.0-or-later | すべてのサービスのシステム・オブ・レコード。地図データ用のPostGIS。行の横に保持されるベクトル用のpgvector | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | UNOジョブキューおよびnexus-authのAPIキーキャッシュなどの短命なキャッシュ | 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はネットワークプロトコルであるBoltを介してNeo4j Community Editionに到達し、サービスはPostgreSQLプロトコルを介してPostGISに到達するため、GPLはそれぞれの側に留まります。OpenBaoは、Vaultのライセンス変更前のVaultから派生したLinux Foundationのフォークです。
すべてのストアは認証がオンの状態で、生成された認証情報(Valkeyのパスワード、QdrantのAPIキー、SeaweedFSのアクセスキー)を使用して実行されます。
dataTierの下にある5つのストアはそれぞれ、クラスター内で実行される(デフォルトのmode: in-cluster)か、すでに運用しているもの(external.hostおよびexternal.existingSecretで指定されたSecretを伴うmode: external)です。外部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-postgresOpenBaoのペアは例外です。カストディJobがインストレーション内で初期化するため、常にインストレーション内で実行されます。
サービス間のアイデンティティ
Nexusはサービスメッシュなしで実行されます。相互TLSは、チャートがcert-managerを介して作成するローカル認証局(CA)から提供されます。cert-managerは最初にインストールしておく必要があります(v1.21.3がテスト済みです)。
自己署名Issuerは、有効期間10年のECDSA(楕円曲線デジタル署名アルゴリズム)P-256のCA証明書nexus-local-caを1つ作成します。2番目のIssuerはそのCAで署名します。インストレーション内のTLSサーバーを呼び出すべてのワークロードは、<service-account>-client-tlsという名前の独自のクライアント証明書を取得します。これは90日間有効で、有効期限の15日前に更新されます。その唯一の名前は、SPIFFE ID形式のURI(Uniform Resource Identifier)です。
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
各ワークロードは、自身の証明書Secret内でCAの公開証明書をca.crtとして見つけます。どのポッドもCAのキーをマウントせず、trust-managerも必要ありません。
3つのサービスが証明書によって呼び出し元を検証します。nexus-authは2番目のリスナーであるポート8443でそれを行い、クラスター内のすべての呼び出し元はそこにダイヤルします。nexus-keysは唯一のリスナーでそれを行います。Probitasは独自の証明書nexus-probitas-tlsからTLSを提供し、cert-managerがそれを更新すると再読み取りします。いずれもX-Forwarded-Client-Certヘッダーを信頼しません。
また、各ワークロードは、呼び出すサービスごとに1つずつ、そのサービスをオーディエンスとする1時間有効なKubernetesトークンを/var/run/secrets/nexusで取得します。ConfigMap nexus-service-identitiesは各<namespace>/<service-account>をサービス名またはプラグイン名にマッピングし、そこに存在しないワークロードはIDを持たず拒否されます。オーケストレーターとProbitasは、Kubernetes APIを使用してこれらのトークンをチェックします。実行中のサービスのうち、system:auth-delegatorを保持しているか、APIトークンがマウントされているのはその2つだけです。トークンを持つもう1つのワークロードは、インストール時に実行されるカストディJobです。
ネットワークポリシーは、IDが閉じないものを閉じます。チャートはデフォルト拒否から始まり、インストレーション自体のポッド間、DNS(Domain Name System)、Ingressコントローラーの名前空間(networkPolicy.ingressNamespace、デフォルトではkube-system)から3つのパブリックServiceへ、および2つのトークンレビュアー用のAPIサーバーへのトラフィックを許可します。OpenBaoポッドはプラットフォームの残りの部分とは異なるラベルを持っているため、名前空間内のオープンルールはそれらには届きません。ポート8200で通過できるのは、nexus-keys、そのJob、およびカストディJobだけです。メールリレーなど、ワークロードが名前空間外に到達しなければならないその他のものはすべて、デフォルトでは空になっているnetworkPolicy.externalEgressCIDRsに入れます。
マイグレーションとスキーマ台帳
マイグレーションは、post-installとpre-upgradeでHelmフックとして実行されます。post-installフックは、リリースのDeploymentが作成された後に実行されます。そのため、最初のインストール時には、スキーマがまだ存在しない間にサービスが開始され、ロールもパスワードもテーブルもないデータベースに対してクラッシュループすることになります。Nexusは台帳(レジャー)によってそれを回避します。
フックはウェイト(重み)順に実行され、Helmは次のウェイトが開始する前に各Jobを待機します。
| ウェイト | フック | 行うこと |
|---|---|---|
| -30 | nexus-migrations-envおよび前提条件 |
マイグレーターの認証情報を含むフック専用Secret、およびカストディJobが読み取るすべてのものを作成します |
| -20 | nexus-db-bootstrap |
nexusおよびnexus_alphaデータベース、マイグレーターロール、すべてのサービスのランタイムロール、拡張機能、および台帳を作成します |
| -15 | nexus-openbao-custody-init |
キーストアとアンシーラーを初期化し、インストレーションIDを発行します |
| -12 | nexus-graphrag-migrations |
nexus-authのベースラインが参照するオブジェクトを所有する、GraphRAGのスキーマ |
| -10 | nexus-auth-migrations |
IDスキーマ |
| -5 | オーケストレーター、ゲートウェイ、およびProbitasのマイグレーション | それらのスキーマ。Probitasは最初にauthテーブルが存在することを確認します |
| 0 | nexus-alpha-bff-migrations |
コンソール固有のデータベース |
各マイグレーションJobにはbackoffLimit: 0があるため、マイグレーションが失敗するとインストールも失敗します。
台帳は1つのテーブルnexus_release.schema_appliedであり、チェーンおよびイメージダイジェストごとに1つの行があります。各フックは、マイグレーションランナーが戻った後にのみその行を書き込みます。PostgreSQLを使用するすべてのDeploymentは、initコンテナwait-for-schemaを持っています。これは、他の何も読み取ることを許可されていないロール(nexus_ledger_reader)としてそのテーブルを読み取り、依存するすべてのチェーンがこのリリースのイメージの行を示すまで待機します。その後、サービスが開始されます。ワークフローワーカーはデータベースを共有しているためオーケストレーターのチェーンを待機し、スキルエンジンはブートストラップのみを待機します。
3秒ごと(schemaWait.intervalSeconds)にポーリングし、1,800秒後(schemaWait.timeoutSeconds)にまだ欠落しているチェーンの名前を示す行を出して諦めます。サービス自体のコンテナが間違ったスキーマに対して開始されることは決してありません。
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaこれが、決してhelm install --waitを実行してはならない理由です。--waitを使用すると、Helmはpost-installフックを実行する前にDeploymentを待機し、Deploymentはフックを待機します。どちらも動かなくなります。これなしでインストールし、後で待機してください。正確なコマンドは第2.6章「KubernetesへのCommunityのインストール」に記載されています。
3つの軸での分離
Nexusにおけるすべての読み取り、書き込み、ツール呼び出し、およびスキルディスパッチは、3つの軸でスコープ設定されます。
| 軸 | フィールド | 分離するもの |
|---|---|---|
| テナント | organization_id |
ある組織と別の組織(厳格な境界) |
| オーナー | owner_user_id |
同じ組織内であっても、ある個人のものと他のすべての人のもの |
| ユニット | business_unit_id |
組織の下位区分(オプション) |
オーナー軸は人々を驚かせます。メールボックスや個人のノートブックは、同じユニット内で同じロールを持つ同僚からであっても、そのオーナーに対してプライベートです。管理者はポリシーを設定し、コンテンツは読み取りません。
これらの軸は認証されたリクエストからのみ得られ、他のどこからも得られません。環境変数、ヘッダー、クエリパラメータ、またはパスセグメントでそれらを設定することはできません。組織を指定するリクエストボディはTENANT_NOT_A_PARAMETERで拒否されます。行がどのテナント、オーナー、ユニットに属しているかを示せないサーフェスは403 SCOPE_PREDICATE_MISSINGで拒否し、ボディにはどの軸が解決され、どの軸が解決されなかったかがリストされます。より広い読み取りにフォールバックすることは決してありません。
これは2つの場所で同時に成り立ちます。
データベース内。すべてのサービスは独自のランタイムロールとして接続します。IDサービスにはnexus_auth、auth_app、auth_platform、Probitasにはnexus_probitasとnexus_probitas_ledger、その他にはnexus_gateway、nexus_graphrag、nexus_skills、orchestrator_app、workflows_appなどです。いずれもスーパーユーザーではなく、BYPASSRLSも持っていません。また、使用するテーブルを所有しているわけでもないため、すべての行レベルセキュリティ(RLS)ポリシーが適用されます。ロールは、接続とスキーマの使用を許可し、テーブルの権限は一切許可しないグループnexus_runtimeを共有します。各サービスには、独自のマイグレーションによって独自のテーブルの権限が付与されます。RLSポリシーが読み取るテナント設定は、そのオーナーとして実行される各サービスのbind_scope関数を通じてのみ設定できます。ブートストラップは他のすべての人からset_configを取り消し、オーケストレーターとProbitasは、ランタイムロールがそれを直接呼び出せる場合は起動を拒否します(ProbitasはそれをDB_ROLE_SETS_SCOPE_DIRECTLYと名付けています)。インストール全体で唯一のスーパーユーザー接続は、ブートストラップJobとBFFのプロビジョニングステップに属します。
共有されたスコープ付きクエリプリミティブ内。プラットフォーム内のすべてのリポジトリと、SDK(ソフトウェア開発キット)上で構築されたすべてのプラグインは、解決されたスコープからSQL述語を構築する1つのフェンスを継承します。そのスコープ関数は検証されたIDを受け取り、組織パラメータを持たないため、呼び出し元がそれを渡すことはできず、どのルートもオプトアウトできません。
テナント境界を越えるケースは正確に1つだけあり、それは狭いものです。つまり、記録された付与(グラント)です。行を保持している組織の2人の人物が、どの組織がどのテーブルをいつまで読み取れるかを記録します。すべての読み取りは読み取り専用トランザクションで実行され、両方のテナントにログ記録されます。オーナーと管理者が境界を越えて読み取ることは決してなく、読み取り側が付与を広げることもできません。
AIの経路
呼び出し元は希望(wish)を表明します。AI Provider Routerが認証情報を所有し、最終的な選択を行います。
Nexus内のすべてのモデル呼び出しはルーターの/internal/ai/*ルートを通過し、ルーターは指定された呼び出し元のみを許可します。チャートはゲートウェイに3つのリストを設定します。
| ルート | 呼び出し可能なもの |
|---|---|
| チャットおよびチャットストリーミング | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| 埋め込み(Embeddings)およびリランク(rerank) | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| ツール実行を含むその他すべて | nexus-orchestrator, nexus-workflows |
呼び出し元IDのない呼び出しは403 MISSING_CALLER_IDENTITYで拒否され、リストにない呼び出し元は403 UNAUTHORIZED_CALLERで拒否されます。プラグインはどのリストにも含まれていませんが、これは意図的なものです。プラグインのモデル呼び出しは、UNOディスパッチを通じてプラグインに代わって行われます。
呼び出し元が送信できるのは希望です。つまり、優先するプロバイダーとモデル、さらに最小コンテキスト長やツール使用などの機能プロファイルです。ルーターは、組織でそのプロバイダーが有効化され、認証情報が設定されている場合にのみ希望を尊重します。そうでない場合は、最初は同じプロバイダー内で、次に組織の他のプロバイダー間で代替します。機能プロファイルはフィルタリングのみを行い、その中のデータレジデンシー要件は厳格です。適合するものがない場合、フォールバックモデルはありません。呼び出し元は、コンソールが管理者に表示する修復文字列とともに、422 MODEL_CAPABILITY_UNAVAILABLEまたは422 NO_PROVIDER_FOR_ROLEを受け取ります。
キーは組織に属します。各組織の管理者は、コンソールから独自のプロバイダーキーをそのプールに入れ、ルーターは呼び出し時にそれらを解決します。モデルキーがチャートの値になることはなく、Nexusに同梱されることもありません。キーを持たない組織はAIの回答を得られず、コンソールにはその旨が明確に表示されます。他の場所から何かがそのギャップを埋めることはありません。
2つのチャート値がルーターを構成します。ai.localProvider.baseUrlは、お客様が運用するOpenAI互換のモデルサーバーを指定し、他のプロバイダーと同様にルーティングされます。ai.installationHostsは、プライベート名を持つお客様のモデルサーバーをリストし、ルーターはこれらをインストール環境内にあるものとして扱います。GraphRAGもまた、そのコンテンツを所有する組織としてルーター経由で埋め込み処理を行います。デフォルトの埋め込みモデルはグラフィックカードなしでクラスター内で動作しますが、ホストされた埋め込みを使用するかどうかは各組織の選択です。
テレメトリなし
お客様が送信しない限り、インストール環境から外部にデータが出ることはありません。チャートのtelemetry.enabledの値はfalseにのみ設定可能であり、スキーマはそれ以外の値を拒否します。データ層自体のレポート機能もオフになっており、Neo4jの使用状況レポートおよびQdrantのテレメトリはチャート内で無効化されています。
デフォルトで有効になっているnetworkPolicy.enabledを使用すると、networkPolicy.externalEgressCIDRsに宛先をリストしない限り、どのPodもインターネットに接続できません。ホストされたモデルプロバイダーはそのような宛先の1つであり、メールリレーも同様です。
同じルールにより、お客様が気づくであろう1つのデフォルト設定が変更されました。サインアップ用のnexus-authのCAPTCHAはインターネットサービスを必要とするため、インストール環境ではオフになっており、未知のユーザーのサインアップは管理者の承認待ちとなります(403 SIGNUP_REQUIRES_APPROVAL)。ホスティングネットワークからのサインアップをブロックするスクリーニングもオフになっています。これは、Nexusに同梱されていないライセンスデータベースを必要とするためです。そのスクリーニング機能は失われます。

