Verze 1.0.0-alpha.1nejnovější
Kapitola 2.22
Běhové prostředí pluginu
Moduly SDK (sady pro vývoj softwaru), na kterých váš plugin běží – od strážce rozsahu a databázové ohrady přes dispečink UNO až po čtení trasy AI (umělé inteligence) a kontroly licencí. Následuje testování oproti reálné databázi, registrace dovedností a úvodní nastavení.
Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

Běhová polovina SDK (sady pro vývoj softwaru) je sada modulů v @adverant-nexus/plugin-sdk/runtime/* a k tomu testovací pomůcky v testing/*. Importujete je, nepíšete je znovu. V tom je celá myšlenka a vzít ji vážně mě stálo jedno zamítnuté hodnocení: poznámka recenzenta k ručně napsané kontrole rozsahu v mém prvním pluginu měla jediný řádek: „SDK už tohle má a ta vaše přijímá token výzvy MFA (vícefaktorového ověřování) jako relaci“.
Tato kapitola sleduje požadavek běžícím pluginem tak, jak jej zapojuje šablona plné služby: strážce rozsahu, databázový plot, jediný povolený přechod, odeslání přes UNO, čtení trasy AI (umělé inteligence) a kontroly licence. Poté se věnuje testování, registraci dovedností z manifestu a krokům zaškolení.
Rozsah: jeden strážce na framework
Každá trasa /api nese strážce rozsahu. Ten ověří token nosiče, vyhodnotí z něj tři osy (tenant, vlastník, jednotka), odmítne tělo požadavku, které uvádí tenanta, uplatní oprávnění trasy z registru manifestu a teprve poté nechá běžet obslužnou rutinu. SDK dodává jeden adaptér pro každý framework, všechny z @adverant-nexus/plugin-sdk/runtime/scope a všechny se stejnými volbami.
| Framework | Adaptér |
|---|---|
| Express | scopeMiddleware |
| Fastify | requireScope jako preHandler |
| Next | withScope, obalující obslužnou rutinu; obslužná rutina Next nezná svou trasu, proto ji withScope přijímá jako třetí argument |
Zde je zkrácené zapojení šablony pro Express. Ověřovatel pochází ze SDK a drží token ve formátu relace služby identit: pouze HS256; povinné iss, exp, iat a jti; životnost nejvýše hodinu; a žádný token výzvy MFA, zosobnění ani token prostředku OAuth (otevřeného standardu pro delegovanou autorizaci) není přijat jako relace.
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)) });
});Strážce oprávnění uplatňuje oprávnění trasy ve čtyřech krocích. Role v seznamu never daného oprávnění vede k odmítnutí s AUTHORITY_EXCEEDED a slovy barred a žádné místo to nezmění. Role v roles přístup povoluje, a pokud to oprávnění uvádí (seat: true), navíc s aktivním místem. Jinak přístup povoluje aktivní místo nesoucí dané oprávnění. Jinak je požadavek odmítnut s AUTHORITY_EXCEEDED a jsou uvedeny osoby, které mohou místo přidělit. Předáte-li strážci úložiště (rights: { manifest, store: { pool, schema } }), čte místa v rámci vlastního rozsahu volajícího; oprávnění, které uvádí licence, potřebuje také čtečku licencí, popsanou níže.
Uvnitř obslužné rutiny je scopeOf(req) jediným způsobem, jak číst vyhodnocený rozsah, a vyvolá výjimku, pokud strážce neproběhl. Strážce registrovaný na prefixu, který běží dříve, než se shodovala jakákoli trasa, odpoví 500 MIDDLEWARE_ORDERING_ERROR; trasa registrovaná vaším kódem, kterou manifest nedeklaruje, odpoví 500 UNHANDLED_ERROR. Obojí selhává do uzavřeného stavu.
Trasy šablony /internal, které volá platforma, používají druhý režim. Strážce služby kontroluje X-Service-Key v konstantním čase a přebírá tenanta z X-Organization-ID platformy, přičemž odmítá MISSING_SERVICE_KEY, INVALID_SERVICE_KEY nebo MISSING_ORG_ID_HEADER. Pro podepsaný token platformy pro jednotlivé volání má SDK requireService (Fastify) a serviceMiddleware (Express), které navíc kontrolují, pro jakou dovednost a trasu byl token vydán, a odmítají token použitý dvakrát.
Databázový plot: tenantFence a withScopedTx
Každý příkaz nad tabulkou s rozsahem skládá plot a běží uvnitř transakce s rozsahem:
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) sestaví predikát a jeho parametry z vyhodnoceného rozsahu. Pro osobní tabulky předejte owner; u artefaktů organizace, kde vlastník značí původ, jej vynechte. Má-li příkaz již parametry, startIndex plotu sdělí, od jakého čísla číslovat. Vložení nikdy nepřijímá osy jako vstup: zapisuje scope.tenant, scope.owner a scope.unit z rozsahu.
withScopedTx naváže všechny tři osy pro jednu transakci prostřednictvím jediné vazební funkce schématu a poté spustí vaše zpětné volání. Druhé navázání v téže transakci vyvolá SCOPE_ALREADY_BOUND (500: váš kód navázal dvakrát; volající nic špatně neudělal). Chybějící nebo nulový tenant či vlastník vyvolá SCOPE_PREDICATE_INVALID (403). Nastavení je lokální pro transakci, takže připojení z fondu nemůže přenést jednoho tenanta do dalšího požadavku.
Dva sourozenci pokrývají případy, které nejsou požadavkem osoby. withTenantScopedTx naváže tenanta a jednotku bez vlastníka pro řádky, které čte stroj (registr zařízení), a odmítne rozsah, který vlastníka nese. maintenanceScope(reason) přiměje operaci napříč celou organizací nahlas říci, čím je, než se otevře transakce vlastníka. Kódový plot a vynucené zabezpečení na úrovni řádků jsou dva mechanismy jednoho zákona; kontrola při spuštění odmítne naslouchat, dokud databáze neprokáže, že druhý z nich platí (jinak DB_ROLE_BYPASSES_ISOLATION).
Každé zamítnutí je řádek
Šablona instaluje ještě jeden middleware, jednou, mezi parser těla a směrovače: knihu odmítnutí.
import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";
app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));Obaluje odpověď tak, aby každé odmítnutí, které osoba uvidí, ať už od strážce oprávnění, obslužné rutiny nebo úložiště, bylo před odesláním těla zapsáno do tabulky refusal vašeho schématu uvnitř vlastní transakce s rozsahem dané osoby. Anonymní 401 nezapisuje nic. Nelze-li řádek zapsat, odpovědí se stane UNHANDLED_ERROR: „ne“, které produkt nedokáže zaznamenat, se neodešle, jako by zaznamenáno bylo. Při spuštění se provede assertRefusalLedger ke kontrole, že tabulka pojme řádek knihy, a úložiště může volat noteSubject({ recordId, isDemo }), aby každé odmítnutí uvádělo záznam, kterého se týkalo. Když se zákazník zeptá, proč byl někdo minulé úterý odmítnut, odpovědí je dotaz, nikoli odhad.
Jediný průchod: zaznamenané oprávnění pouze pro čtení
Když jeden z vašich zákazníků pracuje pro jiného a ten může práci kontrolovat, existuje jediný schválený způsob, jak hranici překročit. Organizace, která řádky drží, zaznamená udělení. Organizace čtenáře připustí osobu prostřednictvím místa nesoucího oprávnění granted.read, které musí uvádět owner a admin v never. Čtení běží jako šestá databázová role, místo pro čtení, které může vybírat pouze z tabulek uvedených v 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 nejprve zapíše nahlédnutí ve vlastním tenantovi čtenáře, poté naváže místo pro čtení na udělení, čímž se zapíše nahlédnutí v tenantovi držitele. Vlastní zásada databáze kontroluje, že udělení uvádí organizaci čtenáře, pokrývá tabulku, začalo, neskončilo a nebylo odvoláno a že tato transakce zapsala své nahlédnutí. Čtení, které nahlédnutí vynechá, nevidí nic. Při spuštění assertSeatAtBoot(seatPool, schema) kontroluje, že fond otevřený z seat.url je skutečně tímto místem a ničím víc, a jinak odmítne s DB_SEAT_ROLE_INVALID.
Dispečink přes UNO
Veškeré výpočty procházejí jediným klientem, sestaveným v jediném souboru, s uzavřeným seznamem povolených:
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,
});
}Seznam povolených je záměrně konstantou na úrovni modulu. Kdyby jej operátor mohl rozšířit z konfigurace, trasa by se stala proxy pro odesílání do celého registru. Vlastní test šablony ověřuje, že seznam uvádí přesně ty typy úloh, na které se manifest kompiluje.
Obálka
Odeslání nese ve svém povinném jádru šest polí. Klient vyplní tenanta a aktéra z ověřeného rozsahu, nikdy z požadavku:
| Pole | Co obsahuje |
|---|---|
jobType |
Typ úlohy s jmenným prostorem, <plugin name>.<skill id> |
organizationId |
Tenant, z rozsahu |
userId |
Aktér, z rozsahu, pro audit a fakturaci |
inputParams |
Vstup dovednosti. Nikdy nenese ID tenanta; vstup, který jej nese, je při odeslání odmítnut |
priority |
critical, high, normal nebo low |
pluginId |
Váš manifest name. Každé odeslání deklaruje svůj původní plugin |
Volitelná pole zahrnují correlationId (UUID (univerzálně jedinečný identifikátor), jinak se vytvoří nový) a callbackUrl, které dovednost plugin_queue potřebuje, aby pracovník věděl, kam odeslat svůj výsledek.
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, pak dotazování
Každé odeslání je zařazeno do fronty. Odpovědí je vždy 202 s identifikátory (jobId, runId, traceId, status), nikdy výsledek. Výsledek získáte dotazováním na úlohu nebo z vašeho zpětného volání. uno.peek(jobId, { scope }) jej přečte jednou a awaitJob se dotazuje až do koncového stavu; obě posílají tenanta z ověřeného rozsahu a obě kontrolují organization_id vráceného řádku proti tenantovi volajícího na vaší straně síťového volání a nesoulad odmítnou s SCOPE_REFUSED.
Čtěte řádek běhu v jeho vlastním zápisu. Odpověď na odeslání uvádí jobId; řádek uvádí job_id, organization_id a plugin_id. Sloupce výsledku a selhání jsou result, error, error_code a error_troubleshooting. completed a failed jsou koncové. timed_out, cancelled a system_failure pocházejí od sběrače a pozdní výsledek je může ještě opravit. Klient, který kterýkoli z nich považuje za nezpracovatelný, odmítá řádky, které platforma zapisuje každý den.
Pozdržení ke schválení
Dovednost z manifestu, která deklaruje approval, je při odeslání pozdržena. 202 pak uvádí status: "awaiting_approval" a nese waitpointId s důvodem, který uvedl manifest. Běh zůstává pozdržen, dokud o něm nerozhodne jmenovitá osoba. uno.approve a uno.resolveWaitpoint posílají tenanta a volajícího jako aktéra a rozhodnutí kýmkoli jiným než ověřeným volajícím je odmítnuto. Schválení úlohu jednou uvolní a znovu provede kontroly odeslání; zamítnutí ji ukončí s failed. Druhé rozhodnutí je odmítnuto, stejně jako rozhodnutí po vypršení pozdržení. Pokud váš produkt vyžaduje, aby schvalovatel byl jiná osoba než navrhovatel, vynuťte to v trase, která rozhoduje: platforma zaznamenává obě.
Pozdrženou úlohu zobrazujte jako pozdrženou. Neříkejte osobě, že její kliknutí ji uvolnilo, dokud to neuvádí řádek běhu.
AI: přání na řádku dovednosti a jedno čtení
Váš plugin nikdy nevolá model. Když jej dovednost z manifestu potřebuje (llm_only nebo tool_using, s důvěrou core nebo verified), vyjádříte preference v jejím řádku registru a směrovač rozhodne z vlastního fondu organizace:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
}
}preferredProvider a preferredModel jsou přání, která směrovač respektuje pouze tehdy, má-li organizace daného poskytovatele povoleného a s přihlašovacími údaji. capabilityProfile filtruje a nikdy nevybírá; jeho dataResidency (eu_only, us_only nebo any) je pevné omezení, které směrovač splní, nebo odmítne. Vynechat je všechny je obvykle správné. modelOverride existuje pro vzácnou dovednost, která potřebuje jeden přesný model, a přání vedle něj činí neúčinnými; doporučuji se mu vyhnout, pokud dovednost na jakémkoli jiném modelu nedává smysl.
Když vaše rozhraní potřebuje ukázat, který model by směrovač použil, přečtěte jej, nepředvídejte jej:
import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";createAIRouteClient(...).effectiveRoute() je jediné schválené čtení z AI Provider Router. Přijímá adresu brány, vlastní token nosiče volajícího a slug vaší platformy a neodesílá žádný požadavek na AI. Odpovídá poskytovatelem a modelem, poskytovateli, které zásada povoluje, a tím, zda zvolený koncový bod běží local nebo external. Když trasa není použitelná, odpoví odmítnutím směrovače slovy (NO_PROVIDER_FOR_ROLE, MODEL_CAPABILITY_UNAVAILABLE nebo NO_MODEL_FOR_ROLE_AND_PROVIDER, s nápravou), nikdy výchozím modelem. Ukažte toto odmítnutí osobě; mluví z něj konfigurace její organizace.
Kontroly licencí
Licencování kontrolují tři mechanismy na třech úrovních podrobnosti.
Oprávnění, které uvádí licenci. Nejjednodušší. V manifestu oprávnění nese licence: "<feature>" a strážce se služby identit s vlastním tokenem volajícího zeptá, zda licence organizace tuto funkci zahrnuje, ještě než přečte jakoukoli roli. Sestavte strážce se čtečkou:
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, která funkci nezahrnuje, odmítne každého s LICENCE_LOCKED, uvede, co ji zahrnuje, a sdělí, že ji mohou zapnout vlastníci a správci organizace. Licence, kterou nelze přečíst, odmítne s UNHANDLED_ERROR: uzamčená funkce není nikdy poskytnuta proto, že licence byla nedostupná. Odpovědi se pamatují 30 sekund pro každou organizaci a funkci.
Brána produktu. createProductGate({ baseUrl, product }) z runtime/product-gate se kontroly nároků ptá, zda organizace volajícího váš produkt vůbec drží, a její middleware() běží po strážci rozsahu. Záporný verdikt je ENTITLEMENT_DENIED; nedostupná kontrola je ENTITLEMENT_UNREACHABLE a brána nikdy nezaměňuje jedno za druhé.
Samotný licenční dokument. Kód, který musí rozhodnout sám podle podepsané licence, například uzavřený modul doménového balíčku, používá verifyLicenceDocument(docText, opts) z runtime/licence-document. Je to čistá funkce: žádné síťové volání, žádná proměnná prostředí, žádný soubor. Ověří oba podpisy proti kořenům důvěry, které sestavení nese, a odpoví stavem (VALID, WARN, GRACE, RESTRICT, TERMINATE nebo ABSENT) spolu s uděleními, doplňky a doménovými balíčky. licenceAllows(verdict, featureGroup, action, tenantId?) pak řekne, zda smíte use nebo provision v rámci skupiny. RESTRICT povoluje use a na provision odpovídá LICENCE_LOCKED, takže probíhající práce pokračuje a nic nového nezačne.
Testování
Testy šablony ukazují vzor; toto jsou nástroje za ním.
Napodobeniny rozsahu. Sestavte dvojníka vyhodnoceného rozsahu jednou, v test/scope-fakes.ts, a vkládejte jej všude, včetně chybějících případů: žádná jednotka, žádný token, token s nulovou organizací. Cesty odmítnutí jsou produktem.
Napodobený přenos odesílání. UnoClient přijímá fetch, now a sleep, takže jednotkový test se nikdy nedotkne sítě. Ověřte pole obálky, tvar 202, dotazování až ke koncovému řádku s jeho organization_id a to, že řádek pro jiného tenanta je zahozen.
Skutečný Postgres. Falešná dotazovací funkce prokáže řetězec SQL. Nemůže prokázat, že vynucené zabezpečení na úrovni řádků platí ani že se soubory aplikují ve správném pořadí jako migrátor. testing/ephemeral-postgres spustí dočasný server a provede tentýž nexus-migrate, který běží v produkci:
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 runsMimo CI (průběžnou integraci) stroj bez serveru Postgres přeskočí každý databázový případ jménem i s nápravou, nikdy jako úspěšný. V CI stejná absence způsobí selhání sady (EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI), protože přeskočený test zabezpečení na úrovni řádků je úspěšná brána, která nic nezměřila. Server čeká na spuštění až 180 sekund a hlídací proces jej zastaví, když testovací proces skončí.
Testovací nástroj izolace. runIsolationHarness(target) z testing/isolation-harness načte každou trasu, kterou vaše aplikace připojuje, a zaútočí na každou jako administrátor jiné organizace a jako kolega. Poté zaútočí znovu s odstraněnou ochranou v kódu, s odstraněnou ochranou v databázi a s odstraněnými oběma. Trasa je PROVEN pouze tehdy, když útok selže, je-li na místě kterákoli z ochran, a dosáhne dat oběti, jsou-li odstraněny obě, takže víte, že test únik vůbec dokáže zachytit. Pro každou trasu odešle její deklarovaný dotaz a ukázkové tělo, takže je dosažena i trasa, která odmítá prázdný požadavek. Zafixujte ledgerOf(report) v testu a nechte jej selhat při defectsOf(report).
Registrace: od manifestu k registru dovedností
Dovednosti z vašeho manifestu se do registru dovedností dostanou jedinou cestou:
manifest.skills[] → compileRegistry(manifest) → POST /api/v1/plugins/sync
compileRegistry převede ověřený manifest na tělo nexus.plugin-sync/v1. Šablona to provede při importu, takže neplatný manifest způsobí selhání sestavení:
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" } ]
}Synchronizace je deklarativní: pokaždé odešlete celou sadu dovedností a vynechaná dovednost se zakáže, přičemž její historie zůstane zachována. Je striktní: neznámé pole, pole jiné úrovně nebo null je odmítnuto, všechna porušení se vrátí společně v jednom 400 SYNC_CONTRACT_VIOLATION a dokud nějaké existuje, nic se nezapíše. Pro každou dovednost zapíše jeden řádek registru s klíčem podle typu úlohy v rámci jmenného prostoru, obsahující každý sloupec, který dispečer čte, takže dovednost je spustitelná ve chvíli, kdy synchronizace odpoví 200.
Plugin je ověřený volající, nikdy pole v těle. Synchronizaci volejte z vlastní úlohy vašeho pluginu přes mTLS (vzájemné TLS: Transport Layer Security s certifikátem na obou stranách). Skills Engine přečte klientský certifikát vaší úlohy, jehož identita SPIFFE (spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>) určuje jmenný prostor a servisní účet, a vyhledá plugin a vlastnickou organizaci zaznamenané pro tento jmenný prostor. Hodnota pluginId v těle se musí shodovat; jde o kontrolu, ne o výběr. Každý řádek se zapíše s tímto pluginem a organizací.
| Stav | Kód | Význam |
|---|---|---|
| 200 | {contract, pluginId, version, created, updated, unchanged, disabled, skills} |
|
| 400 | SYNC_CONTRACT_VIOLATION |
Všechna porušení uvedena v violations[]; nic nezapsáno |
| 401 | UNAUTHORIZED |
Chybný nebo chybějící servisní klíč |
| 401 | CALLER_IDENTITY_UNVERIFIED |
Žádná čitelná identita klienta |
| 403 | DELIVERY_IDENTITY_MISSING |
Volající jmenný prostor nepatří žádnému pluginu |
| 403 | PLUGIN_ID_MISMATCH |
Tělo uvádí jiný plugin |
| 409 | REGISTRY_CONFLICT |
Typ úlohy vlastní někdo jiný nebo byl zaregistrován mimo synchronizaci; nic nezapsáno |
Nechte krok nasazení selhat při jakémkoli stavu kromě 200. Žádný jiný stav neznamená, že jsou vaše dovednosti zaregistrovány.
Úvodní nastavení (onboarding)
Onboarding probíhá v deseti seřazených krocích, z nichž každý lze samostatně znovu spustit, zrušit nebo vrátit zpět:
- Naklonujte repozitář a ověřte jej.
- Zpracujte manifest.
- Prověřte jej na bezpečnostní problémy.
- Sestavte image.
- Odešlete jej do registru instalace.
- Nastavte jeho doménová jména.
- Nasaďte jej prostřednictvím kanálů vydání instalace.
- Počkejte na kontrolu stavu.
- Zaregistrujte plugin.
- Informujte vývojáře.
Před nasazením se proti manifestu a sestavenému image spustí pět kontrol shody: manifest lze zpracovat a obsahuje povinná pole; každá deklarovaná trasa je skutečně zaregistrovaná trasa; plugin vlastní své schéma a nezapisuje nic mimo něj; požadavky na prostředky jsou deklarovány a v mezích; a image má funkční obslužnou rutinu kontroly stavu. Plugin, který se registruje sám při spuštění, provádí tentýž kontrakt pod vlastní autoritou, takže se kontroly stávají jeho CI místo CI pipeline. Vynechání některé z nich onboarding nezkrátí; pouze přesune selhání do běhu.
Branding ve vašem manifestu se poskytuje bez ověření podle domény, protože jej přihlašovací stránka potřebuje dříve, než kdokoli získá přihlašovací údaje. Vše v branding považujte za veřejné.
GATE_CANNOT_BE_SKIPPED.Co za vás běhové prostředí neudělá
Běhové prostředí drží hranici v oblasti izolace, dispečinku a přístupu k modelům. Nezajistí správnost vaší produktové logiky a nezrychlí pomalý dotaz: každý příkaz běží uvnitř vázané transakce s časovými limity, které deklaruje blok db vašeho manifestu, a příkaz, který překročí statementTimeoutMs, je zrušen, nikoli očekáván. Dimenzujte své dotazy podle toho. A schvalovací pozdržení, čtecí místo i čtečka licencí přidávají po jedné obousměrné komunikaci nebo transakci. U mého pluginu pro kontrolu anomálií přidávala kontrola licence několik milisekund na požadavek, dokud se nezahřála její 30sekundová paměť, což byla přiměřená cena za to, že se nikdy neposkytne uzamčená funkce.

