Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.2
Izdanja ispod haube
Kako su izdanja Community i Enterprise izgrađena od jednog proizvoda, kako licenca uključuje grupe funkcija tokom rada, šta Community instalacija prikazuje za Enterprise stranicu i šta to znači za slike koje preuzimate i proširenja koja gradite.
Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

Dva reda u values datoteci određuju koje izdanje instalacija pokreće:
# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
enabled: trueOni moraju biti usklađeni. Ako postavite edition: community uz enterprise.enabled: true, chart se zaustavlja porukom "edition=community but enterprise.enabled=true: they must agree". Ako edition postavite na bilo šta osim community ili enterprise, zaustavlja se sa NEXUS_EDITION_INVALID. Te dve vrednosti biraju koje image-e instalacija preuzima. Šta ti image-i zatim uključuju stvar je licence, u toku rada, jedna grupa funkcija po jedna.
Ovo poglavlje to detaljno razlaže: šta izdanja sadrže, kako jedan proizvod postaje dva builda, kako se licenca pretvara u da ili ne unutar pokrenutog servisa i šta to znači kada gradite nešto svoje. Poglavlje 1.6, Izdanja i licence jednostavnim rečima, daje pogled kupca; ovo je pogled inženjera.
Matrica izdanja
Sve u ovom poglavlju potiče iz jedne datoteke, matrice izdanja. Ona navodi 97 mogućnosti i svakoj dodeljuje nivo. Adverant iz nje generiše katalog licenci i pravila menija konzole, kao i granicu između otvorenog i zatvorenog koda. Kada se matrica promeni, sve to se menja zajedno.
Postoje tri izdanja.
| Izdanje | Licenca | Gde se pokreće |
|---|---|---|
| Community | Apache-2.0, otvoreni kod, besplatno | Vaš hardver ili Adverant cloud |
| Team | Adverant Enterprise licenca | Adverant cloud: Community plus Team skup |
| Enterprise | Adverant Enterprise licenca, po grupi funkcija | Vaš hardver ili Adverant cloud |
Instalacija pokreće jedno od dva: vrednost edition u chartu prihvata samo community i enterprise. Team je cloud izdanje, a Enterprise sadrži i Team skup, pa na Vašem sopstvenom hardveru Team mogućnosti (radni panel usidren pored svakog zapisa, deljene beleške, politika memorije za organizaciju i ostalo) dolaze uz Enterprise.
Sam Enterprise je slojevit. Enterprise osnova je zatvoreno jezgro: više organizacija i poslovnih jedinica, obavezno jedinstveno prijavljivanje uz SAML (Security Assertion Markup Language) i sinhronizaciju direktorijuma, prilagođene uloge sa odobrenjima po principu četiri oka, dugo čuvanje revizorskih zapisa, zaštita podataka, operatorske stranice i upravljanje klasterom. Na osnovu se nadovezuju dodaci, svaki licenciran zasebno, i domenski paketi. Prvi dodatak u tabeli, AI Gateway na velikoj skali, raspoređuje opterećenje AI (veštačka inteligencija) rutera na replike i provajdere.
| Dodatak | Takođe zahteva |
|---|---|
| AI Gateway u velikom obimu | Osnova |
| Fabrika modela | Osnova |
| Ideje | Osnova |
| Pozivi i glas | Osnova |
| Pošta | Osnova |
| Druge firme i zidovi | Osnova |
| Studio beležnica | Osnova |
| Mapa i GeoAI | Osnova |
| Konektori podataka | Osnova |
| Agent-agentu | Osnova |
| Sobe za odlučivanje i zapečaćeni zapisi | Osnova |
| Operacije prihoda | Osnova |
| Prodavnica / white-label | Osnova |
| Nexus Edge | Osnova |
| Mobilne aplikacije | Osnova |
| Radna snaga | Osnova; agentima na edge uređajima potreban je i Nexus Edge, odobrenjima na telefonu potrebne su i Mobilne aplikacije |
| Shield | Osnova |
| Izolovana okruženja (sandbox) | Osnova |
| Kvalitet (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
- Nauke o životu (Life sciences)
- Kritična infrastruktura i energetika
- Odbrana i bezbednost
- Pravne i stručne usluge
- Logistika i pomorstvo
Svakom paketu potrebna je Enterprise osnova, a pet njih zahteva i dodatak. Paketu Osiguranje potrebne su Sobe za odlučivanje i zapečaćeni zapisi. Isto važi i za paket Tržišta kapitala i upravljanje imovinom. Paketu Pravne i profesionalne usluge potrebna su ta dva plus Mail. Paketu Logistika i pomorstvo potrebni su Mapa i GeoAI. U paketu Odbrana i bezbednost, upozorenjima platforme potreban je i Nexus Edge. Ekranima za telefon bilo kog paketa potrebne su i Mobilne aplikacije. Poglavlje 1.7, Domenski paketi i vertikale, opisuje šta svaki sadrži.
Grupe funkcija
Jedinica koju licenca imenuje je grupa funkcija. Ima ih 32: Community osnovni nivo, Team skup, Enterprise osnova, po jedna za svaki dodatak i po jedna za svaki paket. Svaka mogućnost pripada tačno jednoj, pa licenca koja navodi „Enterprise osnova, Mapa i GeoAI, Logistika i pomorstvo“ precizno kazuje koje mogućnosti ova instalacija sme da pokreće.
| Nivo | Mogućnosti |
|---|---|
| Community | 36 |
| Team | 6 |
| Enterprise osnova | 18 |
| Dodaci | 23 |
| Domenski paketi | 14 |
Opseg dodele
Svaka licencirana mogućnost ima opseg dodele, koji određuje na šta se dodela odnosi.
- Opseg tenanta obuhvata delove u kojima ljudi rade: Ideje, Mail, Operacije prihoda, pakete. Licenca ih čini dostupnim instalaciji, a zatim se uključuju ili isključuju po organizaciji i po poslovnoj jedinici. Nova organizacija nikada ne nasleđuje stanje „sve uključeno“.
- Opseg implementacije obuhvata pet stvari koje pripadaju instalaciji kao celini: uvoz licence sa artefaktima koje preuzima, Enterprise oblike isporuke, operatorske stranice, upravljanje klasterom i Nexus Edge.
Community mogućnosti uopšte nemaju opseg dodele. Za njih licenca nije potrebna.
Administrator može suziti ono što licenca dozvoljava, za organizaciju ili jedinicu. Niko ga ne može proširiti iznutra, iz instalacije.
Jedan proizvod, dve verzije za izgradnju
Postoji jedna Nexus baza koda. Community build je njen izvoz otvorenog koda, a Enterprise build je taj izvoz plus zatvoreni moduli.
Lista granica dodeljuje svaku praćenu datoteku nekom izdanju. Uglavnom to čini navodeći mogućnost koju datoteka implementira, a izdanje datoteke proizlazi iz nivoa te mogućnosti: Community mogućnost daje Community datoteku, a sve što je Team, osnova, dodatak ili paket daje Enterprise datoteku. Datoteke koje se ne isporučuju ni u jednom izdanju navedene su uz razlog. Jedno pravilo važi nezavisno od ostalih: migracije baze podataka svakog modula isporučuju se u oba izdanja. Tako Community baza i Enterprise baza imaju istu šemu, a prelazak instalacije sa jednog izdanja na drugo predstavlja promenu onoga što je uključeno, bez podataka za migraciju.
Community izvoz nosi Apache-2.0 zaglavlja i NOTICE datoteku, i svaki paket u njemu licenciran je pod Apache-2.0, osim koda trećih strana koji zadržava sopstvenu licencu (MIT, BSD i druge) i kopiran je u izvornom obliku, i nekoliko paketa kompleta za razvoj softvera (SDK) i interfejsa komandne linije (CLI) koji zadržavaju sopstvenu MIT licencu. Enterprise build licenciran je pod Adverant Enterprise licencom. Njeni uslovi dozvoljavaju korišćenje samo na osnovu pisane licence, za period, implementacije i grupe funkcija koje ta licenca navodi. Zabrana obrnutog inženjeringa izričito zadržava prava koja Vam pravo EU daje da proučavate softver i da ga dekompajlirate radi interoperabilnosti.
Linija licence
Enterprise kod dopire do Community koda samo kroz jedan paket: @adverant/nexus-spi, interfejs pružaoca usluga (SPI). On je pod Apache-2.0 licencom i sadrži interfejse i provere tipova, bez sopstvene logike u toku rada.
| Izvoz | Šta je to |
|---|---|
RouteModule |
Licencirani modul ruta: njegov id, njegova grupa funkcija, tela zahteva koja čita i register(app, ctx) |
SpiApp |
Deo HTTP aplikacije hosta koji modul dodiruje: use |
SpiContext |
Ono što host predaje modulu: proveru proizvoda i čuvara opsega, čitač licence, pool upita sa opsegom, adrese upstream servisa, klijente platforme |
SpiRuntime |
Vrednosti plugin SDK-a (komplet za razvoj softvera) koje host predaje modulu |
SpiPlane |
Grupe ekrana i čitanja ekrana koje licencirani sloj dodaje |
ScreenModule |
Licencirana grupa ekrana konzole: njene rute, ekrani i meni |
GrantCheck |
Provera koju licencirani modul izvršava nad sopstvenom grupom funkcija |
Provera u buildu sprovodi ovu liniju. Unutar Enterprise koda, import iz opsega Community paketa (@adverant/ i @adverant-nexus/) obara build, osim ako nije @adverant/nexus-spi ili Enterprise paket. Isto važi za relativni import koji izlazi iz repozitorijuma, file:, link: ili workspace: zavisnost koja upućuje van njega, Git URL koji imenuje Community repozitorijum i Go replace koji upućuje van njega. Preko linije, povezivanje je mrežni protokol ili modul učitan pri pokretanju, nikada deljeni izvorni kod. SPI čak nosi sopstvenu fiksiranu kopiju deklaracija tipova plugin SDK-a, jer je SDK Community paket koji linija ne propušta; umesto toga host modulu predaje vrednosti SDK-a u toku rada.
Build profili
Konzola i BFF (backend for frontend) kompajliraju se sa build profilom, koji određuje klase koda unutar image-a. Community profil sadrži Community kod; Enterprise profil sadrži Community i Enterprise kod. Svaki odbija da se pokrene kada njegov profil sadrži kod koji izdanje instalacije ne sadrži. BFF to javlja sa PROFILE_OUTSIDE_EDITION i navodi image koji treba implementirati umesto toga. Enterprise konzolu ne možete postaviti na Community instalaciju ponovnim tagovanjem image-a.
Kako licenca uključuje grupe funkcionalnosti
Licenca je potpisani dokument. Adverant potpisuje svaku licencu sa dva nezavisna ključa, i ništa drugo na instalaciji ne odlučuje o tome šta je licencirano. Uvozite je preko stranica Licenca u konzoli, pomoću nexusctl licence import <file> ili slanjem dokumenta na https://<hosts.auth>/api/v1/installation/licence. Licenca nikada nije vrednost charta niti montirana datoteka. Poglavlje 2.13, Licence, obrađuje uvoz i obnovu, kao i svako stanje kroz koje licenca prolazi.
Provera koja je bitna izvršava se unutar svakog zatvorenog modula, nad sopstvenom grupom funkcija tog modula, pre nego što odgovori. To je ugovor GrantCheck iz SPI-ja:
type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;Provera se nalazi u zatvorenom modulu jer bi provera napisana u otvorenom kodu mogla jednostavno da se obriše. Falsifikovana licenca se smatra nepostojećom licencom. Modul čiju grupu funkcija licenca ne navodi odgovara sa LICENCE_LOCKED.
I sami moduli se proveravaju. nexus-keys čuva potpisani manifest delova izdanja i ključ kojim je potpisan. On proverava svaki kompajlirani modul u odnosu na taj manifest pri pokretanju i ponovo svake noći u 03:53 UTC. Modul čiji se potpis ne poklapa nikada se ne učitava, a potpisana kopija koju bi zamenio nastavlja da radi; operatorske stranice to prikazuju sa MODULE_SIGNATURE_INVALID.
Iznad provere modula nalazi se sloj prikaza, koji određuje kako se mogućnost prikazuje svakoj osobi. On kombinuje dodele iz licence sa planom organizacije i ulogom osobe, i svaka kontrola završava u jednom od četiri stanja.
| Stanje | Šta osoba vidi |
|---|---|
| Ovlašćeno | Kontrola, prikazana normalno |
| Najava | Kontrola zasivljena sa katancem; kada je otvorite, objašnjava šta je i ko može da je uključi |
| Skriveno | Ništa; koristi se samo za stvari za koje uloga te osobe ne sme da zna da postoje, kao što je privatno poštansko sanduče druge osobe |
| Odbijeno sa kodom | Pločica odbijanja koja navodi kod, kada neko pokuša radnju koja nije dozvoljena |
Licenca takođe ima sopstvena stanja dok se približava datumu isteka i nakon njega. U svakom od njih važe dva pravila: licenca nikada ne zaustavlja rad u toku, a bezbednosne ispravke se nikada ne uskraćuju.
Šta Community prikazuje za Enterprise stranicu
Community instalacija zadržava oblik proizvoda. Meni ima iste redove kao Enterprise, a Enterprise redovi (Ideje, Odluke, Mail, Pozivi, Druge firme, Agenti, Politike, Usklađenost) prikazani su zasivljeno sa ikonom katanca. Ništa se ne skriva da bi izdanje izgledalo potpuno, i ništa ne zanovetа.
Otvaranje zaključanog reda prikazuje najavu. Za Ideje ona glasi „Ideje su deo Enterprise izdanja“, zatim sledi jedan pasus o tome šta Ideje rade, pa „Ko može da ih uključi: Vaš administrator, putem licence od kompanije Adverant“. Nudi dva dugmeta, „Pitajte administratora“ i „Pogledajte šta radi“. Cena se ne navodi. Otvaranje stranice ništa ne učitava i ništa ne šalje, a promocija se prikazuje jednom.
I unos adrese stranice koja postoji samo u Enterprise izdanju vodi na korisno mesto. Community konzola zna adrese stranica koje ne sadrži i svaku od njih upućuje na svoju stranicu izdanja, unutar uobičajenog okvira sa menijem. Stranica prikazuje pločicu zaključane funkcije:
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 radi referenciranja; rečenice su za osobu koja ih čita.
Osnovni nivo
Neke stvari nikada nisu iza naplate, ni u jednom izdanju, ni u jednom stanju licence: osnove administracije i bezbednosti, razdvajanje tenanata, izvoz podataka, odjavljivanje i svaki ekran odbijanja. Community instalacija ima sve njih. Enterprise instalacija čija je licenca istekla takođe ih zadržava: Enterprise artefakti prestaju da se nude, a Community osnovni nivo i izvoz podataka ostaju. Svoje podatke uvek možete izvući.
Slike kontejnera po izdanjima
Svaki image u izdanju naveden je, prema digestu, u image lock datoteci charta, a sam lock pripada jednom izdanju. Chart proverava svaki image koji generiše u odnosu na lock i u odnosu na izdanje koje ste zatražili. Community instalacija prihvata samo Community image-e. Ako od nje zatražite bilo šta drugo, ona se zaustavlja: "a community install takes only community images". Enterprise lock sadrži Community image-e i Enterprise buildove.
To je važno za izvor iz kog preuzimate image-e. Community image-i su javni, na registry.adverant.ai/nexus/<service>@sha256:…. Enterprise image-i dolaze iz istog registra uz token za preuzimanje, koji dobijate na stranici "Pull tokens and install commands" vašeg Adverant naloga. Community instalaciji taj token nikada nije potreban i ona nikada ne sadrži ni bajt zatvorenog koda.
Putanja nadogradnje zadržava instalaciju. Kada administrator Community izdanja uveze Enterprise licencu, konzola je čita i verifikuje, a zatim prikazuje delove koje će preuzeti (kompajlirane module i pakete i dodatke koje licenca navodi) sa njihovim veličinama. Svaki deo se proverava u odnosu na Adverant ključ izdanja, a grupe se uključuju jedna po jedna. Korisnici i datoteke ostaju kakvi jesu, kao i tokovi rada i kanali, jer je šema već bila ista. Poglavlje 2.7, Instaliranje Enterprise izdanja i primena licence, opisuje postupak na Kubernetes platformi; lokacije bez mrežne veze (air-gapped) uvoze iste delove sa medija, kako opisuje poglavlje 2.10, Instalacija bez mrežne veze.
Oblici isporuke i klase zaštite
Nexus se isporučuje u šest oblika isporuke, koje matrica naziva SKU (jedinice za praćenje zaliha). Pet oblika osim Edge dele jedan potpisani paket i razlikuju se po pakovanju i po načinu na koji licenca stiže.
| SKU | Šta je to | Kako licenca stiže |
|---|---|---|
saas |
Adverant oblak | Izdaje se uz pretplatu |
onprem-connected |
Helm na vaš sopstveni Kubernetes | Instalacija je preuzima putem svoje odlazne veze |
airgap |
Isti paket, uvezen van mreže | Uvozi se kao datoteka, uz potpisani izveštaj o korišćenju jednom godišnje |
self-serve-image |
Mašinski image na vašem sopstvenom nalogu u oblaku | Sam image sadrži samo Community i probne licence; Enterprise moduli stižu kada se licenca izda, uključujući i onu kupljenu preko prodavnice oblaka |
appliance |
Hardver koji proizvodi proizvođač originalne opreme (OEM), koji je njegov zvanični proizvođač | Enterprise licenca; uređaj je jedan od njenih oblika isporuke |
edge |
Nexus Edge, korisni teret na satelitima i dronovima, ili na plovilima i vozilima | Jedna licenca po platformi ili floti, dugotrajna, važeća i van mreže |
Zaštita je druga polovina isporuke i vredi o njoj govoriti otvoreno. Kada se kod izvršava na hardveru koji vi kontrolišete, nijedna tehnika ga ne čini nečitljivim. Zato Adverant razvrstava svoj kod u klase zaštite i za svaki oblik isporuke određuje koliko daleko svaka klasa sme da stigne. Postoje četiri nivoa:
| Klasa | Šta znači |
|---|---|
| P1, nikada se ne isporučuje | Logika se izvršava kod Adverant-a; instalacija sadrži potpisani klijent. |
| P2, zapečaćeno | Poverljiva virtuelna mašina (VM) na koju ne možete da se prijavite, na hardveru kom ne možete da pristupite. |
| P3, ojačani izvorni kod | Kompajliran, očišćen od simbola i izgrađen za svakog vlasnika licence. Podiže cenu čitanja koda sa nekoliko sati na nekoliko nedelja. |
| P4, čitljivo | Običan JavaScript ili TypeScript, kao kod otvorenog koda. |
| Klasa zaštite | Adverant oblak | Povezano lokalno | Bez mrežne veze | Nexus Edge |
|---|---|---|---|---|
| Otvoreni kod (celo Community izdanje) | P4 | P4 | P4 | P4 |
| Kod najveće vrednosti: ocenjivanje ideja, jezgro skladišta zapečaćenih zapisa, mehanizam politika rutiranja, četiri mehanizma odlučivanja paketa Insurance | P1 | P3, ili P2 kao poverljiva VM koju je zapečatio Adverant u vašem zakupu u oblaku | P3 | Ne isporučuje se |
| Zatvoreni serverski moduli koji donose odluke: serverski kod paketa, mobilni gateway | P1 | P3 | P3 | Ne isporučuje se |
| Serverski kod paketa za odbranu i bezbednost | P1 | P3 | P3 | P3 |
| Kod korisnog tereta Nexus Edge | Ne isporučuje se | Ne isporučuje se | Ne isporučuje se | P3 |
| Čitljive klijentske definicije: aplikacije za telefon, ekrani paketa za telefon | P4 | P4 | P4 | P4 |
Iz toga slede dve posledice. Ništa zaštićeno se ne isporučuje u aplikaciji za telefon: svako pravilo i prompt ostaju na serveru. A vrednost sadržana u promptovima, rubrikama ili lancima agenata čitljiva je svakome ko pokreće model kom se šalje. Tamo gde je vaša organizacija vlasnik modela, tu vrednost štiti ugovor o licenci i ništa drugo. Svaki isporučeni TypeScript image je spakovan i minifikovan bez source map datoteka, što je više urednost nego zaštita.
Šta ovo znači kada gradite proširenje
Vaše proširenje nalazi se na istoj liniji kao i Adverant-ovi sopstveni moduli. Gotovo celo ovo poglavlje odnosi se i na njega.
Izolacija, identitet i AI putanja dolaze uz platformu u oba izdanja. Plugin izgrađen pomoću @adverant-nexus/plugin-sdk nasleđuje ogradu ograničenih upita, verifikator tokena i UNO dispečovanje, bez obzira na to na kom izdanju se nađe. Poglavlje 2.19, Pravila koja nasleđuje svako proširenje, ih navodi.
Ograničavanje po izdanju funkcioniše isto i za vas. Plugin deklariše identifikatore svojih funkcija u bloku entitlements svog manifesta (featureIdPattern, plus kratka lista alwaysOn koja se čuva za provere ispravnosti i stranicu podešavanja) i traži od platforme presudu pre nego što posluži ograničenu površinu. Presuda nikada nije goli boolean. ENTITLEMENT_DENIED (403) znači da je platforma odgovorila odrečno. ENTITLEMENT_UNREACHABLE (502) znači da odgovora nije bilo, i vaš plugin mora da odbije umesto da pretpostavlja, jer prekid rada protumačen kao "nema prava" tiho degradira sve korisnike odjednom. Potvrdan odgovor kratko keširajte, a odbijanje nikada ne keširajte.
Na Community izdanju programer dobija iste početne šablone kao na Enterprise izdanju, za pluginove i lense, kao i za veštine i tokove rada. Svaki programer radi u razvojnom prostoru sa granama podataka na jednom serveru, a kod se nalazi na GitHub-u. Šabloni za domenske pakete i platformu su Enterprise. Isto važi i za vremenski ograničeno podizanje pristupa iz IDE-a (integrisanog razvojnog okruženja): na Community izdanju ne postoji zasebna produkcija u koju biste podigli svoj pristup, i konzola to saopštava pomoću PASS_TIER_REQUIRED.
Proširenje koje koristi samo Community spojeve radi nepromenjeno na oba izdanja. Proširenje koje zavisi od dodatka, na primer Mail, prikazuje se kao zaključano svuda gde licenca ne navodi tu grupu. Poglavlje 2.25, Razvoj za svako izdanje, pokazuje kako da strukturirate proširenje za oba izdanja i kako da ga testirate na svakom od njih.



