ВходЗапазете среща

Глава 2.2

Изданията отвътре

Как Community и Enterprise се изграждат от един продукт, как лицензът включва групи от функции по време на изпълнение, какво показва инсталация на Community за страница от Enterprise и какво означава това за образите, които изтегляте, и разширенията, които изграждате.

Тази страница е преведена от ИИ от английския оригинал. Ако нещо е неясно, английската страница е референтна. Прочетете тази страница на английски

17 минути за четене

Два реда във файла със стойности (values) определят кое издание стартира дадена инсталация:

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

Те трябва да съвпадат. Задайте edition: community заедно с enterprise.enabled: true и чартът спира със съобщение „edition=community but enterprise.enabled=true: they must agree“. Задайте edition на каквото и да е друго освен community или enterprise и той спира с NEXUS_EDITION_INVALID. Тези две стойности избират кои образи да използва инсталацията. Какво след това включват тези образи е работа на лиценза, по време на изпълнение, група от функции по група от функции.

Тази глава разглежда това в детайли: какво съдържат изданията, как един продукт се превръща в две компилации (builds), как един лиценз се превръща в „да“ или „не“ в рамките на работеща услуга и какво означава това, когато изграждате нещо свое. Глава 1.6, Издания и лицензи на достъпен език, представя гледната точка на купувача; тази представя гледната точка на инженера.

Матрицата на изданията

Всичко в тази глава идва от един файл – матрицата на изданията. Тя изброява 97 възможности и задава ниво на всяка от тях. От нея Adverant генерира каталога с лицензи и правилата за менютата на конзолата, заедно с границата между отворения и затворения код. Когато матрицата се промени, всички те се променят заедно.

Има три издания.

Издание Лиценз Къде работи
Community Apache-2.0, отворен код, безплатно Вашият хардуер или облакът на Adverant
Team Лиценз Adverant Enterprise Облак на Adverant: Community плюс набора Team
Enterprise Лиценз Adverant Enterprise, за група от функции Вашият хардуер или облакът на Adverant

Една инсталация изпълнява едно от двете: стойността edition на чарта приема само community и enterprise. Team е облачно издание, а Enterprise съдържа и набора Team, така че на вашия собствен хардуер възможностите на Team (работният панел, прикачен до всеки запис, споделените бележници, политиката за памет на организацията и останалото) идват с Enterprise.

Самото издание Enterprise е на слоеве. Базата на Enterprise е затвореното ядро: няколко организации и бизнес единици, прилагане на еднократно влизане (SSO) със SAML (Security Assertion Markup Language) и синхронизация на директории, потребителски роли с одобрение от четири очи, дълго запазване на одитни записи, защита на данните, операторските страници и управление на клъстери. Върху базата стоят добавки, всяка лицензирана отделно, и домейн пакети. Първата добавка в таблицата, AI Gateway в мащаб, разпределя натоварването на рутера за ИИ (изкуствен интелект) между реплики и доставчици.

Допълнение Изисква също
ИИ шлюз в мащаб (AI Gateway at scale) База
Фабрика за модели База
Идеи База
Обаждания и глас База
Поща База
Други фирми и информационни стени База
Студио за бележници База
Карта и GeoAI База
Конектори за данни База
Агент към агент База
Зали за решения и запечатани записи База
Приходни операции База
Витрина / собствена марка (white-label) База
Nexus Edge База
Мобилни приложения База
Работна сила (Workforce) База; агентите на периферни устройства се нуждаят и от Nexus Edge, одобренията на телефон се нуждаят и от Мобилни приложения
Щит (Shield) База
Изолирани среди (Sandboxes) База
Качество (NexusQA) База

Има десет домейн пакета:

  • Застраховане
  • Банкиране и разплащания
  • Капиталови пазари и управление на активи
  • Държавно управление и публичен сектор
  • Здравеопазване
  • Науки за живота
  • Критична инфраструктура и енергетика
  • Отбрана и сигурност
  • Правни и професионални услуги
  • Логистика и морски транспорт

Всеки пакет се нуждае от базата на Enterprise, а пет от тях се нуждаят и от добавка. Пакетът „Застраховане“ се нуждае от „Зали за решения и запечатани записи“. Същото важи и за пакета „Капиталови пазари и управление на активи“. Пакетът „Правни и професионални услуги“ се нуждае от тези две плюс „Поща“. „Логистика и морско дело“ се нуждае от „Карта и GeoAI“. В пакета „Отбрана и сигурност“ платформените известия се нуждаят и от Nexus Edge. Екраните за телефон на всеки пакет се нуждаят и от „Мобилни приложения“. Глава 1.7, Домейн пакети и вертикали, описва какво съдържа всеки от тях.

Групи от функции

Единицата, която един лиценз посочва, е групата от функции. Те са 32: базовият минимум на Community, наборът Team, базата на Enterprise, по една за всяка добавка и по една за всеки пакет. Всяка възможност принадлежи точно към една група, така че лиценз, който изброява „База на Enterprise, Карта и GeoAI, Логистика и морско дело“, казва точно кои възможности може да стартира тази инсталация.

Ниво Възможности
Community 36
Team 6
База на Enterprise 18
Добавки 23
Браншови пакети 14

Обхват на предоставяне

Всяка лицензирана възможност има обхват на предоставяне, който определя към какво се прикачва предоставеното право.

  • Обхватът на ниво арендатор (Tenant) покрива частите, в които хората работят: Идеи, Поща, Операции по приходите, пакетите. Лицензът ги прави достъпни за инсталацията, а след това те се включват или изключват за всяка организация и за всяка бизнес единица. Нова организация никога не наследява състояние „всичко включено“.
  • Обхватът на ниво разгръщане (Deployment) покрива петте неща, които принадлежат на инсталацията като цяло: импортиране на лиценз с артефактите, които то извлича, формите за доставка на Enterprise, операторските страници, управлението на клъстери и Nexus Edge.

Възможностите на Community изобщо нямат обхват на предоставяне. Те не се нуждаят от лиценз.

Администраторът може да стесни това, което лицензът позволява, за дадена организация или единица. Никой не може да го разшири отвътре в инсталацията.

Вертикален стек от шест ленти. Отдолу нагоре: „Базов минимум (всяко издание, никога зад платена стена)“; „Community, Apache-2.0“; дебела двойна линия с надпис „@adverant/nexus-spi, единственият споделен интерфейс“; „База на Enterprise, затворени модули“; „Добавки (19), всяка лицензирана отделно“; „Домейн пакети (10)“. Вдясно, кутия „Подписан лицензионен документ“ със стрелка към трите горни ленти с надпис „проверява се вътре във всеки затворен модул“. Вляво от лентата Community, бележка „Образи на Community: само отворен код“.
Изданията като слоеве, с лицензионния документ като единствен авторитет.

Един продукт, две компилации

Има една кодова база на Nexus. Компилацията Community е нейният експорт с отворен код, а компилацията Enterprise е този експорт плюс затворените модули.

Списък с граници разпределя всеки проследяван файл към дадено издание. В повечето случаи той прави това, като посочва възможността, която файлът имплементира, а изданието на файла следва от нивото на тази възможност: възможност от Community прави файла част от Community, а всичко от Team, базата, добавка или пакет прави файла част от Enterprise. Файловете, които не се доставят в нито едно от изданията, са изброени с причина. Едно правило пресича всички останали: миграциите на бази данни на всеки модул се доставят и в двете издания. Така базата данни на Community и базата данни на Enterprise имат една и съща схема и преместването на инсталация от едното към другото е промяна на това какво е включено, без данни за мигриране.

Експортът на Community носи заглавни части Apache-2.0 и файл NOTICE, и всеки пакет в него е лицензиран под Apache-2.0, с изключение на код на трети страни, който запазва собствения си лиценз (MIT, BSD и други) и се копира в оригиналния си вид, както и няколко пакета за комплекти за разработка на софтуер (SDK) и интерфейс за команден ред (CLI), които запазват собствения си лиценз MIT. Компилацията Enterprise е лицензирана под лиценза Adverant Enterprise. Неговите условия позволяват използване само съгласно писмен лиценз, за срока, разгръщанията и групите от функции, които този лиценз посочва. Забраната за обратно инженерство (reverse engineering) изрично запазва правата, които законодателството на ЕС ви дава да изучавате софтуера и да го декомпилирате за оперативна съвместимост.

Лицензионната линия

Кодът на Enterprise достига до Community само чрез един пакет: @adverant/nexus-spi, интерфейсът за доставчици на услуги (SPI). Той е под Apache-2.0 и съдържа интерфейси и предпазители на типове (type guards), без собствена логика по време на изпълнение.

Експорт Какво представлява
RouteModule Лицензиран модул за маршрутизиране: неговият идентификатор (id), група от функции, телата на заявките, които чете, и register(app, ctx)
SpiApp Частта от HTTP приложението на хоста, до която един модул се докосва: use
SpiContext Какво хостът предава на модула: продуктовата бариера и предпазителя на обхвата, четеца на лицензи, пула за заявки с ограничен обхват, адресите на горните потоци (upstream), платформените клиенти
SpiRuntime Стойностите на плъгин SDK (комплект за разработка на софтуер), които хостът предава на модула
SpiPlane Екранните групи и екранните четения, които една лицензирана равнина добавя
ScreenModule Лицензирана екранна група на конзолата: нейните маршрути, екрани и меню
GrantCheck Проверката, която един лицензиран модул изпълнява върху собствената си група от функции

Проверка при компилирането налага спазването на линията. Вътре в кода на Enterprise, импортирането от обхватите на пакетите на Community (@adverant/ и @adverant-nexus/) проваля компилацията, освен ако не е @adverant/nexus-spi или пакет на Enterprise. Същото прави и относителен импорт, който излиза извън хранилището, зависимост file:, link: или workspace:, сочеща извън него, Git URL адрес, назоваващ хранилище на Community, и Go replace, който сочи извън него. Отвъд линията свързването става чрез мрежов протокол или модул, зареден при стартиране, никога чрез споделен изходен код. SPI дори носи собствено фиксирано копие на декларациите на типове на плъгин SDK, тъй като SDK е пакет на Community, който линията не допуска; вместо това хостът предава на модула стойностите на SDK по време на изпълнение.

Профили на компилация

Конзолата и BFF (бекенд за фронтенд) се компилират с профил на компилация, който фиксира класовете код вътре в образа. Профилът Community съдържа код на Community; профилът Enterprise съдържа код на Community и Enterprise. Всеки от тях отказва да стартира, когато профилът му съдържа код, който изданието на инсталацията не притежава. BFF съобщава това с PROFILE_OUTSIDE_EDITION и посочва образа, който трябва да се разгърне вместо него. Не можете да поставите конзола на Enterprise върху инсталация на Community чрез преетикетиране (retagging) на образ.

Вляво, една кутия „Изходен код на Nexus“ с по-малка кутия вътре в нея, „матрица на изданията“. Стрелка с надпис „списък с граници“ се разделя на две. Горната стрелка отива към „Експорт на Community (Apache-2.0)“ и нататък към „Образи на Community“. Долната стрелка отива към „Компилация на Enterprise“, която също така получава стрелка от експорта на Community и една от кутия „затворени модули“, и произвежда „Образи на Enterprise“. Между затворените модули и експорта на Community има ограда с надпис „лицензионна линия: само @adverant/nexus-spi“. Малка бележка под двете кутии с образи гласи „една и съща схема на базата данни“.
Как едно дърво с изходен код се превръща в две издания.

Как лицензът включва групи от функции

Лицензът е подписан документ. Adverant подписва всеки лиценз с два независими ключа и нищо друго в инсталацията не решава какво е лицензирано. Вие го импортирате през страниците „Лиценз“ на конзолата, с nexusctl licence import <file>, или чрез изпращане (POST) на документа към https://<hosts.auth>/api/v1/installation/licence. Лицензът никога не е стойност в чарта и никога не е монтиран файл. Глава 2.13, Лицензи, обхваща импортирането и подновяването, както и всяко състояние, през което преминава един лиценз.

Проверката, която има значение, се изпълнява вътре във всеки затворен модул, върху собствената група от функции на този модул, преди той да отговори. Това е договорът GrantCheck от SPI:

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

Проверката живее в затворения модул, защото проверка, написана в отворен код, би могла просто да бъде изтрита. Фалшифициран лиценз се брои за липса на лиценз. Модул, чиято група от функции лицензът не посочва, отговаря с LICENCE_LOCKED.

Самите модули също се проверяват. nexus-keys съдържа подписания манифест на частите от изданието и ключа, който го е подписал. Той проверява всеки компилиран модул спрямо този манифест при стартиране и отново всяка нощ в 03:53 UTC. Модул, чийто подпис не съвпада, никога не се зарежда, а подписаното копие, което той би заменил, продължава да работи; операторските страници го показват с MODULE_SIGNATURE_INVALID.

Компилирани части
Компилирани части
Страницата с компилирани части изброява всеки лицензиран модул с неговата група от функции, версия и проверка на подписа. Променено копие, което не е преминало проверката си, се появява като табела за отказ, а подписаното копие е продължило да работи.

Над проверката на модула стои слоят за визуализация, който решава как дадена възможност се показва на всеки човек. Той комбинира предоставените права от лиценза с плана на организацията и ролята на човека, и всяка контрола се озовава в едно от четири състояния.

Състояние Какво вижда човекът
С предоставено право Контролата, изчертана нормално
Тийзър Контролата в сиво с катинар; отварянето ѝ обяснява какво представлява и кой може да я включи
Скрита Нищо; използва се само за неща, за чието съществуване ролята на този човек не трябва да знае, като например личната пощенска кутия на друг човек
Отказана с код Табела за отказ, посочваща кода, когато някой опита действие, което не е разрешено

Лицензът също има свои собствени състояния, когато наближава и преминава крайната си дата. Две правила важат във всяко едно от тях: лицензът никога не спира текуща работа и поправките за сигурност никога не се задържат.

Какво показва Community за страница от Enterprise

Инсталацията на Community запазва формата на продукта. Менюто има същите редове като Enterprise, а тези от Enterprise (Идеи, Решения, Поща, Обаждания, Други фирми, Агенти, Политики, Съответствие) са изчертани в сиво с икона на катинар. Нищо не е скрито с цел изданието да изглежда пълно и нищо не досажда.

Отварянето на заключен ред показва тийзър. За „Идеи“ той гласи „Идеи е част от Enterprise“, след това един параграф за това какво прави „Идеи“, след това „Кой може да го включи: вашият администратор, чрез лиценз от Adverant“. Предлага два бутона: „Попитайте вашия администратор“ и „Вижте какво прави“. Няма цена. Отварянето на страницата не зарежда нищо и не изпраща нищо, а промоцията се показва веднъж.

Нещо, което нямате
Нещо, което нямате
Заключена зона в Community посочва кой може да я включи и какво вече ви дава Community. Редът остава в менюто, в сиво с катинар, така че продуктът изглежда по един и същи начин и в двете издания.

Въвеждането на адреса на страница, достъпна само в Enterprise, също води до полезно място. Конзолата на Community знае адресите на страниците, които не притежава, и препраща всяка от тях към своята страница за изданието, вътре в нормалната рамка с менюто. Страницата изчертава табелата за заключена функция:

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

Кодът е там за справка; изреченията са за човека, който го чете.

Базовият минимум

Някои неща никога не са зад платена стена, в никое издание, при никакво състояние на лиценза: основи на администрирането и сигурността, разделяне на арендаторите, експорт на данни, излизане от профила и всеки екран за отказ. Инсталацията на Community разполага с всички тях. Инсталация на Enterprise, чийто лиценз е изтекъл, също ги запазва: артефактите на Enterprise спират да се предлагат, а базовият минимум на Community и експортът на данни остават. Винаги можете да извлечете данните си.

От Community към Enterprise
От Community към Enterprise
Импортирането на лиценз в инсталация на Community показва какво ще бъде извлечено, какво се променя и какво се запазва, преди да се случи каквото и да било. Бутонът гласи „Извлечи и включи“ и нищо не се извлича, докато не бъде натиснат.

Образи според изданието

Всеки образ в дадено издание (release) е описан чрез хеш (digest) в заключващия файл за образи (image lock) на чарта, а самият заключващ файл принадлежи на едно издание. Чартът проверява всеки образ, който рендира, спрямо заключващия файл и спрямо изданието, което сте заявили. Инсталацията на Community приема само образи на Community. Поискайте ѝ каквото и да е друго и тя спира: „a community install takes only community images“. Заключващият файл на Enterprise съдържа образите на Community плюс компилациите на Enterprise.

Това има значение за мястото, откъдето изтегляте (pull). Образите на Community са публични на registry.adverant.ai/nexus/<service>@sha256:…. Образите на Enterprise идват от същия регистър с токен за изтегляне, който получавате от страницата „Токени за изтегляне и команди за инсталиране“ на вашия акаунт в Adverant. Инсталацията на Community никога не се нуждае от този токен и никога не съдържа нито байт затворен код.

Пътят за надграждане запазва инсталацията. Когато администратор на Community импортира лиценз за Enterprise, конзолата го прочита и верифицира, след което показва частите, които ще извлече (компилираните модули и пакетите и добавките, които лицензът посочва) с техните размери. Всяка част се проверява спрямо ключа на изданието на Adverant и групите се включват една по една. Хората и файловете остават такива, каквито са, както и работните потоци и каналите, тъй като схемата вече е била същата. Глава 2.7, Инсталиране на Enterprise и прилагане на лиценз, проследява процеса в Kubernetes; изолираните от мрежата (air-gapped) обекти импортират същите части от носител, както описва глава 2.10, Инсталиране в изолирана среда.

Форми на доставка и класове на защита

Nexus се доставя в шест форми на доставка, които матрицата нарича SKU (стокови единици). Петте, различни от Edge, споделят един подписан пакет и се различават по опаковката и по начина, по който пристига лицензът.

SKU Какво представлява Как пристига лицензът
saas Облак на Adverant Издава се с абонамента
onprem-connected Helm върху ваш собствен Kubernetes Изтегля се от инсталацията през нейната изходяща връзка
airgap Същият пакет, импортиран офлайн Импортира се като файл, с подписана декларация за използване веднъж годишно
self-serve-image Машинен образ във вашия собствен облачен акаунт Самият образ носи само лицензи за Community и за оценка; модулите на Enterprise пристигат след издаване на лиценз, включително такъв, закупен през магазина на облака
appliance Хардуер, изграден от производител на оригинално оборудване (OEM), който е неговият официален производител Лиценз за Enterprise; устройството е една от неговите форми на доставка
edge Nexus Edge, полезният товар на сателити и дронове, или на плавателни съдове и превозни средства Един лиценз за платформа или флот, дълготраен, валиден докато е офлайн

Защитата е другата половина на доставката и си струва да говорим открито за нея. Веднъж щом кодът се изпълнява на хардуер, който вие контролирате, никаква техника не го прави нечетим. Затова Adverant сортира своя код в класове на защита и решава, за всяка форма на доставка, колко далеч може да пътува всеки клас. Има четири нива:

Клас Какво означава
P1, никога не се доставя Логиката се изпълнява в Adverant; инсталацията държи подписан клиент.
P2, запечатан Поверителна виртуална машина (VM), в която не можете да влезете, на хардуер, който не можете да докоснете.
P3, подсилен нативен код Компилиран, изчистен от символи (stripped) и изграден индивидуално за всеки лицензополучател. Повишава цената за разчитане на кода от часове на седмици.
P4, четим Обикновен JavaScript или TypeScript, какъвто е отвореният код.
Клас на защита Облак на Adverant Свързан локално (on-prem) Изолирана среда (Air-gap) Nexus Edge
Отворен код (цялото издание Community) P4 P4 P4 P4
Код с най-висока стойност: оценяване на идеи, ядрото на хранилището за запечатани записи, двигателят за политики на маршрутизиране, четирите двигателя за решения на пакета „Застраховане“ P1 P3 или P2 като запечатана от Adverant поверителна VM във вашия облачен арендатор P3 Не се доставя
Затворени сървърни модули, които вземат решения: сървърен код на пакетите, мобилният шлюз P1 P3 P3 Не се доставя
Сървърен код на пакета „Отбрана и сигурност“ P1 P3 P3 P3
Код на полезния товар на Nexus Edge Не се доставя Не се доставя Не се доставя P3
Четими клиентски дефиниции: телефонни приложения, телефонни екрани на пакети P4 P4 P4 P4

От това следват две неща. Нищо защитено не се доставя в телефонно приложение: всяко правило и промпт остават на сървъра. А стойността, пренасяна в промптове, рубрики или вериги от агенти, е четима от всеки, който управлява модела, към който тя се изпраща. Когато вашата организация притежава модела, тази стойност е защитена от лицензионния договор и от нищо друго. Всеки доставен образ на TypeScript е пакетиран и минифициран без карти на изходния код (source maps), което е по-скоро за прегледност, отколкото за защита.

Какво означава това, когато изграждате разширение

Вашето разширение стои на същата линия като собствените модули на Adverant. Почти цялата тази глава се отнася и за него.

Изолацията, идентичността и пътят за ИИ идват с платформата и в двете издания. Плъгин, изграден с @adverant-nexus/plugin-sdk, наследява оградата за заявки с ограничен обхват, верификатора на токени и диспечера на UNO, независимо в кое издание попадне. Глава 2.19, Правилата, които всяко разширение наследява, ги изброява.

Ограничаването по издания (edition gating) работи по същия начин и за вас. Един плъгин декларира идентификаторите на своите функции в блока entitlements на своя манифест (featureIdPattern, плюс кратък списък alwaysOn, пазен за проверки на изправността и страницата с настройки) и пита платформата за присъда, преди да обслужи защитена повърхност. Присъдата никога не е просто булева стойност. ENTITLEMENT_DENIED (403) означава, че платформата е отговорила с „не“. ENTITLEMENT_UNREACHABLE (502) означава, че не е имало отговор и вашият плъгин трябва да откаже, вместо да предполага, защото прекъсване, разчетено като „няма предоставено право“, тихомълком понижава нивото на всеки клиент наведнъж. Кеширайте „да“ за кратко и никога не кеширайте отказ.

В Community разработчикът получава същите начални шаблони като в Enterprise – както за плъгини и лещи (lenses), така и за умения и работни потоци. Всеки разработчик работи в пространство за разработка с клонове на данни на един-единствен сървър, а кодът живее в GitHub. Шаблоните за домейн пакети и платформи са част от Enterprise. Такова е и ограниченото във времето повишаване на достъпа от IDE (интегрирана среда за разработка): в Community няма отделна продукционна среда, до която да повишите достъпа си, и конзолата съобщава това с PASS_TIER_REQUIRED.

Изграждане в Community
Изграждане в Community
Изграждането в Community предлага същите шаблони като Enterprise на един сървър, с кода в GitHub. Страницата посочва какво добавя Enterprise и отказва повишен достъп с ясна причина.

Разширение, което използва само точки на свързване (seams) от Community, работи и в двете издания без промяна. Такова, което зависи от добавка, например „Поща“, се показва като заключено навсякъде, където лицензът не посочва тази група. Глава 2.25, Изграждане за всяко издание, показва как да структурирате разширение и за двете и как да го тествате спрямо всяко от тях.