Logga inBoka en genomgång
Support
Version 1.0.0-alpha.1senaste

Dokumentation

Dokumentation för Adverant Nexus

Utgåva 1.0.0-alpha.1. Börja med Del 1 om du är ny i Nexus; Del 2 är till för dem som installerar och kör det.

Del 1: För alla

  • 1.1Vad Nexus är och vem det är till förVad Adverant Nexus gör för en organisation, vem det är byggt för och hur dess delar hänger ihop, förklarat på ett enkelt språk med Harrow Port Authority som exempel. Det avslutas med de tre utgåvorna sammanfattade i ett stycke.
  • 1.2En arbetsdag med NexusEn arbetsdag hos Harrow Port Authority, från den första blicken på Idag till det sista godkännandet, som visar vad medarbetare faktiskt gör i Nexus och var varje typ av arbete hör hemma.
  • 1.3Er organisation, dess medarbetare och vad som förblir privatHur Nexus modellerar en organisation och de roller som medarbetarna har, vem som får köpa och göra anspråk via Adverant-kontot samt gränsen mellan vad administratörer kan se och vad som förblir privat för varje person.
  • 1.4AI på era villkorHur Nexus använder artificiell intelligens (AI) på organisationens egna villkor. Organisationen tar med och äger sina modellnycklar, en växel dirigerar varje modellanrop till de leverantörer den har valt, lokala modeller körs på dess egna servrar och ingenting skickas till Adverant bakom ryggen på den.
  • 1.5Tillit och efterlevnadDe delar av Nexus där en efterlevnadsansvarig arbetar dagligen. Avsnittet behandlar revisionsloggen och förseglade poster, godkännanden som kräver en andra person samt beslut från artificiell intelligens (AI) som väntar på granskning. Det avslutas med begäranden om personuppgifter och de efterlevnadssidor som håller underlag redo innan en revisor frågar.
  • 1.6Utgåvor och licenser på enkelt språkDe tre utgåvorna av Nexus samt de 19 tilläggen och domänpaketen ovanpå dessa, följt av hur en licens fungerar för ett företag. Avsnittet täcker offlinekontrollen och vad varje licensstatus innebär i praktiken, de löften som varje licens håller samt hur man går från Community till Enterprise utan att installera om.
  • 1.7Domänpaket och branschlösningarVad ett domänpaket tillför Nexus för en viss bransch, de tio paket som Adverant erbjuder, hur ett paket aktiveras för en enhet och vad ett paket kräver i er licens.
  • 1.8Var Nexus körsPlatserna där Nexus kan köras, från Adverants EU-moln till en anläggning utan internet och enheter ute i fält, vad suveränitet innebär i praktiken och hur ni väljer rätt.
  • 1.9Kom igångDe två besluten innan ni börjar, vad ert IT-team gör, den första körningen som den första administratören ser den och en checklista över vad som bör finnas redo dag ett.
  • 1.10Borta från skrivbordetAtt använda Nexus på en telefon, från konsolens mobillayout i alla utgåvor till de inbyggda apparna för iPhone och Android. Täcker vad som fungerar utan täckning och hur ett företag hanterar telefonerna.
  • 1.11Gör det till ert egetSätten på vilka en organisation formar Nexus, från en enskild inställning till en egen branschlösning. Även hur ni instruerar utvecklare eller en partner samt vad plattformen garanterar oavsett vad som byggs.
  • 1.12Vanliga frågorTydliga svar på de frågor som inköpare, chefer och dataskyddsombud oftast ställer, inklusive de obekväma frågorna om pengar och åtkomst till era data.

Del 2: För IT, DevOps och utvecklare

  • 2.1ArkitekturVad varje tjänst i Nexus-chartet äger och vilka datalager som ligger under den, följt av reglerna som håller ihop dem, från identitet mellan tjänster till vägen som varje modellanrop tar.
  • 2.2Utgåvor under huvenHur Community och Enterprise byggs från en och samma produkt, hur en licens aktiverar funktionsgrupper under körning, vad en Community-installation visar för en Enterprise-sida samt vad det innebär för de avbildningar ni hämtar och de tillägg ni bygger.
  • 2.3Planera en installationVad en Kubernetes-installation av Nexus kräver innan ni skriver ett kommando, hur stor den är och de två beslut ni inte kan ångra: installationsnamnet och nyckelförvaltarna. Avsnittet avslutas med Harrow Port Authoritys ifyllda planeringsblad.
  • 2.4Hämta och verifiera en utgåvaVar varje del av en Nexus-utgåva finns, hur Enterprise-avbildningar hämtas med en pull-token och hur ni offline bevisar att varje avbildning, chart och nedladdning kommer oförändrad från Adverant innan ni installerar något.
  • 2.5Förkontroll med nexusctlVarje kontroll som `nexusctl preflight` utför, vad var och en läser och hur den kan misslyckas, rapporten som skrivs ut och sparas, hur den rapporten når konsolens sida för förkontroll samt varje flagga.
  • 2.6Installera Community på KubernetesEn steg-för-steg-installation av Community-utgåvan med Helm, från cert-manager till att varje workload är redo, med values-filen förklarad nyckel för nyckel, varför --wait inte används, i vilken ordning chartets hooks körs samt installationsvägen via nexusctl som ett alternativ.
  • 2.7Installera Enterprise och tillämpa en licensVad som ändras när ni installerar Enterprise-utgåvan, hur ni begär en licens från ert Adverant-konto, de tre sätten att importera den med alla avvisningskoder och hur Harrow Port Authority flyttade sin Community-pilot till Enterprise på plats utan att förlora något.
  • 2.8Installationer på en enskild maskinInstallera Nexus på en Linux-server med nexusctl, eller utvärdera det på en bärbar dator med k3d, och nå konsolen via HTTPS så att inloggning och nycklar (passkeys) fungerar.
  • 2.9Installationsprogrammets skivavbildningStarta en tom server eller en virtuell maskin från Nexus-installationsavbildningen så installerar den operativsystemet, k3s, cert-manager och Nexus utan nätverk, och kontrollerar varje fil innan den används.
  • 2.10Luftgapad installationBär med ett signerat offlinepaket till en plats utan internet, verifiera det mot en nyckel som ni tagit med separat, läs in det i ert eget register och installera. Licenser, uppdateringar och spärrlistor korsar också gapet manuellt.
  • 2.11Variationer: externa lagringar, TLS och ingressVärdena som anpassar Nexus till ett kluster som inte är tomt, inklusive TLS (Transport Layer Security), tillsammans med databaser ni redan kör, era egna certifikat, en annan ingress-styrenhet, lagringsklasser, e-post, proxyservrar, repliker och hanterad Kubernetes.
  • 2.12Den första körningenFrån en oanspråkad installation till människor i arbete. Skapa anspråkskoden, gör anspråk på installationen i en webbläsare, skapa den första administratören med en nyckel (passkey), anslut sedan företagsinloggning och bjud in alla andra.
  • 2.13LicenserVad en Nexus-licensfil innehåller, hur installationen kontrollerar den offline, de sex tillstånd den kan befinna sig i samt hur ni begär, importerar, förnyar och återkallar en licens.
  • 2.14AI-leverantörer och modellerHur routern för leverantörer av artificiell intelligens (AI) väljer en modell från organisationens egen nyckelpool, och hur skript och AI-verktyg når Nexus utifrån.
  • 2.15Dag två: driva NexusRutinarbetet med att köra en installation efter den första veckan. Det börjar med att låsa upp nyckellagret efter en omstart och slutar med avinstallation.
  • 2.16Säkerhet och nätverkVad en installation släpper in och ut, hur dess tjänster bevisar vilka de är för varandra och de kontroller en operatör ställer in eller ärver för inloggning och databasen.
  • 2.17FelsökningDe problem operatörer oftast stöter på, organiserade efter vad ni ser. Varje problem anger orsaken, kommandot som bekräftar det och lösningen, och kapitlet avslutas med att skicka ett supportpaket.
  • 2.18TilläggsmodellenDe sex sätten att utöka Nexus, från en inställning till ett domänpaket, gränserna för vart och ett samt hur förtroende- och isoleringsnivåer avgör var er kod körs. Läs detta innan ni öppnar programutvecklingspaketet (SDK).
  • 2.19Reglerna som varje tillägg ärverIsolering på tre axlar, beräkning genom UNO, AI (artificiell intelligens) genom routern, organisationsägda nycklar och licenskontroller. Vad varje regel betyder för er kod och vilken grind som upprätthåller den, och varför ni ärver den i stället för att skriva den.
  • 2.20FärdigheterHur man skriver, testar och publicerar en Skills Engine-färdighet, var den visas när den är i drift och hur manifestfärdigheter i ett insticksprogram skiljer sig åt. Inkluderar en genomarbetad sammanfattning av kajplatstilldelning för Harrow Port Authority.
  • 2.21Plugin SDKInstallera Plugin SDK (programutvecklingspaket), dess kommandoradsverktyg, en genomgång av fullservicemallen, v2-manifestet fält för fält och de tjugotvå grindarna som ser till att ett insticksprogram följer reglerna.
  • 2.22Körtidsmiljön för insticksprogramSDK-modulerna (programutvecklingspaket) som ert insticksprogram körs på, från räckviddsvakten och databasstaketet till UNO-utskick, läsning av rutten för AI (artificiell intelligens) och licenskontroller. Därefter testning mot en riktig databas, registrering av era färdigheter och introduktion.
  • 2.23DomänpaketVad ett domänpaket består av och vad dess pack.json anger; linser och linsregistret; kunskapsmodeller, anslutningar och mobila överlägg; hur ett paket licensieras och aktiveras för en enhet; samt de tio paket som Adverant levererar.
  • 2.24Bygga en anpassad vertikal från grundenEtt genomarbetat bygge av domänpaketet för kylkedja, från den första kravspecifikationen till en driftsatt utgåva för varje enhet, med dess kunskapsmodell, linser, en färdighet, ett komplett tjänsteinsticksprogram och exempeldata. Därefter hur man utökar ett befintligt paket och hur man lägger till en lins i ett paket som redan har levererats.
  • 2.25Bygga för varje utgåvaVad som ändras när ett tillägg måste fungera i varje utgåva, på en luftgapad plats, på en Nexus Edge-nyttolast eller bakom en kunds eget varumärke. Omfattar licensgränsen för Enterprise-moduler och signerad offlineleverans, med en matris över vad som ska göras annorlunda för varje mål.
  • 2.26Bygga med AI-kodningsverktygHur du bygger Nexus-tillägg säkert med Claude Code och andra kodningsverktyg för AI (artificiell intelligens). Det börjar med att ansluta din IDE (integrerad utvecklingsmiljö) till Workbench och en projektfil (CLAUDE.md) som bär plattformsreglerna, och avslutas med sex genomarbetade prompter och den kontrollpunkt som verifierar var och en.
  • 2.27ByggscenarierEn kokbok med tretton byggen, från en enskild färdighet till en luftgapad leverans. Varje recept anger målet, byggstenarna, stegen och kommandona, den kontrollpunkt som bevisar att det fungerade samt vad som ändras beroende på utgåva och leveransform.
  • 2.28Släppa ditt tilläggHur ett insticksprogram eller paket går från ett godkänt bygge till de enheter som kör det, och hur det tas bort igen. Versioner, utgivningsgranskning, kanaler och installationer, signering, ändringsgodkännanden, posten för leveransidentitet, migreringar, återställning och avveckling av en version.

Bilagor: Referens

Ladda ner

PDF-filerna är på engelska.