BejelentkezésBemutató kérése

2.27. fejezet

Fejlesztési forgatókönyvek

Tizenhárom felépítést bemutató receptgyűjtemény, egyetlen képességtől (skill) a zárt hálózatú (air-gapped) szállításig. Minden recept megadja a célt, az építőelemeket, a lépéseket és parancsokat, a működést igazoló ellenőrző kaput, valamint azt, hogy mi változik a kiadás és a szállítási forma függvényében.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

25 perc olvasási idő

Ezekhez a receptekhez nyúlok, amikor valaki a Corrán Orbitalnál vagy egy ügyfélnél azt mondja: „azt szeretnénk, hogy a Nexus X-et tegye”. Mindegyik szándékosan rövid. A lépések mögötti indoklás az ezt megelőző fejezetekben található: 2.20. fejezet, Skills, és 2.21. fejezet, The Plugin SDK, amely a szoftverfejlesztői készletet tárgyalja, majd 2.23. fejezet, Domain packs, valamint az azt követő három, az építésről szóló fejezet. Itt megkapja a célt, azt, hogy mely építőelemeket használja, a lépéseket, a parancsokat, a kaput, amely jelzi, hogy sikerült, valamint a kiadásra és a szállításra vonatkozó megjegyzéseket.

A kapu a legfontosabb. Egy recept akkor kész, ha a kapuja zöld. Ebben a fejezetben minden kapu olyasmi, amit Ön futtathat, vagy amit a platform futtat Ön helyett, és mindegyik nem nulla kóddal lép ki, vagy egy kóddal elutasít, ha a feltétel nem teljesül.

Forgatókönyv Fő építőelem A bizonyító kapu Kiadás
Új Skills Engine-skill SKILL.md-csomag skill:validate nulla hibával Community és Enterprise
Manifestskill host_callback használatával Plugin-manifest: skills[] create-nexus-plugin validate és nexus-gates Community és Enterprise
Meglévő csomag bővítése pack.json, inherits mezővel Lens-szabályzat ellenőrzése a pilotkapunál Enterprise és csomaglicenc
Új csomag a nulláról Domain pack golden path Staging- és pilotkapuk Enterprise
Adatösszekötő plugin_queue-skill validate, nexus-gates, kimenő forgalom elutasítása Community és Enterprise
MCP- (Model Context Protocol-) eszköz Manifest: mcpTools[] validate (felső szintű kombinátorok nélkül) Community és Enterprise
White-label áruház Manifest: domains és branding scope-adherence nyilvános szabály Enterprise és a Storefront kiegészítő
Edge-küldetéscsomag Küldetéscsomag Fedélzeti tesztesetek, háromból két aláírás Enterprise és a Nexus Edge kiegészítő
Air-gapped szállítás Lezárt csomag nexus-airgap verify Enterprise
Csak Enterprise-modul @adverant/nexus-spi Licenchatár-kapu, kiadásonkénti buildek Enterprise
A nyílt mag forkolása vagy bővítése A Community forráskód Tesztek, lint és típusellenőrzés Community
Team-kiadású felhőalkalmazás Kiadói fürt Aláírt kiadás, felülvizsgálat, ügyfélengedély Team
Meglévő belső alkalmazás becsomagolása /plugin-create migrate, validate, nexus-gates Community és Enterprise
Felülről lefelé olvasandó döntési fa. Az első rombusz azt kérdezi: „Szükséges, hogy kód folyamatosan fusson?”. A „Nem” egy „Ez egy asszisztensnek szóló utasítás?” rombuszhoz vezet, amelynek „Igen” ága a „Skills Engine képesség” elemnél, „Nem” ága pedig a „Nézet (lens) egy meglévő csomagon” elemnél ér véget. Az „Igen” egy „Ez a platform egyetlen iparágra szabott nézete?” rombuszhoz vezet, amelynek „Igen” ága a „Szakterületi csomag (a pluginjával)” elemnél ér véget, „Nem” ága pedig egy utolsó, „Zártnak és licenceltnek kell maradnia?” rombuszhoz vezet, amely „Igen” esetén az „Enterprise modul”, „Nem” esetén a „Plugin” elemnél ér véget.
Melyik építőelemmel kezdjen.

1. Új Skills Engine képesség (skill)

A cél egy újrafelhasználható utasításegység, amelyet az asszisztens, az ágensek, a munkafolyamatok és a fejlesztői eszközök egyaránt futtatni tudnak, például egy vámbevallás ellenőrzése a rá vonatkozó szabályok alapján. Építőelemei: egy SKILL.md-csomag a skillről elnevezett mappában, egy opcionális skill.yaml a triggerekhez és címkékhez, valamint egy opcionális, vele együtt csomagolt scripts/ mappa.

  1. Hozza létre a(z) skills/<slug>/ mappát, és írja meg a(z) SKILL.md fájlt frontmatterrel: name (kebab-case, megegyezik a mappa nevével), description (legfeljebb 500 karakter), allowed-tools, valamint opcionálisan triggers, capabilities és version.
  2. Írja meg a törzset a modell számára: mikor kell használni a skillt, mik a lépései, példák, és mit nem szabad soha tennie.
  3. Adjon hozzá teszteseteket. Vegyen fel egyet olyan, a bemenetbe csempészett utasítással, amelyet a skillnek nem szabad követnie.
  4. Validáljon, tekintse át a feltöltési tervet, majd töltse fel.
  5. Tegye közzé. Az írási eszközt hozzáadó skill mindaddig visszatartásra kerül, amíg két megnevezett személy passkeyjel jóvá nem hagyja, és a javaslattevő nem hagyhatja jóvá a saját módosítását.
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

A kapu a(z) skill:validate, amelynek nulla hibát kell jeleznie, mielőtt bármi közzétehető lenne. A blokkoló hibák: hiányzó név vagy leírás, illetve ismétlődő slug vagy feladattípus. A már közzétett tartalom feltöltése a meglévő verziót adja vissza (CONTENT_HASH_ALREADY_PUBLISHED), így a feltöltés biztonságosan megismételhető.

A Community a teljes létrehozót, a könyvtárat, a verziókat, a visszaváltást, az importálást és a teszteket megkapja. Enterprise kiadásban a közzététel shadow és canary fázison is átmegy: a jóváhagyott verzió először shadow módban fut, majd egy egységen, megnevezett kapuk mögött, végül mindenkinél, és magától leáll, ha egy kapu feltétele nem teljesül. Air-gapped ügyfél esetén a skillek előre aláírva, a lezárt csomagban érkeznek (9. forgatókönyv).

2. Leírófájl-alapú (manifest) képesség host_callback használatával

A cél determinisztikus számítás a saját pluginjában, amelyet a platform ütemezni tud, például kitérési rekord megnyitása egy mérési érték alapján. A manifest skills[] részének egy sorát fogja használni host_callback szinttel, valamint egy /internal útvonalat a backendjében, amelyet az SDK service guardja véd.

  1. Deklarálja a skillt: id lower_snake formában, tier: "host_callback", a plugin bizalmi plafonjával megegyező vagy az alatti classification, inputSchema, outputSchema, valamint 1 másodperc és 6 óra közötti timeoutMs.
  2. Töltse ki a(z) hostCallback részt: a saját Service nevét, a portját, egy relatív útvonalat, például /internal/skills/excursion_open, mindkét bájtkorlátot (maxRequestBytes és maxResponseBytes), valamint a(z) tenantHeader: "X-Organization-ID" értéket.
  3. Deklarálja az útvonalat a(z) api.endpoints[] fájlban auth: "service-key" vagy auth: "internal" értékkel, és védje requireService vagy serviceMiddleware guarddal, soha ne a felhasználói scope guarddal.
  4. Validáljon, futtassa a kapukat, és hagyja, hogy az onboarding a(z) compileRegistry segítségével szinkronizálja a skilleket a registrybe. Registry SQL-t soha nem kell kézzel írnia.
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

A(z) validate a registry-szinkron saját szabályait alkalmazza, mielőtt bármi szinkronizálódna, és mindegyik elutasítást a fogadó fél kódjával jelzi. A sémát, // elemet vagy fordított perjelet tartalmazó útvonalat cross-origin útvonalként utasítja el. A hiányzó bájtkorlát ENDPOINT_BYTE_CAP_REQUIRED, egy másik szinthez tartozó mező FIELD_NOT_FOR_TIER, a tartományon kívüli időkorlát pedig TIMEOUT_OUT_OF_BOUNDS. Ezután a(z) nexus-gates ellenőrzi, hogy a(z) /internal útvonal rendelkezik-e service guarddal, és internal vagy service-key deklarációval szerepel-e. Ez a kapupár a bizonyíték.

A szinkron deklaratív. Minden alkalommal a teljes skillkészletet küldje el, mert a kihagyott skill letiltásra kerül, és a telepítési lépés 200-tól eltérő státusz esetén hiúsuljon meg. Enterprise kiadásban a plugin szinkronját egészében ellenőrzi a rendszer: ha egyetlen skill megsért egy szabályt, a szinkron egyetlen elemét sem fogadja el (PLUGIN_SYNC_ALL_OR_NOTHING), és az előző verzió fut tovább. Community-bizalmi szintű plugin nem használhatja a modellt elérő szinteket, a(z) tool_using és llm_only szintet; ezekhez core vagy verified bizalmi szint szükséges.

Bővítmények és MCP-szinkronizálás
Bővítmények és MCP-szinkronizálás
Skilleket hozó pluginok, és hogy az egyes szinkronokat mire ellenőrizte a rendszer. Figyelje meg azt a plugint, amelynek szinkronját egészében elutasította a rendszer, mert öt skillje közül az egyik olyan szintet használt, amelyet csak a platform üzemeltethet, miközben az előző verziója tovább futott.

3. Meglévő csomag bővítése

A cél egy új iparág vagy aliparág, amely egy meglévő csomag nagy részét újrahasznosítja, például hitelezés és kártyás reklamációk az Insurance csomag szerkezetére építve. Az építőelem egy pack.json, amely a(z) inherits mezőben megnevezi a szülőjét, és csak a saját lens-klasztereit és kifejezéseit adja hozzá.

  1. Indítsa a csomagot a domain pack golden path segítségével, majd állítsa a(z) inherits értékét a szülőcsomag azonosítójára.
  2. Adja hozzá a saját lens-klasztereit, mindegyiket a hozzá tartozó szerepkörökkel, céllal és lexikonhivatkozással.
  3. Vegye fel a kifejezéseit a lexikonba, mindegyiket egyszerű magyarázattal. Jelöljön meg egy kifejezést exact jelzővel, ha pontosan a leírt formában kell megjeleníteni.
  4. A saját lensek megrajzolása helyett használja újra a közös lenseket: egy több csomag által igényelt szabályozási rendszer, például a kiszervezett technológiák nyilvántartása, egyetlen közös lens.
  5. Ellenőrizze a licencláncot. A csomag örökli a szülője kiegészítőkre vonatkozó követelményeit.
  6. Tekintse meg előnézetben az egyes lenseket egy adott személyként, egy szintetikus ágon.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

A bizonyíték a pilotkapu szabályzat-ellenőrzése, amely megerősíti, hogy minden lens csak szűkíti az alapját, és alapértelmezés szerint rejtve tartja a személyes mezőket. Az a lens, amely megpróbálja megjeleníteni, amit az alapja elrejt, LENS_CANNOT_WIDEN kóddal elutasításra kerül. Licencelési oldalon a konzol nem bocsát ki licencet az Ön csomagjára a szülője által igényelt kiegészítők nélkül; az Insurance csomaghoz a Decision rooms és a lezárt rekordok szükségesek.

A domain packok Enterprise-funkciók, és csomagonként licencelendők. Egy csomag telefonos képernyőihez a Mobile apps kiegészítő is szükséges. Egy gyermekcsomag nem módosíthatja a shellt, a komponenseket és az írási szabályokat.

4. Új csomag készítése az alapoktól

A cél a Nexus egy adott iparágra szabott nézete: a tudásmodellje, az egyes szerepkörök lensei, a szabályai által megkövetelt bizonyítékok, és az adatait naprakészen tartó plugin. A(z) 2.24. fejezet, Building a custom vertical end to end, teljes egészében végigvezeti ezt az építést; itt a rövid változat következik.

  1. Futtassa a domain pack golden path-t, és írja le a csomagot: cél, egységek, az alapmodell és a leképezett szabályok.
  2. Építse fel a tudásmodellt egy alapmodellre, és minden tulajdonságot a hozzáadáskor soroljon osztályba.
  3. Olvassa el a tervet, erősítse meg az ujjlenyomatát a passkeyjével, és hozza létre.
  4. Alakítsa ki a lenseket a Lens builderben, mindegyiket egy alap-lens szűkítéseként.
  5. Írja meg a plugint és a csomag által igényelt Skills Engine-skilleket.
  6. Generáljon seedelt szintetikus adatokat az Ön számára fontos szokatlan esetekkel, és tekintse meg előnézetben az egyes lenseket egy adott személyként.
  7. Léptesse elő a fejlesztői térből a stagingbe, egy pilotegységbe, majd az összes egységbe.

A bizonyíték az előléptetési kapuk sora: a stagingbe lépéshez minden tesztnek sikeresnek kell lennie a szintetikus ágakon, majd két, a szerzőtől különböző felülvizsgáló következik, végül 14 nap a pilotban, 1 000-ből 1 alatti hibaaránnyal. Egyik lépés sem hagyható ki (GATE_CANNOT_BE_SKIPPED). A csomagok Enterprise-funkciók. Community kiadásban a domain pack golden path nem érhető el.

5. Adatösszekötő (data connector)

A cél, hogy egy külső rendszer adatai ütemezetten áramoljanak a plugin saját tábláiba, például kapuesemények egy terminálüzemeltetési rendszerből. Az építőelemek: egy plugin_queue-skill, egy worker, amely a sorát olvassa, egy migráció a céltáblához, valamint egy, a manifestben deklarált kimenő cím.

  1. Deklaráljon egy plugin_queue-skillt, amelyben a(z) queueName értéke <plugin name>.<name>. Kettőspont nem megengedett, és a névnek szerepelnie kell a manifestben, mert az orchestrator közvetlenül erre teszi sorba a feladatokat.
  2. Írja meg a workert, amely a sort olvassa, és meghívja a külső rendszert.
  3. Deklarálja a külső rendszer címét kimenő címként. Minden, ami nem szerepel a listán, blokkolásra kerül.
  4. A beérkező adatokat a saját sémájában tárolja, minden sorban organization_id, owner_user_id és business_unit_id mezővel.
  5. A külső rendszer hitelesítő adatát név szerint olvassa ki a környezetből, és vegye fel a változót a(z) scripts/ci/required-env listába.
  6. A lekéréseket az UNO-n, a munkafolyamat-motoron keresztül ütemezze, soha ne olyan időzítővel, amely közvetlenül hívja a motorokat.
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

A(z) validate a registry-szinkron szabályai szerint ellenőrzi a sor nevét és az időkorlátot. A három kapu bizonyítja, hogy nincs modell-hitelesítő adat, nincs közvetlen számítás, és a tábla megfelelő hatókörű. Push előtt futtassa a teljes nexus-gates parancsot, mivel a(z) --only szűkíti a futtatást, és ezt az összegzésében jelzi is. Futásidőben a manifestben nem deklarált címre irányuló hívást a határon EGRESS_NOT_DECLARED kóddal állítja le a rendszer.

A platform saját, meghajtókhoz, wikikhez, levéltárakhoz és örökölt rendszerekhez készült, változásrögzítéssel és adatleszármazással rendelkező összekötői a Data connectors kiegészítővel érhetők el. A saját maga által épített összekötő plugin, és bármely kiadásban működik. Egy kimenő cím későbbi kiadásban történő hozzáadása bővítésnek minősül, és visszatartásra kerül, amíg két felülvizsgáló el nem fogadja.

6. MCP eszköz

A cél egy olyan eszköz, amelyet a Claude Code, az ágensek és más MCP- (Model Context Protocol-) kliensek meghívhatnak, például egy hajó ellenőrzési előzményeinek lekérdezéséhez. Az építőelem egy bejegyzés a manifest mcpTools[] részében, amely tartalmaz egy name, egy description és egy inputSchema mezőt.

  1. Nevezze el az eszközt, és írja le egyszerűen. A modell a leírás alapján dönti el, hogy meghívja-e.
  2. A(z) inputSchema mezőt egyetlen objektumsémaként írja meg. Ne tegyen oneOf, allOf vagy anyOf elemet a legfelső szintjére.
  3. Az eszközt kiszolgáló útvonalat – mint minden más /api útvonalat – tartsa a scope guard mögött, hogy a bérlői hozzárendelés a hívó tokenjéből származzon.
  4. Validálja a manifestet.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

A bizonyíték a(z) validate: a felső szintű kombinátort a rendszer már a létrehozáskor elutasítja, mert futásidőben az eszköz minden őt importáló MCP-alágensnél hibára futna, és az eszköz létezne ugyan, de senki sem tudná meghívni.

Enterprise kiadásban minden IDE (integrált fejlesztői környezet) által meghívható eszköz szerepel a Workbench eszközkatalógusában a szintjével, azzal, hogy módosít-e adatokat, egy rögzített ujjlenyomattal és a használatára jogosult szerepkörökkel. Ha az eszköz leírása egy új kiadásban megváltozik, a katalógus visszatartja az eszközt, amíg egy személy át nem tekinti a módosítást. Ez szándékos: egy megváltozott leírás révén kezdhet el egy eszköz olyasmit kérni a modelltől, amit nem kellene. A hívó engedélyén kívül eső bármely hívást a rendszer CONNECTION_SCOPE_EXCEEDED kóddal elutasít.

7. Saját márkás (white-label) áruház

A cél egy olyan alkalmazás, amelyet ügyfelének saját ügyfelei használnak, az ügyfél domainjén és márkájában, az Adverant bármilyen nyoma nélkül. Az építőelemek: a manifest domains és branding blokkja, az SDK bejelentkezési segédfüggvényei, valamint az ügyfél Storefront / white-label kiegészítője.

  1. Adja meg az ügyfél domainjét a(z) domains[] részben primary formában, az esetleges aliases értékekkel együtt.
  2. Töltse ki a(z) branding részt: appName, tagline, primaryColor, accentColor, egy, a domainnel megegyező passkeyRpId, valamint oauthClientRef.
  3. A felhasználókat az SDK bejelentkezési segédfüggvényeivel léptesse be, és a két nyilvános útvonalukat pontosan deklarálja, auth: "public" és allowAnonymous: true értékkel.
  4. Minden frontendhívást a backend for frontend engedélyezőlistás proxyján keresztül küldjön. Soha ne helyezzen szolgáltatáscímet a kliensbe.
  5. A fizetéseket bízza az ügyfél adminisztrátorára, aki csatlakoztatja a fizetési átjárókat, és beállítja a márkázott fizetési folyamatot.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

A bizonyíték a(z) scope-adherence. Csak akkor enged át egy védelem nélküli /api útvonalat, ha a manifest pontosan azt a metódust és útvonalat nyilvánosként deklarálja, és az útvonal a bejelentkezési útvonalak egyike; minden más nyilvános deklaráció meghiúsul, és a hibaüzenet megnevezi a két engedélyezett útvonalat. Ezután a(z) api-contract mindkét irányban összeveti a deklarált útvonalakat a valódiakkal. A(z) definePlugin azt a(z) frontend.basePath értéket is elutasítja, amely nem relatív, azonos eredetű útvonal.

A white-label az Enterprise csomag Storefront / white-label kiegészítője, amely a fizetések licencét is tartalmazza. A kártyaadatok soha nem érintik a Nexust. A márka az ügyfél adminisztrátoráé, és a platform azt a szervezetből határozza meg, nem az Ön kódjából.

8. Edge küldetéscsomag

A cél egy új vagy frissített küldetés egy Nexus Edge-et futtató műhold vagy drón számára, például egy hajókereső adapter hozzáadása egy tengeri megfigyelő küldetéshez. Az építőelem egy küldetéscsomag, amelyet a földön építenek és írnak alá.

  1. Induljon ki a jelenlegi csomagból a Küldetéscsomag építése oldalon, amely a régiből elkészíti az új verzió vázlatát, és minden változtatást megjelöl.
  2. Csak azt módosítsa, amire a küldetésnek szüksége van. A nagy részeket, a nyelvi modellt és az ontológiát lehetőség szerint hagyja változatlanul.
  3. Ellenőrizze az elhelyezési táblázatot minden leromlott állapotú lépésnél, hogy minden kártya továbbra is elbírja azt, amit futtat.
  4. Futtassa a csomag fedélzeti teszteseteit egy azonos kártyákkal felszerelt tesztpadon.
  5. Küldje el aláírásra: háromból két aláírás szükséges.
  6. Adja ki egyetlen platformra. A csomag az üresjárati slotba kerül, és csak azután kapcsolódik be, hogy tesztesetei a fedélzeten sikeresen lefutottak.
  7. Egy hiba nélküli hét után terjessze ki a következő platformra.
Küldetéscsomagok
Küldetéscsomagok
A küldetéscsomag-könyvtár, benne azzal, hogy az egyes csomagok mit tartalmaznak, és mely platformok futtatják őket. Figyelje meg a fedélzeten megtartott régebbi verziót, amelyre vissza lehet állni, valamint azt, hogy az egyes csomagoknak hány tesztesetet kell sikeresen teljesíteniük a saját hardverükön.

Ebben a receptben nincsenek parancsok; a munka a konzol Nexus Edge oldalain történik. A bizonyíték a fedélzeti tesztesetek, amelyeknek mind sikeresen le kell futniuk a csomag bekapcsolása előtt, valamint a két aláírás. Ha egy teszt a fedélzeten sikertelen, a platform az előző csomagján marad, és a hiba a következő átvonuláskor érkezik le. Egy csomag olyan hardverre történő telepítését, amelyre nem ellenőrizték, a rendszer PACK_NOT_CHECKED_FOR_HARDWARE hibával elutasítja.

A Nexus Edge kiegészítő, amelynek licence platformonként vagy flottánként érvényes. A csomagok akkor is érvényesek maradnak, amikor egy platform nincs kapcsolatban. A feltöltési csatorna keskeny, ezért a méreteket ehhez igazítsa: 1.5-ös kiadásunk 412 MB volt, szemben egy új nyelvi modellt tartalmazó csomag 9.8 GB-jával.

9. Zárt hálózatú (air-gapped) szállítás ügyfél részére

A cél az, hogy az Ön pluginja vagy csomagja egy hálózat nélküli ügyfélhelyszínen legyen telepítve. Az építőelemek a @adverant/nexus-sovereign által készített lezárt csomag, az Ön kiadás-aláíró kulcsa és az ügyfél saját kiadási csatornái.

  1. Építse meg a plugint és a hozzá tartozó image-eket pontosan úgy, mint egy hálózatra csatlakozó ügyfél esetében, minden ellenőrzési kapu zöld állapotával.
  2. Készítsen lezárt csomagot a airgap profillal, amely tartalmazza az image-eket, a migrációkat, az előre aláírt képességeket (skilleket), valamint egy SBOM-ot (szoftverösszetevő-jegyzéket) a licencekkel.
  3. Írja alá az Ed25519 kiadási kulcsával.
  4. Ellenőrizze saját maga egy tiszta gépen.
  5. A csomagot adathordozón küldje el, a nyilvános kulcsát és a csomag SHA-256 értékét pedig külön úton.
  6. Az ügyfél üzemeltetője az Ön kulcsával ellenőrzi a csomagot, majd a saját kiadási csatornáin keresztül veszi át a kiadást.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgap

A nexus-airgap bundle az Ön csomagkonfigurációjából építi meg a csomagot. A bizonyíték az ügyfél oldalán futtatott nexus-airgap verify. Ez minden fájl hash-ét újraszámítja, elutasít minden olyan fájlt, amelyet a manifest nem sorol fel, megbízható aláírót követel meg, és elutasítja azt a csomagot, amelynek hálózati engedélylistája nem üres. A módosított fájl BUNDLE_INTEGRITY_VIOLATION hibát eredményez. Senki ne kapcsolja ki soha a szigorú ellenőrzést azért, hogy ezen túljusson.

Az air-gapped (hálózattól elzárt) telepítések az Enterprise csomag részei. A csomagban semmi sem tölthet le semmit a telepítéskor, és a plugin által igényelt modell az ügyfél saját modellszerveréről érkezik az AI (mesterséges intelligencia) Provider Routeren keresztül.

10. Kizárólag Enterprise kiadású modul

A cél egy zárt, licencelt képesség, amely a nyílt maghoz kapcsolódik, például egy hosszú megőrzési idejű auditnapló, amelyet csak Enterprise ügyfeleknek értékesítenek. Az építőelem a @adverant/nexus-spi interfészcsomag, és semmi más a Community kiadásból.

  1. Tartsa a megépített interfészcsomag bájtra rögzített másolatát a tárolójában helyi file: csomagként, a hozzá tartozó SHA256SUMS rögzítéssel.
  2. Írjon ehhez egy RouteModule-t (vagy konzolképernyők esetén egy ScreenModule-t), az általa kiszolgált funkciócsoporttal.
  3. Minden útvonalat a ctx.requireScope mögött futtasson, és válaszadás előtt ellenőrizze a modul saját jogosultságát.
  4. Utasítsa el LICENCE_LOCKED hibával, ha a szervezet nem jogosult, és a funkció előzetesét jelenítse meg, soha ne az adatait.
  5. Tartsa a tárolót a licenchatáron belül, majd építse meg az egyes kiadások összeállított fáját.
npm ci
npm test
npm run build

A bizonyíték a licenchatár-szabály: nincs importálás Community hatókörből az interfészcsomagon kívül, nincs relatív importálás a tárolón kívülről, és nincs file:, link: vagy workspace: függőség azon kívül. Ezután a fenti három parancsnak minden összeállított kiadási fában sikeresen le kell futnia, nem csak az Ön munkafájában. A 2.25. fejezet (Építés az egyes kiadásokhoz) tartalmazza a modul vázát.

A modul induláskor töltődik be egy Community szolgáltatásba azokon a telepítéseken, amelyek licence tartalmazza a funkciócsoportját. E jogosultság nélkül megtagadja a működést, így ugyanaz a build mindenhová kiszállítható, és ahol nincs licencelve, ott nem tesz semmit.

11. A nyílt alaprendszer elágaztatása (fork) vagy bővítése

A cél magának a Community kiadásnak a módosítása, amelyet a saját forkjában tart meg, vagy visszajuttat a projektbe. Az építőelem a Community forráskódja az Apache License, Version 2.0 alatt.

  1. Forkolja a tárolót, és hozzon létre ágat a main ágból.
  2. Ha amit szeretne, megvalósítható pluginként vagy képességként (skillként), részesítse előnyben azt. A mag módosítását minden kiadásnál Önnek kell karbantartania.
  3. A módosítást olyan tesztekkel végezze, amelyek nélküle sikertelenek.
  4. Mielőtt bármit javasolna, futtassa a projekt által futtatott ellenőrzéseket.
  5. Tartsa meg a NOTICE fájlt, és ne használja az Adverant nevét vagy védjegyeit azon túl, hogy megjelöli, honnan származik a munka.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

A bizonyíték e három ellenőrzés sikeres lefutása, valamint annak igazolása, hogy minden új teszt az Ön módosítása előtt sikertelen volt. Tartsa érvényben a nyílt mag egyik tulajdonságát a forkjában: a Community egy ágenst teljes egészében, helyi modellen, kulcs és hálózat nélkül futtat. Az a módosítás, amely ezt megtöri, éppen azt töri meg, ami a Community-t önállóan is használhatóvá teszi.

Ez kizárólag a Community kiadásra vonatkozik. Mindaz, aminek zártnak kell maradnia, ehelyett egy Enterprise modulba (10. forgatókönyv) tartozik, így a licenchatár olyan helyen marad, amelyre bárki rámutathat.

12. Team kiadású felhőalkalmazás

A cél egy olyan alkalmazás, amelyet a Team ügyfelek telepíthetnek. A Team kizárólag az Adverant felhőben fut, így az alkalmazás csak a katalóguson keresztül jut el hozzájuk. Az építőelemek egy plugin és egy kiadói fürt: az Ön saját virtuális fürtje az Adverant felhőben, mintaadatokkal.

  1. A kiadói fürtön építsen és teszteljen, kizárólag mintaadatokkal.
  2. Az alkalmazás manifestjében deklaráljon mindent, amire szüksége van, és semmi többet.
  3. Adja ki aláírva, az Adverant általi felülvizsgálatra és katalógusbeli megjelenésre.
  4. Minden ügyfél maga telepíti, és minden deklarált hatókört egységenként engedélyez.

A bizonyíték két részből áll. Az aláírt, felülvizsgált kiadás juttatja be a katalógusba. Ezután az ügyfél engedélye dönti el, hogy az alkalmazás mihez férhet hozzá az ügyfél környezetében, és minden nem deklarált hívást a rendszer CONNECTION_SCOPE_EXCEEDED hibával elutasít. Hiányzó hatókört csak egy új, az ügyfél által felülvizsgált kiadásban adhat hozzá.

Külső fejlesztésű bővítmény telepítése
Külső fejlesztésű bővítmény telepítése
Egy adminisztrátor egy külső fejlesztésű plugint telepít, minden deklarált hatókört egységenként engedélyez, egyet pedig kihagy. Az ábra egy olyan hívást mutat, amelyet a plugin soha nem deklarált, és amelyet a rendszer elutasított.

A kiadói fürtnek nincs útvonala egyetlen ügyfélhez sem, és ott egy ügyfél adatainak lekérését a rendszer TENANT_BOUNDARY hibával elutasítja. Az ügyfelek megoszthatják Önnel a teszteredményeket, az adataikat soha. A Team tartalmazza a munkafolyamat-üzemeltetési képességet, így ha az alkalmazása munkafolyamatokat szállít, a Team ügyfelek maguk léptethetik elő azokat a környezetek között.

13. Meglévő belső alkalmazás becsomagolása beépülő modulként

A cél egy olyan alkalmazás, amelyet vállalata már futtat, és amelyet a Nexusba hoz, hogy örökölje a bejelentkezést, az elkülönítést és az irányítást. Az építőelemek az első vázlathoz a /plugin-create képesség (skill), a befejezéshez pedig az SDK manifesteszközei és ellenőrzési kapui.

  1. Futtassa a /plugin-create-t a tárolóval. Ez elemzi a kódot, kiválaszt egy becsomagolási stratégiát, majd létrehozza a backendet, a migrációkat, a felhasználói felületet (UI), a manifestet és a teszteket.
  2. Emelje a manifestet a v2 szerződés szintjére. A migrate hozzáadja a három szabálymondatot, a domain-t áthelyezi a domains[]-ba, és megtagadja, hogy belépési pontot találjon ki.
  3. Minden olyan tenant-értéket, amelyet a burkoló a fejlécekből olvas, cseréljen le az SDK hatókörvédőjére.
  4. Adja hozzá a organization_id, owner_user_id és business_unit_id mezőt minden táblához, tenanttal kezdődő elsődleges kulcsokkal.
  5. Minden útvonalat a hozzá tartozó jogosultsággal deklaráljon, és telepítse az elutasítási naplót.
  6. Futtassa az ellenőrzési kapukat, amíg zöldek nem lesznek.
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

A bizonyíték az, hogy a nexus-gates 0 kóddal lép ki, és a scope-adherence, one-fence, migrations-are-scoped, crud-adherence és api-contract mind sikeres. Számítson arra, hogy az első futtatás ezek többségén elbukik; nálunk minden útvonalat hatókör nélkülinek jelzett, mert a vázlat olyan fejlécekben bízott meg, amelyeket a böngésző beállíthatott. Az ellenőrzési kapuknak szándékosan nincs javító kapcsolójuk.

A becsomagolt alkalmazások bármely kiadáson működnek. A telepítés kizárólag a telepítés kiadási csatornáin keresztül történik, ezért hagyja figyelmen kívül a vázlat által írt telepítési fájlokat. Az idő az elkülönítési munkára megy el: egy valódi alkalmazásnál napokkal számoljon, ne órákkal.