Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.22
Izvršno okruženje dodatka
Moduli kompleta SDK (komplet za razvoj softvera) na kojima se vaš dodatak izvršava, od čuvara dosega i ograde baze podataka do UNO otpreme, čitanja AI (umjetna inteligencija) rute i provjera licencija. Zatim testiranje na stvarnoj bazi podataka, registracija vaših vještina i uvođenje u rad.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Izvršni dio SDK-a (komplet za razvoj softvera) skup je modula pod @adverant-nexus/plugin-sdk/runtime/*, uz pomoćne alate za testiranje pod testing/*. Uvozite ih; ne implementirate ih ponovno. To je cijela poanta, a trebala mi je jedna odbijena revizija da to shvatim ozbiljno: napomena recenzenta na moju ručno pisanu provjeru opsega u prvom dodatku bila je jedna rečenica, „SDK to već ima, a vaša prihvaća token izazova za MFA (višefaktorska autentifikacija) kao sesiju”.
Ovo poglavlje prati zahtjev kroz aktivni dodatak, onako kako ga povezuje predložak cjelovite usluge: čuvar opsega, ograda baze podataka, jedini dopušteni prijelaz, otprema putem sustava UNO, čitanje rute za AI (umjetnu inteligenciju) i provjere licenci. Zatim obrađuje testiranje, registraciju vještina iz vašeg manifesta i korake uvođenja.
Doseg: jedan čuvar po radnom okviru
Svaka /api ruta nosi čuvara opsega. On verificira bearer token, iz njega razrješava tri osi (zakupac, vlasnik, jedinica), odbija tijelo zahtjeva koje imenuje zakupca, primjenjuje pravo rute iz registra manifesta i tek tada dopušta izvođenje rukovatelja. SDK isporučuje po jedan adapter za svaki radni okvir, sve iz @adverant-nexus/plugin-sdk/runtime/scope i sve s istim opcijama.
| Radni okvir | Adapter |
|---|---|
| Express | scopeMiddleware |
| Fastify | requireScope, kao preHandler |
| Next | withScope, koji omata rukovatelja; Next rukovatelju nije poznata njegova ruta, pa je withScope prima kao treći argument |
Evo skraćenog prikaza Express povezivanja u predlošku. Verifikator pripada SDK-u i obvezuje token na format sesije usluge identiteta: isključivo HS256; obavezni iss, exp, iat i jti; životni vijek od najviše sat vremena; i nijedan token izazova za MFA, token za oponašanje niti token resursa za OAuth (otvoreni standard za delegiranu autorizaciju) ne priznaje se kao sesija.
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)) });
});Čuvar prava primjenjuje pravo rute u četiri koraka. Uloga na popisu never tog prava odbija zahtjev uz AUTHORITY_EXCEEDED i riječi barred, i nijedno mjesto to ne može poništiti. Uloga u roles dopušta pristup, uz aktivno mjesto kada pravo nalaže seat: true. U suprotnom, aktivno mjesto koje nosi to pravo dopušta pristup. Inače se zahtjev odbija uz AUTHORITY_EXCEEDED, uz navođenje osoba koje bi mogle dodijeliti mjesto. Ako čuvaru proslijedite spremište (rights: { manifest, store: { pool, schema } }), on čita mjesta pod vlastitim opsegom pozivatelja; pravo koje navodi licence također treba čitač licenci, što je opisano u nastavku.
Unutar rukovatelja, scopeOf(req) je jedini način za čitanje razriješenog opsega i izbacuje iznimku ako se čuvar nije izvršio. Čuvar registriran na prefiksu, koji se izvršava prije podudaranja bilo koje rute, odgovara s 500 MIDDLEWARE_ORDERING_ERROR; ruta koju vaš kod registrira, a manifest je ne deklarira, odgovara s 500 UNHANDLED_ERROR. Oba slučaja završavaju zatvaranjem pristupa (fail closed).
Rute /internal iz predloška, koje poziva platforma, koriste drugi režim. Čuvar usluge provjerava X-Service-Key u konstantnom vremenu i preuzima zakupca iz platforminog X-Organization-ID, odbijajući MISSING_SERVICE_KEY, INVALID_SERVICE_KEY ili MISSING_ORG_ID_HEADER. Za platformin potpisani token po pozivu SDK nudi requireService (Fastify) i serviceMiddleware (Express), koji također provjeravaju za koju je vještinu i rutu token izdan te odbijaju dvaput upotrijebljen token.
Ograda baze podataka: tenantFence i withScopedTx
Svaki upit nad tablicom s definiranim opsegom sastavlja ogradu i izvršava se unutar transakcije ograničene opsegom:
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) gradi predikat i njegove parametre iz razriješenog opsega. Proslijedite owner za osobne tablice; izostavite ga za organizacijske artefakte gdje vlasnik predstavlja podrijetlo. Kada upit već ima parametre, startIndex govori ogradi od kojeg broja treba početi numeriranje. Unos (insert) nikada ne prima osi kao ulazne podatke: on zapisuje scope.tenant, scope.owner i scope.unit iz opsega.
withScopedTx veže sve tri osi za jednu transakciju putem jedinstvene funkcije vezanja u shemi, a zatim pokreće vaš povratni poziv (callback). Drugo vezanje u istoj transakciji podiže SCOPE_ALREADY_BOUND (500: vaš je kod izvršio vezanje dvaput; pozivatelj nije učinio ništa pogrešno). Odsutan ili nulti zakupac ili vlasnik podiže SCOPE_PREDICATE_INVALID (403). Postavka je lokalna za transakciju, tako da dijeljena veza iz spremnika ne može prenijeti jednog zakupca u sljedeći zahtjev.
Dvije srodne funkcije pokrivaju slučajeve koji nisu zahtjevi osoba. withTenantScopedTx veže zakupca i jedinicu bez vlasnika, za retke koje čita stroj (registar uređaja), i odbija opseg koji nosi vlasnika. maintenanceScope(reason) zahtijeva da operacija na razini cijele organizacije izričito navede što je prije nego što se transakcija vlasnika uopće otvori. Ograda u kodu i prisilna sigurnost na razini redaka (RLS) dva su mehanizma za jedan zakon; provjera pri pokretanju odbija slušati dok baza podataka ne dokaže da drugi mehanizam vrijedi (u suprotnom DB_ROLE_BYPASSES_ISOLATION).
Svako odbijanje je jedan redak
Predložak instalira još jedan posrednički sloj (middleware), jednom, između parsera tijela zahtjeva i usmjerivača: knjigu odbijanja.
import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";
app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));Ona omata odgovor tako da se svako odbijanje koje osoba pročita, bilo od čuvara prava, rukovatelja ili spremišta, zapiše u tablicu refusal vaše sheme unutar vlastite transakcije te osobe ograničene opsegom prije slanja tijela odgovora. Anonimni 401 ne zapisuje ništa. Ako se redak ne može zapisati, odgovor postaje UNHANDLED_ERROR: „ne” koje proizvod ne može evidentirati ne šalje se kao da je evidentirano. Pri pokretanju izvršava se assertRefusalLedger kako bi se provjerilo može li tablica primiti redak knjige, a spremište može pozvati noteSubject({ recordId, isDemo }) tako da svako odbijanje imenuje zapis na koji se odnosilo. Kada korisnik pita zašto je netko prošlog utorka bio odbijen, odgovor je upit u bazu, a ne nagađanje.
Jedini prijelaz: zabilježeno odobrenje samo za čitanje
Kada jedan od vaših korisnika obavlja posao za drugoga, a taj drugi to smije pregledati, postoji jedan odobreni način prelaska granice. Organizacija koja drži retke bilježi odobrenje. Organizacija čitatelja propušta osobu putem mjesta koje nosi pravo granted.read, koje mora navesti owner i admin u never. Čitanje se izvršava kao šesta uloga baze podataka, mjesto za čitanje, koje može odabrati (select) samo tablice koje databases[].granted navodi:
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 prvo zapisuje uvid kod vlastitog zakupca čitatelja, a zatim veže mjesto za čitanje uz odobrenje, što zapisuje uvid kod zakupca nositelja. Vlastita politika baze podataka provjerava navodi li odobrenje organizaciju čitatelja, pokriva li tablicu, je li započelo, nije li isteklo i nije li povučeno, te je li ova transakcija zapisala svoj uvid. Čitanje koje preskoči zapisivanje uvida ne vidi ništa. Pri pokretanju, assertSeatAtBoot(seatPool, schema) provjerava je li spremnik veza otvoren iz seat.url doista mjesto za čitanje i ništa više, a u suprotnom odbija rad uz DB_SEAT_ROLE_INVALID.
Otprema putem sustava UNO
Sva obrada ide kroz jednog klijenta, izgrađenog u jednoj datoteci, sa zatvorenim popisom dopuštenih stavki:
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,
});
}Popis dopuštenih stavki namjerno je konstanta na razini modula. Kada bi ga operater mogao proširiti iz konfiguracije, ruta bi postala posrednik za otpremu za cijeli registar. Vlastiti test predloška potvrđuje da popis navodi točno one vrste poslova u koje se manifest kompilira.
Omotnica
Otprema u svojoj obaveznoj jezgri nosi šest polja. Klijent popunjava zakupca i izvršitelja iz verificiranog opsega, nikada iz zahtjeva:
| Polje | Što sadrži |
|---|---|
jobType |
Vrsta posla s prostorom imena, <plugin name>.<skill id> |
organizationId |
Zakupac, iz opsega |
userId |
Izvršitelj, iz opsega, za reviziju i naplatu |
inputParams |
Ulazni podaci vještine. Nikada ne nose identifikator zakupca; onaj koji ga nosi biva odbijen pri otpremi |
priority |
critical, high, normal ili low |
pluginId |
Vaš name iz manifesta. Svaka otprema deklarira izvorni dodatak |
Neobavezna polja uključuju correlationId (UUID (univerzalno jedinstveni identifikator), ili se izdaje novi) i callbackUrl, koji je potreban vještini plugin_queue kako bi radni proces znao kamo poslati 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, a zatim prozivanje (polling)
Svaka se otprema stavlja u red čekanja. Odgovor je uvijek 202 s identifikatorima (jobId, runId, traceId, status), nikada rezultat. Rezultat dolazi prozivanjem posla ili iz vašeg povratnog poziva. uno.peek(jobId, { scope }) ga čita jednom, a awaitJob proziva do konačnog statusa; oba šalju zakupca iz verificiranog opsega i oba provjeravaju organization_id vraćenog retka u odnosu na zakupca pozivatelja na vašoj strani mrežnog poziva, odbijajući nepodudaranje uz SCOPE_REFUSED.
Čitajte redak izvođenja u njegovom izvornom obliku zapisa. Odgovor na otpremu kaže jobId; redak kaže job_id, organization_id i plugin_id. Stupci rezultata i pogreške su result, error, error_code i error_troubleshooting. completed i failed su konačni statusi. timed_out, cancelled i system_failure dolaze od čistača (reaper), a zakašnjeli ih rezultat još uvijek može ispraviti. Klijent koji bilo što od toga tretira kao nemoguće za parsiranje odbija retke koje platforma zapisuje svaki dan.
Zadržavanje radi odobrenja
Vještina iz manifesta koja deklarira approval zadržava se pri otpremi. 202 tada glasi status: "awaiting_approval" i nosi waitpointId, s razlogom koji je naveo manifest. Izvođenje ostaje zadržano dok imenovana osoba ne donese odluku o njemu. uno.approve i uno.resolveWaitpoint šalju zakupca i pozivatelja kao izvršitelja, a odluka nekoga tko nije verificirani pozivatelj biva odbijena. Odobrenje jednom oslobađa posao i ponovno pokreće provjere otpreme; odbijanje ga završava uz failed. Druga odluka se odbija, kao i odluka nakon isteka zadržavanja. Ako vaš proizvod zahtijeva da odobravatelj bude različita osoba od predlagatelja, nametnite to u ruti koja donosi odluku: platforma bilježi oboje.
Prikažite zadržani posao kao zadržan. Nemojte osobi reći da ga je njezin klik oslobodio dok redak izvođenja to ne potvrdi.
AI: želje u retku vještine i jedno čitanje
Vaš dodatak nikada ne poziva model. Kada je vještini iz manifesta potreban model (llm_only ili tool_using, na razini povjerenja core ili verified), izražavate preferencije u njezinom retku registra, a usmjerivač odlučuje iz vlastitog spremnika organizacije:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
}
}preferredProvider i preferredModel su želje koje usmjerivač poštuje samo kada organizacija ima omogućenog tog pružatelja usluga i unesene vjerodajnice. capabilityProfile filtrira i nikada ne odabire; njegov dataResidency (eu_only, us_only ili any) čvrsto je ograničenje koje usmjerivač ili zadovoljava ili odbija. Izostavljanje svih njih obično je ispravan pristup. modelOverride postoji za rijetku vještinu koja treba jedan točno određeni model i čini ostale želje uz njega neaktivnima; izbjegavao bih ga osim ako vještina nema smisla ni na jednom drugom modelu.
Kada vaše sučelje treba prikazati koji bi model usmjerivač upotrijebio, pročitajte to, nemojte predviđati:
import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";createAIRouteClient(...).effectiveRoute() je jedino odobreno čitanje komponente AI Provider Router. Prima adresu pristupnika, vlastiti bearer token pozivatelja i oznaku (slug) vaše platforme te ne šalje nikakav AI zahtjev. Odgovara vraćanjem pružatelja usluga i modela, pružatelja koje politika dopušta te informacije o tome izvršava li se odabrana krajnja točka kao local ili external. Kada ruta nije upotrebljiva, odgovara tekstualnim odbijanjem usmjerivača (NO_PROVIDER_FOR_ROLE, MODEL_CAPABILITY_UNAVAILABLE ili NO_MODEL_FOR_ROLE_AND_PROVIDER, uz upute za otklanjanje problema), a nikada zadanim modelom. Prikažite to odbijanje osobi; to progovara konfiguracija njezine organizacije.
Provjere licencija
Tri mehanizma provjeravaju licenciranje, na tri razine granulacije.
Pravo koje navodi licencu. Najjednostavnije. U manifestu pravo nosi licence: "<feature>", a čuvar pita uslugu identiteta nosi li licenca organizacije to pravo, s vlastitim tokenom pozivatelja, prije čitanja bilo koje uloge. Izgradite čuvara s čitačem:
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 koja ne nosi značajku odbija sve uz LICENCE_LOCKED, navodeći što je nosi i govoreći da je vlasnici i administratori organizacije mogu uključiti. Licenca koja se ne može pročitati odbija pristup uz UNHANDLED_ERROR: zaključana se značajka nikada ne poslužuje zato što je licenca bila nedostupna. Odgovori se pamte 30 sekundi po organizaciji i značajci.
Vrata proizvoda. createProductGate({ baseUrl, product }) iz runtime/product-gate pita provjeru ovlaštenja posjeduje li organizacija pozivatelja uopće vaš proizvod, a njegov se middleware() izvršava nakon čuvara opsega. Negativna odluka je ENTITLEMENT_DENIED; provjera do koje se ne može doći je ENTITLEMENT_UNREACHABLE, a vrata nikada ne tretiraju jedno kao drugo.
Sam dokument licence. Kod koji mora samostalno odlučiti na temelju potpisane licence, kao što je zatvoreni modul domenskog paketa, koristi verifyLicenceDocument(docText, opts) iz runtime/licence-document. To je čista funkcija: nema mrežnog poziva, nema varijable okruženja, nema datoteke. Provjerava oba potpisa u odnosu na korijene povjerenja koje nosi izgrađena verzija (build) i vraća stanje (VALID, WARN, GRACE, RESTRICT, TERMINATE ili ABSENT) s odobrenjima, dodacima i domenskim paketima. licenceAllows(verdict, featureGroup, action, tenantId?) zatim govori smijete li izvršiti use ili provision pod grupom. RESTRICT dopušta use i na provision odgovara s LICENCE_LOCKED, tako da se započeti rad nastavlja, a ništa novo ne pokreće.
Testiranje
Testovi predloška pokazuju obrazac; ovo su alati iza njega.
Lažni objekti opsega. Izgradite dvojnika razriješenog opsega jednom, u test/scope-fakes.ts, i ubrizgajte ga posvuda, uključujući slučajeve odsutnosti: bez jedinice, bez tokena, token s nultom organizacijom. Putanje odbijanja čine proizvod.
Lažni transport otpreme. UnoClient prima fetch, now i sleep, tako da jedinični test nikada ne dotiče mrežu. Potvrdite polja omotnice, oblik 202, prozivanje do konačnog retka s njegovim organization_id te da se redak za drugog zakupca odbacuje.
Pravi Postgres. Lažna funkcija upita dokazuje SQL niz znakova. Ne može dokazati da prisilna sigurnost na razini redaka drži ili da se datoteke primjenjuju redoslijedom kao u migratoru. testing/ephemeral-postgres pokreće jednokratni poslužitelj i izvršava iste nexus-migrate koje izvršava i 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 runsIzvan CI-ja (kontinuirana integracija), stroj bez Postgres poslužitelja preskače svaki testni slučaj baze podataka po imenu uz uputu za rješenje, i nikada ne prolazi zeleno. U CI-ju ista odsutnost ruši skup testova (EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI), jer je preskočeni test sigurnosti na razini redaka zelena prolazna točka koja nije izmjerila ništa. Poslužitelj čeka do 180 sekundi na pokretanje, a nadzorni proces (watchdog) zaustavlja ga kada testni proces nestane.
Sklop za testiranje izolacije. runIsolationHarness(target) iz testing/isolation-harness čita svaku rutu koju vaša aplikacija montira i napada svaku od njih kao administrator druge organizacije i kao kolega. Zatim ponovno napada s uklonjenom ogradom u kodu, uklonjenom ogradom baze podataka i s obje uklonjene. Ruta je PROVEN samo kada napad ne uspije dok je bilo koja ograda na mjestu, a dosegne podatke žrtve kada su obje uklonjene, tako da znate da test uopće može uočiti curenje podataka. Šalje deklarirani upit i primjer tijela za svaku rutu, tako da se dosegne i ruta koja odbija prazan zahtjev. Fiksirajte ledgerOf(report) u testu i srušite test na defectsOf(report).
Registracija: od manifesta do registra vještina
Vještine iz vašeg manifesta stižu u registar vještina jednim putem:
manifest.skills[] → compileRegistry(manifest) → POST /api/v1/plugins/sync
compileRegistry pretvara validirani manifest u tijelo nexus.plugin-sync/v1. Predložak to radi pri uvozu, tako da neispravan manifest ruši izgradnju (build):
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" } ]
}Sinkronizacija je deklarativna: svaki put pošaljite cijeli skup vještina, a izostavljena vještina se onemogućuje, uz zadržavanje njezine povijesti. Stroga je: nepoznato polje, polje druge razine ili null bivaju odbijeni, sva kršenja vraćaju se zajedno u jednom 400 SYNC_CONTRACT_VIOLATION i ništa se ne zapisuje dok postoji ijedno kršenje. Zapisuje jedan redak registra po vještini, s ključem na vrsti posla s prostorom imena, noseći svaki stupac koji otpremnik čita, tako da je vještina spremna za izvođenje u trenutku kada sinkronizacija odgovori s 200.
Dodatak je autentificirani pozivatelj, nikada polje u tijelu zahtjeva. Pozovite sinkronizaciju iz vlastitog radnog opterećenja vašeg dodatka putem mTLS-a (uzajamni TLS: sigurnost transportnog sloja s certifikatom na oba kraja). Skills Engine čita klijentski certifikat vašeg radnog opterećenja, čiji SPIFFE identitet (spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>) imenuje prostor imena i račun usluge, te traži dodatak i vlasničku organizaciju zabilježene za taj prostor imena. pluginId u tijelu mora se podudarati; to je provjera, a ne selektor. Svaki se redak zapisuje s tim dodatkom i organizacijom.
| Status | Kod | Značenje |
|---|---|---|
| 200 | {contract, pluginId, version, created, updated, unchanged, disabled, skills} |
|
| 400 | SYNC_CONTRACT_VIOLATION |
Svako kršenje navedeno u violations[]; ništa nije zapisano |
| 401 | UNAUTHORIZED |
Neispravan ili nedostajući ključ usluge |
| 401 | CALLER_IDENTITY_UNVERIFIED |
Nema čitljivog identiteta klijenta |
| 403 | DELIVERY_IDENTITY_MISSING |
Prostor imena pozivatelja ne pripada nijednom dodatku |
| 403 | PLUGIN_ID_MISMATCH |
Tijelo zahtjeva navodi drugi dodatak |
| 409 | REGISTRY_CONFLICT |
Vrsta posla u vlasništvu je drugdje ili je registrirana izvan sinkronizacije; ništa nije zapisano |
Prekinite korak implementacije (deploy) kao neuspješan na svakom statusu osim 200. Nijedan drugi status ne znači da su vaše vještine registrirane.
Uvođenje u rad
Uvođenje se izvršava u deset poredanih koraka, od kojih se svaki može samostalno ponovno pokrenuti, otkazati ili vratiti na prethodno stanje:
- Klonirajte repozitorij i validirajte ga.
- Parsirajte manifest.
- Skenirajte ga radi sigurnosnih problema.
- Izgradite sliku (image).
- Pošaljite je (push) u registar instalacije.
- Postavite njezine nazive domena.
- Implementirajte je (deploy) kroz kanale izdanja instalacije.
- Pričekajte provjeru ispravnosti (health check).
- Registrirajte dodatak.
- Obavijestite razvojnog inženjera.
Prije implementacije izvršava se pet provjera sukladnosti nad manifestom i izgrađenom slikom: manifest se uspješno parsira i nosi svoja obavezna polja; svaka deklarirana ruta stvarna je registrirana ruta; dodatak je vlasnik svoje sheme i ne zapisuje ništa izvan nje; zahtjevi za resursima su deklarirani i unutar granica; i slika ima funkcionalan rukovatelj za provjeru ispravnosti. Dodatak koji se sam registrira pri pokretanju izvršava isti ugovor pod vlastitom ovlasti, pa te provjere postaju njegov CI umjesto CI-ja cjevovoda. Preskakanje jedne provjere ne skraćuje uvođenje; ono samo premješta pogrešku u vrijeme izvođenja.
Vizualni identitet (branding) u vašem manifestu poslužuje se bez autentifikacije prema domeni, jer je stranici za prijavu potreban prije nego što itko ima vjerodajnice. Tretirajte sve u branding kao javno.
GATE_CANNOT_BE_SKIPPED.Što izvršno okruženje neće učiniti umjesto vas
Izvršno okruženje čvrsto drži liniju obrane kod izolacije, otpreme i pristupa modelima. Ono neće učiniti logiku vašeg proizvoda ispravnom i neće učiniti spor upit brzim: svaki se upit izvršava unutar vezane transakcije s vremenskim ograničenjima koja deklarira blok db vašeg manifesta, a upit koji prekorači statementTimeoutMs se otkazuje, a ne čeka. Dimenzionirajte svoje upite u skladu s tim. Osim toga, zadržavanje radi odobrenja, mjesto za čitanje i čitač licenci dodaju po jedan mrežni krug (round trip) ili transakciju. Na mom dodatku za pregled anomalija provjera licence dodala je nekoliko milisekundi po zahtjevu dok se njezina 30-sekundna memorija nije zagrijala, što je bila poštena cijena za to da se zaključana značajka nikada ne posluži.

