Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.2
Izdanja ispod haube
Kako se izdanja Community i Enterprise grade iz jednog proizvoda, kako licencija uključuje skupine značajki u vremenu izvođenja, što instalacija izdanja Community prikazuje za stranicu izdanja Enterprise te što to znači za slike koje povlačite i proširenja koja gradite.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Dva retka u datoteci vrijednosti odlučuju koje izdanje instalacija pokreće:
# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
enabled: trueMoraju se podudarati. Postavite li edition: community uz enterprise.enabled: true, chart se zaustavlja s porukom „edition=community but enterprise.enabled=true: they must agree”. Postavite li edition na bilo što osim community ili enterprise, zaustavlja se s NEXUS_EDITION_INVALID. Te dvije vrijednosti biraju koje će slike instalacija preuzeti. Što te slike zatim uključuju stvar je licencije, u vremenu izvođenja, jednu po jednu skupinu značajki.
Ovo poglavlje to raščlanjuje: što izdanja sadržavaju, kako jedan proizvod postaje dvije međuverzije, kako se licencija pretvara u „da” ili „ne” unutar pokrenute usluge i što to znači kada gradite nešto vlastito. Poglavlje 1.6, Izdanja i licencije jednostavnim rječnikom, donosi pogled kupca; ovo je pogled inženjera.
Matrica izdanja
Sve u ovom poglavlju potječe iz jedne datoteke, matrice izdanja. Ona navodi 97 mogućnosti i svakoj dodjeljuje razinu. Adverant iz nje generira katalog licencija i pravila izbornika konzole, zajedno s granicom između otvorenog i zatvorenog koda. Kada se matrica promijeni, sve se to mijenja zajedno.
Postoje tri izdanja.
| Izdanje | Licencija | Gdje se izvodi |
|---|---|---|
| Community | Apache-2.0, otvoreni kod, besplatno | Vaš hardver ili Adverant oblak |
| Team | Licencija Adverant Enterprise | Adverant oblak: Community plus skup Team |
| Enterprise | Licencija Adverant Enterprise, po skupini značajki | Vaš hardver ili Adverant oblak |
Instalacija pokreće jedno od dvoga: vrijednost edition u chartu prihvaća samo community i enterprise. Team je izdanje za oblak, a Enterprise sadržava i skup Team, pa na vašem vlastitom hardveru mogućnosti izdanja Team (radna ploča usidrena uz svaki zapis, dijeljene bilježnice, pravila memorije za organizaciju i ostalo) dolaze s izdanjem Enterprise.
Sam Enterprise je slojevit. Osnova Enterprise zatvorena je jezgra: više organizacija i poslovnih jedinica, provođenje jedinstvene prijave uz SAML (Security Assertion Markup Language) i sinkronizaciju imenika, prilagođene uloge s odobrenjima četiri oka, dugo zadržavanje revizijskih zapisa, zaštita podataka, operaterske stranice i upravljanje klasterom. Povrh osnove nalaze se dodaci, svaki licenciran zasebno, i domenski paketi. Prvi dodatak u tablici, AI Gateway na velikoj skali, raspoređuje opterećenje usmjerivača AI-ja (umjetne inteligencije) na replike i pružatelje usluga.
| Dodatak | Također zahtijeva |
|---|---|
| AI Gateway na velikoj skali | Osnova |
| Tvornica modela | Osnova |
| Ideje | Osnova |
| Pozivi i glas | Osnova |
| Pošta | Osnova |
| Druge tvrtke i zidovi | Osnova |
| Studio za bilježnice | Osnova |
| Karta i GeoAI | Osnova |
| Podatkovni konektori | Osnova |
| Agent-prema-agentu | Osnova |
| Sobe za donošenje odluka i zapečaćeni zapisi | Osnova |
| Operacije prihoda | Osnova |
| Izlog / white-label | Osnova |
| Nexus Edge | Osnova |
| Mobilne aplikacije | Osnova |
| Radna snaga | Osnova; agenti na rubnim uređajima također trebaju Nexus Edge, odobrenja na telefonu također trebaju Mobilne aplikacije |
| Štit (Shield) | Osnova |
| Sigurna okruženja (Sandboxes) | Osnova |
| Kvaliteta (NexusQA) | Osnova |
Postoji deset domenskih paketa:
- Osiguranje
- Bankarstvo i platni promet
- Tržišta kapitala i upravljanje imovinom
- Državna uprava i javni sektor
- Zdravstvo
- Znanosti o životu
- Kritična infrastruktura i energetika
- Obrana i sigurnost
- Pravne i profesionalne usluge
- Logistika i pomorstvo
Svaki paket treba osnovu Enterprise, a njih pet treba i dodatak. Paket Osiguranje treba Sobe za odlučivanje i zapečaćene zapise. Isto treba i paket Tržišta kapitala i upravljanje imovinom. Paket Pravne i profesionalne usluge treba ta dva plus Poštu. Logistika i pomorstvo treba Karte i GeoAI. U paketu Obrana i sigurnost, upozorenja platforme također trebaju Nexus Edge. Zasloni za telefone bilo kojeg paketa također trebaju Mobilne aplikacije. Poglavlje 1.7, Domenski paketi i vertikale, navodi što svaki od njih sadržava.
Skupine značajki
Jedinica koju licencija imenuje jest skupina značajki. Ima ih 32: temelj Community, skup Team, osnova Enterprise, po jedna za svaki dodatak i po jedna za svaki paket. Svaka mogućnost pripada točno jednoj skupini, pa licencija koja navodi „Osnova Enterprise, Karte i GeoAI, Logistika i pomorstvo” precizno kaže koje mogućnosti ova instalacija smije pokretati.
| Razina | Mogućnosti |
|---|---|
| Community | 36 |
| Team | 6 |
| Osnova Enterprise | 18 |
| Dodaci | 23 |
| Domenski paketi | 14 |
Opseg dodjele
Svaka licencirana mogućnost ima opseg dodjele, koji govori na što se dodjela veže.
- Opseg zakupca pokriva dijelove u kojima ljudi rade: Ideje, Pošta, Operacije prihoda, paketi. Licencija ih čini dostupnima instalaciji, a zatim se uključuju ili isključuju po organizaciji i po poslovnoj jedinici. Nova organizacija nikada ne nasljeđuje stanje u kojem je „sve uključeno”.
- Opseg implementacije pokriva pet stvari koje pripadaju instalaciji u cjelini: uvoz licencije s artefaktima koje dohvaća, oblike isporuke izdanja Enterprise, operaterske stranice, upravljanje klasterom i Nexus Edge.
Mogućnosti izdanja Community uopće nemaju opseg dodjele. Njima ne treba licencija.
Administrator može suziti ono što licencija dopušta, za organizaciju ili jedinicu. Nitko to ne može proširiti unutar same instalacije.
Jedan proizvod, dvije izgradnje
Postoji jedna baza koda za Nexus. Međuverzija Community njezin je izvoz otvorenog koda, a međuverzija Enterprise taj je izvoz plus zatvoreni moduli.
Popis granica dodjeljuje svaku praćenu datoteku određenom izdanju. Uglavnom to čini imenovanjem mogućnosti koju datoteka implementira, a izdanje datoteke proizlazi iz razine te mogućnosti: mogućnost izdanja Community čini datoteku izdanja Community, a sve što pripada razinama Team, osnova, dodatak ili paket čini datoteku izdanja Enterprise. Datoteke koje se ne isporučuju ni u jednom izdanju navedene su s razlogom. Jedno pravilo presijeca sva ostala: migracije baze podataka svakog modula isporučuju se u oba izdanja. Tako baza podataka izdanja Community i baza podataka izdanja Enterprise imaju istu shemu, a prelazak instalacije s jednog na drugo samo je promjena onoga što je uključeno, bez podataka koje treba migrirati.
Izvoz Community nosi zaglavlja Apache-2.0 i datoteku NOTICE, a svaki paket u njemu licenciran je pod Apache-2.0, osim koda trećih strana koji zadržava vlastitu licenciju (MIT, BSD i druge) i kopira se kakav jest, te nekoliko paketa kompleta za razvoj softvera (SDK) i sučelja naredbenog retka (CLI) koji zadržavaju vlastitu licenciju MIT. Međuverzija Enterprise licencirana je pod licencijom Adverant Enterprise. Njezini uvjeti dopuštaju korištenje samo pod pisanom licencijom, za razdoblje, implementacije i skupine značajki koje ta licencija imenuje. Zabrana obrnute analize izričito zadržava prava koja vam zakonodavstvo EU-a daje za proučavanje softvera i njegovo dekompiliranje radi interoperabilnosti.
Linija licencije
Kod izdanja Enterprise dopire do izdanja Community kroz samo jedan paket: @adverant/nexus-spi, sučelje pružatelja usluga (SPI). Ono je pod licencijom Apache-2.0 i sadržava sučelja i čuvare tipova, bez vlastite logike u vremenu izvođenja.
| Izvoz | Što je to |
|---|---|
RouteModule |
Licencirani modul ruta: njegov ID, njegova skupina značajki, tijela koja čita i register(app, ctx) |
SpiApp |
Dio HTTP aplikacije domaćina koji modul dotiče: use |
SpiContext |
Što glavno računalo predaje modulu: vrata proizvoda i čuvara opsega, čitač licencije, bazen upita ograničenog opsega, uzvodne adrese, klijente platforme |
SpiRuntime |
Vrijednosti SDK-a (kompleta za razvoj softvera) za dodatke koje glavno računalo predaje modulu |
SpiPlane |
Skupine zaslona i čitanja zaslona koje dodaje licencirana ravnina |
ScreenModule |
Licencirana skupina zaslona konzole: njezine rute, zasloni i izbornik |
GrantCheck |
Provjera koju licencirani modul pokreće nad vlastitom skupinom značajki |
Provjera pri izgradnji provodi tu liniju. Unutar koda izdanja Enterprise, uvoz iz opsega paketa izdanja Community (@adverant/ i @adverant-nexus/) ruši izgradnju osim ako je riječ o @adverant/nexus-spi ili paketu izdanja Enterprise. Isto čini i relativni uvoz koji izlazi izvan repozitorija, ovisnost file:, link: ili workspace: koja pokazuje izvan njega, Git URL koji imenuje repozitorij izdanja Community te Go replace koji pokazuje izvan njega. Preko te linije, povezivanje se odvija putem mrežnog protokola ili modula učitanog pri pokretanju, nikada putem dijeljenog izvornog koda. SPI čak nosi vlastitu fiksiranu kopiju deklaracija tipova SDK-a za dodatke, jer je SDK paket izdanja Community koji linija ne propušta; glavno računalo umjesto toga modulu predaje vrijednosti SDK-a u vremenu izvođenja.
Profili izgradnje
Konzola i BFF (backend za frontend) kompiliraju se s profilom izgradnje, koji fiksira klase koda unutar slike. Profil Community sadržava kod izdanja Community; profil Enterprise sadržava kod izdanja Community i Enterprise. Svaki se odbija pokrenuti kada njegov profil sadržava kod koji izdanje instalacije nema. BFF to objavljuje uz PROFILE_OUTSIDE_EDITION i imenuje sliku koju treba implementirati umjesto toga. Ne možete staviti konzolu Enterprise na instalaciju Community ponovnim označavanjem slike.
Kako licencija uključuje skupine značajki
Licencija je potpisani dokument. Adverant potpisuje svaku licenciju s dva neovisna ključa i ništa drugo na instalaciji ne odlučuje što je licencirano. Uvozite je putem stranica Licencije u konzoli, pomoću nexusctl licence import <file> ili slanjem dokumenta na https://<hosts.auth>/api/v1/installation/licence. Licencija nikada nije vrijednost u chartu i nikada nije montirana datoteka. Poglavlje 2.13, Licencije, obrađuje uvoz i obnovu te svako stanje kroz koje licencija prolazi.
Provjera koja je bitna izvodi se unutar svakog zatvorenog modula, nad vlastitom skupinom značajki tog modula, prije nego što on odgovori. To je ugovor GrantCheck iz SPI-ja:
type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;Provjera se nalazi u zatvorenom modulu jer bi se provjera napisana u otvorenom kodu mogla jednostavno izbrisati. Krivotvorena licencija računa se kao nepostojeća licencija. Modul čiju skupinu značajki licencija ne imenuje odgovara s LICENCE_LOCKED.
Provjeravaju se i sami moduli. nexus-keys čuva potpisani manifest dijelova izdanja i ključ kojim je potpisan. Provjerava svaki kompilirani modul u odnosu na taj manifest pri pokretanju i ponovno svake noći u 03:53 UTC. Modul čiji se potpis ne podudara nikada se ne učitava, a potpisana kopija koju je trebao zamijeniti nastavlja raditi; operaterske stranice to prikazuju s MODULE_SIGNATURE_INVALID.
Iznad provjere modula nalazi se sloj prikaza, koji odlučuje kako se mogućnost prikazuje svakoj osobi. On kombinira dodjele iz licencije s planom organizacije i ulogom osobe, pa svaka kontrola završi u jednom od četiri stanja.
| Stanje | Što osoba vidi |
|---|---|
| Ovlašteno | Kontrola, iscrtana normalno |
| Najava | Kontrola zasivljena s lokotom; otvaranje objašnjava što je to i tko je može uključiti |
| Skriveno | Ništa; koristi se samo za stvari za koje uloga ove osobe ne smije znati da postoje, kao što je privatni poštanski sandučić druge osobe |
| Odbijeno s kodom | Pločica odbijanja koja navodi kod, kada netko pokuša radnju koja nije dopuštena |
Licencija također ima vlastita stanja kako se približava datumu isteka i prelazi ga. Dva pravila vrijede u svakom od njih: licencija nikada ne zaustavlja rad u tijeku, a sigurnosne zakrpe nikada se ne uskraćuju.
Što Community prikazuje za stranicu izdanja Enterprise
Instalacija Community zadržava oblik proizvoda. Izbornik ima iste retke kao i Enterprise, a oni koji pripadaju izdanju Enterprise (Ideje, Odluke, Pošta, Pozivi, Druge tvrtke, Agenti, Pravila, Usklađenost) iscrtani su zasivljeno s ikonom lokota. Ništa nije skriveno kako bi izdanje izgledalo cjelovito i ništa ne dosađuje porukama.
Otvaranje zaključanog retka prikazuje najavu. Za Ideje piše „Ideje su dio izdanja Enterprise”, zatim jedan odlomak o tome što Ideje rade, a potom „Tko to može uključiti: vaš administrator, putem licencije tvrtke Adverant”. Nudi dva gumba, „Pitajte svog administratora” i „Pogledajte što radi”. Nema cijene. Otvaranje stranice ništa ne učitava i ništa ne šalje, a promocija se prikazuje jednom.
Upisivanje adrese stranice koja postoji samo u izdanju Enterprise također vodi na korisno mjesto. Konzola Community poznaje adrese stranica koje ne sadržava i šalje svaku od njih na svoju stranicu o izdanju, unutar normalnog okvira s izbornikom. Stranica iscrtava pločicu zaključane značajke:
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
Kod je tu za referencu; rečenice su za osobu koja ih čita.
Temelj
Neke se stvari nikada ne zaključavaju iza naplate, ni u kojem izdanju, ni pod kojim stanjem licencije: osnove administracije i sigurnosti, odvajanje zakupaca, izvoz podataka, odjava i svaki zaslon odbijanja. Instalacija Community ima ih sve. Instalacija Enterprise čija je licencija istekla također ih zadržava: artefakti izdanja Enterprise prestaju se nuditi, a temelj Community i izvoz podataka ostaju. Uvijek možete izvući svoje podatke.
Slike prema izdanju
Svaka slika u izdanju navedena je, prema sažetku (digest), u zaključanom popisu slika charta, a sam taj popis pripada jednom izdanju. Chart provjerava svaku sliku koju iscrtava u odnosu na zaključani popis i u odnosu na izdanje koje ste zatražili. Instalacija Community prima samo slike izdanja Community. Zatražite li bilo što drugo, zaustavlja se: „a community install takes only community images”. Zaključani popis za Enterprise sadržava slike izdanja Community te slike izgrađene za izdanje Enterprise.
To je važno zbog mjesta s kojeg povlačite slike. Slike izdanja Community javne su, na adresi registry.adverant.ai/nexus/<service>@sha256:…. Slike izdanja Enterprise dolaze iz istog registra pomoću tokena za povlačenje, koji dobivate na stranici „Pull tokens and install commands” svog Adverant računa. Instalacija Community nikada ne treba taj token i nikada ne sadržava niti jedan bajt zatvorenog koda.
Put nadogradnje čuva postojeću instalaciju. Kada administrator izdanja Community uveze licenciju Enterprise, konzola je pročita i verificira, a zatim prikazuje dijelove koje će dohvatiti (kompilirane module te pakete i dodatke koje licencija imenuje) s njihovim veličinama. Svaki se dio provjerava u odnosu na ključ izdanja tvrtke Adverant, a skupine se uključuju jedna po jedna. Ljudi i datoteke ostaju kakvi jesu, kao i tijekovi rada i kanali, jer je shema već bila ista. Poglavlje 2.7, Instaliranje izdanja Enterprise i primjena licencije, prolazi kroz taj postupak na platformi Kubernetes; izolirane (air-gapped) lokacije uvoze iste dijelove s medija, kako opisuje poglavlje 2.10, Izolirana instalacija.
Oblici isporuke i razredi zaštite
Nexus se isporučuje u šest oblika isporuke, koje matrica naziva SKU-ovima (jedinicama za vođenje zaliha). Pet oblika osim oblika Edge dijeli jedan potpisani paket, a razlikuju se u pakiranju i načinu na koji licencija stiže.
| SKU | Što je to | Kako licencija stiže |
|---|---|---|
saas |
Adverant oblak | Izdaje se s pretplatom |
onprem-connected |
Helm na vaš vlastiti Kubernetes | Instalacija je povlači putem svoje odlazne veze |
airgap |
Isti paket, uvezen izvanmrežno | Uvozi se kao datoteka, uz potpisanu izjavu o korištenju jednom godišnje |
self-serve-image |
Slika stroja na vašem vlastitom računu u oblaku | Sama slika nosi samo licencije Community i licencije za procjenu; moduli Enterprise stižu nakon izdavanja licencije, uključujući onu kupljenu putem trgovine u oblaku |
appliance |
Hardver koji je izradio proizvođač izvorne opreme (OEM), koji je njegov službeni proizvođač | Licencija Enterprise; uređaj je jedan od njezinih oblika isporuke |
edge |
Nexus Edge, korisni teret na satelitima i dronovima ili na plovilima i vozilima | Jedna licencija po platformi ili floti, dugotrajna, valjana dok je izvan mreže |
Zaštita je druga polovica isporuke i o njoj vrijedi govoriti otvoreno. Jednom kada se kod izvodi na hardveru koji vi kontrolirate, nijedna ga tehnika ne može učiniti nečitljivim. Stoga Adverant svrstava svoj kod u klase zaštite i odlučuje, za svaki oblik isporuke, koliko daleko svaka klasa smije putovati. Postoje četiri razine:
| Klasa | Što to znači |
|---|---|
| P1, nikada se ne isporučuje | Logika se izvodi u tvrtki Adverant; instalacija sadržava potpisanog klijenta. |
| P2, zapečaćeno | Povjerljivi virtualni stroj (VM) u koji se ne možete prijaviti, na hardveru koji ne možete dotaknuti. |
| P3, ojačani nativni kod | Kompiliran, ogoljen i izgrađen za svakog korisnika licencije. Podiže trošak čitanja koda sa sati na tjedne. |
| P4, čitljivo | Obični JavaScript ili TypeScript, kakav je i otvoreni kod. |
| Klasa zaštite | Adverant oblak | Povezano na vlastitoj lokaciji | Izolirano (air-gap) | Nexus Edge |
|---|---|---|---|---|
| Otvoreni kod (cijeli Community) | P4 | P4 | P4 | P4 |
| Kod najveće vrijednosti: bodovanje ideja, jezgra pohrane zapečaćenih zapisa, pogon pravila usmjeravanja, četiri pogona za odlučivanje paketa Osiguranje | P1 | P3 ili P2 kao povjerljivi VM koji je zapečatio Adverant u vašem zakupu oblaka | P3 | Ne isporučuje se |
| Zatvoreni poslužiteljski moduli koji donose odluke: poslužiteljski kod paketa, mobilni pristupnik | P1 | P3 | P3 | Ne isporučuje se |
| Poslužiteljski kod paketa Obrana i sigurnost | P1 | P3 | P3 | P3 |
| Kod korisnog tereta za Nexus Edge | Ne isporučuje se | Ne isporučuje se | Ne isporučuje se | P3 |
| Čitljive definicije klijenta: telefonske aplikacije, zasloni paketa za telefone | P4 | P4 | P4 | P4 |
Iz toga proizlaze dvije posljedice. Ništa zaštićeno ne isporučuje se u telefonskoj aplikaciji: svako pravilo i upit ostaju na poslužitelju. A vrijednost sadržana u upitima, rubrikama ili lancima agenata čitljiva je onomu tko pokreće model kojem se šalje. Tamo gdje je vaša organizacija vlasnik modela, ta je vrijednost zaštićena ugovorom o licenciji i ničim drugim. Svaka isporučena TypeScript slika zapakirana je i minificirana bez mapa izvornog koda, što je više radi urednosti nego zaštite.
Što to znači kada gradite proširenje
Vaše proširenje nalazi se na istoj liniji kao i vlastiti moduli tvrtke Adverant. Gotovo sve u ovom poglavlju vrijedi i za njega.
Izolacija, identitet i put AI-ja dolaze s platformom u oba izdanja. Dodatak izgrađen pomoću @adverant-nexus/plugin-sdk nasljeđuje ogradu upita ograničenog opsega, verifikator tokena i UNO otpremu, bez obzira na to u kojem izdanju završi. Poglavlje 2.19, Pravila koja nasljeđuje svako proširenje, navodi ih.
Ograničavanje prema izdanju funkcionira na isti način i za vas. Dodatak deklarira svoje ID-ove značajki u bloku entitlements svog manifesta (featureIdPattern, plus kratki popis alwaysOn koji se čuva za provjere ispravnosti i stranicu postavki) i traži od platforme presudu prije nego što posluži ograničenu površinu. Presuda nikada nije obična Booleova vrijednost. ENTITLEMENT_DENIED (403) znači da je platforma odgovorila „ne”. ENTITLEMENT_UNREACHABLE (502) znači da nije bilo odgovora, a vaš dodatak mora odbiti pristup umjesto da pretpostavlja, jer ispad sustava protumačen kao „nije ovlašteno” tiho spušta razinu usluge svim korisnicima odjednom. Odgovor „da” kratko spremite u predmemoriju, a odbijanje nikada ne spremajte u predmemoriju.
U izdanju Community razvojni inženjer dobiva iste početne predloške kao u izdanju Enterprise, za dodatke i leće, kao i za vještine i tijekove rada. Svaki razvojni inženjer radi u razvojnom prostoru s granama podataka na jednom poslužitelju, a kod se nalazi na platformi GitHub. Predlošci domenskih paketa i platforme pripadaju izdanju Enterprise. Isto vrijedi i za vremenski ograničeno podizanje razine pristupa iz IDE-a (integriranog razvojnog okruženja): u izdanju Community nema zasebne produkcije u koju biste mogli podići svoj pristup, a konzola to navodi uz PASS_TIER_REQUIRED.
Proširenje koje koristi samo spojeve izdanja Community izvodi se u bilo kojem izdanju nepromijenjeno. Ono koje ovisi o dodatku, primjerice Pošti, prikazuje se kao zaključano svugdje gdje licencija ne imenuje tu skupinu. Poglavlje 2.25, Izgradnja za svako izdanje, pokazuje kako strukturirati proširenje za oba izdanja i kako ga testirati u odnosu na svako od njih.



