Поддръжка
Версия 1.0.0-alpha.1последно
Документация
Документация за Adverant Nexus
Издание 1.0.0-alpha.1. Започнете с Част 1, ако сте нови в Nexus; Част 2 е за хората, които го инсталират и поддържат.
Разгледайте картата на модела на знанияСподеленото ядро и всеки домейн пакет, с техните перспективи, модули и релации.
Част 1: За всички
- 1.1Какво представлява Nexus и за кого е предназначенКакво прави Adverant Nexus за една организация, за кого е създаден и как частите му се вписват заедно, разказано на достъпен език с Harrow Port Authority като пример. Завършва с трите издания в един параграф.
- 1.2Един работен ден с NexusЕдин работен ден в Harrow Port Authority, от първия поглед към „Днес“ до последното одобрение, показващ какво реално правят хората в Nexus и къде се намира всеки вид работа.
- 1.3Вашата организация, нейните хора и какво остава поверителноКак Nexus моделира една организация и ролите, които хората в нея заемат, кой може да купува и заявява права в акаунта в Adverant, и границата между това, което администраторите могат да виждат, и това, което остава лично за всеки човек.
- 1.4ИИ при Вашите условияКак Nexus използва изкуствен интелект (ИИ) при собствените условия на организацията. Организацията предоставя и притежава своите ключове за модели, един комутатор насочва всяко извикване на модел към избрани от нея доставчици, локалните модели работят на нейни собствени сървъри и нищо не се изпраща към Adverant зад гърба ѝ.
- 1.5Доверие и съответствиеЧастите от Nexus, в които работи служителят по съответствието. Обхваща одитния дневник и запечатаните записи, одобренията, които изискват втори човек, и решенията на изкуствения интелект (ИИ), чакащи преглед. Завършва със заявките за лични данни и страниците за съответствие, които поддържат доказателствата готови, преди одиторът да ги поиска.
- 1.6Издания и лицензи на достъпен езикТрите издания на Nexus и 19-те добавки и браншови пакета върху тях, както и как работи лицензът за един бизнес. Обхваща офлайн проверката и какво означава всяко състояние на лиценза на практика, обещанията, които всеки лиценз спазва, и преминаването от Community към Enterprise без преинсталиране.
- 1.7Браншови пакети и вертикалиКакво добавя един браншов пакет към Nexus за дадена индустрия, десетте пакета, които Adverant предлага, как се включва пакет за една единица и от какво се нуждае пакетът във Вашия лиценз.
- 1.8Къде работи NexusМестата, където може да работи Nexus – от облака на Adverant в ЕС до обект без интернет и устройства на терен, какво означава суверенитет на практика и как да изберете.
- 1.9Първи стъпкиДвете решения, преди да започнете, какво прави Вашият ИТ екип, първото стартиране през погледа на първия администратор и контролен списък с това какво да подготвите в първия ден.
- 1.10Далеч от бюротоИзползване на Nexus на телефон – от мобилния изглед на конзолата във всяко издание до собствените приложения за iPhone и Android. Обхваща какво работи без обхват и как компанията управлява телефоните.
- 1.11ПерсонализиранеНачините, по които една организация оформя Nexus – от единична настройка до своя собствена вертикала. Също и как да дадете задание на разработчици или партньор и какво гарантира платформата, независимо какво се изгражда.
- 1.12Въпроси, които хората задаватЯсни отговори на въпросите, които купувачите, мениджърите и длъжностните лица по защита на данните задават най-често, включително неудобните въпроси за парите и достъпа до Вашите данни.
Част 2: За ИТ, DevOps и разработчици
- 2.1АрхитектураКакво притежава всяка услуга в чарта на Nexus и кои хранилища стоят под нея, след това правилата, които ги държат заедно – от идентичността между услугите до пътя, който изминава всяко извикване на модел.
- 2.2Изданията отвътреКак Community и Enterprise се изграждат от един продукт, как лицензът включва групи от функции по време на изпълнение, какво показва инсталация на Community за страница от Enterprise и какво означава това за образите, които изтегляте, и разширенията, които изграждате.
- 2.3Планиране на инсталацияОт какво се нуждае една инсталация на Nexus в Kubernetes, преди да въведете команда, колко е голяма и двете решения, които не можете да промените обратно – името на инсталацията и пазителите на ключове. Завършва с попълнения работен лист за планиране на Harrow Port Authority.
- 2.4Получаване и проверка на версияКъде се намира всяка част от дадена версия на Nexus, как се извличат образите за Enterprise с токен за изтегляне и как да докажете офлайн, преди да инсталирате каквото и да било, че всеки образ, чарт и изтеглен файл са дошли от Adverant непроменени.
- 2.5Предварителна проверка с nexusctlВсяка проверка, която `nexusctl preflight` прави, какво чете всяка от тях и как се проваля, отчетът, който извежда и записва, как този отчет достига до страницата за предварителна проверка в конзолата, както и всеки флаг.
- 2.6Инсталиране на Community в KubernetesНомерирана инсталация на изданието Community с Helm – от cert-manager до готовност на всяко работно натоварване, с обяснение на файла със стойности ключ по ключ, защо няма --wait, реда, в който се изпълняват куките (hooks) на чарта, и маршрута с nexusctl install като алтернатива.
- 2.7Инсталиране на Enterprise и прилагане на лицензКакво се променя, когато инсталирате изданието Enterprise, как да заявите лиценз от профила си в Adverant, трите начина да го импортирате заедно с всеки код за отказ и как Harrow Port Authority прехвърли своя пилотен проект от Community към Enterprise на място, без да изгуби нищо.
- 2.8Инсталации на една машинаИнсталирайте Nexus на един Linux сървър с nexusctl или го тествайте на лаптоп с k3d и отворете конзолата през HTTPS, за да работят влизането и ключовете за достъп.
- 2.9Дисковият образ на инсталатораСтартирайте физически сървър или виртуална машина от инсталационния образ на Nexus и той ще инсталира операционната система, k3s, cert-manager и Nexus без мрежа, като проверява всеки файл преди употреба.
- 2.10Инсталация в изолирана средаПренесете подписан офлайн пакет в обект без интернет, проверете го спрямо ключ, който сте внесли отделно, заредете го в собствения си регистър и инсталирайте. Лицензите, обновленията и списъците с анулирани сертификати също преминават изолираната зона на ръка.
- 2.11Вариации: външни хранилища, TLS и ingressСтойностите, които адаптират Nexus към клъстер, който не е празен, включително TLS (Transport Layer Security), заедно с бази данни, които вече поддържате, Ваши собствени сертификати, друг ingress контролер, класове за съхранение, поща, проксита, реплики и управляван Kubernetes.
- 2.12Първото стартиранеОт незаявена инсталация до работещи хора. Създайте кода за заявяване, заявете инсталацията в браузър, създайте първия администратор с ключ за достъп, след което свържете фирменото влизане и поканете всички останали.
- 2.13ЛицензиКакво съдържа лицензионният файл на Nexus, как инсталацията го проверява офлайн, шестте състояния, в които може да се намира, и как да заявите, импортирате, подновите и оттеглите лиценз.
- 2.14Доставчици и модели на ИИКак маршрутизаторът на доставчици на изкуствен интелект (ИИ) избира модел от собствения пул от ключове на организацията и как скриптове и инструменти за ИИ се свързват с Nexus отвън.
- 2.15Ден втори: експлоатация на NexusРутинната работа по поддържането на инсталацията след първата седмица. Тя започва с разпечатването на хранилището за ключове след рестартиране и завършва с деинсталирането.
- 2.16Сигурност и мрежиКакво допуска и изпраща една инсталация, как нейните услуги доказват идентичността си една пред друга и контролите, които операторът задава или наследява за влизането и базата данни.
- 2.17Отстраняване на неизправностиПроблемите, с които операторите се сблъскват най-често, организирани според симптомите. За всеки са посочени причината, командата за потвърждение и решението, а главата завършва с изпращане на пакет за поддръжка.
- 2.18Моделът за разширенияШестте начина за разширяване на Nexus – от настройка до браншов пакет, границите на всеки от тях и как нивата на доверие и изолация определят къде се изпълнява Вашият код. Прочетете това, преди да отворите пакета за разработка на софтуер (SDK).
- 2.19Правилата, които всяко разширение наследяваИзолация по три оси, изчисления чрез UNO, ИИ (изкуствен интелект) през маршрутизатора, ключове, притежавани от организацията, и проверки на лиценза. Какво означава всяко правило за Вашия код, коя проверка го налага и защо го наследявате, вместо да го пишете сами.
- 2.20УменияКак да напишете, тествате и публикувате умение за Skills Engine, къде се появява то, след като бъде активирано, и по какво се различават уменията от манифест в плъгин. Включва разработен пример за обобщение на разпределението на корабни места за Harrow Port Authority.
- 2.21Пакетът Plugin SDKИнсталиране на Plugin SDK (пакет за разработка на софтуер), неговите инструменти за командния ред, преглед на шаблона за пълна услуга, манифестът v2 поле по поле и двадесет и двете проверки, които следят плъгинът да спазва правилата.
- 2.22Средата за изпълнение на плъгиниМодулите на SDK (пакета за разработка на софтуер), върху които работи Вашият плъгин – от защитата на обхвата и преградата на базата данни до диспечера на UNO, четенето на маршрута за ИИ (изкуствен интелект) и проверките на лиценза. Следват тестване срещу реална база данни, регистриране на Вашите умения и въвеждане в експлоатация.
- 2.23Браншови пакетиОт какво се състои един браншов пакет и какво описва неговият pack.json; призми и регистърът на призмите; модели на знания, конектори и мобилни наслагвания; как се лицензира и включва пакет за дадено звено; и десетте пакета, които Adverant доставя.
- 2.24Цялостно изграждане на персонализирано вертикално решениеПрактически пример за изграждане на домейн пакета за хладилна верига (Cold chain) – от първоначалното задание до работещо издание за всяко звено, заедно с неговия модел на знания, лещи (lenses), умение, плъгин с пълна функционалност и примерни данни. След това – как да разширите вече съществуващ пакет и как да добавите леща към вече публикуван такъв.
- 2.25Разработване за всяко изданиеКакво се променя, когато едно разширение трябва да работи във всяко издание, в изолирана от интернет среда (air-gapped), в пакет за Nexus Edge или под собствената марка на клиента. Обхваща лицензионната граница за модулите Enterprise и подписаната офлайн доставка, с матрица на това какво трябва да се направи по различен начин за всяка целева среда.
- 2.26Изграждане с ИИ инструменти за програмиранеКак да изграждате разширения за Nexus безопасно с Claude Code и други инструменти за програмиране с ИИ (изкуствен интелект). Започва със свързването на Вашата IDE (интегрирана среда за разработка) към Workbench и проектен файл CLAUDE.md, който съдържа правилата на платформата, и завършва с шест разработени промпта и проверката (gate), която доказва всеки от тях.
- 2.27Сценарии за изгражданеНаръчник с тринадесет сценария за изграждане – от единично умение до доставка за изолирана среда (air-gapped). Всяка рецепта посочва целта, градивните елементи, стъпките и командите, проверката, която доказва, че решението работи, и какво се променя според изданието и формата на доставка.
- 2.28Пускане на Вашето разширениеКак един плъгин или пакет преминава от успешна компилация до звената, които го изпълняват, и как се извежда от употреба. Версии, преглед на изданието, канали и инсталации, подписване, одобрения на промени, запис за идентичност на доставката, миграции, връщане към стара версия (rollback) и оттегляне на версия.
Приложения: Справочник
- AПриложение А: Справочник за стойностите на HelmВсеки ключ, който пакетът (chart) на Nexus приема, неговият тип, допустимите му стойности и стойността по подразбиране.
- BПриложение Б: Матрица на изданиятаКое издание, добавка или домейн пакет включва всяка от функционалностите.
- CПриложение В: Кодове за грешкиВсеки код за отказ, с който се сблъсква оператор или разработчик, какво означава той и какво трябва да се направи.
- DПриложение Г: Услуги и портовеВсяка услуга, която пакетът (chart) изпълнява, нейните портове и ключът във файла със стойности, който я конфигурира.
- EПриложение Д: Речник на терминитеТермините, използвани в двете части, обяснени на достъпен език.
- FПриложение Е: Архитектурата накраткоЦялата платформа, отвореното ядро и лицензираните компоненти над него, всеки начин за стартиране на Nexus и всеки от десетте домейн пакета – с по една диаграма за всяко.
- GПриложение Ж: Речник на данните и модели на знанияПолетата във всеки запис и от какво се състои всеки домейн пакет.
Изтегляне
- Part 1, for everyone (PDF) (отваря се в нов раздел) 18 MB
- Part 2, technical, with the appendices (PDF) (отваря се в нов раздел) 40 MB
PDF файловете са на английски език.