Različica 1.0.0-alpha.1najnovejša
Poglavje 2.27
Scenariji izdelave
Zbirka trinajstih receptov za izdelavo, od posamezne veščine do dostave v izolirano okolje (air-gapped). Vsak recept podaja cilj, gradnike, korake in ukaze, kontrolno točko, ki dokazuje uspešnost, ter razlike glede na izdajo in obliko dostave.
To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

To so recepti, po katerih posežem, ko nekdo v podjetju Corrán Orbital ali pri stranki reče »želimo, da Nexus naredi X«. Vsak je namenoma kratek. Utemeljitev korakov je v poglavjih pred tem: poglavje 2.20, Veščine, in poglavje 2.21, Plugin SDK, ki obravnava komplet za razvoj programske opreme, nato poglavje 2.23, Domenski paketi, in tri poglavja za njim o gradnji. Tukaj dobite cilj, katere gradnike uporabiti, korake, ukaze, vrata, ki vam povedo, da je uspelo, ter opombe o izdaji in dostavi.
Vrata so najpomembnejša. Recept je končan, ko so njegova vrata zelena. Vsaka vrata v tem poglavju so nekaj, kar lahko zaženete sami ali kar platforma zažene namesto vas, in vsaka se končajo z izhodno kodo, različno od nič, ali zavrnejo s kodo, kadar pogoj ni izpolnjen.
| Scenarij | Glavni gradnik | Vrata, ki to dokazujejo | Izdaja |
|---|---|---|---|
| Nova veščina Skills Engine | Paket SKILL.md |
skill:validate brez napak |
Community in Enterprise |
Veščina v manifestu z host_callback |
Manifest vtičnika skills[] |
create-nexus-plugin validate in nexus-gates |
Community in Enterprise |
| Razširitev obstoječega paketa | pack.json z inherits |
Preverjanje pravilnika leč na pilotnih vratih | Enterprise in licenca za paket |
| Nov paket od začetka | Zlata pot domenskega paketa | Vrata za staging in pilot | Enterprise |
| Podatkovni povezovalnik | Veščina plugin_queue |
validate, nexus-gates, zavrnitev izhodnega prometa |
Community in Enterprise |
| Orodje MCP (Model Context Protocol) | Manifest mcpTools[] |
validate (brez kombinatorjev na najvišji ravni) |
Community in Enterprise |
| Spletna trgovina pod lastno blagovno znamko | Manifest domains in branding |
Javno pravilo scope-adherence |
Enterprise in dodatek Storefront |
| Misijski paket za Edge | Misijski paket | Testni primeri na napravi, dva od treh podpisov | Enterprise in dodatek Nexus Edge |
| Dostava v izolirano okolje (air-gapped) | Zapečateni sveženj | nexus-airgap verify |
Enterprise |
| Modul samo za Enterprise | @adverant/nexus-spi |
Vrata licenčne meje, gradnje izdaj | Enterprise |
| Razcepitev ali razširitev odprtega jedra | Izvorna koda Community | Testi, lint in preverjanje tipov | Community |
| Oblačna aplikacija za izdajo Team | Izdajateljski gručni sistem | Podpisana izdaja, pregled, dodelitev stranki | Team |
| Ovijanje obstoječe interne aplikacije | /plugin-create |
migrate, validate, nexus-gates |
Community in Enterprise |
1. Nova veščina za Skills Engine
Cilj je navodilo za večkratno uporabo, ki ga lahko izvajajo asistent, agenti, poteki dela in razvojna orodja, na primer preverjanje carinske prijave glede na njena pravila. Vaši gradniki so paket SKILL.md v mapi, poimenovani po veščini, izbirni skill.yaml za sprožilce in oznake ter izbirna mapa scripts/, priložena zraven.
- Ustvarite
skills/<slug>/in napišiteSKILL.mds frontmatter:name(kebab-case, enako imenu mape),description(do 500 znakov),allowed-toolster po željitriggers,capabilitiesinversion. - Napišite telo za model: kdaj uporabiti veščino, njene korake, primere in česa nikoli ne sme storiti.
- Dodajte testne primere. Vključite enega z navodilom, podtaknjenim v vhodne podatke, ki mu veščina ne sme slediti.
- Preverite, preglejte načrt nalaganja, nato naložite.
- Objavite. Veščina, ki doda orodje za pisanje, je zadržana, dokler je ne odobrita dve imenovani osebi s ključi za dostop (passkey), predlagatelj pa svoje spremembe ne more odobriti.
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing --dry-run
npm run skill:upload skills/check-a-customs-filingVrata so skill:validate, ki mora poročati nič napak, preden je mogoče karkoli objaviti. Blokirajoče napake so manjkajoče ime ali opis ter podvojen slug ali vrsta opravila. Nalaganje že objavljene vsebine vrne obstoječo različico (CONTENT_HASH_ALREADY_PUBLISHED), zato je nalaganje varno ponoviti.
Community dobi celoten ustvarjalnik, knjižnico, različice, vračanje na prejšnje, uvoz in teste. Na Enterprise objava poteka tudi skozi senčni in kanarski način: odobrena različica teče v senci, nato za eno enoto za imenovanimi vrati, nato za vse, in se sama ustavi, če vrata niso izpolnjena. Pri stranki v izoliranem okolju veščine potujejo vnaprej podpisane v zapečatenem svežnju (scenarij 9).
2. Manifestna veščina s funkcijo host_callback
Cilj je deterministično računanje v vašem lastnem vtičniku, ki ga platforma lahko odpošlje, na primer odprtje zapisa o odstopanju na podlagi odčitka. Uporabili boste vrstico v skills[] manifesta s stopnjo host_callback in pot /internal v vašem zaledju, zaščiteno s storitvenim varovalom SDK.
- Deklarirajte veščino:
idv lower_snake,tier: "host_callback",classificationna ali pod mejo zaupanja vašega vtičnika,inputSchema,outputSchemaintimeoutMsmed 1 sekundo in 6 urami. - Izpolnite
hostCallback: ime lastne storitve (Service), njena vrata, relativno pot, kot je/internal/skills/excursion_open, obe omejitvi bajtov (maxRequestBytesinmaxResponseBytes) tertenantHeader: "X-Organization-ID". - Deklarirajte pot v
api.endpoints[]zauth: "service-key"aliauth: "internal"in jo zaščitite zrequireServicealiserviceMiddleware, nikoli z varovalom uporabniškega obsega. - Preverite, zaženite vrata in pustite, da uvajanje sinhronizira veščine v register prek
compileRegistry. SQL za register nikoli ne pišete ročno.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testvalidate uporabi lastna pravila sinhronizacije registra, preden se karkoli sinhronizira, in vsako kršitev zavrne s kodo prejemnika. Pot s shemo, // ali poševnico nazaj je zavrnjena kot navzkrižnoizvorna. Manjkajoča omejitev bajtov je ENDPOINT_BYTE_CAP_REQUIRED, polje iz druge stopnje je FIELD_NOT_FOR_TIER, časovna omejitev zunaj obsega pa TIMEOUT_OUT_OF_BOUNDS. Nato nexus-gates preveri, da ima pot /internal storitveno varovalo in je deklarirana kot internal ali service-key. Ta par vrat je dokaz.
Sinhronizacija je deklarativna. Vsakič pošljite celoten nabor veščin, ker je veščina, ki jo izpustite, onemogočena, in naj korak uvajanja spodleti ob vsakem statusu, ki ni 200. Na Enterprise se sinhronizacija vtičnika preveri v celoti: če ena veščina krši pravilo, ni sprejet noben del te sinhronizacije (PLUGIN_SYNC_ALL_OR_NOTHING) in prejšnja različica teče naprej. Vtičnik z zaupanjem community ne more uporabljati stopenj, ki dosežejo model, tool_using in llm_only; ti zahtevata zaupanje core ali verified.
3. Razširitev obstoječega paketa
Cilj je nova panoga ali podpanoga, ki ponovno uporabi večino obstoječega paketa, na primer posojila in spori pri karticah na osnovi oblike paketa Insurance. Gradnik je pack.json, ki v inherits navede svojega starša in doda le lastne skupine leč in besede.
- Paket začnite z zlato potjo domenskega paketa, nato nastavite
inheritsna id starševskega paketa. - Dodajte lastne skupine
lens, vsako z njenimi sedeži, namenom in sklicem na leksikon. - Dodajte svoje besede v leksikon, vsako s preprosto razlago. Izraz označite z
exact, kjer mora biti prikazan tako, kot je zapisan. - Namesto risanja lastnih leč ponovno uporabite skupne: režim, ki ga potrebuje več paketov, na primer register zunanje izvajane tehnologije, je ena skupna leča.
- Preverite licenčno verigo. Vaš paket podeduje zahteve za dodatke svojega starša.
- Predoglejte si vsako lečo kot oseba na sintetični veji.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Dokaz je preverjanje pravilnika na pilotnih vratih, ki potrdi, da vsaka leča le zožuje svojo osnovo in da so osebna polja privzeto izklopljena. Leča, ki poskuša prikazati, kar njena osnova skriva, je zavrnjena z LENS_CANNOT_WIDEN. Na strani licenciranja konzola zavrne izdajo licence za vaš paket brez dodatkov, ki jih potrebuje njegov starš; paket Insurance potrebuje sobe za odločanje in zapečatene zapise.
Domenski paketi so Enterprise in se licencirajo po paketu. Zasloni paketa za telefon potrebujejo tudi dodatek za mobilne aplikacije. Podrejeni paket ne more spremeniti lupine, komponent ali pravil pisanja.
4. Nov paket od začetka
Cilj je pogled ene panoge na Nexus: njen model znanja, leče za vsako vlogo, dokazila, ki jih zahtevajo njena pravila, in vtičnik, ki ohranja njene podatke ažurne. Poglavje 2.24, Gradnja vertikale po meri od začetka do konca, to gradnjo opiše v celoti; tukaj je kratka oblika.
- Zaženite zlato pot domenskega paketa in opišite paket: namen, enote, osnovni model in pravila, ki jih preslikuje.
- Zgradite model znanja na osnovnem modelu in vsako lastnost razvrstite, ko jo dodate.
- Preberite načrt, potrdite njegov prstni odtis s ključem za dostop in ustvarite.
- Oblikujte leče v graditelju leč, vsako kot zožitev osnovne leče.
- Napišite vtičnik in vse veščine Skills Engine, ki jih paket potrebuje.
- Ustvarite sintetične podatke s semenom, ki vključujejo nenavadne primere, ki so za vas pomembni, in si predoglejte vsako lečo kot oseba.
- Napredujte iz razvojnega prostora v staging, v pilotno enoto in nato v vse enote.
Dokaz so vrata napredovanja: vsi testi uspešni na sintetičnih vejah za vstop v staging, nato dva pregledovalca, ki nista avtor, nato 14 dni v pilotu z napakami pod 1 na 1.000. Nobenega koraka ni mogoče preskočiti (GATE_CANNOT_BE_SKIPPED). Paketi so Enterprise. Na Community zlata pot domenskega paketa ni na voljo.
5. Podatkovni konektor
Cilj so podatki iz zunanjega sistema, ki po urniku tečejo v lastne tabele vašega vtičnika, na primer dogodki na vratih iz operacijskega sistema terminala. Gradniki so veščina plugin_queue, delavec, ki prevzema iz vaše vrste, migracija za ciljno tabelo in izhodni naslov, deklariran v manifestu.
- Deklarirajte veščino
plugin_queuezqueueName, zapisanim kot<plugin name>.<name>. Dvopičje ni dovoljeno, ime pa mora biti v manifestu, ker ga orkestrator neposredno uvršča v vrsto. - Napišite delavca, ki prevzema iz vrste in kliče zunanji sistem.
- Naslov zunanjega sistema deklarirajte kot izhodni naslov. Vse, kar ni navedeno, je blokirano.
- Prispele podatke shranite v lastno shemo, z
organization_id,owner_user_idinbusiness_unit_idv vsaki vrstici. - Poverilnico zunanjega sistema preberite po imenu iz okolja in spremenljivko navedite v
scripts/ci/required-env. - Prevzeme odpošiljajte prek UNO, mehanizma za poteke dela, nikoli s časovnikom, ki neposredno kliče mehanizme.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only no-credentials --only no-direct-compute --only migrations-are-scoped
node scripts/ci/required-envvalidate preveri ime vrste in časovno omejitev glede na pravila sinhronizacije registra. Troje vrat dokazuje, da ni poverilnice za model, ni neposrednega računanja in je tabela ustrezno omejena. Pred potiskanjem zaženite celoten nexus-gates, saj --only zoži izvajanje in to navede v povzetku. Med izvajanjem se klic na naslov, ki ga manifest ni deklariral, ustavi na robu z EGRESS_NOT_DECLARED.
Lastni povezovalniki platforme za pogone, wikije, poštne shrambe in starejše sisteme, z zajemom sprememb in sledljivostjo izvora, so del dodatka Podatkovni povezovalniki. Povezovalnik, ki ga zgradite sami, je vtičnik in deluje v kateri koli izdaji. Dodajanje izhodnega naslova v kasnejši izdaji je razširitev, ki je zadržana, dokler je ne sprejmeta dva pregledovalca.
6. Orodje MCP
Cilj je orodje, ki ga lahko kličejo Claude Code, agenti in drugi odjemalci MCP (Model Context Protocol), na primer za iskanje zgodovine pregledov plovila. Gradnik je vnos v mcpTools[] manifesta z name, description in inputSchema.
- Orodje poimenujte in ga preprosto opišite. Opis je tisto, kar model prebere, da se odloči, ali ga bo poklical.
inputSchemanapišite kot eno objektno shemo. Na njeno najvišjo raven ne postavljajteoneOf,allOfalianyOf.- Pot, ki streže orodje, naj bo za varovalom obsega, kot vsaka druga pot
/api, tako da najemništvo izhaja iz žetona klicatelja. - Preverite manifest.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonDokaz je validate: kombinator na najvišji ravni je zavrnjen že ob pisanju, ker bi med izvajanjem povzročil, da orodje odpove za vsakega podagenta MCP, ki ga uvozi, in orodje bi obstajalo, ne da bi ga kdorkoli mogel poklicati.
Na Enterprise je vsako orodje, ki ga lahko kliče IDE (integrirano razvojno okolje), navedeno v katalogu orodij Workbench z njegovo stopnjo, podatkom, ali kaj spreminja, pripetim prstnim odtisom in vlogami, ki ga smejo uporabljati. Če se opis vašega orodja v novi izdaji spremeni, katalog orodje zadrži, dokler sprememb ne pregleda oseba. To je namerno: spremenjen opis je način, kako lahko orodje začne od modela zahtevati nekaj, česar ne bi smelo. Klic česar koli zunaj klicateljeve prepustnice je zavrnjen z CONNECTION_SCOPE_EXCEEDED.
7. Trgovina z lastno blagovno znamko (white-label)
Cilj je aplikacija, ki jo uporabljajo stranke vaše stranke, na domeni stranke in pod njeno blagovno znamko, brez sledi Adverant. Gradniki so bloka domains in branding v manifestu, pomočniki SDK za prijavo in dodatek Storefront / white-label stranke.
- Domeno stranke vnesite v
domains[]kotprimary, skupaj z morebitnimialiases. - Izpolnite
branding:appName,tagline,primaryColor,accentColor,passkeyRpId, enak domeni, inoauthClientRef. - Prijavo oseb izvedite prek pomočnikov SDK za prijavo in natančno deklarirajte njune dve javni poti, z
auth: "public"inallowAnonymous: true. - Vsak klic sprednjega dela pošljite prek posredniškega strežnika s seznamom dovoljenih (backend for frontend). Naslova storitve nikoli ne vstavite v odjemalca.
- Plačila prepustite skrbniku stranke, ki poveže plačilne prehode in nastavi blagovno označeno blagajno.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractDokaz je scope-adherence. Nezaščiteno pot /api dopusti le, kadar manifest natančno to metodo in pot deklarira kot javno in je pot ena od poti za prijavo; vsaka druga javna deklaracija spodleti in navede obe dovoljeni poti. api-contract nato primerja deklarirane poti z dejanskimi v obeh smereh. definePlugin zavrne tudi frontend.basePath, ki ni relativna pot z istim izvorom.
Bela oznaka (white-label) je dodatek Storefront / white-label v izdaji Enterprise, ki licencira tudi plačila. Podatki o karticah nikoli ne pridejo v Nexus. Blagovna znamka je v lasti skrbnika stranke, platforma pa jo razbere iz organizacije in ne iz vaše kode.
8. Misijonski paket Edge
Cilj je nova ali posodobljena misija za satelit ali dron, ki poganja Nexus Edge, na primer dodajanje adapterja za iskanje ladij misiji pomorskega nadzora. Gradnik je paket misije, ki je zgrajen in podpisan na tleh.
- Začnite s trenutnim paketom na strani Izdelava paketa misije, ki novo različico pripravi iz stare in označi vsako spremembo.
- Spremenite samo tisto, kar misija potrebuje. Velike dele, jezikovni model in ontologijo, po možnosti ohranite nespremenjene.
- Na vsakem koraku poslabšanega delovanja preverite tabelo razporeditve, da vsaka plošča še vedno ustreza temu, kar izvaja.
- Testne primere paketa za izvajanje na krovu zaženite na preizkusni postavitvi z enakimi ploščami.
- Pošljite ga v podpis: potrebna sta dva od treh podpisov.
- Izdajte ga za eno platformo. Namesti se v nedejavno režo in se vklopi šele, ko njegovi testni primeri uspešno prestanejo preizkus na krovu.
- Po tednu dni brez težav ga uvedite na naslednji platformi.
Ta recept ne vsebuje ukazov; izvede se na straneh Nexus Edge v konzoli. Dokaz so testni primeri na krovu, ki morajo vsi uspešno prestati preizkus, preden se paket vklopi, ter oba podpisa. Če preizkus na krovu ne uspe, platforma ostane na prejšnjem paketu, napaka pa se prenese ob naslednjem preletu. Namestitev paketa na strojno opremo, za katero ni bil preverjen, je zavrnjena z PACK_NOT_CHECKED_FOR_HARDWARE.
Nexus Edge je dodatek, licenciran na platformo ali na floto. Paketi ostanejo veljavni, tudi ko platforma ni dosegljiva. Povezava navzgor je ozka, zato velikosti načrtujte glede na to: naša izdaja 1.5 je imela 412 MB, paket z novim jezikovnim modelom pa 9.8 GB.
9. Dostava stranki v izolirano okolje (air-gapped)
Cilj je vtičnik ali paket, nameščen pri stranki brez omrežja. Gradniki so zapečateni sveženj iz @adverant/nexus-sovereign, vaš ključ za podpisovanje izdaj in lastni kanali izdaj stranke.
- Vtičnik in njegove slike zgradite povsem enako kot za povezano stranko, pri čemer morajo biti vsa preverjanja uspešna.
- S profilom
airgapustvarite zapečateni sveženj, ki vsebuje slike, migracije, vnaprej podpisane veščine in SBOM (seznam programskih komponent) z licencami. - Podpišite ga s svojim ključem za izdaje Ed25519.
- Sami ga preverite na čistem računalniku.
- Sveženj pošljite na nosilcu podatkov, svoj javni ključ in SHA-256 svežnja pa pošljite po ločeni poti.
- Operater stranke preveri sveženj z vašim ključem in nato izdajo uvede prek svojih kanalov izdaj.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle zgradi sveženj iz vaše konfiguracije svežnja. Dokaz je nexus-airgap verify na strani stranke. Ponovno izračuna zgoščeno vrednost vsake datoteke, zavrne vsako datoteko, ki je ni v manifestu, zahteva zaupanja vrednega podpisnika in zavrne sveženj, katerega seznam dovoljenih omrežnih naslovov ni prazen. Spremenjena datoteka povzroči napako BUNDLE_INTEGRITY_VIOLATION. Nihče ne sme nikoli izklopiti strogega preverjanja, da bi to obšel.
Namestitve brez omrežne povezave so del izdaje Enterprise. Nič v svežnju ne sme ob namestitvi ničesar prenašati, model, ki ga vtičnik potrebuje, pa pride s strankinega lastnega strežnika modelov prek usmerjevalnika ponudnikov UI (umetne inteligence).
10. Modul samo za izdajo Enterprise
Cilj je zaprta, licencirana zmogljivost, ki se priključi na odprto jedro, na primer revizijska sled z dolgim hranjenjem, ki se prodaja samo strankam izdaje Enterprise. Gradnik je paket vmesnikov @adverant/nexus-spi in nič drugega iz izdaje Community.
- V svojem repozitoriju hranite bajtno pripeto kopijo zgrajenega paketa vmesnikov kot lokalni paket
file:z njegovo pripetostjoSHA256SUMS. - Na njegovi podlagi napišite
RouteModule(aliScreenModuleza zaslone konzole) s skupino funkcij, ki ji služi. - Vsako pot izvajajte za
ctx.requireScopein pred odgovorom preverite lastno dovoljenje modula. - Kadar organizacija nima pravice, zavrnite z
LICENCE_LOCKEDin prikažite predstavitev funkcije, nikoli pa njenih podatkov. - Repozitorij uskladite z licenčno mejo, nato zgradite sestavljeno drevo za vsako izdajo.
npm ci
npm test
npm run buildDokaz je pravilo licenčne meje: noben uvoz iz obsega Community razen paketa vmesnikov, noben relativni uvoz zunaj repozitorija in nobena odvisnost file:, link: ali workspace: zunaj njega. Nato morajo trije zgoraj navedeni ukazi uspešno delovati v sestavljenem drevesu vsake izdaje, ne le v vašem delovnem drevesu. Poglavje 2.25, Gradnja za posamezno izdajo, vsebuje ogrodje modula.
Modul se ob zagonu naloži v storitev Community v namestitvah, katerih licenca vključuje njegovo skupino funkcij. Brez tega dovoljenja zavrne delovanje, zato se ista gradnja dostavlja povsod in ne naredi ničesar tam, kjer ni licencirana.
11. Razcep ali razširitev odprtega jedra
Cilj je sprememba same izdaje Community, ki jo ohranite v svoji razvejitvi ali prispevate nazaj. Gradnik je izvorna koda Community pod licenco Apache License, Version 2.0.
- Razvejite repozitorij in ustvarite vejo iz
main. - Če je to, kar želite, mogoče izvesti kot vtičnik ali veščino, raje izberite to. Spremembo jedra morate vzdrževati sami ob vsaki izdaji.
- Spremembo izvedite s testi, ki brez nje ne uspejo.
- Preden karkoli predlagate, zaženite preverjanja, ki jih izvaja projekt.
- Ohranite datoteko NOTICE in Adverantovih imen ali blagovnih znamk ne uporabljajte za nič drugega kot za navedbo izvora dela.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckDokaz so ta tri uspešna preverjanja ter dokaz, da vsak nov test pred vašo spremembo ni uspel. V svoji razvejitvi ohranite eno lastnost odprtega jedra: Community izvaja agenta od začetka do konca na lokalnem modelu brez ključa in brez omrežja. Sprememba, ki to pokvari, pokvari tisto, zaradi česar je Community uporaben samostojno.
To velja samo za Community. Vse, kar mora ostati zaprto, sodi v modul Enterprise (scenarij 10), da licenčna meja ostane na mestu, na katerega lahko pokaže vsakdo.
12. Oblačna aplikacija za izdajo Team
Cilj je aplikacija, ki jo lahko namestijo stranke izdaje Team. Team deluje samo v oblaku Adverant, zato aplikacija do njih pride samo prek kataloga. Gradnika sta vtičnik in založniška gruča: vaša lastna navidezna gruča v oblaku Adverant z vzorčnimi podatki.
- Gradite in preizkušajte v založniški gruči, samo z vzorčnimi podatki.
- V manifestu aplikacije navedite vse, kar potrebuje, in nič več.
- Izdajte jo podpisano, za Adverantov pregled in uvrstitev v katalog.
- Vsaka stranka jo namesti in vsak navedeni obseg odobri za vsako enoto posebej.
Dokaz je dvodelen. Podpisana in pregledana izdaja vas pripelje v katalog. Nato odobritev stranke določi, do česa lahko aplikacija dostopa pri njej, vsak klic, ki ga ni navedla, pa je zavrnjen z CONNECTION_SCOPE_EXCEEDED. Manjkajoči obseg lahko dodate samo v novi izdaji, ki jo stranka pregleda.
Založniška gruča nima poti do nobene stranke, zahteva po podatkih stranke pa je tam zavrnjena z TENANT_BOUNDARY. Stranke lahko z vami delijo rezultate testov, nikoli pa svojih podatkov. Team vključuje zmogljivost operacij delovnih tokov, zato lahko stranke izdaje Team, če vaša aplikacija vsebuje delovne tokove, te same prenašajo med okolji.
13. Ovijanje obstoječe interne aplikacije kot vtičnika
Cilj je aplikacija, ki jo vaše podjetje že uporablja, prenesena v Nexus, da podeduje prijavo, izolacijo in upravljanje. Gradniki so veščina /plugin-create za prvi osnutek ter orodja za manifest in preverjanja iz SDK za dokončanje.
- Zaženite
/plugin-createz repozitorijem. Analizira kodo in izbere strategijo ovijanja, nato ustvari zaledje, migracije, uporabniški vmesnik (UI), manifest in teste. - Manifest dvignite na pogodbo v2.
migratedoda tri stavke zakona in premaknedomainvdomains[], pri čemer zavrne izmišljanje vstopne točke. - Vsako vrednost najemnika, ki jo ovojnica bere iz glav, zamenjajte z zaščito obsega iz SDK.
- Vsaki tabeli dodajte
organization_id,owner_user_idinbusiness_unit_ids primarnimi ključi, ki se začnejo z najemnikom. - Vsako pot navedite z njeno pravico in namestite evidenco zavrnitev.
- Preverjanja izvajajte, dokler niso vsa uspešna.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin migrate nexus.manifest.json --write
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testDokaz je izhod nexus-gates s kodo 0, pri čemer so scope-adherence, one-fence, migrations-are-scoped, crud-adherence in api-contract vsi uspešni. Pričakujte, da bo prvi zagon pri večini neuspešen; naš je vse poti označil kot brez obsega, ker je osnutek zaupal glavam, ki jih lahko nastavi brskalnik. Preverjanja namenoma nimajo stikala za popravljanje.
Ovite aplikacije delujejo v kateri koli izdaji. Uvajanje poteka samo prek kanalov izdaj namestitve, zato prezrite vse datoteke za uvajanje, ki jih je napisal osnutek. Največ časa vzame delo na izolaciji: pri resnični aplikaciji računajte na dneve, ne na ure.


