Ondersteuning
Versie 1.0.0-alpha.1nieuwste
Documentatie
Adverant Nexus-documentatie
Release 1.0.0-alpha.1. Begin met Deel 1 als u nieuw bent bij Nexus; Deel 2 is voor de mensen die het installeren en beheren.
Verken de kaart van het kennismodelDe gedeelde kern en elk domeinpakket, met hun lenzen, modules en relaties.
Deel 1: Voor iedereen
- 1.1Wat Nexus is en voor wie het isWat Adverant Nexus voor een organisatie doet, voor wie het is gebouwd en hoe de onderdelen op elkaar aansluiten, in gewone taal uitgelegd met Harrow Port Authority als voorbeeld. Het sluit af met de drie edities in één alinea.
- 1.2Een werkdag met NexusEén werkdag bij Harrow Port Authority, van de eerste blik op Vandaag tot de laatste goedkeuring, waarin te zien is wat mensen daadwerkelijk doen in Nexus en waar elk soort werk thuishoort.
- 1.3Uw organisatie, haar mensen en wat privé blijftHoe Nexus een organisatie en de rollen van haar mensen modelleert, wie mag inkopen en claimen op het Adverant-account, en de grens tussen wat beheerders kunnen zien en wat privé blijft voor elke persoon.
- 1.4AI op uw voorwaardenHoe Nexus kunstmatige intelligentie (AI) gebruikt op de eigen voorwaarden van de organisatie. De organisatie neemt haar eigen modelsleutels mee en bezit deze, één schakelbord routeert elke modelaanroep naar de providers die zij heeft gekozen, lokale modellen draaien op haar eigen servers, en er wordt niets achter haar rug om naar Adverant gestuurd.
- 1.5Vertrouwen en complianceDe onderdelen van Nexus waarin een compliance officer werkt. Het behandelt het auditlogboek en verzegelde records, goedkeuringen waarvoor een tweede persoon nodig is en beslissingen van kunstmatige intelligentie (AI) die wachten op beoordeling. Het sluit af met verzoeken rond persoonsgegevens en de compliancepagina's die bewijsmateriaal klaarhouden voordat een auditor erom vraagt.
- 1.6Edities en licenties in gewone taalDe drie edities van Nexus en de 19 add-ons en domeinpakketten daarbovenop, gevolgd door hoe een licentie voor een bedrijf werkt. Het behandelt de offline controle en wat elke licentiestatus in de praktijk betekent, de beloften die elke licentie nakomt, en het overstappen van Community naar Enterprise zonder opnieuw te installeren.
- 1.7Domeinpakketten en verticale oplossingenWat een domeinpakket toevoegt aan Nexus voor één sector, de tien pakketten die Adverant aanbiedt, hoe een pakket voor één onderdeel wordt ingeschakeld en wat een pakket nodig heeft in uw licentie.
- 1.8Waar Nexus draaitDe plekken waar Nexus kan draaien, van de EU-cloud van Adverant tot een locatie zonder internet en apparaten in het veld, wat soevereiniteit in de praktijk betekent en hoe u kiest.
- 1.9Aan de slagDe twee beslissingen voordat u begint, wat uw IT-team doet, de eerste ingebruikname zoals de eerste beheerder die ziet, en een checklist van wat u op dag één klaar moet hebben.
- 1.10Niet op uw werkplekNexus gebruiken op een telefoon, van de telefoonweergave van de console in elke editie tot de native iPhone- en Android-apps. Behandelt wat werkt zonder bereik en hoe een bedrijf de telefoons beheert.
- 1.11Het naar uw hand zettenDe manieren waarop een organisatie Nexus vormgeeft, van een enkele instelling tot een eigen verticale oplossing. Ook hoe u ontwikkelaars of een partner brieft, en wat het platform garandeert, ongeacht wat er wordt gebouwd.
- 1.12Vragen die mensen stellenDuidelijke antwoorden op de vragen die inkopers, managers en functionarissen voor gegevensbescherming het vaakst stellen, inclusief de ongemakkelijke vragen over geld en toegang tot uw gegevens.
Deel 2: Voor IT, DevOps en ontwikkelaars
- 2.1ArchitectuurWaar elke service in de Nexus-chart eigenaar van is en welke gegevensopslag eronder ligt, gevolgd door de regels die ze samenhouden, van identiteit tussen services tot het pad dat elke modelaanroep aflegt.
- 2.2Edities onder de motorkapHoe Community en Enterprise uit één product worden gebouwd, hoe een licentie functiegroepen tijdens het draaien inschakelt, wat een Community-installatie toont voor een Enterprise-pagina, en wat dat betekent voor de images die u ophaalt en de extensies die u bouwt.
- 2.3Een installatie plannenWat een Kubernetes-installatie van Nexus nodig heeft voordat u een commando typt, hoe groot deze is, en de twee beslissingen die u niet kunt terugdraaien: de installatienaam en de sleutelbewaarders. Het sluit af met het ingevulde planningswerkblad van Harrow Port Authority.
- 2.4Een release ophalen en verifiërenWaar elk onderdeel van een Nexus-release staat, hoe Enterprise-images worden opgehaald met een pull-token, en hoe u offline bewijst dat elke image, chart en download ongewijzigd van Adverant afkomstig is, voordat u iets installeert.
- 2.5Preflight met nexusctlElke controle die `nexusctl preflight` uitvoert, wat elke controle leest en hoe deze faalt, het rapport dat wordt afgedrukt en opgeslagen, hoe dat rapport de preflight-pagina van de console bereikt, en elke vlag.
- 2.6Community installeren op KubernetesEen genummerde installatie van de Community-editie met Helm, van cert-manager tot het gereed zijn van elke workload, met het values-bestand sleutel voor sleutel uitgelegd, waarom er geen --wait is, de volgorde waarin de hooks van de chart worden uitgevoerd, en de installatieroute met nexusctl als alternatief.
- 2.7Enterprise installeren en een licentie toepassenWat er verandert wanneer u de Enterprise-editie installeert, hoe u een licentie aanvraagt vanuit uw Adverant-account, de drie manieren om deze te importeren met elke weigeringscode, en hoe Harrow Port Authority zijn Community-pilot ter plekke naar Enterprise heeft overgezet zonder iets te verliezen.
- 2.8Installaties op één machineInstalleer Nexus op één Linux-server met nexusctl, of evalueer het op een laptop met k3d, en bereik de console via HTTPS zodat aanmelden en passkeys werken.
- 2.9De schijfimage van het installatieprogrammaStart een kale server of een virtuele machine op vanaf de Nexus-installatie-image en deze installeert het besturingssysteem, k3s, cert-manager en Nexus zonder netwerk, waarbij elk bestand wordt gecontroleerd voordat het wordt gebruikt.
- 2.10Air-gapped installatieNeem een ondertekende offline bundel mee naar een locatie zonder internet, verifieer deze aan de hand van een sleutel die u afzonderlijk hebt meegebracht, laad deze in uw eigen registry en installeer. Licenties, updates en intrekkingslijsten overbruggen de scheiding eveneens handmatig.
- 2.11Variaties: externe opslag, TLS en ingressDe waarden waarmee u Nexus aanpast aan een cluster dat niet leeg is, inclusief TLS (Transport Layer Security), samen met databases die u al draait, uw eigen certificaten, een andere ingress-controller, opslagklassen, e-mail, proxy's, replica's en beheerde Kubernetes.
- 2.12De eerste ingebruiknameVan een niet-geclaimde installatie naar mensen aan het werk. Maak de claimcode aan, claim de installatie in een browser, maak de eerste beheerder aan met een passkey, koppel vervolgens de bedrijfsaanmelding en nodig alle anderen uit.
- 2.13LicentiesWat een Nexus-licentiebestand bevat, hoe de installatie het offline controleert, de zes statussen waarin het zich kan bevinden, en hoe u er een aanvraagt, importeert, verlengt en intrekt.
- 2.14AI-providers en modellenHoe de Provider Router voor kunstmatige intelligentie (AI) een model kiest uit de eigen sleutelpool van de organisatie, en hoe scripts en AI-tools Nexus van buitenaf bereiken.
- 2.15Dag twee: Nexus beherenHet routinewerk van het beheren van een installatie na de eerste week. Het begint met het ontgrendelen van de sleutelkluis na een herstart en eindigt met het verwijderen van de installatie.
- 2.16Beveiliging en netwerkenWat een installatie binnenlaat en naar buiten stuurt, hoe haar services aan elkaar bewijzen wie ze zijn, en de beheersmaatregelen die een beheerder instelt of overneemt voor aanmelding en de database.
- 2.17ProbleemoplossingDe problemen die beheerders het vaakst tegenkomen, geordend op wat u ziet. Bij elk probleem vindt u de oorzaak, het commando dat dit bevestigt en de oplossing, en het hoofdstuk sluit af met het versturen van een ondersteuningsbundel.
- 2.18Het extensiemodelDe zes manieren om Nexus uit te breiden, van een instelling tot een domeinpakket, de grenzen van elk daarvan, en hoe vertrouwens- en isolatieniveaus bepalen waar uw code draait. Lees dit voordat u de software development kit (SDK) opent.
- 2.19De regels die elke extensie overneemtIsolatie op drie assen, rekenkracht via UNO, AI (kunstmatige intelligentie) via de router, sleutels in eigendom van de organisatie en licentiecontroles. Wat elke regel betekent voor uw code en welke poort deze afdwingt, en waarom u deze overneemt in plaats van zelf schrijft.
- 2.20VaardighedenHoe u een Skills Engine-vaardigheid schrijft, test en publiceert, waar deze verschijnt zodra deze live is, en waarin manifestvaardigheden in een plug-in verschillen. Bevat een uitgewerkt overzicht voor ligplaatstoewezing voor Harrow Port Authority.
- 2.21De Plugin SDKHet installeren van de Plugin SDK (software development kit), de opdrachtregelprogramma's, een rondleiding door de full-service-sjabloon, het v2-manifest veld voor veld, en de tweeëntwintig poorten die een plug-in aan de regels houden.
- 2.22De plug-in-runtimeDe SDK-modules (software development kit) waarop uw plug-in draait, van de scopebewaker en de database-omheining tot UNO-verzending, het uitlezen van de AI-route (kunstmatige intelligentie) en licentiecontroles. Vervolgens testen tegen een echte database, het registreren van uw vaardigheden en onboarding.
- 2.23DomeinpakkettenWaaruit een domeinpakket bestaat en wat er in het bijbehorende pack.json-bestand staat; lenzen en het lensregister; kennismodellen, connectoren en mobiele overlays; hoe een pakket wordt gelicentieerd en ingeschakeld voor een eenheid; en de tien pakketten die Adverant levert.
- 2.24Een aangepaste verticale oplossing van begin tot eind bouwenEen uitgewerkte opbouw van het domeinpakket Cold chain, van de eerste briefing tot een release die voor elke eenheid draait, met het bijbehorende kennismodel, lenzen, een vaardigheid, een full-service-plug-in en voorbeeldgegevens. Vervolgens hoe u een reeds bestaand pakket uitbreidt en hoe u een lens toevoegt aan een pakket dat al is geleverd.
- 2.25Bouwen voor elke editieWat er verandert wanneer één extensie moet werken in elke editie, op een air-gapped locatie, op een Nexus Edge-payload of achter het eigen merk van een klant. Behandelt de licentiegrens voor Enterprise-modules en ondertekende offline levering, met een matrix van wat u voor elk doel anders moet doen.
- 2.26Bouwen met AI-codeertoolsHoe u veilig Nexus-extensies bouwt met Claude Code en andere AI-codeerhulpmiddelen (kunstmatige intelligentie). Het begint met het verbinden van uw IDE (integrated development environment) met de Workbench en een projectspecifiek CLAUDE.md-bestand dat de platformregels bevat, en eindigt met zes uitgewerkte prompts en de poort die elk ervan bewijst.
- 2.27Bouwscenario'sEen kookboek met dertien builds, van een enkele vaardigheid tot een air-gapped levering. Elk recept geeft het doel, de bouwstenen, de stappen en opdrachten, de poort die bewijst dat het heeft gewerkt, en wat er verandert per editie en leveringsvorm.
- 2.28Uw extensie vrijgevenHoe een plug-in of pakket van een geslaagde build naar de eenheden gaat die deze draaien, en hoe deze weer wordt verwijderd. Versies, releasebeoordeling, kanalen en installaties, ondertekening, wijzigingsgoedkeuringen, het identiteitsrecord van de levering, migraties, terugdraaien en het uitfaseren van een versie.
Bijlagen: Referentie
- ABijlage A: Referentie voor Helm-waardenElke sleutel die de Nexus-chart accepteert, het bijbehorende type, de toegestane waarden en de standaardwaarde.
- BBijlage B: EditiematrixWelke editie, add-on of welk domeinpakket elke mogelijkheid bevat.
- CBijlage C: FoutcodesElke weigeringscode die een operator of ontwikkelaar tegenkomt, wat deze betekent en wat u moet doen.
- DBijlage D: Services en poortenElke service die de chart uitvoert, de bijbehorende poorten en de waardesleutel waarmee deze wordt geconfigureerd.
- EBijlage E: WoordenlijstDe termen die in beide delen worden gebruikt, in begrijpelijke taal.
- FBijlage F: Architectuur in één oogopslagHet volledige platform, de open core en wat daarbovenop in licentie wordt gegeven, elke manier om Nexus te draaien, en elk van de tien domeinpakketten, met één diagram per stuk.
- GBijlage G: Gegevenswoordenboek en kennismodellenDe velden op elk record en waaruit elk domeinpakket bestaat.
Downloaden
- Part 1, for everyone (PDF) (opent in een nieuw tabblad) 18 MB
- Part 2, technical, with the appendices (PDF) (opent in een nieuw tabblad) 40 MB
De pdf's zijn in het Engels.