AnmeldenBriefing buchen
Support
Version 1.0.0-alpha.1aktuell

Dokumentation

Adverant Nexus-Dokumentation

Version 1.0.0-alpha.1. Beginnen Sie mit Teil 1, wenn Sie neu bei Nexus sind; Teil 2 richtet sich an diejenigen, die es installieren und betreiben.

Teil 1: Für alle

  • 1.1Was Nexus ist und für wen es gedacht istWas Adverant Nexus für eine Organisation leistet, für wen es entwickelt wurde und wie seine Bestandteile ineinandergreifen – einfach erklärt am Beispiel der Harrow Port Authority. Am Ende werden die drei Editionen in einem Absatz vorgestellt.
  • 1.2Ein Arbeitstag mit NexusEin Arbeitstag bei der Harrow Port Authority, vom ersten Blick auf „Heute“ bis zur letzten Freigabe – mit einem Einblick, was Mitarbeitende in Nexus tatsächlich tun und wo welche Art von Arbeit stattfindet.
  • 1.3Ihre Organisation, ihre Mitarbeitenden und was privat bleibtWie Nexus eine Organisation und die Rollen ihrer Mitarbeitenden abbildet, wer über das Adverant-Konto Käufe tätigen und Ansprüche geltend machen darf und wo die Grenze zwischen dem verläuft, was Administratoren sehen können, und dem, was für jede Person privat bleibt.
  • 1.4KI zu Ihren BedingungenWie Nexus künstliche Intelligenz (KI) zu den eigenen Bedingungen der Organisation einsetzt. Die Organisation bringt ihre eigenen Modellschlüssel mit und behält die Kontrolle darüber, eine zentrale Vermittlungsstelle leitet jeden Modellaufruf an die von ihr gewählten Anbieter weiter, lokale Modelle laufen auf ihren eigenen Servern, und nichts wird hinter ihrem Rücken an Adverant gesendet.
  • 1.5Vertrauen und ComplianceDie Bereiche von Nexus, in denen ein Compliance-Beauftragter zu Hause ist. Behandelt werden das Audit-Protokoll und versiegelte Datensätze, Freigaben, die eine zweite Person erfordern, sowie Entscheidungen der künstlichen Intelligenz (KI), die auf Überprüfung warten. Den Abschluss bilden Auskunftsanfragen zu personenbezogenen Daten und die Compliance-Seiten, die Nachweise bereithalten, noch bevor ein Prüfer danach fragt.
  • 1.6Editionen und Lizenzen einfach erklärtDie drei Editionen von Nexus und die 19 darauf aufbauenden Add-ons und Branchenpakete sowie die Funktionsweise einer Lizenz für ein Unternehmen. Behandelt werden die Offline-Prüfung und was die einzelnen Lizenzstatus in der Praxis bedeuten, die Versprechen, die jede Lizenz einhält, sowie der Wechsel von Community zu Enterprise ohne Neuinstallation.
  • 1.7Branchenpakete und BranchenlösungenWas ein Branchenpaket für eine bestimmte Branche zu Nexus hinzufügt, welche zehn Pakete Adverant anbietet, wie ein Paket für eine Geschäftseinheit aktiviert wird und was ein Paket in Ihrer Lizenz voraussetzt.
  • 1.8Wo Nexus läuftDie Umgebungen, in denen Nexus ausgeführt werden kann – von der EU-Cloud von Adverant bis hin zu einem Standort ohne Internetverbindung und Geräten im Außeneinsatz –, was Souveränität in der Praxis bedeutet und wie Sie die richtige Wahl treffen.
  • 1.9Erste SchritteDie zwei Entscheidungen vor dem Start, was Ihr IT-Team tut, der erste Start aus Sicht des ersten Administrators und eine Checkliste dessen, was am ersten Tag bereitliegen sollte.
  • 1.10UnterwegsDie Nutzung von Nexus auf dem Smartphone, von der mobilen Ansicht der Konsole in jeder Edition bis hin zu den nativen Apps für iPhone und Android. Behandelt wird, was ohne Empfang funktioniert und wie ein Unternehmen die Smartphones verwaltet.
  • 1.11Nexus an Ihre Bedürfnisse anpassenDie Möglichkeiten, wie eine Organisation Nexus gestalten kann – von einer einzelnen Einstellung bis hin zu einer eigenen Branchenlösung. Außerdem: wie Sie Entwickler oder Partner instruieren und was die Plattform unabhängig davon garantiert, was entwickelt wird.
  • 1.12Häufig gestellte FragenKlare Antworten auf die Fragen, die Einkäufer, Führungskräfte und Datenschutzbeauftragte am häufigsten stellen – einschließlich der unangenehmen Fragen zu Kosten und dem Zugriff auf Ihre Daten.

Teil 2: Für IT, DevOps und Entwickler

  • 2.1ArchitekturWofür jeder Dienst im Nexus-Chart zuständig ist und welche Datenspeicher darunter liegen, gefolgt von den Regeln, die alles zusammenhalten – von der Identität zwischen Diensten bis hin zum Pfad, den jeder Modellaufruf nimmt.
  • 2.2Editionen unter der HaubeWie Community und Enterprise aus einem einzigen Produkt erstellt werden, wie eine Lizenz Funktionsgruppen zur Laufzeit aktiviert, was eine Community-Installation bei einer Enterprise-Seite anzeigt und was das für die von Ihnen abgerufenen Images und die von Ihnen entwickelten Erweiterungen bedeutet.
  • 2.3Planung einer InstallationWas eine Kubernetes-Installation von Nexus benötigt, bevor Sie den ersten Befehl eingeben, wie groß sie dimensioniert sein muss und welche zwei Entscheidungen Sie nicht rückgängig machen können: den Installationsnamen und die Schlüsselverwahrer. Den Abschluss bildet das ausgefüllte Planungsarbeitsblatt der Harrow Port Authority.
  • 2.4Beziehen und Überprüfen eines ReleasesWo sich die einzelnen Bestandteile eines Nexus-Releases befinden, wie Enterprise-Images mit einem Pull-Token abgerufen werden und wie Sie vor der Installation offline nachweisen, dass jedes Image, jedes Chart und jeder Download unverändert von Adverant stammt.
  • 2.5Vorabprüfung mit nexusctlJede Prüfung, die `nexusctl preflight` durchführt, was dabei jeweils ausgelesen wird und wann sie fehlschlägt, der Bericht, der ausgegeben und gespeichert wird, wie dieser Bericht auf die Preflight-Seite der Konsole gelangt, sowie alle Flags.
  • 2.6Installation von Community auf KubernetesEine schrittweise Installation der Community-Edition mit Helm, von cert-manager bis zur Einsatzbereitschaft aller Workloads – mit einer Erklärung der Values-Datei Schlüssel für Schlüssel, dem Grund für den Verzicht auf --wait, der Ausführungsreihenfolge der Chart-Hooks und dem Installationsweg über nexusctl als Alternative.
  • 2.7Installation von Enterprise und Einspielen einer LizenzWas sich bei der Installation der Enterprise-Edition ändert, wie Sie über Ihr Adverant-Konto eine Lizenz anfordern, welche drei Möglichkeiten zum Importieren es gibt (einschließlich aller Ablehnungscodes) und wie die Harrow Port Authority ihren Community-Piloten im laufenden Betrieb ohne Datenverlust auf Enterprise umgestellt hat.
  • 2.8Einzelrechner-InstallationenInstallieren Sie Nexus mit nexusctl auf einem einzelnen Linux-Server oder testen Sie es mit k3d auf einem Laptop, und rufen Sie die Konsole über HTTPS auf, damit Anmeldung und Passkeys funktionieren.
  • 2.9Das Installations-Disk-ImageStarten Sie einen physischen Server oder eine virtuelle Maschine vom Nexus-Installations-Image, um das Betriebssystem, k3s, cert-manager und Nexus ganz ohne Netzwerkverbindung zu installieren – wobei jede Datei vor ihrer Verwendung überprüft wird.
  • 2.10Air-Gap-InstallationBringen Sie ein signiertes Offline-Bundle an einen Standort ohne Internetverbindung, überprüfen Sie es anhand eines separat mitgebrachten Schlüssels, laden Sie es in Ihre eigene Registry und führen Sie die Installation durch. Auch Lizenzen, Updates und Sperrlisten überbrücken die Trennung manuell.
  • 2.11Varianten: Externe Speicher, TLS und IngressDie Konfigurationswerte, mit denen Nexus an einen bereits bestehenden Cluster angepasst wird – einschließlich TLS (Transport Layer Security), bereits von Ihnen betriebener Datenbanken, eigener Zertifikate, eines anderen Ingress-Controllers, Speicherklassen, E-Mail, Proxys, Replikaten und verwaltetem Kubernetes.
  • 2.12Der erste StartVon einer noch nicht übernommenen Installation bis zur produktiven Arbeit. Erzeugen Sie den Übernahmecode, übernehmen Sie die Installation im Browser, legen Sie den ersten Administrator mit einem Passkey an, binden Sie anschließend die Unternehmensanmeldung an und laden Sie alle weiteren Personen ein.
  • 2.13LizenzenWas eine Nexus-Lizenzdatei enthält, wie die Installation sie offline überprüft, welche sechs Status sie annehmen kann und wie Sie eine Lizenz anfordern, importieren, verlängern und widerrufen.
  • 2.14KI-Anbieter und -ModelleWie der Provider Router für künstliche Intelligenz (KI) ein Modell aus dem eigenen Schlüsselpool der Organisation auswählt und wie Skripte und KI-Werkzeuge von außen auf Nexus zugreifen.
  • 2.15Tag zwei: Betrieb von NexusDie Routineaufgaben beim Betrieb einer Installation nach der ersten Woche. Das Kapitel beginnt mit dem Entsiegeln des Schlüsselspeichers nach einem Neustart und endet mit der Deinstallation.
  • 2.16Sicherheit und NetzwerkWas eine Installation hinein- und hinauslässt, wie ihre Dienste einander ihre Identität nachweisen und welche Kontrollen ein Betreiber für die Anmeldung und die Datenbank festlegt oder übernimmt.
  • 2.17FehlerbehebungDie Probleme, denen Betreiber am häufigsten begegnen, geordnet nach dem jeweiligen Symptom. Zu jedem Problem werden die Ursache, der Befehl zur Bestätigung und die Lösung genannt; das Kapitel endet mit dem Einsenden eines Support-Bundles.
  • 2.18Das ErweiterungsmodellDie sechs Möglichkeiten zur Erweiterung von Nexus – von einer Einstellung bis zum Branchenpaket –, die jeweiligen Grenzen und wie Vertrauens- und Isolationsstufen darüber entscheiden, wo Ihr Code ausgeführt wird. Lesen Sie dies, bevor Sie das Software Development Kit (SDK) öffnen.
  • 2.19Die Regeln, die jede Erweiterung erbtIsolierung auf drei Achsen, Berechnung über UNO, KI (künstliche Intelligenz) über den Router, organisationseigene Schlüssel und Lizenzprüfungen. Was jede Regel für Ihren Code bedeutet, welches Gate sie durchsetzt und warum Sie sie erben, anstatt sie selbst zu programmieren.
  • 2.20SkillsWie man einen Skills-Engine-Skill schreibt, testet und veröffentlicht, wo er erscheint, sobald er live ist, und wie sich Manifest-Skills in einem Plugin unterscheiden. Enthält eine ausgearbeitete Zusammenfassung zur Liegeplatzzuweisung für die Harrow Port Authority.
  • 2.21Das Plugin SDKInstallation des Plugin SDK (Software Development Kit), seine Befehlszeilen-Tools, ein Rundgang durch die Full-Service-Vorlage, das v2-Manifest Feld für Feld und die zweiundzwanzig Gates, die ein Plugin an die Regeln binden.
  • 2.22Die Plugin-LaufzeitumgebungDie SDK-Module (Software Development Kit), auf denen Ihr Plugin läuft, vom Scope Guard und der Datenbank-Abgrenzung bis zum UNO-Dispatch, dem Auslesen der KI-Route (künstliche Intelligenz) und Lizenzprüfungen. Anschließend das Testen gegen eine echte Datenbank, das Registrieren Ihrer Skills und das Onboarding.
  • 2.23Domain PacksWoraus ein Domain Pack besteht und was seine pack.json aussagt; Linsen und die Linsen-Registry; Wissensmodelle, Konnektoren und mobile Overlays; wie ein Pack lizenziert und für eine Einheit aktiviert wird; sowie die zehn Packs, die Adverant ausliefert.
  • 2.24Eine maßgeschneiderte Branchenlösung durchgehend erstellenEin ausgearbeiteter Aufbau des Domain Packs für die Kühlkette, vom ersten Briefing bis zum produktiven Release für jede Einheit, mit seinem Wissensmodell, Linsen, einem Skill, einem Full-Service-Plugin und Beispieldaten. Anschließend, wie man ein bereits bestehendes Pack erweitert und wie man einem bereits ausgelieferten Pack eine Linse hinzufügt.
  • 2.25Erstellen für jede EditionWas sich ändert, wenn eine Erweiterung in jeder Edition, an einem Air-Gapped-Standort, auf einem Nexus Edge Payload oder hinter der eigenen Marke eines Kunden funktionieren muss. Behandelt die Lizenzgrenze für Enterprise-Module und die signierte Offline-Auslieferung, mit einer Matrix dessen, was für jedes Ziel anders zu handhaben ist.
  • 2.26Entwickeln mit KI-ProgrammierwerkzeugenWie Sie Nexus-Erweiterungen sicher mit Claude Code und anderen KI-Coding-Tools (künstliche Intelligenz) erstellen. Es beginnt mit der Verbindung Ihrer IDE (integrierte Entwicklungsumgebung) mit der Workbench und einer Projektdatei CLAUDE.md, die die Plattformregeln enthält, und endet mit sechs ausgearbeiteten Prompts und dem Gate, das jeden einzelnen bestätigt.
  • 2.27Build-SzenarienEin Kochbuch mit dreizehn Builds, von einem einzelnen Skill bis zur Air-Gapped-Auslieferung. Jedes Rezept nennt das Ziel, die Bausteine, die Schritte und Befehle, das Gate, das den Erfolg beweist, und was sich je nach Edition und Auslieferungsform ändert.
  • 2.28Ihre Erweiterung veröffentlichenWie ein Plugin oder Pack von einem erfolgreichen Build zu den Einheiten gelangt, auf denen es läuft, und wie es wieder entfernt wird. Versionen, Release-Überprüfung, Kanäle und Installationen, Signierung, Änderungsfreigaben, der Delivery-Identity-Datensatz, Migrationen, Rollback und das Stilllegen einer Version.

Anhänge: Referenz

Herunterladen

Die PDFs sind auf Englisch.