Logga inBoka en genomgång

Kapitel 2.2

Utgåvor under huven

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

Denna sida har översatts av AI från det engelska originalet. Om något är oklart är den engelska sidan referensen. Läs denna sida på engelska

17 minuters läsning

Två rader i en värdefil avgör vilken utgåva en installation kör:

# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
  enabled: true

De måste stämma överens. Anger du edition: community med enterprise.enabled: true stannar charten med "edition=community but enterprise.enabled=true: they must agree". Anger du edition som något annat än community eller enterprise stannar den med NEXUS_EDITION_INVALID. Dessa två värden väljer vilka avbilder installationen använder. Vad dessa avbilder sedan slår på avgörs av licensen under körning, en funktionsgrupp i taget.

Det här kapitlet går igenom hur det fungerar: vad utgåvorna innehåller, hur en produkt blir två byggen, hur en licens blir ett ja eller ett nej inuti en körande tjänst och vad det innebär när du bygger något eget. Kapitel 1.6, Utgåvor och licenser i klarspråk, ger köparens perspektiv; detta är teknikernas.

Utgåvematrisen

Allt i det här kapitlet kommer från en enda fil: utgåvematrisen. Den listar 97 förmågor och ger var och en en nivå. Adverant genererar licenskatalogen och konsolens menyregler utifrån den, liksom gränsen mellan öppen och sluten kod. När matrisen ändras följer allt detta med.

Det finns tre utgåvor.

Utgåva Licens Var den körs
Community Apache-2.0, öppen källkod, kostnadsfri Din hårdvara eller Adverant cloud
Team Adverant Enterprise-licens Adverant cloud: Community plus Team-uppsättningen
Enterprise Adverant Enterprise-licens, per funktionsgrupp Din hårdvara eller Adverant cloud

En installation kör en av två: chartens värde för edition accepterar endast community och enterprise. Team är en molnutgåva, och Enterprise innehåller även Team-uppsättningen, så på din egen hårdvara ingår Team-förmågorna (arbetspanelen som är dockad bredvid varje post, delade anteckningsböcker, minnespolicy för organisationen med mera) i Enterprise.

Enterprise är i sig uppbyggd i lager. Enterprise-basen är den slutna kärnan: flera organisationer och affärsenheter, krav på enkel inloggning med SAML (Security Assertion Markup Language) och katalogsynkronisering, anpassade roller med godkännande enligt fyra-ögon-principen, lång lagringstid för granskningsloggar, dataskydd, operatörssidorna och klusterhantering. Ovanpå basen ligger tillägg, som licensieras separat, och domänpaket. Det första tillägget i tabellen, AI Gateway at scale, fördelar belastningen för routern för AI (artificiell intelligens) över repliker och leverantörer.

Tillägg Kräver även
AI Gateway i stor skala Bas
Modellfabrik Bas
Idéer Bas
Samtal och röst Bas
E-post Bas
Andra företag och informationsbarriärer Bas
Anteckningsboksstudio Bas
Karta och GeoAI Bas
Datakonlektorer Bas
Agent-till-agent Bas
Beslutsrum och förseglade poster Bas
Intäktsstyrning Bas
Webbutik / white-label Bas
Nexus Edge Bas
Mobilappar Bas
Arbetsstyrka Bas; agenter på kantenheter kräver även Nexus Edge, godkännanden på en telefon kräver även Mobilappar
Shield Bas
Sandlådor Bas
Kvalitet (NexusQA) Bas

Det finns tio domänpaket:

  • Försäkring
  • Bank och betalningar
  • Kapitalmarknader och kapitalförvaltning
  • Myndigheter och offentlig sektor
  • Hälso- och sjukvård
  • Life science
  • Kritisk infrastruktur och energi
  • Försvar och säkerhet
  • Juridik och konsulttjänster
  • Logistik och sjöfart

Varje paket kräver Enterprise-basen, och fem av dem kräver även ett tillägg. Paketet Försäkring kräver Beslutsrum och förseglade poster. Det gör även paketet Kapitalmarknader och kapitalförvaltning. Paketet Juridik och konsulttjänster kräver dessa två plus E-post. Logistik och sjöfart kräver Kartor och GeoAI. I paketet Försvar och säkerhet kräver plattformsvarningar även Nexus Edge. Telefonskärmarna i samtliga paket kräver även Mobilappar. I kapitel 1.7, Domänpaket och branscher, beskrivs vad vart och ett innehåller.

Funktionsgrupper

Den enhet som en licens anger är funktionsgruppen. Det finns 32 stycken: Community-basnivån, Team-uppsättningen, Enterprise-basen, en per tillägg och en per paket. Varje förmåga tillhör exakt en grupp, så en licens som anger "Enterprise-bas, Kartor och GeoAI, Logistik och sjöfart" specificerar exakt vilka förmågor den här installationen får köra.

Nivå Förmågor
Community 36
Team 6
Enterprise-bas 18
Tillägg 23
Domänpaket 14

Tilldelningsomfång

Varje licensierad förmåga har ett tilldelningsomfång som anger vad en tilldelning knyts till.

  • Klientomfånget täcker de delar där användarna arbetar: Idéer, E-post, Intäktsstyrning och paketen. Licensen gör dem tillgängliga för installationen, och de slås sedan på eller av per organisation och per affärsenhet. En ny organisation ärver aldrig ett tillstånd där allt är påslaget.
  • Driftsättningsomfånget täcker de fem delar som tillhör installationen som helhet: licensimport med de artefakter den hämtar, leveransformerna för Enterprise, operatörssidorna, klusterhantering och Nexus Edge.

Community-förmågor har inget tilldelningsomfång alls. De kräver ingen licens.

En administratör kan begränsa vad licensen tillåter för en organisation eller en enhet. Ingen kan utöka det inifrån installationen.

En vertikal stapel med sex band. Nerifrån och upp: "Basnivå (alla utgåvor, aldrig bakom betalvägg)"; "Community, Apache-2.0"; en tjock dubbellinje märkt "@adverant/nexus-spi, det enda delade gränssnittet"; "Enterprise-bas, slutna moduler"; "Tillägg (19), vart och ett licensierat separat"; "Domänpaket (10)". Till höger, en ruta "Signerat licensdokument" med en pil in i de tre övre banden märkt "kontrolleras inuti varje sluten modul". Till vänster om Community-bandet, en notering "Community-avbilder: endast öppen källkod".
Utgåvorna som lager, med licensdokumentet som enda auktoritet.

En produkt, två byggen

Det finns en enda Nexus-kodbas. Community-bygget är dess export med öppen källkod, och Enterprise-bygget är den exporten plus slutna moduler.

En gränslista tilldelar varje spårad fil till en utgåva. Oftast sker det genom att ange vilken förmåga en fil implementerar, varpå filens utgåva följer av den förmågans nivå: en Community-förmåga ger en Community-fil, och allt som tillhör Team, bas, tillägg eller paket ger en Enterprise-fil. Filer som inte levereras i någon av utgåvorna listas med en motivering. En regel gäller över alla andra: varje moduls databasmigreringar levereras i båda utgåvorna. En Community-databas och en Enterprise-databas har därför samma schema, och att flytta en installation från den ena till den andra innebär bara en ändring av vad som är påslaget, utan att några data behöver migreras.

Community-exporten har Apache-2.0-huvuden och en NOTICE-fil, och varje paket i den är licensierat under Apache-2.0, förutom tredjepartskod som behåller sin egen licens (MIT, BSD med flera) och kopieras i befintligt skick, samt ett fåtal paket för programutvecklingskit (SDK) och kommandoradsgränssnitt (CLI) som behåller sin egen MIT-licens. Enterprise-bygget licensieras under Adverant Enterprise-licensen. Dess villkor tillåter användning endast enligt en skriftlig licens, för den giltighetstid, de driftsättningar och de funktionsgrupper som licensen anger. Förbudet mot bakåtkompilering bevarar uttryckligen de rättigheter som EU-rätten ger dig att studera programvara och att dekompilera den i syfte att uppnå interoperabilitet.

Licensgränsen

Enterprise-kod når Community genom ett enda paket: @adverant/nexus-spi, tjänsteleverantörsgränssnittet (SPI). Det är licensierat under Apache-2.0 och innehåller gränssnitt och typvakter, helt utan egen körningslogik.

Export Vad det är
RouteModule En licensierad ruttmodul: dess id, dess funktionsgrupp, de meddelandekroppar den läser och register(app, ctx)
SpiApp Den del av värdens HTTP-applikation som en modul berör: use
SpiContext Vad värden lämnar över till en modul: produktspärren och omfångsvakten, licensläsaren, poolen för omfångsbegränsade frågor, uppströmsadresser, plattformsklienter
SpiRuntime De värden för plugin-SDK:t (programutvecklingskitet) som värden lämnar över till en modul
SpiPlane De skärmgrupper och skärmläsningar som ett licensierat plan lägger till
ScreenModule En konsols licensierade skärmgrupp: dess rutter, skärmar och meny
GrantCheck Den kontroll som en licensierad modul kör på sin egen funktionsgrupp

En kontroll i bygget upprätthåller gränsen. Inuti Enterprise-koden leder en import från Community-paketomfången (@adverant/ och @adverant-nexus/) till att bygget avbryts, såvida det inte gäller @adverant/nexus-spi eller ett Enterprise-paket. Detsamma gäller en relativ import som går utanför arkivet, ett beroende med file:, link: eller workspace: som pekar utanför det, en Git-URL som anger ett Community-arkiv samt ett replace i Go som pekar utanför det. Över gränsen sker kopplingen via ett nätverksprotokoll eller en modul som läses in vid start, aldrig genom delad källkod. SPI:t har till och med en egen låst kopia av plugin-SDK:ts typdeklarationer, eftersom SDK:t är ett Community-paket som gränsen inte släpper igenom; värden lämnar i stället över SDK:ts körningsvärden till modulen.

Byggprofiler

Konsolen och BFF (backend for frontend) kompileras med en byggprofil som fastställer vilka kodklasser som finns inuti avbilden. Community-profilen innehåller Community-kod; Enterprise-profilen innehåller Community- och Enterprise-kod. Båda vägrar att starta när profilen innehåller kod som installationens utgåva saknar. BFF meddelar detta med PROFILE_OUTSIDE_EDITION och anger vilken avbild som ska driftsättas i stället. Det går inte att lägga en Enterprise-konsol på en Community-installation genom att märka om en avbild.

Till vänster, en ruta "Nexus-källkod" med en mindre ruta inuti, "utgåvematris". En pil märkt "gränslista" delar sig i två. Den övre pilen går till "Community-export (Apache-2.0)" och vidare till "Community-avbilder". Den nedre pilen går till "Enterprise-bygge", som även tar emot en pil från Community-exporten och en från en ruta "slutna moduler", och producerar "Enterprise-avbilder". Mellan de slutna modulerna och Community-exporten finns ett staket märkt "licensgräns: endast @adverant/nexus-spi". En liten notering under båda avbildsrutorna lyder "samma databasschema".
Hur ett källkodsträd blir två utgåvor.

Hur en licens aktiverar funktionsgrupper

En licens är ett signerat dokument. Adverant signerar varje licens med två oberoende nycklar, och ingenting annat i installationen avgör vad som är licensierat. Du importerar den via konsolens licenssidor, med nexusctl licence import <file> eller genom att skicka dokumentet via POST till https://<hosts.auth>/api/v1/installation/licence. En licens är aldrig ett chart-värde och aldrig en monterad fil. Kapitel 2.13, Licenser, behandlar import och förnyelse samt varje tillstånd en licens passerar igenom.

Den avgörande kontrollen körs inuti varje sluten modul, på modulens egen funktionsgrupp, innan den svarar. Det är kontraktet GrantCheck från SPI:t:

type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;

Kontrollen ligger i den slutna modulen eftersom en kontroll skriven i öppen källkod helt enkelt skulle kunna raderas. En förfalskad licens räknas som ingen licens alls. En modul vars funktionsgrupp inte anges i licensen svarar med LICENCE_LOCKED.

Även själva modulerna kontrolleras. nexus-keys håller utgåvans signerade komponentmanifest och den nyckel som signerade det. Tjänsten kontrollerar varje kompilerad modul mot detta manifest vid start och därefter varje natt kl. 03:53 UTC. En modul vars signatur inte stämmer läses aldrig in, och den signerade kopia som den skulle ha ersatt fortsätter att köras; operatörssidorna visar detta med MODULE_SIGNATURE_INVALID.

Kompilerade komponenter
Kompilerade komponenter
Sidan för kompilerade komponenter listar varje licensierad modul med dess funktionsgrupp, version och signaturkontroll. En ändrad kopia som inte har klarat kontrollen visas som en nekandeskylt, medan den signerade kopian fortsätter att köras.

Ovanför modulkontrollen ligger visningslagret, som avgör hur en förmåga visas för varje person. Det kombinerar licensens tilldelningar med organisationens plan och personens roll, vilket gör att varje kontroll hamnar i ett av fyra tillstånd.

Tillstånd Vad personen ser
Berättigad Kontrollen, normalt utritad
Förhandsvisning Kontrollen utgråad med ett hänglås; om den öppnas förklaras vad det är och vem som kan slå på den
Dold Ingenting; används endast för sådant som personens roll inte får känna till att det finns, exempelvis en annan persons privata postlåda
Nekad med en kod En nekandeskylt som anger koden, när någon försöker utföra en åtgärd som inte är tillåten

Licensen har även egna tillstånd när den närmar sig och passerar sitt slutdatum. Två regler gäller i samtliga tillstånd: en licens stoppar aldrig pågående arbete, och säkerhetsuppdateringar hålls aldrig inne.

Vad Community visar för en Enterprise-sida

En Community-installation behåller produktens form. Menyn har samma rader som i Enterprise, och Enterprise-raderna (Idéer, Beslut, E-post, Samtal, Andra företag, Agenter, Policyer, Efterlevnad) ritas ut gråmarkerade med en låsikon. Ingenting döljs för att få utgåvan att se komplett ut, och ingenting tjatar.

Om du öppnar en låst rad visas en förhandsvisning. För Idéer står det "Idéer är en del av Enterprise", följt av ett stycke om vad Idéer gör och därefter "Vem som kan slå på funktionen: din administratör, genom en licens från Adverant". Där finns två knappar: "Fråga din administratör" och "Se vad den gör". Det står inget pris. När sidan öppnas läses ingenting in och ingenting skickas, och informationen visas bara en gång.

Något du inte har
Något du inte har
Ett låst område i Community anger vem som kan slå på det och vad Community redan ger dig. Raden ligger kvar i menyn, utgråad med ett hänglås, så att produkten ser likadan ut i båda utgåvorna.

Att skriva in adressen till en sida som bara finns i Enterprise leder också till en användbar plats. Community-konsolen känner till adresserna till de sidor den inte innehåller och skickar dem till sin utgåvesida, inuti den vanliga ramen med menyn. Sidan ritar ut skylten för låst funktion:

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 finns där som referens; meningarna är till för personen som läser.

Basnivån

Vissa saker ligger aldrig bakom en betalvägg, oavsett utgåva och licenstillstånd: grundläggande administration och säkerhet, klientseparering, dataexport, utloggning samt varje nekandeskärm. En Community-installation har allt detta. En Enterprise-installation vars licens har löpt ut behåller dem också: Enterprise-artefakterna slutar erbjudas, medan Community-basnivån och dataexporten finns kvar. Du kan alltid få ut dina data.

Från Community till Enterprise
Från Community till Enterprise
Vid import av en licens på en Community-installation visas vad som kommer att hämtas, vad som ändras och vad som behålls innan någonting sker. På knappen står det "Hämta och slå på", och ingenting hämtas förrän någon trycker på den.

Avbildningar per utgåva

Varje avbild i en utgåva listas med sin kontrollsumma (digest) i chartens avbildslås, och själva låset tillhör en specifik utgåva. Charten kontrollerar varje avbild den renderar mot låset och mot den utgåva du har begärt. En Community-installation använder endast Community-avbilder. Begär du något annat stannar den: "a community install takes only community images". Ett Enterprise-lås innehåller Community-avbilderna plus Enterprise-byggena.

Detta har betydelse för varifrån du hämtar avbilderna. Community-avbilder är publika på registry.adverant.ai/nexus/<service>@sha256:…. Enterprise-avbilder kommer från samma register med en hämtningstoken (pull token), som du hämtar från sidan "Hämtningstoken och installationskommandon" på ditt Adverant-konto. En Community-installation behöver aldrig den token och innehåller aldrig en enda byte sluten kod.

Uppgraderingsvägen bevarar installationen. När en Community-administratör importerar en Enterprise-licens läser och verifierar konsolen den, och visar sedan de komponenter som kommer att hämtas (de kompilerade modulerna samt de paket och tillägg som licensen anger) tillsammans med deras storlek. Varje komponent kontrolleras mot Adverants utgåvenyckel, och grupperna slås på en i taget. Personer och filer förblir som de är, liksom arbetsflöden och kanaler, eftersom schemat redan var detsamma. Kapitel 2.7, Installera Enterprise och tillämpa en licens, går igenom hur detta görs på Kubernetes; luftgapade (air-gapped) anläggningar importerar samma komponenter från lagringsmedia, enligt beskrivningen i kapitel 2.10, Luftgapad installation.

Leveransformer och skyddsklasser

Nexus levereras i sex leveransformer, som i matrisen kallas SKU:er (stock-keeping units). De fem utöver Edge delar samma signerade paket och skiljer sig åt i paketering och i hur licensen levereras.

SKU Vad det är Hur licensen levereras
saas Adverant-molnet Utfärdas med prenumerationen
onprem-connected Helm på ditt eget Kubernetes Hämtas av installationen via dess utgående anslutning
airgap Samma paket, importerat offline Importeras som en fil, med ett signerat användningsintyg en gång om året
self-serve-image En maskinavbild i ditt eget molnkonto Själva avbilden innehåller endast Community- och utvärderingslicenser; Enterprise-moduler levereras när en licens har utfärdats, inklusive licenser som köpts via molnets butik
appliance Hårdvara byggd av en originaltillverkare (OEM), som är dess registrerade tillverkare En Enterprise-licens; hårdvaruenheten är en av dess leveransformer
edge Nexus Edge, nyttolasten på satelliter och drönare, eller på fartyg och fordon En licens per plattform eller flotta, långlivad, giltig i offlineläge

Skydd är den andra halvan av leveransen, och det är värt att tala klarspråk om. När kod väl körs på hårdvara som du kontrollerar finns det ingen teknik som gör den oläsbar. Därför delar Adverant in sin kod i skyddsklasser och bestämmer, för varje leveransform, hur långt varje klass får färdas. Det finns fyra nivåer:

Klass Vad det innebär
P1, levereras aldrig Logiken körs hos Adverant; installationen har en signerad klient.
P2, förseglad En konfidentiell virtuell maskin (VM) som du inte kan logga in på, på hårdvara som du inte kan röra.
P3, härdad maskinkod Kompilerad, rensad på symboler (stripped) och byggd per licenstagare. Det höjer kostnaden för att läsa koden från timmar till veckor.
P4, läsbar Vanlig JavaScript eller TypeScript, precis som öppen källkod.
Skyddsklass Adverant-molnet Ansluten lokalt (on-prem) Luftgapad (air-gap) Nexus Edge
Öppen källkod (hela Community) P4 P4 P4 P4
Kod med högst värde: idépoängsättning, kärnan i lagret för förseglade poster, motorn för ruttningspolicyer, de fyra beslutsmotorerna i paketet Försäkring P1 P3, eller P2 som en Adverant-förseglad konfidentiell VM i din molnmiljö P3 Levereras inte
Slutna servermoduler som fattar beslut: paketens serverkod, mobilgatewayen P1 P3 P3 Levereras inte
Serverkod för paketet Försvar och säkerhet P1 P3 P3 P3
Nyttolastkod för Nexus Edge Levereras inte Levereras inte Levereras inte P3
Läsbara klientdefinitioner: telefonappar, paketens telefonskärmar P4 P4 P4 P4

Detta får två konsekvenser. Ingenting skyddat levereras i en telefonapp: varje regel och prompt stannar på servern. Och värde som bärs i prompter, bedömningsmatriser eller agentkedjor kan läsas av den som kör modellen det skickas till. Där din organisation äger modellen skyddas detta värde av licensavtalet och ingenting annat. Varje levererad TypeScript-avbild är paketerad och minifierad utan källkodskartor (source maps), vilket handlar mer om ordning och reda än om skydd.

Vad detta innebär när ni bygger ett tillägg

Din utökning ligger på samma gräns som Adverants egna moduler. Nästan allt i det här kapitlet gäller även för den.

Isolering, identitet och AI-vägen följer med plattformen i båda utgåvorna. En plugin som byggs med @adverant-nexus/plugin-sdk ärver staketet för omfångsbegränsade frågor, tokenverifieraren och UNO-utskicket, oavsett vilken utgåva den hamnar på. Kapitel 2.19, Reglerna som varje utökning ärver, listar dem.

Utgåvespärrar fungerar på samma sätt för dig. En plugin deklarerar sina funktions-id:n i manifestets entitlements-block (featureIdPattern, plus en kort alwaysOn-lista som behålls för hälsokontroller och inställningssidan) och ber plattformen om ett besked innan den betjänar en spärrad yta. Beskedet är aldrig ett enkelt booleskt värde. ENTITLEMENT_DENIED (403) betyder att plattformen svarade nej. ENTITLEMENT_UNREACHABLE (502) betyder att det inte kom något svar, och din plugin måste då neka snarare än att göra ett antagande, eftersom ett driftavbrott som tolkas som "ej berättigad" i tysthet nedgraderar alla kunder samtidigt. Cacha ett ja under en kort tid och cacha aldrig ett nekande.

I Community får en utvecklare samma startmallar som i Enterprise, för såväl plugins och linser som färdigheter och arbetsflöden. Varje utvecklare arbetar i ett utvecklingsutrymme med datagrenar på en och samma server, och koden ligger i GitHub. Domänpakets- och plattformsmallar tillhör Enterprise. Det gäller även tidsbegränsad behörighetshöjning från en IDE (integrerad utvecklingsmiljö): i Community finns det ingen separat produktionsmiljö att höja sin behörighet till, vilket konsolen meddelar med PASS_TIER_REQUIRED.

Bygga på Community
Bygga på Community
Att bygga på Community ger samma mallar som i Enterprise på en server, med koden i GitHub. Sidan anger vad Enterprise lägger till och nekar förhöjd behörighet med en tydlig förklaring.

En utökning som endast använder Community-gränssnitt körs oförändrad på båda utgåvorna. En som är beroende av ett tillägg, exempelvis E-post, visas som låst överallt där licensen inte anger den gruppen. Kapitel 2.25, Bygga för respektive utgåva, visar hur du strukturerar en utökning för båda, och hur du testar den mot var och en.