Iniciar sesiónReservar sesión

Capítulo 2.1

Arquitectura

De qué es responsable cada servicio en el chart de Nexus y qué almacenes de datos subyacen, seguido de las reglas que los mantienen unidos, desde la identidad entre servicios hasta la ruta que sigue cada llamada a un modelo.

Esta página fue traducida por IA a partir del original en inglés. Si algo no está claro, la página en inglés es la referencia. Leer esta página en inglés

19 minutos de lectura

Cuando Tomás Reilly terminó la primera instalación en Harrow Port Authority, kubectl -n nexus get pods mostraba diez Deployments y siete StatefulSets, además de tres CronJobs. Los Jobs de migración que construyeron la base de datos ya habían desaparecido, porque cada uno se elimina a sí mismo cuando termina con éxito. Ese listado es toda la plataforma. Apréndaselo, porque la mayoría de las preguntas del segundo día empiezan por «¿cuál de estos es dueño de aquello?».

Este capítulo responde a esa pregunta para cada componente, sigue una solicitud a través de ellos y luego aborda las reglas que todos obedecen. El resto de la Parte 2 se basa en este panorama.

Los servicios y qué gestiona cada uno

El chart es un único chart de Helm, nexus, versión 1.0.0-alpha.1, para Kubernetes 1.33 o posterior. Cada carga de trabajo se ejecuta bajo su propia ServiceAccount, como usuario no root y con todas las capacidades de Linux eliminadas. Las llamadas a los servicios que protegen la identidad y las claves se realizan mediante TLS (Transport Layer Security) mutuo, y la API (interfaz de programación de aplicaciones) pública comparte proceso con el enrutador de IA (inteligencia artificial).

Componente Deployment y Service Puerto del Service De qué es responsable
Consola nexus-alpha 3000 Las páginas que ven los usuarios; sirve HTML (Hypertext Markup Language) en el host de la consola
BFF (backend for frontend) nexus-alpha-bff 8080 Los datos propios de la consola, el menú que recibe cada persona, el registro de versiones
Auth nexus-auth 9101 (TLS mutuo en 8443) Personas, organizaciones, sesiones, tokens, claves de API, el fondo de claves de modelos de la organización
Gateway nexus-gateway 9092, WebSocket 8093 El enrutador de proveedores de IA (AI Provider Router) y el borde de la API pública para REST (representational state transfer) y MCP (Model Context Protocol)
Orquestador nexus-orchestrator 8080 Despacho de UNO: acepta cada trabajo y lo pone en cola
Workflows nexus-workflows 8081 Ejecución de UNO: el worker que ejecuta los trabajos en cola
GraphRAG nexus-graphrag 8090, WebSocket 8091 Memoria: el grafo de conocimiento y la recuperación sobre él
Probitas nexus-probitas 9151 (HTTPS) Evidencia: registros de gobernanza y el libro mayor sellado
Motor de habilidades nexus-skills-engine 8095 La biblioteca de habilidades; búsqueda y ejecución de habilidades
Claves nexus-keys 8080 (HTTPS, TLS mutuo) Claves por organización en OpenBao, custodia, la identidad de la instalación
Complementos nexus-plugins 9111 El registro de complementos y los registros del catálogo; desactivado de forma predeterminada
Procesamiento de archivos nexus-fileprocess 9109 Lectura de documentos e imágenes subidos; desactivado de forma predeterminada

Los diez primeros son obligatorios. Los dos últimos son opcionales y se activan con components.plugins.enabled y components.fileprocess.enabled cuando una instalación Enterprise o un paquete de dominio los utiliza. Un servicio opcional más, nexus-alive en el puerto 8080, tiene su propio interruptor, components.alive.enabled, y también está desactivado de forma predeterminada. Las réplicas y los recursos de cada uno se encuentran bajo components.<name>.

La consola consta de páginas renderizadas en el servidor sin base de datos. Se comunica con el BFF y con nexus-auth dentro del clúster, nunca saliendo por el host público de autenticación para volver a entrar. Se niega a arrancar sin su edición, que el chart pasa como NEXUS_EDITION a partir del único valor edition. Cada miembro de una organización trabaja en ella según su rol. Las páginas de administración son para propietarios y administradores, y un miembro que abra una recibe la página «Not an administrator».

El BFF es la mitad de servidor de la consola y está construido como un complemento de la plataforma, registrado como el producto Nexus Alpha. Mantiene las tablas propias de la consola en una base de datos separada, nexus_alpha, y decide qué grupos de menús ve una persona. Cuando la consola necesita que se realice un trabajo, el BFF se lo pide al servicio responsable.

nexus-auth está escrito en Go y es el único servicio que emite tokens. Los tokens de acceso duran 15 minutos y los de actualización 12 horas de forma predeterminada (auth.accessTokenTTL, auth.refreshTokenTTL). Limita a cada persona con sesión iniciada a 5,000 solicitudes por minuto antes de responder 429 (auth.rateLimitPerMinute). Ejecuta dos escuchas: la simple en el puerto de contenedor 8080 a la que llega el Ingress público, y una con TLS mutuo en el 8443 que debe usar todo llamador dentro del clúster. Solo confía en X-Forwarded-For cuando proviene de los saltos indicados en proxy.trustedCIDRs, una lista de rangos CIDR (Classless Inter-Domain Routing) cuyo valor predeterminado es 10.42.0.0/16, la red de pods de k3s. Si su controlador de ingress se ejecuta en otro lugar, cámbielo. De lo contrario, parecerá que cada inicio de sesión proviene del controlador.

El gateway tiene dos funciones que comparten un mismo proceso. Dentro del clúster es el enrutador de proveedores de IA (la centralita de IA de la Parte 1 y de las páginas de la consola), el único poseedor de las credenciales de modelos de una organización (más detalles a continuación). En el borde es a lo que llega api.<domain>: clientes REST y clientes MCP, cuyos tokens llevan la audiencia https://<hosts.api>/mcp y provienen del servidor de autorización OAuth 2.1 en el host de autenticación (OAuth es el estándar abierto para la autorización delegada).

El orquestador y workflows forman juntos UNO, el motor de flujos de trabajo. Todo el cómputo pasa por ellos. El orquestador acepta un trabajo en POST /api/v1/dispatch, responde 202 con un jobId, runId y traceId, y lo pone en cola. No existe una vía de ejecución en línea: el cliente siempre consulta GET /api/v1/dispatch/{jobId} o recibe una llamada de retorno (callback). El worker de workflows extrae trabajos de la cola, cuatro a la vez por réplica de forma predeterminada (workflows.concurrency), y tiene exactamente una ruta HTTP, GET /health.

Probitas es el servicio de evidencia. Sirve TLS por sí mismo, a partir de un certificado emitido por el chart, y mantiene sus tablas en el esquema trust con un rol separado para el libro mayor. Sus funciones de gobernanza se conmutan mediante probitas.flags. Varias se entregan en modo shadow: el veredicto se calcula y se registra, y no se bloquea nada hasta que usted cambia el indicador.

nexus-keys es el servicio de claves de la plataforma, escrito en Go. Mantiene una clave por organización en un almacén de claves OpenBao y las rota cada noche. Sus trabajos nocturnos también destruyen las claves cuya fecha de retención ha llegado y exportan sus recibos a un volumen propio. Borrar la clave de una organización hace que los datos bloqueados con ella sean ilegibles para siempre. También emite la identidad de la instalación en el primer arranque inicial (bootstrap), bajo keys.installationName, y ese nombre es permanente. Elíjalo con cuidado: el chart rechaza un nombre vacío (INSTALLATION_NAME_MISSING) y rechaza el nombre que figura en sus propios valores de ejemplo (INSTALLATION_NAME_EXAMPLE).

Esta instalación (Community)
Esta instalación (Community)
La página propia de una instalación Community muestra su versión y el estado del motor. Indica claramente que no se necesita licencia. Las partes Enterprise de la página se muestran como adelantos.

Tres hosts públicos

El chart publica exactamente tres nombres de host, que juntos constituyen la identidad de la instalación. Todos los servicios se niegan a arrancar sin ellos.

Ingress Valor del host Backend
nexus-console hosts.console nexus-alpha, puerto 3000
nexus-api hosts.api nexus-gateway, puerto 9092
nexus-auth hosts.auth nexus-auth, puerto 9101

Los ejemplos de este libro utilizan console.harrow.example, api.harrow.example y auth.harrow.example. Los Ingress son objetos networking.k8s.io/v1 simples con una regla cada uno, ruta /. El TLS en el borde sigue a tls.mode: existing (un Secret creado por usted, nombrado en tls.existingSecret), cert-manager (un ClusterIssuer que usted ejecuta, nombrado en tls.clusterIssuer) o none (el TLS termina delante del clúster). El chart no añade ninguna redirección propia, por lo que un desafío HTTP de ACME (Automated Certificate Management Environment) llega a su solucionador sin modificaciones. El capítulo 2.11, Variaciones: almacenes externos, TLS e ingress, aborda cada modo.

No se expone nada más. Los almacenes de datos, OpenBao y todos los servicios internos escuchan únicamente dentro del espacio de nombres.

Tres bandas horizontales. La banda superior es "Edge" con tres cuadros de Ingress etiquetados como console, api y auth, cada uno apuntando hacia abajo a su Service (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). La banda intermedia es "Platform services": un cuadro para nexus-alpha-bff; nexus-orchestrator junto a nexus-workflows, agrupados y etiquetados como UNO; luego nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; y dos cuadros con líneas discontinuas para los componentes opcionales nexus-plugins y nexus-fileprocess. La banda inferior es "Data tier" con un cuadro por almacén (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS), y un cuadro delimitado separado etiquetado como "Key store" que contiene openbao y openbao-unsealer, al que solo accede nexus-keys.
Los componentes de una instalación de Nexus y los almacenes que subyacen a ellos.

Una solicitud, de principio a fin

Esto es lo que ocurre cuando Aoife Brennan, directora de TI en Harrow, abre la consola y le hace al asistente una pregunta sobre el programa de atraques de este mes.

  1. Su navegador carga https://console.harrow.example. El Ingress nexus-console lo envía a nexus-alpha en el puerto 3000.
  2. Inicia sesión con su llave de acceso (passkey). Las páginas de inicio de sesión se comunican con nexus-auth a través de auth.harrow.example, y nexus-auth le emite un token de acceso que contiene su usuario, su organización y, cuando su sesión tiene una, su unidad de negocio.
  3. El servidor de la consola llama al BFF, que comprueba su token y pregunta a nexus-auth si su organización posee el producto y si su rol está admitido. Responde con los grupos de menús que ella puede ver.
  4. Su pregunta va del BFF a la ruta de despacho del orquestador, con su organización y usuario tomados del token verificado. El orquestador responde 202 y pone el trabajo en una cola en Valkey.
  5. Un worker de workflows toma el trabajo. El motor de habilidades resuelve la habilidad que ejecuta, y la recuperación sobre los documentos de Harrow va a GraphRAG, que lee Neo4j, Qdrant y su esquema de PostgreSQL.
  6. La llamada al modelo va al enrutador de proveedores de IA en /internal/ai/chat. El enrutador elige el proveedor y el modelo del propio fondo de claves y política de enrutamiento de Harrow, realiza la llamada con la clave de Harrow y devuelve la respuesta generada.
  7. El resultado aterriza en la fila de ejecución del trabajo. El BFF lo lee y la consola muestra la respuesta, con sus citas.

Los saltos entre servicios transportan tokens de servicio proyectados; los que entran en nexus-auth, nexus-keys y Probitas se ejecutan sobre TLS de la propia autoridad de certificación de la instalación, y cada acceso a datos en los pasos 4 a 6 está acotado a la organización de Harrow en la propia base de datos. Las secciones siguientes explican ambas cosas.

Una secuencia de izquierda a derecha. Un cuadro de navegador envía "1 page" al Ingress console y luego a nexus-alpha. Una flecha lateral "2 sign-in" va desde el navegador a través del Ingress auth hasta nexus-auth. nexus-alpha envía "3 menu" a nexus-alpha-bff, que lo verifica con nexus-auth. nexus-alpha-bff envía "4 dispatch, 202" a nexus-orchestrator, que escribe en un icono de cola de Valkey. nexus-workflows extrae "5 job" de la cola y llama a nexus-skills-engine y nexus-graphrag (con sus tres almacenes dibujados bajo GraphRAG). nexus-workflows envía "6 chat" a nexus-gateway, etiquetado como "AI Provider Router: organisation key pool", que envía una única flecha fuera del límite del clúster hacia "model provider". Una flecha de retorno punteada "7 result on run row" vuelve a nexus-alpha-bff.
Una pregunta al asistente, desde el navegador hasta el proveedor del modelo y de vuelta.

La capa de datos

Nexus incluye su propia copia firmada de cada almacén, con la oferta de código fuente de cada uno en el paquete. Cada uno fue elegido tanto por su licencia como por su función.

Almacén Versión Licencia Por qué está ahí Puerto Volumen predeterminado
PostgreSQL con PostGIS y pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 Licencia PostgreSQL; PostGIS GPL-2.0-or-later El sistema de registro para todos los servicios; PostGIS para datos cartográficos; pgvector para vectores guardados junto a las filas 5432 50 GiB
Valkey 8.1 BSD-3-Clause Las colas de trabajos de UNO y las cachés de corta duración, como la caché de claves de API de nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 El grafo de conocimiento que GraphRAG construye y recorre 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Búsqueda vectorial para GraphRAG y el motor de habilidades 6333 (HTTP), 6334 (llamadas a procedimientos remotos gRPC) 10 GiB
SeaweedFS 4.48 Apache-2.0 Almacenamiento de objetos para archivos, compatible con Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 El almacén de claves y su dessellador, para nexus-keys 8200 5 GiB y 1 GiB

Algunas elecciones sustituyeron a opciones más conocidas. Valkey reemplaza a Redis 7.4, cuyas licencias actuales son rechazadas por la versión. MinIO es AGPL-3.0, por lo que el almacén de objetos es SeaweedFS. GraphRAG se comunica con Neo4j Community Edition mediante Bolt, un protocolo de red, y los servicios se comunican con PostGIS mediante el protocolo de PostgreSQL, de modo que la GPL permanece en cada uno de ellos. OpenBao es la bifurcación de Vault realizada por la Linux Foundation antes del cambio de licencia de Vault.

Todos los almacenes se ejecutan con la autenticación activada y credenciales generadas: una contraseña para Valkey, una clave de API para Qdrant y claves de acceso para SeaweedFS.

Cada uno de los cinco almacenes bajo dataTier se ejecuta en el clúster (mode: in-cluster, el valor predeterminado) o es uno que usted ya opera (mode: external, con external.host y un Secret nombrado por external.existingSecret). Para un PostgreSQL externo, establezca sslmode en verify-full o verify-ca, y ponga el certificado de la autoridad de certificación (CA) del servidor en ese Secret; el capítulo 2.11, Variaciones: almacenes externos, TLS e ingress, contiene los detalles.

# 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

El par de OpenBao es la excepción: siempre se ejecuta dentro de la instalación, porque el Job de custodia lo inicializa allí.

Identidad entre servicios

Nexus se ejecuta sin una malla de servicios (service mesh). El TLS mutuo proviene de una autoridad de certificación (CA) local que el chart crea a través de cert-manager, el cual debe instalarse primero (se ha probado la versión v1.21.3).

Un Issuer autofirmado crea un certificado de CA, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, válido por diez años. Un segundo Issuer firma con esa CA. Cada carga de trabajo que llama a un servidor TLS dentro de la instalación obtiene su propio certificado de cliente, llamado <service-account>-client-tls, válido por 90 días y renovado 15 días antes de su vencimiento. Su único nombre es un identificador uniforme de recursos (URI) con el formato de identidad SPIFFE:

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

Cada carga de trabajo encuentra el certificado público de la CA como ca.crt en su propio Secret de certificado. Ningún pod monta la clave de la CA y no necesita trust-manager.

Tres servicios verifican a los llamadores mediante certificado. nexus-auth lo hace en su segunda escucha, el puerto 8443, y todos los llamadores dentro del clúster marcan ese puerto. nexus-keys lo hace en su única escucha. Probitas sirve TLS desde su propio certificado, nexus-probitas-tls, que vuelve a leer cuando cert-manager lo renueva. Ninguno confía en un encabezado X-Forwarded-Client-Cert.

Cada carga de trabajo también obtiene tokens de Kubernetes de una hora en /var/run/secrets/nexus, uno por cada servicio al que llama, con ese servicio como audiencia. El ConfigMap nexus-service-identities asocia cada <namespace>/<service-account> con un nombre de servicio o complemento, y una carga de trabajo que no figure en él no tiene identidad y es rechazada. El orquestador y Probitas comprueban estos tokens con la API de Kubernetes. De los servicios en ejecución, solo esos dos poseen system:auth-delegator o tienen montado un token de API; la única otra carga de trabajo con un token es el Job de custodia que se ejecuta durante la instalación.

La política de red cierra lo que la identidad no cierra. El chart parte de una denegación predeterminada y luego admite el tráfico entre los propios pods de la instalación, el DNS (Domain Name System), el espacio de nombres del controlador de ingress (networkPolicy.ingressNamespace, kube-system de forma predeterminada) hacia los tres Services públicos, y el servidor de la API para los dos revisores de tokens. Los pods de OpenBao llevan una etiqueta diferente a la del resto de la plataforma, por lo que la regla abierta dentro del espacio de nombres no los alcanza: solo pasan nexus-keys, sus Jobs y el Job de custodia, en el puerto 8200. Cualquier otra cosa a la que una carga de trabajo deba llegar fuera del espacio de nombres, como su retransmisor de correo, va en networkPolicy.externalEgressCIDRs, que está vacío de forma predeterminada.

Migraciones y el libro mayor de esquemas

Las migraciones se ejecutan como hooks de Helm, en post-install y pre-upgrade. Un hook post-install se ejecuta después de que se hayan creado los Deployments de la versión. Por tanto, en una primera instalación los servicios arrancan mientras sus esquemas aún no existen, y entrarían en un bucle de fallos (crash-loop) contra una base de datos sin rol, sin contraseña y sin tablas. Nexus evita eso con un libro mayor.

Los hooks se ejecutan en orden de peso, y Helm espera a cada Job antes de que comience el siguiente peso:

Peso Hook Qué hace
-30 nexus-migrations-env y requisitos previos Crea el Secret exclusivo para hooks con las credenciales del migrador y todo lo que lee el Job de custodia
-20 nexus-db-bootstrap Crea las bases de datos nexus y nexus_alpha, el rol de migrador, el rol de tiempo de ejecución de cada servicio, las extensiones y el libro mayor
-15 nexus-openbao-custody-init Inicializa el almacén de claves y el dessellador y emite la identidad de la instalación
-12 nexus-graphrag-migrations El esquema de GraphRAG, que posee objetos a los que hace referencia la línea base de nexus-auth
-10 nexus-auth-migrations El esquema de identidad
-5 Migraciones del orquestador, el gateway y Probitas Sus esquemas; Probitas comprueba primero que existan las tablas de autenticación
0 nexus-alpha-bff-migrations La base de datos propia de la consola

Cada Job de migración tiene backoffLimit: 0, por lo que una migración fallida hace que falle la instalación.

El libro mayor es una sola tabla, nexus_release.schema_applied, con una fila por cadena y resumen (digest) de imagen. Cada hook escribe su fila solo después de que su ejecutor de migración haya terminado. Cada Deployment que utiliza PostgreSQL lleva un contenedor de inicialización, wait-for-schema, que lee esa tabla con un rol al que no se le permite leer nada más (nexus_ledger_reader) y espera hasta que cada cadena de la que depende muestre una fila para la imagen de esta versión. Entonces arranca el servicio. El worker de workflows espera a la cadena del orquestador, ya que comparte esa base de datos, y el motor de habilidades espera únicamente al arranque inicial.

Consulta cada 3 segundos (schemaWait.intervalSeconds) y desiste tras 1,800 (schemaWait.timeoutSeconds) con una línea que nombra las cadenas que aún faltan. El contenedor propio del servicio nunca arranca contra un esquema incorrecto.

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

Por eso nunca debe ejecutar helm install --wait. Con --wait, Helm espera a los Deployments antes de ejecutar los hooks post-install, y los Deployments esperan a los hooks. Ninguno avanza. Instale sin esa opción y espere después; el capítulo 2.6, Instalación de Community en Kubernetes, ofrece el comando exacto.

Aislamiento en tres ejes

Cada lectura, escritura, llamada a herramienta y despacho de habilidad en Nexus se acota en tres ejes.

Eje Campo Qué separa
Inquilino organization_id Una organización de otra; un límite estricto
Propietario owner_user_id Los elementos de una persona de los de todos los demás, incluso dentro de una misma organización
Unidad business_unit_id Una subdivisión de una organización, opcional

El eje de propietario sorprende a la gente. Un buzón de correo o un cuaderno personal es privado para su propietario incluso frente a colegas de la misma unidad con el mismo rol. Un administrador establece políticas y no lee el contenido.

Los ejes provienen de la solicitud autenticada y de ningún otro lugar. Ninguna variable de entorno, encabezado, parámetro de consulta o segmento de ruta puede establecerlos. Un cuerpo de solicitud que nombre una organización es rechazado con TENANT_NOT_A_PARAMETER. Una superficie que no pueda indicar a qué inquilino, propietario y unidad pertenece una fila rechaza la operación con 403 SCOPE_PREDICATE_MISSING, y el cuerpo enumera qué ejes se resolvieron y cuáles no. Nunca recurre a una lectura más amplia.

Eso se cumple en dos lugares a la vez.

En la base de datos. Cada servicio se conecta con sus propios roles de tiempo de ejecución: nexus_auth, auth_app y auth_platform para el servicio de identidad, nexus_probitas y nexus_probitas_ledger para Probitas, y nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app y el resto para los demás. Ninguno es superusuario ni tiene BYPASSRLS. Ninguno es propietario de las tablas que utiliza tampoco, por lo que se le aplica cada política de seguridad a nivel de fila (RLS). Los roles comparten un grupo, nexus_runtime, que concede conexión y uso de esquemas pero ningún derecho sobre tablas; a cada servicio se le conceden sus propias tablas mediante sus propias migraciones. Los ajustes de inquilino que leen las políticas RLS solo pueden establecerse a través de la función bind_scope de cada servicio, que se ejecuta como su propietario. El arranque inicial revoca set_config a todos los demás, y el orquestador y Probitas se niegan a arrancar si su rol de tiempo de ejecución pudiera llamarlo directamente (Probitas denomina a eso DB_ROLE_SETS_SCOPE_DIRECTLY). Las únicas conexiones de superusuario en toda la instalación pertenecen al Job de arranque inicial y al paso de aprovisionamiento del BFF.

En la primitiva compartida de consultas acotadas. Cada repositorio de la plataforma y cada complemento construido sobre el SDK (kit de desarrollo de software) hereda una barrera que construye el predicado SQL a partir de un ámbito resuelto. Su función de ámbito toma la identidad verificada y no tiene parámetro de organización, por lo que un llamador no puede pasar uno y ninguna ruta puede eludirlo.

Existe exactamente un cruce del límite de inquilino, y es estrecho: una concesión registrada. Dos personas de la organización que posee las filas registran qué organización puede leer qué tablas y hasta cuándo. Cada lectura se ejecuta en una transacción de solo lectura y se registra en ambos inquilinos. Los propietarios y administradores nunca leen entre organizaciones, y el lector no puede ampliar una concesión.

La ruta de la IA

Los llamadores expresan deseos. El enrutador de proveedores de IA posee la credencial y toma la decisión final.

Cada llamada a un modelo en Nexus pasa por las rutas /internal/ai/* del enrutador, y el enrutador solo admite llamadores nombrados. El chart establece tres listas en el gateway:

Rutas Quién puede llamar
Chat y transmisión de chat (streaming) nexus-orchestrator, nexus-workflows, nexus-skills-engine
Embeddings y reclasificación (rerank) nexus-graphrag, nexus-skills-engine, nexus-workflows
Todo lo demás, incluida la ejecución de herramientas nexus-orchestrator, nexus-workflows

Una llamada sin identidad de llamador es rechazada con 403 MISSING_CALLER_IDENTITY, y un llamador que no esté en la lista con 403 UNAUTHORIZED_CALLER. Los complementos no están en ninguna lista, y eso es deliberado: las llamadas a modelos de un complemento se realizan en su nombre, a través del despacho de UNO.

Lo que un llamador puede enviar es un deseo: un proveedor y modelo preferidos, más un perfil de capacidades como una longitud mínima de contexto o el uso de herramientas. El enrutador atiende un deseo solo cuando la organización tiene ese proveedor habilitado y con credenciales; de lo contrario, lo sustituye, primero dentro del mismo proveedor y luego entre los demás proveedores de la organización. Un perfil de capacidades solo filtra, y un requisito de residencia de datos en él es estricto. Cuando nada encaja, no hay modelo de respaldo: el llamador recibe 422 MODEL_CAPABILITY_UNAVAILABLE o 422 NO_PROVIDER_FOR_ROLE, con una cadena de remediación que la consola muestra a un administrador.

Las claves pertenecen a la organización. Los administradores de cada organización introducen sus propias claves de proveedor en su fondo desde la consola, y el enrutador las resuelve en el momento de la llamada. Ninguna clave de modelo es un valor del chart y ninguna se incluye con Nexus. Una organización sin clave no obtiene respuestas de IA, y la consola lo indica claramente; nada suple esa carencia desde otro lugar.

Dos valores del chart configuran el enrutador. ai.localProvider.baseUrl nombra un servidor de modelos compatible con OpenAI que usted ejecuta, enrutado como cualquier otro proveedor. ai.installationHosts enumera sus servidores de modelos en nombres privados, que el enrutador cuenta como internos a la instalación. GraphRAG también genera incrustaciones a través del enrutador, en nombre de la organización a la que pertenece el contenido. El modelo de incrustación predeterminado se ejecuta en el clúster sin tarjeta gráfica; las incrustaciones alojadas son elección de cada organización.

Sin telemetría

Nada sale de una instalación a menos que usted lo envíe. El valor telemetry.enabled del chart solo puede ser false; el esquema rechaza cualquier otra cosa. Los informes propios de la capa de datos también están desactivados: el informe de uso de Neo4j y la telemetría de Qdrant están deshabilitados en el chart.

Con networkPolicy.enabled activado, que es el valor predeterminado, ningún pod puede acceder a internet a menos que usted incluya el destino en networkPolicy.externalEgressCIDRs. Un proveedor de modelos alojado es uno de esos destinos, al igual que su retransmisor de correo.

La misma regla cambió un valor predeterminado que usted notará. El CAPTCHA de nexus-auth para los registros necesita un servicio de internet, por lo que en una instalación está desactivado, y el registro de un desconocido espera la aprobación de un administrador (403 SIGNUP_REQUIRES_APPROVAL). El filtro que bloquea los registros desde redes de alojamiento también está desactivado, porque necesita bases de datos con licencia que Nexus no incluye. Usted pierde ese filtrado.

Estado de la instalación
Estado de la instalación
En Enterprise, la página de estado muestra el clúster bajo Nexus: qué tan ocupada está cada parte y cuánta capacidad queda, con cada advertencia junto a lo que se debe hacer al respecto.