Brukerstøtte
Versjon 1.0.0-alpha.1nyeste
Dokumentasjon
Adverant Nexus-dokumentasjon
Utgivelse 1.0.0-alpha.1. Start med del 1 hvis du ikke kjenner Nexus fra før; del 2 er for dem som installerer og kjører systemet.
Utforsk kartet over kunnskapsmodellenDen delte kjernen og hver domenepakke, med tilhørende linser, moduler og relasjoner.
Del 1: For alle
- 1.1Hva Nexus er, og hvem det er forHva Adverant Nexus gjør for en organisasjon, hvem det er bygget for, og hvordan delene henger sammen, forklart i klarspråk med Harrow Port Authority som eksempel. Det avsluttes med de tre utgavene i ett avsnitt.
- 1.2En arbeidsdag med NexusÉn arbeidsdag hos Harrow Port Authority, fra det første blikket på I dag til den siste godkjenningen, som viser hva folk faktisk gjør i Nexus og hvor hver type arbeid hører hjemme.
- 1.3Organisasjonen, menneskene i den, og hva som forblir privatHvordan Nexus modellerer en organisasjon og rollene menneskene i den har, hvem som kan kjøpe og gjøre krav på Adverant-kontoen, og grensen mellom hva administratorer kan se og hva som forblir privat for hver enkelt.
- 1.4KI på dine premisserHvordan Nexus bruker kunstig intelligens (KI) på organisasjonens egne premisser. Organisasjonen tar med og eier sine egne modellnøkler, ett sentralbord ruter hvert modellkall til leverandørene den har valgt, lokale modeller kjører på dens egne servere, og ingenting sendes til Adverant bak ryggen på den.
- 1.5Tillit og etterlevelseDelene av Nexus en etterlevelsesansvarlig arbeider i. Dette dekker revisjonsloggen og forseglede oppføringer, godkjenninger som krever en person til, og beslutninger tatt av kunstig intelligens (KI) som venter på gjennomgang. Det avsluttes med forespørsler om personopplysninger og etterlevelsessidene som holder dokumentasjonen klar før en revisor spør.
- 1.6Utgaver og lisenser i klarspråkDe tre utgavene av Nexus samt de 19 tilleggene og domenepakkene på toppen, og deretter hvordan en lisens fungerer for en bedrift. Det dekker frakoblet kontroll og hva hver lisenstilstand betyr i praksis, løftene hver lisens holder, og overgangen fra Community til Enterprise uten å installere på nytt.
- 1.7Domenepakker og bransjeløsningerHva en domenepakke legger til i Nexus for én bransje, de ti pakkene Adverant tilbyr, hvordan en pakke slås på for én enhet, og hva en pakke krever i lisensen din.
- 1.8Hvor Nexus kjørerStedene Nexus kan kjøre, fra Adverants EU-sky til et anlegg uten internett og enheter i felten, hva suverenitet betyr i praksis, og hvordan man velger.
- 1.9Kom i gangDe to beslutningene før du starter, hva IT-teamet ditt gjør, den første kjøringen slik den første administratoren ser den, og en sjekkliste over hva som bør være klart på dag én.
- 1.10Borte fra skrivebordetBruk av Nexus på telefon, fra konsollens telefonvisning i hver utgave til de egne appene for iPhone og Android. Dekker hva som fungerer uten dekning og hvordan en bedrift administrerer telefonene.
- 1.11Gjør det til ditt egetMåtene en organisasjon former Nexus på, fra en enkelt innstilling til en egen bransjeløsning. Også hvordan man gir oppdrag til utviklere eller en partner, og hva plattformen garanterer uansett hva som bygges.
- 1.12Spørsmål folk stillerKlare svar på spørsmålene innkjøpere, ledere og personvernombud stiller oftest, inkludert de ubehagelige om penger og tilgang til dataene dine.
Del 2: For IT, DevOps og utviklere
- 2.1ArkitekturHva hver tjeneste i Nexus-chartet eier og hvilke datalagre som ligger under den, samt reglene som holder dem sammen, fra identitet mellom tjenester til veien hvert modellkall tar.
- 2.2Utgaver under panseretHvordan Community og Enterprise bygges fra ett produkt, hvordan en lisens slår på funksjonsgrupper under kjøring, hva en Community-installasjon viser for en Enterprise-side, og hva det betyr for avbildningene du henter og utvidelsene du bygger.
- 2.3Planlegge en installasjonHva en Kubernetes-installasjon av Nexus krever før du skriver en kommando, hvor stor den er, og de to beslutningene du ikke kan omgjøre: installasjonsnavnet og nøkkelforvalterne. Det avsluttes med det utfylte planleggingsskjemaet til Harrow Port Authority.
- 2.4Hente og verifisere en utgivelseHvor hver del av en Nexus-utgivelse ligger, hvordan Enterprise-avbildninger hentes med et pull-token, og hvordan du beviser at hver avbildning, hvert chart og hver nedlasting kom uendret fra Adverant, frakoblet, før du installerer noe.
- 2.5Forhåndskontroll med nexusctlHver kontroll `nexusctl preflight` utfører, hva hver enkelt leser og hvordan den feiler, rapporten den skriver ut og lagrer, hvordan denne rapporten når forhåndskontrollsiden i konsollen, og hvert flagg.
- 2.6Installere Community på KubernetesEn nummerert installasjon av Community-utgaven med Helm, fra cert-manager til hver arbeidsbelastning er klar, med verdifilen forklart nøkkel for nøkkel, hvorfor det ikke brukes --wait, rekkefølgen chartets hooks kjører i, og installasjonsveien med nexusctl som et alternativ.
- 2.7Installere Enterprise og legge inn en lisensHva som endres når du installerer Enterprise-utgaven, hvordan du ber om en lisens fra Adverant-kontoen din, de tre måtene å importere den på med hver avvisningskode, og hvordan Harrow Port Authority oppgraderte sin Community-pilot til Enterprise på stedet uten å miste noe.
- 2.8Installasjoner på én maskinInstaller Nexus på én Linux-server med nexusctl, eller evaluer det på en bærbar PC med k3d, og nå konsollen over HTTPS slik at pålogging og passnøkler fungerer.
- 2.9Diskavbildningen for installasjonsprogrammetStart opp en tom server eller en virtuell maskin fra installasjonsavbildningen for Nexus, så installerer den operativsystemet, k3s, cert-manager og Nexus uten nettverk, og kontrollerer hver fil før den brukes.
- 2.10Luftgap-installasjonTa med en signert frakoblet pakke inn til et anlegg uten internett, bekreft den mot en nøkkel du har tatt med separat, last den inn i ditt eget register og installer. Lisenser, oppdateringer og tilbakekallingslister krysser også gapet manuelt.
- 2.11Variasjoner: eksterne lagre, TLS og ingressVerdiene som tilpasser Nexus til en klynge som ikke er tom, inkludert TLS (Transport Layer Security), sammen med databaser du allerede kjører, dine egne sertifikater, en annen ingress-kontroller, lagringsklasser, e-post, proxyer, replikaer og administrert Kubernetes.
- 2.12Første oppstartFra en uregistrert installasjon til ansatte i arbeid. Lag kravkoden, gjør krav på installasjonen i en nettleser, opprett den første administratoren med en passnøkkel, koble deretter til bedriftspålogging og inviter alle andre.
- 2.13LisenserHva en Nexus-lisensfil inneholder, hvordan installasjonen kontrollerer den frakoblet, de seks tilstandene den kan være i, og hvordan du ber om, importerer, fornyer og trekker tilbake en lisens.
- 2.14KI-leverandører og modellerHvordan leverandørruteren for kunstig intelligens (KI) velger en modell fra organisasjonens egen nøkkelpulje, og hvordan skript og KI-verktøy når Nexus utenfra.
- 2.15Dag to: drift av NexusDet rutinemessige arbeidet med å drifte en installasjon etter den første uken. Det starter med å låse opp nøkkellageret etter en omstart og slutter med avinstallering.
- 2.16Sikkerhet og nettverkHva en installasjon slipper inn og ut, hvordan tjenestene beviser hvem de er overfor hverandre, og kontrollene en operatør angir eller arver for pålogging og databasen.
- 2.17FeilsøkingProblemene operatører oftest møter, organisert etter hva du ser. Hvert tilfelle oppgir årsaken, kommandoen som bekrefter den og løsningen, og kapittelet avsluttes med å sende en støttepakke.
- 2.18UtvidelsesmodellenDe seks måtene å utvide Nexus på, fra en innstilling til en domenepakke, grensene for hver av dem, og hvordan tillits- og isolasjonsnivåer avgjør hvor koden din kjører. Les dette før du åpner programvareutviklingssettet (SDK).
- 2.19Reglene hver utvidelse arverIsolasjon på tre akser, beregning gjennom UNO, KI (kunstig intelligens) gjennom ruteren, organisasjonseide nøkler og lisenskontroller. Hva hver regel betyr for koden din og hvilken port som håndhever den, og hvorfor du arver den i stedet for å skrive den.
- 2.20FerdigheterHvordan du skriver, tester og publiserer en ferdighet i Skills Engine, hvor den dukker opp når den er i bruk, og hvordan manifestferdigheter i et programtillegg skiller seg ut. Inkluderer et gjennomarbeidet sammendrag av kaiplasstildeling for Harrow Port Authority.
- 2.21Plugin SDKInstallere Plugin SDK (programvareutviklingssett), kommandolinjeverktøyene, en gjennomgang av fullservicemalen, v2-manifestet felt for felt, og de tjueto portene som sikrer at et programtillegg følger reglene.
- 2.22Kjøremiljøet for programtilleggSDK-modulene (programvareutviklingssett) som programtillegget ditt kjører på, fra omfangsvakten og databasegjerdet til UNO-utsendelse, avlesning av KI-ruten (kunstig intelligens) og lisenskontroller. Deretter testing mot en ekte database, registrering av ferdighetene dine og klargjøring.
- 2.23DomenepakkerHva en domenepakke består av og hva pack.json sier; linser og linseregisteret; kunnskapsmodeller, koblinger og mobiloverlegg; hvordan en pakke lisensieres og slås på for en enhet; og de ti pakkene Adverant leverer.
- 2.24Bygge en tilpasset vertikal fra start til sluttEn gjennomarbeidet bygging av domenepakken Cold chain, fra den første spesifikasjonen til en utgivelse som kjører for hver enhet, med dens kunnskapsmodell, linser, en ferdighet, en fullservice-plugin og eksempeldata. Deretter hvordan du utvider en pakke som allerede finnes, og hvordan du legger til en linse i en som allerede er levert.
- 2.25Bygge for hver utgaveHva som endres når én utvidelse må fungere i hver utgave, på et luftgapet anlegg, på en Nexus Edge-nyttelast eller bak en kundes eget merke. Dekker lisensgrensen for Enterprise-moduler og signert frakoblet levering, med en matrise over hva som må gjøres annerledes for hvert mål.
- 2.26Bygge med KI-kodeverktøyHvordan bygge Nexus-utvidelser trygt med Claude Code og andre kodeverktøy med KI (kunstig intelligens). Det starter med å koble ditt IDE (integrert utviklingsmiljø) til Workbench og en prosjektfil kalt CLAUDE.md som bærer plattformreglene, og avsluttes med seks gjennomarbeidede ledetekster og kontrollpunktet som beviser hver enkelt.
- 2.27ByggescenarioerEn kokebok med tretten bygg, fra én enkelt ferdighet til en luftgapet levering. Hver oppskrift gir målet, byggeklossene, trinnene og kommandoene, kontrollpunktet som beviser at det fungerte, og hva som endres etter utgave og leveringsform.
- 2.28Utgi utvidelsen dinHvordan en plugin eller pakke går fra et grønt bygg til enhetene som kjører den, og hvordan den tas ut igjen. Versjoner, utgivelsesgjennomgang, kanaler og installasjoner, signering, endringsgodkjenninger, oppføringen for leveringsidentitet, migreringer, tilbakerulling og utfasing av en versjon.
Vedlegg: Referanse
- AVedlegg A: Referanse for Helm-verdierHver nøkkel som Nexus-chartet godtar, dens type, dens tillatte verdier og dens standardverdi.
- BVedlegg B: UtgavematriseHvilken utgave, hvilket tillegg eller hvilken domenepakke som inkluderer hver kapabilitet.
- CVedlegg C: FeilkoderHver avvisningskode en operatør eller utvikler møter, hva den betyr og hva man skal gjøre.
- DVedlegg D: Tjenester og porterHver tjeneste chartet kjører, dens porter og verdinøkkelen som konfigurerer den.
- EVedlegg E: OrdlisteBegrepene som brukes i begge deler, forklart med enkle ord.
- FVedlegg F: Arkitektur i korte trekkHele plattformen, den åpne kjernen og hva som er lisensiert på toppen av den, hver måte å kjøre Nexus på, og hver av de ti domenepakkene, med ett diagram hver.
- GVedlegg G: Dataordbok og kunnskapsmodellerFeltene på hver post, og hva hver domenepakke er bygget opp av.
Last ned
- Part 1, for everyone (PDF) (åpnes i en ny fane) 18 MB
- Part 2, technical, with the appendices (PDF) (åpnes i en ny fane) 40 MB
PDF-ene er på engelsk.