Prihlásiť saRezervovať brífing

Kapitola 2.27

Scenáre zostavenia

Kuchárka trinástich zostavení, od jednej zručnosti až po doručenie do izolovaného prostredia (air-gapped). Každý recept uvádza cieľ, stavebné bloky, kroky a príkazy, kontrolnú bránu, ktorá overí funkčnosť, a to, čo sa mení podľa edície a formy doručenia.

Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

25 min čítania

Toto sú postupy, po ktorých siahnem, keď niekto v Corrán Orbital alebo u zákazníka povie „chceme, aby Nexus robil X“. Každý z nich je zámerne krátky. Zdôvodnenie jednotlivých krokov nájdete v predchádzajúcich kapitolách: kapitola 2.20, Skills, a kapitola 2.21, The Plugin SDK, ktorá sa venuje súprave na vývoj softvéru, ďalej kapitola 2.23, Doménové balíky, a tri kapitoly za ňou o tvorbe. Tu dostanete cieľ, ktoré stavebné prvky použiť, kroky, príkazy, bránu, ktorá vám povie, že to funguje, a poznámky k edícii a doručeniu.

Najdôležitejšia je brána. Postup je dokončený, keď je jeho brána zelená. Každá brána v tejto kapitole je niečo, čo môžete spustiť, alebo niečo, čo platforma spustí za vás, a každá skončí s nenulovým kódom alebo odmietne s kódom, keď nie je splnená.

Scenár Hlavný stavebný prvok Brána, ktorá to dokazuje Edícia
Nová zručnosť Skills Engine Balík SKILL.md skill:validate s nulovým počtom chýb Community a Enterprise
Zručnosť v manifeste s host_callback Manifest pluginu skills[] create-nexus-plugin validate a nexus-gates Community a Enterprise
Rozšírenie existujúceho balíka pack.json s inherits Kontrola politiky pohľadov pri pilotnej bráne Enterprise a licencia na balík
Nový balík od začiatku Odporúčaný postup pre doménový balík Brány pre staging a pilot Enterprise
Dátový konektor Zručnosť plugin_queue validate, nexus-gates, odmietnutie odchádzajúcej komunikácie Community a Enterprise
Nástroj MCP (Model Context Protocol) Manifest mcpTools[] validate (bez kombinátorov na najvyššej úrovni) Community a Enterprise
White-label obchod Manifest domains a branding Verejné pravidlo scope-adherence Enterprise a doplnok Storefront
Misijný balík Edge Misijný balík Testovacie prípady na palube, dva z troch podpisov Enterprise a doplnok Nexus Edge
Doručenie do izolovaného prostredia (air-gapped) Zapečatený balík nexus-airgap verify Enterprise
Modul len pre Enterprise @adverant/nexus-spi Brána licenčnej hranice, zostavy edícií Enterprise
Fork alebo rozšírenie otvoreného jadra Zdrojový kód Community Testy, lint a kontrola typov Community
Cloudová aplikácia pre edíciu Team Klaster vydavateľa Podpísané vydanie, revízia, udelenie zákazníkovi Team
Obalenie existujúcej internej aplikácie /plugin-create migrate, validate, nexus-gates Community a Enterprise
Rozhodovací strom čítaný zhora nadol. Prvý kosoštvorec sa pýta „Potrebuje neustále bežiaci kód?“. „Nie“ vedie ku kosoštvorcu „Ide o pokyny pre asistenta?“, ktorého „Áno“ končí pri „Skill pre Skills Engine“ a „Nie“ pri „Lens na existujúcom balíku“. „Áno“ vedie ku kosoštvorcu „Ide o pohľad jedného odvetvia na platformu?“, ktorého „Áno“ končí pri „Doménový balík (s jeho pluginom)“ a „Nie“ vedie k poslednému kosoštvorcu „Musí zostať uzavretý a licencovaný?“, ktorý končí pri „Modul Enterprise“ pre „Áno“ a „Plugin“ pre „Nie“.
Z ktorého stavebného prvku začať.

1. Nová zručnosť pre Skills Engine

Cieľom je opakovane použiteľná inštrukcia, ktorú môžu spúšťať asistent, agenti, pracovné postupy aj vývojárske nástroje, napríklad kontrola colného podania voči jeho pravidlám. Vašimi stavebnými prvkami sú balík SKILL.md v priečinku pomenovanom podľa zručnosti, voliteľný skill.yaml pre spúšťače a značky a voliteľný priečinok scripts/ pribalený k nemu.

  1. Vytvorte skills/<slug>/ a napíšte SKILL.md s frontmatter: name (kebab-case, zhodný s názvom priečinka), description (najviac 500 znakov), allowed-tools a voliteľne triggers, capabilities a version.
  2. Telo napíšte pre model: kedy zručnosť použiť, jej kroky, príklady a čo nesmie nikdy robiť.
  3. Pridajte testovacie prípady. Zahrňte jeden so vstupom, do ktorého je podstrčená inštrukcia, ktorú zručnosť nesmie vykonať.
  4. Overte platnosť, pozrite si plán nahrávania a potom nahrajte.
  5. Publikujte. Zručnosť, ktorá pridáva nástroj na zápis, je pozdržaná, kým ju neschvália dve menovite určené osoby pomocou passkey, a navrhovateľ nemôže schváliť vlastnú zmenu.
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

Bránou je skill:validate, ktorý musí hlásiť nulový počet chýb skôr, ako je možné čokoľvek publikovať. Blokujúcimi chybami sú chýbajúci názov alebo popis a duplicitný slug alebo typ úlohy. Nahratie obsahu, ktorý je už publikovaný, vráti existujúcu verziu (CONTENT_HASH_ALREADY_PUBLISHED), takže nahrávanie možno bezpečne zopakovať.

Community dostáva celý editor, knižnicu, verzie, návrat k predchádzajúcej verzii, import a testy. V Enterprise publikovanie prechádza aj režimom shadow a canary: schválená verzia beží v tieni, potom pre jednu jednotku za menovite určenými bránami, potom pre všetkých, a sama sa zastaví, ak niektorá brána nie je splnená. Pre zákazníka v izolovanom prostredí sa zručnosti prenášajú vopred podpísané vo vnútri zapečateného balíka (scenár 9).

2. Zručnosť manifestu s host_callback

Cieľom je deterministický výpočet vo vašom vlastnom plugine, ktorý môže platforma spustiť, napríklad otvorenie záznamu o prekročení na základe odčítanej hodnoty. Použijete riadok v skills[] manifestu s úrovňou host_callback a trasu /internal vo vašom backende chránenú servisnou ochranou SDK.

  1. Deklarujte zručnosť: id v lower_snake, tier: "host_callback", classification na úrovni dôveryhodnostného stropu vášho pluginu alebo pod ním, inputSchema, outputSchema a timeoutMs v rozsahu od 1 sekundy do 6 hodín.
  2. Vyplňte hostCallback: názov vlastnej služby, jej port, relatívnu cestu, napríklad /internal/skills/excursion_open, oba bajtové limity (maxRequestBytes a maxResponseBytes) a tenantHeader: "X-Organization-ID".
  3. Deklarujte trasu v api.endpoints[] s auth: "service-key" alebo auth: "internal" a chráňte ju pomocou requireService alebo serviceMiddleware, nikdy nie ochranou používateľského rozsahu.
  4. Overte platnosť, spustite brány a nechajte proces onboardingu synchronizovať zručnosti do registra cez compileRegistry. SQL pre register nikdy nepíšete ručne.
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 uplatní vlastné pravidlá synchronizácie registra ešte pred akoukoľvek synchronizáciou, pričom každé porušenie odmietne s kódom príjemcu. Cesta so schémou, // alebo spätnou lomkou sa odmietne ako cross-origin. Chýbajúci bajtový limit je ENDPOINT_BYTE_CAP_REQUIRED, pole z inej úrovne je FIELD_NOT_FOR_TIER a časový limit mimo rozsahu je TIMEOUT_OUT_OF_BOUNDS. Potom nexus-gates skontroluje, či trasa /internal nesie servisnú ochranu a je deklarovaná ako internal alebo service-key. Táto dvojica brán je dôkazom.

Synchronizácia je deklaratívna. Zakaždým odošlite celú množinu zručností, pretože zručnosť, ktorú vynecháte, sa deaktivuje, a nechajte krok nasadenia zlyhať pri akomkoľvek inom stave ako 200. V Enterprise sa synchronizácia pluginu kontroluje ako celok: ak jedna zručnosť poruší pravidlo, z tejto synchronizácie sa neprijme nič (PLUGIN_SYNC_ALL_OR_NOTHING) a ďalej beží predchádzajúca verzia. Plugin s komunitnou dôverou nemôže používať úrovne, ktoré pristupujú k modelu, tool_using a llm_only; tie vyžadujú dôveru core alebo verified.

Pluginy a synchronizácia MCP
Pluginy a synchronizácia MCP
Pluginy, ktoré prinášajú zručnosti, a čo sa pri každej synchronizácii kontrolovalo. Všimnite si plugin, ktorého synchronizácia bola odmietnutá ako celok, pretože jedna z jeho piatich zručností použila úroveň, ktorú smie hostiť iba platforma, zatiaľ čo jeho predchádzajúca verzia ďalej bežala.

3. Rozšírenie existujúceho balíka

Cieľom je nové odvetvie alebo pododvetvie, ktoré opätovne využíva väčšinu existujúceho balíka, napríklad úvery a spory pri platobných kartách postavené na štruktúre balíka Insurance. Stavebným prvkom je pack.json, ktorý v inherits uvádza svojho rodiča a pridáva iba vlastné zoskupenia pohľadov a pojmy.

  1. Začnite balík odporúčaným postupom pre doménový balík a potom nastavte inherits na id rodičovského balíka.
  2. Pridajte vlastné zoskupenia lens, každé s jeho rolami, účelom a odkazom na slovník.
  3. Pridajte svoje pojmy do slovníka, každý s jednoduchým vysvetlením. Pojem označte ako exact tam, kde sa musí zobraziť presne tak, ako je napísaný.
  4. Namiesto kreslenia vlastných pohľadov opätovne použite zdieľané pohľady: režim, ktorý potrebuje viacero balíkov, napríklad register outsourcovaných technológií, je jeden zdieľaný pohľad.
  5. Skontrolujte licenčný reťazec. Váš balík dedí požiadavky rodiča na doplnky.
  6. Zobrazte si náhľad každého pohľadu ako konkrétna osoba na syntetickej vetve.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Dôkazom je kontrola politiky pri pilotnej bráne, ktorá potvrdí, že každý pohľad iba zužuje svoj základ a predvolene skrýva osobné polia. Pohľad, ktorý sa pokúsi zobraziť to, čo jeho základ skrýva, sa odmietne s LENS_CANNOT_WIDEN. Na strane licencovania konzola odmietne vydať licenciu na váš balík bez doplnkov, ktoré potrebuje jeho rodič; balík Insurance potrebuje Rozhodovacie miestnosti a zapečatené záznamy.

Doménové balíky sú súčasťou Enterprise a licencujú sa po balíkoch. Obrazovky balíka pre telefóny navyše vyžadujú doplnok Mobilné aplikácie. Podradený balík nemôže meniť shell, komponenty ani pravidlá písania.

4. Nový balík od základov

Cieľom je pohľad jedného odvetvia na Nexus: jeho znalostný model, pohľady pre jednotlivé roly, dôkazy, ktoré vyžadujú jeho pravidlá, a plugin, ktorý udržiava jeho údaje aktuálne. Kapitola 2.24, Building a custom vertical end to end, prechádza touto tvorbou v plnom rozsahu; tu je skrátená verzia.

  1. Spustite odporúčaný postup pre doménový balík a popíšte balík: účel, jednotky, základný model a pravidlá, ktoré mapuje.
  2. Vytvorte znalostný model na základnom modeli a každú vlastnosť zaraďte do triedy hneď pri jej pridaní.
  3. Prečítajte si plán, potvrďte jeho odtlačok svojím passkey a vytvorte.
  4. Navrhnite pohľady v nástroji Lens builder, pričom každý zužuje základný pohľad.
  5. Napíšte plugin a všetky zručnosti Skills Engine, ktoré balík potrebuje.
  6. Vygenerujte syntetické údaje so seedom vrátane neobvyklých prípadov, na ktorých vám záleží, a zobrazte si náhľad každého pohľadu ako konkrétna osoba.
  7. Povýšte z vývojového priestoru do stagingu, do pilotnej jednotky a potom do všetkých jednotiek.

Dôkazom sú brány povýšenia: všetky testy úspešné na syntetických vetvách pred stagingom, potom dvaja revízori, ktorí nie sú autorom, potom 14 dní v pilote s chybovosťou pod 1 z 1 000. Žiadny krok nemožno preskočiť (GATE_CANNOT_BE_SKIPPED). Balíky sú súčasťou Enterprise. V Community sa odporúčaný postup pre doménový balík neponúka.

5. Dátový konektor

Cieľom je, aby údaje z externého systému podľa plánu prúdili do vlastných tabuliek vášho pluginu, napríklad udalosti brány z terminálového operačného systému. Stavebnými prvkami sú zručnosť plugin_queue, worker, ktorý vyberá vašu frontu, migrácia pre cieľovú tabuľku a odchádzajúca adresa deklarovaná v manifeste.

  1. Deklarujte zručnosť plugin_queue s queueName v tvare <plugin name>.<name>. Dvojbodka nie je povolená a názov musí byť v manifeste, pretože orchestrátor doň zaraďuje úlohy priamo.
  2. Napíšte worker, ktorý vyberá frontu a volá externý systém.
  3. Deklarujte adresu externého systému ako odchádzajúcu adresu. Všetko, čo nie je uvedené, je zablokované.
  4. To, čo prichádza, ukladajte do vlastnej schémy, s organization_id, owner_user_id a business_unit_id v každom riadku.
  5. Prihlasovacie údaje externého systému čítajte podľa názvu z prostredia a premennú uveďte v scripts/ci/required-env.
  6. Sťahovanie spúšťajte cez UNO, nástroj pracovných postupov, nikdy nie časovačom, ktorý volá nástroje priamo.
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 kontroluje názov fronty a časový limit voči pravidlám synchronizácie registra. Tri brány dokazujú, že neexistujú prihlasovacie údaje k modelu, žiadny priamy výpočet a že tabuľka má správny rozsah. Pred odoslaním spustite úplný nexus-gates, pretože --only zužuje beh a uvádza to vo svojom súhrne. Počas behu sa volanie na adresu, ktorú manifest nedeklaroval, zastaví na okraji s EGRESS_NOT_DECLARED.

Vlastné konektory platformy k diskom, wiki, poštovým úložiskám a starším systémom so zachytávaním zmien a sledovaním pôvodu údajov sú súčasťou doplnku Dátové konektory. Konektor, ktorý si vytvoríte sami, je plugin a funguje v ktorejkoľvek edícii. Pridanie odchádzajúcej adresy v neskoršom vydaní je rozšírenie, ktoré je pozdržané, kým ho neprijmú dvaja revízori.

6. Nástroj MCP

Cieľom je nástroj, ktorý môžu volať Claude Code, agenti a ďalší klienti MCP (Model Context Protocol), napríklad na vyhľadanie histórie inšpekcií plavidla. Stavebným prvkom je položka v mcpTools[] manifestu s name, description a inputSchema.

  1. Pomenujte nástroj a popíšte ho jednoducho. Popis je to, čo model číta pri rozhodovaní, či ho zavolať.
  2. Napíšte inputSchema ako jednu objektovú schému. Na jej najvyššiu úroveň nedávajte oneOf, allOf ani anyOf.
  3. Trasu, ktorá obsluhuje nástroj, ponechajte za ochranou rozsahu ako každú inú trasu /api, aby tenant vyplýval z tokenu volajúceho.
  4. Overte platnosť manifestu.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Dôkazom je validate: kombinátor na najvyššej úrovni sa odmietne už pri tvorbe, pretože počas behu by spôsobil zlyhanie nástroja pre každého subagenta MCP, ktorý ho importuje, a nástroj by existoval bez toho, aby ho niekto mohol zavolať.

V Enterprise je každý nástroj, ktorý môže volať IDE (integrované vývojové prostredie), uvedený v katalógu nástrojov Workbench s jeho úrovňou, informáciou, či niečo mení, pripnutým odtlačkom a rolami, ktoré ho smú používať. Ak sa popis vášho nástroja v novom vydaní zmení, katalóg nástroj pozdrží, kým zmenu neskontroluje človek. Je to zámerné: zmenený popis je spôsob, akým môže nástroj začať žiadať od modelu niečo, čo by nemal. Volanie čohokoľvek mimo oprávnenia volajúceho sa odmietne s CONNECTION_SCOPE_EXCEEDED.

7. White-label predajný portál

Cieľom je aplikácia, ktorú používajú zákazníci vášho zákazníka, na doméne zákazníka a v jeho značke, bez akejkoľvek stopy po Adverant. Stavebnými prvkami sú bloky domains a branding manifestu, pomocné funkcie SDK na prihlásenie a doplnok zákazníka Storefront / white-label.

  1. Doménu zákazníka zadajte do domains[] ako primary spolu s prípadnými aliases.
  2. Vyplňte branding: appName, tagline, primaryColor, accentColor, passkeyRpId zhodné s doménou a oauthClientRef.
  3. Prihlasujte ľudí cez pomocné funkcie SDK na prihlásenie a ich dve verejné trasy deklarujte presne, s auth: "public" a allowAnonymous: true.
  4. Každé volanie z frontendu posielajte cez proxy so zoznamom povolených položiek backendu pre frontend. Adresu služby nikdy nedávajte do klienta.
  5. Platby prenechajte administrátorovi zákazníka, ktorý pripojí platobné brány a nastaví pokladňu v značke zákazníka.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Dôkazom je scope-adherence. Nechránenú trasu /api pripustí iba vtedy, keď manifest deklaruje presne túto metódu a cestu ako verejnú a cesta je jednou z prihlasovacích trás; akákoľvek iná verejná deklarácia zlyhá a uvedie dve povolené cesty. api-contract potom porovná deklarované trasy so skutočnými v oboch smeroch. definePlugin tiež odmietne frontend.basePath, ktorý nie je relatívnou cestou v rámci rovnakého pôvodu.

White-label je doplnok Storefront / white-label v edícii Enterprise, ktorý zároveň licencuje platby. Údaje o kartách sa nikdy nedostanú do Nexus. Značku vlastní administrátor zákazníka a platforma ju určuje z organizácie, nie z vášho kódu.

8. Misiový balík pre Edge

Cieľom je nová alebo aktualizovaná misia pre satelit alebo dron s Nexus Edge, napríklad pridanie adaptéra na vyhľadávanie lodí do misie námorného dozoru. Stavebným prvkom je balík misie, zostavený a podpísaný na zemi.

  1. Začnite od aktuálneho balíka na stránke Zostavenie balíka misie, ktorá z pôvodnej verzie pripraví návrh novej a označí každú zmenu.
  2. Meňte len to, čo misia potrebuje. Veľké časti, jazykový model a ontológiu, ponechajte podľa možnosti nezmenené.
  3. Pri každom stupni zníženej prevádzky skontrolujte tabuľku umiestnenia, aby každá doska stále zvládala to, čo na nej beží.
  4. Spustite testovacie prípady balíka určené pre palubu na skúšobnom zariadení s rovnakými doskami.
  5. Odošlite ho na podpis: sú potrebné dva z troch podpisov.
  6. Vydajte ho pre jednu platformu. Uloží sa do nečinného slotu a zapne sa až po tom, ako jeho testovacie prípady prejdú na palube.
  7. Po týždni bez problémov ho nasaďte na ďalšiu platformu.
Balíky misií
Balíky misií
Knižnica balíkov misií s obsahom každého balíka a platformami, na ktorých beží. Všimnite si staršiu verziu uchovanú na palube pre návrat a počet testovacích prípadov, ktoré musí každý balík splniť na svojom hardvéri.

Tento postup neobsahuje žiadne príkazy; vykonáva sa na stránkach Nexus Edge v konzole. Dôkazom sú testovacie prípady na palube, ktoré musia všetky prejsť pred zapnutím balíka, a dva podpisy. Ak test na palube zlyhá, platforma zostane na predchádzajúcom balíku a informácia o zlyhaní sa prenesie pri ďalšom prelete. Inštalácia balíka na hardvér, pre ktorý nebol overený, sa odmietne s PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge je doplnok licencovaný na platformu alebo na flotilu. Balíky zostávajú platné, aj keď je platforma mimo spojenia. Uplink je úzky, preto plánujte veľkosti s ohľadom naň: naše vydanie 1.5 malo 412 MB, oproti 9.8 GB pri balíku s novým jazykovým modelom.

9. Doručenie zákazníkovi do izolovaného prostredia (air-gapped)

Cieľom je váš plugin alebo balík nainštalovaný u zákazníka bez siete. Stavebnými prvkami sú zapečatený balík z @adverant/nexus-sovereign, váš podpisový kľúč pre vydania a vlastné kanály vydaní zákazníka.

  1. Zostavte plugin a jeho obrazy presne ako pre pripojeného zákazníka, so všetkými kontrolami v zelenom stave.
  2. Vytvorte zapečatený balík s profilom airgap, ktorý obsahuje obrazy, migrácie, vopred podpísané skills a SBOM (zoznam softvérových komponentov) s licenciami.
  3. Podpíšte ho svojím kľúčom Ed25519 pre vydania.
  4. Sami ho overte na čistom počítači.
  5. Balík odošlite na médiu a svoj verejný kľúč a SHA-256 balíka pošlite inou cestou.
  6. Operátor zákazníka overí balík vaším kľúčom a potom prevezme vydanie cez vlastné kanály vydaní.
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 zostaví balík z vašej konfigurácie balíka. Dôkazom je nexus-airgap verify na strane zákazníka. Znovu vypočíta hash každého súboru, odmietne každý súbor, ktorý manifest neuvádza, vyžaduje dôveryhodného podpisovateľa a odmietne balík, ktorého zoznam povolených sieťových adries nie je prázdny. Zmenený súbor zlyhá s BUNDLE_INTEGRITY_VIOLATION. Nikto by nikdy nemal vypnúť prísnu kontrolu, aby ju obišiel.

Inštalácie bez pripojenia k sieti (air-gapped) sú súčasťou edície Enterprise. Nič v balíku nesmie pri inštalácii nič sťahovať a model, ktorý plugin potrebuje, pochádza z vlastného modelového servera zákazníka cez AI (umelá inteligencia) Provider Router.

10. Modul výhradne pre edíciu Enterprise

Cieľom je uzavretá, licencovaná funkcia, ktorá sa pripája k otvorenému jadru, napríklad audítorský záznam s dlhou dobou uchovávania predávaný len zákazníkom Enterprise. Stavebným prvkom je balík rozhraní @adverant/nexus-spi a nič iné z Community.

  1. Uchovávajte vo svojom repozitári kópiu zostaveného balíka rozhraní pripnutú na úrovni bajtov ako lokálny balík file: s jeho pripnutím SHA256SUMS.
  2. Napíšte voči nemu RouteModule (alebo ScreenModule pre obrazovky konzoly) so skupinou funkcií, ktorej slúži.
  3. Každú trasu spúšťajte za ctx.requireScope a pred odpoveďou skontrolujte vlastné oprávnenie modulu.
  4. Ak organizácia nemá nárok, odmietnite s LICENCE_LOCKED a zobrazte ukážku funkcie, nikdy nie jej údaje.
  5. Dodržiavajte v repozitári licenčnú hranicu a potom zostavte zložený strom každej edície.
npm ci
npm test
npm run build

Dôkazom je pravidlo licenčnej hranice: žiadny import z rozsahu Community okrem balíka rozhraní, žiadny relatívny import mimo repozitára a žiadna závislosť file:, link: ani workspace: mimo neho. Potom musia tri vyššie uvedené príkazy prejsť v zloženom strome každej edície, nielen vo vašom pracovnom strome. Kapitola 2.25, Zostavenie pre každú edíciu, obsahuje kostru modulu.

Modul sa načíta do služby Community pri štarte na inštaláciách, ktorých licencia obsahuje jeho skupinu funkcií. Bez tohto oprávnenia odmieta, takže sa všade dodáva rovnaké zostavenie, ktoré tam, kde nie je licencované, nerobí nič.

11. Vytvorenie vetvy (fork) alebo rozšírenie otvoreného jadra

Cieľom je zmena samotnej Community, ponechaná vo vašom forku alebo prispená späť. Stavebným prvkom je zdrojový kód Community pod licenciou Apache License, Version 2.0.

  1. Vytvorte fork repozitára a vetvu z main.
  2. Ak to, čo chcete, môže byť plugin alebo skill, uprednostnite ich. Zmenu jadra musíte udržiavať pri každom vydaní sami.
  3. Zmenu urobte s testami, ktoré bez nej zlyhajú.
  4. Pred akýmkoľvek návrhom spustite kontroly, ktoré spúšťa projekt.
  5. Zachovajte súbor NOTICE a nepoužívajte názvy ani ochranné známky spoločnosti Adverant nad rámec uvedenia pôvodu diela.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Dôkazom je úspešné prejdenie týchto troch kontrol a doklad, že každý nový test pred vašou zmenou zlyhal. Zachovajte vo svojom forku jednu vlastnosť otvoreného jadra: Community spustí agenta od začiatku do konca na lokálnom modeli bez kľúča a bez siete. Zmena, ktorá to poruší, poruší to, vďaka čomu je Community použiteľná samostatne.

Toto platí len pre Community. Čokoľvek, čo musí zostať uzavreté, patrí namiesto toho do modulu Enterprise (scenár 10), aby licenčná hranica zostala na mieste, na ktoré môže ktokoľvek ukázať.

12. Cloudová aplikácia pre edíciu Team

Cieľom je aplikácia, ktorú si môžu nainštalovať zákazníci Team. Team beží len v cloude Adverant, takže aplikácia sa k nim dostane len cez katalóg. Stavebnými prvkami sú plugin a klaster vydavateľa: váš vlastný virtuálny klaster v cloude Adverant so vzorovými údajmi.

  1. Zostavujte a testujte na klastri vydavateľa, len so vzorovými údajmi.
  2. V manifeste deklarujte všetko, čo aplikácia potrebuje, a nič viac.
  3. Vydajte ju podpísanú na posúdenie spoločnosťou Adverant a zaradenie do katalógu.
  4. Každý zákazník ju nainštaluje a udelí každý deklarovaný rozsah jednotku po jednotke.

Dôkaz má dve časti. Podpísané a posúdené vydanie vás dostane do katalógu. Potom oprávnenie zákazníka rozhodne, k čomu má aplikácia u neho prístup, a každé volanie, ktoré nedeklarovala, sa odmietne s CONNECTION_SCOPE_EXCEEDED. Chýbajúci rozsah môžete pridať len v novom vydaní, ktoré zákazník posúdi.

Inštalácia pluginu tretej strany
Inštalácia pluginu tretej strany
Administrátor inštaluje plugin tretej strany, udeľuje každý deklarovaný rozsah pre jednotlivé jednotky a jeden vynecháva. Tabuľka zobrazuje odmietnuté volanie, ktoré plugin nikdy nedeklaroval.

Klaster vydavateľa nemá cestu k žiadnemu zákazníkovi a žiadosť o údaje zákazníka sa tam odmietne s TENANT_BOUNDARY. Zákazníci s vami môžu zdieľať výsledky testov, nikdy nie svoje údaje. Team obsahuje funkciu prevádzky workflowov, takže ak vaša aplikácia dodáva workflowy, zákazníci Team ich môžu sami presúvať medzi prostrediami.

13. Obalenie existujúcej internej aplikácie ako zásuvného modulu

Cieľom je aplikácia, ktorú vaša spoločnosť už prevádzkuje, prenesená do Nexus, aby zdedila prihlasovanie, izoláciu a správu. Stavebnými prvkami sú skill /plugin-create pre prvý návrh a nástroje manifestu a kontroly SDK na jeho dokončenie.

  1. Spustite /plugin-create s repozitárom. Analyzuje kód, zvolí stratégiu obalenia a potom vygeneruje backend, migrácie, používateľské rozhranie (UI), manifest a testy.
  2. Povýšte manifest na kontrakt v2. migrate pridá tri vety zákona a presunie domain do domains[], pričom odmietne vymyslieť vstupný bod.
  3. Každú hodnotu tenanta, ktorú obal číta z hlavičiek, nahraďte strážcom rozsahu zo SDK.
  4. Pridajte organization_id, owner_user_id a business_unit_id do každej tabuľky s primárnymi kľúčmi začínajúcimi tenantom.
  5. Deklarujte každú trasu s jej oprávnením a nainštalujte register odmietnutí.
  6. Spúšťajte kontroly, kým nebudú v zelenom stave.
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

Dôkazom je nexus-gates s návratovým kódom 0, pričom scope-adherence, one-fence, migrations-are-scoped, crud-adherence a api-contract všetky prejdú. Počítajte s tým, že prvé spustenie väčšinu z nich nesplní; u nás hlásilo každú trasu ako bez rozsahu, pretože návrh dôveroval hlavičkám, ktoré mohol nastaviť prehliadač. Kontroly zámerne nemajú prepínač na opravu.

Obalené aplikácie fungujú v každej edícii. Nasadenie prebieha len cez kanály vydaní inštalácie, preto ignorujte všetky súbory nasadenia, ktoré návrh vytvoril. Najviac času zaberie práca na izolácii: pri skutočnej aplikácii počítajte s dňami, nie hodinami.