Versiune 1.0.0-alpha.1cea mai recentă
Capitolul 2.27
Scenarii de construire
Un ghid practic cu treisprezece construcții, de la o singură competență până la o livrare izolată de rețea (air-gapped). Fiecare rețetă prezintă obiectivul, blocurile de construcție, pașii și comenzile, poarta de validare care demonstrează că a funcționat și ceea ce se schimbă în funcție de ediție și de forma de livrare.
Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

Acestea sunt rețetele la care apelez atunci când cineva de la Corrán Orbital sau de la un client spune „vrem ca Nexus să facă X”. Fiecare este scurtă în mod intenționat. Raționamentul din spatele pașilor se află în capitolele dinaintea acestuia: capitolul 2.20, Skills, și capitolul 2.21, The Plugin SDK, care tratează kitul de dezvoltare software, apoi capitolul 2.23, Pachete de domeniu, și cele trei capitole de după acesta despre construire. Aici găsiți obiectivul, elementele de bază de folosit, pașii, comenzile, poarta care vă arată că a funcționat, precum și notele despre ediție și livrare.
Poarta contează cel mai mult. O rețetă este finalizată atunci când poarta sa este verde. Fiecare poartă din acest capitol este ceva ce puteți rula sau ceva ce platforma rulează pentru dumneavoastră și fiecare se încheie cu un cod de ieșire diferit de zero sau refuză cu un cod atunci când nu este îndeplinită.
| Scenariu | Elementul de bază principal | Poarta care o dovedește | Ediție |
|---|---|---|---|
| Un skill nou pentru Skills Engine | Pachet SKILL.md |
skill:validate cu zero erori |
Community și Enterprise |
Un skill din manifest cu host_callback |
Manifestul pluginului skills[] |
create-nexus-plugin validate și nexus-gates |
Community și Enterprise |
| Extinderea unui pachet existent | pack.json cu inherits |
Verificarea politicii lentilelor la poarta pilot | Enterprise și o licență de pachet |
| Un pachet nou de la zero | Calea de referință pentru pachetele de domeniu | Porțile de staging și pilot | Enterprise |
| Un conector de date | Skill plugin_queue |
validate, nexus-gates, refuzul traficului de ieșire |
Community și Enterprise |
| Un instrument MCP (Model Context Protocol) | Manifestul mcpTools[] |
validate (fără combinatori la nivelul superior) |
Community și Enterprise |
| Un magazin online white-label | Manifestul domains și branding |
Regula publică scope-adherence |
Enterprise și add-on-ul Storefront |
| Un pachet de misiune Edge | Pachet de misiune | Cazuri de test la bord, două din trei semnături | Enterprise și add-on-ul Nexus Edge |
| O livrare air-gapped | Pachet sigilat | nexus-airgap verify |
Enterprise |
| Un modul exclusiv Enterprise | @adverant/nexus-spi |
Poarta liniei de licență, build-uri pe ediții | Enterprise |
| Fork-ul sau extinderea nucleului open-source | Sursa Community | Teste, lint și verificarea tipurilor | Community |
| O aplicație cloud pentru ediția Team | Cluster de editor | Versiune semnată, revizuire, acordare către client | Team |
| Încapsularea unei aplicații interne existente | /plugin-create |
migrate, validate, nexus-gates |
Community și Enterprise |
1. O nouă competență Skills Engine
Obiectivul este o instrucțiune reutilizabilă pe care asistentul, agenții, fluxurile de lucru și instrumentele pentru dezvoltatori o pot rula cu toții, cum ar fi verificarea unei declarații vamale în raport cu regulile sale. Elementele de bază sunt un pachet SKILL.md într-un folder denumit după skill, un skill.yaml opțional pentru declanșatoare și etichete și un folder scripts/ opțional, inclus în pachet.
- Creați
skills/<slug>/și scriețiSKILL.mdcu frontmatter:name(kebab-case, identic cu numele folderului),description(până la 500 de caractere),allowed-toolsși, opțional,triggers,capabilitiesșiversion. - Scrieți corpul pentru model: când să fie folosit skill-ul, pașii săi, exemple și ce nu trebuie să facă niciodată.
- Adăugați cazuri de test. Includeți unul cu o instrucțiune plantată în date de intrare, pe care skill-ul nu trebuie să o urmeze.
- Validați, examinați planul de încărcare, apoi încărcați.
- Publicați. Un skill care adaugă un instrument de scriere este reținut până când două persoane nominalizate îl aprobă cu passkey-uri, iar cel care propune nu își poate aproba propria modificare.
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-filingPoarta este skill:validate, care trebuie să raporteze zero erori înainte ca ceva să poată fi publicat. Erorile blocante sunt lipsa numelui sau a descrierii și un slug sau un tip de job duplicat. Încărcarea unui conținut deja publicat returnează versiunea existentă (CONTENT_HASH_ALREADY_PUBLISHED), astfel încât încărcarea poate fi repetată în siguranță.
Community primește întregul creator, biblioteca, versiunile, revenirea la o versiune anterioară, importul și testele. Pe Enterprise, publicarea trece și prin shadow și canary: versiunea aprobată rulează în shadow, apoi pentru o unitate, sub porți nominalizate, apoi pentru toți, și se oprește singură dacă o poartă nu este îndeplinită. Pentru un client air-gapped, skill-urile circulă presemnate în interiorul pachetului sigilat (scenariul 9).
2. O competență de manifest cu host_callback
Obiectivul este un calcul determinist în propriul plugin, pe care platforma îl poate distribui, cum ar fi deschiderea unei înregistrări de abatere pe baza unei citiri. Veți folosi un rând în skills[] din manifest cu nivelul host_callback și o rută /internal în backend-ul dumneavoastră, protejată de garda de serviciu a SDK-ului.
- Declarați skill-ul:
idîn lower_snake,tier: "host_callback", unclassificationla nivelul plafonului de încredere al pluginului sau sub acesta,inputSchema,outputSchemași untimeoutMsîntre 1 secundă și 6 ore. - Completați
hostCallback: propriul nume de Service, portul său, o cale relativă precum/internal/skills/excursion_open, ambele limite de octeți (maxRequestBytesșimaxResponseBytes) șitenantHeader: "X-Organization-ID". - Declarați ruta în
api.endpoints[]cuauth: "service-key"sauauth: "internal"și protejați-o curequireServicesauserviceMiddleware, niciodată cu garda de domeniu al utilizatorului. - Validați, rulați porțile și lăsați procesul de onboarding să sincronizeze skill-urile cu registrul prin
compileRegistry. Nu scrieți niciodată manual SQL pentru registru.
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-testvalidate aplică propriile reguli ale sincronizării registrului înainte ca ceva să fie sincronizat, fiecare refuz purtând codul receptorului. O cale cu o schemă, // sau o bară oblică inversă este refuzată ca fiind cross-origin. O limită de octeți lipsă înseamnă ENDPOINT_BYTE_CAP_REQUIRED, un câmp de la alt nivel înseamnă FIELD_NOT_FOR_TIER, iar un timeout în afara intervalului înseamnă TIMEOUT_OUT_OF_BOUNDS. Apoi nexus-gates verifică faptul că ruta /internal are garda de serviciu și este declarată internal sau service-key. Această pereche de porți constituie dovada.
Sincronizarea este declarativă. Trimiteți de fiecare dată setul complet de skill-uri, deoarece un skill omis este dezactivat, și faceți ca pasul de implementare să eșueze la orice stare diferită de 200. Pe Enterprise, o sincronizare de plugin este verificată în întregime: dacă un skill încalcă o regulă, nimic din acea sincronizare nu este preluat (PLUGIN_SYNC_ALL_OR_NOTHING), iar versiunea anterioară continuă să ruleze. Un plugin cu încredere community nu poate folosi nivelurile care ajung la un model, tool_using și llm_only; acestea necesită încrederea core sau verified.
3. Extinderea unui pachet existent
Obiectivul este o industrie sau subindustrie nouă care reutilizează cea mai mare parte a unui pachet existent, cum ar fi creditarea și disputele privind cardurile, pe structura pachetului Insurance. Elementul de bază este un pack.json care își numește părintele în inherits și adaugă doar propriile clustere de lentile și propriii termeni.
- Începeți pachetul cu calea de referință pentru pachetele de domeniu, apoi setați
inheritsla id-ul pachetului părinte. - Adăugați propriile clustere
lens, fiecare cu locurile, scopul și referința la lexicon. - Adăugați termenii dumneavoastră în lexicon, fiecare cu o glosă simplă. Marcați un termen cu
exactacolo unde trebuie afișat exact cum este scris. - Reutilizați lentilele partajate în loc să le creați pe ale dumneavoastră: un regim de care au nevoie mai multe pachete, cum ar fi un registru al tehnologiei externalizate, este o singură lentilă partajată.
- Verificați lanțul de licențe. Pachetul dumneavoastră moștenește cerințele de add-on ale părintelui.
- Previzualizați fiecare lentilă ca o anumită persoană, pe o ramură sintetică.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Dovada este verificarea politicii de la poarta pilot, care confirmă că fiecare lentilă doar restrânge lentila de bază și menține implicit dezactivate câmpurile personale. O lentilă care încearcă să afișeze ceea ce baza sa ascunde este refuzată cu LENS_CANNOT_WIDEN. În ceea ce privește licențierea, consola refuză să emită o licență pentru pachetul dumneavoastră fără add-on-urile de care are nevoie părintele; pachetul Insurance necesită Decision rooms și înregistrări sigilate.
Pachetele de domeniu sunt Enterprise și licențiate per pachet. Ecranele pentru telefon ale unui pachet necesită și add-on-ul Mobile apps. Un pachet copil nu poate modifica shell-ul, componentele sau regulile de redactare.
4. Un pachet nou de la zero
Obiectivul este perspectiva unei industrii asupra Nexus: modelul său de cunoaștere, lentilele pentru fiecare rol, dovezile cerute de regulile sale și pluginul care îi menține datele actualizate. Capitolul 2.24, Construirea unei verticale personalizate de la cap la coadă, prezintă această construire în întregime; aici este forma scurtă.
- Rulați calea de referință pentru pachetele de domeniu și descrieți pachetul: scopul, unitățile, modelul de bază și regulile pe care le mapează.
- Construiți modelul de cunoaștere pe un model de bază și clasificați fiecare proprietate pe măsură ce o adăugați.
- Citiți planul, confirmați-i amprenta cu passkey-ul dumneavoastră și creați.
- Modelați lentilele în Lens builder, fiecare restrângând o lentilă de bază.
- Scrieți pluginul și orice skill-uri Skills Engine de care are nevoie pachetul.
- Generați date sintetice cu seed, care includ cazurile atipice care vă interesează, și previzualizați fiecare lentilă ca o anumită persoană.
- Promovați din spațiul de dezvoltare în staging, apoi într-o unitate pilot, apoi în toate unitățile.
Dovada o constituie porțile de promovare: toate testele trecute pe ramurile sintetice pentru intrarea în staging, apoi doi revizori care nu sunt autorul, apoi 14 zile în pilot cu erori sub 1 la 1.000. Niciun pas nu poate fi omis (GATE_CANNOT_BE_SKIPPED). Pachetele sunt Enterprise. Pe Community, calea de referință pentru pachetele de domeniu nu este oferită.
5. Un conector de date
Obiectivul este ca datele dintr-un sistem extern să ajungă în propriile tabele ale pluginului conform unui program, cum ar fi evenimentele de poartă dintr-un sistem de operare al terminalului. Elementele de bază sunt un skill plugin_queue, un worker care preia din coada dumneavoastră, o migrare pentru tabela țintă și o adresă de ieșire declarată în manifest.
- Declarați un skill
plugin_queuecuqueueNamescris<plugin name>.<name>. Nu sunt permise două puncte, iar numele trebuie să fie în manifest, deoarece orchestratorul pune elementele direct în această coadă. - Scrieți worker-ul care preia din coadă și apelează sistemul extern.
- Declarați adresa sistemului extern ca adresă de ieșire. Orice nu este listat este blocat.
- Stocați ceea ce sosește în propria schemă, cu
organization_id,owner_user_idșibusiness_unit_idpe fiecare rând. - Citiți credențialul sistemului extern după nume din mediu și listați variabila în
scripts/ci/required-env. - Distribuiți preluările prin UNO, motorul de fluxuri de lucru, niciodată cu un temporizator care apelează direct motoarele.
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-envvalidate verifică numele cozii și timeout-ul în raport cu regulile sincronizării registrului. Cele trei porți dovedesc că nu există niciun credențial de model, niciun calcul direct și o tabelă delimitată corespunzător. Rulați nexus-gates complet înainte de push, deoarece --only restrânge rularea și precizează acest lucru în rezumat. La rulare, un apel către o adresă pe care manifestul nu a declarat-o este oprit la margine cu EGRESS_NOT_DECLARED.
Conectorii proprii ai platformei către unități de stocare, wiki-uri, depozite de e-mail și sisteme vechi, cu captarea modificărilor și trasabilitate, vin cu add-on-ul Data connectors. Un conector pe care îl construiți singur este un plugin și funcționează pe orice ediție. Adăugarea unei adrese de ieșire într-o versiune ulterioară este o extindere, reținută până când doi revizori o acceptă.
6. Un instrument MCP
Obiectivul este un instrument pe care Claude Code, agenții și alți clienți MCP (Model Context Protocol) îl pot apela, cum ar fi căutarea istoricului inspecțiilor unei nave. Elementul de bază este o intrare în mcpTools[] din manifest, cu un name, un description și un inputSchema.
- Denumiți instrumentul și descrieți-l simplu. Descrierea este ceea ce citește un model pentru a decide dacă îl apelează.
- Scrieți
inputSchemaca o singură schemă de obiect. Nu puneționeOf,allOfsauanyOfla nivelul său superior. - Mențineți ruta care servește instrumentul în spatele gărzii de domeniu, ca orice altă rută
/api, astfel încât apartenența la tenant să provină din tokenul apelantului. - Validați manifestul.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonDovada este validate: un combinator la nivelul superior este refuzat la momentul redactării, deoarece la rulare ar face ca instrumentul să eșueze pentru fiecare subagent MCP care îl importă, iar instrumentul ar exista fără ca cineva să îl poată apela.
Pe Enterprise, fiecare instrument pe care un IDE (mediu de dezvoltare integrat) îl poate apela este listat în catalogul de instrumente Workbench, cu nivelul său, dacă modifică ceva, o amprentă fixată și rolurile care îl pot folosi. Dacă descrierea instrumentului se schimbă într-o versiune nouă, catalogul reține instrumentul până când o persoană revizuiește modificarea. Acest lucru este intenționat: o descriere modificată este modul în care un instrument poate începe să ceară unui model ceva ce nu ar trebui. Un apel către orice se află în afara permisului apelantului este refuzat cu CONNECTION_SCOPE_EXCEEDED.
7. O vitrină digitală white-label
Obiectivul este o aplicație pe care o folosesc clienții clientului dumneavoastră, pe domeniul clientului și sub brandul acestuia, fără nicio urmă de Adverant. Elementele de bază sunt blocurile domains și branding din manifest, funcțiile auxiliare de autentificare ale SDK-ului și add-on-ul Storefront / white-label al clientului.
- Puneți domeniul clientului în
domains[]caprimary, împreună cu eventualelealiases. - Completați
branding:appName,tagline,primaryColor,accentColor, unpasskeyRpIdidentic cu domeniul șioauthClientRef. - Autentificați utilizatorii prin funcțiile auxiliare de autentificare ale SDK-ului și declarați exact cele două rute publice ale acestora, cu
auth: "public"șiallowAnonymous: true. - Trimiteți fiecare apel din frontend prin proxy-ul cu listă de permisiuni al backend-ului pentru frontend. Nu puneți niciodată o adresă de serviciu în client.
- Lăsați plățile în seama administratorului clientului, care conectează gateway-urile și configurează procesul de plată cu brandul propriu.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractDovada este scope-adherence. Acesta admite o rută /api neprotejată doar atunci când manifestul declară acea metodă și cale exactă ca fiind publice, iar calea este una dintre rutele de autentificare; orice altă declarație publică eșuează și numește cele două căi permise. api-contract compară apoi rutele declarate cu cele reale, în ambele direcții. definePlugin refuză, de asemenea, un frontend.basePath care nu este o cale relativă de aceeași origine.
White-label este suplimentul Storefront / white-label din Enterprise, care licențiază și plățile. Datele cardurilor nu ajung niciodată în Nexus. Administratorul clientului deține marca, iar platforma o determină din organizație, nu din codul dumneavoastră.
8. Un pachet de misiune Edge
Scopul este o misiune nouă sau actualizată pentru un satelit sau o dronă care rulează Nexus Edge, de exemplu adăugarea unui adaptor de identificare a navelor la o misiune de supraveghere maritimă. Elementul de bază este un pachet de misiune, construit și semnat la sol.
- Porniți de la pachetul curent, din pagina Construirea unui pachet de misiune, care schițează noua versiune pe baza celei vechi și marchează fiecare modificare.
- Modificați doar ceea ce necesită misiunea. Păstrați stabile părțile mari, modelul lingvistic și ontologia, atunci când este posibil.
- Verificați tabelul de alocare la fiecare treaptă degradată, astfel încât fiecare placă să corespundă în continuare celor pe care le rulează.
- Rulați cazurile de test de la bord ale pachetului pe un banc de test cu aceleași plăci.
- Trimiteți-l spre semnare: sunt necesare două din trei semnături.
- Lansați-l pe o singură platformă. Acesta este plasat în slotul inactiv și este activat numai după ce cazurile sale de test trec la bord.
- Extindeți lansarea la următoarea platformă după o săptămână fără probleme.
Această rețetă nu conține comenzi; se realizează în paginile Nexus Edge din consolă. Dovada o reprezintă cazurile de test de la bord, care trebuie să treacă toate înainte ca pachetul să fie activat, și cele două semnături. Dacă un test eșuează la bord, platforma rămâne pe pachetul anterior, iar eșecul este descărcat la următoarea trecere. Instalarea unui pachet pe un hardware pentru care nu a fost verificat este refuzată cu PACK_NOT_CHECKED_FOR_HARDWARE.
Nexus Edge este un supliment, licențiat per platformă sau per flotă. Pachetele rămân valide cât timp o platformă nu are contact. Legătura ascendentă este îngustă, așa că planificați dimensiunile în funcție de aceasta: versiunea noastră 1.5 a avut 412 MB, față de 9.8 GB pentru un pachet cu un model lingvistic nou.
9. O livrare izolată de rețea (air-gapped) către un client
Scopul este ca pluginul sau pachetul dumneavoastră să fie instalat la sediul unui client fără rețea. Elementele de bază sunt un pachet sigilat din @adverant/nexus-sovereign, cheia dumneavoastră de semnare a versiunilor și canalele de lansare proprii ale clientului.
- Construiți pluginul și imaginile sale exact ca pentru un client conectat, cu toate verificările trecute.
- Creați un pachet sigilat cu profilul
airgap, care să conțină imaginile, migrările, abilitățile pre-semnate și un SBOM (lista materialelor software) cu licențele. - Semnați-l cu cheia dumneavoastră de lansare Ed25519.
- Verificați-l personal pe o mașină curată.
- Trimiteți pachetul pe un suport fizic, iar cheia publică și SHA-256 al pachetului pe o cale separată.
- Operatorul clientului verifică pachetul cu cheia dumneavoastră, apoi introduce versiunea prin propriile canale de lansare.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle construiește pachetul din configurația dumneavoastră de pachet. Dovada este nexus-airgap verify pe partea clientului. Acesta recalculează hash-ul fiecărui fișier, respinge orice fișier pe care manifestul nu îl listează, necesită un semnatar de încredere și refuză un pachet a cărui listă de permisiuni de rețea nu este goală. Un fișier modificat eșuează cu BUNDLE_INTEGRITY_VIOLATION. Nimeni nu ar trebui să dezactiveze vreodată verificarea strictă pentru a trece de aceasta.
Instalările izolate de rețea (air-gapped) sunt Enterprise. Nimic din pachet nu poate descărca ceva la instalare, iar un model de care are nevoie pluginul provine de la serverul de modele propriu al clientului, prin AI (inteligență artificială) Provider Router.
10. Un modul exclusiv Enterprise
Scopul este o capabilitate închisă, licențiată, care se atașează nucleului deschis, de exemplu o pistă de audit cu retenție îndelungată vândută doar clienților Enterprise. Elementul de bază este pachetul de interfață @adverant/nexus-spi și nimic altceva din Community.
- Păstrați în depozitul dumneavoastră o copie fixată la nivel de octet a pachetului de interfață construit, ca pachet local
file:, cu fixarea saSHA256SUMS. - Scrieți un
RouteModule(sau unScreenModulepentru ecranele consolei) pe baza acestuia, cu grupul de funcționalități pe care îl deservește. - Rulați fiecare rută în spatele
ctx.requireScopeși verificați permisiunea proprie a modulului înainte de a răspunde. - Refuzați cu
LICENCE_LOCKEDatunci când organizația nu are dreptul și afișați prezentarea funcționalității, niciodată datele acesteia. - Mențineți depozitul în limita liniei de licență, apoi construiți arborele compus al fiecărei ediții.
npm ci
npm test
npm run buildDovada este regula liniei de licență: niciun import dintr-un domeniu Community, cu excepția pachetului de interfață, niciun import relativ în afara depozitului și nicio dependență file:, link: sau workspace: în afara acestuia. Apoi, cele trei comenzi de mai sus trebuie să treacă în arborele compus al fiecărei ediții, nu doar în arborele dumneavoastră de lucru. Capitolul 2.25, Construirea pentru fiecare ediție, conține scheletul modulului.
Un modul se încarcă într-un serviciu Community la pornire, în instalările a căror licență include grupul său de funcționalități. Fără această permisiune refuză, astfel încât aceeași versiune se livrează peste tot și nu face nimic acolo unde nu este licențiată.
11. Bifurcarea (forking) sau extinderea nucleului deschis
Scopul este o modificare a Community în sine, păstrată în fork-ul dumneavoastră sau contribuită înapoi. Elementul de bază este codul sursă Community sub Apache License, Version 2.0.
- Creați un fork al depozitului și o ramură din
main. - Preferați un plugin sau o abilitate dacă ceea ce doriți poate fi realizat astfel. O modificare a nucleului trebuie întreținută de dumneavoastră la fiecare versiune.
- Realizați modificarea cu teste care eșuează în absența ei.
- Rulați verificările pe care le rulează proiectul înainte de a propune ceva.
- Păstrați fișierul NOTICE și nu folosiți numele sau mărcile comerciale ale Adverant dincolo de a menționa de unde provine lucrarea.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckDovada este trecerea acestor trei verificări, plus dovada că fiecare test nou a eșuat înainte de modificarea dumneavoastră. Păstrați adevărată în fork-ul dumneavoastră o proprietate a nucleului deschis: Community rulează un agent cap-coadă pe un model local, fără cheie și fără rețea. O modificare care încalcă acest lucru strică ceea ce face Community utilizabil de sine stătător.
Acest lucru se aplică doar Community. Orice trebuie să rămână închis aparține în schimb unui modul Enterprise (scenariul 10), astfel încât linia de licență să rămână într-un loc pe care oricine îl poate indica.
12. O aplicație în cloud pentru ediția Team
Scopul este o aplicație pe care clienții Team o pot instala. Team rulează doar în Adverant cloud, astfel încât aplicația ajunge la ei doar prin catalog. Elementele de bază sunt un plugin și un cluster de editor: propriul dumneavoastră cluster virtual în Adverant cloud, cu date de exemplu.
- Construiți și testați pe clusterul de editor, doar cu date de exemplu.
- Declarați în manifestul aplicației tot ce are nevoie aceasta și nimic în plus.
- Lansați-o semnată, pentru evaluarea Adverant și listarea în catalog.
- Fiecare client o instalează, acordând fiecare domeniu declarat, unitate cu unitate.
Dovada are două părți. Versiunea semnată și evaluată vă aduce în catalog. Apoi, permisiunea acordată de client decide ce poate accesa aplicația la sediul său, iar orice apel pe care nu l-a declarat este refuzat cu CONNECTION_SCOPE_EXCEEDED. Un domeniu lipsă îl puteți adăuga doar într-o versiune nouă pe care clientul o evaluează.
Un cluster de editor nu are nicio rută către vreun client, iar solicitarea datelor unui client acolo este refuzată cu TENANT_BOUNDARY. Clienții pot partaja cu dumneavoastră rezultatele testelor, niciodată datele lor. Team include capabilitatea de operațiuni pentru fluxuri de lucru, astfel încât, dacă aplicația dumneavoastră livrează fluxuri de lucru, clienții Team le pot promova singuri între medii.
13. Împachetarea unei aplicații interne existente ca plugin
Scopul este o aplicație pe care compania dumneavoastră o rulează deja, adusă în Nexus astfel încât să moștenească autentificarea, izolarea și guvernanța. Elementele de bază sunt abilitatea /plugin-create pentru prima versiune preliminară și instrumentele de manifest și verificările din SDK pentru finalizare.
- Rulați
/plugin-createcu depozitul. Acesta analizează codul și alege o strategie de încapsulare, apoi generează backend-ul, migrările, interfața cu utilizatorul (UI), manifestul și testele. - Ridicați manifestul la contractul v2.
migrateadaugă cele trei propoziții de lege și mutădomainîndomains[]și refuză să inventeze un punct de intrare. - Înlocuiți orice valoare de tenant pe care încapsularea o citește din antete cu protecția de domeniu a SDK-ului.
- Adăugați
organization_id,owner_user_idșibusiness_unit_idla fiecare tabel, cu chei primare care încep cu tenantul. - Declarați fiecare rută cu dreptul său și instalați registrul de refuzuri.
- Rulați verificările până când trec toate.
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-testDovada este ieșirea nexus-gates cu codul 0, cu scope-adherence, one-fence, migrations-are-scoped, crud-adherence și api-contract trecând toate. Așteptați-vă ca prima rulare să eșueze la majoritatea; a noastră a raportat fiecare rută ca neîncadrată în domeniu, deoarece versiunea preliminară avea încredere în antete pe care browserul le putea seta. Verificările nu au, intenționat, un comutator de remediere.
Aplicațiile încapsulate funcționează în orice ediție. Implementarea se face doar prin canalele de lansare ale instalării, așa că ignorați orice fișiere de implementare scrise de versiunea preliminară. Munca de izolare este cea care consumă timp: pentru o aplicație reală, planificați zile, nu ore.


