Versioon 1.0.0-alpha.1uusim
Peatükk 2.22
Pistikprogrammi käituskeskkond
SDK (tarkvaraarenduskomplekti) moodulid, millel teie pistikprogramm töötab, alates skoobikaitsest ja andmebaasi piirdest kuni UNO suunamise, AI (tehisintellekti) marsruudi lugemise ja litsentsikontrollideni. Seejärel testimine päris andmebaasi vastu, oskuste registreerimine ja kasutuselevõtt.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

SDK (tarkvaraarenduskomplekti) käitusaegne pool on moodulite kogum asukohas @adverant-nexus/plugin-sdk/runtime/* ning testiabivahendid asukohas testing/*. Te impordite need; te ei kirjuta neid uuesti. Selles ongi kogu mõte ja mul kulus üks tagasi lükatud ülevaatus, et seda tõsiselt võtta: ülevaataja märkus minu esimese pistikprogrammi käsitsi kirjutatud ulatusekontrolli kohta oli üksainus rida: „SDK-s on see juba olemas ja teie oma aktsepteerib MFA (mitmikautentimise) väljakutse tõendit seansina“.
See peatükk jälgib päringut läbi töötava pistikprogrammi nii, nagu täisteenuse mall selle ühendab: ulatuse kaitse, andmebaasi tara, üks lubatud ülepiiri ligipääs, saatmine UNO kaudu, AI (tehisintellekti) marsruudi lugemine ja litsentsikontrollid. Seejärel käsitleb see testimist, manifesti oskuste registreerimist ja kasutuselevõtu samme.
Skoop: üks kaitse raamistiku kohta
Igal /api marsruudil on ulatuse kaitse. See kontrollib kandjatõendit, tuletab sellest kolm telge (rentnik, omanik, üksus), keeldub päringu sisust, mis nimetab rentnikku, rakendab manifesti registrist marsruudi õigust ja alles seejärel laseb töötlejal käivituda. SDK pakub iga raamistiku jaoks ühte adapterit, kõik asukohast @adverant-nexus/plugin-sdk/runtime/scope ja kõik samade valikutega.
| Raamistik | Adapter |
|---|---|
| Express | scopeMiddleware |
| Fastify | requireScope, preHandler-funktsioonina |
| Järgmine | withScope, mis mähib töötleja; Next'i töötlejale ei öelda tema marsruuti, seega võtab withScope selle kolmanda argumendina |
Siin on malli Expressi ühendus lühendatult. Kontrollija on SDK oma ja see hoiab tõendit identiteediteenuse seansivormingu juures: ainult HS256; iss, exp, iat ja jti on kohustuslikud; eluiga on kõige rohkem üks tund; ning seansina ei aktsepteerita MFA väljakutse, kellenagi esinemise ega OAuth (delegeeritud volitamise avatud standardi) ressursi tõendit.
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)) });
});Õiguste kaitse rakendab marsruudi õigust neljas etapis. Roll õiguse never loendis keeldub koodiga AUTHORITY_EXCEEDED ja barred sõnadega ning ükski koht seda ei tühista. Roll loendis roles lubab, kui õigus ütleb seat: true, siis lisaks kehtiva kohaga. Vastasel korral lubab õigust kandev kehtiv koht. Vastasel korral keeldutakse päringust koodiga AUTHORITY_EXCEEDED, nimetades inimesi, kes saaksid koha anda. Andke kaitsele hoidla (rights: { manifest, store: { pool, schema } }) ja see loeb kohti helistaja enda ulatuses; õigus, mis nimetab licence, vajab lisaks litsentsilugejat, mida käsitletakse allpool.
Töötleja sees on scopeOf(req) ainus viis tuletatud ulatust lugeda ja see viskab erindi, kui kaitse ei käivitunud. Eesliitele registreeritud kaitse, mis käivitub enne, kui ükski marsruut on sobitunud, vastab 500 MIDDLEWARE_ORDERING_ERROR; teie koodi registreeritud marsruut, mida manifest ei deklareeri, vastab 500 UNHANDLED_ERROR. Mõlemad nurjuvad suletult.
Malli /internal marsruudid, mida platvorm kutsub, kasutavad teist režiimi. Teenuse kaitse kontrollib X-Service-Key konstantse ajaga ja võtab rentniku platvormi väärtusest X-Organization-ID, keeldudes veakoodiga MISSING_SERVICE_KEY, INVALID_SERVICE_KEY või MISSING_ORG_ID_HEADER. Platvormi allkirjastatud kutsepõhise tõendi jaoks on SDK-s requireService (Fastify) ja serviceMiddleware (Express), mis kontrollivad ka, millise oskuse ja marsruudi jaoks tõend loodi, ning keelduvad kaks korda kasutatud tõendist.
Andmebaasi tara: tenantFence ja withScopedTx
Iga lause ulatusega tabeli vastu koostab tara ja käivitub ulatusega tehingu sees:
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) loob tuletatud ulatusest predikaadi ja selle parameetrid. Edastage isiklike tabelite puhul owner; jätke see välja organisatsiooni artefaktide puhul, kus omanik näitab päritolu. Kui lausel on juba parameetrid, ütleb startIndex tarale, millisest numbrist alustada. Lisamine ei võta telgi kunagi sisendina: see kirjutab scope.tenant, scope.owner ja scope.unit ulatusest.
withScopedTx seob kõik kolm telge üheks tehinguks skeemi ainsa sidumisfunktsiooni kaudu ja käivitab seejärel teie tagasikutse. Teine sidumine samas tehingus tõstab SCOPE_ALREADY_BOUND (500: teie kood sidus kaks korda; helistaja ei teinud midagi valesti). Puuduv või nullväärtusega rentnik või omanik tõstab SCOPE_PREDICATE_INVALID (403). Säte kehtib ainult tehingu piires, seega ei saa kogumisse kuuluv ühendus kanda ühte rentnikku järgmisesse päringusse.
Kaks sõsarfunktsiooni katavad juhtumid, mis ei ole inimese päring. withTenantScopedTx seob rentniku ja üksuse ilma omanikuta ridade jaoks, mida loeb masin (seadmeregister), ja keeldub ulatusest, milles on omanik. maintenanceScope(reason) sunnib organisatsiooniülest toimingut enne omaniku tehingu avamist ütlema valjult välja, mis see on. Koodi tara ja sunnitud reataseme turve on kaks mehhanismi ühe seaduse jaoks; käivituskontroll keeldub kuulamast, kuni andmebaas tõestab, et teine neist kehtib (vastasel korral DB_ROLE_BYPASSES_ISOLATION).
Iga keeldumine on rida
Mall paigaldab ühe korra veel ühe vahevara päringu sisu parseri ja marsruuterite vahele: keeldumiste registri.
import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";
app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));See mähib vastuse nii, et iga keeldumine, mida inimene loeb, olgu see õiguste kaitselt, töötlejalt või hoidlalt, kirjutatakse teie skeemi tabelisse refusal selle inimese enda ulatusega tehingu sees enne vastuse sisu saatmist. Anonüümne 401 ei kirjuta midagi. Kui rida ei saa kirjutada, muutub vastuseks UNHANDLED_ERROR: „ei“, mida toode ei saa salvestada, ei saadeta nii, nagu oleks see salvestatud. Käivitamisel käitatakse assertRefusalLedger, et kontrollida, kas tabel suudab registri rea vastu võtta, ja hoidla saab kutsuda noteSubject({ recordId, isDemo }), et iga keeldumine nimetaks kirjet, mida see puudutas. Kui klient küsib, miks kellelegi möödunud teisipäeval keelduti, on vastus päring, mitte oletus.
Ainus piiriületus: salvestatud kirjutuskaitstud luba
Kui üks teie klient teeb tööd teisele ja teine võib seda kontrollida, on piiri ületamiseks üks heakskiidetud viis. Ridu hoidev organisatsioon salvestab loa. Lugeja organisatsioon lubab inimese sisse koha kaudu, mis kannab õigust granted.read, mis peab loendis never nimetama owner ja admin. Lugemine toimub kuuenda andmebaasirollina, lugemiskohana, mis saab valida ainult tabeleid, mille databases[].granted loetleb:
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 kirjutab vaatamise esmalt lugeja enda rentnikusse, seejärel seob lugemiskoha loaga, mis kirjutab vaatamise hoidja rentnikusse. Andmebaasi enda poliitika kontrollib, et luba nimetab lugeja organisatsiooni, katab tabelit, on alanud, ei ole lõppenud ega ole tagasi võetud ning et see tehing kirjutas oma vaatamise. Lugemine, mis jätab vaatamise vahele, ei näe midagi. Käivitamisel kontrollib assertSeatAtBoot(seatPool, schema), et seat.url põhjal avatud kogum on tõesti see koht ja mitte midagi enamat, ning keeldub vastasel korral koodiga DB_SEAT_ROLE_INVALID.
Suunamine läbi UNO
Kogu arvutus käib läbi ühe kliendi, mis on loodud ühes failis suletud lubatud loendiga:
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,
});
}Lubatud loend on meelega mooduli tasemel konstant. Kui operaator saaks seda konfiguratsiooni kaudu laiendada, muutuks marsruut kogu registri saatmisvolikirjaks. Malli enda test kinnitab, et loend nimetab täpselt need tööde tüübid, milleks manifest kompileerub.
Ümbrik
Saatmise kohustuslikus tuumas on kuus välja. Klient täidab rentniku ja tegutseja kontrollitud ulatusest, mitte kunagi päringust:
| Väli | Mida see sisaldab |
|---|---|
jobType |
Nimeruumiga töö tüüp, <plugin name>.<skill id> |
organizationId |
Rentnik ulatusest |
userId |
Tegutseja ulatusest, auditi ja arvelduse jaoks |
inputParams |
Oskuse sisend. See ei sisalda kunagi rentniku ID-d; sellist sisaldav sisend lükatakse saatmisel tagasi |
priority |
critical, high, normal või low |
pluginId |
Teie manifesti name. Iga saatmine deklareerib oma lähte-pistikprogrammi |
Valikulised väljad on muu hulgas correlationId (UUID (universaalselt unikaalne identifikaator) või luuakse uus) ja callbackUrl, mida plugin_queue oskus vajab, et töötaja teaks, kuhu oma tulemus postitada.
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, seejärel küsitlemine
Iga saatmine pannakse järjekorda. Vastus on alati 202 koos identifikaatoritega (jobId, runId, traceId, status), mitte kunagi tulemus. Tulemus tuleb töö küsitlemisest või teie tagasikutsest. uno.peek(jobId, { scope }) loeb selle üks kord ja awaitJob küsitleb kuni lõppolekuni; mõlemad saadavad rentniku kontrollitud ulatusest ja mõlemad kontrollivad tagastatud rea välja organization_id helistaja rentniku vastu teie pool võrgukutset, keeldudes mittevastavusest koodiga SCOPE_REFUSED.
Lugege käivitusrida selle enda kirjapildis. Saatmise vastus ütleb jobId; rida ütleb job_id, organization_id ja plugin_id. Tulemuse ja nurjumise veerud on result, error, error_code ja error_troubleshooting. completed ja failed on lõppolekud. timed_out, cancelled ja system_failure tulevad koristajalt ja hiline tulemus võib neid veel parandada. Klient, mis käsitleb mõnda neist parsimatuna, keeldub ridadest, mida platvorm iga päev kirjutab.
Kinnitusootel hoidmine
Manifesti oskus, mis deklareerib approval, peetakse saatmisel kinni. 202 ütleb siis status: "awaiting_approval" ja sisaldab välja waitpointId koos manifestis antud põhjusega. Käivitus jääb ootele, kuni nimetatud inimene selle kohta otsuse teeb. uno.approve ja uno.resolveWaitpoint saadavad rentniku ja helistaja tegutsejana ning otsusest, mille teeb keegi muu kui kontrollitud helistaja, keeldutakse. Kinnitus vabastab töö üks kord ja käitab saatmiskontrollid uuesti; tagasilükkamine lõpetab selle olekuga failed. Teisest otsusest keeldutakse, samuti otsusest pärast ootele panemise aegumist. Kui teie toode nõuab, et kinnitaja oleks ettepaneku tegijast erinev inimene, jõustage see otsust tegevas marsruudis: platvorm salvestab mõlemad.
Kuvage kinni peetud töö kinni peetuna. Ärge öelge inimesele, et tema klõps selle vabastas, enne kui käivitusrida seda ütleb.
AI: eelistused oskuse real ja üks lugemine
Teie pistikprogramm ei kutsu kunagi mudelit. Kui manifesti oskus seda vajab (llm_only või tool_using, usaldustasemel core või verified), väljendate eelistused selle registrireal ja marsruuter otsustab organisatsiooni enda kogumist:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
}
}preferredProvider ja preferredModel on soovid, mida marsruuter järgib ainult siis, kui organisatsioonil on see teenusepakkuja lubatud ja volitustega varustatud. capabilityProfile filtreerib ega vali kunagi; selle dataResidency (eu_only, us_only või any) on range piirang, mille marsruuter kas täidab või keeldub. Kõigi nende väljajätmine on tavaliselt õige. modelOverride on olemas harvaesineva oskuse jaoks, mis vajab üht täpset mudelit, ja see muudab selle kõrval olevad soovid toimetuks; ma väldiksin seda, kui oskus pole ühelgi teisel mudelil mõttetu.
Kui teie liides peab näitama, millist mudelit marsruuter kasutaks, lugege see, ärge ennustage:
import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";createAIRouteClient(...).effectiveRoute() on AI Provider Routeri ainus heakskiidetud lugemisviis. See võtab lüüsi aadressi, helistaja enda kandjatõendi ja teie platvormi slugi ega saada ühtegi AI-päringut. See vastab teenusepakkuja ja mudeliga, poliitikaga lubatud teenusepakkujatega ning sellega, kas valitud lõpp-punkt käitab local või external. Kui marsruut pole kasutatav, vastab see marsruuteri keeldumisega sõnades (NO_PROVIDER_FOR_ROLE, MODEL_CAPABILITY_UNAVAILABLE või NO_MODEL_FOR_ROLE_AND_PROVIDER koos parandusjuhisega), mitte kunagi vaikemudeliga. Näidake seda keeldumist inimesele; see on tema organisatsiooni konfiguratsioon, mis räägib.
Litsentsikontrollid
Litsentsimist kontrollib kolm mehhanismi kolmel täpsusastmel.
Õigus, mis nimetab litsentsi. Kõige lihtsam. Manifestis kannab õigus välja licence: "<feature>" ja kaitse küsib enne ühegi rolli lugemist helistaja enda tõendiga identiteediteenuselt, kas organisatsiooni litsents seda kannab. Looge kaitse lugejaga:
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 }) },
});Litsents, mis funktsiooni ei kanna, keeldub kõigist koodiga LICENCE_LOCKED, nimetades, mis seda kannab, ja öeldes, et organisatsiooni omanikud ja administraatorid saavad selle sisse lülitada. Litsents, mida ei saa lugeda, keeldub koodiga UNHANDLED_ERROR: lukustatud funktsiooni ei pakuta kunagi seetõttu, et litsents polnud kättesaadav. Vastuseid jäetakse meelde 30 sekundiks organisatsiooni ja funktsiooni kohta.
Toote värav. createProductGate({ baseUrl, product }) asukohast runtime/product-gate küsib kasutusõiguse kontrollilt, kas helistaja organisatsioonil on teie toode üldse olemas, ja selle middleware() käivitub pärast ulatuse kaitset. Eitav otsus on ENTITLEMENT_DENIED; kontroll, millega ei saa ühendust, on ENTITLEMENT_UNREACHABLE, ja värav ei käsitle kunagi üht teisena.
Litsentsidokument ise. Kood, mis peab allkirjastatud litsentsi põhjal ise otsustama, näiteks domeenipaketi suletud moodul, kasutab verifyLicenceDocument(docText, opts) asukohast runtime/licence-document. See on puhas funktsioon: ei võrgukutset, keskkonnamuutujat ega faili. See kontrollib mõlemat allkirja järgu kaasas olevate usaldusjuurte vastu ja vastab olekuga (VALID, WARN, GRACE, RESTRICT, TERMINATE või ABSENT) koos õiguste, lisandmoodulite ja domeenipakettidega. Seejärel ütleb licenceAllows(verdict, featureGroup, action, tenantId?), kas võite grupi all teha use või provision. RESTRICT lubab use ja vastab provision väärtusega LICENCE_LOCKED, nii et käimasolev töö jätkub ja midagi uut ei alga.
Testimine
Malli testid näitavad mustrit; need on selle taga olevad tööriistad.
Ulatuse võltsingud. Looge tuletatud ulatuse asendusobjekt üks kord failis test/scope-fakes.ts ja süstige seda kõikjale, sealhulgas puudumise juhtumitesse: üksust pole, tõendit pole, tõend nullorganisatsiooniga. Keeldumisteed ongi toode.
Võltsitud saatmistransport. UnoClient võtab fetch, now ja sleep, nii et ühiktest ei puuduta kunagi võrku. Kinnitage ümbriku väljad, 202 kuju, küsitlemine kuni lõppolekus reani koos selle väljaga organization_id ning see, et teise rentniku rida jäetakse kõrvale.
Päris Postgres. Võltsitud päringufunktsioon tõendab SQL-stringi. See ei suuda tõendada, et sunnitud reataseme turve kehtib või et failid rakenduvad samas järjekorras nagu migraatoris. testing/ephemeral-postgres käivitab ühekordse serveri ja käitab sama nexus-migrate, mida käitab toodang:
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 runsVäljaspool CI-d (pidevat integratsiooni) jätab masin, millel pole Postgresi serverit, iga andmebaasijuhtumi nimeliselt vahele koos lahendusega, mitte kunagi rohelisena. CI-s põhjustab sama puudumine testikomplekti nurjumise (EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI), sest vahele jäetud reataseme turbe test on roheline kontrollpunkt, mis ei mõõtnud midagi. Server ootab käivitumist kuni 180 sekundit ja valvetaimer peatab selle, kui testiprotsess kaob.
Isolatsiooni testraamistik. runIsolationHarness(target) moodulist testing/isolation-harness loeb kõik marsruudid, mille teie rakendus ühendab, ja ründab igaüht teise organisatsiooni administraatorina ja kolleegina. Seejärel ründab see uuesti nii, et koodi tõke on eemaldatud, andmebaasi tõke on eemaldatud ning mõlemad on eemaldatud. Marsruut on PROVEN ainult siis, kui rünnak nurjub kummagi tõkke olemasolul ja jõuab ohvri andmeteni, kui mõlemad on eemaldatud, nii et teate, et test suudab lekke üldse tuvastada. See saadab iga marsruudi deklareeritud päringu ja näidiskeha, nii et ka tühja päringu tagasi lükkav marsruut saavutatakse. Fikseerige testis ledgerOf(report) ja nurjuge defectsOf(report) korral.
Registreerimine: manifestist oskuste registrisse
Teie manifesti oskused jõuavad oskuste registrisse ühe tee kaudu:
manifest.skills[] → compileRegistry(manifest) → POST /api/v1/plugins/sync
compileRegistry muudab valideeritud manifesti nexus.plugin-sync/v1 kehaks. Mall teeb seda importimisel, nii et kehtetu manifest nurjab järgu:
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" } ]
}Sünkroonimine on deklaratiivne: saatke iga kord kogu oskuste komplekt ning välja jäetud oskus keelatakse, selle ajalugu säilitatakse. See on range: tundmatu väli, teise taseme väli või null lükatakse tagasi, kõik rikkumised tagastatakse koos ühes 400 SYNC_CONTRACT_VIOLATION vastuses ja seni, kuni neid on, ei kirjutata midagi. Ning see kirjutab iga oskuse kohta ühe registrirea, mille võtmeks on nimeruumiga tööülesande tüüp ja mis sisaldab kõiki veerge, mida dispetšer loeb, nii et oskus on käivitatav kohe, kui sünkroonimine vastab 200.
Plugin on autenditud kutsuja, mitte kunagi kehavälja väärtus. Kutsuge sünkroonimist oma plugina enda töökoormusest üle mTLS-i (vastastikune TLS: Transport Layer Security, kus sertifikaat on mõlemas otsas). Skills Engine loeb teie töökoormuse kliendisertifikaati, mille SPIFFE identiteet (spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>) nimetab nimeruumi ja teenusekonto, ning otsib üles selle nimeruumi jaoks salvestatud plugina ja omanikorganisatsiooni. Keha pluginId peab ühtima; see on kontroll, mitte valija. Iga rida kirjutatakse selle plugina ja organisatsiooniga.
| Olek | Kood | Tähendus |
|---|---|---|
| 200 | {contract, pluginId, version, created, updated, unchanged, disabled, skills} |
|
| 400 | SYNC_CONTRACT_VIOLATION |
Kõik rikkumised on loetletud väljal violations[]; midagi ei kirjutatud |
| 401 | UNAUTHORIZED |
Vigane või puuduv teenusevõti |
| 401 | CALLER_IDENTITY_UNVERIFIED |
Loetav kliendi identiteet puudub |
| 403 | DELIVERY_IDENTITY_MISSING |
Kutsuv nimeruum ei kuulu ühelegi pluginale |
| 403 | PLUGIN_ID_MISMATCH |
Keha nimetab teist pluginat |
| 409 | REGISTRY_CONFLICT |
Tööülesande tüüp kuulub mujale või registreeriti väljaspool sünkroonimist; midagi ei kirjutatud |
Laske oma juurutusetapil nurjuda iga oleku korral peale 200. Ükski muu olek ei tähenda, et teie oskused on registreeritud.
Kasutuselevõtt (onboarding)
Kasutuselevõtt toimub kümne järjestatud sammuna, millest igaüht saab eraldi uuesti käivitada, tühistada või tagasi pöörata:
- Kloonige hoidla ja valideerige see.
- Parsige manifest.
- Kontrollige seda turbeprobleemide suhtes.
- Ehitage tõmmis.
- Lükake see paigalduse registrisse.
- Seadistage selle domeeninimed.
- Juurutage see paigalduse väljalaskekanalite kaudu.
- Oodake seisukontrolli.
- Registreerige plugin.
- Teavitage arendajat.
Enne juurutamist käivitatakse manifesti ja ehitatud tõmmise suhtes viis vastavuskontrolli: manifest on parsitav ja sisaldab nõutud välju; iga deklareeritud marsruut on päris registreeritud marsruut; plugin omab oma skeemi ega kirjuta midagi väljapoole seda; ressursipäringud on deklareeritud ja piirides; ning tõmmisel on toimiv seisukontrolli käsitleja. Plugin, mis registreerib end käivitumisel ise, täidab sama lepingut omal volitusel, nii et kontrollid muutuvad selle CI-ks, mitte konveieri omaks. Ühe vahelejätmine ei lühenda kasutuselevõttu; see viib nurjumise käitusaega.
Teie manifesti brändingut serveeritakse domeeni järgi ilma autentimiseta, sest sisselogimisleht vajab seda enne, kui kellelgi on mandaat. Käsitlege kõike plokis branding avalikuna.
GATE_CANNOT_BE_SKIPPED.Mida käituskeskkond teie eest ära ei tee
Käituskeskkond hoiab joont isolatsiooni, dispetšeerimise ja mudelitele juurdepääsu osas. See ei tee teie tooteloogikat õigeks ega muuda aeglast päringut kiireks: iga lause käivitatakse seotud transaktsiooni sees ajalõpudega, mille teie manifesti db plokk deklareerib, ja lause, mis ületab statementTimeoutMs, tühistatakse, mitte ei oodata. Kujundage oma päringud selle järgi. Lisaks lisavad kinnitusootel hoidmine, lugemiskoht ja litsentsilugeja igaüks ühe edasi-tagasi päringu või transaktsiooni. Minu anomaaliate ülevaatuse pluginas lisas litsentsikontroll iga päringu kohta mõne millisekundi, kuni selle 30-sekundiline mälu soojenes, mis oli õiglane hind selle eest, et lukustatud funktsiooni ei serveerita kunagi.

