Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.27
Smíðadæmi
Uppskriftabók með þrettán smíðum, allt frá stakra færni til neteinangraðrar afhendingar. Hver uppskrift lýsir markmiðinu, byggingareiningunum, skrefunum og skipununum, gáttinni sem sannreynir virknina og hvað breytist eftir útgáfu og afhendingarformi.
Þ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

Þetta eru uppskriftirnar sem ég gríp til þegar einhver hjá Corrán Orbital, eða hjá viðskiptavini, segir „við viljum að Nexus geri X“. Hver þeirra er stutt af ásettu ráði. Rökin að baki skrefunum eru í köflunum á undan þessum: kafla 2.20, Færni, og kafla 2.21, Plugin SDK, sem fjallar um hugbúnaðarþróunarsettið, síðan kafla 2.23, Lénspakkar, og köflunum þremur á eftir honum um smíði. Hér fáið þér markmiðið, hvaða byggingareiningar á að nota, skrefin, skipanirnar, hliðið sem sýnir að þetta tókst, og athugasemdir um útgáfur og afhendingu.
Hliðið skiptir mestu. Uppskrift er lokið þegar hlið hennar er grænt. Hvert hlið í þessum kafla er eitthvað sem þér getið keyrt eða eitthvað sem kerfið keyrir fyrir yður, og hvert þeirra hættir með útgangskóða annan en núll eða hafnar með kóða þegar því er ekki fullnægt.
| Atburðarás | Aðalbyggingareining | Hliðið sem sannar það | Útgáfa |
|---|---|---|---|
| Ný færni í Skills Engine | SKILL.md pakki |
skill:validate án nokkurra villna |
Community og Enterprise |
Færni í upplýsingaskrá með host_callback |
Upplýsingaskrá viðbótar skills[] |
create-nexus-plugin validate og nexus-gates |
Community og Enterprise |
| Útvíkkun á fyrirliggjandi pakka | pack.json með inherits |
Stefnuathugun linsa við tilraunahliðið | Enterprise og pakkaleyfi |
| Nýr pakki frá grunni | Gullna leiðin fyrir lénspakka | Hlið fyrir sviðsetningu og tilraunarekstur | Enterprise |
| Gagnatengi | plugin_queue færni |
validate, nexus-gates, höfnun á útleið |
Community og Enterprise |
| MCP-verkfæri (Model Context Protocol) | Upplýsingaskrá mcpTools[] |
validate (engir samsetningarvirkjar á efsta stigi) |
Community og Enterprise |
| Hvítmerkt netverslun | domains og branding í upplýsingaskrá |
scope-adherence regla um opinberar leiðir |
Enterprise og Storefront-viðbótin |
| Edge-leiðangurspakki | Leiðangurspakki | Prófunartilvik um borð, tvær af þremur undirskriftum | Enterprise og Nexus Edge-viðbótin |
| Afhending í loftrofnu umhverfi | Innsiglað safn | nexus-airgap verify |
Enterprise |
| Eining eingöngu fyrir Enterprise | @adverant/nexus-spi |
Hlið leyfislínu, útgáfusmíðar | Enterprise |
| Kvíslun eða útvíkkun á opna kjarnanum | Community-frumkóðinn | Prófanir, lint og tegundaathugun | Community |
| Skýjaforrit fyrir Team-útgáfu | Útgefandaklasi | Undirrituð útgáfa, yfirferð, heimild viðskiptavinar | Team |
| Innpökkun á fyrirliggjandi innra forriti | /plugin-create |
migrate, validate, nexus-gates |
Community og Enterprise |
1. Ný færni í Skills Engine
Markmiðið er endurnýtanleg fyrirmæli sem aðstoðarmaðurinn, umboðsmenn, verkflæði og þróunartól geta öll keyrt, til dæmis að athuga tollskýrslu gagnvart reglum hennar. Byggingareiningarnar eru SKILL.md pakki í möppu sem ber heiti færninnar, valfrjáls skill.yaml fyrir kveikjur og merki, og valfrjáls scripts/ mappa sem fylgir með.
- Búið til
skills/<slug>/og skrifiðSKILL.mdmeð forsíðugögnum:name(kebab-case, sama og heiti möppunnar),description(allt að 500 stafir),allowed-tools, og valfrjálsttriggers,capabilitiesogversion. - Skrifið meginmálið fyrir líkanið: hvenær nota á færnina, skref hennar, dæmi og hvað hún má aldrei gera.
- Bætið við prófunartilvikum. Hafið með eitt þar sem fyrirmælum hefur verið komið fyrir í inntakinu sem færnin má ekki fylgja.
- Staðfestið, skoðið upphleðsluáætlunina og hlaðið síðan upp.
- Birtið. Færni sem bætir við skrifverkfæri er haldið eftir þar til tveir tilgreindir einstaklingar samþykkja hana með aðgangslyklum, og sá sem leggur breytinguna til getur ekki samþykkt hana sjálfur.
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-filingHliðið er skill:validate, sem verður að skila engum villum áður en hægt er að birta nokkuð. Hamlandi villurnar eru heiti eða lýsing sem vantar og tvítekið slug eða verktegund. Upphleðsla efnis sem þegar hefur verið birt skilar fyrirliggjandi útgáfu (CONTENT_HASH_ALREADY_PUBLISHED), svo óhætt er að endurtaka upphleðsluna.
Community fær allan smiðinn, safnið, útgáfur, afturhvarf, innflutning og prófanir. Í Enterprise fer birting einnig í gegnum skugga- og kanarírekstur: samþykkta útgáfan keyrir í skugga, síðan fyrir eina einingu á bak við tilgreind hlið, síðan fyrir alla, og hún stöðvar sig sjálf ef hliði er ekki fullnægt. Hjá viðskiptavini í loftrofnu umhverfi berst færni fyrirfram undirrituð innan innsiglaða safnsins (atburðarás 9).
2. Skráarfærni (manifest skill) með host_callback
Markmiðið er ákvarðanleg vinnsla í yðar eigin viðbót sem kerfið getur sent verk til, til dæmis að opna frávikaskrá út frá mælingu. Þér notið línu í skills[] upplýsingaskrárinnar með þrepinu host_callback, og /internal leið í bakenda yðar sem varin er með þjónustuverði SDK-sins.
- Skilgreinið færnina:
idí lower_snake,tier: "host_callback",classificationsem er jafnt eða undir trausthámarki viðbótarinnar,inputSchema,outputSchemaogtimeoutMsá bilinu 1 sekúnda til 6 klukkustundir. - Fyllið út
hostCallback: heiti yðar eigin Service, gátt hennar, afstæða slóð eins og/internal/skills/excursion_open, bæði bætahámörkin (maxRequestBytesogmaxResponseBytes), ogtenantHeader: "X-Organization-ID". - Skilgreinið leiðina í
api.endpoints[]meðauth: "service-key"eðaauth: "internal", og verjið hana meðrequireServiceeðaserviceMiddleware, aldrei notandavarðanum fyrir umfang. - Staðfestið, keyrið hliðin og látið innleiðinguna samstilla færnina við skrána í gegnum
compileRegistry. Þér skrifið aldrei SQL fyrir skrána handvirkt.
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 beitir eigin reglum skrársamstillingarinnar áður en nokkuð er samstillt, og hverju er hafnað með kóða móttakandans. Slóð með skema, // eða bakstriki er hafnað sem þvert á uppruna. Bætahámark sem vantar er ENDPOINT_BYTE_CAP_REQUIRED, reitur úr öðru þrepi er FIELD_NOT_FOR_TIER, og tímamörk utan bilsins eru TIMEOUT_OUT_OF_BOUNDS. Síðan athugar nexus-gates að /internal leiðin beri þjónustuvörðinn og sé skilgreind internal eða service-key. Þetta hliðapar er sönnunin.
Samstilling er yfirlýsingarbundin. Sendið allt færnisafnið í hvert skipti, því færni sem þér sleppið er gerð óvirk, og látið dreifingarskrefið mistakast við hvaða stöðu sem er önnur en 200. Í Enterprise er samstilling viðbótar athuguð í heild: ef ein færni brýtur reglu er ekkert úr þeirri samstillingu tekið (PLUGIN_SYNC_ALL_OR_NOTHING) og fyrri útgáfan heldur áfram að keyra. Viðbót með samfélagstrausti getur ekki notað þrepin sem ná til líkans, tool_using og llm_only; þau krefjast trausts core eða verified.
3. Að útvíkka núverandi pakka
Markmiðið er ný atvinnugrein eða undirgrein sem endurnýtir mest af fyrirliggjandi pakka, til dæmis útlán og kortaágreiningur ofan á uppbyggingu Insurance-pakkans. Byggingareiningin er pack.json sem tilgreinir foreldri sitt í inherits og bætir aðeins við eigin linsuklösum og orðum.
- Byrjið pakkann með gullnu leiðinni fyrir lénspakka og stillið síðan
inheritsá auðkenni foreldrapakkans. - Bætið við yðar eigin
lensklösum, hverjum með sætum sínum, tilgangi og tilvísun í orðasafn. - Bætið orðum yðar við orðasafnið með einfaldri skýringu við hvert. Merkið hugtak
exactþar sem það verður að birtast eins og það er ritað. - Endurnýtið sameiginlegar linsur frekar en að teikna yðar eigin: regluverk sem nokkrir pakkar þurfa, svo sem skrá yfir útvistaða tækni, er ein sameiginleg linsa.
- Athugið leyfiskeðjuna. Pakkinn yðar erfir kröfur foreldrisins um viðbætur.
- Forskoðið hverja linsu sem tiltekinn einstaklingur á tilbúinni grein.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Sönnunin er stefnuathugun tilraunahliðsins, sem staðfestir að hver linsa þrengi aðeins grunn sinn og haldi persónureitum lokuðum sjálfgefið. Linsu sem reynir að sýna það sem grunnur hennar felur er hafnað með LENS_CANNOT_WIDEN. Hvað leyfi varðar neitar stjórnborðið að gefa út leyfi fyrir pakkann yðar án þeirra viðbóta sem foreldri hans þarf; Insurance-pakkinn þarf Decision rooms og innsiglaðar skrár.
Lénspakkar tilheyra Enterprise og eru leyfðir fyrir hvern pakka. Símaskjáir pakka þurfa einnig Mobile apps-viðbótina. Barnapakki getur ekki breytt skelinni, íhlutunum eða ritreglunum.
4. Nýr pakki frá grunni
Markmiðið er sýn einnar atvinnugreinar á Nexus: þekkingarlíkan hennar, linsurnar fyrir hvert hlutverk, sönnunargögnin sem reglur hennar krefjast, og viðbótin sem heldur gögnum hennar uppfærðum. Kafli 2.24, Smíði sérsniðins lóðrétts lausnamengis frá upphafi til enda, fer yfir þessa smíði í heild; hér er stutta útgáfan.
- Keyrið gullnu leiðina fyrir lénspakka og lýsið pakkanum: tilgangi, einingum, grunnlíkaninu og reglunum sem hann kortleggur.
- Byggið þekkingarlíkanið á grunnlíkani og flokkið hvern eiginleika um leið og honum er bætt við.
- Lesið áætlunina, staðfestið fingrafar hennar með aðgangslyklinum yðar og stofnið.
- Mótið linsurnar í Lens builder, þar sem hver þrengir grunnlinsu.
- Skrifið viðbótina og þá færni í Skills Engine sem pakkinn þarf.
- Búið til fræjuð tilbúin gögn með þeim óvenjulegu tilvikum sem skipta yður máli, og forskoðið hverja linsu sem tiltekinn einstaklingur.
- Færið úr þróunarrýminu í sviðsetningu, í tilraunaeiningu og síðan í allar einingar.
Sönnunin eru færsluhliðin: öll próf standast á tilbúnu greinunum á leið í sviðsetningu, síðan tveir yfirlesarar sem ekki eru höfundurinn, síðan 14 dagar í tilraunarekstri með villur undir 1 af 1.000. Ekki er hægt að sleppa neinu skrefi (GATE_CANNOT_BE_SKIPPED). Pakkar tilheyra Enterprise. Í Community er gullna leiðin fyrir lénspakka ekki í boði.
5. Gagnatengi
Markmiðið er að gögn úr utanaðkomandi kerfi streymi inn í eigin töflur viðbótarinnar samkvæmt áætlun, til dæmis hliðaratburðir úr rekstrarkerfi gámahafnar. Byggingareiningarnar eru plugin_queue færni, vinnsluferli sem sækir úr biðröðinni, flutningur fyrir marktöfluna og útleiðarvistfang sem skilgreint er í upplýsingaskránni.
- Skilgreinið
plugin_queuefærni meðqueueNameritað<plugin name>.<name>. Enginn tvípunktur er leyfður og heitið verður að vera í upplýsingaskránni, því stýrikerfið setur beint í þá biðröð. - Skrifið vinnsluferlið sem sækir úr biðröðinni og kallar á utanaðkomandi kerfið.
- Skilgreinið vistfang utanaðkomandi kerfisins sem útleiðarvistfang. Allt sem ekki er skráð er lokað.
- Geymið það sem berst í yðar eigin skema, með
organization_id,owner_user_idogbusiness_unit_idí hverri línu. - Lesið auðkenni utanaðkomandi kerfisins eftir heiti úr umhverfinu og skráið breytuna í
scripts/ci/required-env. - Sendið sóknirnar í gegnum UNO, verkflæðisvélina, aldrei með tímastilli sem kallar beint á vélar.
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 athugar heiti biðraðarinnar og tímamörkin gagnvart reglum skrársamstillingarinnar. Hliðin þrjú sanna að ekkert líkanaauðkenni sé til staðar, engin bein vinnsla og rétt afmörkuð tafla. Keyrið fullt nexus-gates áður en þér ýtið, þar sem --only þrengir keyrsluna og segir það í samantekt sinni. Við keyrslu er kall á vistfang sem upplýsingaskráin skilgreindi ekki stöðvað við jaðarinn með EGRESS_NOT_DECLARED.
Eigin tengi kerfisins við drif, wiki-síður, póstgeymslur og eldri kerfi, með breytingaskráningu og ferilrakningu, fylgja Data connectors-viðbótinni. Tengi sem þér smíðið sjálf er viðbót og virkar í hvaða útgáfu sem er. Að bæta við útleiðarvistfangi í síðari útgáfu er víkkun, sem haldið er eftir þar til tveir yfirlesarar samþykkja hana.
6. MCP-verkfæri
Markmiðið er verkfæri sem Claude Code, umboðsmenn og aðrir MCP-biðlarar (Model Context Protocol) geta kallað á, til dæmis til að fletta upp skoðunarsögu skips. Byggingareiningin er færsla í mcpTools[] upplýsingaskrárinnar, með name, description og inputSchema.
- Gefið verkfærinu heiti og lýsið því á skýran hátt. Lýsingin er það sem líkan les til að ákveða hvort kalla eigi á það.
- Skrifið
inputSchemasem eitt hlutaskema. Setjið ekkioneOf,allOfeðaanyOfá efsta stig þess. - Haldið leiðinni sem þjónar verkfærinu á bak við umfangsvörðinn, eins og öllum öðrum
/apileiðum, svo leigjendaskipting komi úr tóka kallandans. - Staðfestið upplýsingaskrána.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonSönnunin er validate: samsetningarvirkja á efsta stigi er hafnað við gerð, því við keyrslu myndi hann láta verkfærið bregðast hjá öllum MCP-undirumboðsmönnum sem flytja það inn, og verkfærið væri til án þess að nokkur gæti kallað á það.
Í Enterprise er hvert verkfæri sem IDE (samþætt þróunarumhverfi) getur kallað á skráð í verkfæraskrá Workbench með þrepi sínu, hvort það breyti hlutum, festu fingrafari og þeim hlutverkum sem mega nota það. Ef lýsing verkfærisins breytist í nýrri útgáfu heldur skráin verkfærinu eftir þar til einstaklingur fer yfir breytinguna. Það er af ásettu ráði: breytt lýsing er leiðin sem verkfæri getur farið til að byrja að biðja líkan um eitthvað sem það ætti ekki að gera. Kalli á nokkuð utan heimildar kallandans er hafnað með CONNECTION_SCOPE_EXCEEDED.
7. Endurmerkt vefverslun (white-label)
Markmiðið er forrit sem viðskiptavinir viðskiptavinar yðar nota, á léni viðskiptavinarins og undir vörumerki hans, án nokkurra ummerkja um Adverant. Byggingareiningarnar eru domains og branding blokkir upplýsingaskrárinnar, innskráningarhjálparföll SDK-sins og Storefront / white-label-viðbót viðskiptavinarins.
- Setjið lén viðskiptavinarins í
domains[]semprimary, ásamtaliasesef við á. - Fyllið út
branding:appName,tagline,primaryColor,accentColor,passkeyRpIdsem er sama og lénið, ogoauthClientRef. - Skráið fólk inn í gegnum innskráningarhjálparföll SDK-sins og skilgreinið tvær opinberar leiðir þeirra nákvæmlega, með
auth: "public"ogallowAnonymous: true. - Sendið hvert framendakall í gegnum leyfislista-staðgengil bakendans fyrir framendann. Setjið aldrei þjónustuvistfang í biðlarann.
- Látið greiðslur í hendur stjórnanda viðskiptavinarins, sem tengir greiðslugáttir og setur upp vörumerkta greiðsluferlið.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractSönnunin er scope-adherence. Hún leyfir óvarða /api leið aðeins þegar upplýsingaskráin skilgreinir nákvæmlega þá aðferð og slóð sem opinbera og slóðin er ein af innskráningarleiðunum; hver önnur opinber skilgreining mistekst og tilgreinir slóðirnar tvær sem leyfðar eru. api-contract ber síðan skilgreindu leiðirnar saman við raunverulegu leiðirnar í báðar áttir. definePlugin hafnar einnig frontend.basePath sem er ekki afstæð slóð af sama uppruna.
Hvítmerking (white-label) er viðbótin Storefront / white-label í Enterprise, sem veitir einnig leyfi fyrir greiðslum. Kortaupplýsingar koma aldrei inn í Nexus. Stjórnandi viðskiptavinarins á vörumerkið og kerfið sækir það út frá fyrirtækinu en ekki út frá kóðanum yðar.
8. Edge-verkefnapakki
Markmiðið er nýtt eða uppfært verkefni fyrir gervihnött eða dróna sem keyrir Nexus Edge, til dæmis að bæta skipaleitartengi við eftirlitsverkefni á hafi. Byggingareiningin er verkefnapakki sem er smíðaður og undirritaður á jörðu niðri.
- Byrjið á núverandi pakka á síðunni Smíða verkefnapakka, sem dregur upp nýju útgáfuna út frá þeirri gömlu og merkir hverja breytingu.
- Breytið aðeins því sem verkefnið þarfnast. Haldið stóru hlutunum, mállíkaninu og verufræðinni, stöðugum þegar þess er kostur.
- Athugið staðsetningartöfluna við hvert skert þrep, svo að hvert borð rúmi enn það sem það keyrir.
- Keyrið prófunartilvik pakkans um borð á prófunarbúnaði með sömu borðum.
- Sendið hann til undirritunar: tvær af þremur undirskriftum þarf.
- Gefið hann út á einn búnað. Hann fer í lausa hólfið og er aðeins virkjaður eftir að prófunartilvik hans standast um borð.
- Dreifið á næsta búnað eftir viku án villna.
Engar skipanir eru í þessari uppskrift; þetta er gert á Nexus Edge-síðum stjórnborðsins. Sönnunin eru prófunartilvikin um borð, sem öll verða að standast áður en pakkinn er virkjaður, og undirskriftirnar tvær. Ef próf mistekst um borð helst búnaðurinn á fyrri pakka sínum og villan berst niður í næstu yfirferð. Uppsetningu pakka á vélbúnað sem hann var ekki prófaður fyrir er hafnað með PACK_NOT_CHECKED_FOR_HARDWARE.
Nexus Edge er viðbót sem leyfð er fyrir hvern búnað eða hvern flota. Pakkar haldast gildir á meðan búnaður er utan sambands. Upptengingin er þröng, svo skipuleggið stærðir með hliðsjón af henni: útgáfa okkar 1.5 var 412 MB, á móti 9.8 GB fyrir pakka með nýju mállíkani.
9. Neteinangruð afhending til viðskiptavinar
Markmiðið er að viðbótin eða pakkinn yðar sé settur upp hjá viðskiptavini án netsambands. Byggingareiningarnar eru innsiglaður pakki frá @adverant/nexus-sovereign, útgáfuundirritunarlykill yðar og eigin útgáfurásir viðskiptavinarins.
- Smíðið viðbótina og myndir hennar nákvæmlega eins og fyrir tengdan viðskiptavin, með öll hlið græn.
- Búið til innsiglaðan pakka með sniðinu
airgap, sem inniheldur myndirnar, flutningana, forundirrituð færni og SBOM (hugbúnaðarefnisskrá) með leyfunum. - Undirritið hann með Ed25519-útgáfulykli yðar.
- Sannreynið hann sjálf á hreinni vél.
- Sendið pakkann á gagnamiðli og sendið opinberan lykil yðar og SHA-256 pakkans eftir annarri leið.
- Rekstraraðili viðskiptavinarins sannreynir pakkann með lykli yðar og tekur síðan útgáfuna inn um eigin útgáfurásir.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle smíðar pakkann út frá pakkastillingum yðar. Sönnunin er nexus-airgap verify hjá viðskiptavininum. Það reiknar tætigildi hverrar skrár aftur, hafnar hverri skrá sem skráin yfir innihald tilgreinir ekki, krefst traust undirritara og hafnar pakka þar sem leyfilisti nets er ekki tómur. Breytt skrá mistekst með BUNDLE_INTEGRITY_VIOLATION. Enginn ætti nokkurn tíma að slökkva á strangri athugun til að komast fram hjá því.
Uppsetningar án nettengingar (air-gapped) tilheyra Enterprise. Ekkert í pakkanum má sækja neitt við uppsetningu, og líkan sem viðbótin þarfnast kemur frá eigin líkanaþjóni viðskiptavinarins í gegnum AI (gervigreind) Provider Router.
10. Eining eingöngu fyrir Enterprise
Markmiðið er lokuð, leyfisskyld virkni sem tengist opna kjarnanum, til dæmis endurskoðunarslóð með langri varðveislu sem aðeins er seld Enterprise-viðskiptavinum. Byggingareiningin er viðmótspakkinn @adverant/nexus-spi og ekkert annað úr Community.
- Geymið bætafesta afritun af smíðaða viðmótspakkanum í geymslu yðar sem staðbundinn
file:-pakka, með festingu sinniSHA256SUMS. - Skrifið
RouteModule(eðaScreenModulefyrir skjái stjórnborðsins) gegn honum, með þeim eiginleikahópi sem hann þjónar. - Keyrið hverja leið á bak við
ctx.requireScopeog athugið eigin heimild einingarinnar áður en svarað er. - Hafnið með
LICENCE_LOCKEDþegar fyrirtækið á ekki rétt á eiginleikanum, og birtið kynningu eiginleikans, aldrei gögn hans. - Haldið geymslunni við leyfismörkin og smíðið síðan samsett tré hverrar útgáfu.
npm ci
npm test
npm run buildSönnunin er leyfismarkareglan: enginn innflutningur úr Community-umfangi nema viðmótspakkinn, enginn afstæður innflutningur út fyrir geymsluna og engin file:-, link:- eða workspace:-tenging utan hennar. Síðan verða skipanirnar þrjár hér að ofan að standast í hverju samsettu útgáfutré, ekki aðeins í vinnutré yðar. Kafli 2.25, Smíði fyrir hverja útgáfu, inniheldur beinagrind einingarinnar.
Eining hleðst inn í Community-þjónustu við ræsingu, í uppsetningum þar sem leyfið nær yfir eiginleikahóp hennar. Án þeirrar heimildar hafnar hún, svo sama smíð er send alls staðar og gerir ekkert þar sem hún er ekki leyfð.
11. Að kvíslataka (fork) eða útvíkka opna kjarnann
Markmiðið er breyting á Community sjálfu, sem haldið er í kvísl yðar eða lögð til baka. Byggingareiningin er Community-frumkóðinn undir Apache License, Version 2.0.
- Kvíslið geymsluna og greinið frá
main. - Veljið frekar viðbót eða færni ef það sem þér viljið getur verið slíkt. Breyting á kjarnanum er yðar að viðhalda í hverri útgáfu.
- Gerið breytinguna með prófunum sem mistakast án hennar.
- Keyrið þær athuganir sem verkefnið keyrir áður en þér leggið nokkuð til.
- Haldið NOTICE-skránni og notið ekki nöfn eða vörumerki Adverant umfram það að greina frá uppruna verksins.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckSönnunin er að þessar þrjár athuganir standist, ásamt sönnun þess að hvert nýtt próf hafi mistekist fyrir breytingu yðar. Haldið einum eiginleika opna kjarnans réttum í kvísl yðar: Community keyrir umboðsmann frá upphafi til enda á staðbundnu líkani án lykils og án netsambands. Breyting sem rýfur það rýfur það sem gerir Community nothæft eitt og sér.
Þetta á aðeins við um Community. Allt sem þarf að haldast lokað á heima í Enterprise-einingu (atburðarás 10) í staðinn, svo leyfismörkin haldist á stað sem hver sem er getur bent á.
12. Skýjaforrit fyrir Team-útgáfu
Markmiðið er forrit sem Team-viðskiptavinir geta sett upp. Team keyrir aðeins í Adverant-skýinu, svo forritið nær aðeins til þeirra í gegnum vörulistann. Byggingareiningarnar eru viðbót og útgefandaklasi: yðar eigin sýndarklasi í Adverant-skýinu með sýnigögnum.
- Smíðið og prófið á útgefandaklasanum, aðeins með sýnigögnum.
- Tilgreinið allt sem forritið þarfnast í lýsingarskrá þess, og ekkert umfram það.
- Gefið það út undirritað, til yfirferðar Adverant og skráningar í vörulista.
- Hver viðskiptavinur setur það upp og veitir hvert tilgreint umfang einingu fyrir einingu.
Sönnunin er í tveimur hlutum. Undirrituð, yfirfarin útgáfa kemur yður inn í vörulistann. Síðan ræður heimild viðskiptavinarins því hvað forritið getur náð til hjá honum, og hverju kalli sem það tilgreindi ekki er hafnað með CONNECTION_SCOPE_EXCEEDED. Aðeins er hægt að bæta við vantandi umfangi í nýrri útgáfu sem viðskiptavinurinn yfirfer.
Útgefandaklasi hefur enga leið til nokkurs viðskiptavinar, og beiðni um gögn viðskiptavinar þar er hafnað með TENANT_BOUNDARY. Viðskiptavinir geta deilt prófunarniðurstöðum með yður, aldrei gögnum sínum. Team inniheldur verkflæðisrekstrargetuna, svo ef forrit yðar inniheldur verkflæði geta Team-viðskiptavinir sjálfir fært þau milli umhverfa.
13. Að pakka inn núverandi innra forriti sem viðbót
Markmiðið er forrit sem fyrirtæki yðar keyrir nú þegar, fært inn í Nexus svo það erfi innskráningu, einangrun og stjórnun. Byggingareiningarnar eru færnin /plugin-create fyrir fyrstu drög, og lýsingarskrártól og hlið SDK til að ljúka því.
- Keyrið
/plugin-createmeð geymslunni. Það greinir kóðann og velur innpökkunaraðferð, og býr síðan til bakenda, flutninga, notendaviðmót (UI), lýsingarskrá og prófanir. - Færið lýsingarskrána upp í v2-samninginn.
migratebætir við lagasetningunum þremur og færirdomainídomains[], og það neitar að búa til inngangspunkt. - Skiptið út hverju leigjandagildi sem umbúðirnar lesa úr hausum fyrir umfangsvörð SDK.
- Bætið
organization_id,owner_user_idogbusiness_unit_idvið hverja töflu, með frumlyklum sem byrja á leigjanda. - Tilgreinið hverja leið með sínum réttindum og setjið upp höfnunarskrána.
- Keyrið hliðin þar til þau eru græn.
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-testSönnunin er að nexus-gates skili 0, þar sem scope-adherence, one-fence, migrations-are-scoped, crud-adherence og api-contract standast öll. Búist við að fyrsta keyrsla mistakist á flestum þeirra; okkar tilkynnti hverja leið án umfangs, því drögin treystu hausum sem vafrinn gat stillt. Hliðin hafa enga lagfæringarrofa, af ásettu ráði.
Innpökkuð forrit virka á hvaða útgáfu sem er. Dreifing fer aðeins fram um útgáfurásir uppsetningarinnar, svo hunsið allar dreifingarskrár sem drögin skrifuðu. Einangrunarvinnan er það sem tekur tímann: gerið ráð fyrir dögum fyrir raunverulegt forrit, ekki klukkustundum.


