Přihlásit seDomluvit prezentaci

Kapitola 2.27

Scénáře sestavení

Kuchařka třinácti sestavení, od jediné dovednosti až po doručení do izolovaného (air-gapped) prostředí. Každý recept uvádí cíl, stavební bloky, kroky a příkazy, kontrolní bránu ověřující funkčnost a rozdíly podle edice a formy doručení.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

25 min čtení

Toto jsou postupy, po kterých sahám, když někdo ve společnosti Corrán Orbital nebo u zákazníka řekne: „Chceme, aby Nexus dělal X“. Každý je záměrně stručný. Zdůvodnění jednotlivých kroků najdete v předchozích kapitolách: kapitola 2.20, Dovednosti, a kapitola 2.21, Plugin SDK, která se věnuje sadě pro vývoj softwaru, dále kapitola 2.23, Doménové balíčky, a tři kapitoly po ní, které se týkají sestavování. Zde najdete cíl, stavební bloky, které použít, kroky, příkazy, kontrolu, která potvrdí, že vše funguje, a poznámky k edicím a dodání.

Nejdůležitější je kontrola. Postup je hotový, když je jeho kontrola zelená. Každou kontrolu v této kapitole můžete spustit sami, nebo ji platforma spustí za vás, a každá skončí nenulovým kódem nebo odmítnutím s kódem, pokud není splněna.

Scénář Hlavní stavební blok Kontrola, která to dokazuje Edice
Nová dovednost Skills Engine Balíček SKILL.md skill:validate bez jediné chyby Community a Enterprise
Dovednost v manifestu s host_callback Manifest pluginu skills[] create-nexus-plugin validate a nexus-gates Community a Enterprise
Rozšíření existujícího balíčku pack.json s inherits Kontrola zásad pohledů v pilotní kontrole Enterprise a licence balíčku
Nový balíček od začátku Standardní postup pro doménové balíčky Kontroly pro staging a pilotní provoz Enterprise
Datový konektor Dovednost plugin_queue validate, nexus-gates, odmítnutí odchozího provozu Community a Enterprise
Nástroj MCP (Model Context Protocol) Manifest mcpTools[] validate (bez kombinátorů na nejvyšší úrovni) Community a Enterprise
Obchod pod vlastní značkou Manifest domains a branding Veřejné pravidlo scope-adherence Enterprise a doplněk Storefront
Misijní balíček pro Edge Misijní balíček Testovací případy na palubě, dva ze tří podpisů Enterprise a doplněk Nexus Edge
Dodání do izolovaného prostředí Zapečetěný balík nexus-airgap verify Enterprise
Modul pouze pro Enterprise @adverant/nexus-spi Kontrola licenční hranice, sestavení edic Enterprise
Fork nebo rozšíření otevřeného jádra Zdrojový kód Community Testy, lint a kontrola typů Community
Cloudová aplikace pro edici Team Cluster vydavatele Podepsané vydání, revize, udělení zákazníkovi Team
Zabalení existující interní aplikace /plugin-create migrate, validate, nexus-gates Community a Enterprise
Rozhodovací strom čtený shora dolů. První kosočtverec se ptá „Potřebuje kód běžící neustále?“. „Ne“ vede ke kosočtverci „Jde o pokyny pro asistenta?“, jehož „Ano“ končí u „Dovednost Skills Engine“ a jehož „Ne“ končí u „Pohled na existující balíček“. „Ano“ vede ke kosočtverci „Jde o pohled jednoho odvětví na platformu?“, jehož „Ano“ končí u „Doménový balíček (s jeho pluginem)“ a jehož „Ne“ vede k poslednímu kosočtverci „Musí zůstat uzavřený a licencovaný?“, končícímu u „Modul Enterprise“ pro „Ano“ a „Plugin“ pro „Ne“.
Od jakého stavebního bloku začít.

1. Nová dovednost pro Skills Engine

Cílem je opakovaně použitelný kus instrukcí, který mohou spouštět asistent, agenti, pracovní postupy i vývojářské nástroje, například kontrola celního podání podle jeho pravidel. Vašimi stavebními bloky jsou balíček SKILL.md ve složce pojmenované podle dovednosti, volitelný skill.yaml pro spouštěče a štítky a volitelná složka scripts/, která je k němu přibalena.

  1. Vytvořte skills/<slug>/ a napište SKILL.md s frontmatter: name (kebab-case, shodné s názvem složky), description (nejvýše 500 znaků), allowed-tools a volitelně triggers, capabilities a version.
  2. Napište tělo pro model: kdy dovednost použít, její kroky, příklady a co nesmí nikdy dělat.
  3. Přidejte testovací případy. Zahrňte jeden se vstupem, do kterého je podstrčena instrukce, kterou dovednost nesmí provést.
  4. Proveďte validaci, prohlédněte si plán nahrání a poté nahrajte.
  5. Publikujte. Dovednost, která přidává nástroj pro zápis, je pozdržena, dokud ji neschválí dvě jmenovitě určené osoby pomocí přístupových klíčů (passkey), přičemž navrhovatel nemůže schválit vlastní změnu.
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

Kontrolou je skill:validate, který musí hlásit nula chyb, než lze cokoli publikovat. Blokujícími chybami jsou chybějící název nebo popis a duplicitní slug nebo typ úlohy. Nahrání obsahu, který je již publikován, vrátí existující verzi (CONTENT_HASH_ALREADY_PUBLISHED), takže nahrání lze bezpečně opakovat.

Community obsahuje celý tvůrce, knihovnu, verze, návrat k předchozí verzi, import a testy. V edici Enterprise prochází publikování také režimy shadow a canary: schválená verze běží ve stínovém režimu, poté pro jednu jednotku za jmenovitými kontrolami, poté pro všechny a sama se zastaví, pokud některá kontrola není splněna. U zákazníka v izolovaném prostředí putují dovednosti předem podepsané uvnitř zapečetěného balíku (scénář 9).

2. Dovednost manifestu s host_callback

Cílem je deterministický výpočet ve vašem vlastním pluginu, který platforma může spouštět, například otevření záznamu o odchylce na základě odečtu. Použijete řádek v skills[] manifestu s úrovní host_callback a trasu /internal ve vašem backendu chráněnou ochranou služby (service guard) ze SDK.

  1. Deklarujte dovednost: id v lower_snake, tier: "host_callback", classification na úrovni důvěry vašeho pluginu nebo pod ní, inputSchema, outputSchema a timeoutMs v rozmezí 1 sekunda až 6 hodin.
  2. Vyplňte hostCallback: název vlastní služby (Service), její port, relativní cestu, napří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" nebo auth: "internal" a chraňte ji pomocí requireService nebo serviceMiddleware, nikdy ne ochranou uživatelského rozsahu.
  4. Proveďte validaci, spusťte kontroly a nechte onboarding synchronizovat dovednosti do registru prostřednictvím compileRegistry. SQL pro registr nikdy nepíšete ručně.
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í pravidla synchronizace registru dříve, než se cokoli synchronizuje, a každé porušení odmítne s kódem přijímající strany. Cesta se schématem, // nebo zpětným lomítkem je odmítnuta jako cross-origin. Chybějící bajtový limit je ENDPOINT_BYTE_CAP_REQUIRED, pole z jiné úrovně je FIELD_NOT_FOR_TIER a časový limit mimo rozsah je TIMEOUT_OUT_OF_BOUNDS. Poté nexus-gates ověří, že trasa /internal nese ochranu služby a je deklarována jako internal nebo service-key. Tato dvojice kontrol je důkazem.

Synchronizace je deklarativní. Pokaždé odešlete celou sadu dovedností, protože dovednost, kterou vynecháte, bude zakázána, a nechte krok nasazení selhat při jakémkoli jiném stavu než 200. V edici Enterprise se synchronizace pluginu kontroluje jako celek: pokud jedna dovednost poruší pravidlo, nic z dané synchronizace se nepřevezme (PLUGIN_SYNC_ALL_OR_NOTHING) a dál běží předchozí verze. Plugin s komunitní úrovní důvěry nemůže používat úrovně, které se dostanou k modelu, tool_using a llm_only; ty vyžadují důvěru core nebo verified.

Pluginy a synchronizace MCP
Pluginy a synchronizace MCP
Pluginy, které přinášejí dovednosti, a co bylo u každé synchronizace kontrolováno. Všimněte si pluginu, jehož synchronizace byla odmítnuta jako celek, protože jedna z jeho pěti dovedností použila úroveň, kterou smí hostovat pouze platforma, zatímco jeho předchozí verze dál běžela.

3. Rozšíření existujícího balíčku

Cílem je nové odvětví nebo pododvětví, které přebírá většinu existujícího balíčku, například úvěry a reklamace karet postavené na struktuře balíčku Insurance. Stavebním blokem je pack.json, který v inherits uvádí svého rodiče a přidává pouze vlastní skupiny pohledů a pojmy.

  1. Založte balíček pomocí standardního postupu pro doménové balíčky a poté nastavte inherits na id rodičovského balíčku.
  2. Přidejte vlastní skupiny lens, každou s jejími rolemi, účelem a odkazem na slovník.
  3. Přidejte své pojmy do slovníku, každý s jednoduchým vysvětlením. Pojem označte jako exact, pokud musí být zobrazen přesně tak, jak je napsán.
  4. Místo kreslení vlastních pohledů znovu použijte sdílené pohledy: režim, který potřebuje více balíčků, například registr outsourcovaných technologií, je jeden sdílený pohled.
  5. Zkontrolujte licenční řetězec. Váš balíček dědí požadavky rodiče na doplňky.
  6. Zobrazte si náhled každého pohledu jako konkrétní osoba na syntetické větvi.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Důkazem je kontrola zásad v pilotní kontrole, která potvrzuje, že každý pohled pouze zužuje svůj základ a ve výchozím stavu ponechává osobní pole skrytá. Pohled, který se pokusí zobrazit, co jeho základ skrývá, je odmítnut s LENS_CANNOT_WIDEN. Na straně licencí konzole odmítne vydat licenci pro váš balíček bez doplňků, které potřebuje jeho rodič; balíček Insurance vyžaduje rozhodovací místnosti a zapečetěné záznamy.

Doménové balíčky jsou součástí edice Enterprise a licencují se po jednotlivých balíčcích. Obrazovky balíčku pro telefony navíc vyžadují doplněk Mobilní aplikace. Podřízený balíček nemůže měnit shell, komponenty ani pravidla psaní.

4. Nový balíček od nuly

Cílem je pohled jednoho odvětví na Nexus: jeho znalostní model, pohledy pro každou roli, důkazy, které vyžadují jeho pravidla, a plugin, který udržuje jeho data aktuální. Kapitola 2.24, Sestavení vlastní vertikály od začátku do konce, prochází toto sestavení podrobně; zde je zkrácená verze.

  1. Spusťte standardní postup pro doménové balíčky a popište balíček: účel, jednotky, základní model a pravidla, která mapuje.
  2. Sestavte znalostní model na základním modelu a každou vlastnost při přidání zařaďte do třídy.
  3. Přečtěte si plán, potvrďte jeho otisk svým přístupovým klíčem (passkey) a vytvořte.
  4. Utvořte pohledy v nástroji Lens builder, každý jako zúžení základního pohledu.
  5. Napište plugin a všechny dovednosti Skills Engine, které balíček potřebuje.
  6. Vygenerujte syntetická data se semínkem, včetně neobvyklých případů, na kterých vám záleží, a zobrazte si náhled každého pohledu jako konkrétní osoba.
  7. Povyšte z vývojového prostoru do stagingu, poté do pilotní jednotky a nakonec do všech jednotek.

Důkazem jsou kontroly povýšení: všechny testy na syntetických větvích úspěšné před přechodem do stagingu, poté dva revizoři, kteří nejsou autory, poté 14 dní v pilotním provozu s chybovostí pod 1 z 1,000. Žádný krok nelze přeskočit (GATE_CANNOT_BE_SKIPPED). Balíčky jsou součástí edice Enterprise. V edici Community není standardní postup pro doménové balíčky nabízen.

5. Datový konektor

Cílem jsou data z externího systému, která podle plánu proudí do vlastních tabulek vašeho pluginu, například události brány z terminálového operačního systému. Stavebními bloky jsou dovednost plugin_queue, worker, který odebírá z vaší fronty, migrace pro cílovou tabulku a odchozí adresa deklarovaná v manifestu.

  1. Deklarujte dovednost plugin_queue s queueName zapsaným jako <plugin name>.<name>. Dvojtečka není povolena a název musí být v manifestu, protože orchestrátor do ní zařazuje úlohy přímo.
  2. Napište worker, který odebírá z fronty a volá externí systém.
  3. Deklarujte adresu externího systému jako odchozí adresu. Vše, co není uvedeno, je blokováno.
  4. Příchozí data ukládejte do vlastního schématu, s organization_id, owner_user_id a business_unit_id v každém řádku.
  5. Přihlašovací údaje externího systému čtěte podle názvu z prostředí a proměnnou uveďte v scripts/ci/required-env.
  6. Stahování spouštějte prostřednictvím UNO, enginu pracovních postupů, nikdy časovačem, který volá enginy přímo.
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 ověří název fronty a časový limit podle pravidel synchronizace registru. Tři kontroly dokazují, že neexistují žádné přihlašovací údaje k modelu, žádný přímý výpočet a že tabulka má správně vymezený rozsah. Před odesláním spusťte úplný nexus-gates, protože --only běh zužuje a uvádí to ve svém souhrnu. Za běhu je volání na adresu, kterou manifest nedeklaroval, zastaveno na okraji s EGRESS_NOT_DECLARED.

Vlastní konektory platformy k diskům, wiki, poštovním úložištím a starším systémům, se zachytáváním změn a sledováním původu dat, jsou součástí doplňku Datové konektory. Konektor, který si vytvoříte sami, je plugin a funguje v jakékoli edici. Přidání odchozí adresy v pozdějším vydání je rozšířením, které je pozdrženo, dokud jej nepřijmou dva revizoři.

6. Nástroj MCP

Cílem je nástroj, který mohou volat Claude Code, agenti a další klienti MCP (Model Context Protocol), například vyhledání historie inspekcí plavidla. Stavebním blokem je položka v mcpTools[] manifestu s name, description a inputSchema.

  1. Pojmenujte nástroj a popište jej srozumitelně. Popis je to, co model čte, když se rozhoduje, zda jej zavolat.
  2. Napište inputSchema jako jedno objektové schéma. Na jeho nejvyšší úroveň nedávejte oneOf, allOf ani anyOf.
  3. Trasu, která nástroj obsluhuje, ponechte za ochranou rozsahu jako každou jinou trasu /api, aby se příslušnost k tenantovi odvozovala z tokenu volajícího.
  4. Proveďte validaci manifestu.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Důkazem je validate: kombinátor na nejvyšší úrovni je odmítnut již při tvorbě, protože za běhu by způsobil selhání nástroje pro každého podagenta MCP, který jej importuje, a nástroj by existoval, aniž by jej kdokoli mohl zavolat.

V edici Enterprise je každý nástroj, který může volat IDE (integrované vývojové prostředí), uveden v katalogu nástrojů Workbench s jeho úrovní, informací, zda něco mění, připnutým otiskem a rolemi, které jej smějí používat. Pokud se popis vašeho nástroje v novém vydání změní, katalog nástroj pozdrží, dokud změnu nezkontroluje člověk. To je záměrné: změněný popis je způsob, jak může nástroj začít žádat model o něco, co by neměl. Volání čehokoli mimo oprávnění volajícího je odmítnuto s CONNECTION_SCOPE_EXCEEDED.

7. White-label výloha

Cílem je aplikace, kterou používají zákazníci vašeho zákazníka, na doméně zákazníka a v jeho značce, bez jakékoli stopy po Adverant. Stavebními bloky jsou bloky domains a branding v manifestu, pomocné funkce SDK pro přihlášení a zákazníkův doplněk Storefront / white-label.

  1. Doménu zákazníka uveďte v domains[] jako primary, spolu s případnými aliases.
  2. Vyplňte branding: appName, tagline, primaryColor, accentColor, passkeyRpId shodné s doménou a oauthClientRef.
  3. Přihlašujte uživatele pomocí pomocných funkcí SDK pro přihlášení a jejich dvě veřejné trasy deklarujte přesně, s auth: "public" a allowAnonymous: true.
  4. Každé volání z frontendu posílejte přes proxy backendu pro frontend se seznamem povolených. Nikdy neuvádějte adresu služby v klientovi.
  5. Platby ponechte na administrátorovi zákazníka, který připojí platební brány a nastaví pokladnu ve značce zákazníka.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Důkazem je scope-adherence. Nechráněnou trasu /api připustí pouze tehdy, když manifest deklaruje přesně tuto metodu a cestu jako veřejnou a cesta je jednou z přihlašovacích tras; jakákoli jiná veřejná deklarace selže a uvede dvě povolené cesty. api-contract poté porovná deklarované trasy se skutečnými v obou směrech. definePlugin také odmítne frontend.basePath, který není relativní cestou se stejným původem.

White-label je doplněk Storefront / white-label v edici Enterprise, který zároveň licencuje platby. Údaje o platebních kartách se nikdy nedostanou do Nexus. Značku vlastní administrátor zákazníka a platforma ji určuje podle organizace, nikoli podle vašeho kódu.

8. Balíček mise pro Edge

Cílem je nová nebo aktualizovaná mise pro satelit nebo dron s Nexus Edge, například přidání adaptéru pro vyhledávání lodí do mise námořního dohledu. Stavebním prvkem je balíček mise, sestavený a podepsaný na zemi.

  1. Začněte od aktuálního balíčku na stránce Sestavení balíčku mise, která vytvoří koncept nové verze ze staré a označí každou změnu.
  2. Měňte pouze to, co mise potřebuje. Velké části, jazykový model a ontologii, ponechte pokud možno beze změny.
  3. Zkontrolujte tabulku umístění v každém kroku degradace, aby každá deska stále odpovídala tomu, co na ní běží.
  4. Spusťte palubní testovací případy balíčku na zkušební sestavě se stejnými deskami.
  5. Odešlete jej k podpisu: jsou potřeba dva ze tří podpisů.
  6. Vydejte jej pro jednu platformu. Uloží se do nečinného slotu a aktivuje se teprve poté, co jeho testovací případy na palubě projdou.
  7. Po týdnu bez problémů jej nasaďte na další platformu.
Balíčky misí
Balíčky misí
Knihovna balíčků misí s obsahem každého balíčku a platformami, na kterých běží. Všimněte si starší verze uchované na palubě pro návrat a počtu testovacích případů, které musí každý balíček projít na svém hardwaru.

Tento postup neobsahuje žádné příkazy; provádí se na stránkách Nexus Edge v konzoli. Důkazem jsou palubní testovací případy, které musí všechny projít před aktivací balíčku, a dva podpisy. Pokud test na palubě selže, platforma zůstane na předchozím balíčku a informace o selhání se stáhne při dalším přeletu. Instalace balíčku na hardware, pro který nebyl ověřen, je odmítnuta s PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge je doplněk licencovaný na platformu nebo na flotilu. Balíčky zůstávají platné i v době, kdy je platforma mimo spojení. Uplink je úzký, proto plánujte velikosti s ohledem na něj: naše verze 1.5 měla 412 MB, oproti 9.8 GB u balíčku s novým jazykovým modelem.

9. Doručení zákazníkovi do izolovaného (air-gapped) prostředí

Cílem je váš plugin nebo balíček nainstalovaný u zákazníka bez sítě. Stavebními prvky jsou zapečetěný bundle z @adverant/nexus-sovereign, váš podpisový klíč pro vydání a vlastní kanály vydání zákazníka.

  1. Sestavte plugin a jeho obrazy přesně jako pro připojeného zákazníka, se všemi kontrolami zelenými.
  2. Vytvořte zapečetěný bundle s profilem airgap, který obsahuje obrazy, migrace, předem podepsané dovednosti a SBOM (software bill of materials) s licencemi.
  3. Podepište jej svým klíčem pro vydání Ed25519.
  4. Sami jej ověřte na čistém počítači.
  5. Bundle odešlete na médiu a svůj veřejný klíč a SHA-256 bundlu pošlete jinou cestou.
  6. Operátor zákazníka ověří bundle vaším klíčem a poté převezme vydání prostřednictvím vlastních kanálů vydání.
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 sestaví bundle z vaší konfigurace bundlu. Důkazem je nexus-airgap verify na straně zákazníka. Znovu vypočítá hash každého souboru, odmítne každý soubor, který manifest neuvádí, vyžaduje důvěryhodného podepisovatele a odmítne bundle, jehož seznam povolených síťových přístupů není prázdný. Změněný soubor selže s BUNDLE_INTEGRITY_VIOLATION. Nikdo by nikdy neměl vypínat striktní kontrolu, aby ji obešel.

Instalace v izolovaném prostředí (air-gapped) jsou součástí edice Enterprise. Nic v bundlu nesmí při instalaci nic stahovat a model, který plugin potřebuje, pochází z vlastního modelového serveru zákazníka prostřednictvím AI (umělá inteligence) Provider Router.

10. Modul pouze pro edici Enterprise

Cílem je uzavřená licencovaná funkce, která se připojuje k otevřenému jádru, například auditní záznam s dlouhou dobou uchování prodávaný pouze zákazníkům Enterprise. Stavebním prvkem je balíček rozhraní @adverant/nexus-spi a nic jiného z Community.

  1. Uchovávejte ve svém repozitáři bajtově připnutou kopii sestaveného balíčku rozhraní jako lokální balíček file: s jeho připnutím SHA256SUMS.
  2. Napište proti němu RouteModule (nebo ScreenModule pro obrazovky konzole) se skupinou funkcí, kterou obsluhuje.
  3. Provozujte každou trasu za ctx.requireScope a před odpovědí zkontrolujte vlastní oprávnění modulu.
  4. Odmítněte s LICENCE_LOCKED, pokud organizace nemá nárok, a zobrazte upoutávku funkce, nikdy její data.
  5. Udržujte repozitář v souladu s licenční hranicí a poté sestavte složený strom každé edice.
npm ci
npm test
npm run build

Důkazem je pravidlo licenční hranice: žádný import z oboru Community kromě balíčku rozhraní, žádný relativní import mimo repozitář a žádná závislost file:, link: nebo workspace: mimo něj. Poté musí tři výše uvedené příkazy projít v každém složeném stromu edice, nejen ve vašem pracovním stromu. Kapitola 2.25, Sestavení pro každou edici, obsahuje kostru modulu.

Modul se načte do služby Community při spuštění v instalacích, jejichž licence obsahuje jeho skupinu funkcí. Bez tohoto oprávnění odmítá, takže stejné sestavení se dodává všude a tam, kde není licencováno, nic nedělá.

11. Rozvětvení (fork) nebo rozšíření otevřeného jádra

Cílem je změna samotné Community, uchovaná ve vašem forku nebo přispěná zpět. Stavebním prvkem je zdrojový kód Community pod licencí Apache License, Version 2.0.

  1. Vytvořte fork repozitáře a větev z main.
  2. Upřednostněte plugin nebo dovednost, pokud jimi může být to, co chcete. Změnu jádra musíte udržovat sami při každém vydání.
  3. Proveďte změnu s testy, které bez ní selžou.
  4. Než cokoli navrhnete, spusťte kontroly, které projekt používá.
  5. Zachovejte soubor NOTICE a nepoužívejte názvy ani ochranné známky Adverant nad rámec uvedení, odkud dílo pochází.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Důkazem je úspěšné projití těchto tří kontrol a doklad, že každý nový test před vaší změnou selhal. Ve svém forku zachovejte jednu vlastnost otevřeného jádra: Community spustí agenta od začátku do konce na lokálním modelu bez klíče a bez sítě. Změna, která to naruší, naruší to, co činí Community samostatně použitelnou.

Toto platí pouze pro Community. Cokoli, co má zůstat uzavřené, patří místo toho do modulu Enterprise (scénář 10), aby licenční hranice zůstala na místě, na které může kdokoli ukázat.

12. Cloudová aplikace pro edici Team

Cílem je aplikace, kterou si mohou nainstalovat zákazníci Team. Team běží pouze na Adverant cloud, takže aplikace se k nim dostane jen přes katalog. Stavebními prvky jsou plugin a cluster vydavatele: váš vlastní virtuální cluster na Adverant cloud s ukázkovými daty.

  1. Sestavujte a testujte na clusteru vydavatele, pouze s ukázkovými daty.
  2. V manifestu deklarujte vše, co aplikace potřebuje, a nic víc.
  3. Vydejte ji podepsanou ke kontrole společností Adverant a k zařazení do katalogu.
  4. Každý zákazník ji nainstaluje a udělí každý deklarovaný rozsah jednotku po jednotce.

Důkaz má dvě části. Podepsané a zkontrolované vydání vás dostane do katalogu. Poté oprávnění zákazníka rozhoduje, k čemu má aplikace u něj přístup, a každé volání, které nedeklarovala, je odmítnuto s CONNECTION_SCOPE_EXCEEDED. Chybějící rozsah můžete přidat pouze v novém vydání, které zákazník zkontroluje.

Instalace pluginu třetí strany
Instalace pluginu třetí strany
Administrátor instaluje plugin třetí strany, uděluje každý deklarovaný rozsah pro jednotlivé jednotky a jeden vynechává. Obrázek ukazuje odmítnuté volání, které plugin nikdy nedeklaroval.

Cluster vydavatele nemá cestu k žádnému zákazníkovi a požadavek na data zákazníka je tam odmítnut s TENANT_BOUNDARY. Zákazníci s vámi mohou sdílet výsledky testů, nikdy svá data. Team zahrnuje funkci provozu pracovních postupů, takže pokud vaše aplikace dodává pracovní postupy, zákazníci Team je mohou sami povyšovat mezi prostředími.

13. Zabalení existující interní aplikace jako pluginu

Cílem je aplikace, kterou vaše společnost již provozuje, převedená do Nexus, aby zdědila přihlašování, izolaci a správu. Stavebními prvky jsou dovednost /plugin-create pro první koncept a nástroje a kontroly manifestu v SDK pro jeho dokončení.

  1. Spusťte /plugin-create s repozitářem. Analyzuje kód a zvolí strategii obalení, poté vygeneruje backend, migrace, uživatelské rozhraní (UI), manifest a testy.
  2. Převeďte manifest na kontrakt v2. migrate přidá tři věty zákona a přesune domain do domains[] a odmítne si vymyslet vstupní bod.
  3. Nahraďte každou hodnotu tenanta, kterou obal čte z hlaviček, ochranou rozsahu ze SDK.
  4. Přidejte organization_id, owner_user_id a business_unit_id do každé tabulky s primárními klíči začínajícími tenantem.
  5. Deklarujte každou trasu s jejím oprávněním a nainstalujte evidenci odmítnutí.
  6. Spouštějte kontroly, dokud nebudou zelené.
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ůkazem je, že nexus-gates skončí s kódem 0 a scope-adherence, one-fence, migrations-are-scoped, crud-adherence a api-contract všechny projdou. Počítejte s tím, že první spuštění u většiny z nich selže; u nás hlásilo každou trasu jako bez rozsahu, protože koncept důvěřoval hlavičkám, které mohl nastavit prohlížeč. Kontroly záměrně nemají přepínač pro opravu.

Obalené aplikace fungují v jakékoli edici. Nasazení probíhá pouze prostřednictvím kanálů vydání instalace, proto ignorujte všechny soubory nasazení, které koncept vytvořil. Nejvíce času zabere práce na izolaci: u skutečné aplikace počítejte s dny, ne hodinami.