Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.27
Scenariji izrade
Priručnik s trinaest izrada, od pojedinačne vještine do izolirane isporuke (air-gapped). Svaki recept donosi cilj, gradivne blokove, korake i naredbe, kontrolnu točku koja dokazuje uspješnost te ono što se mijenja ovisno o izdanju i obliku isporuke.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Ovo su recepti kojima se služim kada netko u Corrán Orbital ili kod korisnika kaže „želimo da Nexus radi X”. Svaki je namjerno kratak. Obrazloženje koraka nalazi se u poglavljima prije ovoga: poglavlje 2.20, Vještine, i poglavlje 2.21, Plugin SDK, koje obrađuje komplet za razvoj softvera, zatim poglavlje 2.23, Domenski paketi, te tri poglavlja nakon njega o izgradnji. Ovdje dobivate cilj, građevne blokove koje treba upotrijebiti, korake, naredbe, provjeru koja potvrđuje da je uspjelo te napomene o izdanju i isporuci.
Provjera je najvažnija. Recept je dovršen kada je njegova provjera zelena. Svaka provjera u ovom poglavlju nešto je što možete pokrenuti ili što platforma pokreće umjesto vas, i svaka završava kodom različitim od nule ili odbija s kodom kada uvjet nije ispunjen.
| Scenarij | Glavni građevni blok | Provjera koja to dokazuje | Izdanje |
|---|---|---|---|
| Nova vještina za Skills Engine | Paket SKILL.md |
skill:validate bez pogrešaka |
Community i Enterprise |
Vještina u manifestu s host_callback |
Manifest dodatka skills[] |
create-nexus-plugin validate i nexus-gates |
Community i Enterprise |
| Proširenje postojećeg paketa | pack.json s inherits |
Provjera pravila leća na pilotnoj provjeri | Enterprise i licenca za paket |
| Novi paket od nule | Zlatni put za domenski paket | Provjere za staging i pilot | Enterprise |
| Podatkovni konektor | Vještina plugin_queue |
validate, nexus-gates, odbijanje izlaznog prometa |
Community i Enterprise |
| Alat MCP (Model Context Protocol) | Manifest mcpTools[] |
validate (bez kombinatora na najvišoj razini) |
Community i Enterprise |
| Trgovina pod tuđom robnom markom (white-label) | Manifest domains i branding |
Javno pravilo scope-adherence |
Enterprise i dodatak Storefront |
| Paket misije za Edge | Paket misije | Testni slučajevi na uređaju, dva od tri potpisa | Enterprise i dodatak Nexus Edge |
| Isporuka u izoliranu okolinu (air-gapped) | Zapečaćeni paket | nexus-airgap verify |
Enterprise |
| Modul samo za Enterprise | @adverant/nexus-spi |
Provjera licencne granice, izgradnje po izdanjima | Enterprise |
| Forkanje ili proširenje otvorene jezgre | Izvorni kôd izdanja Community | Testovi, lint i provjera tipova | Community |
| Aplikacija u oblaku za izdanje Team | Klaster izdavača | Potpisano izdanje, pregled, dodjela korisniku | Team |
| Omatanje postojeće interne aplikacije | /plugin-create |
migrate, validate, nexus-gates |
Community i Enterprise |
1. Nova vještina sustava Skills Engine
Cilj je višekratno upotrebljiva uputa koju mogu pokretati asistent, agenti, tijekovi rada i razvojni alati, primjerice provjera carinske prijave prema njezinim pravilima. Vaši građevni blokovi su paket SKILL.md u mapi nazvanoj po vještini, neobavezni skill.yaml za okidače i oznake te neobavezna mapa scripts/ priložena uz njega.
- Izradite
skills/<slug>/i napišiteSKILL.mds frontmatterom:name(kebab-case, jednako nazivu mape),description(do 500 znakova),allowed-toolste neobaveznotriggers,capabilitiesiversion. - Napišite tijelo za model: kada upotrijebiti vještinu, njezine korake, primjere i ono što nikada ne smije činiti.
- Dodajte testne slučajeve. Uključite jedan s uputom podmetnutom u ulaz koju vještina ne smije slijediti.
- Provedite validaciju, pregledajte plan prijenosa, a zatim prenesite.
- Objavite. Vještina koja dodaje alat za pisanje zadržava se dok je dvije imenovane osobe ne odobre pristupnim ključevima, a predlagatelj ne može odobriti vlastitu promjenu.
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-filingProvjera je skill:validate, koja mora prijaviti nula pogrešaka prije nego što se išta može objaviti. Blokirajuće pogreške su nedostajući naziv ili opis te dvostruki slug ili vrsta posla. Prijenos sadržaja koji je već objavljen vraća postojeću verziju (CONTENT_HASH_ALREADY_PUBLISHED), pa je prijenos sigurno ponoviti.
Community dobiva cijeli alat za izradu, biblioteku, verzije, vraćanje na prethodnu verziju, uvoz i testove. Na izdanju Enterprise objava prolazi i kroz shadow i canary: odobrena verzija radi u sjeni, zatim za jednu jedinicu iza imenovanih provjera, zatim za sve, a sama se zaustavlja ako provjera nije zadovoljena. Za korisnika u izoliranoj okolini vještine putuju unaprijed potpisane unutar zapečaćenog paketa (scenarij 9).
2. Vještina manifesta sa svojstvom host_callback
Cilj je deterministička obrada u vašem vlastitom dodatku koju platforma može pokrenuti, primjerice otvaranje zapisa o odstupanju na temelju očitanja. Upotrijebit ćete redak u manifestu skills[] s razinom host_callback i rutu /internal u svojem backendu zaštićenu servisnim čuvarom SDK-a.
- Deklarirajte vještinu:
idu lower_snake,tier: "host_callback",classificationjednak ili ispod gornje granice povjerenja vašeg dodatka,inputSchema,outputSchemaitimeoutMsizmeđu 1 sekunde i 6 sati. - Ispunite
hostCallback: naziv vlastitog servisa, njegov port, relativnu putanju poput/internal/skills/excursion_open, obje granice bajtova (maxRequestBytesimaxResponseBytes) tetenantHeader: "X-Organization-ID". - Deklarirajte rutu u
api.endpoints[]sauth: "service-key"iliauth: "internal"i zaštitite je srequireServiceiliserviceMiddleware, nikada korisničkim čuvarom opsega. - Provedite validaciju, pokrenite provjere i prepustite uvođenju da sinkronizira vještine s registrom putem
compileRegistry. SQL za registar nikada ne pišete ručno.
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 primjenjuje vlastita pravila sinkronizacije registra prije nego što se išta sinkronizira, a svako odbijanje nosi kod primatelja. Putanja sa shemom, // ili obrnutom kosom crtom odbija se kao cross-origin. Nedostajuća granica bajtova je ENDPOINT_BYTE_CAP_REQUIRED, polje iz druge razine je FIELD_NOT_FOR_TIER, a vremensko ograničenje izvan raspona je TIMEOUT_OUT_OF_BOUNDS. Zatim nexus-gates provjerava ima li ruta /internal servisnog čuvara i je li deklarirana kao internal ili service-key. Taj par provjera je dokaz.
Sinkronizacija je deklarativna. Svaki put pošaljite cijeli skup vještina, jer se vještina koju izostavite onemogućuje, i neka korak implementacije ne uspije za svaki status osim 200. Na izdanju Enterprise sinkronizacija dodatka provjerava se u cijelosti: ako jedna vještina prekrši pravilo, ništa iz te sinkronizacije nije prihvaćeno (PLUGIN_SYNC_ALL_OR_NOTHING), a prethodna verzija nastavlja raditi. Dodatak s povjerenjem community ne može upotrebljavati razine koje dosežu model, tool_using i llm_only; za njih je potrebno povjerenje core ili verified.
3. Proširivanje postojećeg paketa
Cilj je nova industrija ili podindustrija koja ponovno upotrebljava većinu postojećeg paketa, primjerice krediti i sporovi oko kartica na temelju strukture paketa Insurance. Građevni blok je pack.json koji imenuje roditelja u inherits i dodaje samo vlastite skupine leća i riječi.
- Započnite paket zlatnim putem za domenski paket, a zatim postavite
inheritsna id roditeljskog paketa. - Dodajte vlastite skupine
lens, svaku s mjestima, svrhom i referencom na leksikon. - Dodajte svoje riječi u leksikon, svaku s jednostavnim objašnjenjem. Označite pojam s
exactondje gdje se mora prikazati kako je napisan. - Ponovno upotrijebite zajedničke leće umjesto da crtate vlastite: režim koji treba više paketa, primjerice registar izdvojene tehnologije, jedna je zajednička leća.
- Provjerite licencni lanac. Vaš paket nasljeđuje zahtjeve za dodatke svojeg roditelja.
- Pregledajte svaku leću kao osoba na sintetičkoj grani.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Dokaz je provjera pravila na pilotnoj provjeri, koja potvrđuje da svaka leća samo sužava svoju osnovu i da su osobna polja prema zadanim postavkama isključena. Leća koja pokušava prikazati ono što njezina osnova skriva odbija se s LENS_CANNOT_WIDEN. Što se tiče licenciranja, konzola odbija izdati licencu za vaš paket bez dodataka koje treba njegov roditelj; paket Insurance treba Decision rooms i zapečaćene zapise.
Domenski paketi pripadaju izdanju Enterprise i licenciraju se po paketu. Zasloni paketa za telefon također trebaju dodatak Mobile apps. Podređeni paket ne može mijenjati ljusku, komponente ni pravila pisanja.
4. Novi paket od nule
Cilj je pogled jedne industrije na Nexus: njezin model znanja, leće za svaku ulogu, dokazi koje traže njezina pravila i dodatak koji održava njezine podatke ažurnima. Poglavlje 2.24, Izgradnja prilagođene vertikale od početka do kraja, u cijelosti prolazi kroz ovu izgradnju; ovdje je kratka verzija.
- Pokrenite zlatni put za domenski paket i opišite paket: svrhu, jedinice, osnovni model i pravila koja preslikava.
- Izgradite model znanja na osnovnom modelu i klasificirajte svako svojstvo dok ga dodajete.
- Pročitajte plan, potvrdite njegov otisak pristupnim ključem i izradite.
- Oblikujte leće u alatu Lens builder, pri čemu svaka sužava osnovnu leću.
- Napišite dodatak i sve vještine za Skills Engine koje paket treba.
- Generirajte sintetičke podatke s početnom vrijednošću (seed), uključujući neobične slučajeve do kojih vam je stalo, i pregledajte svaku leću kao osoba.
- Promovirajte iz razvojnog prostora u staging, zatim u pilotnu jedinicu, pa u sve jedinice.
Dokaz su provjere promocije: svi testovi prolaze na sintetičkim granama prije stagingа, zatim dva recenzenta koji nisu autori, zatim 14 dana u pilotu s pogreškama ispod 1 na 1.000. Nijedan korak ne može se preskočiti (GATE_CANNOT_BE_SKIPPED). Paketi pripadaju izdanju Enterprise. Na izdanju Community zlatni put za domenski paket nije ponuđen.
5. Podatkovni konektor
Cilj su podaci iz vanjskog sustava koji prema rasporedu pristižu u vlastite tablice vašeg dodatka, primjerice događaji na ulazu iz operativnog sustava terminala. Građevni blokovi su vještina plugin_queue, radni proces koji preuzima iz vašeg reda, migracija za ciljnu tablicu i izlazna adresa deklarirana u manifestu.
- Deklarirajte vještinu
plugin_queuesqueueNamenapisanim kao<plugin name>.<name>. Dvotočka nije dopuštena, a naziv mora biti u manifestu jer ga orkestrator izravno stavlja u red. - Napišite radni proces koji preuzima iz reda i poziva vanjski sustav.
- Deklarirajte adresu vanjskog sustava kao izlaznu adresu. Sve što nije navedeno blokira se.
- Pohranite ono što stigne u vlastitu shemu, s
organization_id,owner_user_idibusiness_unit_idu svakom retku. - Vjerodajnicu vanjskog sustava pročitajte po nazivu iz okruženja i navedite varijablu u
scripts/ci/required-env. - Preuzimanja pokrećite putem sustava UNO, mehanizma tijekova rada, nikada mjeračem vremena koji izravno poziva mehanizme.
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 provjerava naziv reda i vremensko ograničenje prema pravilima sinkronizacije registra. Tri provjere dokazuju da nema vjerodajnice za model, nema izravne obrade i da je tablica ispravno ograničena opsegom. Pokrenite cijeli nexus-gates prije slanja (push), jer --only sužava pokretanje i to navodi u svojem sažetku. Tijekom izvođenja poziv na adresu koju manifest nije deklarirao zaustavlja se na rubu s EGRESS_NOT_DECLARED.
Vlastiti konektori platforme za diskove, wikije, spremišta pošte i naslijeđene sustave, s bilježenjem promjena i porijeklom podataka, dolaze s dodatkom Data connectors. Konektor koji sami izgradite je dodatak i radi na svakom izdanju. Dodavanje izlazne adrese u kasnijem izdanju je proširenje koje se zadržava dok ga dva recenzenta ne prihvate.
6. MCP alat
Cilj je alat koji Claude Code, agenti i drugi klijenti MCP (Model Context Protocol) mogu pozvati, primjerice pretraživanje povijesti inspekcija plovila. Građevni blok je unos u manifestu mcpTools[], s name, description i inputSchema.
- Imenujte alat i jasno ga opišite. Opis je ono što model čita kako bi odlučio hoće li ga pozvati.
- Napišite
inputSchemakao jednu shemu objekta. Ne stavljajteoneOf,allOfnianyOfna njezinu najvišu razinu. - Rutu koja poslužuje alat držite iza čuvara opsega, kao i svaku drugu rutu
/api, tako da zakupništvo proizlazi iz tokena pozivatelja. - Provedite validaciju manifesta.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonDokaz je validate: kombinator na najvišoj razini odbija se već pri izradi, jer bi tijekom izvođenja alat zakazao za svakog MCP podagenta koji ga uvozi, pa bi alat postojao, a nitko ga ne bi mogao pozvati.
Na izdanju Enterprise svaki alat koji IDE (integrirano razvojno okruženje) može pozvati naveden je u katalogu alata Workbench s razinom, podatkom mijenja li nešto, prikvačenim otiskom i ulogama koje ga smiju upotrebljavati. Ako se opis vašeg alata promijeni u novom izdanju, katalog zadržava alat dok osoba ne pregleda promjenu. To je namjerno: promijenjeni opis način je na koji alat može početi tražiti od modela nešto što ne bi smio. Poziv bilo čega izvan propusnice pozivatelja odbija se s CONNECTION_SCOPE_EXCEEDED.
7. White-label izlog
Cilj je aplikacija kojom se služe korisnici vašeg korisnika, na korisnikovoj domeni i pod njegovom robnom markom, bez ikakva traga Adverant. Građevni blokovi su blokovi manifesta domains i branding, pomoćne funkcije za prijavu iz SDK-a i korisnikov dodatak Storefront / white-label.
- Stavite korisnikovu domenu u
domains[]kaoprimary, uz eventualnealiases. - Ispunite
branding:appName,tagline,primaryColor,accentColor,passkeyRpIdjednak domeni teoauthClientRef. - Prijavljujte osobe putem pomoćnih funkcija za prijavu iz SDK-a i točno deklarirajte njihove dvije javne rute, s
auth: "public"iallowAnonymous: true. - Svaki poziv frontenda šaljite kroz proxy s popisom dopuštenih adresa backenda za frontend. Nikada ne stavljajte adresu servisa u klijent.
- Plaćanja prepustite korisnikovu administratoru, koji povezuje pristupnike za plaćanje i postavlja brendiranu naplatu.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractDokaz je scope-adherence. Ona dopušta nezaštićenu rutu /api samo kada manifest deklarira upravo tu metodu i putanju kao javne i kada je putanja jedna od ruta za prijavu; svaka druga javna deklaracija ne prolazi i navodi dvije dopuštene putanje. api-contract zatim uspoređuje deklarirane rute sa stvarnima u oba smjera. definePlugin također odbija frontend.basePath koji nije relativna putanja istog podrijetla.
White-label je dodatak Storefront / white-label u izdanju Enterprise, koji licencira i plaćanja. Podaci o karticama nikada ne dolaze do Nexusa. Robnu marku posjeduje administrator korisnika, a platforma je razrješava iz organizacije, a ne iz vašeg koda.
8. Edge misijski paket
Cilj je nova ili ažurirana misija za satelit ili dron koji pokreće Nexus Edge, primjerice dodavanje adaptera za pronalaženje brodova u misiju pomorskog nadzora. Gradivni element je paket misije, izgrađen i potpisan na zemlji.
- Krenite od trenutačnog paketa na stranici Izrada paketa misije, koja izrađuje nacrt nove verzije iz stare i označava svaku promjenu.
- Mijenjajte samo ono što misija zahtijeva. Velike dijelove, jezični model i ontologiju, zadržite nepromijenjenima kad god možete.
- Provjerite tablicu raspoređivanja na svakom koraku degradacije, kako bi svaka ploča i dalje odgovarala onome što pokreće.
- Pokrenite ugrađene testne slučajeve paketa na ispitnom postavu s istim pločama.
- Pošaljite ga na potpisivanje: potrebna su dva od tri potpisa.
- Objavite ga na jednoj platformi. Postavlja se u neaktivni utor i uključuje se tek nakon što njegovi testni slučajevi prođu na uređaju.
- Nakon tjedna bez problema uvedite ga na sljedeću platformu.
U ovom receptu nema naredbi; izvodi se na stranicama Nexus Edge u konzoli. Dokaz su ugrađeni testni slučajevi, koji svi moraju proći prije uključivanja paketa, te dva potpisa. Ako test ne prođe na uređaju, platforma ostaje na prethodnom paketu, a podaci o neuspjehu preuzimaju se pri sljedećem preletu. Instalacija paketa na hardver za koji nije provjeren odbija se uz PACK_NOT_CHECKED_FOR_HARDWARE.
Nexus Edge je dodatak koji se licencira po platformi ili po floti. Paketi ostaju valjani dok platforma nije u vezi. Uzlazna veza je uska, stoga veličine planirajte u skladu s njom: naše izdanje 1.5 imalo je 412 MB, naspram 9.8 GB za paket s novim jezičnim modelom.
9. Izolirana isporuka (air-gapped) korisniku
Cilj je vaš dodatak ili paket instaliran na lokaciji korisnika bez mreže. Gradivni elementi su zapečaćeni paket iz @adverant/nexus-sovereign, vaš ključ za potpisivanje izdanja i vlastiti kanali izdanja korisnika.
- Izgradite dodatak i njegove slike točno kao za povezanog korisnika, sa svim provjerama zelenima.
- Izradite zapečaćeni paket s profilom
airgap, koji sadrži slike, migracije, unaprijed potpisane vještine i SBOM (popis softverskih komponenti) s licencama. - Potpišite ga svojim ključem izdanja Ed25519.
- Sami ga provjerite na čistom računalu.
- Pošaljite paket na mediju, a svoj javni ključ i SHA-256 paketa pošaljite zasebnim putem.
- Operater korisnika provjerava paket vašim ključem, a zatim uvodi izdanje putem vlastitih kanala izdanja.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle gradi paket iz vaše konfiguracije paketa. Dokaz je nexus-airgap verify na strani korisnika. Ponovno izračunava sažetak svake datoteke, odbacuje svaku datoteku koju manifest ne navodi, zahtijeva pouzdanog potpisnika i odbija paket čiji popis dopuštenih mrežnih odredišta nije prazan. Izmijenjena datoteka ne prolazi uz BUNDLE_INTEGRITY_VIOLATION. Nitko nikada ne bi smio isključiti strogu provjeru kako bi je zaobišao.
Instalacije bez mrežne veze (air-gapped) dio su izdanja Enterprise. Ništa u paketu ne smije ništa preuzimati pri instalaciji, a model koji dodatak treba dolazi s vlastitog poslužitelja modela korisnika putem usmjerivača pružatelja AI-ja (umjetne inteligencije).
10. Modul samo za izdanje Enterprise
Cilj je zatvorena, licencirana mogućnost koja se priključuje otvorenoj jezgri, primjerice revizijski trag s dugim zadržavanjem koji se prodaje samo korisnicima izdanja Enterprise. Gradivni element je paket sučelja @adverant/nexus-spi i ništa drugo iz izdanja Community.
- U repozitoriju držite kopiju izgrađenog paketa sučelja prikvačenu na razini bajtova kao lokalni paket
file:, s njegovim prikvačenjemSHA256SUMS. - Napišite
RouteModule(iliScreenModuleza zaslone konzole) prema njemu, s grupom značajki kojoj služi. - Svaku rutu izvodite iza
ctx.requireScopei prije odgovora provjerite vlastito ovlaštenje modula. - Odbijte uz
LICENCE_LOCKEDkada organizacija nema pravo, i prikažite najavu značajke, nikada njezine podatke. - Držite repozitorij unutar licencne granice, a zatim izgradite složeno stablo za svako izdanje.
npm ci
npm test
npm run buildDokaz je pravilo licencne granice: nema uvoza iz opsega izdanja Community osim paketa sučelja, nema relativnog uvoza izvan repozitorija i nema ovisnosti file:, link: ili workspace: izvan njega. Zatim tri gore navedene naredbe moraju proći u svakom složenom stablu izdanja, a ne samo u vašem radnom stablu. Poglavlje 2.25, Izgradnja za svako izdanje, sadrži kostur modula.
Modul se učitava u uslugu izdanja Community pri pokretanju, na instalacijama čija licenca sadrži njegovu grupu značajki. Bez tog ovlaštenja odbija rad, pa se ista verzija isporučuje posvuda i ne čini ništa ondje gdje nije licencirana.
11. Grananje (forking) ili proširivanje otvorene jezgre
Cilj je promjena samog izdanja Community, zadržana u vašem forku ili vraćena projektu. Gradivni element je izvorni kod izdanja Community pod licencom Apache License, Version 2.0.
- Napravite fork repozitorija i granu iz
main. - Ako ono što želite može biti dodatak ili vještina, odaberite to. Promjenu jezgre morate sami održavati u svakom izdanju.
- Unesite promjenu s testovima koji bez nje ne prolaze.
- Prije nego što bilo što predložite, pokrenite provjere koje projekt pokreće.
- Zadržite datoteku NOTICE i ne koristite nazive ni zaštitne znakove tvrtke Adverant osim za navođenje podrijetla rada.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckDokaz je prolaz tih triju provjera, uz dokaz da je svaki novi test padao prije vaše promjene. U svojem forku očuvajte jedno svojstvo otvorene jezgre: Community izvodi agenta od početka do kraja na lokalnom modelu bez ključa i bez mreže. Promjena koja to naruši narušava ono što Community čini samostalno upotrebljivim.
Ovo se odnosi samo na Community. Sve što mora ostati zatvoreno umjesto toga pripada modulu izdanja Enterprise (scenarij 10), kako bi licencna granica ostala ondje gdje je svatko može pokazati.
12. Aplikacija u oblaku za izdanje Team
Cilj je aplikacija koju korisnici izdanja Team mogu instalirati. Team radi samo u oblaku Adverant, pa aplikacija do njih dolazi samo putem kataloga. Gradivni elementi su dodatak i izdavački klaster: vaš vlastiti virtualni klaster u oblaku Adverant s oglednim podacima.
- Gradite i testirajte na izdavačkom klasteru, isključivo s oglednim podacima.
- U manifestu deklarirajte sve što aplikacija treba, i ništa više.
- Objavite je potpisanu, radi pregleda tvrtke Adverant i uvrštavanja u katalog.
- Svaki je korisnik instalira, dodjeljujući svaki deklarirani opseg jedinicu po jedinicu.
Dokaz se sastoji od dva dijela. Potpisano, pregledano izdanje uvodi vas u katalog. Zatim ovlaštenje korisnika određuje čemu aplikacija može pristupiti na njegovoj lokaciji, a svaki poziv koji nije deklarirala odbija se uz CONNECTION_SCOPE_EXCEEDED. Opseg koji nedostaje možete dodati samo u novom izdanju koje korisnik pregleda.
Izdavački klaster nema put ni do jednog korisnika, a zahtjev za podacima korisnika ondje se odbija uz TENANT_BOUNDARY. Korisnici s vama mogu dijeliti rezultate testova, nikada svoje podatke. Team uključuje mogućnost upravljanja tijekovima rada, pa ako vaša aplikacija isporučuje tijekove rada, korisnici izdanja Team mogu ih sami premještati između okruženja.
13. Omotavanje postojeće interne aplikacije kao dodatka
Cilj je aplikacija koju vaša tvrtka već koristi, uvedena u Nexus kako bi naslijedila prijavu, izolaciju i upravljanje. Gradivni elementi su vještina /plugin-create za prvi nacrt te alati za manifest i provjere iz SDK-a za dovršetak.
- Pokrenite
/plugin-creates repozitorijem. Analizira kod i odabire strategiju omatanja, a zatim generira pozadinski sustav, migracije, korisničko sučelje (UI), manifest i testove. - Podignite manifest na ugovor v2.
migratedodaje tri rečenice pravila i premještadomainudomains[], a odbija izmisliti ulaznu točku. - Svaku vrijednost zakupca koju omotač čita iz zaglavlja zamijenite zaštitom opsega iz SDK-a.
- Dodajte
organization_id,owner_user_idibusiness_unit_idu svaku tablicu, s primarnim ključevima koji počinju zakupcem. - Deklarirajte svaku rutu s njezinim pravom i instalirajte evidenciju odbijanja.
- Pokrećite provjere dok ne budu zelene.
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-testDokaz je da nexus-gates završava s kodom 0, uz prolaz provjera scope-adherence, one-fence, migrations-are-scoped, crud-adherence i api-contract. Očekujte da prvo pokretanje ne prođe na većini njih; naše je svaku rutu prijavilo kao neograničenu opsegom jer je nacrt vjerovao zaglavljima koja preglednik može postaviti. Provjere namjerno nemaju prekidač za ispravak.
Omotane aplikacije rade na svakom izdanju. Uvođenje se obavlja isključivo putem kanala izdanja instalacije, stoga zanemarite sve datoteke za uvođenje koje je nacrt napisao. Na rad na izolaciji odlazi najviše vremena: za stvarnu aplikaciju planirajte dane, a ne sate.


