УвійтиЗамовити брифінг

Розділ 2.27

Сценарії збирання

Збірник із тринадцяти рецептів збирання: від однієї навички до доставлення в ізольоване середовище. Кожен рецепт містить мету, будівельні блоки, кроки й команди, контрольну перевірку, що підтверджує результат, а також відмінності залежно від редакції та форми доставлення.

Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

25 хв читання

Це рецепти, до яких я звертаюся, коли хтось у Corrán Orbital або в замовника каже: «Ми хочемо, щоб Nexus робив X». Кожен із них навмисно короткий. Обґрунтування кроків наведено в попередніх розділах: розділ 2.20, «Навички», і розділ 2.21, «Plugin SDK», що описує набір засобів розробки програмного забезпечення, потім розділ 2.23, «Доменні пакети», і три наступні розділи про розробку. Тут ви знайдете мету, які будівельні блоки використовувати, кроки, команди, контрольну точку, що підтверджує успіх, а також примітки щодо редакцій і постачання.

Найважливіше — контрольна точка. Рецепт завершено, коли його контрольна точка зелена. Кожна контрольна точка в цьому розділі — це те, що ви можете запустити, або те, що платформа запускає за вас, і кожна з них завершується з ненульовим кодом або відмовляє з кодом помилки, якщо умову не виконано.

Сценарій Основний будівельний блок Контрольна точка, що це підтверджує Редакція
Нова навичка Skills Engine Пакет SKILL.md skill:validate без помилок Community та Enterprise
Навичка в маніфесті з host_callback Маніфест плагіна skills[] create-nexus-plugin validate та nexus-gates Community та Enterprise
Розширення наявного пакета pack.json з inherits Перевірка політики лінз на пілотній контрольній точці Enterprise та ліцензія на пакет
Новий пакет з нуля Еталонний шлях доменного пакета Контрольні точки staging і пілоту Enterprise
Конектор даних Навичка plugin_queue validate, nexus-gates, відмова у вихідному трафіку Community та Enterprise
Інструмент MCP (Model Context Protocol) mcpTools[] маніфесту validate (без комбінаторів верхнього рівня) Community та Enterprise
Вітрина під білою маркою domains і branding маніфесту Правило публічних маршрутів scope-adherence Enterprise та доповнення Storefront
Місійний пакет Edge Місійний пакет Бортові тестові сценарії, два підписи з трьох Enterprise та доповнення Nexus Edge
Постачання в ізольоване середовище Запечатаний пакет постачання nexus-airgap verify Enterprise
Модуль лише для Enterprise @adverant/nexus-spi Контрольна точка лінії ліцензування, збірки редакцій Enterprise
Форк або розширення відкритого ядра Вихідний код Community Тести, lint і перевірка типів Community
Хмарний застосунок для редакції Team Кластер видавця Підписаний реліз, рецензування, надання доступу замовнику Team
Обгортання наявного внутрішнього застосунку /plugin-create migrate, validate, nexus-gates Community та Enterprise
Дерево рішень, що читається згори донизу. Перший ромб запитує «Чи потрібен код, що працює постійно?». «Ні» веде до ромба «Чи це інструкції для асистента?», у якого «Так» закінчується на «Навичка Skills Engine», а «Ні» — на «Лінза для наявного пакета». «Так» веде до ромба «Чи це погляд однієї галузі на платформу?», у якого «Так» закінчується на «Галузевий пакет (з його плагіном)», а «Ні» веде до останнього ромба «Чи має він залишатися закритим і ліцензованим?», що закінчується на «Модуль Enterprise» для «Так» і «Плагін» для «Ні».
З якого будівельного блока почати.

1. Нова навичка Skills Engine

Мета — багаторазова інструкція, яку можуть виконувати асистент, агенти, робочі процеси та інструменти розробника, наприклад перевірка митної декларації на відповідність її правилам. Ваші будівельні блоки — пакет SKILL.md у папці з назвою навички, необов’язковий skill.yaml для тригерів і тегів та необов’язкова папка scripts/, що постачається разом із ним.

  1. Створіть skills/<slug>/ і напишіть SKILL.md з frontmatter: name (kebab-case, збігається з назвою папки), description (до 500 символів), allowed-tools і, за потреби, triggers, capabilities та version.
  2. Напишіть основну частину для моделі: коли використовувати навичку, її кроки, приклади та те, чого вона ніколи не повинна робити.
  3. Додайте тестові сценарії. Включіть один, у вхідні дані якого підкладено інструкцію, яку навичка не повинна виконувати.
  4. Виконайте валідацію, перегляньте план завантаження, а потім завантажте.
  5. Опублікуйте. Навичка, що додає інструмент запису, утримується, доки двоє визначених осіб не схвалять її за допомогою ключів доступу (passkey), причому автор пропозиції не може схвалити власну зміну.
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing --dry-run
npm run skill:upload skills/check-a-customs-filing

Контрольна точка — skill:validate, яка має повідомити про нуль помилок, перш ніж щось можна буде опублікувати. Блокувальні помилки — відсутня назва або опис і дубльований slug чи тип завдання. Завантаження вже опублікованого вмісту повертає наявну версію (CONTENT_HASH_ALREADY_PUBLISHED), тож завантаження можна безпечно повторювати.

Community отримує весь конструктор, бібліотеку, версії, повернення до попередньої версії, імпорт і тести. В Enterprise публікація також проходить через тіньовий і канарковий режими: схвалена версія працює в тіньовому режимі, потім для одного підрозділу за визначеними контрольними точками, потім для всіх, і вона зупиняється сама, якщо умову контрольної точки не виконано. Для замовника в ізольованому середовищі навички постачаються попередньо підписаними всередині запечатаного пакета (сценарій 9).

2. Навичка маніфесту з host_callback

Мета — детерміновані обчислення у вашому власному плагіні, які платформа може запускати, наприклад відкриття запису про відхилення на основі показника. Ви використаєте рядок у skills[] маніфесту з рівнем host_callback і маршрут /internal у вашому бекенді, захищений сервісним guard з SDK.

  1. Оголосіть навичку: id у lower_snake, tier: "host_callback", classification на рівні стелі довіри вашого плагіна або нижче, inputSchema, outputSchema і timeoutMs від 1 секунди до 6 годин.
  2. Заповніть hostCallback: назву вашого власного Service, його порт, відносний шлях, наприклад /internal/skills/excursion_open, обидва обмеження в байтах (maxRequestBytes і maxResponseBytes) та tenantHeader: "X-Organization-ID".
  3. Оголосіть маршрут у api.endpoints[] з auth: "service-key" або auth: "internal" і захистіть його за допомогою requireService або serviceMiddleware, але ніколи не guard користувацької області.
  4. Виконайте валідацію, запустіть контрольні точки й дозвольте процесу підключення синхронізувати навички з реєстром через compileRegistry. Ви ніколи не пишете SQL для реєстру вручну.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test

validate застосовує власні правила синхронізації реєстру ще до синхронізації, і кожна відмова має код приймача. Шлях зі схемою, // або зворотною скісною рискою відхиляється як міжджерельний. Відсутнє обмеження в байтах — це ENDPOINT_BYTE_CAP_REQUIRED, поле з іншого рівня — FIELD_NOT_FOR_TIER, а тайм-аут поза діапазоном — TIMEOUT_OUT_OF_BOUNDS. Потім nexus-gates перевіряє, що маршрут /internal має сервісний guard і оголошений як internal або service-key. Ця пара контрольних точок і є доказом.

Синхронізація декларативна. Щоразу надсилайте повний набір навичок, оскільки пропущена навичка вимикається, і завершуйте крок розгортання з помилкою за будь-якого статусу, крім 200. В Enterprise синхронізація плагіна перевіряється цілком: якщо одна навичка порушує правило, жодну частину цієї синхронізації не приймається (PLUGIN_SYNC_ALL_OR_NOTHING), а попередня версія продовжує працювати. Плагін із рівнем довіри community не може використовувати рівні, що звертаються до моделі, tool_using і llm_only; для них потрібна довіра core або verified.

Плагіни та синхронізація MCP
Плагіни та синхронізація MCP
Плагіни, що постачають навички, і що перевірялося під час кожної синхронізації. Зверніть увагу на плагін, синхронізацію якого відхилено цілком, оскільки одна з його п’яти навичок використовувала рівень, який може розміщувати лише платформа, тоді як його попередня версія продовжувала працювати.

3. Розширення наявного пакета

Мета — нова галузь або підгалузь, що повторно використовує більшу частину наявного пакета, наприклад кредитування та спори щодо карткових операцій на основі структури пакета Insurance. Будівельний блок — pack.json, що вказує батьківський пакет у inherits і додає лише власні кластери лінз і терміни.

  1. Почніть пакет з еталонного шляху доменного пакета, потім установіть для inherits ідентифікатор батьківського пакета.
  2. Додайте власні кластери lens, кожен зі своїми місцями, призначенням і посиланням на лексикон.
  3. Додайте свої терміни до лексикону, кожен із простим поясненням. Позначте термін як exact, якщо його потрібно показувати в незмінному написанні.
  4. Повторно використовуйте спільні лінзи замість створення власних: регуляторний режим, потрібний кільком пакетам, наприклад реєстр аутсорсингових технологій, — це одна спільна лінза.
  5. Перевірте ланцюжок ліцензій. Ваш пакет успадковує вимоги до доповнень від батьківського.
  6. Перегляньте кожну лінзу від імені конкретної особи на синтетичній гілці.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Доказом є перевірка політики на пілотній контрольній точці, яка підтверджує, що кожна лінза лише звужує свою базову та за замовчуванням приховує персональні поля. Лінза, що намагається показати те, що приховує її базова, відхиляється з LENS_CANNOT_WIDEN. Щодо ліцензування: консоль відмовляє у видачі ліцензії на ваш пакет без доповнень, потрібних його батьківському пакету; для пакета Insurance потрібні Decision rooms і запечатані записи.

Доменні пакети доступні в Enterprise і ліцензуються окремо для кожного пакета. Для екранів пакета на телефоні також потрібне доповнення Mobile apps. Дочірній пакет не може змінювати оболонку, компоненти чи правила оформлення текстів.

4. Новий пакет із нуля

Мета — галузеве представлення Nexus: його модель знань, лінзи для кожної ролі, докази, яких вимагають його правила, і плагін, що підтримує актуальність його даних. У розділі 2.24, «Створення власної вертикалі від початку до кінця», цю розробку описано повністю; тут наведено стислу версію.

  1. Пройдіть еталонний шлях доменного пакета й опишіть пакет: призначення, підрозділи, базову модель і правила, які він відображає.
  2. Побудуйте модель знань на базовій моделі та класифікуйте кожну властивість під час додавання.
  3. Прочитайте план, підтвердьте його відбиток своїм ключем доступу (passkey) і створіть.
  4. Сформуйте лінзи в Lens builder, кожна з яких звужує базову лінзу.
  5. Напишіть плагін і всі навички Skills Engine, потрібні пакету.
  6. Згенеруйте синтетичні дані з seed, що містять важливі для вас нетипові випадки, і перегляньте кожну лінзу від імені конкретної особи.
  7. Просувайте пакет із простору розробки до staging, до пілотного підрозділу, а потім до всіх підрозділів.

Доказом є контрольні точки просування: усі тести на синтетичних гілках успішні для переходу до staging, потім два рецензенти, які не є автором, потім 14 днів у пілоті з частотою помилок менше 1 на 1,000. Жоден крок не можна пропустити (GATE_CANNOT_BE_SKIPPED). Пакети доступні в Enterprise. У Community еталонний шлях доменного пакета не пропонується.

5. Конектор даних

Мета — дані із зовнішньої системи, що за розкладом надходять до власних таблиць вашого плагіна, наприклад події на воротах із термінальної операційної системи. Будівельні блоки — навичка plugin_queue, worker, що отримує завдання з вашої черги, міграція для цільової таблиці та вихідна адреса, оголошена в маніфесті.

  1. Оголосіть навичку plugin_queue з queueName у написанні <plugin name>.<name>. Двокрапка не допускається, і назва має бути в маніфесті, оскільки оркестратор ставить завдання безпосередньо в цю чергу.
  2. Напишіть worker, що отримує завдання з черги та звертається до зовнішньої системи.
  3. Оголосіть адресу зовнішньої системи як вихідну адресу. Усе, що не зазначено, блокується.
  4. Зберігайте отримані дані у власній схемі з organization_id, owner_user_id і business_unit_id у кожному рядку.
  5. Зчитуйте облікові дані зовнішньої системи за назвою із середовища та вкажіть змінну в scripts/ci/required-env.
  6. Запускайте отримання даних через UNO, рушій робочих процесів, і ніколи — за допомогою таймера, що звертається до рушіїв безпосередньо.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only no-credentials --only no-direct-compute --only migrations-are-scoped
node scripts/ci/required-env

validate перевіряє назву черги й тайм-аут за правилами синхронізації реєстру. Три контрольні точки доводять відсутність облікових даних моделі, прямих обчислень і наявність таблиці з правильною областю. Перед push запустіть повний nexus-gates, оскільки --only звужує запуск і повідомляє про це в підсумку. Під час виконання звернення до адреси, не оголошеної в маніфесті, зупиняється на периметрі з EGRESS_NOT_DECLARED.

Власні конектори платформи до дисків, вікі, поштових сховищ і застарілих систем із захопленням змін і відстеженням походження даних постачаються з доповненням Data connectors. Конектор, який ви створюєте самостійно, є плагіном і працює в будь-якій редакції. Додавання вихідної адреси в пізнішому релізі є розширенням, яке утримується, доки його не приймуть два рецензенти.

6. Інструмент MCP

Мета — інструмент, який можуть викликати Claude Code, агенти та інші клієнти MCP (Model Context Protocol), наприклад для пошуку історії інспекцій судна. Будівельний блок — запис у mcpTools[] маніфесту з name, description і inputSchema.

  1. Назвіть інструмент і опишіть його простими словами. Саме опис модель читає, щоб вирішити, чи викликати його.
  2. Напишіть inputSchema як одну об’єктну схему. Не розміщуйте oneOf, allOf або anyOf на її верхньому рівні.
  3. Тримайте маршрут, що обслуговує інструмент, за guard області, як і будь-який інший маршрут /api, щоб належність до тенанта визначалася токеном викликача.
  4. Виконайте валідацію маніфесту.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Доказом є validate: комбінатор верхнього рівня відхиляється під час створення, оскільки під час виконання він призвів би до збою інструмента для кожного субагента MCP, що його імпортує, і інструмент існував би, але ніхто не зміг би його викликати.

В Enterprise кожен інструмент, який може викликати IDE (інтегроване середовище розробки), зазначено в каталозі інструментів Workbench з його рівнем, ознакою того, чи вносить він зміни, закріпленим відбитком і ролями, яким дозволено його використовувати. Якщо опис вашого інструмента змінюється в новому релізі, каталог утримує інструмент, доки людина не перегляне зміну. Це зроблено навмисно: змінений опис — це спосіб, у який інструмент може почати просити модель про те, чого не слід. Звернення до будь-чого поза перепусткою викликача відхиляється з CONNECTION_SCOPE_EXCEEDED.

7. Вітрина під власним брендом (white-label)

Мета — застосунок, яким користуються клієнти вашого замовника, на домені замовника та в його бренді, без жодних слідів Adverant. Будівельні блоки — блоки domains і branding маніфесту, допоміжні засоби входу SDK і доповнення замовника Storefront / white-label.

  1. Укажіть домен замовника в domains[] як primary з усіма aliases.
  2. Заповніть branding: appName, tagline, primaryColor, accentColor, passkeyRpId, що збігається з доменом, і oauthClientRef.
  3. Здійснюйте вхід користувачів через допоміжні засоби входу SDK і точно оголосіть два їхні публічні маршрути з auth: "public" і allowAnonymous: true.
  4. Надсилайте кожен виклик фронтенду через проксі бекенду для фронтенду зі списком дозволених адрес. Ніколи не вказуйте адресу сервісу в клієнті.
  5. Залиште платежі адміністраторові замовника, який підключає платіжні шлюзи та налаштовує брендовану сторінку оформлення замовлення.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Доказом є scope-adherence. Він допускає незахищений маршрут /api лише тоді, коли маніфест оголошує саме цей метод і шлях публічними, а шлях є одним із маршрутів входу; будь-яке інше публічне оголошення не проходить перевірку, і повідомлення називає два дозволені шляхи. Потім api-contract порівнює оголошені маршрути з реальними в обох напрямках. definePlugin також відхиляє frontend.basePath, що не є відносним шляхом того самого джерела.

White-label — це додатковий модуль Storefront / white-label у редакції Enterprise, який також ліцензує платежі. Дані карток ніколи не потрапляють до Nexus. Брендом володіє адміністратор клієнта, і платформа визначає його за організацією, а не за вашим кодом.

8. Пакет місії Edge

Мета — нова або оновлена місія для супутника чи дрона з Nexus Edge, наприклад додавання адаптера пошуку суден до місії морського спостереження. Будівельний блок — пакет місії, зібраний і підписаний на землі.

  1. Почніть із поточного пакета на сторінці «Створення пакета місії», яка готує чернетку нової версії на основі старої та позначає кожну зміну.
  2. Змінюйте лише те, що потрібно місії. Великі частини, мовну модель та онтологію, за можливості залишайте незмінними.
  3. Перевіряйте таблицю розміщення на кожному кроці деградації, щоб кожна плата й надалі вміщувала те, що на ній виконується.
  4. Запустіть бортові тестові сценарії пакета на стенді з такими самими платами.
  5. Надішліть його на підписання: потрібні два підписи з трьох.
  6. Випустіть його на одну платформу. Він потрапляє в неактивний слот і вмикається лише після того, як його тестові сценарії пройдуть на борту.
  7. Розгортайте на наступну платформу після тижня без збоїв.
Пакети місій
Пакети місій
Бібліотека пакетів місій із вмістом кожного пакета та платформами, на яких він працює. Зверніть увагу на старішу версію, що зберігається на борту для повернення, і на кількість тестових сценаріїв, які кожен пакет має пройти на своєму обладнанні.

У цьому рецепті немає команд; усе виконується на сторінках Nexus Edge у консолі. Доказом є бортові тестові сценарії, які всі мають пройти до ввімкнення пакета, і два підписи. Якщо тест не проходить на борту, платформа залишається на попередньому пакеті, а збій передається на землю під час наступного прольоту. Встановлення пакета на обладнання, для якого його не перевіряли, відхиляється з PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge — це додатковий модуль, що ліцензується на платформу або на флот. Пакети залишаються чинними, поки платформа поза зв’язком. Канал висхідного зв’язку вузький, тому плануйте розміри з урахуванням цього: наш випуск 1.5 мав 412 MB, тоді як пакет із новою мовною моделлю — 9.8 GB.

9. Доставлення клієнту в ізольоване середовище (air-gapped)

Мета — ваш плагін або пакет, встановлений на об’єкті клієнта без мережі. Будівельні блоки — запечатаний пакет із @adverant/nexus-sovereign, ваш ключ підписання випусків і власні канали випусків клієнта.

  1. Зберіть плагін і його образи точно так само, як для клієнта з підключенням, з усіма перевірками в зеленому стані.
  2. Створіть запечатаний пакет із профілем airgap, що містить образи, міграції, попередньо підписані навички та SBOM (специфікацію програмного забезпечення) з ліцензіями.
  3. Підпишіть його своїм ключем випусків Ed25519.
  4. Перевірте його самостійно на чистій машині.
  5. Надішліть пакет на носії, а свій відкритий ключ і SHA-256 пакета — окремим каналом.
  6. Оператор клієнта перевіряє пакет вашим ключем, а потім вводить випуск через власні канали випусків.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgap

nexus-airgap bundle збирає пакет із вашої конфігурації пакета. Доказом є nexus-airgap verify на боці клієнта. Він повторно обчислює хеш кожного файлу, відхиляє будь-який файл, якого немає в маніфесті, вимагає довіреного підписувача та відмовляє пакету, чий список дозволених мережевих адрес не порожній. Змінений файл спричиняє помилку BUNDLE_INTEGRITY_VIOLATION. Ніхто й ніколи не повинен вимикати сувору перевірку, щоб її обійти.

Ізольовані від мережі інсталяції належать до Enterprise. Ніщо в пакеті не може нічого завантажувати під час встановлення, а модель, потрібна плагіну, надходить із власного сервера моделей клієнта через AI (штучний інтелект) Provider Router.

10. Модуль лише для редакції Enterprise

Мета — закрита ліцензована можливість, що підключається до відкритого ядра, наприклад журнал аудиту з тривалим зберіганням, який продається лише клієнтам Enterprise. Будівельний блок — інтерфейсний пакет @adverant/nexus-spi, і більше нічого з Community.

  1. Зберігайте в репозиторії побайтово закріплену копію зібраного інтерфейсного пакета як локальний пакет file: з його закріпленням SHA256SUMS.
  2. Напишіть на його основі RouteModule (або ScreenModule для екранів консолі) із групою функцій, яку він обслуговує.
  3. Пропускайте кожен маршрут через ctx.requireScope і перевіряйте власний дозвіл модуля перед відповіддю.
  4. Відмовляйте з LICENCE_LOCKED, коли організація не має права, і показуйте анонс функції, але ніколи її дані.
  5. Дотримуйтеся в репозиторії ліцензійної межі, а потім зберіть скомпоноване дерево кожної редакції.
npm ci
npm test
npm run build

Доказом є правило ліцензійної межі: жодного імпорту з області Community, крім інтерфейсного пакета, жодного відносного імпорту за межі репозиторію і жодної залежності file:, link: чи workspace: поза ним. Потім три наведені вище команди мають пройти в скомпонованому дереві кожної редакції, а не лише у вашому робочому дереві. Розділ 2.25, «Збирання для кожної редакції», містить каркас модуля.

Модуль завантажується в сервіс Community під час запуску на інсталяціях, ліцензія яких містить його групу функцій. Без цього дозволу він відмовляє, тож та сама збірка постачається всюди й нічого не робить там, де не ліцензована.

11. Форк або розширення відкритого ядра

Мета — зміна самої Community, що зберігається у вашому форку або передається назад до проєкту. Будівельний блок — вихідний код Community за ліцензією Apache License, Version 2.0.

  1. Створіть форк репозиторію та гілку від main.
  2. Віддавайте перевагу плагіну чи навичці, якщо те, що вам потрібно, може ними бути. Зміну в ядрі вам доведеться підтримувати в кожному випуску.
  3. Вносьте зміну разом із тестами, які без неї не проходять.
  4. Запустіть перевірки, які запускає проєкт, перш ніж щось пропонувати.
  5. Зберігайте файл NOTICE і не використовуйте назви чи торговельні марки Adverant поза зазначенням походження роботи.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Доказом є успішне проходження цих трьох перевірок, а також підтвердження того, що кожен новий тест не проходив до вашої зміни. Збережіть у своєму форку одну властивість відкритого ядра: Community виконує агента від початку до кінця на локальній моделі без ключа й без мережі. Зміна, що це порушує, руйнує те, що робить Community придатною до самостійного використання.

Це стосується лише Community. Усе, що має залишатися закритим, натомість належить до модуля Enterprise (сценарій 10), щоб ліцензійна межа залишалася там, де будь-хто може на неї вказати.

12. Хмарний застосунок для редакції Team

Мета — застосунок, який можуть встановити клієнти Team. Team працює лише в хмарі Adverant, тому застосунок потрапляє до них лише через каталог. Будівельні блоки — плагін і кластер видавця: ваш власний віртуальний кластер у хмарі Adverant із демонстраційними даними.

  1. Збирайте й тестуйте на кластері видавця лише з демонстраційними даними.
  2. Оголосіть у маніфесті все, що потрібно застосунку, і нічого більше.
  3. Випустіть його підписаним для перевірки Adverant і розміщення в каталозі.
  4. Кожен клієнт встановлює його, надаючи кожну оголошену область доступу для кожного підрозділу окремо.

Доказ складається з двох частин. Підписаний і перевірений випуск дає вам доступ до каталогу. Далі дозвіл клієнта визначає, до чого застосунок має доступ на його об’єкті, а будь-який виклик, якого він не оголосив, відхиляється з CONNECTION_SCOPE_EXCEEDED. Відсутню область доступу можна додати лише в новому випуску, який перевіряє клієнт.

Встановлення стороннього плагіна
Встановлення стороннього плагіна
Адміністратор встановлює сторонній плагін, надаючи кожну оголошену область доступу для кожного підрозділу й пропускаючи одну. На панелі показано відхилений виклик, якого плагін ніколи не оголошував.

Кластер видавця не має маршруту до жодного клієнта, і запит на дані клієнта там відхиляється з TENANT_BOUNDARY. Клієнти можуть ділитися з вами результатами тестів, але ніколи своїми даними. Team містить можливість операцій з робочими процесами, тож якщо ваш застосунок постачає робочі процеси, клієнти Team можуть самостійно просувати їх між середовищами.

13. Обгортання наявного внутрішнього застосунку як плагіна

Мета — застосунок, який ваша компанія вже використовує, перенесений у Nexus, щоб він успадкував вхід, ізоляцію та керування. Будівельні блоки — навичка /plugin-create для першої чернетки, а також інструменти маніфесту й перевірки SDK для завершення.

  1. Запустіть /plugin-create з репозиторієм. Вона аналізує код і обирає стратегію обгортання, а потім генерує бекенд, міграції, інтерфейс користувача (UI), маніфест і тести.
  2. Переведіть маніфест на контракт v2. migrate додає три речення правил і переносить domain до domains[], а також відмовляється вигадувати точку входу.
  3. Замініть будь-яке значення орендаря, яке обгортка зчитує із заголовків, на захисник області SDK.
  4. Додайте organization_id, owner_user_id і business_unit_id до кожної таблиці з первинними ключами, що починаються з орендаря.
  5. Оголосіть кожен маршрут із його правом і встановіть журнал відмов.
  6. Запускайте перевірки, доки вони не стануть зеленими.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin migrate nexus.manifest.json --write
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test

Доказом є завершення nexus-gates з кодом 0 і успішне проходження scope-adherence, one-fence, migrations-are-scoped, crud-adherence та api-contract. Очікуйте, що перший запуск не пройде більшість із них; наш позначив кожен маршрут як такий, що не має області, бо чернетка довіряла заголовкам, які може встановити браузер. Перевірки навмисно не мають перемикача автоматичного виправлення.

Обгорнуті застосунки працюють у будь-якій редакції. Розгортання відбувається лише через канали випусків інсталяції, тому ігноруйте будь-які файли розгортання, створені чернеткою. Найбільше часу забирає робота з ізоляції: для реального застосунку плануйте дні, а не години.