Versija 1.0.0-alpha.1naujausia
2.27 skyrius
Kūrimo scenarijai
Trylikos darinių receptų knyga – nuo vieno įgūdžio iki pristatymo į izoliuotą tinklą. Kiekviename recepte nurodomas tikslas, sudedamosios dalys, žingsniai ir komandos, patikros vartai, įrodantys, kad viskas suveikė, bei tai, kas keičiasi priklausomai nuo leidimo ir pristatymo formos.
Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

Tai receptai, kuriais naudojuosi, kai kas nors iš Corrán Orbital arba iš kliento sako: „norime, kad Nexus darytų X“. Kiekvienas jų sąmoningai trumpas. Žingsnių pagrindimas pateiktas ankstesniuose skyriuose: 2.20 skyriuje „Įgūdžiai“ ir 2.21 skyriuje „Plugin SDK“, kuriame aptariamas programinės įrangos kūrimo rinkinys, tada 2.23 skyriuje „Domenų paketai“ ir trijuose po jo einančiuose skyriuose apie kūrimą. Čia rasite tikslą, kuriuos sudedamuosius blokus naudoti, žingsnius, komandas, patikrą, kuri parodo, kad pavyko, ir pastabas apie leidimą bei pristatymą.
Svarbiausia yra patikra. Receptas baigtas, kai jo patikra žalia. Kiekvieną šio skyriaus patikrą galite paleisti patys arba ją paleidžia platforma, ir kiekviena, kai sąlyga netenkinama, baigiasi nenuliniu kodu arba atsisako pateikdama kodą.
| Scenarijus | Pagrindinis sudedamasis blokas | Tai įrodanti patikra | Leidimas |
|---|---|---|---|
| Naujas Skills Engine įgūdis | SKILL.md paketas |
skill:validate be klaidų |
Community ir Enterprise |
Manifesto įgūdis su host_callback |
Įskiepio manifestas skills[] |
create-nexus-plugin validate ir nexus-gates |
Community ir Enterprise |
| Esamo paketo išplėtimas | pack.json su inherits |
Lęšio politikos patikra bandomojo etapo vartuose | Enterprise ir paketo licencija |
| Naujas paketas nuo nulio | Domeno paketo auksinis kelias | Parengiamosios aplinkos ir bandomojo etapo vartai | Enterprise |
| Duomenų jungtis | plugin_queue įgūdis |
validate, nexus-gates, išeinančio srauto atmetimas |
Community ir Enterprise |
| MCP (Model Context Protocol) įrankis | Manifestas mcpTools[] |
validate (be aukščiausiojo lygio kombinatorių) |
Community ir Enterprise |
| Baltos etiketės parduotuvė | Manifestas domains ir branding |
scope-adherence viešumo taisyklė |
Enterprise ir Storefront priedas |
| Edge misijos paketas | Misijos paketas | Įrenginyje vykdomi testai, du parašai iš trijų | Enterprise ir Nexus Edge priedas |
| Pristatymas į izoliuotą aplinką | Užantspauduotas rinkinys | nexus-airgap verify |
Enterprise |
| Tik Enterprise skirtas modulis | @adverant/nexus-spi |
Licencijos ribos patikra, leidimų versijos | Enterprise |
| Atvirojo branduolio atšakojimas arba išplėtimas | Community šaltinio kodas | Testai, lint ir tipų patikra | Community |
| Team leidimo debesijos programa | Leidėjo klasteris | Pasirašytas leidimas, peržiūra, suteikimas klientui | Team |
| Esamos vidinės programos apgaubimas | /plugin-create |
migrate, validate, nexus-gates |
Community ir Enterprise |
1. Naujas „Skills Engine“ įgūdis
Tikslas – daugkartinio naudojimo instrukcija, kurią gali vykdyti asistentas, agentai, darbo eigos ir kūrėjų įrankiai, pavyzdžiui, muitinės deklaracijos patikra pagal jai taikomas taisykles. Jūsų sudedamieji blokai – SKILL.md paketas aplanke, pavadintame įgūdžio vardu, neprivalomas skill.yaml trigeriams ir žymoms bei neprivalomas kartu pridedamas scripts/ aplankas.
- Sukurkite
skills/<slug>/ir parašykiteSKILL.mdsu antrašte:name(kebab-case, sutampa su aplanko pavadinimu),description(iki 500 simbolių),allowed-toolsir, jei reikia,triggers,capabilitiesbeiversion. - Parašykite turinį modeliui: kada naudoti įgūdį, jo žingsnius, pavyzdžius ir ko jis niekada neturi daryti.
- Pridėkite testų atvejų. Įtraukite vieną su į įvestį įterpta instrukcija, kurios įgūdis neturi vykdyti.
- Patvirtinkite, peržiūrėkite įkėlimo planą, tada įkelkite.
- Paskelbkite. Įgūdis, pridedantis rašymo įrankį, sulaikomas, kol jį passkey patvirtina du įvardyti asmenys, o siūlytojas negali patvirtinti savo paties pakeitimo.
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-filingPatikra yra skill:validate, kuri prieš bet kokį paskelbimą turi pranešti apie nulį klaidų. Blokuojančios klaidos – trūkstamas pavadinimas ar aprašymas ir pasikartojantis slug arba užduoties tipas. Įkeliant jau paskelbtą turinį grąžinama esama versija (CONTENT_HASH_ALREADY_PUBLISHED), todėl įkėlimą saugu kartoti.
Community leidime gaunate visą kūrimo įrankį, biblioteką, versijas, grįžimą atgal, importą ir testus. Enterprise leidime paskelbimas papildomai vyksta per šešėlinį ir kanarėlės diegimą: patvirtinta versija veikia šešėliniu režimu, tada vienam padaliniui už įvardytų vartų, tada visiems, ir ji sustoja pati, jei vartų sąlyga netenkinama. Izoliuotos aplinkos klientui įgūdžiai keliauja iš anksto pasirašyti užantspauduotame rinkinyje (9 scenarijus).
2. Manifesto įgūdis su host_callback
Tikslas – deterministiniai skaičiavimai jūsų pačių įskiepyje, kuriuos platforma gali paskirstyti, pavyzdžiui, nuokrypio įrašo atidarymas pagal rodmenį. Naudosite eilutę manifesto skills[] su lygiu host_callback ir /internal maršrutą savo backend dalyje, apsaugotą SDK paslaugų apsauga.
- Deklaruokite įgūdį:
idlower_snake formatu,tier: "host_callback",classification, neviršijantį jūsų įskiepio pasitikėjimo ribos,inputSchema,outputSchemairtimeoutMsnuo 1 sekundės iki 6 valandų. - Užpildykite
hostCallback: savo Service pavadinimą, jo prievadą, santykinį kelią, pavyzdžiui,/internal/skills/excursion_open, abi baitų ribas (maxRequestBytesirmaxResponseBytes) beitenantHeader: "X-Organization-ID". - Deklaruokite maršrutą
api.endpoints[]suauth: "service-key"arbaauth: "internal"ir apsaugokite jįrequireServicearbaserviceMiddleware, niekada ne naudotojo srities apsauga. - Patvirtinkite, paleiskite patikras ir leiskite įdiegimo procesui sinchronizuoti įgūdžius su registru per
compileRegistry. Registro SQL niekada nerašote ranka.
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 prieš bet kokią sinchronizaciją pritaiko pačios registro sinchronizacijos taisykles ir kiekvieną pažeidimą atmeta su gavėjo kodu. Kelias su schema, // arba atgaliniu brūkšniu atmetamas kaip kitos kilmės. Trūkstama baitų riba – ENDPOINT_BYTE_CAP_REQUIRED, kito lygio laukas – FIELD_NOT_FOR_TIER, o intervalo neatitinkantis laiko limitas – TIMEOUT_OUT_OF_BOUNDS. Tada nexus-gates patikrina, ar /internal maršrutas turi paslaugų apsaugą ir yra deklaruotas internal arba service-key. Ši vartų pora ir yra įrodymas.
Sinchronizacija yra deklaratyvi. Kiekvieną kartą siųskite visą įgūdžių rinkinį, nes praleistas įgūdis išjungiamas, ir nutraukite diegimo žingsnį esant bet kokiai kitai būsenai nei 200. Enterprise leidime įskiepio sinchronizacija tikrinama kaip visuma: jei vienas įgūdis pažeidžia taisyklę, nepriimama nieko iš tos sinchronizacijos (PLUGIN_SYNC_ALL_OR_NOTHING), o ankstesnė versija toliau veikia. Bendruomenės pasitikėjimo įskiepis negali naudoti lygių, pasiekiančių modelį, tool_using ir llm_only; jiems reikia pasitikėjimo core arba verified.
3. Esamo paketo išplėtimas
Tikslas – nauja pramonės šaka ar jos poskyris, pakartotinai naudojantis didžiąją esamo paketo dalį, pavyzdžiui, skolinimas ir kortelių ginčai, paremti Insurance paketo struktūra. Sudedamasis blokas – pack.json, kuris inherits nurodo savo tėvinį paketą ir prideda tik savo lęšių grupes ir žodžius.
- Pradėkite paketą domeno paketo auksiniu keliu, tada nustatykite
inheritsį tėvinio paketo id. - Pridėkite savo
lensgrupes, kiekvieną su vietomis, paskirtimi ir leksikono nuoroda. - Pridėkite savo žodžius į leksikoną, kiekvienam pateikdami paprastą paaiškinimą. Pažymėkite terminą
exact, kai jis turi būti rodomas taip, kaip parašytas. - Naudokite bendrus lęšius, užuot kūrę savo: kelių paketų reikalaujamas režimas, pavyzdžiui, užsakomųjų technologijų registras, yra vienas bendras lęšis.
- Patikrinkite licencijų grandinę. Jūsų paketas paveldi tėvinio paketo priedų reikalavimus.
- Peržiūrėkite kiekvieną lęšį kaip konkretus asmuo sintetinėje šakoje.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Įrodymas – bandomojo etapo vartų politikos patikra, patvirtinanti, kad kiekvienas lęšis tik siaurina savo bazę ir pagal numatytuosius nustatymus nerodo asmeninių laukų. Lęšis, bandantis rodyti tai, ką jo bazė slepia, atmetamas su LENS_CANNOT_WIDEN. Licencijavimo pusėje konsolė atsisako išduoti licenciją jūsų paketui be priedų, kurių reikia tėviniam paketui; Insurance paketui reikia Decision rooms ir užantspauduotų įrašų.
Domenų paketai yra Enterprise funkcija ir licencijuojami atskirai kiekvienam paketui. Paketo telefono ekranams taip pat reikia Mobile apps priedo. Vaikinis paketas negali keisti apvalkalo, komponentų ar rašymo taisyklių.
4. Naujas paketas nuo nulio
Tikslas – vienos pramonės šakos Nexus vaizdas: jos žinių modelis, kiekvieno vaidmens lęšiai, jos taisyklių reikalaujami įrodymai ir įskiepis, palaikantis jos duomenų aktualumą. 2.24 skyriuje „Individualaus vertikalaus sprendimo kūrimas nuo pradžios iki galo“ šis kūrimas aprašytas išsamiai; čia pateikiama trumpa versija.
- Paleiskite domeno paketo auksinį kelią ir aprašykite paketą: paskirtį, padalinius, bazinį modelį ir taisykles, kurias jis atvaizduoja.
- Kurkite žinių modelį ant bazinio modelio ir klasifikuokite kiekvieną savybę ją pridėdami.
- Perskaitykite planą, patvirtinkite jo kontrolinį kodą savo passkey ir sukurkite.
- Suformuokite lęšius Lens builder, kiekvienas iš jų siaurina bazinį lęšį.
- Parašykite įskiepį ir visus paketui reikalingus Skills Engine įgūdžius.
- Sugeneruokite sintetinius duomenis su sėkla ir jums svarbiais neįprastais atvejais, tada peržiūrėkite kiekvieną lęšį kaip konkretus asmuo.
- Perkelkite iš kūrimo erdvės į parengiamąją aplinką, į bandomąjį padalinį, tada į visus padalinius.
Įrodymas – perkėlimo vartai: į parengiamąją aplinką – visi testai sėkmingi sintetinėse šakose, tada du peržiūrėtojai, kurie nėra autoriai, tada 14 dienų bandomajame etape su klaidomis, mažesnėmis nei 1 iš 1,000. Jokio žingsnio praleisti negalima (GATE_CANNOT_BE_SKIPPED). Paketai yra Enterprise funkcija. Community leidime domeno paketo auksinis kelias nesiūlomas.
5. Duomenų jungtis
Tikslas – pagal tvarkaraštį į jūsų įskiepio lenteles tekantys duomenys iš išorinės sistemos, pavyzdžiui, vartų įvykiai iš terminalo operacinės sistemos. Sudedamieji blokai – plugin_queue įgūdis, darbuotojas, imantis užduotis iš jūsų eilės, tikslinės lentelės migracija ir manifeste deklaruotas išeinantis adresas.
- Deklaruokite
plugin_queueįgūdį suqueueName, užrašytu<plugin name>.<name>. Dvitaškis neleidžiamas, o pavadinimas turi būti manifeste, nes orkestratorius į jį įtraukia užduotis tiesiogiai. - Parašykite darbuotoją, kuris ima užduotis iš eilės ir kreipiasi į išorinę sistemą.
- Deklaruokite išorinės sistemos adresą kaip išeinantį adresą. Visa, kas neišvardyta, blokuojama.
- Gautus duomenis saugokite savo schemoje, kiekvienoje eilutėje nurodydami
organization_id,owner_user_idirbusiness_unit_id. - Išorinės sistemos prisijungimo duomenis skaitykite pagal pavadinimą iš aplinkos ir įtraukite kintamąjį į
scripts/ci/required-env. - Užklausas paskirstykite per UNO, darbo eigų variklį, niekada ne laikmačiu, kuris tiesiogiai kviečia variklius.
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 patikrina eilės pavadinimą ir laiko limitą pagal registro sinchronizacijos taisykles. Trys vartai įrodo, kad nėra modelio prisijungimo duomenų, nėra tiesioginių skaičiavimų ir lentelė tinkamai apribota. Prieš siųsdami paleiskite visą nexus-gates, nes --only susiaurina vykdymą ir tai nurodo santraukoje. Vykdymo metu kreipinys į adresą, kurio manifestas nedeklaravo, sustabdomas ties kraštu su EGRESS_NOT_DECLARED.
Pačios platformos jungtys su diskais, wiki, pašto saugyklomis ir senosiomis sistemomis, su pakeitimų fiksavimu ir kilmės sekimu, teikiamos su Data connectors priedu. Jūsų pačių sukurta jungtis yra įskiepis ir veikia bet kuriame leidime. Išeinančio adreso pridėjimas vėlesniame leidime yra išplėtimas, sulaikomas, kol jį priims du peržiūrėtojai.
6. MCP įrankis
Tikslas – įrankis, kurį gali iškviesti Claude Code, agentai ir kiti MCP (Model Context Protocol) klientai, pavyzdžiui, laivo patikrinimų istorijos paieška. Sudedamasis blokas – įrašas manifesto mcpTools[] su name, description ir inputSchema.
- Pavadinkite įrankį ir aprašykite jį paprastai. Aprašymą skaito modelis, spręsdamas, ar jį iškviesti.
- Parašykite
inputSchemakaip vieną objekto schemą. NedėkiteoneOf,allOfaranyOfjos aukščiausiame lygyje. - Įrankį aptarnaujantį maršrutą laikykite už srities apsaugos, kaip ir visus kitus
/apimaršrutus, kad nuomininkas būtų nustatomas pagal kviečiančiojo žetoną. - Patvirtinkite manifestą.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonĮrodymas – validate: aukščiausiojo lygio kombinatorius atmetamas kūrimo metu, nes vykdymo metu dėl jo įrankis neveiktų jokiam jį importuojančiam MCP subagentui, ir įrankis egzistuotų, bet niekas negalėtų jo iškviesti.
Enterprise leidime kiekvienas IDE (integruotos kūrimo aplinkos) iškviečiamas įrankis įtraukiamas į Workbench įrankių katalogą su jo lygiu, nurodymu, ar jis ką nors keičia, prisegtu kontroliniu kodu ir vaidmenimis, kuriems leidžiama jį naudoti. Jei naujame leidime pasikeičia jūsų įrankio aprašymas, katalogas sulaiko įrankį, kol pakeitimą peržiūri žmogus. Tai sąmoninga: pakeistas aprašymas yra būdas, kuriuo įrankis gali pradėti prašyti modelio to, ko neturėtų. Kreipinys į bet ką už kviečiančiojo leidimo ribų atmetamas su CONNECTION_SCOPE_EXCEEDED.
7. Baltosios etiketės vitrina
Tikslas – programa, kuria naudojasi jūsų kliento klientai, kliento domene ir su kliento prekės ženklu, be jokių Adverant pėdsakų. Sudedamieji blokai – manifesto domains ir branding blokai, SDK prisijungimo pagalbinės priemonės ir kliento Storefront / white-label priedas.
- Įrašykite kliento domeną į
domains[]kaipprimary, kartu su visaisaliases. - Užpildykite
branding:appName,tagline,primaryColor,accentColor,passkeyRpId, sutampantį su domenu, iroauthClientRef. - Prijunkite žmones per SDK prisijungimo pagalbines priemones ir tiksliai deklaruokite jų du viešuosius maršrutus su
auth: "public"irallowAnonymous: true. - Kiekvieną frontend kreipinį siųskite per backend for frontend leidžiamųjų sąrašo tarpinį serverį. Niekada nedėkite paslaugos adreso į klientą.
- Mokėjimus palikite kliento administratoriui, kuris prijungia mokėjimų šliuzus ir sukonfigūruoja firminį atsiskaitymą.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractĮrodymas – scope-adherence. Jis leidžia neapsaugotą /api maršrutą tik tada, kai manifestas deklaruoja būtent tą metodą ir kelią kaip viešą ir kelias yra vienas iš prisijungimo maršrutų; bet kokia kita vieša deklaracija nepraeina ir nurodo du leidžiamus kelius. Tada api-contract palygina deklaruotus maršrutus su tikraisiais abiem kryptimis. definePlugin taip pat atmeta frontend.basePath, kuris nėra santykinis tos pačios kilmės kelias.
Baltoji etiketė yra Enterprise plano papildinys „Storefront / baltoji etiketė“, kuris taip pat licencijuoja mokėjimus. Kortelės duomenys niekada nepasiekia Nexus. Prekės ženklas priklauso kliento administratoriui, o platforma jį nustato pagal organizaciją, o ne pagal jūsų kodą.
8. „Edge“ misijos paketas
Tikslas yra nauja arba atnaujinta misija palydovui ar dronui, kuriame veikia Nexus Edge, pavyzdžiui, laivų paieškos adapterio pridėjimas prie jūrinio stebėjimo misijos. Pagrindinis elementas yra misijos paketas, sukurtas ir pasirašytas antžeminėje stotyje.
- Pradėkite nuo dabartinio paketo puslapyje „Misijos paketo kūrimas“, kuris parengia naujos versijos juodraštį pagal senąją ir pažymi kiekvieną pakeitimą.
- Keiskite tik tai, ko reikia misijai. Kai įmanoma, didžiąsias dalis, kalbos modelį ir ontologiją, palikite nepakeistas.
- Kiekviename sumažinto pajėgumo žingsnyje patikrinkite išdėstymo lentelę, kad kiekviena plokštė vis dar atitiktų tai, ką ji vykdo.
- Paleiskite paketo borto bandymų atvejus bandymų stende su tokiomis pačiomis plokštėmis.
- Pateikite jį pasirašyti: reikia dviejų iš trijų parašų.
- Išleiskite jį vienai platformai. Jis įrašomas į laisvą lizdą ir įjungiamas tik tada, kai jo bandymų atvejai sėkmingai įvykdomi borte.
- Po savaitės be klaidų diekite kitoje platformoje.
Šiame recepte komandų nėra; jis atliekamas konsolės Nexus Edge puslapiuose. Įrodymas yra borto bandymų atvejai, kurie visi turi būti sėkmingai įvykdyti prieš įjungiant paketą, ir du parašai. Jei bandymas borte nepavyksta, platforma lieka su ankstesniu paketu, o klaida atsiunčiama per kitą perskridimą. Paketo diegimas aparatinėje įrangoje, kuriai jis nebuvo patikrintas, atmetamas su PACK_NOT_CHECKED_FOR_HARDWARE.
Nexus Edge yra papildinys, licencijuojamas kiekvienai platformai arba visam parkui. Paketai lieka galioti, kol platforma neturi ryšio. Siuntimo kanalas siauras, todėl planuokite dydžius atsižvelgdami į jį: mūsų 1.5 leidimas buvo 412 MB, palyginti su 9.8 GB paketui su nauju kalbos modeliu.
9. Pristatymas klientui į izoliuotą tinklą
Tikslas yra jūsų įskiepis arba paketas, įdiegtas kliento vietoje be tinklo. Pagrindiniai elementai yra užantspauduotas rinkinys iš @adverant/nexus-sovereign, jūsų leidimų pasirašymo raktas ir paties kliento leidimų kanalai.
- Sukurkite įskiepį ir jo atvaizdus lygiai taip pat, kaip prijungtam klientui, su visais sėkmingai įveiktais patikros etapais.
- Sukurkite užantspauduotą rinkinį su
airgapprofiliu, apimantį atvaizdus, migracijas, iš anksto pasirašytus įgūdžius ir SBOM (programinės įrangos komponentų sąrašą) su licencijomis. - Pasirašykite jį savo Ed25519 leidimų raktu.
- Patys jį patikrinkite švariame kompiuteryje.
- Išsiųskite rinkinį laikmenoje, o savo viešąjį raktą ir rinkinio SHA-256 išsiųskite atskiru keliu.
- Kliento operatorius patikrina rinkinį jūsų raktu, tada įdiegia leidimą per savo leidimų kanalus.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle sukuria rinkinį pagal jūsų rinkinio konfigūraciją. Įrodymas yra nexus-airgap verify kliento pusėje. Jis iš naujo apskaičiuoja kiekvieno failo maišos reikšmę, atmeta bet kurį manifeste neišvardytą failą, reikalauja patikimo pasirašytojo ir atmeta rinkinį, kurio leidžiamų tinklų sąrašas nėra tuščias. Pakeistas failas sukelia klaidą BUNDLE_INTEGRITY_VIOLATION. Niekas niekada neturėtų išjungti griežto tikrinimo, kad ją apeitų.
Izoliuoti nuo tinklo diegimai yra Enterprise plano dalis. Niekas rinkinyje diegimo metu negali nieko atsisiųsti, o įskiepiui reikalingas modelis gaunamas iš paties kliento modelių serverio per DI (dirbtinio intelekto) tiekėjų maršrutizatorių.
10. Tik „Enterprise“ skirtas modulis
Tikslas yra uždara, licencijuojama funkcija, prijungiama prie atvirojo branduolio, pavyzdžiui, ilgo saugojimo audito žurnalas, parduodamas tik Enterprise klientams. Pagrindinis elementas yra sąsajos paketas @adverant/nexus-spi ir niekas daugiau iš Community.
- Laikykite savo saugykloje baitų tikslumu prisegtą sukurto sąsajos paketo kopiją kaip vietinį
file:paketą su joSHA256SUMSprisegimu. - Parašykite
RouteModule(arbaScreenModulekonsolės ekranams) pagal jį, nurodydami funkcijų grupę, kuriai jis skirtas. - Vykdykite kiekvieną maršrutą per
ctx.requireScopeir prieš atsakydami patikrinkite paties modulio suteiktą teisę. - Kai organizacija neturi teisės, atmeskite su
LICENCE_LOCKEDir rodykite funkcijos pristatymą, niekada ne jos duomenis. - Užtikrinkite, kad saugykla atitiktų licencijos ribą, tada sukurkite kiekvieno leidimo sudarytą medį.
npm ci
npm test
npm run buildĮrodymas yra licencijos ribos taisyklė: jokio importo iš Community srities, išskyrus sąsajos paketą, jokio santykinio importo už saugyklos ribų ir jokios file:, link: ar workspace: priklausomybės už jos ribų. Tada trys aukščiau nurodytos komandos turi būti sėkmingai įvykdytos kiekvieno leidimo sudarytame medyje, o ne tik jūsų darbiniame medyje. 2.25 skyriuje „Kūrimas kiekvienam leidimui“ pateiktas modulio karkasas.
Modulis įkeliamas į Community paslaugą jos paleidimo metu tuose diegimuose, kurių licencija apima jo funkcijų grupę. Be šios teisės jis atsisako veikti, todėl tas pats komplektas tiekiamas visur ir nieko nedaro ten, kur nėra licencijuotas.
11. Atvirojo branduolio atšakojimas arba išplėtimas
Tikslas yra pačios Community pakeitimas, laikomas jūsų atšakoje arba grąžinamas projektui. Pagrindinis elementas yra Community pirminis kodas, platinamas pagal Apache License, Version 2.0.
- Sukurkite saugyklos atšaką ir šaką nuo
main. - Jei tai, ko norite, gali būti įskiepis ar įgūdis, rinkitės juos. Branduolio pakeitimą turėsite prižiūrėti patys kiekviename leidime.
- Atlikite pakeitimą su testais, kurie be jo nepavyksta.
- Prieš ką nors siūlydami paleiskite projekto naudojamas patikras.
- Išsaugokite NOTICE failą ir nenaudokite Adverant pavadinimų ar prekių ženklų, išskyrus nurodant, iš kur kilo darbas.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckĮrodymas yra tos trys sėkmingai įvykdytos patikros ir įrodymai, kad kiekvienas naujas testas nepavykdavo prieš jūsų pakeitimą. Išsaugokite savo atšakoje vieną atvirojo branduolio savybę: Community nuo pradžios iki galo vykdo agentą vietiniame modelyje be rakto ir be tinklo. Pakeitimas, kuris tai pažeidžia, pažeidžia tai, kas daro Community tinkamą naudoti savarankiškai.
Tai skirta tik Community. Viskas, kas turi likti uždara, priklauso Enterprise moduliui (10 scenarijus), kad licencijos riba liktų ten, kur ją gali nurodyti kiekvienas.
12. „Team“ leidimo debesijos programa
Tikslas yra programa, kurią gali įdiegti Team klientai. Team veikia tik Adverant debesyje, todėl programa juos pasiekia tik per katalogą. Pagrindiniai elementai yra įskiepis ir leidėjo klasteris: jūsų nuosavas virtualus klasteris Adverant debesyje su pavyzdiniais duomenimis.
- Kurkite ir testuokite leidėjo klasteryje, naudodami tik pavyzdinius duomenis.
- Programos manifeste deklaruokite viską, ko jai reikia, ir nieko daugiau.
- Išleiskite ją pasirašytą, kad Adverant ją peržiūrėtų ir įtrauktų į katalogą.
- Kiekvienas klientas ją įdiegia, suteikdamas kiekvieną deklaruotą sritį kiekvienam padaliniui atskirai.
Įrodymas susideda iš dviejų dalių. Pasirašytas, peržiūrėtas leidimas įtraukia jus į katalogą. Tada kliento suteiktos teisės lemia, ką programa gali pasiekti jo vietoje, o bet koks nedeklaruotas iškvietimas atmetamas su CONNECTION_SCOPE_EXCEEDED. Trūkstamą sritį galite pridėti tik naujame leidime, kurį peržiūri klientas.
Leidėjo klasteris neturi kelio iki jokio kliento, o užklausa dėl kliento duomenų ten atmetama su TENANT_BOUNDARY. Klientai gali pasidalyti su jumis testų rezultatais, bet niekada savo duomenimis. Team apima darbo eigų operacijų funkciją, todėl jei jūsų programa pateikia darbo eigas, Team klientai gali patys perkelti jas tarp aplinkų.
13. Esamos vidinės programos apgaubimas kaip įskiepio
Tikslas yra jūsų įmonėje jau veikianti programa, perkelta į Nexus, kad paveldėtų prisijungimą, izoliaciją ir valdymą. Pagrindiniai elementai yra /plugin-create įgūdis pirmajam juodraščiui ir SDK manifesto įrankiai bei patikros etapai jam užbaigti.
- Paleiskite
/plugin-createsu saugykla. Jis išanalizuoja kodą ir parenka apgaubimo strategiją, tada sugeneruoja vidinę dalį, migracijas, naudotojo sąsają (UI), manifestą ir testus. - Atnaujinkite manifestą iki v2 kontrakto.
migrateprideda tris taisyklių sakinius ir perkeliadomainįdomains[], tačiau atsisako išgalvoti įėjimo tašką. - Pakeiskite bet kokią nuomininko reikšmę, kurią apgaubas skaito iš antraščių, SDK srities apsauga.
- Pridėkite
organization_id,owner_user_idirbusiness_unit_idprie kiekvienos lentelės, su pirminiais raktais, prasidedančiais nuomininku. - Deklaruokite kiekvieną maršrutą su jo teise ir įdiekite atmetimų žurnalą.
- Vykdykite patikros etapus, kol visi bus sėkmingi.
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Įrodymas yra nexus-gates baigimas su kodu 0, kai scope-adherence, one-fence, migrations-are-scoped, crud-adherence ir api-contract yra sėkmingai įvykdyti. Tikėkitės, kad pirmą kartą dauguma jų nepavyks; mūsų atveju kiekvienas maršrutas buvo pažymėtas kaip neapribotas sritimi, nes juodraštis pasitikėjo antraštėmis, kurias galėjo nustatyti naršyklė. Patikros etapai sąmoningai neturi taisymo jungiklio.
Apgaubtos programos veikia bet kuriame leidime. Diegiama tik per diegimo leidimų kanalus, todėl nepaisykite jokių juodraščio parašytų diegimo failų. Daugiausia laiko užima izoliacijos darbas: realiai programai planuokite dienas, o ne valandas.


