IdħolIbbukkja laqgħa informattiva

Kapitlu 2.27

Xenarji ta' bini

Ktieb tar-riċetti ta' tlettax-il binja, minn ħila waħda sa twassil iżolat (air-gapped). Kull riċetta tagħti l-għan, il-blokok tal-bini, il-passi u l-kmandi, il-punt ta' kontroll li jipprova li ħadmet, u x'jinbidel skont l-edizzjoni u l-forma tat-twassil.

Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

25 minuti qari

Dawn huma r-riċetti li nirrikorri għalihom meta xi ħadd f'Corrán Orbital, jew għand klijent, jgħid "irridu li Nexus jagħmel X". Kull waħda hija qasira apposta. Ir-raġunament wara l-passi jinsab fil-kapitoli ta' qabel dan: il-kapitolu 2.20, Skills, u il-kapitolu 2.21, The Plugin SDK, li jkopri l-kit għall-iżvilupp tas-softwer, imbagħad il-kapitolu 2.23, Domain packs, u t-tliet kapitoli ta' wara dwar il-bini. Hawn issibu l-għan, liema blokki tal-bini għandkom tużaw, il-passi, il-kmandi, il-kontroll li jgħidilkom li rnexxa, u n-noti dwar l-edizzjoni u t-twassil.

Il-kontroll huwa l-iktar importanti. Riċetta titlesta meta l-kontroll tagħha jkun aħdar. Kull kontroll f'dan il-kapitolu huwa xi ħaġa li tistgħu tħaddmu jew xi ħaġa li l-pjattaforma tħaddem għalikom, u kull wieħed joħroġ b'kodiċi mhux żero jew jirrifjuta b'kodiċi meta ma jkunx sodisfatt.

Xenarju Blokk tal-bini prinċipali Il-kontroll li jipprovah Edizzjoni
Skill ġdida tal-Skills Engine Pakkett SKILL.md skill:validate b'żero żbalji Community u Enterprise
Skill tal-manifest b'host_callback skills[] tal-manifest tal-plugin create-nexus-plugin validate u nexus-gates Community u Enterprise
Estensjoni ta' pakkett eżistenti pack.json bi inherits Verifika tal-politika tal-lenti fil-kontroll pilota Enterprise u liċenzja tal-pakkett
Pakkett ġdid mill-bidu Il-mogħdija standard għall-pakketti tad-dominju Kontrolli ta' staging u pilota Enterprise
Konnettur tad-dejta Skill plugin_queue validate, nexus-gates, rifjut tat-traffiku 'l barra Community u Enterprise
Għodda MCP (Model Context Protocol) mcpTools[] tal-manifest validate (l-ebda kombinatur fil-livell ta' fuq) Community u Enterprise
Storefront white-label domains u branding tal-manifest Regola pubblika scope-adherence Enterprise u l-add-on Storefront
Pakkett ta' missjoni Edge Pakkett ta' missjoni Każijiet ta' test abbord, tnejn minn tliet firem Enterprise u l-add-on Nexus Edge
Twassil air-gapped Pakkett issiġillat nexus-airgap verify Enterprise
Modulu għal Enterprise biss @adverant/nexus-spi Kontroll tal-linja tal-liċenzja, bini tal-edizzjonijiet Enterprise
Fork jew estensjoni tal-qalba miftuħa Is-sors Community Testijiet, lint u verifika tat-tipi Community
App tal-cloud tal-edizzjoni Team Publisher cluster Rilaxx iffirmat, reviżjoni, għotja lill-klijent Team
Tgeżwir ta' app interna eżistenti /plugin-create migrate, validate, nexus-gates Community u Enterprise
Siġra tad-deċiżjonijiet li tinqara minn fuq għal isfel. L-ewwel djamant jistaqsi "Jeħtieġ kodiċi li jaħdem il-ħin kollu?". "Le" jwassal għal djamant "Huma istruzzjonijiet għal assistent?", li l-"Iva" tiegħu jispiċċa f'"Ħila tal-Skills Engine" u l-"Le" tiegħu jispiċċa f'"Lenti fuq pakkett eżistenti". "Iva" jwassal għal djamant "Hija l-perspettiva ta' industrija waħda dwar il-pjattaforma?", li l-"Iva" tiegħu jispiċċa f'"Pakkett tad-dominju (bil-plugin tiegħu)" u l-"Le" tiegħu jwassal għal djamant aħħari "Irid jibqa' magħluq u b'liċenzja?", li jispiċċa f'"Modulu Enterprise" għal "Iva" u "Plugin" għal "Le".
Minn liema blokk tal-bini għandkom tibdew.

1. Ħila ġdida ta' Skills Engine

L-għan huwa biċċa struzzjoni li terġa' tintuża u li l-assistent, l-aġenti, il-workflows u l-għodod tal-iżviluppaturi jistgħu kollha jħaddmu, bħall-verifika ta' dikjarazzjoni doganali kontra r-regoli tagħha. Il-blokki tal-bini tagħkom huma pakkett SKILL.md f'folder imsemmi għall-skill, skill.yaml fakultattiv għall-iskattaturi u t-tikketti, u folder scripts/ fakultattiv inkluż miegħu.

  1. Oħolqu skills/<slug>/ u iktbu SKILL.md bil-frontmatter: name (kebab-case, l-istess bħall-isem tal-folder), description (sa 500 karattru), allowed-tools, u fakultattivament triggers, capabilities u version.
  2. Iktbu l-korp għall-mudell: meta għandu jintuża l-skill, il-passi tiegħu, eżempji, u x'm'għandu qatt jagħmel.
  3. Żidu każijiet ta' test. Inkludu wieħed b'istruzzjoni mdaħħla fl-input li l-skill m'għandux isegwi.
  4. Ivvalidaw, ħarsu lejn il-pjan tat-tlugħ, imbagħad tellgħu.
  5. Ippubblikaw. Skill li żżid għodda tal-kitba tinżamm sakemm żewġ persuni msemmija japprovawha bil-passkeys, u min jipproponi ma jistax japprova l-bidla tiegħu stess.
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-filing

Il-kontroll huwa skill:validate, li għandu jirrapporta żero żbalji qabel ma jista' jiġi ppubblikat xejn. L-iżbalji li jimblokkaw huma isem jew deskrizzjoni nieqsa u slug jew tip ta' xogħol duplikat. It-tlugħ ta' kontenut li diġà ġie ppubblikat jirritorna l-verżjoni eżistenti (CONTENT_HASH_ALREADY_PUBLISHED), għalhekk it-tlugħ jista' jiġi ripetut b'mod sikur.

Community jieħu l-kreatur kollu, il-librerija, il-verżjonijiet, ir-ritorn lura, l-importazzjoni u t-testijiet. Fuq Enterprise, il-pubblikazzjoni tgħaddi wkoll minn shadow u canary: il-verżjoni approvata taħdem f'shadow, imbagħad għal unità waħda wara kontrolli msemmija, imbagħad għal kulħadd, u tieqaf waħedha jekk kontroll ma jintlaħaqx. Għal klijent air-gapped, l-skills jivvjaġġaw iffirmati minn qabel ġewwa l-pakkett issiġillat (xenarju 9).

2. Ħila ta' manifest b'host_callback

L-għan huwa komputazzjoni deterministika fil-plugin tagħkom stess li l-pjattaforma tista' tibgħat, bħall-ftuħ ta' rekord ta' eskursjoni minn qari. Se tużaw ringiela f'skills[] tal-manifest bil-livell host_callback, u rotta /internal fil-backend tagħkom protetta mill-gwardja tas-servizz tal-SDK.

  1. Iddikjaraw l-skill: id f'lower_snake, tier: "host_callback", classification fil-limitu ta' fiduċja tal-plugin tagħkom jew taħtu, inputSchema, outputSchema u timeoutMs bejn sekonda u 6 sigħat.
  2. Imlew hostCallback: l-isem tas-Service tagħkom stess, il-port tiegħu, mogħdija relattiva bħal /internal/skills/excursion_open, iż-żewġ limiti tal-bytes (maxRequestBytes u maxResponseBytes), u tenantHeader: "X-Organization-ID".
  3. Iddikjaraw ir-rotta f'api.endpoints[] b'auth: "service-key" jew auth: "internal", u pproteġuha b'requireService jew serviceMiddleware, qatt bil-gwardja tal-ambitu tal-utent.
  4. Ivvalidaw, ħaddmu l-kontrolli, u ħallu l-onboarding jissinkronizza l-skills mar-reġistru permezz ta' compileRegistry. Qatt ma tiktbu SQL tar-reġistru bl-idejn.
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-test

validate japplika r-regoli tas-sinkronizzazzjoni tar-reġistru stess qabel ma jiġi sinkronizzat xejn, u kull rifjut jingħata bil-kodiċi tar-riċevitur. Mogħdija bi skema, // jew backslash tiġi rrifjutata bħala cross-origin. Limitu tal-bytes nieqes huwa ENDPOINT_BYTE_CAP_REQUIRED, qasam minn livell ieħor huwa FIELD_NOT_FOR_TIER, u timeout barra l-medda huwa TIMEOUT_OUT_OF_BOUNDS. Imbagħad nexus-gates jivverifika li r-rotta /internal għandha l-gwardja tas-servizz u hija ddikjarata internal jew service-key. Dak il-par ta' kontrolli huwa l-prova.

Is-sinkronizzazzjoni hija dikjarattiva. Ibagħtu s-sett sħiħ ta' skills kull darba, għax skill li tħallu barra tiġi diżattivata, u ħallu l-pass tal-iskjerament ifalli fuq kwalunkwe status minbarra 200. Fuq Enterprise, sinkronizzazzjoni ta' plugin tiġi vverifikata kollha flimkien: jekk skill waħda tikser regola, xejn minn dik is-sinkronizzazzjoni ma jiġi aċċettat (PLUGIN_SYNC_ALL_OR_NOTHING) u l-verżjoni preċedenti tibqa' taħdem. Plugin b'fiduċja community ma jistax juża l-livelli li jilħqu mudell, tool_using u llm_only; dawk jeħtieġu fiduċja core jew verified.

Plugins u sinkronizzazzjoni tal-MCP
Plugins u sinkronizzazzjoni tal-MCP
Plugins li jġibu skills, u għal xiex ġiet ivverifikata kull sinkronizzazzjoni. Innotaw il-plugin li s-sinkronizzazzjoni tiegħu ġiet irrifjutata kollha għax waħda mill-ħames skills tiegħu użat livell li l-pjattaforma biss tista' tospita, filwaqt li l-verżjoni preċedenti tiegħu baqgħet taħdem.

3. L-estensjoni ta' pakkett eżistenti

L-għan huwa industrija jew sottoindustrija ġdida li terġa' tuża l-biċċa l-kbira ta' pakkett eżistenti, bħal self u tilwim dwar il-kards fuq l-istruttura tal-pakkett Insurance. Il-blokk tal-bini huwa pack.json li jsemmi l-ġenitur tiegħu f'inherits u jżid biss ir-raggruppamenti tal-lenti u l-kliem tiegħu stess.

  1. Ibdew il-pakkett bil-mogħdija standard għall-pakketti tad-dominju, imbagħad issettjaw inherits għall-id tal-pakkett ġenitur.
  2. Żidu r-raggruppamenti lens tagħkom stess, kull wieħed bis-siġġijiet, l-iskop u r-referenza għal-lessiku tiegħu.
  3. Żidu l-kliem tagħkom mal-lessiku b'glossa sempliċi għal kull wieħed. Immarkaw terminu exact fejn irid jintwera kif inhu miktub.
  4. Erġgħu użaw lenti kondiviżi minflok ma tfasslu tagħkom: reġim li jeħtieġu diversi pakketti, bħal reġistru tat-teknoloġija esternalizzata, huwa lenti kondiviża waħda.
  5. Ivverifikaw il-katina tal-liċenzji. Il-pakkett tagħkom jiret ir-rekwiżiti tal-add-ons tal-ġenitur tiegħu.
  6. Araw minn qabel kull lenti bħala persuna fuq fergħa sintetika.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Il-prova hija l-verifika tal-politika tal-kontroll pilota, li tikkonferma li kull lenti tnaqqas biss il-bażi tagħha u żżomm l-oqsma personali mitfija b'mod awtomatiku. Lenti li tipprova turi dak li l-bażi tagħha taħbi tiġi rrifjutata b'LENS_CANNOT_WIDEN. Fuq in-naħa tal-liċenzjar, il-console tirrifjuta li toħroġ liċenzja għall-pakkett tagħkom mingħajr l-add-ons li jeħtieġ il-ġenitur tiegħu; il-pakkett Insurance jeħtieġ Kmamar tad-deċiżjoni u rekords issiġillati.

Il-pakketti tad-dominju huma Enterprise u liċenzjati għal kull pakkett. L-iskrins tal-mowbajl ta' pakkett jeħtieġu wkoll l-add-on tal-Apps tal-mowbajl. Pakkett wild ma jistax ibiddel il-qoxra, il-komponenti jew ir-regoli tal-kitba.

4. Pakkett ġdid mill-bidu nett

L-għan huwa l-perspettiva ta' industrija waħda dwar Nexus: il-mudell tal-għarfien tagħha, il-lenti għal kull rwol, l-evidenza li jitolbu r-regoli tagħha, u l-plugin li jżomm id-dejta tagħha aġġornata. Il-kapitolu 2.24, Building a custom vertical end to end, jgħaddi minn dan il-bini kollu; hawn hawn il-verżjoni qasira.

  1. Ħaddmu l-mogħdija standard għall-pakketti tad-dominju u iddeskrivu l-pakkett: l-iskop, l-unitajiet, il-mudell bażi u r-regoli li jimmappja.
  2. Ibnu l-mudell tal-għarfien fuq mudell bażi u kklassifikaw kull proprjetà hekk kif iżżiduha.
  3. Aqraw il-pjan, ikkonfermaw il-fingerprint tiegħu bil-passkey tagħkom, u oħolqu.
  4. Sawru l-lenti fil-Lens builder, kull waħda tnaqqas lenti bażi.
  5. Iktbu l-plugin u kwalunkwe skill tal-Skills Engine li jeħtieġ il-pakkett.
  6. Iġġeneraw dejta sintetika b'seed bil-każijiet strambi li jimpurtaw lilkom, u araw minn qabel kull lenti bħala persuna.
  7. Ippromwovu mill-ispazju tal-iżvilupp għal staging, għal unità pilota, imbagħad għall-unitajiet kollha.

Il-prova huma l-kontrolli tal-promozzjoni: it-testijiet kollha jgħaddu fuq il-fergħat sintetiċi qabel staging, imbagħad żewġ reviżuri li mhumiex l-awtur, imbagħad 14-il jum fil-pilota bi żbalji taħt 1 f'1,000. L-ebda pass ma jista' jinqabeż (GATE_CANNOT_BE_SKIPPED). Il-pakketti huma Enterprise. Fuq Community il-mogħdija standard għall-pakketti tad-dominju mhix offruta.

5. Konnettur tad-dejta

L-għan huwa dejta minn sistema esterna li tgħaddi lejn it-tabelli tal-plugin tagħkom stess skont skeda, bħal avvenimenti tal-gate minn sistema operattiva ta' terminal. Il-blokki tal-bini huma skill plugin_queue, worker li jiġbed mill-kju tagħkom, migrazzjoni għat-tabella fil-mira, u indirizz 'il barra ddikjarat fil-manifest.

  1. Iddikjaraw skill plugin_queue b'queueName miktub <plugin name>.<name>. L-ebda kolon mhu permess, u l-isem irid ikun fil-manifest, għax l-orkestratur idaħħal fil-kju direttament fuqu.
  2. Iktbu l-worker li jiġbed mill-kju u jsejjaħ lis-sistema esterna.
  3. Iddikjaraw l-indirizz tas-sistema esterna bħala indirizz 'il barra. Kull ma mhuwiex elenkat jiġi mblukkat.
  4. Aħżnu dak li jasal fl-iskema tagħkom stess, b'organization_id, owner_user_id u business_unit_id fuq kull ringiela.
  5. Aqraw il-kredenzjali tas-sistema esterna bl-isem mill-ambjent, u elenkaw il-varjabbli f'scripts/ci/required-env.
  6. Ibagħtu l-ġbid permezz ta' UNO, il-magna tal-workflows, qatt b'timer li jsejjaħ il-magni direttament.
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-env

validate jivverifika l-isem tal-kju u t-timeout kontra r-regoli tas-sinkronizzazzjoni tar-reġistru. It-tliet kontrolli jippruvaw li m'hemmx kredenzjali tal-mudell, l-ebda komputazzjoni diretta u tabella b'ambitu xieraq. Ħaddmu nexus-gates sħiħ qabel ma tagħmlu push, għax --only idejjaq it-tħaddim u jgħid hekk fis-sommarju tiegħu. Waqt it-tħaddim, sejħa lejn indirizz li l-manifest ma ddikjarax titwaqqaf fit-tarf b'EGRESS_NOT_DECLARED.

Il-konnetturi tal-pjattaforma stess għal drives, wikis, ħażniet tal-posta u sistemi legacy, b'qbid tal-bidliet u lineage, jiġu mal-add-on Data connectors. Konnettur li tibnuh intom stess huwa plugin u jaħdem fuq kwalunkwe edizzjoni. Iż-żieda ta' indirizz 'il barra f'rilaxx aktar tard hija twessigħ, li jinżamm sakemm żewġ reviżuri jaċċettawh.

6. Għodda MCP

L-għan huwa għodda li Claude Code, l-aġenti u klijenti oħra MCP (Model Context Protocol) jistgħu jsejħu, bħat-tfittxija tal-istorja tal-ispezzjonijiet ta' bastiment. Il-blokk tal-bini huwa entrata f'mcpTools[] tal-manifest, b'name, description u inputSchema.

  1. Semmu l-għodda u iddeskrivuha b'mod sempliċi. Id-deskrizzjoni hija dak li jaqra mudell biex jiddeċiedi jekk isejħilhiex.
  2. Iktbu l-inputSchema bħala skema ta' oġġett wieħed. Tpoġġux oneOf, allOf jew anyOf fil-livell ta' fuq tagħha.
  3. Żommu r-rotta li sservi l-għodda wara l-gwardja tal-ambitu, bħal kull rotta /api oħra, sabiex it-tenancy tiġi mit-token ta' min qed isejjaħ.
  4. Ivvalidaw il-manifest.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Il-prova hija validate: kombinatur fil-livell ta' fuq jiġi rrifjutat waqt il-kitba, għax waqt it-tħaddim iġiegħel l-għodda tfalli għal kull subaġent MCP li jimportaha, u l-għodda teżisti mingħajr ħadd ma jkun jista' jsejħilha.

Fuq Enterprise, kull għodda li IDE (ambjent integrat tal-iżvilupp) jista' jsejjaħ hija elenkata fil-katalgu tal-għodod tal-Workbench bil-livell tagħha, jekk tbiddilx l-affarijiet, fingerprint imwaħħal u r-rwoli li jistgħu jużawha. Jekk id-deskrizzjoni tal-għodda tagħkom tinbidel f'rilaxx ġdid, il-katalgu jżomm l-għodda sakemm persuna tirrevedi l-bidla. Dan huwa intenzjonat: deskrizzjoni mibdula hija l-mod kif għodda tista' tibda titlob lil mudell xi ħaġa li m'għandhiex. Sejħa għal kwalunkwe ħaġa barra l-pass ta' min qed isejjaħ tiġi rrifjutata b'CONNECTION_SCOPE_EXCEEDED.

7. Ħanut diġitali white-label

L-għan huwa app li jużaw il-klijenti tal-klijent tagħkom, fuq id-dominju tal-klijent u bil-brand tiegħu, mingħajr ebda traċċa ta' Adverant. Il-blokki tal-bini huma l-blokki domains u branding tal-manifest, l-għajnuniet tad-dħul tal-SDK, u l-add-on Storefront / white-label tal-klijent.

  1. Poġġu d-dominju tal-klijent f'domains[] bħala primary, ma' kwalunkwe aliases.
  2. Imlew branding: appName, tagline, primaryColor, accentColor, passkeyRpId ugwali għad-dominju, u oauthClientRef.
  3. Daħħlu lin-nies permezz tal-għajnuniet tad-dħul tal-SDK, u iddikjaraw iż-żewġ rotot pubbliċi tagħhom eżattament, b'auth: "public" u allowAnonymous: true.
  4. Ibagħtu kull sejħa tal-frontend permezz tal-proxy b'lista ta' permess tal-backend for frontend. Qatt tpoġġu indirizz ta' servizz fil-klijent.
  5. Ħallu l-pagamenti f'idejn l-amministratur tal-klijent, li jgħaqqad il-gateways u jwaqqaf il-checkout bil-brand.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Il-prova hija scope-adherence. Jammetti rotta /api mhux protetta biss meta l-manifest jiddikjara dak il-metodu u l-mogħdija eżatti bħala pubbliċi u l-mogħdija tkun waħda mir-rotot tad-dħul; kwalunkwe dikjarazzjoni pubblika oħra tfalli u ssemmi ż-żewġ mogħdijiet permessi. api-contract imbagħad iqabbel ir-rotot iddikjarati ma' dawk reali fiż-żewġ direzzjonijiet. definePlugin jirrifjuta wkoll frontend.basePath li mhijiex mogħdija relattiva same-origin.

Il-white-label huwa ż-żieda Storefront / white-label fuq Enterprise, li tagħti wkoll il-liċenzja għall-pagamenti. Id-dettalji tal-kard qatt ma jmissu lil Nexus. L-amministratur tal-klijent huwa sid il-marka, u l-pjattaforma tiddeterminaha mill-organizzazzjoni u mhux mill-kodiċi tagħkom.

8. Pakkett ta' missjoni Edge

L-għan huwa missjoni ġdida jew aġġornata għal satellita jew drone li jħaddem Nexus Edge, bħaż-żieda ta' adapter għas-sejbien tal-vapuri ma' missjoni ta' sorveljanza marittima. Il-blokk tal-bini huwa pakkett tal-missjoni, mibni u ffirmat fuq l-art.

  1. Ibdew mill-pakkett attwali fil-paġna Ibnu pakkett tal-missjoni, li tfassal il-verżjoni l-ġdida mill-qadima u timmarka kull bidla.
  2. Ibdlu biss dak li teħtieġ il-missjoni. Żommu l-partijiet il-kbar, il-mudell tal-lingwa u l-ontoloġija, stabbli meta tistgħu.
  3. Iċċekkjaw it-tabella tat-tqegħid f'kull pass degradat, sabiex kull bord xorta jlaħħaq ma' dak li jħaddem.
  4. Ħaddmu l-każijiet tat-test abbord tal-pakkett fuq rig tal-bank bl-istess bordijiet.
  5. Ibagħtuh għall-iffirmar: huma meħtieġa żewġ firem minn tlieta.
  6. Oħorġuh għal pjattaforma waħda. Jidħol fis-slot inattiv u jinxtegħel biss wara li l-każijiet tat-test tiegħu jgħaddu abbord.
  7. Xerrduh fuq il-pjattaforma li jmiss wara ġimgħa mingħajr problemi.
Pakketti tal-missjoni
Pakketti tal-missjoni
Il-librerija tal-pakketti tal-missjoni, b'dak li jġorr kull pakkett u l-pjattaformi li jħaddmuh. Innotaw il-verżjoni l-antika li tinżamm abbord biex wieħed jerġa' lura għaliha, u l-għadd ta' każijiet tat-test li kull pakkett irid jgħaddi fuq il-hardware tiegħu.

M'hemmx kmandi f'din ir-riċetta; issir fil-paġni ta' Nexus Edge tal-console. Il-prova hija l-każijiet tat-test abbord, li kollha jridu jgħaddu qabel ma jinxtegħel il-pakkett, u ż-żewġ firem. Jekk test ifalli abbord, il-pjattaforma tibqa' fuq il-pakkett preċedenti tagħha u l-falliment jinżel fil-passaġġ li jmiss. L-installazzjoni ta' pakkett fuq hardware li ma ġiex iċċekkjat għalih tiġi rrifjutata b'PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge huwa żieda, b'liċenzja għal kull pjattaforma jew għal kull flotta. Il-pakketti jibqgħu validi waqt li pjattaforma tkun barra mill-kuntatt. L-uplink huwa dejjaq, għalhekk ippjanaw id-daqsijiet skont dan: ir-rilaxx 1.5 tagħna kien ta' 412 MB, meta mqabbel ma' 9.8 GB għal pakkett b'mudell tal-lingwa ġdid.

9. Twassil iżolat (air-gapped) lil klijent

L-għan huwa li l-plugin jew il-pakkett tagħkom jiġi installat f'sit ta' klijent mingħajr netwerk. Il-blokki tal-bini huma bundle issiġillat minn @adverant/nexus-sovereign, iċ-ċavetta tal-iffirmar tar-rilaxx tagħkom, u l-kanali tar-rilaxx tal-klijent stess.

  1. Ibnu l-plugin u l-immaġnijiet tiegħu eżatt bħal għal klijent konness, b'kull gate aħdar.
  2. Agħmlu bundle issiġillat bil-profil airgap, li jġorr l-immaġnijiet, il-migrazzjonijiet, il-ħiliet iffirmati minn qabel u SBOM (software bill of materials) bil-liċenzji.
  3. Iffirmawh biċ-ċavetta tar-rilaxx Ed25519 tagħkom.
  4. Ivverifikawh intom stess fuq magna nadifa.
  5. Ibagħtu l-bundle fuq midja, u ibagħtu ċ-ċavetta pubblika tagħkom u s-SHA-256 tal-bundle minn rotta separata.
  6. L-operatur tal-klijent jivverifika l-bundle biċ-ċavetta tagħkom, imbagħad idaħħal ir-rilaxx permezz tal-kanali tar-rilaxx tiegħu stess.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgap

nexus-airgap bundle jibni l-bundle mill-konfigurazzjoni tal-bundle tagħkom. Il-prova hija nexus-airgap verify min-naħa tal-klijent. Jerġa' jikkalkula l-hash ta' kull fajl, jirrifjuta kull fajl li l-manifest ma jelenkax, jeħtieġ firmatarju fdat, u jirrifjuta bundle li l-allow-list tan-netwerk tiegħu mhix vojta. Fajl mibdul ifalli b'BUNDLE_INTEGRITY_VIOLATION. Ħadd qatt m'għandu jitfi l-verifika stretta biex jgħaddi minnha.

L-installazzjonijiet air-gapped huma Enterprise. Xejn fil-bundle ma jista' jġib xi ħaġa waqt l-installazzjoni, u mudell li jeħtieġ il-plugin jiġi mis-server tal-mudelli tal-klijent stess permezz tal-AI (intelliġenza artifiċjali) Provider Router.

10. Modulu għal Enterprise biss

L-għan huwa kapaċità magħluqa u b'liċenzja li titwaħħal mal-qalba miftuħa, bħal audit trail b'żamma twila mibjugħa biss lil klijenti Enterprise. Il-blokk tal-bini huwa l-pakkett tal-interfaċċa @adverant/nexus-spi, u xejn iktar minn Community.

  1. Żommu kopja ffissata sal-byte tal-pakkett tal-interfaċċa mibni fir-repożitorju tagħkom bħala pakkett lokali file:, bil-pin SHA256SUMS tiegħu.
  2. Iktbu RouteModule (jew ScreenModule għall-iskrins tal-console) kontrih, bil-grupp ta' funzjonalitajiet li jservi.
  3. Ħaddmu kull rotta wara ctx.requireScope, u ċċekkjaw l-għotja tal-modulu stess qabel ma twieġbu.
  4. Irrifjutaw b'LICENCE_LOCKED meta l-organizzazzjoni ma tkunx intitolata, u uru t-teaser tal-funzjonalità, qatt id-data tagħha.
  5. Żommu r-repożitorju mal-linja tal-liċenzja, imbagħad ibnu s-siġra komposta ta' kull edizzjoni.
npm ci
npm test
npm run build

Il-prova hija r-regola tal-linja tal-liċenzja: l-ebda import minn scope ta' Community ħlief il-pakkett tal-interfaċċa, l-ebda import relattiv barra mir-repożitorju, u l-ebda dipendenza file:, link: jew workspace: barra minnu. Imbagħad it-tliet kmandi ta' hawn fuq iridu jgħaddu f'kull siġra komposta tal-edizzjoni, mhux biss fis-siġra tax-xogħol tagħkom. Il-Kapitolu 2.25, Bini għal kull edizzjoni, fih l-iskeletru tal-modulu.

Modulu jitgħabba f'servizz ta' Community mal-bidu, fuq installazzjonijiet li l-liċenzja tagħhom iġġorr il-grupp ta' funzjonalitajiet tiegħu. Mingħajr dik l-għotja jirrifjuta, għalhekk l-istess build jinħareġ kullimkien u ma jagħmel xejn fejn mhuwiex liċenzjat.

11. Il-forking jew l-estensjoni tal-qalba miftuħa

L-għan huwa bidla f'Community innifsu, miżmuma fil-fork tagħkom jew ikkontribwita lura. Il-blokk tal-bini huwa s-sors ta' Community taħt l-Apache License, Version 2.0.

  1. Agħmlu fork tar-repożitorju u oħolqu branch minn main.
  2. Ippreferu plugin jew ħila jekk dak li tridu jista' jkun wieħed minnhom. Bidla fil-qalba hija tagħkom biex iżżommuha f'kull rilaxx.
  3. Agħmlu l-bidla b'testijiet li jfallu mingħajrha.
  4. Ħaddmu l-verifiki li jħaddem il-proġett qabel ma tipproponu xi ħaġa.
  5. Żommu l-fajl NOTICE, u tużawx l-ismijiet jew it-trademarks ta' Adverant lil hinn milli tgħidu minn fejn ġie x-xogħol.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Il-prova hija li dawk it-tliet verifiki jgħaddu, flimkien mal-evidenza li kull test ġdid falla qabel il-bidla tagħkom. Żommu propjetà waħda tal-qalba miftuħa vera fil-fork tagħkom: Community iħaddem aġent minn tarf sa tarf fuq mudell lokali mingħajr ċavetta u mingħajr netwerk. Bidla li tkisser dan tkisser dak li jagħmel lil Community użabbli waħdu.

Dan huwa Community biss. Kull ħaġa li għandha tibqa' magħluqa tappartjeni minflok f'modulu Enterprise (xenarju 10), sabiex il-linja tal-liċenzja tibqa' x'imkien fejn kulħadd jista' jindikaha.

12. App fuq il-cloud tal-edizzjoni Team

L-għan huwa app li l-klijenti Team jistgħu jinstallaw. Team jaħdem biss fuq Adverant cloud, għalhekk l-app tilħaqhom biss permezz tal-katalgu. Il-blokki tal-bini huma plugin u publisher cluster: il-cluster virtwali tagħkom stess fuq Adverant cloud b'data ta' kampjun.

  1. Ibnu u ittestjaw fuq il-publisher cluster, b'data ta' kampjun biss.
  2. Iddikjaraw kull ma teħtieġ l-app fil-manifest tagħha, u xejn iktar.
  3. Oħorġuha ffirmata, għar-reviżjoni ta' Adverant u għal elenkar fil-katalgu.
  4. Kull klijent jinstallaha, billi jagħti kull scope iddikjarat unità b'unità.

Il-prova tiġi f'żewġ partijiet. Ir-rilaxx iffirmat u rivedut idaħħalkom fil-katalgu. Imbagħad l-għotja tal-klijent tiddeċiedi x'tista' tilħaq l-app fis-sit tiegħu, u kull sejħa li ma ddikjaratx tiġi rrifjutata b'CONNECTION_SCOPE_EXCEEDED. Tistgħu iżżidu scope nieqes biss f'rilaxx ġdid li jirrevedi l-klijent.

Installa plugin ta' parti terza
Installa plugin ta' parti terza
Amministratur jinstalla plugin ta' parti terza, jagħti kull scope iddikjarat għal kull unità u jħalli wieħed barra. Il-pjanċa turi sejħa li l-plugin qatt ma ddikjara, rrifjutata.

Publisher cluster m'għandu l-ebda rotta lejn xi klijent, u t-talba għad-data ta' klijent hemmhekk tiġi rrifjutata b'TENANT_BOUNDARY. Il-klijenti jistgħu jaqsmu r-riżultati tat-testijiet magħkom, qatt id-data tagħhom. Team jinkludi l-kapaċità tal-operazzjonijiet tal-workflows, għalhekk jekk l-app tagħkom toħroġ workflows, il-klijenti Team jistgħu jippromwovuhom bejn l-ambjenti huma stess.

13. L-inkapsulament ta' app interna eżistenti bħala plugin

L-għan huwa app li l-kumpanija tagħkom diġà tħaddem, imdaħħla f'Nexus sabiex tiret l-aċċess, l-iżolament u l-governanza. Il-blokki tal-bini huma l-ħila /plugin-create għall-ewwel abbozz, u l-għodod tal-manifest u l-gates tal-SDK biex tlestuha.

  1. Ħaddmu /plugin-create bir-repożitorju. Janalizza l-kodiċi u jagħżel strateġija ta' tgeżwir, imbagħad jiġġenera l-backend, il-migrazzjonijiet, l-interfaċċa tal-utent (UI), il-manifest u t-testijiet.
  2. Għollu l-manifest għall-kuntratt v2. migrate iżid it-tliet sentenzi tal-liġi u jċaqlaq domain għal domains[], u jirrifjuta li jivvinta entrypoint.
  3. Ibdlu kull valur tat-tenant li l-wrapper jaqra mill-headers bl-iscope guard tal-SDK.
  4. Żidu organization_id, owner_user_id u business_unit_id ma' kull tabella, b'primary keys li jibdew bit-tenant.
  5. Iddikjaraw kull rotta bid-dritt tagħha, u installaw ir-reġistru tar-rifjuti.
  6. Ħaddmu l-gates sakemm ikunu ħodor.
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-test

Il-prova hija li nexus-gates joħroġ b'0, b'scope-adherence, one-fence, migrations-are-scoped, crud-adherence u api-contract kollha jgħaddu. Stennew li l-ewwel tħaddim ifalli fuq il-biċċa l-kbira tagħhom; tagħna rrapporta kull rotta bħala mingħajr scope, għaliex l-abbozz kien jafda headers li l-browser seta' jissettja. Il-gates m'għandhom l-ebda swiċċ ta' tiswija, apposta.

L-apps imgeżwra jaħdmu fuq kwalunkwe edizzjoni. L-iskjerament isir biss permezz tal-kanali tar-rilaxx tal-installazzjoni, għalhekk injoraw kull fajl tal-iskjerament li kiteb l-abbozz. Ix-xogħol tal-iżolament huwa fejn imur il-ħin: ippjanaw għal jiem fuq app reali, mhux sigħat.