Iniciar sesiónReservar sesión
Soporte
Versión 1.0.0-alpha.1 más reciente

Documentación

Documentación de Adverant Nexus

Versión 1.0.0-alpha.1. Empiece por la Parte 1 si es nuevo en Nexus; la Parte 2 es para las personas que lo instalan y ejecutan.

Parte 1: Para todos

  • 1.1Qué es Nexus y para quién esQué hace Adverant Nexus por una organización, para quién está diseñado y cómo encajan sus partes, explicado con palabras sencillas usando Harrow Port Authority como ejemplo. Termina resumiendo las tres ediciones en un párrafo.
  • 1.2Un día de trabajo con NexusUn día de trabajo en Harrow Port Authority, desde el primer vistazo a Hoy hasta la última aprobación, mostrando lo que las personas hacen realmente en Nexus y dónde reside cada tipo de trabajo.
  • 1.3Su organización, su gente y lo que permanece privadoCómo modela Nexus una organización y los roles que ocupan sus miembros, quién puede comprar y reclamar en la cuenta de Adverant, y la línea entre lo que los administradores pueden ver y lo que permanece privado para cada persona.
  • 1.4IA bajo sus propias condicionesCómo utiliza Nexus la inteligencia artificial (IA) bajo las propias condiciones de la organización. La organización aporta y posee sus claves de modelos, una centralita enruta cada llamada a los proveedores que eligió, los modelos locales se ejecutan en sus propios servidores y no se envía nada a Adverant a sus espaldas.
  • 1.5Confianza y cumplimiento normativoLas partes de Nexus en las que trabaja a diario un responsable de cumplimiento normativo. Abarca el registro de auditoría y los registros sellados, las aprobaciones que requieren una segunda persona y las decisiones de inteligencia artificial (IA) pendientes de revisión. Termina con las solicitudes de datos personales y las páginas de cumplimiento que mantienen las evidencias listas antes de que las pida un auditor.
  • 1.6Ediciones y licencias en términos sencillosLas tres ediciones de Nexus y los 19 complementos y paquetes de dominio adicionales, seguidos de cómo funciona una licencia para una empresa. Abarca la comprobación sin conexión y lo que significa cada estado de licencia en la práctica, las promesas que cumple cada licencia y cómo pasar de Community a Enterprise sin reinstalar.
  • 1.7Paquetes de dominio y soluciones verticalesQué añade un paquete de dominio a Nexus para un sector concreto, los diez paquetes que ofrece Adverant, cómo se activa un paquete para una unidad y qué requiere un paquete en su licencia.
  • 1.8Dónde se ejecuta NexusLos lugares donde puede ejecutarse Nexus, desde la nube de la UE de Adverant hasta un emplazamiento sin internet y dispositivos sobre el terreno, qué significa la soberanía en la práctica y cómo elegir.
  • 1.9Primeros pasosLas dos decisiones antes de empezar, lo que hace su equipo de TI, la primera ejecución tal como la ve el primer administrador y una lista de comprobación de lo que debe tener listo el primer día.
  • 1.10Lejos del escritorioEl uso de Nexus en un teléfono, desde el diseño móvil de la consola en todas las ediciones hasta las aplicaciones nativas para iPhone y Android. Abarca qué funciona sin cobertura y cómo gestiona los teléfonos una empresa.
  • 1.11Adaptarlo a su medidaLas formas en que una organización moldea Nexus, desde un único ajuste hasta una solución vertical propia. También cómo dar instrucciones a los desarrolladores o a un socio, y qué garantiza la plataforma independientemente de lo que se construya.
  • 1.12Preguntas frecuentesRespuestas claras a las preguntas que más hacen los compradores, directivos y delegados de protección de datos, incluidas las incómodas sobre el dinero y el acceso a sus datos.

Parte 2: Para TI, DevOps y desarrolladores

  • 2.1ArquitecturaDe 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.
  • 2.2Las ediciones por dentroCómo se construyen Community y Enterprise a partir de un mismo producto, cómo una licencia activa grupos de funciones en tiempo de ejecución, qué muestra una instalación Community para una página de Enterprise, y qué significa eso para las imágenes que descarga y las extensiones que desarrolla.
  • 2.3Planificación de una instalaciónQué necesita una instalación de Nexus en Kubernetes antes de escribir un comando, qué tamaño tiene y las dos decisiones irreversibles: el nombre de la instalación y los custodios de claves. Termina con la hoja de planificación cumplimentada de Harrow Port Authority.
  • 2.4Obtención y verificación de una versiónDónde reside cada parte de una versión de Nexus, cómo se obtienen las imágenes de Enterprise con un token de descarga, y cómo demostrar sin conexión que cada imagen, chart y descarga proviene de Adverant sin alteraciones antes de instalar nada.
  • 2.5Comprobación previa con nexusctlCada comprobación que realiza `nexusctl preflight`, qué lee cada una y cómo falla, el informe que imprime y guarda, cómo llega ese informe a la página de comprobación previa de la consola, y cada opción.
  • 2.6Instalación de Community en KubernetesUna instalación paso a paso de la edición Community con Helm, desde cert-manager hasta tener todas las cargas de trabajo listas, con el archivo de valores explicado clave por clave, por qué no se usa --wait, el orden en que se ejecutan los hooks del chart y la vía de instalación con nexusctl como alternativa.
  • 2.7Instalación de Enterprise y aplicación de una licenciaQué cambia al instalar la edición Enterprise, cómo solicitar una licencia desde su cuenta de Adverant, las tres formas de importarla con todos los códigos de rechazo, y cómo Harrow Port Authority pasó su piloto de Community a Enterprise in situ sin perder nada.
  • 2.8Instalaciones en una sola máquinaInstale Nexus en un servidor Linux con nexusctl, o evalúelo en un portátil con k3d, y acceda a la consola mediante HTTPS para que funcionen el inicio de sesión y las llaves de acceso (passkeys).
  • 2.9La imagen de disco del instaladorArranque un servidor físico o una máquina virtual desde la imagen del instalador de Nexus e instalará el sistema operativo, k3s, cert-manager y Nexus sin red, comprobando cada archivo antes de utilizarlo.
  • 2.10Instalación aislada de la red (air-gapped)Lleve un paquete sin conexión firmado a un emplazamiento sin internet, verifíquelo con una clave que haya introducido por separado, cárguelo en su propio registro e instálelo. Las licencias, actualizaciones y listas de revocación también cruzan la brecha manualmente.
  • 2.11Variaciones: almacenes externos, TLS e ingressLos valores que adaptan Nexus a un clúster que no parte de cero, incluido TLS (Transport Layer Security), junto con bases de datos que ya ejecuta, sus propios certificados, otro controlador de ingress, clases de almacenamiento, correo, proxies, réplicas y Kubernetes gestionado.
  • 2.12La primera ejecuciónDe una instalación no reclamada a personas trabajando. Genere el código de reclamación, reclame la instalación en un navegador, cree el primer administrador con una llave de acceso (passkey), conecte el inicio de sesión de la empresa e invite a todos los demás.
  • 2.13LicenciasQué contiene un archivo de licencia de Nexus, cómo lo comprueba la instalación sin conexión, los seis estados en los que puede encontrarse y cómo solicitar, importar, renovar y retirar una.
  • 2.14Proveedores y modelos de IACómo el Enrutador de Proveedores de inteligencia artificial (IA) elige un modelo del propio conjunto de claves de la organización, y cómo los scripts y las herramientas de IA se comunican con Nexus desde el exterior.
  • 2.15Día dos: operación de NexusEl trabajo rutinario de operar una instalación después de la primera semana. Comienza con el desbloqueo del almacén de claves tras un reinicio y termina con la desinstalación.
  • 2.16Seguridad y redesQué deja entrar y salir una instalación, cómo sus servicios demuestran su identidad entre sí, y los controles que un operador establece o hereda para el inicio de sesión y la base de datos.
  • 2.17Resolución de problemasLos problemas que los operadores encuentran con más frecuencia, organizados según lo que se observa. Cada uno indica la causa, el comando que la confirma y la solución, y el capítulo termina con el envío de un paquete de soporte.
  • 2.18El modelo de extensiónLas seis formas de ampliar Nexus, desde un ajuste hasta un paquete de dominio, los límites de cada una y cómo los niveles de confianza y aislamiento deciden dónde se ejecuta su código. Léalo antes de abrir el kit de desarrollo de software (SDK).
  • 2.19Las reglas que hereda toda extensiónAislamiento en tres ejes, cómputo a través de UNO, IA (inteligencia artificial) a través del enrutador, claves propiedad de la organización y comprobaciones de licencia. Qué significa cada regla para su código y qué barrera la aplica, y por qué la hereda en lugar de programarla.
  • 2.20HabilidadesCómo escribir, probar y publicar una habilidad de Skills Engine, dónde aparece una vez que está activa y en qué se diferencian las habilidades de manifiesto en un complemento. Incluye un ejemplo práctico de resumen de asignación de atraques para Harrow Port Authority.
  • 2.21El SDK de complementosInstalación del SDK (kit de desarrollo de software) de complementos, sus herramientas de línea de comandos, un recorrido por la plantilla de servicio completo, el manifiesto v2 campo por campo y los veintidós controles que obligan a un complemento a cumplir las reglas.
  • 2.22El entorno de ejecución de complementosLos módulos del SDK (kit de desarrollo de software) sobre los que se ejecuta su complemento, desde la protección de ámbito y la barrera de base de datos hasta el despacho por UNO, la lectura de rutas de IA (inteligencia artificial) y las comprobaciones de licencia. A continuación, pruebas frente a una base de datos real, registro de sus habilidades e incorporación.
  • 2.23Paquetes de dominioDe qué se compone un paquete de dominio y qué indica su archivo pack.json; lentes y el registro de lentes; modelos de conocimiento, conectores y superposiciones móviles; cómo se otorga la licencia de un paquete y cómo se activa para una unidad; y los diez paquetes que suministra Adverant.
  • 2.24Creación de una solución vertical personalizada de principio a finUna compilación práctica del paquete de dominio de cadena de frío, desde las especificaciones iniciales hasta una versión en ejecución para cada unidad, con su modelo de conocimiento, lentes, una habilidad, un complemento de servicio completo y datos de muestra. A continuación, cómo ampliar un paquete ya existente y cómo añadir una lente a uno que ya se ha distribuido.
  • 2.25Compilación para cada ediciónQué cambia cuando una misma extensión debe funcionar en todas las ediciones, en un emplazamiento aislado de la red (air-gapped), en una carga útil de Nexus Edge o bajo la propia marca de un cliente. Cubre el límite de licencia para los módulos Enterprise y la entrega firmada sin conexión, con una matriz de qué hacer de forma diferente para cada destino.
  • 2.26Construir con herramientas de programación de IACómo crear extensiones de Nexus de forma segura con Claude Code y otras herramientas de programación con IA (inteligencia artificial). Comienza con la conexión de su IDE (entorno de desarrollo integrado) al Workbench y un archivo CLAUDE.md de proyecto que incorpora las reglas de la plataforma, y termina con seis instrucciones (prompts) prácticas y el control que valida cada una.
  • 2.27Escenarios de compilaciónUn recetario de trece compilaciones, desde una única habilidad hasta una entrega en un entorno aislado (air-gapped). Cada receta ofrece el objetivo, los bloques de construcción, los pasos y comandos, el control que demuestra que ha funcionado y qué cambia según la edición y la forma de entrega.
  • 2.28Lanzamiento de su extensiónCómo pasa un complemento o paquete de una compilación validada a las unidades que lo ejecutan, y cómo vuelve a retirarse. Versiones, revisión de lanzamiento, canales e instalaciones, firma, aprobaciones de cambios, el registro de identidad de entrega, migraciones, reversión y retirada de una versión.

Apéndices: Referencia

Descargar

Los PDF están en inglés.