Версія 1.0.0-alpha.1найновіша
Розділ 2.22
Середовище виконання плагіна
Модулі SDK (набору засобів розробки), на базі яких працює ваш плагін: від захисника області видимості (scope guard) і бар'єра бази даних до диспетчеризації UNO, читання маршруту ШІ (штучного інтелекту) та перевірок ліцензії. Далі — тестування на реальній базі даних, реєстрація навичок і початкове підключення (onboarding).
Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

Частина SDK (набору засобів розробки ПЗ), що відповідає за середовище виконання, — це набір модулів у @adverant-nexus/plugin-sdk/runtime/*, а також допоміжні засоби для тестування в testing/*. Ви імпортуєте їх, а не реалізуєте наново. У цьому вся суть, і мені вистачило одного відхиленого код-рев'ю, щоб поставитися до цього серйозно: примітка рецензента до моєї першої власноруч написаної перевірки області видимості в плагіні складалася з одного рядка: «це вже є в SDK, а ваш код приймає токен виклику MFA (багатофакторної автентифікації) як сесію».
У цьому розділі простежується шлях запиту через запущений плагін саме так, як його зв'язує повнофункціональний шаблон: захисник області видимості, бар'єр бази даних, єдиний дозволений перетин межі, диспетчеризація через UNO, читання маршруту ШІ (штучного інтелекту) та перевірки ліцензій. Далі розглядаються тестування, реєстрація ваших навичок із маніфесту та етапи підключення.
Область видимості: один захисник на фреймворк
Кожен маршрут /api містить захисник області видимості (scope guard). Він перевіряє токен пред'явника (bearer token), визначає з нього три осі (орендар, власник, підрозділ), відхиляє тіло запиту, у якому вказано орендаря, застосовує право маршруту з реєстру маніфесту й лише тоді дозволяє запуск обробника. SDK постачає по одному адаптеру для кожного фреймворку, усі вони імпортуються з @adverant-nexus/plugin-sdk/runtime/scope і приймають однакові параметри.
| Фреймворк | Адаптер |
|---|---|
| Express | scopeMiddleware |
| Fastify | requireScope, як preHandler |
| Далі | withScope, що обгортає обробник; обробнику Next не повідомляється його маршрут, тому withScope приймає його як третій аргумент |
Ось скорочений варіант зв'язування для Express із шаблону. Верифікатор належить SDK і вимагає відповідності токена формату сесії сервісу ідентифікації: лише HS256; обов'язкові поля iss, exp, iat та jti; час життя не більше однієї години; жодні токени виклику MFA, імперсонації чи ресурсні токени OAuth (відкритого стандарту для делегованої авторизації) не допускаються як сесія.
import { platformAccessTokenVerifier } from "@adverant-nexus/plugin-sdk/runtime/platform-token";
import { scopeMiddleware } from "@adverant-nexus/plugin-sdk/runtime/scope";
const requireScope = scopeMiddleware({
verify: platformAccessTokenVerifier(config.PLATFORM_JWT_SECRET),
rights: { manifest },
});
router.get("/api/projects", requireScope, async (req, res) => {
res.json({ projects: await db.listProjects(scopeOf(req)) });
});Захисник прав застосовує право маршруту в чотири етапи. Роль зі списку never цього права відхиляє запит із кодом AUTHORITY_EXCEEDED та словами barred, і жодне місце (seat) цього не скасовує. Роль у roles надає доступ, причому також за наявності активного місця, якщо в праві вказано seat: true. В іншому разі доступ надає активне місце, що містить відповідне право. Інакше запит відхиляється з кодом AUTHORITY_EXCEEDED і зазначенням осіб, які можуть надати місце. Передайте захиснику сховище (rights: { manifest, store: { pool, schema } }), і він зчитуватиме місця у власній області видимості ініціатора виклику; для права, у якому вказано licence, також потрібен засіб читання ліцензій, описаний нижче.
Усередині обробника scopeOf(req) є єдиним способом прочитати визначену область видимості, і він генерує виняток, якщо захисник не спрацював. Захисник, зареєстрований для префікса, який запускається до збігу з будь-яким маршрутом, повертає помилку 500 MIDDLEWARE_ORDERING_ERROR; маршрут, зареєстрований вашим кодом, але не оголошений у маніфесті, повертає помилку 500 UNHANDLED_ERROR. В обох випадках діє принцип безпечної відмови (fail closed).
Маршрути /internal шаблону, які викликає платформа, використовують інший режим. Сервісний захисник перевіряє X-Service-Key за сталий час і бере орендаря з X-Organization-ID платформи, відхиляючи MISSING_SERVICE_KEY, INVALID_SERVICE_KEY або MISSING_ORG_ID_HEADER. Для підписаного платформою токена на кожен виклик у SDK передбачено requireService (Fastify) та serviceMiddleware (Express), які також перевіряють, для якої навички та маршруту було випущено токен, і відхиляють повторно використаний токен.
Бар'єр бази даних: tenantFence та withScopedTx
Кожен оператор, що звертається до таблиці з обмеженою областю видимості, формує бар'єр і виконується всередині транзакції з обмеженою областю видимості:
import { withScopedTx } from "@adverant-nexus/plugin-sdk/runtime/db";
import { tenantFence } from "@adverant-nexus/plugin-sdk/runtime/fence";
async function listProjects(scope: ResolvedScope) {
// Projects are owner-private inside the organisation, so the owner axis is passed explicitly.
const f = tenantFence(scope, { alias: "p", owner: scope.owner });
const r = await withScopedTx(pool, scope, { schema: SCHEMA }, (db) =>
db.query(`SELECT p.* FROM anomaly_review.reviews p WHERE ${f.where} ORDER BY p.created_at DESC`, f.params),
);
return r.rows;
}tenantFence(scope, options) будує предикат та його параметри на основі визначеної області видимості. Передавайте owner для персональних таблиць; опускайте його для артефактів організації, де власник вказує на походження. Коли оператор уже має параметри, startIndex вказує бар'єру, з якого номера починати нумерацію. Операція вставки ніколи не приймає осі як вхідні дані: вона записує scope.tenant, scope.owner та scope.unit з області видимості.
withScopedTx прив'язує всі три осі для однієї транзакції через єдину функцію прив'язки схеми, а потім запускає вашу функцію зворотного виклику. Повторна прив'язка в тій самій транзакції викликає SCOPE_ALREADY_BOUND (500: ваш код виконав прив'язку двічі; ініціатор виклику нічого не порушив). Відсутній або нульовий орендар чи власник викликає SCOPE_PREDICATE_INVALID (403). Налаштування діє локально в межах транзакції, тому з'єднання з пулу не може перенести одного орендаря в наступний запит.
Дві споріднені функції охоплюють випадки, які не є запитами від людини. withTenantScopedTx прив'язує орендаря та підрозділ без власника для рядків, які зчитує машина (реєстр пристроїв), і відхиляє область видимості, що містить власника. maintenanceScope(reason) змушує операцію рівня всієї організації явно задекларувати свою суть перед тим, як відкриється транзакція власника. Кодовий бар'єр і примусова безпека на рівні рядків (RLS) — це два механізми реалізації одного закону; перевірка під час завантаження відмовляється приймати запити, доки база даних не доведе, що другий механізм діє (інакше виникає DB_ROLE_BYPASSES_ISOLATION).
Кожна відмова записується в рядок
Шаблон встановлює ще один компонент проміжного ПЗ (middleware), один раз, між аналізатором тіла запиту та маршрутизаторами: журнал відмов.
import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";
app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));Він обгортає відповідь таким чином, щоб кожна відмова, яку отримує користувач — чи то від захисника прав, обробника, чи то від сховища, — записувалася до таблиці refusal вашої схеми всередині власної транзакції з областю видимості цієї особи перед надсиланням тіла відповіді. Анонімна помилка 401 нічого не записує. Якщо рядок неможливо записати, відповідь змінюється на UNHANDLED_ERROR: відмова, яку продукт не може зафіксувати, не надсилається так, ніби її було зафіксовано. Під час завантаження запускається assertRefusalLedger, щоб перевірити, чи може таблиця прийняти рядок журналу, а сховище може викликати noteSubject({ recordId, isDemo }), щоб кожна відмова вказувала запис, якого вона стосувалася. Коли клієнт запитує, чому комусь було відмовлено в доступі минулого вівторка, відповіддю є запит до бази, а не припущення.
Єдиний виняток для перетину межі: зафіксований дозвіл лише на читання
Коли один із ваших клієнтів виконує роботу для іншого, а той інший має право її перевіряти, існує єдиний санкціонований спосіб перетину межі. Організація, що володіє рядками, реєструє дозвіл (grant). Організація читача надає особі доступ через місце, що містить право granted.read, у якому мають бути вказані owner та admin у never. Читання виконується від імені шостої ролі бази даних — місця для читання (read seat), яке може вибирати дані лише з таблиць, перелічених у databases[].granted:
const r = await withSeatTx({ app: appPool, seat: seatPool }, seatsOf(req), { holder, grantId }, { schema: "anomaly_review" }, (db) => {
const f = grantFence(db.seat, { alias: "r" });
return db.query(`SELECT r.review_id FROM anomaly_review.reviews r WHERE ${f.where}`, f.params);
});
if (!r.ok) return res.status(r.status).json(r.refusal);withSeatTx спочатку записує факт перегляду в орендарі самого читача, а потім прив'язує місце для читання до дозволу, який записує факт перегляду в орендарі власника даних. Власна політика бази даних перевіряє, що в дозволі вказано організацію читача, що він охоплює цю таблицю, набув чинності, не закінчився і не був відкликаний, а також що ця транзакція записала свій факт перегляду. Читання, яке пропускає запис про перегляд, не бачить нічого. Під час завантаження assertSeatAtBoot(seatPool, schema) перевіряє, чи пул, відкритий із seat.url, дійсно є місцем для читання і нічим більше, а в іншому разі відмовляє з помилкою DB_SEAT_ROLE_INVALID.
Диспетчеризація через UNO
Усі обчислення проходять через один клієнт, зібраний в одному файлі, із закритим списком дозволеного (allow-list):
import { UnoClient } from "@adverant-nexus/plugin-sdk/runtime/uno";
/** The namespaced job types this surface may dispatch. Closed; edit in code. */
export const DISPATCHABLE = Object.freeze([`${manifest.name}.sentiment_score`] as const);
export function createUno(deps: UnoDeps): UnoClient {
return new UnoClient({
baseUrl: deps.dispatchUrl,
serviceKey: deps.serviceKey,
callerService: manifest.name,
dispatchable: DISPATCHABLE,
});
}Список дозволеного навмисно зроблено константою рівня модуля. Якби оператор міг розширити його через конфігурацію, маршрут перетворився б на проксі диспетчеризації для всього реєстру. Власний тест шаблону перевіряє, що в списку вказано лише ті типи завдань, у які компілюється маніфест.
Конверт
Диспетчеризація у своїй обов'язковій основі містить шість полів. Клієнт заповнює орендаря та суб'єкта дії (actor) із перевіреної області видимості, і ніколи — із запиту:
| Поле | Що містить |
|---|---|
jobType |
Тип завдання з простором імен, <plugin name>.<skill id> |
organizationId |
Орендар, з області видимості |
userId |
Суб'єкт дії, з області видимості, для аудиту та білінгу |
inputParams |
Вхідні дані навички. Вони ніколи не містять ідентифікатора орендаря; якщо він там є, запит відхиляється під час диспетчеризації |
priority |
critical, high, normal або low |
pluginId |
Ваш name маніфесту. Кожна диспетчеризація оголошує свій вихідний плагін |
Необов'язкові поля включають correlationId (UUID — універсальний унікальний ідентифікатор, або генерується новий) та callbackUrl, який потрібен навичці plugin_queue, щоб воркер знав, куди надсилати результат.
const accepted = await uno.dispatch(scope, {
jobType: DISPATCHABLE[0],
inputParams: { text: text.body },
priority: "normal",
pluginId: manifest.name,
correlationId: crypto.randomUUID(),
});
if (!accepted.ok) return res.status(statusFor(accepted.refusal.code)).json(accepted.refusal);
res.status(202).json(accepted.value);202, а потім опитування
Кожна диспетчеризація ставиться в чергу. Відповіддю завжди є 202 з ідентифікаторами (jobId, runId, traceId, status), і ніколи — сам результат. Результат надходить під час опитування завдання або через ваш зворотний виклик. uno.peek(jobId, { scope }) зчитує його один раз, а awaitJob опитує до досягнення кінцевого статусу; обидва надсилають орендаря з перевіреної області видимості, і обидва звіряють organization_id повернутого рядка з орендарем ініціатора виклику на вашому боці мережевого виклику, відхиляючи невідповідність із помилкою SCOPE_REFUSED.
Читаючи рядок виконання, зважайте на його власні назви полів. Відповідь диспетчеризації містить jobId; а рядок містить job_id, organization_id та plugin_id. Стовпцями результату та помилки є result, error, error_code та error_troubleshooting. Статуси completed і failed є кінцевими. Статуси timed_out, cancelled та system_failure надходять від процесу очищення (reaper), і запізнілий результат усе ще може їх виправити. Клієнт, який трактує будь-який із них як такий, що не піддається синтаксичному аналізу, відхиляє рядки, які платформа записує щодня.
Утримання до затвердження
Навичка маніфесту, яка оголошує approval, утримується під час диспетчеризації. Тоді 202 повертає status: "awaiting_approval" і містить waitpointId із причиною, вказаною в маніфесті. Виконання залишається на утриманні, доки визначена особа не винесе рішення щодо нього. uno.approve та uno.resolveWaitpoint надсилають орендаря та ініціатора виклику як суб'єкта дії, а рішення від когось іншого, крім перевіреного ініціатора виклику, відхиляється. Затвердження одноразово вивільняє завдання і знову запускає перевірки диспетчеризації; відхилення завершує його зі статусом failed. Повторне рішення відхиляється, як і рішення після закінчення терміну дії утримання. Якщо ваш продукт вимагає, щоб особа, яка затверджує, відрізнялася від ініціатора пропозиції, забезпечте це примусово в маршруті, який виносить рішення: платформа фіксує обох.
Відображайте утримуване завдання як утримуване. Не повідомляйте користувачу, що його клік вивільнив завдання, доки це не буде вказано в рядку виконання.
ШІ: побажання в рядку навички та одне читання
Ваш плагін ніколи не викликає модель. Коли навичці маніфесту потрібна модель (llm_only або tool_using, із рівнем довіри core або verified), ви вказуєте побажання в її рядку реєстру, а маршрутизатор приймає рішення на основі власного пулу організації:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
}
}preferredProvider та preferredModel — це побажання, які маршрутизатор враховує лише тоді, коли в організації цього провайдера увімкнено та забезпечено обліковими даними. capabilityProfile фільтрує, але ніколи не вибирає; його dataResidency (eu_only, us_only або any) є жорстким обмеженням, яке маршрутизатор або задовольняє, або відхиляє запит. Зазвичай найкраще опустити їх усі. modelOverride існує для рідкісних навичок, яким потрібна одна конкретна модель, і робить сусідні побажання неактивними; я б уникав цього параметра, якщо тільки навичка не втрачає сенсу на будь-якій іншій моделі.
Коли вашому інтерфейсу потрібно показати, яку модель використає маршрутизатор, зчитайте це значення, а не намагайтеся передбачити:
import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";createAIRouteClient(...).effectiveRoute() — це єдиний санкціонований спосіб читання з Маршрутизатора провайдерів ШІ (AI Provider Router). Він приймає адресу шлюзу, власний токен пред'явника ініціатора виклику та коротке ім'я (slug) вашої платформи, не надсилаючи жодного запиту до ШІ. Він повертає провайдера та модель, перелік провайдерів, дозволених політикою, а також те, як працює вибрана кінцева точка — local чи external. Коли маршрут непридатний для використання, він повертає відмову маршрутизатора словами (NO_PROVIDER_FOR_ROLE, MODEL_CAPABILITY_UNAVAILABLE або NO_MODEL_FOR_ROLE_AND_PROVIDER, разом зі способом усунення проблеми), і ніколи — модель за замовчуванням. Покажіть цю відмову користувачу; так говорить конфігурація його організації.
Перевірки ліцензії
Три механізми перевіряють ліцензування на трьох рівнях деталізації.
Право, у якому вказано ліцензію. Найпростіший варіант. У маніфесті право містить licence: "<feature>", і захисник за допомогою власного токена ініціатора виклику запитує в сервісу ідентифікації, чи підтримує це ліцензія організації, ще до зчитування будь-якої ролі. Створіть захисник із засобом читання:
import { createLicenceReader } from "@adverant-nexus/plugin-sdk/runtime/licence";
const requireScope = scopeMiddleware({
verify,
rights: { manifest, store: { pool, schema: SCHEMA }, licence: createLicenceReader({ baseUrl: config.NEXUS_AUTH_URL }) },
});Ліцензія, яка не містить потрібної функції, відмовляє всім із кодом LICENCE_LOCKED, вказуючи, де ця функція є, і повідомляючи, що власники та адміністратори організації можуть її увімкнути. Ліцензія, яку не вдається прочитати, відмовляє з кодом UNHANDLED_ERROR: заблокована функція ніколи не надається через те, що ліцензія була недоступною. Відповіді запам'ятовуються на 30 секунд для кожної комбінації організації та функції.
Продуктовий шлюз. createProductGate({ baseUrl, product }) із runtime/product-gate звертається до перевірки прав (entitlement check), щоб дізнатися, чи володіє організація ініціатора виклику вашим продуктом узагалі, а його middleware() запускається після захисника області видимості. Негативний вердикт повертає ENTITLEMENT_DENIED; недоступна перевірка повертає ENTITLEMENT_UNREACHABLE, і шлюз ніколи не підміняє одне іншим.
Сам документ ліцензії. Код, який мусить приймати рішення самостійно на основі підписаної ліцензії, наприклад закритий модуль галузевого пакета (domain pack), використовує verifyLicenceDocument(docText, opts) із runtime/licence-document. Це чиста функція: жодних мережевих викликів, жодних змінних середовища, жодних файлів. Вона перевіряє обидва підписи за кореневими сертифікатами довіри, вбудованими в збірку, і повертає стан (VALID, WARN, GRACE, RESTRICT, TERMINATE або ABSENT) разом із дозволами, доповненнями та галузевими пакетами. Потім licenceAllows(verdict, featureGroup, action, tenantId?) визначає, чи можете ви виконувати use або provision у межах групи. RESTRICT дозволяє use і відповідає на provision значенням LICENCE_LOCKED, щоб поточна робота тривала, але нічого нового не запускалося.
Тестування
Тести шаблону демонструють цей шаблон проектування; ось інструменти, що стоять за ним.
Імітації області видимості (Scope fakes). Створіть тестовий дублікат визначеної області видимості один раз у test/scope-fakes.ts і впроваджуйте його всюди, включно з випадками відсутності даних: без підрозділу, без токена, токен із нульовою організацією. Шляхи обробки відмов — це і є продукт.
Імітація транспорту диспетчеризації. UnoClient приймає fetch, now та sleep, тому модульний тест ніколи не звертається до мережі. Перевіряйте (assert) поля конверта, структуру 202, опитування до кінцевого рядка з його organization_id, а також те, що рядок для іншого орендаря відкидається.
Справжній Postgres. Імітація функції запиту перевіряє лише рядок SQL. Вона не може довести, що примусова безпека на рівні рядків діє або що файли застосовуються мігратором у правильному порядку. testing/ephemeral-postgres запускає одноразовий сервер і виконує ті самі операції nexus-migrate, що й у продуктивному середовищі:
import { EPHEMERAL_REMEDY, migrated, startEphemeralPostgres } from "@adverant-nexus/plugin-sdk/testing/ephemeral-postgres";
const pg = await startEphemeralPostgres(); // null off CI: skip each case by name with EPHEMERAL_REMEDY
const db = migrated(pg!, "plugin_test", { root }); // provision as the superuser, then every file as the migrator
// connect as db.appUrl and run the boot checks the server runsПоза середовищем CI (безперервної інтеграції) машина без сервера Postgres пропускає кожен тестовий випадок бази даних за іменем, вказуючи спосіб усунення проблеми, але ніколи не позначає його як успішний (зелений). У CI така сама відсутність призводить до збою всього набору тестів (EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI), оскільки пропущений тест безпеки на рівні рядків — це «зелений» шлюз, який нічого не виміряв. Сервер чекає на запуск до 180 секунд, а сторожовий таймер (watchdog) зупиняє його, коли процес тестування завершується.
Тестовий стенд ізоляції. runIsolationHarness(target) із testing/isolation-harness зчитує кожен маршрут, який монтує ваш застосунок, і атакує кожен із них від імені адміністратора іншої організації та від імені колеги. Потім він атакує знову: зі знятим кодовим бар'єром, зі знятим бар'єром бази даних та зі знятими обома бар'єрами. Маршрут отримує статус PROVEN лише тоді, коли атака зазнає невдачі за наявності будь-якого з бар'єрів і досягає даних жертви, коли знято обидва, — так ви точно знаєте, що тест узагалі здатний побачити витік. Стенд надсилає оголошений запит і приклад тіла для кожного маршруту, тому маршрут, який відхиляє порожній запит, усе одно перевіряється. Зафіксуйте ledgerOf(report) у тесті та налаштуйте збій у разі defectsOf(report).
Реєстрація: від маніфесту до реєстру навичок
Ваші навички з маніфесту потрапляють до реєстру навичок єдиним шляхом:
manifest.skills[] → compileRegistry(manifest) → POST /api/v1/plugins/sync
compileRegistry перетворює перевірений маніфест на тіло nexus.plugin-sync/v1. Шаблон робить це під час імпорту, тому недійсний маніфест зриває збірку:
import { compileRegistry, definePlugin } from "@adverant-nexus/plugin-sdk";
export const manifest = definePlugin(raw);
export const registryPayload = compileRegistry(manifest);{
"contract": "nexus.plugin-sync/v1",
"pluginId": "anomaly-review",
"version": "0.3.0",
"skills": [ { "job_type": "anomaly-review.excursion_summary", "tier": "host_callback", "classification": "tenant" } ]
}Синхронізація є декларативною: щоразу надсилайте весь набір навичок, а пропущена навичка вимикається зі збереженням її історії. Вона сувора: невідоме поле, поле іншого рівня або null відхиляються, усі порушення повертаються разом в одному 400 SYNC_CONTRACT_VIOLATION, і за наявності хоча б одного порушення нічого не записується. Вона записує по одному рядку реєстру на кожну навичку з ключем за типом завдання з простором імен, що містить усі стовпці, які читає диспетчер, тому навичка готова до запуску тієї ж миті, коли синхронізація відповідає 200.
Автентифікованим ініціатором виклику є сам плагін, а не поле в тілі запиту. Викликайте синхронізацію з власного робочого навантаження вашого плагіна через mTLS (взаємний TLS: протокол захисту транспортного рівня із сертифікатами з обох сторін). Рушій навичок (Skills Engine) зчитує клієнтський сертифікат вашого робочого навантаження, чий ідентифікатор SPIFFE (spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>) вказує простір імен та сервісний обліковий запис, і знаходить плагін та організацію-власника, записані для цього простору імен. Поле pluginId у тілі запиту має збігатися; це перевірка, а не селектор. Кожен рядок записується із цим плагіном та організацією.
| Статус | Код | Значення |
|---|---|---|
| 200 | {contract, pluginId, version, created, updated, unchanged, disabled, skills} |
|
| 400 | SYNC_CONTRACT_VIOLATION |
Усі порушення перелічено в violations[]; нічого не записано |
| 401 | UNAUTHORIZED |
Неправильний або відсутній сервісний ключ |
| 401 | CALLER_IDENTITY_UNVERIFIED |
Немає придатного для читання ідентифікатора клієнта |
| 403 | DELIVERY_IDENTITY_MISSING |
Простір імен, що здійснює виклик, не належить жодному плагіну |
| 403 | PLUGIN_ID_MISMATCH |
У тілі запиту вказано інший плагін |
| 409 | REGISTRY_CONFLICT |
Тип завдання належить іншому компоненту або був зареєстрований поза синхронізацією; нічого не записано |
Переривайте етап розгортання помилкою за будь-якого статусу, крім 200. Жоден інший статус не означає, що ваші навички зареєстровано.
Початкове підключення (Onboarding)
Підключення виконується як десять послідовних кроків, кожен з яких можна окремо перезапустити, скасувати або відкотити:
- Клонувати репозиторій та перевірити його.
- Розібрати маніфест.
- Просканувати його на наявність проблем із безпекою.
- Зібрати образ.
- Надіслати його до реєстру інсталяції.
- Налаштувати його доменні імена.
- Розгорнути його через канали випуску інсталяції.
- Дочекатися перевірки працездатності (health check).
- Зареєструвати плагін.
- Повідомити розробника.
Перед розгортанням щодо маніфесту та зібраного образу виконуються п'ять перевірок на відповідність: маніфест піддається синтаксичному аналізу та містить обов'язкові поля; кожен оголошений маршрут є реальним зареєстрованим маршрутом; плагін володіє своєю схемою і нічого не записує поза нею; запити на ресурси оголошені та перебувають у допустимих межах; образ має робочий обробник перевірки працездатності. Плагін, який реєструє себе під час завантаження, виконує той самий контракт під власними повноваженнями, тому ці перевірки стають його власним CI, а не частиною конвеєра. Пропуск однієї з них не пришвидшує підключення, а лише переносить збій на час виконання.
Брендинг із вашого маніфесту віддається за доменом без автентифікації, оскільки він потрібен сторінці входу ще до того, як хтось введе облікові дані. Вважайте все, що міститься в branding, публічним.
GATE_CANNOT_BE_SKIPPED.Чого середовище виконання не зробить замість вас
Середовище виконання тримає оборону в питаннях ізоляції, диспетчеризації та доступу до моделей. Воно не зробить логіку вашого продукту правильною і не пришвидшить повільний запит: кожен оператор виконується всередині прив'язаної транзакції з тайм-аутами, які оголошує блок db вашого маніфесту, а оператор, що перевищує statementTimeoutMs, скасовується, а не очікує завершення. Розраховуйте розмір своїх запитів з огляду на це. Крім того, утримання до затвердження, місце для читання та засіб читання ліцензій додають мережевий обмін або транзакцію. У моєму плагіні для перегляду аномалій перевірка ліцензії додавала кілька мілісекунд на запит, доки не прогрівалася її 30-секундна пам'ять, що було справедливою ціною за гарантію того, що заблокована функція ніколи не буде надана.

