Log indBook en briefing

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

17 minutters læsetid

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: true

De 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
Mail 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.

En lodret stak med seks bånd. Nedefra: "Bund (hver udgave, aldrig bag betalingsmur)"; "Community, Apache-2.0"; en tyk dobbeltlinje mærket "@adverant/nexus-spi, den eneste delte grænseflade"; "Enterprise-base, lukkede moduler"; "Tilføjelser (19), hver licenseret separat"; "Domænepakker (10)". Til højre en boks "Signeret licensdokument" med en pil ind i de tre øverste bånd mærket "kontrolleret inde i hvert lukket modul". Til venstre for Community-båndet en note "Community-images: kun open source".
Udgaverne som lag, med licensdokumentet som eneste autoritet.

É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.

Til venstre én boks "Nexus-kildekode" med en mindre boks indeni, "udgavematrice". En pil mærket "grænseliste" deler sig i to. Den øverste pil går til "Community-eksport (Apache-2.0)" og videre til "Community-images". Den nederste pil går til "Enterprise-build", som også modtager en pil fra Community-eksporten og én fra en boks "lukkede moduler", og danner "Enterprise-images". Mellem de lukkede moduler og Community-eksporten er et hegn mærket "licensgrænse: kun @adverant/nexus-spi". En lille note under begge image-bokse lyder "samme databaseskema".
Hvordan ét kildetræ bliver til to udgaver.

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.

Kompilerede komponenter
Kompilerede komponenter
Siden med kompilerede komponenter viser hvert licenseret modul med dets funktionsgruppe, version og signaturkontrol. En ændret kopi, der ikke bestod sin kontrol, vises som en afvisningsplade, og den signerede kopi fortsatte med at køre.

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.

Noget, du ikke har
Noget, du ikke har
Et låst område på Community angiver, hvem der kan slå det til, og hvad Community allerede giver dig. Rækken bliver i menuen, nedtonet med en lås, så produktet ser ens ud i begge udgaver.

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.

Fra Community til Enterprise
Fra Community til Enterprise
Når en licens importeres på en Community-installation, vises det, hvad der vil blive hentet, hvad der ændres, og hvad der bevares, før der sker noget. Knappen lyder "Hent og slå til", og intet hentes, før der trykkes på den.

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.

Udvikling på Community
Udvikling på Community
Udvikling på Community tilbyder de samme skabeloner som Enterprise på én server, med koden i GitHub. Siden nævner, hvad Enterprise tilføjer, og afviser udvidet adgang med en ligefrem begrundelse.

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.