Versija 1.0.0-alpha.1jaunākā
2.22. nodaļa
Spraudņu izpildlaika vide
SDK (programmatūras izstrādes komplekta) moduļi, uz kuriem darbojas jūsu spraudnis — no tvēruma sarga un datubāzes nožogojuma līdz UNO nosūtīšanai, MI (mākslīgā intelekta) maršruta nolasīšanai un licenču pārbaudēm. Pēc tam — testēšana ar reālu datubāzi, prasmju reģistrēšana un ieviešana.
Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

SDK (programmatūras izstrādes komplekta) izpildlaika daļa ir moduļu kopums zem @adverant-nexus/plugin-sdk/runtime/*, kā arī testēšanas palīgrīki zem testing/*. Jūs tos importējat; jūs tos neīstenojat no jauna. Tāda ir pamatideja, un man vajadzēja vienu noraidītu koda pārbaudi, lai to uztvertu nopietni: recenzenta piezīme par mana pirmā spraudņa paša rakstīto tvēruma pārbaudi bija viena rindiņa — "SDK tas jau ir, un jūsējā pieņem MFA (daudzfaktoru autentifikācijas) izaicinājuma marķieri kā sesiju".
Šajā nodaļā tiek izsekots pieprasījums darbojošā spraudnī tā, kā to savieno pilna servisa veidne: tvēruma sargs, datubāzes nožogojums, vienīgā atļautā šķērsošana, nosūtīšana caur UNO, MI (mākslīgā intelekta) maršruta lasīšana un licenču pārbaudes. Pēc tam tajā ir aplūkota testēšana, manifesta prasmju reģistrēšana un ieviešanas soļi.
Tvērums: viens sargs katram ietvaram
Katram /api maršrutam ir tvēruma sargs. Tas verificē uzrādītāja marķieri, no tā nosaka trīs asis (nomnieku, īpašnieku, vienību), noraida pamattekstu, kurā nosaukts nomnieks, piemēro maršruta tiesības no manifesta reģistra un tikai pēc tam ļauj darboties apstrādātājam. SDK nodrošina pa vienam adapterim katram ietvaram, kas visi ir no @adverant-nexus/plugin-sdk/runtime/scope un pieņem vienādas opcijas.
| Ietvars | Adapteris |
|---|---|
| Express | scopeMiddleware |
| Fastify | requireScope, kā preHandler |
| Nākamā | withScope, aptverot apstrādātāju; Next apstrādātājam netiek paziņots tā maršruts, tāpēc withScope to pieņem kā trešo argumentu |
Šeit ir saīsināts veidnes Express savienojums. Verifikators ir no SDK, un tas pieprasa marķierim atbilstību identitātes servisa sesijas formātam: tikai HS256; iss, exp, iat un jti ir obligāti; derīguma termiņš nepārsniedz vienu stundu; un kā sesija netiek pieņemts neviens MFA izaicinājuma, uzdošanās par citu personu vai OAuth (atvērtā deleģētās autorizācijas standarta) resursa marķieris.
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)) });
});Tiesību sargs piemēro maršruta tiesības četros soļos. Loma, kas ir tiesību sarakstā never, noraida ar AUTHORITY_EXCEEDED un vārdiem barred, un neviena vieta to neatceļ. Loma sarakstā roles pieļauj piekļuvi, turklāt arī ar aktīvu vietu, ja tiesībās ir norādīts seat: true. Citādi piekļuvi pieļauj aktīva vieta, kurai ir šīs tiesības. Pretējā gadījumā pieprasījums tiek noraidīts ar AUTHORITY_EXCEEDED, nosaucot personas, kuras varētu piešķirt vietu. Piešķiriet sargam krātuvi (rights: { manifest, store: { pool, schema } }), un tas lasīs vietas paša izsaucēja tvērumā; tiesībām, kurās nosaukts licence, ir nepieciešams arī licences lasītājs, kas aprakstīts tālāk.
Apstrādātāja iekšienē scopeOf(req) ir vienīgais veids, kā nolasīt noteikto tvērumu, un tas izmet kļūdu, ja sargs nav darbojies. Sargs, kas reģistrēts prefiksam un darbojas pirms jebkura maršruta atbilstības, atbild ar 500 MIDDLEWARE_ORDERING_ERROR; maršruts, ko reģistrē jūsu kods, bet ko nedeklarē manifests, atbild ar 500 UNHANDLED_ERROR. Abi kļūmes gadījumā bloķē piekļuvi.
Veidnes /internal maršruti, kurus izsauc platforma, izmanto otru režīmu. Servisa sargs pārbauda X-Service-Key konstanta laika režīmā un paņem nomnieku no platformas X-Organization-ID, noraidot MISSING_SERVICE_KEY, INVALID_SERVICE_KEY vai MISSING_ORG_ID_HEADER. Platformas parakstītajam katra izsaukuma marķierim SDK ir requireService (Fastify) un serviceMiddleware (Express), kas arī pārbauda, kurai prasmei un maršrutam marķieris tika izveidots, un noraida divreiz izmantotu marķieri.
Datubāzes nožogojums: tenantFence un withScopedTx
Katrs priekšraksts pret tabulu ar noteiktu tvērumu veido nožogojumu un tiek izpildīts tvērumam piesaistītā transakcijā:
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) izveido predikātu un tā parametrus no noteiktā tvēruma. Padodiet owner personiskajām tabulām; izlaidiet to organizācijas artefaktiem, kur īpašnieks norāda izcelsmi. Ja priekšrakstam jau ir parametri, startIndex norāda nožogojumam, no kurienes sākt numerāciju. Ievietošana nekad nepieņem asis kā ievadi: tā ieraksta scope.tenant, scope.owner un scope.unit no tvēruma.
withScopedTx piesaista visas trīs asis vienai transakcijai, izmantojot shēmas vienīgo piesaistes funkciju, un pēc tam palaiž jūsu atpakaļizsaukumu. Otrā piesaiste tajā pašā transakcijā izraisa SCOPE_ALREADY_BOUND (500: jūsu kods veica piesaisti divreiz; izsaucējs neko nav izdarījis nepareizi). Iztrūkstošs vai nulles nomnieks vai īpašnieks izraisa SCOPE_PREDICATE_INVALID (403). Iestatījums ir lokāls transakcijai, tāpēc pūla savienojums nevar pārnest vienu nomnieku uz nākamo pieprasījumu.
Divas radniecīgas funkcijas aptver gadījumus, kas nav personas pieprasījumi. withTenantScopedTx piesaista nomnieku un vienību bez īpašnieka rindām, kuras lasa mašīna (ierīču reģistrs), un noraida tvērumu, kurā ir īpašnieks. maintenanceScope(reason) liek visas organizācijas mēroga darbībai skaidri paziņot, kas tā ir, pirms tiek atvērta īpašnieka transakcija. Koda nožogojums un piespiedu rindu līmeņa drošība ir divi mehānismi vienam likumam; palaišanas pārbaude atsakās klausīties, līdz datubāze pierāda, ka otrais ir spēkā (pretējā gadījumā DB_ROLE_BYPASSES_ISOLATION).
Katrs atteikums ir ieraksts
Veidne vienu reizi starp pamatteksta parsētāju un maršrutētājiem uzstāda vēl vienu starpprogrammatūras posmu: noraidījumu virsgrāmatu.
import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";
app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));Tā aptver atbildi tā, lai katrs noraidījums, ko persona nolasa — vai tas būtu no tiesību sarga, apstrādātāja vai krātuves —, pirms pamatteksta nosūtīšanas tiktu ierakstīts jūsu shēmas tabulā refusal šīs personas pašas tvēruma transakcijā. Anonīms 401 neieraksta neko. Ja rindu nevar ierakstīt, atbilde kļūst par UNHANDLED_ERROR: "nē", ko produkts nevar reģistrēt, netiek nosūtīts tā, it kā tas būtu reģistrēts. Palaišanas laikā tiek izpildīts assertRefusalLedger, lai pārbaudītu, vai tabula var pieņemt virsgrāmatas rindu, un krātuve var izsaukt noteSubject({ recordId, isDemo }), lai katrā noraidījumā būtu nosaukts ieraksts, uz kuru tas attiecās. Kad klients jautā, kāpēc kāds pagājušajā otrdienā tika noraidīts, atbilde ir vaicājums, nevis minējums.
Vienīgā robežas šķērsošana: reģistrēta tikai lasāma atļauja
Kad viens no jūsu klientiem veic darbu citam un otrs drīkst to pārbaudīt, pastāv viens sankcionēts veids, kā šķērsot robežu. Organizācija, kurai pieder rindas, reģistrē piešķīrumu. Lasītāja organizācija pielaiž personu caur vietu, kurai ir tiesības granted.read, kurām sarakstā never ir jānosauc owner un admin. Lasīšana notiek kā sestajai datubāzes lomai — lasīšanas vietai, kas var atlasīt tikai tās tabulas, kuras uzskaita 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 vispirms ieraksta apskati paša lasītāja nomniekā, pēc tam piesaista lasīšanas vietu piešķīrumam, kas ieraksta apskati turētāja nomniekā. Pašas datubāzes politika pārbauda, vai piešķīrumā ir nosaukta lasītāja organizācija, vai tas aptver tabulu, ir sācies, nav beidzies un nav atsaukts, un vai šī transakcija ir ierakstījusi savu apskati. Lasīšana, kas izlaiž apskates ierakstīšanu, neredz neko. Palaišanas laikā assertSeatAtBoot(seatPool, schema) pārbauda, vai no seat.url atvērtais pūls patiešām ir šī vieta un nekas vairāk, un pretējā gadījumā noraida ar DB_SEAT_ROLE_INVALID.
Nosūtīšana caur UNO
Visi aprēķini notiek caur vienu klientu, kas izveidots vienā failā ar slēgtu atļauto sarakstu:
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,
});
}Atļauto saraksts ar nolūku ir moduļa līmeņa konstante. Ja operators varētu to paplašināt no konfigurācijas, maršruts kļūtu par nosūtīšanas starpniekserveri visam reģistram. Pašas veidnes tests apgalvo, ka sarakstā ir nosaukti tieši tie uzdevumu veidi, kuros kompilējas manifests.
aploksne
Nosūtīšana tās obligātajā kodolā satur sešus laukus. Klients aizpilda nomnieku un izpildītāju no verificētā tvēruma, nekad no pieprasījuma:
| Lauks | Ko tas satur |
|---|---|
jobType |
Nosaukumvietas uzdevuma veids, <plugin name>.<skill id> |
organizationId |
Nomnieks, no tvēruma |
userId |
Izpildītājs, no tvēruma, revīzijai un norēķiniem |
inputParams |
Prasmes ievade. Tā nekad nesatur nomnieka id; ievade, kurā tas ir, nosūtīšanas laikā tiek noraidīta |
priority |
critical, high, normal vai low |
pluginId |
Jūsu manifesta name. Katra nosūtīšana deklarē savu izcelsmes spraudni |
Neobligātie lauki ietver correlationId (UUID (universāli unikālo identifikatoru), vai arī tiek izveidots jauns) un callbackUrl, kas ir nepieciešams plugin_queue prasmei, lai izpildītājs zinātu, kur nosūtīt savu rezultātu.
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, pēc tam aptauja
Katra nosūtīšana tiek ievietota rindā. Atbilde vienmēr ir 202 ar identifikatoriem (jobId, runId, traceId, status), nekad rezultāts. Rezultāts tiek iegūts, aptaujājot uzdevumu vai no jūsu atpakaļizsaukuma. uno.peek(jobId, { scope }) nolasa to vienreiz, un awaitJob veic aptauju līdz gala statusam; abi nosūta nomnieku no verificētā tvēruma, un abi pārbauda atgrieztās rindas organization_id atbilstību izsaucēja nomniekam jūsu tīkla izsaukuma pusē, noraidot neatbilstību ar SCOPE_REFUSED.
Lasiet izpildes rindu tās pašas pareizrakstībā. Nosūtīšanas atbildē ir teikts jobId; rindā ir teikts job_id, organization_id un plugin_id. Rezultāta un kļūmes kolonnas ir result, error, error_code un error_troubleshooting. completed un failed ir gala statusi. timed_out, cancelled un system_failure nāk no tīrītāja, un novēlots rezultāts joprojām var tos izlabot. Klients, kas jebkuru no tiem uzskata par neparsējamu, noraida rindas, kuras platforma raksta katru dienu.
Apstiprināšanas aizturēšana
Manifesta prasme, kas deklarē approval, nosūtīšanas laikā tiek aizturēta. Tad 202 saka status: "awaiting_approval" un satur waitpointId ar iemeslu, ko norādīja manifests. Izpilde paliek aizturēta, līdz nosauktā persona pieņem lēmumu par to. uno.approve un uno.resolveWaitpoint nosūta nomnieku un izsaucēju kā izpildītāju, un lēmums, ko pieņēmis kāds cits, nevis verificētais izsaucējs, tiek noraidīts. Apstiprinājums vienreiz atbrīvo uzdevumu un vēlreiz palaiž nosūtīšanas pārbaudes; noraidījums to izbeidz ar failed. Otrs lēmums tiek noraidīts, tāpat kā lēmums pēc aizturēšanas termiņa beigām. Ja jūsu produktam ir nepieciešams, lai apstiprinātājs būtu cita persona nekā iesniedzējs, nodrošiniet to maršrutā, kas pieņem lēmumu: platforma reģistrē abus.
Attēlojiet aizturētu uzdevumu kā aizturētu. Nesakiet personai, ka tās klikšķis to ir atbrīvojis, kamēr izpildes rinda tā nesaka.
MI: vēlmes prasmes ierakstā un viena nolasīšana
Jūsu spraudnis nekad neizsauc modeli. Kad manifesta prasmei tāds ir nepieciešams (llm_only vai tool_using, uzticamības līmenī core vai verified), jūs paužat preferences tās reģistra rindā, un maršrutētājs pieņem lēmumu no pašas organizācijas pūla:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
}
}preferredProvider un preferredModel ir vēlmes, kuras maršrutētājs ievēro tikai tad, ja organizācijai šis pakalpojumu sniedzējs ir iespējots un nodrošināts ar akreditācijas datiem. capabilityProfile filtrē un nekad neatlasa; tā dataResidency (eu_only, us_only vai any) ir stingrs ierobežojums, ko maršrutētājs izpilda vai noraida. Parasti ir pareizi tos visus izlaist. modelOverride pastāv retajām prasmēm, kurām nepieciešams viens konkrēts modelis, un tas padara blakus esošās vēlmes neaktīvas; es no tā izvairītos, ja vien prasme nav bezjēdzīga jebkurā citā modelī.
Kad jūsu saskarnei ir jāparāda, kuru modeli izmantotu maršrutētājs, nolasiet to, nevis prognozējiet:
import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";createAIRouteClient(...).effectiveRoute() ir vienīgā sankcionētā lasīšana no MI pakalpojumu sniedzēju maršrutētāja. Tā pieņem vārtejas adresi, paša izsaucēja uzrādītāja marķieri un jūsu platformas īso identifikatoru, un nenosūta MI pieprasījumu. Tā atbild ar pakalpojumu sniedzēju un modeli, politikas atļautajiem pakalpojumu sniedzējiem un to, vai izvēlētais galapunkts darbojas local vai external. Kad maršruts nav lietojams, tā atbild ar maršrutētāja noraidījumu vārdos (NO_PROVIDER_FOR_ROLE, MODEL_CAPABILITY_UNAVAILABLE vai NO_MODEL_FOR_ROLE_AND_PROVIDER, ar novēršanas norādījumiem), nekad ar noklusējuma modeli. Parādiet šo noraidījumu personai; tā runā viņu organizācijas konfigurācija.
Licenču pārbaudes
Trīs mehānismi pārbauda licencēšanu trīs detalizācijas līmeņos.
Tiesības, kurās nosaukta licence. Visvienkāršākais. Manifestā tiesībām ir licence: "<feature>", un sargs ar paša izsaucēja marķieri jautā identitātes servisam, vai organizācijas licencē tas ir iekļauts, pirms tiek nolasīta jebkura loma. Izveidojiet sargu ar lasītāju:
import { createLicenceReader } from "@adverant-nexus/plugin-sdk/runtime/licence";
const requireScope = scopeMiddleware({
verify,
rights: { manifest, store: { pool, schema: SCHEMA }, licence: createLicenceReader({ baseUrl: config.NEXUS_AUTH_URL }) },
});Licence, kurā nav šīs funkcijas, noraida visus ar LICENCE_LOCKED, nosaucot to, kurā tā ir iekļauta, un norādot, ka organizācijas īpašnieki un administratori var to ieslēgt. Licence, ko nevar nolasīt, noraida ar UNHANDLED_ERROR: bloķēta funkcija nekad netiek apkalpota tāpēc, ka licence nebija sasniedzama. Atbildes tiek saglabātas atmiņā 30 sekundes katrai organizācijai un funkcijai.
Produkta vārti. createProductGate({ baseUrl, product }) no runtime/product-gate jautā tiesību pārbaudei, vai izsaucēja organizācijai vispār ir jūsu produkts, un tā middleware() darbojas pēc tvēruma sarga. Negatīvs verdikts ir ENTITLEMENT_DENIED; pārbaude, ko nevar sasniegt, ir ENTITLEMENT_UNREACHABLE, un vārti nekad neuzskata vienu par otru.
Pats licences dokuments. Kods, kuram pašam jāpieņem lēmums no parakstītās licences, piemēram, domēna pakotnes slēgtais modulis, izmanto verifyLicenceDocument(docText, opts) no runtime/licence-document. Tā ir tīra funkcija: bez tīkla izsaukuma, bez vides mainīgā, bez faila. Tā pārbauda abus parakstus pret uzticamības saknēm, kas ir būvējumā, un atbild ar stāvokli (VALID, WARN, GRACE, RESTRICT, TERMINATE vai ABSENT) kopā ar piešķīrumiem, papildinājumiem un domēna pakotnēm. Pēc tam licenceAllows(verdict, featureGroup, action, tenantId?) pasaka, vai jūs drīkstat veikt use vai provision zem grupas. RESTRICT atļauj use un atbild uz provision ar LICENCE_LOCKED, tāpēc iesāktais darbs turpinās un nekas jauns nesākas.
Testēšana
Veidnes testi parāda modeli; šie ir rīki, kas ir tā pamatā.
Tvēruma imitācijas. Izveidojiet noteiktā tvēruma dublikātu vienu reizi iekš test/scope-fakes.ts un ievadiet to visur, ieskaitot iztrūkstošos gadījumus: nav vienības, nav marķiera, marķieris ar nulles organizāciju. Noraidīšanas ceļi ir pats produkts.
Imitēts nosūtīšanas transports. UnoClient pieņem fetch, now un sleep, tāpēc vienību tests nekad neskar tīklu. Pārbaudiet aploksnes laukus, 202 formu, aptauju līdz gala rindai ar tās organization_id un to, ka rinda citam nomniekam tiek atmesta.
Īsts Postgres. Imitēta vaicājuma funkcija pārbauda SQL virkni. Tā nevar pierādīt, ka piespiedu rindu līmeņa drošība ir spēkā vai ka faili tiek piemēroti tādā secībā, kā to dara migrētājs. testing/ephemeral-postgres palaiž vienreizlietojamu serveri un izpilda to pašu nexus-migrate, ko produkcijas vide:
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Ārpus CI (nepārtrauktās integrācijas) mašīna bez Postgres servera izlaiž katru datubāzes gadījumu pēc nosaukuma, norādot risinājumu, un nekad nav zaļa. CI vidē šis pats iztrūkums izraisa testu kopas kļūmi (EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI), jo izlaists rindu līmeņa drošības tests ir zaļie vārti, kas neko nav izmērījuši. Serveris gaida līdz 180 sekundēm, lai palaistos, un sargsuņa process to aptur, kad testa process beidzas.
Izolācijas testēšanas ietvars. runIsolationHarness(target) no testing/isolation-harness nolasa katru maršrutu, ko pievieno jūsu lietotne, un uzbrūk katram no tiem kā citas organizācijas administrators un kā kolēģis. Pēc tam tas uzbrūk vēlreiz ar noņemtu koda nožogojumu, noņemtu datubāzes nožogojumu un abiem. Maršruts ir PROVEN tikai tad, ja uzbrukums neizdodas, kad ir uzstādīts jebkurš no nožogojumiem, un sasniedz upura datus, kad abi ir noņemti, lai jūs zinātu, ka tests vispār spēj pamanīt noplūdi. Tas nosūta katra maršruta deklarēto vaicājumu un pamatteksta piemēru, tāpēc maršruts, kas noraida tukšu pieprasījumu, tik un tā tiek sasniegts. Nostipriniet ledgerOf(report) testā un iestatiet kļūmi pie defectsOf(report).
Reģistrācija: no manifesta līdz prasmju reģistram
Jūsu manifesta prasmes sasniedz prasmju reģistru pa vienu ceļu:
manifest.skills[] → compileRegistry(manifest) → POST /api/v1/plugins/sync
compileRegistry pārvērš validētu manifestu par nexus.plugin-sync/v1 pamattekstu. Veidne to dara importēšanas laikā, tāpēc nederīgs manifests izraisa būvējuma kļūmi:
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" } ]
}Sinhronizācija ir deklaratīva: katru reizi nosūtiet visu prasmju kopu, un izlaistā prasme tiek atspējota, saglabājot tās vēsturi. Tā ir stingra: nezināms lauks, cita līmeņa lauks vai null tiek noraidīts, visi pārkāpumi tiek atgriezti kopā vienā 400 SYNC_CONTRACT_VIOLATION, un nekas netiek ierakstīts, kamēr pastāv kaut viens pārkāpums. Un tā ieraksta vienu reģistra rindu katrai prasmei ar nosaukumvietas uzdevuma veidu kā atslēgu, iekļaujot katru kolonnu, ko lasa nosūtītājs, tāpēc prasme ir izpildāma brīdī, kad sinhronizācija atbild ar 200.
Spraudnis ir autentificētais izsaucējs, nekad pamatteksta lauks. Izsauciet sinhronizāciju no sava spraudņa darba slodzes, izmantojot mTLS (abpusējo TLS: transporta slāņa drošību ar sertifikātu abos galos). Skills Engine nolasa jūsu darba slodzes klienta sertifikātu, kura SPIFFE identitātē (spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>) ir nosaukta nosaukumvieta un servisa konts, un atrod šai nosaukumvietai reģistrēto spraudni un īpašnieka organizāciju. Pamatteksta pluginId ir jāsakrīt; tā ir pārbaude, nevis atlasītājs. Katra rinda tiek ierakstīta ar šo spraudni un organizāciju.
| Statuss | Kods | Nozīme |
|---|---|---|
| 200 | {contract, pluginId, version, created, updated, unchanged, disabled, skills} |
|
| 400 | SYNC_CONTRACT_VIOLATION |
Katrs pārkāpums uzskaitīts iekš violations[]; nekas nav ierakstīts |
| 401 | UNAUTHORIZED |
Slikta vai iztrūkstoša servisa atslēga |
| 401 | CALLER_IDENTITY_UNVERIFIED |
Nav nolasāmas klienta identitātes |
| 403 | DELIVERY_IDENTITY_MISSING |
Izsaucošā nosaukumvieta nepieder nevienam spraudnim |
| 403 | PLUGIN_ID_MISMATCH |
Pamattekstā ir nosaukts cits spraudnis |
| 409 | REGISTRY_CONFLICT |
Uzdevuma veids pieder citur vai tika reģistrēts ārpus sinhronizācijas; nekas nav ierakstīts |
Pārtrauciet izvietošanas soli ar kļūmi pie jebkura statusa, izņemot 200. Neviens cits statuss nenozīmē, ka jūsu prasmes ir reģistrētas.
Ieviešana
Ieviešana notiek kā desmit secīgi soļi, no kuriem katru var atsevišķi palaist atkārtoti, atcelt vai atritināt:
- Klonēt repozitoriju un validēt to.
- Parsēt manifestu.
- Skenēt to, meklējot drošības problēmas.
- Izveidot attēlu.
- Nosūtīt to uz instalācijas reģistru.
- Iestatīt tā domēna vārdus.
- Izvietot to, izmantojot instalācijas laidienu kanālus.
- Sagaidīt darbspējas pārbaudi.
- Reģistrēt spraudni.
- Paziņot izstrādātājam.
Pirms izvietošanas pret manifestu un izveidoto attēlu tiek veiktas piecas atbilstības pārbaudes: manifests tiek parsēts un satur obligātos laukus; katrs deklarētais maršruts ir reāls reģistrēts maršruts; spraudnim pieder tā shēma un tas neko neraksta ārpus tās; resursu pieprasījumi ir deklarēti un iekļaujas robežās; un attēlam ir strādājošs darbspējas apstrādātājs. Spraudnis, kas sevi reģistrē palaišanas laikā, izpilda to pašu līgumu savā autoritātē, tāpēc pārbaudes kļūst par tā CI, nevis konveijera. Vienas pārbaudes izlaišana nesaīsina ieviešanu; tā pārvieto kļūmi uz izpildlaiku.
Jūsu manifestā esošais zīmolvedības saturs tiek pasniegts bez autentifikācijas pēc domēna, jo pierakstīšanās lapai tas ir nepieciešams, pirms jebkuram ir akreditācijas dati. Uzskatiet visu iekš branding par publisku.
GATE_CANNOT_BE_SKIPPED.Ko izpildlaika vide jūsu vietā nedarīs
Izpildlaiks stingri uztur izolāciju, nosūtīšanu un piekļuvi modeļiem. Tas nepadarīs jūsu produkta loģiku pareizu un nepadarīs lēnu vaicājumu ātru: katrs priekšraksts darbojas piesaistītā transakcijā ar noildzēm, ko deklarē jūsu manifesta bloks db, un priekšraksts, kas pārsniedz statementTimeoutMs, tiek atcelts, nevis gaidīts.Pielāgojiet savu vaicājumu apjomu tam. Turklāt apstiprināšanas aizturēšana, lasīšanas vieta un licences lasītājs visi pievieno tīkla izsaukumu turp un atpakaļ vai transakciju. Manā anomāliju pārskatīšanas spraudnī licences pārbaude pievienoja dažas milisekundes katram pieprasījumam, līdz tās 30 sekunžu atmiņa iesila, kas bija godīga cena par to, lai nekad neapkalpotu bloķētu funkciju.

