Log indBook en briefing
Support
Version 1.0.0-alpha.1seneste

Dokumentation

Adverant Nexus-dokumentation

Udgivelse 1.0.0-alpha.1. Start med Del 1, hvis du er ny i Nexus; Del 2 er for dem, der installerer og driver det.

Del 1: For alle

  • 1.1Hvad Nexus er, og hvem det er tilHvad Adverant Nexus gør for en organisation, hvem det er bygget til, og hvordan delene hænger sammen, fortalt i et ligefremt sprog med Harrow Port Authority som eksempel. Det slutter med de tre udgaver i ét afsnit.
  • 1.2En arbejdsdag med NexusÉn arbejdsdag hos Harrow Port Authority, fra det første kig på I dag til den sidste godkendelse, som viser, hvad folk faktisk laver i Nexus, og hvor hver type arbejde hører hjemme.
  • 1.3Din organisation, dens medarbejdere, og hvad der forbliver privatHvordan Nexus modellerer en organisation og de roller, dens medarbejdere har, hvem der må købe og gøre krav på Adverant-kontoen, samt grænsen mellem, hvad administratorer kan se, og hvad der forbliver privat for den enkelte.
  • 1.4AI på dine egne vilkårHvordan Nexus bruger kunstig intelligens (AI) på organisationens egne vilkår. Organisationen medbringer og ejer sine modelnøgler, ét omstillingsbord dirigerer hvert modelkald til udbydere, den selv har valgt, lokale modeller kører på dens egne servere, og intet sendes til Adverant bag dens ryg.
  • 1.5Tillid og complianceDe dele af Nexus, en compliance-ansvarlig arbejder i til daglig. Det dækker revisionsloggen og forseglede optegnelser, godkendelser, der kræver en ekstra person, samt beslutninger truffet af kunstig intelligens (AI), der afventer gennemgang. Det slutter med anmodninger om persondata og de compliance-sider, der holder dokumentationen klar, før en revisor spørger.
  • 1.6Udgaver og licenser i et ligefremt sprogDe tre udgaver af Nexus og de 19 tilføjelser og domænepakker oveni, og derefter hvordan en licens fungerer for en virksomhed. Det dækker offline-kontrollen, og hvad hver licenstilstand betyder i praksis, de løfter enhver licens holder, og hvordan man skifter fra Community til Enterprise uden at geninstallere.
  • 1.7Domænepakker og vertikalerHvad en domænepakke føjer til Nexus for en enkelt branche, de ti pakker Adverant tilbyder, hvordan en pakke slås til for en enkelt enhed, og hvad en pakke kræver i din licens.
  • 1.8Hvor Nexus kørerDe steder, Nexus kan køre, fra Adverants EU-cloud til en lokation uden internet og enheder i marken, hvad suverænitet betyder i praksis, og hvordan man vælger.
  • 1.9Kom godt i gangDe to beslutninger før du går i gang, hvad dit IT-team gør, den første opstart som den første administrator ser den, og en tjekliste over, hvad du skal have klar på dag ét.
  • 1.10Væk fra skrivebordetBrug af Nexus på en telefon, fra konsollens telefonlayout i alle udgaver til de dedikerede iPhone- og Android-apps. Dækker, hvad der fungerer uden signal, og hvordan en virksomhed administrerer telefonerne.
  • 1.11Gør det til dit egetDe måder, en organisation former Nexus på, fra en enkelt indstilling til sin helt egen vertikal. Også hvordan man briefer udviklere eller en partner, og hvad platformen garanterer, uanset hvad der bygges.
  • 1.12Spørgsmål, folk stillerLigefremme svar på de spørgsmål, indkøbere, ledere og databeskyttelsesrådgivere oftest stiller, herunder de ubehagelige om penge og adgang til dine data.

Del 2: For IT, DevOps og udviklere

  • 2.1ArkitekturHvad hver tjeneste i Nexus-chartet ejer, og hvilke datalagre der ligger under den, samt de regler, der holder dem sammen, fra identitet mellem tjenester til den vej, hvert modelkald tager.
  • 2.2Udgaver under motorhjelmenHvordan Community og Enterprise bygges ud fra ét produkt, hvordan en licens slår funktionsgrupper til ved kørsel, hvad en Community-installation viser for en Enterprise-side, og hvad det betyder for de images, du henter, og de udvidelser, du bygger.
  • 2.3Planlægning af en installationHvad en Kubernetes-installation af Nexus kræver, før du skriver en kommando, hvor stor den er, og de to beslutninger, du ikke kan gøre om: installationsnavnet og nøgleforvalterne. Det slutter med Harrow Port Authoritys udfyldte planlægningsark.
  • 2.4Hentning og verificering af en udgivelseHvor hver del af en Nexus-udgivelse ligger, hvordan Enterprise-images hentes med et pull-token, og hvordan man beviser, at hvert image, chart og download kom uændret fra Adverant, offline, før du installerer noget.
  • 2.5Forhåndskontrol med nexusctlHver kontrol `nexusctl preflight` foretager, hvad hver enkelt læser, og hvordan den fejler, rapporten den udskriver og gemmer, hvordan den rapport når frem til konsollens side for forhåndskontrol, samt hvert enkelt flag.
  • 2.6Installation af Community på KubernetesEn nummereret installation af Community-udgaven med Helm, fra cert-manager til hver workload er klar, med values-filen forklaret nøgle for nøgle, hvorfor der ikke bruges --wait, rækkefølgen chartets hooks kører i, samt installationsvejen med nexusctl som et alternativ.
  • 2.7Installation af Enterprise og aktivering af en licensHvad der ændrer sig, når De installerer Enterprise-udgaven, hvordan De anmoder om en licens fra Deres Adverant-konto, de tre måder at importere den på med alle afvisningskoder, og hvordan Harrow Port Authority opgraderede sin Community-pilot til Enterprise direkte på stedet uden at miste noget.
  • 2.8Installationer på én maskineInstaller Nexus på én Linux-server med nexusctl, eller evaluer det på en bærbar computer med k3d, og tilgå konsollen via HTTPS, så login og adgangsnøgler fungerer.
  • 2.9InstallationsdiskafbildningenStart en tom server eller en virtuel maskine fra Nexus-installationsafbildningen, og den installerer styresystemet, k3s, cert-manager og Nexus uden netværk, idet hver fil kontrolleres, før den tages i brug.
  • 2.10Air-gap-installationMedbring en signeret offline-pakke til en lokation uden internet, verificer den mod en nøgle, De har medbragt separat, indlæs den i Deres eget register, og installer. Licenser, opdateringer og tilbagekaldelseslister overføres også manuelt på tværs af adskillelsen.
  • 2.11Variationer: eksterne datalagre, TLS og ingressDe værdier, der tilpasser Nexus til en klynge, som ikke er tom, herunder TLS (Transport Layer Security), samt databaser, De allerede driver, Deres egne certifikater, en anden ingress-controller, lagerklasser, e-mail, proxyer, replikaer og administreret Kubernetes.
  • 2.12Første kørselFra en uovertaget installation til medarbejdere i arbejde. Opret overtagelseskoden, overtag installationen i en browser, opret den første administrator med en adgangsnøgle, og tilslut derefter virksomhedslogin og inviter alle andre.
  • 2.13LicenserHvad en Nexus-licensfil indeholder, hvordan installationen kontrollerer den offline, de seks tilstande den kan være i, og hvordan De anmoder om, importerer, fornyer og tilbagekalder en.
  • 2.14AI-udbydere og modellerHvordan udbyderrouteren til kunstig intelligens (AI) vælger en model fra organisationens egen pulje af nøgler, og hvordan scripts og AI-værktøjer tilgår Nexus udefra.
  • 2.15Dag to: drift af NexusDet rutinemæssige arbejde med at drive en installation efter den første uge. Det begynder med at ophæve forseglingen af nøglelageret efter en genstart og slutter med afinstallation.
  • 2.16Sikkerhed og netværkHvad en installation lukker ind og ud, hvordan dens tjenester beviser deres identitet over for hinanden, og de kontroller en operatør indstiller eller arver for login og databasen.
  • 2.17FejlfindingDe problemer operatører oftest møder, organiseret efter hvad De ser. Hvert punkt angiver årsagen, kommandoen der bekræfter den, og løsningen, og kapitlet slutter med afsendelse af en supportpakke.
  • 2.18UdvidelsesmodellenDe seks måder at udvide Nexus på, fra en indstilling til en domænepakke, grænserne for hver enkelt, og hvordan tillids- og isolationsniveauer afgør, hvor Deres kode kører. Læs dette, før De åbner softwareudviklingssættet (SDK).
  • 2.19De regler enhver udvidelse arverIsolation på tre akser, beregning gennem UNO, AI (kunstig intelligens) gennem routeren, organisationsejede nøgler og licenskontroller. Hvad hver regel betyder for Deres kode, hvilken kontrolport der håndhæver den, og hvorfor De arver den i stedet for at skrive den.
  • 2.20FærdighederHvordan man skriver, tester og udgiver en Skills Engine-færdighed, hvor den vises, når den er aktiv, og hvordan manifestfærdigheder i et plugin adskiller sig. Indeholder en gennemarbejdet oversigt over kajpladstildeling for Harrow Port Authority.
  • 2.21Plugin SDK'etInstallation af Plugin SDK'et (softwareudviklingssættet), dets kommandolinjeværktøjer, en gennemgang af skabelonen til fuld tjeneste, v2-manifestet felt for felt og de 22 kontrolporte, der sikrer, at et plugin overholder reglerne.
  • 2.22Plugin-kørselsmiljøetDe SDK-moduler (softwareudviklingssæt), som Deres plugin kører på, fra råderumsvagten og databasehegnet til UNO-afvikling, aflæsning af AI-ruten (kunstig intelligens) og licenskontroller. Derefter test mod en rigtig database, registrering af Deres færdigheder og ibrugtagning.
  • 2.23DomænepakkerHvad en domænepakke består af, og hvad dens pack.json angiver; linser og linseregistret; vidensmodeller, konnektorer og mobile overlejringer; hvordan en pakke licenseres og aktiveres for en enhed; og de ti pakker Adverant leverer.
  • 2.24Byg en skræddersyet vertikal løsning fra start til slutEn gennemarbejdet opbygning af domænepakken til kølekæden (Cold chain), fra det første oplæg til en udgivelse, der kører for hver enhed, med dens vidensmodel, linser, en færdighed, et full-service-plugin og eksempeldata. Derefter gennemgås det, hvordan man udvider en pakke, der allerede findes, og hvordan man tilføjer en linse til en pakke, der er udgivet.
  • 2.25Byg til hver udgaveHvad der ændrer sig, når én udvidelse skal fungere i hver udgave, på et air-gapped anlæg, på en Nexus Edge-payload eller bag en kundes eget brand. Dækker licensgrænsen for Enterprise-moduler og signeret offline-levering med en oversigt over, hvad man skal gøre forskelligt for hvert mål.
  • 2.26Byg med AI-kodeværktøjerSådan bygger I Nexus-udvidelser sikkert med Claude Code og andre AI-kodeværktøjer (kunstig intelligens). Det starter med at forbinde jeres IDE (integreret udviklingsmiljø) til Workbench og en projektfil ved navn CLAUDE.md, der indeholder platformsreglerne, og slutter med seks gennemarbejdede prompts samt den kontrolport, der beviser hver enkelt.
  • 2.27ByggescenarierEn kogebog med tretten builds, fra en enkelt færdighed til en air-gapped levering. Hver opskrift angiver målet, byggestenene, trinene og kommandoerne, kontrolporten, der beviser, at det virkede, og hvad der ændrer sig afhængigt af udgave og leveringsform.
  • 2.28Udgivelse af jeres udvidelseHvordan et plugin eller en pakke går fra et godkendt build til de enheder, der kører det, og hvordan det tages ud igen. Versioner, udgivelsesgennemgang, kanaler og installationer, signering, ændringsgodkendelser, registrering af leveringsidentitet, migreringer, tilbagerulning og udfasning af en version.

Bilag: Reference

Download

PDF-filerne er på engelsk.