Različica 1.0.0-alpha.1najnovejša
Poglavje 2.22
Izvajalno okolje vtičnika
Moduli SDK (komplet za razvoj programske opreme), na katerih teče vaš vtičnik, od varovala obsega in ograje podatkovne zbirke do razporejanja UNO, branja usmeritve UI (umetne inteligence) ter preverjanja licenc. Sledijo preizkušanje na dejanski podatkovni zbirki, registracija vaših veščin in uvajanje.
To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

Izvajalni del SDK (kompleta za razvoj programske opreme) je nabor modulov pod @adverant-nexus/plugin-sdk/runtime/* ter pomožnih orodij za testiranje pod testing/*. Uvozite jih; ne implementirajte jih znova. To je celotno bistvo, in potreboval sem en zavrnjen pregled, da sem to vzel resno: opomba pregledovalca pri ročno napisanem preverjanju obsega v mojem prvem vtičniku je obsegala eno samo vrstico: »SDK to že ima, vaš pa sprejme izzivalni žeton MFA (večfaktorske avtentikacije) kot sejo«.
To poglavje sledi zahtevi skozi delujoč vtičnik, tako kot jo poveže predloga polne storitve: varovalo obsega, podatkovna ograja, edini dovoljeni prehod, razpošiljanje prek UNO, branje poti UI (umetne inteligence) in preverjanja licenc. Nato obravnava testiranje, registracijo veščin iz vašega manifesta ter korake uvajanja.
Obseg: eno varovalo na ogrodje
Vsaka pot /api nosi varovalo obsega. To preveri prinosniški žeton, iz njega razreši tri osi (najemnik, lastnik, enota), zavrne telo zahteve, ki imenuje najemnika, uveljavi pravico poti iz registra manifesta in šele nato dovoli zagon obravnavalnika. SDK vključuje po en vmesnik za vsako ogrodje, vsi so iz @adverant-nexus/plugin-sdk/runtime/scope in vsi sprejemajo enake možnosti.
| Ogrodje | Vmesnik |
|---|---|
| Express | scopeMiddleware |
| Fastify | requireScope, kot preHandler |
| Naslednje | withScope, ki ovija obravnavalnik; obravnavalniku Next pot ni sporočena, zato jo withScope sprejme kot tretji argument |
Tukaj je skrajšana povezava za Express iz predloge. Preverjevalnik pripada SDK-ju in od žetona zahteva format seje storitve identitete: samo HS256; obvezni so iss, exp, iat in jti; življenjska doba največ eno uro; kot seja pa ni dovoljen noben izzivalni žeton MFA, žeton za prevzem identitete ali žeton vira OAuth (odprti standard za delegirano avtorizacijo).
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)) });
});Varovalo pravic uveljavi pravico poti v štirih korakih. Vloga na seznamu never pravice zavrne zahtevo s AUTHORITY_EXCEEDED in besedami barred, česar noben sedež ne more razveljaviti. Vloga v roles dovoli dostop, skupaj z aktivnim sedežem, ko pravica določa seat: true. Sicer dostop dovoli aktiven sedež, ki nosi ustrezno pravico. V nasprotnem primeru je zahteva zavrnjena s AUTHORITY_EXCEEDED, pri čemer so navedene osebe, ki bi lahko dodelile sedež. Če varovalu dodelite shrambo (rights: { manifest, store: { pool, schema } }), bo bralo sedeže znotraj klicateljevega lastnega obsega; pravica, ki imenuje licence, potrebuje tudi bralnik licenc, kar je opisano spodaj.
Znotraj obravnavalnika je scopeOf(req) edini način za branje razrešenega obsega in sproži izjemo, če se varovalo ni izvedlo. Varovalo, registrirano na predponi, ki se izvede, preden se ujema katera koli pot, odgovori s 500 MIDDLEWARE_ORDERING_ERROR; pot, ki jo vaša koda registrira, manifest pa je ne deklarira, odgovori s 500 UNHANDLED_ERROR. V obeh primerih se ob napaki dostop varno zapre.
Poti /internal v predlogi, ki jih kliče platforma, uporabljajo drugi režim. Storitveno varovalo preveri X-Service-Key v konstantnem času in prevzame najemnika iz X-Organization-ID platforme, pri čemer zavrne MISSING_SERVICE_KEY, INVALID_SERVICE_KEY ali MISSING_ORG_ID_HEADER. Za podpisan žeton platforme za posamezen klic ima SDK requireService (Fastify) in serviceMiddleware (Express), ki prav tako preverita, za katero veščino in pot je bil žeton izdan, ter zavrneta žeton, ki je uporabljen dvakrat.
Podatkovna ograja: tenantFence in withScopedTx
Vsak stavek nad tabelo z omejenim obsegom sestavi ograjo in se izvede znotraj transakcije z omejenim obsegom:
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) zgradi predikat in njegove parametre iz razrešenega obsega. Podajte owner za osebne tabele; izpustite ga pri organizacijskih artefaktih, kjer lastnik predstavlja izvor. Ko stavek že ima parametre, startIndex ograji pove, od kje naj začne številčiti. Vstavljanje nikoli ne sprejme osi kot vhodnih podatkov: scope.tenant, scope.owner in scope.unit zapiše iz obsega.
withScopedTx poveže vse tri osi za eno transakcijo prek edine povezovalne funkcije sheme in nato zažene vaš povratni klic. Druga povezava v isti transakciji sproži SCOPE_ALREADY_BOUND (500: vaša koda je povezala dvakrat; klicatelj ni storil ničesar narobe). Manjkajoči ali ničelni najemnik oziroma lastnik sproži SCOPE_PREDICATE_INVALID (403). Nastavitev je lokalna za transakcijo, zato povezava iz bazena ne more prenesti enega najemnika v naslednjo zahtevo.
Sorodni funkciji pokrivata primera, ko ne gre za zahtevo osebe. withTenantScopedTx poveže najemnika in enoto brez lastnika za vrstice, ki jih bere stroj (register naprav), in zavrne obseg, ki vključuje lastnika. maintenanceScope(reason) zahteva, da operacija na ravni celotne organizacije to izrecno navede, preden se transakcija lastnika sploh odpre. Kodna ograja in vsiljena varnost na ravni vrstic sta dva mehanizma za eno pravilo; zagonsko preverjanje zavrne poslušanje, dokler podatkovna baza ne dokaže, da drugi mehanizem drži (sicer vrne DB_ROLE_BYPASSES_ISOLATION).
Vsaka zavrnitev je zapisana vrstica
Predloga namesti še en kos vmesne programske opreme, enkrat, med razčlenjevalnik telesa in usmerjevalnike: dnevnik zavrnitev.
import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";
app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));Ta ovije odgovor tako, da se vsaka zavrnitev, ki jo oseba prebere – bodisi od varovala pravic, obravnavalnika ali shrambe –, zapiše v tabelo refusal vaše sheme znotraj lastne transakcije z omejenim obsegom te osebe, preden je telo poslano. Anonimni 401 ne zapiše ničesar. Če vrstice ni mogoče zapisati, odgovor postane UNHANDLED_ERROR: »ne«, ki ga produkt ne more zabeležiti, se ne pošlje, kot da bi bil zabeležen. Ob zagonu se izvede assertRefusalLedger, ki preveri, ali tabela lahko sprejme vrstico dnevnika, shramba pa lahko pokliče noteSubject({ recordId, isDemo }), tako da vsaka zavrnitev imenuje zapis, na katerega se je nanašala. Ko stranka vpraša, zakaj je bil nekdo prejšnji torek zavrnjen, je odgovor poizvedba, ne ugibanje.
Edini prehod: zabeležena odobritev samo za branje
Ko ena od vaših strank opravlja delo za drugo in ga ta druga sme pregledati, obstaja en odobren način za prehod meje. Organizacija, ki je lastnica vrstic, zabeleži odobritev. Bralčeva organizacija osebi dovoli dostop prek sedeža s pravico granted.read, ki mora v never imenovati owner in admin. Branje se izvede kot šesta vloga podatkovne baze, bralni sedež, ki lahko izbira samo tabele, navedene 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 najprej zapiše vpogled pri bralčevem lastnem najemniku, nato pa poveže bralni sedež z odobritvijo, kar zapiše vpogled pri najemniku imetnika. Lastni pravilnik podatkovne baze preveri, ali odobritev imenuje bralčevo organizacijo, pokriva tabelo, se je začela, se še ni končala in ni bila umaknjena ter ali je ta transakcija zapisala svoj vpogled. Branje, ki preskoči zapis vpogleda, ne vidi ničesar. Ob zagonu assertSeatAtBoot(seatPool, schema) preveri, ali je bazen, odprt iz seat.url, resnično ta sedež in nič več, sicer pa zavrne zagon s DB_SEAT_ROLE_INVALID.
Razporejanje prek sistema UNO
Vsa računska obdelava poteka prek enega odjemalca, zgrajenega v eni datoteki, z zaprtim seznamom dovoljenih elementov:
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 dovoljenih elementov je namenoma konstanta na ravni modula. Če bi ga upravljavec lahko razširil v konfiguraciji, bi pot postala posrednik za razpošiljanje za celoten register. Lastni test predloge preverja, ali seznam imenuje natanko tiste vrste opravil, v katere se prevede manifest.
Ovojnica
Razpošiljanje v svojem obveznem jedru nosi šest polj. Odjemalec izpolni najemnika in akterja iz preverjenega obsega, nikoli iz zahteve:
| Polje | Kaj vsebuje |
|---|---|
jobType |
Vrsta opravila z imenskim prostorom, <plugin name>.<skill id> |
organizationId |
Najemnik, iz obsega |
userId |
Akter, iz obsega, za revizijo in obračunavanje |
inputParams |
Vhodni podatki veščine. Nikoli ne vsebujejo identifikatorja najemnika; če ga, so ob razpošiljanju zavrnjeni |
priority |
critical, high, normal ali low |
pluginId |
Vaš name iz manifesta. Vsako razpošiljanje deklarira svoj izvorni vtičnik |
Izbirna polja vključujejo correlationId (UUID (univerzalno edinstven identifikator), sicer se ustvari nov) in callbackUrl, ki ga veščina plugin_queue potrebuje, da delavec ve, kam naj pošlje svoj rezultat.
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, nato povpraševanje
Vsako razpošiljanje je uvrščeno v čakalno vrsto. Odgovor je vedno 202 z identifikatorji (jobId, runId, traceId, status), nikoli rezultat. Rezultat dobite s povpraševanjem po opravilu ali prek povratnega klica. uno.peek(jobId, { scope }) ga prebere enkrat, awaitJob pa povprašuje do končnega stanja; oba pošljeta najemnika iz preverjenega obsega in oba preverita organization_id vrnjene vrstice glede na klicateljevega najemnika na vaši strani omrežnega klica ter ob neujemanju zavrneta s SCOPE_REFUSED.
Vrstico izvajanja berite v njenem lastnem zapisu. Odgovor na razpošiljanje pravi jobId; vrstica pravi job_id, organization_id in plugin_id. Stolpci za rezultat in napako so result, error, error_code in error_troubleshooting. completed in failed sta končni stanji. timed_out, cancelled in system_failure prihajajo od čistilnika, vendar jih pozen rezultat še vedno lahko popravi. Odjemalec, ki katerega koli od teh obravnava kot nerazčlenljivega, zavrača vrstice, ki jih platforma zapisuje vsak dan.
Zadržanje za odobritev
Veščina v manifestu, ki deklarira approval, je ob razpošiljanju zadržana. 202 takrat pravi status: "awaiting_approval" in nosi waitpointId z razlogom, ki ga je navedel manifest. Izvajanje ostane zadržano, dokler imenovana oseba o njem ne odloči. uno.approve in uno.resolveWaitpoint pošljeta najemnika in klicatelja kot akterja, odločitev kogar koli drugega kot preverjenega klicatelja pa je zavrnjena. Odobritev enkrat sprosti opravilo in znova zažene preverjanja ob razpošiljanju; zavrnitev ga konča kot failed. Druga odločitev je zavrnjena, prav tako odločitev po poteku zadržanja. Če vaš produkt zahteva, da je odobritelj druga oseba kot predlagatelj, to uveljavite na poti, ki sprejme odločitev: platforma zabeleži oba.
Zadržano opravilo prikažite kot zadržano. Osebi ne sporočite, da ga je njen klik sprostil, dokler tega ne pove vrstica izvajanja.
UI: želje v vrstici veščine in eno branje
Vaš vtičnik nikoli ne kliče modela. Ko ga veščina iz manifesta potrebuje (llm_only ali tool_using, na ravni zaupanja core ali verified), izrazite želene nastavitve v njeni vrstici v registru, usmerjevalnik pa se odloči iz lastnega bazena organizacije:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
}
}preferredProvider in preferredModel sta želji, ki ju usmerjevalnik upošteva le, če ima organizacija tega ponudnika omogočenega in opremljenega s poverilnicami. capabilityProfile filtrira in nikoli ne izbira; njegov dataResidency (eu_only, us_only ali any) je stroga omejitev, ki jo usmerjevalnik izpolni ali pa zahtevo zavrne. Običajno je najbolje izpustiti vse. modelOverride obstaja za redke veščine, ki potrebujejo en točno določen model, zaradi česar postanejo želje poleg njega neaktivne; sam bi se mu izognil, razen če je veščina na katerem koli drugem modelu nesmiselna.
Ko mora vaš vmesnik prikazati, kateri model bi usmerjevalnik uporabil, to preberite, ne napovedujte:
import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";createAIRouteClient(...).effectiveRoute() je edino odobreno branje usmerjevalnika ponudnikov UI. Sprejme naslov prehoda, klicateljev lastni prinosniški žeton in okrajšavo vaše platforme ter ne pošlje nobene zahteve UI. Odgovori s ponudnikom in modelom, ponudniki, ki jih dovoljuje pravilnik, ter podatkom, ali izbrana končna točka teče kot local ali external. Ko pot ni uporabna, odgovori z zavrnitvijo usmerjevalnika v besedah (NO_PROVIDER_FOR_ROLE, MODEL_CAPABILITY_UNAVAILABLE ali NO_MODEL_FOR_ROLE_AND_PROVIDER, skupaj z ukrepom za odpravo), nikoli s privzetim modelom. To zavrnitev prikažite osebi; to govori konfiguracija njene organizacije.
Preverjanje licenc
Trije mehanizmi preverjajo licenciranje, na treh ravneh podrobnosti.
Pravica, ki imenuje licenco. Najpreprostejši način. V manifestu pravica nosi licence: "<feature>", varovalo pa s klicateljevim lastnim žetonom vpraša storitev identitete, ali licenca organizacije to vključuje, še preden se prebere katera koli vloga. Zgradite varovalo z bralnikom:
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 }) },
});Licenca, ki ne vključuje zmožnosti, zavrne vsakogar s LICENCE_LOCKED, pri čemer navede, kaj jo vključuje, in pove, da jo lastniki ter skrbniki organizacije lahko vklopijo. Licenca, ki je ni mogoče prebrati, zavrne s UNHANDLED_ERROR: zaklenjena zmožnost ni nikoli postrežena zato, ker licenca ni bila dosegljiva. Odgovori se shranijo v pomnilnik za 30 sekund na organizacijo in zmožnost.
Produktna vrata. createProductGate({ baseUrl, product }) iz runtime/product-gate pri preverjanju upravičenosti preveri, ali ima klicateljeva organizacija sploh vaš produkt, njegov middleware() pa se izvede za varovalom obsega. Negativna odločitev je ENTITLEMENT_DENIED; preverjanje, ki ni dosegljivo, je ENTITLEMENT_UNREACHABLE, vrata pa nikoli ne obravnavajo enega kot drugega.
Sam licenčni dokument. Koda, ki se mora sama odločiti na podlagi podpisane licence, kot je zaprti modul domenskega paketa, uporablja verifyLicenceDocument(docText, opts) iz runtime/licence-document. To je čista funkcija: brez omrežnega klica, brez okoljske spremenljivke, brez datoteke. Oba podpisa preveri glede na korene zaupanja, ki jih nosi gradnja, in odgovori s stanjem (VALID, WARN, GRACE, RESTRICT, TERMINATE ali ABSENT) skupaj z odobritvami, dodatki in domenskimi paketi. licenceAllows(verdict, featureGroup, action, tenantId?) nato pove, ali smete izvesti use ali provision pod skupino. RESTRICT dovoli use in na provision odgovori z LICENCE_LOCKED, tako da se tekoče delo nadaljuje, nič novega pa se ne začne.
Preizkušanje
Testi predloge prikazujejo vzorec; to so orodja v ozadju.
Ponaredki obsega. Dvojnika razrešenega obsega zgradite enkrat, v test/scope-fakes.ts, in ga vstavite povsod, vključno s primeri odsotnosti: brez enote, brez žetona, žeton z ničelno organizacijo. Poti zavrnitve so produkt.
Ponarejen transport za razpošiljanje. UnoClient sprejme fetch, now in sleep, tako da se test enote nikoli ne dotakne omrežja. Preverite polja ovojnice, obliko 202, povpraševanje do končne vrstice z njenim organization_id ter to, da se vrstica za drugega najemnika zavrže.
Pravi Postgres. Ponarejena funkcija poizvedbe dokaže niz SQL. Ne more pa dokazati, da drži vsiljena varnost na ravni vrstic ali da se datoteke uveljavijo po vrstnem redu kot pri migratorju. testing/ephemeral-postgres zažene strežnik za enkratno uporabo in izvede isti nexus-migrate, kot ga izvaja produkcija:
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 runsIzven CI (neprekinjene integracije) stroj brez strežnika Postgres preskoči vsak primer podatkovne baze po imenu skupaj z rešitvijo in nikoli ne javi uspeha (zelene). V CI ista odsotnost povzroči neuspeh celotne zbirke (EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI), saj je preskočen test varnosti na ravni vrstic zeleno stikalo, ki ni izmerilo ničesar. Strežnik čaka do 180 sekund na zagon, nadzorni mehanizem pa ga ustavi, ko testni proces preneha.
Izolacijsko ogrodje. runIsolationHarness(target) iz testing/isolation-harness prebere vsako pot, ki jo vaša aplikacija priklopi, in vsako napade kot skrbnik druge organizacije ter kot sodelavec. Nato napade znova z odstranjeno kodno ograjo, odstranjeno podatkovno ograjo in z odstranjenima obema. Pot je PROVEN le, ko napad spodleti ob prisotnosti katere koli ograje in doseže podatke žrtve, ko sta odstranjeni obe, tako da veste, da test sploh lahko zazna uhajanje podatkov. Pošlje deklarirano poizvedbo in primer telesa za vsako pot, tako da je dosežena tudi pot, ki zavrne prazno zahtevo. V testu pripnite ledgerOf(report) in sprožite neuspeh ob defectsOf(report).
Registracija: od manifesta do registra veščin
Veščine iz vašega manifesta dosežejo register veščin po eni poti:
manifest.skills[] → compileRegistry(manifest) → POST /api/v1/plugins/sync
compileRegistry pretvori potrjen manifest v telo nexus.plugin-sync/v1. Predloga to stori ob uvozu, zato neveljaven manifest prekine gradnjo:
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" } ]
}Sinhronizacija je deklarativna: vsakič pošljite celoten nabor veščin, izpuščena veščina pa se onemogoči, pri čemer se njena zgodovina ohrani. Je stroga: neznano polje, polje druge ravni ali null je zavrnjeno, vse kršitve se vrnejo skupaj v enem 400 SYNC_CONTRACT_VIOLATION in dokler obstaja vsaj ena, se ne zapiše nič. Za vsako veščino zapiše eno vrstico v registru s ključem vrste opravila z imenskim prostorom, ki nosi vsak stolpec, ki ga bere razpošiljatelj, tako da je veščina izvedljiva v trenutku, ko sinhronizacija odgovori z 200.
Avtenticirani klicatelj je vtičnik, nikoli polje v telesu. Sinhronizacijo pokličite iz lastne delovne obremenitve vašega vtičnika prek mTLS (vzajemni TLS: Transport Layer Security s potrdilom na obeh straneh). Pogon veščin prebere odjemalsko potrdilo vaše delovne obremenitve, katerega identiteta SPIFFE (spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>) imenuje imenski prostor in storitveni račun, ter poišče vtičnik in lastniško organizacijo, zabeleženo za ta imenski prostor. pluginId v telesu se mora ujemati; to je preverjanje, ne izbirnik. Vsaka vrstica se zapiše s tem vtičnikom in organizacijo.
| Stanje | Koda | Pomen |
|---|---|---|
| 200 | {contract, pluginId, version, created, updated, unchanged, disabled, skills} |
|
| 400 | SYNC_CONTRACT_VIOLATION |
Vsaka kršitev je navedena v violations[]; nič ni zapisano |
| 401 | UNAUTHORIZED |
Napačen ali manjkajoč storitveni ključ |
| 401 | CALLER_IDENTITY_UNVERIFIED |
Ni berljive identitete odjemalca |
| 403 | DELIVERY_IDENTITY_MISSING |
Klicni imenski prostor ne pripada nobenemu vtičniku |
| 403 | PLUGIN_ID_MISMATCH |
Telo imenuje drug vtičnik |
| 409 | REGISTRY_CONFLICT |
Vrsta opravila je v lasti drugje ali je bila registrirana izven sinhronizacije; nič ni zapisano |
Korak namestitve naj spodleti ob vsakem stanju razen 200. Nobeno drugo stanje ne pomeni, da so vaše veščine registrirane.
Uvajanje
Uvajanje poteka v desetih zaporednih korakih, od katerih je vsakega mogoče samostojno ponoviti, preklicati ali povrniti v prejšnje stanje:
- Klonirajte skladišče in ga potrdite.
- Razčlenite manifest.
- Preglejte ga glede varnostnih težav.
- Zgradite sliko.
- Potisnite jo v register namestitve.
- Nastavite njena domenska imena.
- Namestite jo prek kanalov izdaje namestitve.
- Počakajte na preverjanje stanja delovanja.
- Registrirajte vtičnik.
- Obvestite razvijalca.
Pred namestitvijo se na manifestu in zgrajeni sliki izvede pet preverjanj skladnosti: manifest se razčleni in vsebuje obvezna polja; vsaka deklarirana pot je dejanska registrirana pot; vtičnik je lastnik svoje sheme in ne zapisuje ničesar izven nje; zahteve za vire so deklarirane in znotraj meja; slika pa ima delujoč obravnavalnik stanja delovanja. Vtičnik, ki se ob zagonu sam registrira, izvede isto pogodbo pod lastno avtoriteto, tako da preverjanja postanejo njegov CI namesto CI cevovoda. Preskok enega preverjanja ne skrajša uvajanja; napako le prestavi v čas izvajanja.
Elementi blagovne znamke v vašem manifestu se strežejo brez avtentikacije glede na domeno, saj jih prijavna stran potrebuje, preden ima kdor koli poverilnice. Vse v branding obravnavajte kot javno.
GATE_CANNOT_BE_SKIPPED.Česa izvajalno okolje ne bo naredilo namesto vas
Izvajalno okolje strogo varuje izolacijo, razpošiljanje in dostop do modelov. Ne bo pa poskrbelo za pravilnost vaše produktne logike in ne bo pohitrilo počasne poizvedbe: vsak stavek se izvede znotraj povezane transakcije s časovnimi omejitvami, ki jih deklarira blok db vašega manifesta, stavek, ki preseže statementTimeoutMs, pa se prekliče in se nanj ne čaka. Temu primerno dimenzionirajte svoje poizvedbe. Poleg tega zadržanje za odobritev, bralni sedež in bralnik licenc dodajo povratno pot v omrežju ali transakcijo. Pri mojem vtičniku za pregled anomalij je preverjanje licence dodalo nekaj milisekund na zahtevo, dokler se njegov 30-sekundni pomnilnik ni ogrel, kar je bila poštena cena za to, da nikoli ne postrežemo zaklenjene zmožnosti.

