Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.22
Mjedisi i ekzekutimit të shtojcës
Modulet e SDK (paketës së zhvillimit të softuerit) mbi të cilat ekzekutohet shtojca juaj, nga mbrojtësi i fushëveprimit dhe gardhi i bazës së të dhënave deri te dërgimi UNO, leximi i rrugës së AI (inteligjencës artificiale) dhe kontrollet e licencës. Më pas, testimi kundrejt një baze të dhënash reale, regjistrimi i aftësive tuaja dhe integrimi fillestar.
Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

Pjesa e ekzekutimit (runtime) e SDK-së (kompleti për zhvillimin e softuerit) është një grup modulesh nën @adverant-nexus/plugin-sdk/runtime/*, si dhe ndihmës testimi nën testing/*. Ju i importoni ato; nuk i rizbatoni. Kjo është e gjithë ideja, dhe m'u desh një rishikim i refuzuar për ta marrë seriozisht: shënimi i rishikuesit për kontrollin e fushëveprimit që kisha shkruar me dorë në plugin-in tim të parë ishte një rresht i vetëm, "SDK-ja e ka tashmë këtë, dhe i juaji pranon një token sfide MFA (autentifikim me shumë faktorë) si sesion".
Ky kapitull ndjek një kërkesë nëpër një plugin në ekzekutim, ashtu siç e lidh shablloni i shërbimit të plotë: rojën e fushëveprimit, gardhin e bazës së të dhënave, kalimin e vetëm të lejuar, dërgimin përmes UNO, leximin e rrugës së AI (inteligjencës artificiale) dhe kontrollet e licencës. Më pas trajton testimin, regjistrimin e aftësive të manifestit tuaj dhe hapat e hyrjes në punë.
Fushëveprimi: një mbrojtës për kornizë
Çdo rrugë /api mbart rojën e fushëveprimit. Ajo verifikon token-in bartës, zbërthen prej tij tri boshtet (qiramarrësi, pronari, njësia), refuzon një trup kërkese që emërton një qiramarrës, zbaton të drejtën e rrugës nga regjistri i manifestit dhe vetëm atëherë e lejon trajtuesin të ekzekutohet. SDK-ja ofron një përshtatës për çdo framework, të gjithë nga @adverant-nexus/plugin-sdk/runtime/scope dhe të gjithë me të njëjtat opsione.
| Framework | Përshtatësi |
|---|---|
| Express | scopeMiddleware |
| Fastify | requireScope, si preHandler |
| Tjetri | withScope, që mbështjell trajtuesin; një trajtuesi Next nuk i tregohet rruga e tij, prandaj withScope e merr atë si argument të tretë |
Ja lidhja Express e shabllonit, e shkurtuar. Verifikuesi është ai i SDK-së dhe e detyron token-in t'i përmbahet formatit të sesionit të shërbimit të identitetit: vetëm HS256; iss, exp, iat dhe jti të detyrueshme; jetëgjatësi jo më shumë se një orë; dhe asnjë token sfide MFA, imitimi apo burimi OAuth (standardi i hapur për autorizimin e deleguar) nuk pranohet si sesion.
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)) });
});Roja e të drejtave zbaton të drejtën e një rruge në katër hapa. Një rol në listën never të së drejtës refuzon me AUTHORITY_EXCEEDED dhe fjalët barred, dhe asnjë vend nuk e heq këtë. Një rol në roles pranon, edhe me një vend aktiv kur e drejta thotë seat: true. Përndryshe, një vend aktiv që mbart të drejtën pranon. Përndryshe, kërkesa refuzohet AUTHORITY_EXCEEDED, duke emërtuar personat që mund të japin një vend. Nëse i jepni rojës një depo (rights: { manifest, store: { pool, schema } }), ajo lexon vendet nën fushëveprimin e vetë thirrësit; një e drejtë që emërton një licence ka nevojë edhe për një lexues licence, që trajtohet më poshtë.
Brenda një trajtuesi, scopeOf(req) është mënyra e vetme për të lexuar fushëveprimin e zbërthyer, dhe ai hedh gabim nëse roja nuk është ekzekutuar. Një roje e regjistruar mbi një prefiks, që ekzekutohet para se të përputhet ndonjë rrugë, përgjigjet 500 MIDDLEWARE_ORDERING_ERROR; një rrugë që kodi juaj regjistron, por që manifesti nuk e deklaron, përgjigjet 500 UNHANDLED_ERROR. Të dyja dështojnë në mënyrë të mbyllur.
Rrugët /internal të shabllonit, të cilat i thërret platforma, përdorin regjimin tjetër. Roja e shërbimit kontrollon X-Service-Key në kohë konstante dhe merr qiramarrësin nga X-Organization-ID e platformës, duke refuzuar MISSING_SERVICE_KEY, INVALID_SERVICE_KEY ose MISSING_ORG_ID_HEADER. Për token-in e nënshkruar për çdo thirrje të platformës, SDK-ja ka requireService (Fastify) dhe serviceMiddleware (Express), të cilat kontrollojnë gjithashtu për cilën aftësi dhe rrugë u krijua token-i dhe refuzojnë një token të përdorur dy herë.
Gardhi i bazës së të dhënave: tenantFence dhe withScopedTx
Çdo deklaratë ndaj një tabele me fushëveprim e kompozon gardhin dhe ekzekutohet brenda një transaksioni me fushëveprim:
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) ndërton kallëzuesin dhe parametrat e tij nga një fushëveprim i zbërthyer. Kaloni owner për tabelat personale; lëreni jashtë për artefaktet e organizatës, ku pronari tregon prejardhjen. Kur deklarata ka tashmë parametra, startIndex i tregon gardhit nga ku të fillojë numërimin. Një futje nuk i merr kurrë boshtet si hyrje: ajo shkruan scope.tenant, scope.owner dhe scope.unit nga fushëveprimi.
withScopedTx lidh të tri boshtet për një transaksion përmes funksionit të vetëm të lidhjes së skemës, dhe më pas ekzekuton callback-un tuaj. Një lidhje e dytë në të njëjtin transaksion ngre SCOPE_ALREADY_BOUND (500: kodi juaj lidhi dy herë; thirrësi nuk bëri asgjë gabim). Një qiramarrës ose pronar që mungon ose është zero ngre SCOPE_PREDICATE_INVALID (403). Cilësimi është lokal për transaksionin, kështu që një lidhje nga grupi (pool) nuk mund ta bartë një qiramarrës në kërkesën tjetër.
Dy funksione motra mbulojnë rastet që nuk janë kërkesa e një personi. withTenantScopedTx lidh qiramarrësin dhe njësinë pa pronar, për rreshtat që lexon një makinë (regjistri i pajisjeve), dhe refuzon një fushëveprim që mbart pronar. maintenanceScope(reason) e detyron një operacion mbarë organizatën të deklarojë hapur se çfarë është para se të hapet transaksioni i pronarit. Gardhi i kodit dhe siguria e detyruar në nivel rreshti janë dy mekanizma për një ligj të vetëm; kontrolli i nisjes refuzon të dëgjojë derisa baza e të dhënave të provojë se i dyti vlen (DB_ROLE_BYPASSES_ISOLATION në të kundërt).
Çdo refuzim është një rresht
Shablloni instalon edhe një pjesë tjetër middleware, një herë, midis analizuesit të trupit dhe ruterave: regjistrin e refuzimeve.
import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";
app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));Ai mbështjell përgjigjen në mënyrë që çdo refuzim që lexon një person, qoftë nga roja e të drejtave, një trajtues apo një depo, të shkruhet në tabelën refusal të skemës suaj brenda transaksionit me fushëveprim të vetë atij personi, para se të dërgohet trupi. Një 401 anonim nuk shkruan asgjë. Nëse rreshti nuk mund të shkruhet, përgjigjja bëhet UNHANDLED_ERROR: një "jo" që produkti nuk mund ta regjistrojë nuk dërgohet sikur të ishte regjistruar. Nisja ekzekuton assertRefusalLedger për të kontrolluar që tabela mund ta pranojë rreshtin e regjistrit, dhe një depo mund të thërrasë noteSubject({ recordId, isDemo }) që çdo refuzim të emërtojë regjistrimin për të cilin ishte. Kur një klient pyet pse dikush u refuzua të martën e kaluar, përgjigjja është një pyetje në bazën e të dhënave, jo një hamendësim.
Kalimi i vetëm: një leje e regjistruar vetëm për lexim
Kur një nga klientët tuaj kryen punë për një tjetër dhe ky i fundit mund ta inspektojë atë, ekziston një mënyrë e vetme e miratuar për të kaluar kufirin. Organizata që mban rreshtat regjistron një dhënie leje. Organizata e lexuesit pranon një person përmes një vendi që mbart të drejtën granted.read, e cila duhet të emërtojë owner dhe admin në never. Leximi ekzekutohet si një rol i gjashtë i bazës së të dhënave, vendi i leximit, i cili mund të zgjedhë vetëm tabelat që liston 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 shkruan fillimisht shikimin në qiramarrësin e vetë lexuesit, pastaj lidh vendin e leximit me lejen, gjë që shkruan shikimin në qiramarrësin e mbajtësit. Politika e vetë bazës së të dhënave kontrollon që leja emërton organizatën e lexuesit, mbulon tabelën, ka filluar, nuk ka përfunduar dhe nuk është tërhequr, si dhe që ky transaksion e ka shkruar shikimin e tij. Një lexim që e anashkalon shikimin nuk sheh asgjë. Gjatë nisjes, assertSeatAtBoot(seatPool, schema) kontrollon që grupi i lidhjeve i hapur nga seat.url është vërtet vendi dhe asgjë më shumë, dhe në të kundërt refuzon me DB_SEAT_ROLE_INVALID.
Dërgimi përmes UNO
E gjithë llogaritja kalon përmes një klienti të vetëm, të ndërtuar në një skedar të vetëm, me një listë të mbyllur lejimesh:
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,
});
}Lista e lejimeve është qëllimisht një konstante në nivel moduli. Nëse një operator mund ta zgjeronte nga konfigurimi, rruga do të bëhej një ndërmjetës dërgimi për të gjithë regjistrin. Testi i vetë shabllonit pohon që lista emërton saktësisht llojet e punëve në të cilat kompilohet manifesti.
Zarfi
Një dërgim mbart gjashtë fusha në thelbin e tij të detyrueshëm. Klienti e plotëson qiramarrësin dhe aktorin nga fushëveprimi i verifikuar, kurrë nga kërkesa:
| Fusha | Çfarë mban |
|---|---|
jobType |
Lloji i punës me hapësirë emrash, <plugin name>.<skill id> |
organizationId |
Qiramarrësi, nga fushëveprimi |
userId |
Aktori, nga fushëveprimi, për auditim dhe faturim |
inputParams |
Hyrja e aftësisë. Ajo nuk mbart kurrë një id qiramarrësi; ajo që e mbart refuzohet gjatë dërgimit |
priority |
critical, high, normal ose low |
pluginId |
name e manifestit tuaj. Çdo dërgim deklaron plugin-in nga i cili buron |
Fushat opsionale përfshijnë correlationId (një UUID (identifikues unik universal), ose krijohet një i ri) dhe callbackUrl, të cilën e ka nevojë një aftësi plugin_queue që punëtori të dijë ku ta postojë rezultatin.
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, pastaj kontrolli periodik
Çdo dërgim vendoset në radhë. Përgjigjja është gjithmonë 202 me identifikues (jobId, runId, traceId, status), kurrë një rezultat. Rezultati vjen nga kontrolli periodik i punës ose nga callback-u juaj. uno.peek(jobId, { scope }) e lexon atë një herë dhe awaitJob kontrollon periodikisht deri në një status përfundimtar; të dyja dërgojnë qiramarrësin nga fushëveprimi i verifikuar, dhe të dyja kontrollojnë organization_id e rreshtit të kthyer ndaj qiramarrësit të thirrësit në anën tuaj të thirrjes së rrjetit, duke refuzuar një mospërputhje me SCOPE_REFUSED.
Lexojeni rreshtin e ekzekutimit me drejtshkrimin e tij. Përgjigjja e dërgimit thotë jobId; rreshti thotë job_id, organization_id dhe plugin_id. Kolonat e rezultatit dhe të dështimit janë result, error, error_code dhe error_troubleshooting. completed dhe failed janë përfundimtare. timed_out, cancelled dhe system_failure vijnë nga pastruesi (reaper) dhe një rezultat i vonuar mund t'i korrigjojë ende. Një klient që cilindo prej tyre e trajton si të paanalizueshëm refuzon rreshta që platforma i shkruan çdo ditë.
Mbajtja për miratim
Një aftësi manifesti që deklaron approval mbahet gjatë dërgimit. 202 thotë atëherë status: "awaiting_approval" dhe mbart një waitpointId, me arsyen që dha manifesti. Ekzekutimi mbetet i mbajtur derisa një person i emërtuar të vendosë për të. uno.approve dhe uno.resolveWaitpoint dërgojnë qiramarrësin dhe thirrësin si aktor, dhe një vendim nga dikush tjetër përveç thirrësit të verifikuar refuzohet. Një miratim e liron punën një herë dhe i ekzekuton sërish kontrollet e dërgimit; një refuzim e përfundon atë failed. Një vendim i dytë refuzohet, po ashtu edhe një vendim pasi mbajtja ka skaduar. Nëse produkti juaj kërkon që miratuesi të jetë person tjetër nga propozuesi, zbatojeni këtë në rrugën që vendos: platforma i regjistron të dy.
Shfaqeni një punë të mbajtur si të mbajtur. Mos i thoni një personi se klikimi i tij e liroi atë derisa rreshti i ekzekutimit ta thotë këtë.
AI: dëshirat në rreshtin e aftësisë dhe një lexim
Plugin-i juaj nuk thërret kurrë një model. Kur një aftësi manifesti ka nevojë për një të tillë (llm_only ose tool_using, me besueshmëri core ose verified), ju shprehni preferenca në rreshtin e saj të regjistrit, dhe ruteri vendos nga grupi i vetë organizatës:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
}
}preferredProvider dhe preferredModel janë dëshira që ruteri i respekton vetëm kur organizata e ka atë ofrues të aktivizuar dhe me kredenciale. capabilityProfile filtron dhe nuk zgjedh kurrë; dataResidency e tij (eu_only, us_only ose any) është një kufizim i prerë që ruteri ose e plotëson ose refuzon. Lënia jashtë e të gjithave zakonisht është zgjedhja e duhur. modelOverride ekziston për aftësinë e rrallë që ka nevojë për një model të saktë, dhe i bën joaktive dëshirat pranë tij; unë do ta shmangja, përveç nëse aftësia nuk ka kuptim me asnjë model tjetër.
Kur ndërfaqja juaj duhet të tregojë cilin model do të përdorte ruteri, lexojeni, mos e parashikoni:
import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";createAIRouteClient(...).effectiveRoute() është leximi i vetëm i miratuar i AI Provider Router. Ai merr adresën e portës, bartësin e vetë thirrësit dhe slug-un e platformës suaj, dhe nuk dërgon asnjë kërkesë AI. Ai përgjigjet me ofruesin dhe modelin, ofruesit që lejon politika, dhe nëse pika fundore e zgjedhur ekzekuton local apo external. Kur rruga nuk është e përdorshme, ai përgjigjet me refuzimin e ruterit me fjalë (NO_PROVIDER_FOR_ROLE, MODEL_CAPABILITY_UNAVAILABLE ose NO_MODEL_FOR_ROLE_AND_PROVIDER, me masën korrigjuese), kurrë me një model të paracaktuar. Tregojani personit atë refuzim; është konfigurimi i organizatës së tij që flet.
Kontrollet e licencës
Tre mekanizma kontrollojnë licencimin, në tre nivele hollësie.
Një e drejtë që emërton një licencë. Më i thjeshti. Në manifest, një e drejtë mbart licence: "<feature>", dhe roja pyet shërbimin e identitetit nëse licenca e organizatës e mbart atë, me token-in e vetë thirrësit, para se të lexohet ndonjë rol. Ndërtojeni rojën me një lexues:
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 }) },
});Një licencë që nuk e mbart veçorinë i refuzon të gjithë me LICENCE_LOCKED, duke emërtuar se çfarë e mbart atë dhe duke thënë se pronarët dhe administratorët e organizatës mund ta aktivizojnë. Një licencë që nuk mund të lexohet refuzon UNHANDLED_ERROR: një veçori e kyçur nuk ofrohet kurrë sepse licenca ishte e paarritshme. Përgjigjet mbahen mend për 30 sekonda për çdo organizatë dhe veçori.
Porta e produktit. createProductGate({ baseUrl, product }) nga runtime/product-gate pyet kontrollin e të drejtave nëse organizata e thirrësit e zotëron fare produktin tuaj, dhe middleware() e saj ekzekutohet pas rojës së fushëveprimit. Një verdikt negativ është ENTITLEMENT_DENIED; një kontroll që nuk mund të arrihet është ENTITLEMENT_UNREACHABLE, dhe porta nuk e trajton kurrë njërin si tjetrin.
Vetë dokumenti i licencës. Kodi që duhet të vendosë vetë nga licenca e nënshkruar, si moduli i mbyllur i një pakete domeni, përdor verifyLicenceDocument(docText, opts) nga runtime/licence-document. Është një funksion i pastër: pa thirrje rrjeti, pa variabël mjedisi, pa skedar. Ai kontrollon të dyja nënshkrimet ndaj rrënjëve të besimit që mbart build-i dhe përgjigjet me një gjendje (VALID, WARN, GRACE, RESTRICT, TERMINATE ose ABSENT) me lejet, shtojcat dhe paketat e domenit. Më pas licenceAllows(verdict, featureGroup, action, tenantId?) tregon nëse mund të use ose provision nën një grup. RESTRICT lejon use dhe përgjigjet provision me LICENCE_LOCKED, kështu që puna në ekzekutim vazhdon dhe asgjë e re nuk fillon.
Testimi
Testet e shabllonit tregojnë modelin; këto janë mjetet që qëndrojnë pas tij.
Imitime të fushëveprimit. Ndërtojeni imitimin e fushëveprimit të zbërthyer një herë, në test/scope-fakes.ts, dhe injektojeni kudo, përfshirë rastet e mungesës: pa njësi, pa token, një token me organizatë zero. Shtigjet e refuzimit janë vetë produkti.
Një transport dërgimi imitues. UnoClient merr fetch, now dhe sleep, kështu që një test njësie nuk prek kurrë rrjetin. Pohoni fushat e zarfit, formën e 202, kontrollin periodik deri te një rresht përfundimtar me organization_id e tij, dhe që një rresht për një qiramarrës tjetër hidhet poshtë.
Një Postgres i vërtetë. Një funksion i rremë pyetjeje vërteton një varg SQL. Ai nuk mund të vërtetojë që siguria e detyruar në nivel rreshti mban, as që skedarët zbatohen me radhë si migratori. testing/ephemeral-postgres nis një server të përkohshëm dhe ekzekuton të njëjtin nexus-migrate që ekzekuton prodhimi:
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 runsJashtë CI (integrimit të vazhdueshëm), një makinë pa server Postgres e anashkalon çdo rast databaze me emër, bashkë me zgjidhjen, kurrë si të gjelbër. Në CI e njëjta mungesë e rrëzon suitën (EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI), sepse një test i anashkaluar i sigurisë në nivel rreshti është një portë e gjelbër që nuk ka matur asgjë. Serveri pret deri në 180 sekonda për t'u nisur, dhe një mbikëqyrës e ndalon kur procesi i testit largohet.
Mjedisi i testimit të izolimit. runIsolationHarness(target) nga testing/isolation-harness lexon çdo rrugë që montohet nga aplikacioni juaj dhe sulmon secilën si administrator i një organizate tjetër dhe si koleg. Pastaj sulmon përsëri me gardhin e kodit të hequr, me gardhin e databazës të hequr, dhe me të dy të hequr. Një rrugë është PROVEN vetëm kur sulmi dështon me secilin gardh në vend dhe arrin te të dhënat e viktimës me të dy të hequr, kështu që e dini se testi mund ta shohë fare një rrjedhje. Ai dërgon pyetjen e deklaruar dhe trupin shembull të çdo rruge, kështu që edhe një rrugë që refuzon një kërkesë bosh arrihet. Fiksoni ledgerOf(report) në një test dhe dështoni me defectsOf(report).
Regjistrimi: nga manifesti te regjistri i aftësive
Aftësitë e manifestit tuaj arrijnë në regjistrin e aftësive përmes një rruge të vetme:
manifest.skills[] → compileRegistry(manifest) → POST /api/v1/plugins/sync
compileRegistry e kthen një manifest të validuar në trupin nexus.plugin-sync/v1. Shablloni e bën këtë gjatë importit, kështu që një manifest i pavlefshëm e rrëzon ndërtimin:
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" } ]
}Sinkronizimi është deklarativ: dërgoni çdo herë të gjithë grupin e aftësive, dhe një aftësi e lënë jashtë çaktivizohet, me historikun e saj të ruajtur. Është i rreptë: një fushë e panjohur, një fushë e një niveli tjetër ose një null refuzohet, të gjitha shkeljet kthehen së bashku në një 400 SYNC_CONTRACT_VIOLATION, dhe asgjë nuk shkruhet ndërsa ka qoftë edhe një. Dhe shkruan një rresht regjistri për çdo aftësi, me çelës llojin e punës me hapësirë emrash, që mbart çdo kolonë që lexon shpërndarësi, kështu që aftësia është e ekzekutueshme në çastin që sinkronizimi përgjigjet 200.
Shtojca është thirrësi i autentikuar, kurrë një fushë e trupit. Thirreni sinkronizimin nga ngarkesa e punës e vetë shtojcës suaj përmes mTLS (TLS reciprok: Transport Layer Security me një certifikatë në të dy skajet). Skills Engine lexon certifikatën e klientit të ngarkesës suaj të punës, identiteti SPIFFE i së cilës (spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>) emërton hapësirën e emrave dhe llogarinë e shërbimit, dhe kërkon shtojcën dhe organizatën pronare të regjistruara për atë hapësirë emrash. pluginId i trupit duhet të përputhet; është një kontroll, jo një përzgjedhës. Çdo rresht shkruhet me atë shtojcë dhe organizatë.
| Statusi | Kodi | Kuptimi |
|---|---|---|
| 200 | {contract, pluginId, version, created, updated, unchanged, disabled, skills} |
|
| 400 | SYNC_CONTRACT_VIOLATION |
Çdo shkelje e listuar në violations[]; asgjë nuk shkruhet |
| 401 | UNAUTHORIZED |
Çelës shërbimi i gabuar ose që mungon |
| 401 | CALLER_IDENTITY_UNVERIFIED |
Asnjë identitet klienti i lexueshëm |
| 403 | DELIVERY_IDENTITY_MISSING |
Hapësira e emrave thirrëse nuk i përket asnjë shtojce |
| 403 | PLUGIN_ID_MISMATCH |
Trupi emërton një shtojcë tjetër |
| 409 | REGISTRY_CONFLICT |
Një lloj pune zotërohet diku tjetër ose është regjistruar jashtë sinkronizimit; asgjë nuk shkruhet |
Rrëzojeni hapin tuaj të vendosjes për çdo status përveç 200. Asnjë status tjetër nuk do të thotë se aftësitë tuaja janë regjistruar.
Integrimi fillestar
Futja në punë kryhet në dhjetë hapa të renditur, secili prej të cilëve mund të riekzekutohet, anulohet ose kthehet mbrapsht më vete:
- Klononi repozitorin dhe validojeni.
- Analizoni manifestin.
- Skanojeni për probleme sigurie.
- Ndërtoni imazhin.
- Shtyjeni në regjistrin e instalimit.
- Konfiguroni emrat e tij të domenit.
- Vendoseni, përmes kanaleve të publikimit të instalimit.
- Prisni kontrollin e shëndetit.
- Regjistroni shtojcën.
- Njoftoni zhvilluesin.
Para vendosjes, pesë kontrolle përputhshmërie ekzekutohen ndaj manifestit dhe imazhit të ndërtuar: manifesti analizohet dhe mbart fushat e tij të detyrueshme; çdo rrugë e deklaruar është një rrugë reale e regjistruar; shtojca zotëron skemën e saj dhe nuk shkruan asgjë jashtë saj; kërkesat për burime janë deklaruar dhe brenda kufijve; dhe imazhi ka një trajtues shëndeti që funksionon. Një shtojcë që regjistrohet vetë gjatë nisjes ekzekuton të njëjtën kontratë nën autoritetin e vet, kështu që kontrollet bëhen CI e saj në vend të asaj të linjës. Anashkalimi i njërit nuk e shkurton futjen në punë; e zhvendos dështimin në kohën e ekzekutimit.
Markimi në manifestin tuaj shërbehet pa autentikim sipas domenit, sepse faqja e hyrjes ka nevojë për të përpara se dikush të ketë kredenciale. Trajtojeni gjithçka në branding si publike.
GATE_CANNOT_BE_SKIPPED.Çfarë nuk do të bëjë mjedisi i ekzekutimit për ju
Mjedisi i ekzekutimit e mban vijën për izolimin, shpërndarjen dhe aksesin te modelet. Ai nuk do ta bëjë logjikën e produktit tuaj të saktë, dhe nuk do ta bëjë të shpejtë një pyetje të ngadaltë: çdo deklaratë ekzekutohet brenda një transaksioni të kufizuar me afatet kohore që deklaron blloku db i manifestit tuaj, dhe një deklaratë që e tejkalon statementTimeoutMs anulohet, nuk pritet. Përmasojini pyetjet tuaja për këtë. Dhe pezullimi për miratim, vendi i leximit dhe lexuesi i licencës shtojnë secili një vajtje-ardhje ose një transaksion. Në shtojcën time të shqyrtimit të anomalive, kontrolli i licencës shtonte disa milisekonda për kërkesë derisa memoria e tij 30-sekondëshe u ngroh, që ishte një çmim i drejtë për të mos shërbyer kurrë një veçori të kyçur.

