InnskráningBóka kynningu

Kafli 2.22

Keyrsluumhverfi viðbóta

SDK-einingarnar (þróunarsettið) sem viðbótin þín keyrir á, allt frá gildissviðsvörð og gagnagrunnsgirðingu til UNO-afgreiðslu, lesturs á gervigreindarleið (AI) og leyfisathugana. Síðan prófanir gegn raunverulegum gagnagrunni, skráning á færniþáttum þínum og innleiðing.

Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

21 mínútna lestur

Keyrsluhluti SDK (hugbúnaðarþróunarsettsins) er safn eininga undir @adverant-nexus/plugin-sdk/runtime/*, auk prófunarhjálpartækja undir testing/*. Þú flytur þær inn; þú útfærir þær ekki upp á nýtt. Það er öll hugmyndin, og það þurfti eina hafnaða yfirferð til að ég tæki hana alvarlega: athugasemd yfirlesarans við handskrifaða umfangsathugun í fyrstu viðbótinni minni var ein lína, „SDK hefur þetta nú þegar, og þín samþykkir MFA-áskorunartóka (fjölþátta auðkenning) sem setu“.

Þessi kafli fylgir beiðni í gegnum viðbót í keyrslu, eins og heildarþjónustusniðmátið tengir hana: umfangsvörðinn, gagnagrunnsgirðinguna, einu leyfðu yfirferðina, sendingu í gegnum UNO, lestur gervigreindarleiðar og leyfisathuganirnar. Síðan fjallar hann um prófanir, skráningu færnianna í skilgreiningarskránni þinni og skrefin við innleiðingu.

Gildissvið: einn vörður á hvert umhverfi

Sérhver /api-leið ber umfangsvörðinn. Hann staðfestir handhafatókann, leysir úr honum ásana þrjá (leigjanda, eiganda, einingu), hafnar meginmáli sem tilgreinir leigjanda, beitir réttindum leiðarinnar úr réttindaskrá skilgreiningarskrárinnar og leyfir aðeins þá meðhöndlaranum að keyra. SDK fylgir eitt millistykki fyrir hvern ramma, öll úr @adverant-nexus/plugin-sdk/runtime/scope og öll með sömu valkostunum.

Rammi Millistykki
Express scopeMiddleware
Fastify requireScope, sem preHandler
Næsti withScope, sem umlykur meðhöndlarann; Next-meðhöndlara er ekki sagt hver leið hans er, svo withScope tekur hana sem þriðju færibreytu

Hér er Express-tenging sniðmátsins, stytt. Staðfestingaraðilinn er frá SDK og hann heldur tókanum við setusnið auðkennisþjónustunnar: aðeins HS256; iss, exp, iat og jti áskilin; líftími að hámarki ein klukkustund; og hvorki MFA-áskorun, staðgöngutóki né OAuth-tilfangatóki (opni staðallinn fyrir framselda heimild) tekinn gildur sem seta.

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)) });
});

Réttindavörðurinn beitir réttindum leiðar í fjórum skrefum. Hlutverk á never-lista réttindanna hafnar með AUTHORITY_EXCEEDED og barred-orðunum, og ekkert sæti aflétti því. Hlutverk á roles hleypir inn, og þá einnig með virku sæti þegar réttindin segja seat: true. Annars hleypir virkt sæti sem ber réttindin inn. Annars er beiðninni hafnað AUTHORITY_EXCEEDED og tilgreint hverjir gætu úthlutað sæti. Gefðu verðinum geymslu (rights: { manifest, store: { pool, schema } }) og hann les sæti undir umfangi kallandans sjálfs; réttindi sem tilgreina licence þurfa einnig leyfislesara, sem fjallað er um hér á eftir.

Innan meðhöndlara er scopeOf(req) eina leiðin til að lesa leyst umfang, og það kastar villu ef vörðurinn keyrði ekki. Vörður skráður á forskeyti, sem keyrir áður en nokkur leið hefur passað, svarar 500 MIDDLEWARE_ORDERING_ERROR; leið sem kóðinn þinn skráir en skilgreiningarskráin lýsir ekki yfir svarar 500 UNHANDLED_ERROR. Hvort tveggja bregst lokað.

/internal-leiðir sniðmátsins, sem verkvangurinn kallar á, nota hitt fyrirkomulagið. Þjónustuvörðurinn athugar X-Service-Key á föstum tíma og tekur leigjandann úr X-Organization-ID verkvangsins, og hafnar MISSING_SERVICE_KEY, INVALID_SERVICE_KEY eða MISSING_ORG_ID_HEADER. Fyrir undirritaðan tóka verkvangsins fyrir hvert kall hefur SDK requireService (Fastify) og serviceMiddleware (Express), sem athuga einnig fyrir hvaða færni og leið tókinn var sleginn og hafna tóka sem er notaður tvisvar.

Gagnagrunnsgirðingin: tenantFence og withScopedTx

Sérhver skipun gegn umfangsbundinni töflu setur saman girðinguna og keyrir innan umfangsbundinnar færslu:

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) byggir skilyrðið og færibreytur þess úr leystu umfangi. Sendu owner fyrir persónulegar töflur; slepptu því fyrir skipulagsgögn þar sem eigandi segir til um uppruna. Þegar skipunin hefur þegar færibreytur segir startIndex girðingunni frá hvaða tölu hún á að byrja að númera. Innsetning tekur aldrei ásana sem inntak: hún skrifar scope.tenant, scope.owner og scope.unit úr umfanginu.

withScopedTx bindur alla þrjá ásana fyrir eina færslu í gegnum einu bindiaðgerð skemans og keyrir síðan svarfallið þitt. Önnur binding í sömu færslu kallar fram SCOPE_ALREADY_BOUND (500: kóðinn þinn batt tvisvar; kallandinn gerði ekkert rangt). Leigjandi eða eigandi sem vantar eða er núll kallar fram SCOPE_PREDICATE_INVALID (403). Stillingin gildir aðeins innan færslunnar, svo tenging úr tengingasafni getur ekki borið einn leigjanda yfir í næstu beiðni.

Tvær systuraðgerðir ná yfir þau tilvik sem eru ekki beiðni einstaklings. withTenantScopedTx bindur leigjanda og einingu án eiganda, fyrir raðir sem vél les (tækjaskrána), og hafnar umfangi sem ber eiganda. maintenanceScope(reason) lætur aðgerð sem nær til alls skipulagsins segja upphátt hvað hún er áður en færsla eigandans opnast. Kóðagirðingin og þvinguð raðaöryggisstýring eru tvö kerfi fyrir eina reglu; ræsiathugunin neitar að hlusta þar til gagnagrunnurinn sannar að hið síðara gildi (DB_ROLE_BYPASSES_ISOLATION ella).

Sérhver höfnun er röð

Sniðmátið setur upp eitt millihugbúnaðarstykki til viðbótar, einu sinni, á milli meginmálsþáttarans og beinanna: höfnunarskrána.

import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";

app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));

Hún umlykur svarið þannig að sérhver höfnun sem einstaklingur les, hvort sem hún kemur frá réttindaverðinum, meðhöndlara eða geymslu, er skrifuð í refusal-töflu skemans þíns innan umfangsbundinnar færslu þess einstaklings áður en meginmálið er sent. Nafnlaust 401 skrifar ekkert. Ef ekki er hægt að skrifa röðina verður svarið UNHANDLED_ERROR: „nei“ sem varan getur ekki skráð er ekki sent eins og það hefði verið skráð. Ræsingin keyrir assertRefusalLedger til að athuga hvort taflan geti tekið við röð skrárinnar, og geymsla getur kallað á noteSubject({ recordId, isDemo }) svo hver höfnun tilgreini færsluna sem hún snerist um. Þegar viðskiptavinur spyr hvers vegna einhverjum var vísað frá síðasta þriðjudag er svarið fyrirspurn, ekki ágiskun.

Eina þverunin: skráð lesheimild

Þegar einn viðskiptavina þinna vinnur fyrir annan og sá síðarnefndi má skoða vinnuna er ein viðurkennd leið yfir mörkin. Skipulagið sem geymir raðirnar skráir heimild. Skipulag lesandans hleypir einstaklingi inn í gegnum sæti sem ber réttindin granted.read, sem verða að tilgreina owner og admin í never. Lesturinn keyrir sem sjötta gagnagrunnshlutverkið, lestrarsætið, sem getur aðeins valið úr þeim töflum sem databases[].granted telur upp:

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 skrifar skoðunina fyrst í eigin leigjanda lesandans og bindur síðan lestrarsætið við heimildina, sem skrifar skoðunina í leigjanda handhafans. Eigin stefna gagnagrunnsins athugar að heimildin tilgreini skipulag lesandans, nái yfir töfluna, sé hafin, sé ekki lokið og hafi ekki verið afturkölluð, og að þessi færsla hafi skrifað skoðun sína. Lestur sem sleppir skoðuninni sér ekkert. Við ræsingu athugar assertSeatAtBoot(seatPool, schema) að tengingasafnið sem opnað var úr seat.url sé í raun sætið og ekkert annað, og hafnar með DB_SEAT_ROLE_INVALID ella.

Afgreiðsla í gegnum UNO

Öll reiknivinnsla fer í gegnum einn biðlara, byggðan í einni skrá, með lokuðum leyfislista:

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,
  });
}

Leyfislistinn er viljandi fasti á einingarstigi. Ef rekstraraðili gæti víkkað hann úr stillingum yrði leiðin að sendingarmilliliði fyrir alla skrána. Eigið próf sniðmátsins staðfestir að listinn tilgreini nákvæmlega þær verktegundir sem skilgreiningarskráin þýðist yfir í.

Umslagið

Sending ber sex reiti í áskildum kjarna sínum. Biðlarinn fyllir út leigjanda og geranda úr staðfestu umfangi, aldrei úr beiðninni:

Reitur Hvað það geymir
jobType Verktegundin með nafnrými, <plugin name>.<skill id>
organizationId Leigjandinn, úr umfanginu
userId Gerandinn, úr umfanginu, vegna endurskoðunar og reikningagerðar
inputParams Inntak færninnar. Það ber aldrei auðkenni leigjanda; inntaki sem gerir það er hafnað við sendingu
priority critical, high, normal eða low
pluginId name skilgreiningarskrárinnar þinnar. Sérhver sending lýsir yfir upprunaviðbót sinni

Valfrjálsir reitir eru meðal annars correlationId (UUID (altækt einkvæmt auðkenni), annars er nýtt slegið) og callbackUrl, sem plugin_queue-færni þarfnast svo vinnslueiningin viti hvert hún á að senda niðurstöðu sína.

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, síðan fyrirspurnir

Sérhver sending er sett í biðröð. Svarið er alltaf 202 með auðkennum (jobId, runId, traceId, status), aldrei niðurstaða. Niðurstaðan kemur úr fyrirspurnum um verkið eða úr svarfallinu þínu. uno.peek(jobId, { scope }) les hana einu sinni og awaitJob spyr þar til lokastöðu er náð; báðar senda leigjandann úr staðfestu umfangi og báðar bera organization_id skilaðrar raðar saman við leigjanda kallandans þín megin við netkallið og hafna ósamræmi með SCOPE_REFUSED.

Lestu keyrsluröðina með hennar eigin stafsetningu. Sendingarsvarið segir jobId; röðin segir job_id, organization_id og plugin_id. Niðurstöðu- og villudálkarnir eru result, error, error_code og error_troubleshooting. completed og failed eru lokastöður. timed_out, cancelled og system_failure koma frá hreinsiferlinu og síðbúin niðurstaða getur enn leiðrétt þær. Biðlari sem telur einhverja þeirra óþáttanlega hafnar röðum sem verkvangurinn skrifar á hverjum degi.

Samþykkisbiðin

Færni í skilgreiningarskrá sem lýsir yfir approval er haldið við sendingu. 202 segir þá status: "awaiting_approval" og ber waitpointId, með ástæðunni sem skilgreiningarskráin gaf. Keyrslunni er haldið þar til nafngreindur einstaklingur úrskurðar um hana. uno.approve og uno.resolveWaitpoint senda leigjandann og kallandann sem geranda, og úrskurði annars en staðfests kallanda er hafnað. Samþykki losar verkið einu sinni og keyrir sendingarathuganirnar aftur; höfnun lýkur því failed. Öðrum úrskurði er hafnað, og einnig úrskurði eftir að biðin rennur út. Ef varan þín krefst þess að samþykkjandinn sé annar einstaklingur en sá sem lagði til skaltu framfylgja því í leiðinni sem úrskurðar: verkvangurinn skráir báða.

Birtu verk í bið sem verk í bið. Segðu einstaklingi ekki að smellur hans hafi losað það fyrr en keyrsluröðin segir það.

Gervigreind: óskir í færniþáttaröðinni og einn lestur

Viðbótin þín kallar aldrei á líkan. Þegar færni í skilgreiningarskrá þarf líkan (llm_only eða tool_using, á trausti core eða verified) tjáir þú óskir í skráarröð hennar og beinirinn ákveður úr eigin safni skipulagsins:

{
  "execution_config_skill": {
    "preferredProvider": "gemini",
    "capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
  }
}

preferredProvider og preferredModel eru óskir sem beinirinn virðir aðeins þegar skipulagið hefur þá veitu virka og með skilríkjum. capabilityProfile síar og velur aldrei; dataResidency hennar (eu_only, us_only eða any) er ófrávíkjanleg skorða sem beinirinn uppfyllir eða hafnar. Að sleppa þeim öllum er yfirleitt rétt. modelOverride er til fyrir þá sjaldgæfu færni sem þarf eitt tiltekið líkan, og það gerir óskirnar við hlið þess óvirkar; ég myndi forðast það nema færnin sé merkingarlaus á öllum öðrum líkönum.

Þegar viðmótið þitt þarf að sýna hvaða líkan beinirinn myndi nota skaltu lesa það, ekki spá fyrir um það:

import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";

createAIRouteClient(...).effectiveRoute() er eini viðurkenndi lesturinn á AI Provider Router. Hann tekur vistfang gáttarinnar, eigin handhafatóka kallandans og auðkennisslóð verkvangsins þíns, og sendir enga gervigreindarbeiðni. Hann svarar með veitu og líkani, þeim veitum sem stefnan leyfir og hvort valinn endapunktur keyrir local eða external. Þegar leiðin er ekki nothæf svarar hann með höfnun beinisins í orðum (NO_PROVIDER_FOR_ROLE, MODEL_CAPABILITY_UNAVAILABLE eða NO_MODEL_FOR_ROLE_AND_PROVIDER, ásamt úrbótum), aldrei sjálfgefnu líkani. Sýndu einstaklingnum þá höfnun; þar talar uppsetning skipulags hans.

Leyfisathuganir

Þrjú kerfi athuga leyfi, á þremur stigum.

Réttindi sem tilgreina leyfi. Einfaldast. Í skilgreiningarskránni bera réttindi licence: "<feature>" og vörðurinn spyr auðkennisþjónustuna hvort leyfi skipulagsins beri það, með eigin tóka kallandans, áður en nokkurt hlutverk er lesið. Byggðu vörðinn með lesara:

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 }) },
});

Leyfi sem ber ekki eiginleikann hafnar öllum með LICENCE_LOCKED, tilgreinir hvað ber hann og segir að eigendur og stjórnendur skipulagsins geti virkjað hann. Leyfi sem ekki er hægt að lesa hafnar með UNHANDLED_ERROR: læstur eiginleiki er aldrei veittur vegna þess að ekki náðist í leyfið. Svör eru geymd í 30 sekúndur fyrir hvert skipulag og hvern eiginleika.

Vöruhliðið. createProductGate({ baseUrl, product }) úr runtime/product-gate spyr réttindaathugunina hvort skipulag kallandans hafi vöruna þína yfirleitt, og middleware() þess keyrir á eftir umfangsverðinum. Neikvæður úrskurður er ENTITLEMENT_DENIED; athugun sem ekki næst í er ENTITLEMENT_UNREACHABLE, og hliðið fer aldrei með annað sem hitt.

Leyfisskjalið sjálft. Kóði sem þarf að ákveða sjálfur út frá undirrituðu leyfinu, svo sem lokaða eining sviðspakka, notar verifyLicenceDocument(docText, opts) úr runtime/licence-document. Það er hrein aðgerð: ekkert netkall, engin umhverfisbreyta, engin skrá. Hún athugar báðar undirskriftirnar gagnvart traustrótunum sem smíðin ber og svarar með stöðu (VALID, WARN, GRACE, RESTRICT, TERMINATE eða ABSENT) ásamt heimildum, viðbótum og sviðspökkum. licenceAllows(verdict, featureGroup, action, tenantId?) segir síðan hvort þú megir use eða provision undir hópi. RESTRICT leyfir use og svarar provision með LICENCE_LOCKED, svo vinna í gangi heldur áfram og ekkert nýtt hefst.

Prófanir

Prófanir sniðmátsins sýna mynstrið; þetta eru verkfærin að baki því.

Umfangsgervingar. Byggðu staðgengil leysts umfangs einu sinni, í test/scope-fakes.ts, og settu hann inn alls staðar, þar á meðal í tilvikunum þar sem eitthvað vantar: engin eining, enginn tóki, tóki með núll-skipulagi. Höfnunarleiðirnar eru varan.

Gervisendingarflutningur. UnoClient tekur fetch, now og sleep, svo einingapróf snertir aldrei netið. Staðfestu reiti umslagsins, lögun 202, fyrirspurnir þar til lokaröð næst ásamt organization_id hennar, og að röð fyrir annan leigjanda sé felld út.

Raunverulegur Postgres. Gervifyrirspurnarfall sannreynir SQL-streng. Það getur ekki sannreynt að þvinguð raðaröryggisstýring haldi eða að skrárnar séu keyrðar í réttri röð sem flutningsforritið. testing/ephemeral-postgres ræsir einnota netþjón og keyrir sama nexus-migrate og keyrt er í framleiðslu:

import { EPHEMERAL_REMEDY, migrated, startEphemeralPostgres } from "@adverant-nexus/plugin-sdk/testing/ephemeral-postgres";

const pg = await startEphemeralPostgres();          // null off CI: skip each case by name with EPHEMERAL_REMEDY
const db = migrated(pg!, "plugin_test", { root });  // provision as the superuser, then every file as the migrator
// connect as db.appUrl and run the boot checks the server runs

Utan CI (samfelldrar samþættingar) sleppir vél án Postgres-netþjóns hverju gagnagrunnstilviki með nafni ásamt úrræðinu, aldrei sem grænt. Í CI veldur sami skortur því að prófunarsafnið fellur (EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI), því sleppt raðaröryggispróf er grænt hlið sem mældi ekkert. Netþjónninn bíður í allt að 180 sekúndur eftir ræsingu og varðhundur stöðvar hann þegar prófunarferlið hverfur.

Einangrunarprófunarbúnaðurinn. runIsolationHarness(target) úr testing/isolation-harness les hverja leið sem forritið yðar tengir og ræðst á hverja þeirra sem stjórnandi annarrar stofnunar og sem samstarfsmaður. Síðan ræðst hann aftur á þær með kóðagirðinguna fjarlægða, gagnagrunnsgirðinguna fjarlægða og báðar. Leið er PROVEN aðeins þegar árásin mistekst með aðra hvora girðinguna á sínum stað og nær gögnum fórnarlambsins þegar báðar eru fjarlægðar, svo að þér vitið að prófið geti yfirhöfuð greint leka. Hann sendir uppgefna fyrirspurn og dæmimeginmál hverrar leiðar, svo að leið sem hafnar tómri beiðni næst samt. Festið ledgerOf(report) í prófi og látið það falla á defectsOf(report).

Skráning: úr yfirlýsingaskrá í færniþáttaskrá

Færnir í upplýsingaskrá yðar berast í færniskrána eftir einni leið:

manifest.skills[]  →  compileRegistry(manifest)  →  POST /api/v1/plugins/sync

compileRegistry breytir staðfestri upplýsingaskrá í nexus.plugin-sync/v1-meginmálið. Sniðmátið gerir það við innflutning, svo að ógild upplýsingaskrá veldur því að smíðin fellur:

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" } ]
}

Samstillingin er yfirlýsingabundin: sendið allt færnisafnið í hvert sinn, og færni sem er sleppt er gerð óvirk, en saga hennar varðveitt. Hún er ströng: óþekktu sviði, sviði annars stigs eða null er hafnað, öll brot berast saman í einu 400 SYNC_CONTRACT_VIOLATION og ekkert er skrifað á meðan eitt er til staðar. Og hún skrifar eina skráarröð fyrir hverja færni, lyklaða á nafnrýmisbundnu verkgerðina, með hverjum dálki sem úthlutarinn les, svo að færnin er keyrsluhæf um leið og samstillingin svarar 200.

Viðbótin er auðkenndi kallandinn, aldrei svið í meginmáli. Kallið á samstillinguna úr vinnuálagi viðbótarinnar sjálfrar yfir mTLS (gagnkvæmt TLS: Transport Layer Security með skilríki á báðum endum). Skills Engine les biðlaraskilríki vinnuálags yðar, en SPIFFE-auðkenni þess (spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>) tilgreinir nafnrýmið og þjónustureikninginn, og flettir upp viðbótinni og eigandastofnuninni sem skráð eru fyrir það nafnrými. pluginId í meginmálinu verður að passa; það er athugun, ekki val. Sérhver röð er skrifuð með þeirri viðbót og stofnun.

Staða Kóði Merking
200 {contract, pluginId, version, created, updated, unchanged, disabled, skills}
400 SYNC_CONTRACT_VIOLATION Sérhvert brot talið upp í violations[]; ekkert skrifað
401 UNAUTHORIZED Ógildur eða vantandi þjónustulykill
401 CALLER_IDENTITY_UNVERIFIED Ekkert læsilegt biðlaraauðkenni
403 DELIVERY_IDENTITY_MISSING Kallandi nafnrými tilheyrir engri viðbót
403 PLUGIN_ID_MISMATCH Meginmálið tilgreinir aðra viðbót
409 REGISTRY_CONFLICT Verkgerð er í eigu annars staðar eða var skráð utan samstillingarinnar; ekkert skrifað

Látið uppsetningarskrefið falla á hvaða stöðu sem er önnur en 200. Engin önnur staða þýðir að færnir yðar séu skráðar.

Innleiðing

Innleiðing fer fram í tíu skrefum í ákveðinni röð, og hvert þeirra má keyra aftur, hætta við eða afturkalla sérstaklega:

  1. Klónið geymsluna og staðfestið hana.
  2. Þáttið upplýsingaskrána.
  3. Skannið hana fyrir öryggisvandamálum.
  4. Smíðið myndina.
  5. Sendið hana í skrá uppsetningarinnar.
  6. Setjið upp lén hennar.
  7. Dreifið henni um útgáfurásir uppsetningarinnar.
  8. Bíðið eftir heilbrigðisathuguninni.
  9. Skráið viðbótina.
  10. Látið forritarann vita.

Fyrir dreifingu eru keyrðar fimm samræmisathuganir gegn upplýsingaskránni og smíðuðu myndinni: upplýsingaskráin þáttast og inniheldur nauðsynleg svið; hver uppgefin leið er raunveruleg skráð leið; viðbótin á sitt eigið skema og skrifar ekkert utan þess; tilföngabeiðnir eru tilgreindar og innan marka; og myndin hefur virkan heilbrigðismeðhöndlara. Viðbót sem skráir sig sjálf við ræsingu keyrir sama samning undir eigin heimild, svo að athuganirnar verða CI hennar í stað leiðslunnar. Að sleppa einni styttir ekki innleiðinguna; það færir bilunina yfir á keyrslutíma.

Vörumerkjaefnið í upplýsingaskrá yðar er afhent án auðkenningar eftir léni, því innskráningarsíðan þarfnast þess áður en nokkur hefur skilríki. Lítið á allt í branding sem opinbert.

Umhverfi og tilfærsla milli umhverfa
Umhverfi og flutningur útgáfa milli umhverfa
Umhverfi og kynning flytur hverja útgáfu úr þróunarrýminu í gegnum prófunarumhverfi til tilraunaeiningar og síðan til allra eininga, með hvert hlið og stöðu þess á einni síðu. Kynningu sem sleppir hliði er hafnað með GATE_CANNOT_BE_SKIPPED.
Rásir og uppsetningar
Rásir og uppsetningar
Rásir og uppsetningar sýnir hvaða eining keyrir hvaða útgáfu, með villutíðni sem fjölda og aldrei innihald. Að færa eina einingu til baka er yfirfarin breyting sem snertir aðeins þá einingu.

Hvað keyrsluumhverfið mun ekki gera fyrir þig

Keyrsluumhverfið stendur vörð um einangrun, úthlutun og aðgang að líkönum. Það gerir vörurökfræði yðar ekki rétta og það gerir hæga fyrirspurn ekki hraða: sérhver skipun keyrir innan bundinnar færslu með þeim tímamörkum sem db-hluti upplýsingaskrár yðar tilgreinir, og skipun sem fer fram úr statementTimeoutMs er hætt, ekki beðið eftir henni. Stillið stærð fyrirspurna yðar í samræmi við það. Og samþykkisbiðin, lessætið og leyfislesarinn bæta hvert um sig við einni ferð fram og til baka eða færslu. Í frávikayfirferðarviðbót minni bætti leyfisathugunin við nokkrum millisekúndum á hverja beiðni þar til 30 sekúndna minni hennar var orðið heitt, sem var sanngjarnt verð fyrir að afhenda aldrei læstan eiginleika.