PrisijungtiUžsisakyti pristatymą

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

25 min. skaitymo

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
Sprendimų medis, skaitomas iš viršaus į apačią. Pirmasis rombas klausia „Ar jam reikia nuolat veikiančio kodo?“. „Ne“ veda į rombą „Ar tai instrukcijos asistentui?“, kurio „Taip“ baigiasi ties „Skills Engine įgūdis“, o „Ne“ baigiasi ties „Esamo paketo lęšis“. „Taip“ veda į rombą „Ar tai vienos pramonės šakos platformos vaizdas?“, kurio „Taip“ baigiasi ties „Srities paketas (su savo įskiepiu)“, o „Ne“ veda į paskutinį rombą „Ar jis turi likti uždaras ir licencijuotas?“, kuris baigiasi ties „Enterprise modulis“ atsakius „Taip“ ir „Įskiepis“ atsakius „Ne“.
Nuo kurio sudedamojo bloko pradėti.

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.

  1. Sukurkite skills/<slug>/ ir parašykite SKILL.md su antrašte: name (kebab-case, sutampa su aplanko pavadinimu), description (iki 500 simbolių), allowed-tools ir, jei reikia, triggers, capabilities bei version.
  2. Parašykite turinį modeliui: kada naudoti įgūdį, jo žingsnius, pavyzdžius ir ko jis niekada neturi daryti.
  3. Pridėkite testų atvejų. Įtraukite vieną su į įvestį įterpta instrukcija, kurios įgūdis neturi vykdyti.
  4. Patvirtinkite, peržiūrėkite įkėlimo planą, tada įkelkite.
  5. 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-filing

Patikra 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.

  1. Deklaruokite įgūdį: id lower_snake formatu, tier: "host_callback", classification, neviršijantį jūsų įskiepio pasitikėjimo ribos, inputSchema, outputSchema ir timeoutMs nuo 1 sekundės iki 6 valandų.
  2. Užpildykite hostCallback: savo Service pavadinimą, jo prievadą, santykinį kelią, pavyzdžiui, /internal/skills/excursion_open, abi baitų ribas (maxRequestBytes ir maxResponseBytes) bei tenantHeader: "X-Organization-ID".
  3. Deklaruokite maršrutą api.endpoints[] su auth: "service-key" arba auth: "internal" ir apsaugokite jį requireService arba serviceMiddleware, niekada ne naudotojo srities apsauga.
  4. 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-test

validate 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.

Papildiniai ir MCP sinchronizavimas
Papildiniai ir MCP sinchronizavimas
Įgūdžius pateikiantys įskiepiai ir tai, kas buvo patikrinta per kiekvieną sinchronizaciją. Atkreipkite dėmesį į įskiepį, kurio sinchronizacija atmesta visa, nes vienas iš penkių jo įgūdžių naudojo lygį, kurį gali talpinti tik platforma, o ankstesnė jo versija toliau veikė.

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.

  1. Pradėkite paketą domeno paketo auksiniu keliu, tada nustatykite inherits į tėvinio paketo id.
  2. Pridėkite savo lens grupes, kiekvieną su vietomis, paskirtimi ir leksikono nuoroda.
  3. 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.
  4. 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.
  5. Patikrinkite licencijų grandinę. Jūsų paketas paveldi tėvinio paketo priedų reikalavimus.
  6. 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.

  1. Paleiskite domeno paketo auksinį kelią ir aprašykite paketą: paskirtį, padalinius, bazinį modelį ir taisykles, kurias jis atvaizduoja.
  2. Kurkite žinių modelį ant bazinio modelio ir klasifikuokite kiekvieną savybę ją pridėdami.
  3. Perskaitykite planą, patvirtinkite jo kontrolinį kodą savo passkey ir sukurkite.
  4. Suformuokite lęšius Lens builder, kiekvienas iš jų siaurina bazinį lęšį.
  5. Parašykite įskiepį ir visus paketui reikalingus Skills Engine įgūdžius.
  6. Sugeneruokite sintetinius duomenis su sėkla ir jums svarbiais neįprastais atvejais, tada peržiūrėkite kiekvieną lęšį kaip konkretus asmuo.
  7. 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.

  1. Deklaruokite plugin_queue įgūdį su queueName, užrašytu <plugin name>.<name>. Dvitaškis neleidžiamas, o pavadinimas turi būti manifeste, nes orkestratorius į jį įtraukia užduotis tiesiogiai.
  2. Parašykite darbuotoją, kuris ima užduotis iš eilės ir kreipiasi į išorinę sistemą.
  3. Deklaruokite išorinės sistemos adresą kaip išeinantį adresą. Visa, kas neišvardyta, blokuojama.
  4. Gautus duomenis saugokite savo schemoje, kiekvienoje eilutėje nurodydami organization_id, owner_user_id ir business_unit_id.
  5. Išorinės sistemos prisijungimo duomenis skaitykite pagal pavadinimą iš aplinkos ir įtraukite kintamąjį į scripts/ci/required-env.
  6. 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-env

validate 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.

  1. Pavadinkite įrankį ir aprašykite jį paprastai. Aprašymą skaito modelis, spręsdamas, ar jį iškviesti.
  2. Parašykite inputSchema kaip vieną objekto schemą. Nedėkite oneOf, allOf ar anyOf jos aukščiausiame lygyje.
  3. Įrankį aptarnaujantį maršrutą laikykite už srities apsaugos, kaip ir visus kitus /api maršrutus, kad nuomininkas būtų nustatomas pagal kviečiančiojo žetoną.
  4. 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.

  1. Įrašykite kliento domeną į domains[] kaip primary, kartu su visais aliases.
  2. Užpildykite branding: appName, tagline, primaryColor, accentColor, passkeyRpId, sutampantį su domenu, ir oauthClientRef.
  3. Prijunkite žmones per SDK prisijungimo pagalbines priemones ir tiksliai deklaruokite jų du viešuosius maršrutus su auth: "public" ir allowAnonymous: true.
  4. Kiekvieną frontend kreipinį siųskite per backend for frontend leidžiamųjų sąrašo tarpinį serverį. Niekada nedėkite paslaugos adreso į klientą.
  5. 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.

  1. Pradėkite nuo dabartinio paketo puslapyje „Misijos paketo kūrimas“, kuris parengia naujos versijos juodraštį pagal senąją ir pažymi kiekvieną pakeitimą.
  2. Keiskite tik tai, ko reikia misijai. Kai įmanoma, didžiąsias dalis, kalbos modelį ir ontologiją, palikite nepakeistas.
  3. Kiekviename sumažinto pajėgumo žingsnyje patikrinkite išdėstymo lentelę, kad kiekviena plokštė vis dar atitiktų tai, ką ji vykdo.
  4. Paleiskite paketo borto bandymų atvejus bandymų stende su tokiomis pačiomis plokštėmis.
  5. Pateikite jį pasirašyti: reikia dviejų iš trijų parašų.
  6. Išleiskite jį vienai platformai. Jis įrašomas į laisvą lizdą ir įjungiamas tik tada, kai jo bandymų atvejai sėkmingai įvykdomi borte.
  7. Po savaitės be klaidų diekite kitoje platformoje.
Misijų paketai
Misijų paketai
Misijų paketų biblioteka, kurioje nurodyta, ką apima kiekvienas paketas ir kuriose platformose jis veikia. Atkreipkite dėmesį į senesnę versiją, laikomą borte, kad būtų galima prie jos grįžti, ir į bandymų atvejų skaičių, kurį kiekvienas paketas turi sėkmingai įvykdyti savo aparatinėje įrangoje.

Š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.

  1. Sukurkite įskiepį ir jo atvaizdus lygiai taip pat, kaip prijungtam klientui, su visais sėkmingai įveiktais patikros etapais.
  2. Sukurkite užantspauduotą rinkinį su airgap profiliu, apimantį atvaizdus, migracijas, iš anksto pasirašytus įgūdžius ir SBOM (programinės įrangos komponentų sąrašą) su licencijomis.
  3. Pasirašykite jį savo Ed25519 leidimų raktu.
  4. Patys jį patikrinkite švariame kompiuteryje.
  5. Išsiųskite rinkinį laikmenoje, o savo viešąjį raktą ir rinkinio SHA-256 išsiųskite atskiru keliu.
  6. 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 airgap

nexus-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.

  1. Laikykite savo saugykloje baitų tikslumu prisegtą sukurto sąsajos paketo kopiją kaip vietinį file: paketą su jo SHA256SUMS prisegimu.
  2. Parašykite RouteModule (arba ScreenModule konsolės ekranams) pagal jį, nurodydami funkcijų grupę, kuriai jis skirtas.
  3. Vykdykite kiekvieną maršrutą per ctx.requireScope ir prieš atsakydami patikrinkite paties modulio suteiktą teisę.
  4. Kai organizacija neturi teisės, atmeskite su LICENCE_LOCKED ir rodykite funkcijos pristatymą, niekada ne jos duomenis.
  5. 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.

  1. Sukurkite saugyklos atšaką ir šaką nuo main.
  2. 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.
  3. Atlikite pakeitimą su testais, kurie be jo nepavyksta.
  4. Prieš ką nors siūlydami paleiskite projekto naudojamas patikras.
  5. 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.

  1. Kurkite ir testuokite leidėjo klasteryje, naudodami tik pavyzdinius duomenis.
  2. Programos manifeste deklaruokite viską, ko jai reikia, ir nieko daugiau.
  3. Išleiskite ją pasirašytą, kad Adverant ją peržiūrėtų ir įtrauktų į katalogą.
  4. 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.

Įdiegti trečiosios šalies papildinį
Įdiegti trečiosios šalies papildinį
Administratorius diegia trečiosios šalies įskiepį, suteikdamas kiekvieną deklaruotą sritį kiekvienam padaliniui ir vieną praleisdamas. Lentelėje rodomas iškvietimas, kurio įskiepis niekada nedeklaravo, atmestas.

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.

  1. Paleiskite /plugin-create su saugykla. Jis išanalizuoja kodą ir parenka apgaubimo strategiją, tada sugeneruoja vidinę dalį, migracijas, naudotojo sąsają (UI), manifestą ir testus.
  2. Atnaujinkite manifestą iki v2 kontrakto. migrate prideda tris taisyklių sakinius ir perkelia domain į domains[], tačiau atsisako išgalvoti įėjimo tašką.
  3. Pakeiskite bet kokią nuomininko reikšmę, kurią apgaubas skaito iš antraščių, SDK srities apsauga.
  4. Pridėkite organization_id, owner_user_id ir business_unit_id prie kiekvienos lentelės, su pirminiais raktais, prasidedančiais nuomininku.
  5. Deklaruokite kiekvieną maršrutą su jo teise ir įdiekite atmetimų žurnalą.
  6. 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.