Verzió 1.0.0-alpha.1legújabb
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

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 |
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.
- Hozza létre a(z)
skills/<slug>/mappát, és írja meg a(z)SKILL.mdfájlt frontmatterrel:name(kebab-case, megegyezik a mappa nevével),description(legfeljebb 500 karakter),allowed-tools, valamint opcionálisantriggers,capabilitiesésversion. - Í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.
- Adjon hozzá teszteseteket. Vegyen fel egyet olyan, a bemenetbe csempészett utasítással, amelyet a skillnek nem szabad követnie.
- Validáljon, tekintse át a feltöltési tervet, majd töltse fel.
- 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-filingA 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.
- Deklarálja a skillt:
idlower_snake formában,tier: "host_callback", a plugin bizalmi plafonjával megegyező vagy az alatticlassification,inputSchema,outputSchema, valamint 1 másodperc és 6 óra közöttitimeoutMs. - Töltse ki a(z)
hostCallbackré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ésmaxResponseBytes), valamint a(z)tenantHeader: "X-Organization-ID"értéket. - Deklarálja az útvonalat a(z)
api.endpoints[]fájlbanauth: "service-key"vagyauth: "internal"értékkel, és védjerequireServicevagyserviceMiddlewareguarddal, soha ne a felhasználói scope guarddal. - Validáljon, futtassa a kapukat, és hagyja, hogy az onboarding a(z)
compileRegistrysegí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-testA(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.
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á.
- 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. - Adja hozzá a saját
lens-klasztereit, mindegyiket a hozzá tartozó szerepkörökkel, céllal és lexikonhivatkozással. - Vegye fel a kifejezéseit a lexikonba, mindegyiket egyszerű magyarázattal. Jelöljön meg egy kifejezést
exactjelzővel, ha pontosan a leírt formában kell megjeleníteni. - 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.
- Ellenőrizze a licencláncot. A csomag örökli a szülője kiegészítőkre vonatkozó követelményeit.
- 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.
- Futtassa a domain pack golden path-t, és írja le a csomagot: cél, egységek, az alapmodell és a leképezett szabályok.
- Építse fel a tudásmodellt egy alapmodellre, és minden tulajdonságot a hozzáadáskor soroljon osztályba.
- Olvassa el a tervet, erősítse meg az ujjlenyomatát a passkeyjével, és hozza létre.
- Alakítsa ki a lenseket a Lens builderben, mindegyiket egy alap-lens szűkítéseként.
- Írja meg a plugint és a csomag által igényelt Skills Engine-skilleket.
- 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.
- 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.
- 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. - Írja meg a workert, amely a sort olvassa, és meghívja a külső rendszert.
- Deklarálja a külső rendszer címét kimenő címként. Minden, ami nem szerepel a listán, blokkolásra kerül.
- A beérkező adatokat a saját sémájában tárolja, minden sorban
organization_id,owner_user_idésbusiness_unit_idmezővel. - 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-envlistába. - 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-envA(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.
- 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.
- A(z)
inputSchemamezőt egyetlen objektumsémaként írja meg. Ne tegyenoneOf,allOfvagyanyOfelemet a legfelső szintjére. - 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. - Validálja a manifestet.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonA 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.
- Adja meg az ügyfél domainjét a(z)
domains[]részbenprimaryformában, az esetlegesaliasesértékekkel együtt. - Töltse ki a(z)
brandingrészt:appName,tagline,primaryColor,accentColor, egy, a domainnel megegyezőpasskeyRpId, valamintoauthClientRef. - 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"ésallowAnonymous: trueértékkel. - 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.
- 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-contractA 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á.
- 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.
- 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.
- 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.
- Futtassa a csomag fedélzeti teszteseteit egy azonos kártyákkal felszerelt tesztpadon.
- Küldje el aláírásra: háromból két aláírás szükséges.
- 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.
- Egy hiba nélküli hét után terjessze ki a következő platformra.
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.
- É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.
- Készítsen lezárt csomagot a
airgapprofillal, 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. - Írja alá az Ed25519 kiadási kulcsával.
- Ellenőrizze saját maga egy tiszta gépen.
- 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.
- 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 airgapA 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.
- 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óSHA256SUMSrögzítéssel. - Írjon ehhez egy
RouteModule-t (vagy konzolképernyők esetén egyScreenModule-t), az általa kiszolgált funkciócsoporttal. - Minden útvonalat a
ctx.requireScopemögött futtasson, és válaszadás előtt ellenőrizze a modul saját jogosultságát. - Utasítsa el
LICENCE_LOCKEDhibával, ha a szervezet nem jogosult, és a funkció előzetesét jelenítse meg, soha ne az adatait. - 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 buildA 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.
- Forkolja a tárolót, és hozzon létre ágat a
mainágból. - 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.
- A módosítást olyan tesztekkel végezze, amelyek nélküle sikertelenek.
- Mielőtt bármit javasolna, futtassa a projekt által futtatott ellenőrzéseket.
- 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 typecheckA 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.
- A kiadói fürtön építsen és teszteljen, kizárólag mintaadatokkal.
- Az alkalmazás manifestjében deklaráljon mindent, amire szüksége van, és semmi többet.
- Adja ki aláírva, az Adverant általi felülvizsgálatra és katalógusbeli megjelenésre.
- 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á.
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.
- 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. - Emelje a manifestet a v2 szerződés szintjére. A
migratehozzáadja a három szabálymondatot, adomain-t áthelyezi adomains[]-ba, és megtagadja, hogy belépési pontot találjon ki. - Minden olyan tenant-értéket, amelyet a burkoló a fejlécekből olvas, cseréljen le az SDK hatókörvédőjére.
- Adja hozzá a
organization_id,owner_user_idésbusiness_unit_idmezőt minden táblához, tenanttal kezdődő elsődleges kulcsokkal. - Minden útvonalat a hozzá tartozó jogosultsággal deklaráljon, és telepítse az elutasítási naplót.
- 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-testA 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.


