Version 1.0.0-alpha.1seneste
Kapitel 2.2
Udgaver under motorhjelmen
Hvordan 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.
Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

To linjer i en values-fil afgør, hvilken udgave en installation kører:
# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
enabled: trueDe skal stemme overens. Hvis du sætter edition: community sammen med enterprise.enabled: true, stopper chartet med "edition=community but enterprise.enabled=true: they must agree". Hvis du sætter edition til andet end community eller enterprise, stopper det med NEXUS_EDITION_INVALID. De to værdier vælger, hvilke images installationen tager. Hvad de images derefter slår til, afgør licensen på kørselstidspunktet, én funktionsgruppe ad gangen.
Dette kapitel skiller det ad: hvad udgaverne indeholder, hvordan ét produkt bliver til to builds, hvordan en licens bliver til et ja eller et nej inde i en kørende tjeneste, og hvad det betyder, når du bygger noget selv. Kapitel 1.6, Udgaver og licenser i klart sprog, har køberens perspektiv; dette er ingeniørens.
Udgavematricen
Alt i dette kapitel kommer fra én fil, udgavematricen. Den opregner 97 kapabiliteter og tildeler hver enkelt et niveau. Adverant genererer licenskataloget og konsollens menuregler ud fra den, sammen med grænsen mellem åben og lukket kode. Når matricen flytter sig, flytter alt dette sig sammen.
Der er tre udgaver.
| Udgave | Licens | Hvor den kører |
|---|---|---|
| Community | Apache-2.0, open source, gratis | Din egen hardware eller Adverant cloud |
| Team | Adverant Enterprise-licens | Adverant cloud: Community plus Team-sættet |
| Enterprise | Adverant Enterprise-licens, pr. funktionsgruppe | Din egen hardware eller Adverant cloud |
En installation kører én af to: chartets edition-værdi accepterer kun community og enterprise. Team er en cloud-udgave, og Enterprise rummer også Team-sættet, så på din egen hardware følger Team-kapabiliteterne (arbejdspanelet forankret ved siden af hver post, delte notesbøger, hukommelsespolitik for organisationen og resten) med Enterprise.
Selve Enterprise er lagdelt. Enterprise-basen er den lukkede kerne: flere organisationer og forretningsenheder, håndhævelse af single sign-on med SAML (Security Assertion Markup Language) og katalogsynkronisering, brugerdefinerede roller med fire-øjne-godkendelser, lang opbevaring af revisionsspor, databeskyttelse, operatørsiderne og klyngeadministration. Oven på basen ligger tilføjelser, der hver licenseres separat, og domænepakker. Den første tilføjelse i tabellen, AI Gateway at scale, fordeler belastningen på AI-routeren (kunstig intelligens) på tværs af replikaer og udbydere.
| Tilføjelse | Kræver også |
|---|---|
| AI Gateway i stor skala | Base |
| Modelfabrik | Base |
| Ideer | Base |
| Opkald og tale | Base |
| Base | |
| Andre firmaer og mure | Base |
| Notesbogsstudie | Base |
| Kort og GeoAI | Base |
| Dataforbindelser | Base |
| Agent-til-agent | Base |
| Beslutningsrum og forseglede optegnelser | Base |
| Omsætningsdrift (Revenue operations) | Base |
| Butiksfacade / white-label | Base |
| Nexus Edge | Base |
| Mobilapps | Base |
| Workforce | Base; agenter på edge-enheder kræver også Nexus Edge, godkendelser på en telefon kræver også Mobile apps |
| Shield | Base |
| Sandkasser | Base |
| Kvalitet (NexusQA) | Base |
Der er ti domænepakker:
- Forsikring
- Bankvæsen og betalinger
- Kapitalmarkeder og kapitalforvaltning
- Stat og offentlig sektor
- Sundhedsvæsen
- Life science
- Kritisk infrastruktur og energi
- Forsvar og sikkerhed
- Juridisk rådgivning og liberale erhverv
- Logistik og søfart
Hver pakke kræver Enterprise-basen, og fem af dem kræver også en tilføjelse. Pakken Insurance kræver Decision rooms og sealed records. Det samme gør pakken Capital markets and asset management. Pakken Legal and professional services kræver de to plus Mail. Logistics and maritime kræver Map and GeoAI. I pakken Defence and security kræver platformalarmer også Nexus Edge. Enhver pakkes telefonskærme kræver også Mobile apps. Kapitel 1.7, Domænepakker og vertikaler, beskriver, hvad hver enkelt indeholder.
Funktionsgrupper
Den enhed, en licens navngiver, er funktionsgruppen. Der er 32: Community-bunden, Team-sættet, Enterprise-basen, én pr. tilføjelse og én pr. pakke. Hver kapabilitet tilhører præcis én, så en licens, der angiver "Enterprise base, Map and GeoAI, Logistics and maritime", fastslår præcis, hvilke kapabiliteter denne installation må køre.
| Niveau | Kapabiliteter |
|---|---|
| Community | 36 |
| Team | 6 |
| Enterprise-base | 18 |
| Tilkøb | 23 |
| Domænepakker | 14 |
Tildelingsomfang
Hver licenseret kapabilitet har et tildelingsomfang, som angiver, hvad en tildeling knytter sig til.
- Lejeromfang dækker de dele, folk arbejder i: Ideas, Mail, Revenue operations, pakkerne. Licensen gør dem tilgængelige for installationen, og de slås derefter til eller fra pr. organisation og pr. forretningsenhed. En ny organisation arver aldrig en tilstand, hvor alt er slået til.
- Installationsomfang dækker de fem ting, der hører til installationen som helhed: licensimport med de artefakter, den henter, Enterprise-leveringsformerne, operatørsiderne, klyngeadministration og Nexus Edge.
Community-kapabiliteter har slet intet tildelingsomfang. De kræver ingen licens.
En administrator kan indsnævre det, licensen tillader, for en organisation eller en enhed. Ingen kan udvide det indefra installationen.
Ét produkt, to builds
Der er én Nexus-kodebase. Community-buildet er dens open source-eksport, og Enterprise-buildet er den eksport plus lukkede moduler.
En grænseliste knytter hver sporet fil til en udgave. For det meste gør den det ved at navngive den kapabilitet, en fil implementerer, og filens udgave følger af den kapabilitets niveau: en Community-kapabilitet giver en Community-fil, og alt, der er Team, base, tilføjelse eller pakke, giver en Enterprise-fil. Filer, der ikke leveres i nogen af udgaverne, står opført med en begrundelse. Én regel går på tværs af resten: hvert moduls databasemigreringer leveres i begge udgaver. En Community-database og en Enterprise-database har derfor det samme skema, og at flytte en installation fra den ene til den anden er en ændring af, hvad der er slået til, uden data, der skal migreres.
Community-eksporten bærer Apache-2.0-headere og en NOTICE-fil, og hver pakke i den er licenseret under Apache-2.0, bortset fra tredjepartskode, der beholder sin egen licens (MIT, BSD og andre) og kopieres uændret, samt enkelte SDK- (software development kit) og CLI-pakker (command-line interface), der beholder deres egen MIT-licens. Enterprise-buildet er licenseret under Adverant Enterprise-licensen. Dens vilkår tillader kun brug under en skriftlig licens, i den periode og for de installationer og funktionsgrupper, som licensen nævner. Forbuddet mod reverse engineering bevarer udtrykkeligt de rettigheder, som EU-lovgivningen giver dig til at undersøge software og dekompilere den af hensyn til interoperabilitet.
Licensgrænsen
Enterprise-kode når kun Community gennem én pakke: @adverant/nexus-spi, service provider-grænsefladen (SPI). Den er Apache-2.0 og indeholder grænseflader og type guards, uden egen kørselslogik.
| Eksport | Hvad det er |
|---|---|
RouteModule |
Et licenseret rutemodul: dets id, dets funktionsgruppe, de bodies det læser, og register(app, ctx) |
SpiApp |
Den del af værtens HTTP-app, et modul berører: use |
SpiContext |
Hvad værten giver et modul: produktporten og omfangsvagten, licenslæseren, puljen til afgrænsede forespørgsler, upstream-adresser, platformsklienter |
SpiRuntime |
De plugin-SDK-værdier (software development kit), som værten giver et modul |
SpiPlane |
De skærmgrupper og skærmlæsninger, et licenseret plan tilføjer |
ScreenModule |
En konsols licenserede skærmgruppe: dens ruter, skærme og menu |
GrantCheck |
Den kontrol, et licenseret modul kører på sin egen funktionsgruppe |
En kontrol i buildet håndhæver grænsen. Inde i Enterprise-koden får en import fra Community-pakkeområderne (@adverant/ og @adverant-nexus/) buildet til at fejle, medmindre det er @adverant/nexus-spi eller en Enterprise-pakke. Det samme gør en relativ import, der bevæger sig ud af repositoriet, en file:-, link:- eller workspace:-afhængighed, der peger uden for det, en Git-URL, der angiver et Community-repositorium, og en Go-replace, der peger uden for det. På tværs af grænsen sker kobling via en netværksprotokol eller et modul indlæst ved opstart, aldrig via delt kildekode. SPI'en indeholder endda sin egen fastlåste kopi af plugin-SDK'ets typedeklarationer, fordi SDK'et er en Community-pakke, som grænsen ikke tillader; værten giver i stedet et modul SDK'ets kørselsværdier.
Buildprofiler
Konsollen og BFF'en (backend for frontend) kompileres med en buildprofil, som fastlægger kodeklasserne inde i imaget. Community-profilen rummer Community-kode; Enterprise-profilen rummer Community- og Enterprise-kode. Hver især nægter at starte, når dens profil rummer kode, som installationens udgave ikke gør. BFF'en meddeler det med PROFILE_OUTSIDE_EDITION og angiver, hvilket image der skal udrulles i stedet. Du kan ikke lægge en Enterprise-konsol på en Community-installation ved at ommærke et image.
Hvordan en licens slår funktionsgrupper til
En licens er et signeret dokument. Adverant signerer hver licens med to uafhængige nøgler, og intet andet på installationen afgør, hvad der er licenseret. Du importerer den gennem konsollens licenssider, med nexusctl licence import <file>, eller ved at sende dokumentet til https://<hosts.auth>/api/v1/installation/licence. En licens er aldrig en chart-værdi og aldrig en monteret fil. Kapitel 2.13, Licenser, dækker import og fornyelse samt hver tilstand, en licens gennemløber.
Den kontrol, der tæller, kører inde i hvert lukket modul, på det moduls egen funktionsgruppe, før det svarer. Det er GrantCheck-kontrakten fra SPI'en:
type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;Kontrollen ligger i det lukkede modul, fordi en kontrol skrevet i open source-kode blot ville kunne slettes. En forfalsket licens tæller som ingen licens. Et modul, hvis funktionsgruppe licensen ikke nævner, svarer med LICENCE_LOCKED.
Selve modulerne kontrolleres også. nexus-keys indeholder udgivelsens signerede komponentmanifest og den nøgle, der signerede det. Den kontrollerer hvert kompileret modul mod dette manifest ved opstart og igen hver nat kl. 03:53 UTC. Et modul, hvis signatur ikke stemmer, indlæses aldrig, og den signerede kopi, det skulle have erstattet, bliver ved med at køre; operatørsiderne viser det med MODULE_SIGNATURE_INVALID.
Over modulkontrollen ligger visningslaget, som afgør, hvordan en kapabilitet fremtræder for den enkelte person. Det kombinerer licensens tildelinger med organisationens plan og personens rolle, og hvert betjeningselement ender i én af fire tilstande.
| Tilstand | Hvad personen ser |
|---|---|
| Berettiget | Betjeningselementet, vist normalt |
| Smagsprøve | Betjeningselementet nedtonet med en hængelås; når det åbnes, forklares det, hvad det er, og hvem der kan slå det til |
| Skjult | Ingenting; bruges kun til ting, som denne persons rolle ikke må vide eksisterer, såsom en anden persons private postkasse |
| Afvist med en kode | En afvisningsplade, der angiver koden, når nogen forsøger en handling, der ikke er tilladt |
Licensen har også sine egne tilstande, efterhånden som den nærmer sig og passerer sin udløbsdato. To regler gælder i dem alle: en licens standser aldrig igangværende arbejde, og sikkerhedsrettelser tilbageholdes aldrig.
Hvad Community viser for en Enterprise-side
En Community-installation bevarer produktets form. Menuen har de samme rækker som Enterprise, og Enterprise-rækkerne (Ideas, Decisions, Mail, Calls, Other firms, Agents, Policies, Compliance) vises nedtonet med et låseikon. Intet er skjult for at få udgaven til at se komplet ud, og intet plager brugeren.
Når man åbner en låst række, vises en smagsprøve. For Ideas står der "Ideas er en del af Enterprise", derefter ét afsnit om, hvad Ideas gør, og så "Hvem kan slå det til: din administrator, gennem en licens fra Adverant". Den tilbyder to knapper, "Spørg din administrator" og "Se hvad det gør". Der er ingen pris. At åbne siden indlæser intet og sender intet, og omtalen vises én gang.
Hvis man indtaster adressen på en side, der kun findes i Enterprise, lander man også et nyttigt sted. Community-konsollen kender adresserne på de sider, den ikke rummer, og sender enhver af dem til sin udgaveside, inde i den normale ramme med menuen. Siden viser pladen for låste funktioner:
LICENCE_LOCKED
This page is part of Nexus Enterprise. This installation runs Nexus Community,
so the page is not here and nothing was read.
- To use it, the installation needs Nexus Enterprise: an administrator can ask Adverant about it
- Every page this installation holds is in the menu
Koden er der som reference; sætningerne er til personen, der læser den.
Bunden
Nogle ting ligger aldrig bag en betalingsmur, i nogen udgave, under nogen licenstilstand: grundlæggende administration og sikkerhed, lejeradskillelse, dataeksport, log ud samt enhver afvisningsskærm. En Community-installation har dem alle. En Enterprise-installation, hvis licens er udløbet, beholder dem også: Enterprise-artefakterne tilbydes ikke længere, mens Community-bunden og dataeksport bliver tilbage. Du kan altid få dine data ud.
Images efter udgave
Hvert image i en udgivelse er opført efter digest i chartets image-lås, og selve låsen tilhører én udgave. Chartet kontrollerer hvert image, det genererer, mod låsen og mod den udgave, du har bedt om. En Community-installation tager kun Community-images. Bed den om andet, og den stopper: "a community install takes only community images". En Enterprise-lås rummer Community-images plus Enterprise-builds.
Det har betydning for, hvor du henter fra. Community-images er offentlige på registry.adverant.ai/nexus/<service>@sha256:…. Enterprise-images kommer fra det samme register med et pull-token, som du får fra siden "Pull tokens and install commands" på din Adverant-konto. En Community-installation behøver aldrig dette token og indeholder aldrig en eneste byte lukket kode.
Opgraderingsvejen bevarer installationen. Når en Community-administrator importerer en Enterprise-licens, læser og verificerer konsollen den og viser derefter de komponenter, den vil hente (de kompilerede moduler samt de pakker og tilføjelser, licensen nævner) med deres størrelser. Hver komponent kontrolleres mod Adverants udgivelsesnøgle, og grupperne slås til én ad gangen. Personer og filer forbliver, som de er, og det samme gælder arbejdsgange og kanaler, fordi skemaet allerede var det samme. Kapitel 2.7, Installation af Enterprise og anvendelse af en licens, gennemgår det på Kubernetes; air-gappede miljøer importerer de samme komponenter fra medier, som beskrevet i kapitel 2.10, Air-gapped installation.
Leveringsformer og beskyttelsesklasser
Nexus leveres i seks leveringsformer, som matricen kalder SKU'er (stock-keeping units). De fem andre end Edge deler én signeret pakke og adskiller sig i indpakning og i, hvordan licensen ankommer.
| SKU | Hvad det er | Hvordan licensen ankommer |
|---|---|---|
saas |
Adverant cloud | Udstedt sammen med abonnementet |
onprem-connected |
Helm på dit eget Kubernetes | Hentet af installationen over dens udgående forbindelse |
airgap |
Den samme pakke, importeret offline | Importeret som en fil, med en signeret forbrugsopgørelse én gang om året |
self-serve-image |
Et maskin-image på din egen cloud-konto | Selve imaget indeholder kun Community- og evalueringslicenser; Enterprise-moduler ankommer, når en licens er udstedt, herunder en købt gennem cloud-udbyderens butik |
appliance |
Hardware bygget af en original equipment manufacturer (OEM), som er dens registrerede producent | En Enterprise-licens; appliancen er en af dens leveringsformer |
edge |
Nexus Edge, nyttelasten på satellitter og droner eller på fartøjer og køretøjer | Én licens pr. platform eller flåde, langtidsholdbar, gyldig mens den er offline |
Beskyttelse er den anden halvdel af leveringen, og det er værd at sige ligeud. Når først kode kører på hardware, du kontrollerer, kan ingen teknik gøre den ulæselig. Derfor inddeler Adverant sin kode i beskyttelsesklasser og beslutter for hver leveringsform, hvor langt hver klasse må rejse. Der er fire niveauer:
| Klasse | Hvad det betyder |
|---|---|
| P1, sendes aldrig ud | Logikken kører hos Adverant; installationen rummer en signeret klient. |
| P2, forseglet | En fortrolig virtuel maskine (VM), som du ikke kan logge ind på, på hardware, du ikke kan røre. |
| P3, hærdet maskinkode | Kompileret, strippet og bygget pr. licenstager. Det hæver omkostningen ved at læse koden fra timer til uger. |
| P4, læsbar | Almindelig JavaScript eller TypeScript, ligesom open source er. |
| Beskyttelsesklasse | Adverant cloud | Forbundet on-prem | Air-gap | Nexus Edge |
|---|---|---|---|---|
| Open source (hele Community) | P4 | P4 | P4 | P4 |
| Kode med højest værdi: idébedømmelse, kernen i lageret til forseglede poster, motoren til rutningspolitikker, de fire beslutningsmotorer i Insurance-pakken | P1 | P3, eller P2 som en Adverant-forseglet fortrolig VM i dit cloud-miljø | P3 | Sendes ikke ud |
| Lukkede servermoduler, der træffer beslutninger: pakkeserverkode, mobil-gatewayen | P1 | P3 | P3 | Sendes ikke ud |
| Serverkode til pakken Defence and security | P1 | P3 | P3 | P3 |
| Nyttelastkode til Nexus Edge | Sendes ikke ud | Sendes ikke ud | Sendes ikke ud | P3 |
| Læsbare klientdefinitioner: telefon-apps, pakkernes telefonskærme | P4 | P4 | P4 | P4 |
Heraf følger to konsekvenser. Intet beskyttet leveres i en telefon-app: hver regel og prompt bliver på serveren. Og værdi indeholdt i prompter, bedømmelseskriterier eller agentkæder kan læses af den, der driver den model, det sendes til. Hvor din organisation ejer modellen, er den værdi beskyttet af licenskontrakten og intet andet. Hvert leveret TypeScript-image er bundtet og minificeret uden source maps, hvilket handler mere om orden end om beskyttelse.
Hvad dette betyder, når du bygger en udvidelse
Din udvidelse ligger på samme linje som Adverants egne moduler. Næsten hele dette kapitel gælder også for den.
Isolering, identitet og AI-stien følger med platformen i begge udgaver. Et plugin bygget med @adverant-nexus/plugin-sdk arver hegnet for afgrænsede forespørgsler, token-verifikatoren og UNO-afvikling, uanset hvilken udgave det lander på. Kapitel 2.19, Reglerne som enhver udvidelse arver, opregner dem.
Udgavebegrænsning fungerer på samme måde for dig. Et plugin erklærer sine funktions-id'er i sit manifests entitlements-blok (featureIdPattern, plus en kort alwaysOn-liste af hensyn til sundhedstjek og indstillingssiden) og beder platformen om en afgørelse, før det betjener en begrænset flade. Afgørelsen er aldrig en simpel boolesk værdi. ENTITLEMENT_DENIED (403) betyder, at platformen svarede nej. ENTITLEMENT_UNREACHABLE (502) betyder, at der ikke kom noget svar, og dit plugin skal afvise frem for at antage noget, fordi et udfald læst som "ikke berettiget" i stilhed nedgraderer samtlige kunder på én gang. Gem et ja kortvarigt i cachen, og gem aldrig en afvisning.
På Community får en udvikler de samme startskabeloner som på Enterprise, til plugins og linser såvel som færdigheder og arbejdsgange. Hver udvikler arbejder i et udviklingsrum med datagrene på den ene server, og koden ligger i GitHub. Domænepakke- og platformsskabeloner hører til Enterprise. Det samme gør tidsbegrænset adgangsudvidelse fra et IDE (integreret udviklingsmiljø): på Community er der intet separat produktionsmiljø at hæve sin adgang ind i, og det meddeler konsollen med PASS_TIER_REQUIRED.
En udvidelse, der kun bruger Community-snitflader, kører uændret på begge udgaver. En, der afhænger af en tilføjelse, eksempelvis Mail, vises som låst overalt, hvor licensen ikke nævner den gruppe. Kapitel 2.25, Udvikling til hver udgave, viser, hvordan man strukturerer en udvidelse til begge, og hvordan man tester den mod hver enkelt.



