PrijavaRezervirajte prezentaciju

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

25 min čitanja

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
Stablo odlučivanja čita se odozgo prema dolje. Prvi romb pita "Treba li kod koji se stalno izvodi?". "Ne" vodi do romba "Jesu li to upute za asistenta?", čiji "Da" završava kod "Vještina Skills Engine", a "Ne" kod "Leća na postojećem paketu". "Da" vodi do romba "Je li to prikaz platforme za jednu industriju?", čiji "Da" završava kod "Domenski paket (s pripadajućim dodatkom)", a "Ne" vodi do posljednjeg romba "Mora li ostati zatvoreno i licencirano?", koji završava kod "Modul izdanja Enterprise" za "Da" i "Dodatak" za "Ne".
Od kojeg građevnog bloka započeti.

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.

  1. Izradite skills/<slug>/ i napišite SKILL.md s frontmatterom: name (kebab-case, jednako nazivu mape), description (do 500 znakova), allowed-tools te neobavezno triggers, capabilities i version.
  2. Napišite tijelo za model: kada upotrijebiti vještinu, njezine korake, primjere i ono što nikada ne smije činiti.
  3. Dodajte testne slučajeve. Uključite jedan s uputom podmetnutom u ulaz koju vještina ne smije slijediti.
  4. Provedite validaciju, pregledajte plan prijenosa, a zatim prenesite.
  5. 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-filing

Provjera 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.

  1. Deklarirajte vještinu: id u lower_snake, tier: "host_callback", classification jednak ili ispod gornje granice povjerenja vašeg dodatka, inputSchema, outputSchema i timeoutMs između 1 sekunde i 6 sati.
  2. Ispunite hostCallback: naziv vlastitog servisa, njegov port, relativnu putanju poput /internal/skills/excursion_open, obje granice bajtova (maxRequestBytes i maxResponseBytes) te tenantHeader: "X-Organization-ID".
  3. Deklarirajte rutu u api.endpoints[] s auth: "service-key" ili auth: "internal" i zaštitite je s requireService ili serviceMiddleware, nikada korisničkim čuvarom opsega.
  4. 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-test

validate 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.

Dodaci i MCP sinkronizacija
Dodaci i MCP sinkronizacija
Dodaci koji donose vještine i ono što je provjereno pri svakoj sinkronizaciji. Uočite dodatak čija je sinkronizacija odbijena u cijelosti jer je jedna od njegovih pet vještina upotrijebila razinu koju smije pokretati samo platforma, dok je njegova prethodna verzija nastavila raditi.

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.

  1. Započnite paket zlatnim putem za domenski paket, a zatim postavite inherits na id roditeljskog paketa.
  2. Dodajte vlastite skupine lens, svaku s mjestima, svrhom i referencom na leksikon.
  3. Dodajte svoje riječi u leksikon, svaku s jednostavnim objašnjenjem. Označite pojam s exact ondje gdje se mora prikazati kako je napisan.
  4. 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.
  5. Provjerite licencni lanac. Vaš paket nasljeđuje zahtjeve za dodatke svojeg roditelja.
  6. 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.

  1. Pokrenite zlatni put za domenski paket i opišite paket: svrhu, jedinice, osnovni model i pravila koja preslikava.
  2. Izgradite model znanja na osnovnom modelu i klasificirajte svako svojstvo dok ga dodajete.
  3. Pročitajte plan, potvrdite njegov otisak pristupnim ključem i izradite.
  4. Oblikujte leće u alatu Lens builder, pri čemu svaka sužava osnovnu leću.
  5. Napišite dodatak i sve vještine za Skills Engine koje paket treba.
  6. 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.
  7. 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.

  1. Deklarirajte vještinu plugin_queue s queueName napisanim kao <plugin name>.<name>. Dvotočka nije dopuštena, a naziv mora biti u manifestu jer ga orkestrator izravno stavlja u red.
  2. Napišite radni proces koji preuzima iz reda i poziva vanjski sustav.
  3. Deklarirajte adresu vanjskog sustava kao izlaznu adresu. Sve što nije navedeno blokira se.
  4. Pohranite ono što stigne u vlastitu shemu, s organization_id, owner_user_id i business_unit_id u svakom retku.
  5. Vjerodajnicu vanjskog sustava pročitajte po nazivu iz okruženja i navedite varijablu u scripts/ci/required-env.
  6. 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-env

validate 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.

  1. Imenujte alat i jasno ga opišite. Opis je ono što model čita kako bi odlučio hoće li ga pozvati.
  2. Napišite inputSchema kao jednu shemu objekta. Ne stavljajte oneOf, allOf ni anyOf na njezinu najvišu razinu.
  3. Rutu koja poslužuje alat držite iza čuvara opsega, kao i svaku drugu rutu /api, tako da zakupništvo proizlazi iz tokena pozivatelja.
  4. Provedite validaciju manifesta.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Dokaz 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.

  1. Stavite korisnikovu domenu u domains[] kao primary, uz eventualne aliases.
  2. Ispunite branding: appName, tagline, primaryColor, accentColor, passkeyRpId jednak domeni te oauthClientRef.
  3. Prijavljujte osobe putem pomoćnih funkcija za prijavu iz SDK-a i točno deklarirajte njihove dvije javne rute, s auth: "public" i allowAnonymous: true.
  4. Svaki poziv frontenda šaljite kroz proxy s popisom dopuštenih adresa backenda za frontend. Nikada ne stavljajte adresu servisa u klijent.
  5. 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-contract

Dokaz 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.

  1. Krenite od trenutačnog paketa na stranici Izrada paketa misije, koja izrađuje nacrt nove verzije iz stare i označava svaku promjenu.
  2. Mijenjajte samo ono što misija zahtijeva. Velike dijelove, jezični model i ontologiju, zadržite nepromijenjenima kad god možete.
  3. Provjerite tablicu raspoređivanja na svakom koraku degradacije, kako bi svaka ploča i dalje odgovarala onome što pokreće.
  4. Pokrenite ugrađene testne slučajeve paketa na ispitnom postavu s istim pločama.
  5. Pošaljite ga na potpisivanje: potrebna su dva od tri potpisa.
  6. 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.
  7. Nakon tjedna bez problema uvedite ga na sljedeću platformu.
Paketi misija
Paketi misija
Knjižnica paketa misija, sa sadržajem svakog paketa i platformama na kojima se izvodi. Obratite pozornost na stariju verziju koja se čuva na uređaju za povratak te na broj testnih slučajeva koje svaki paket mora proći na svojem hardveru.

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.

  1. Izgradite dodatak i njegove slike točno kao za povezanog korisnika, sa svim provjerama zelenima.
  2. Izradite zapečaćeni paket s profilom airgap, koji sadrži slike, migracije, unaprijed potpisane vještine i SBOM (popis softverskih komponenti) s licencama.
  3. Potpišite ga svojim ključem izdanja Ed25519.
  4. Sami ga provjerite na čistom računalu.
  5. Pošaljite paket na mediju, a svoj javni ključ i SHA-256 paketa pošaljite zasebnim putem.
  6. 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 airgap

nexus-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.

  1. U repozitoriju držite kopiju izgrađenog paketa sučelja prikvačenu na razini bajtova kao lokalni paket file:, s njegovim prikvačenjem SHA256SUMS.
  2. Napišite RouteModule (ili ScreenModule za zaslone konzole) prema njemu, s grupom značajki kojoj služi.
  3. Svaku rutu izvodite iza ctx.requireScope i prije odgovora provjerite vlastito ovlaštenje modula.
  4. Odbijte uz LICENCE_LOCKED kada organizacija nema pravo, i prikažite najavu značajke, nikada njezine podatke.
  5. Držite repozitorij unutar licencne granice, a zatim izgradite složeno stablo za svako izdanje.
npm ci
npm test
npm run build

Dokaz 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.

  1. Napravite fork repozitorija i granu iz main.
  2. Ako ono što želite može biti dodatak ili vještina, odaberite to. Promjenu jezgre morate sami održavati u svakom izdanju.
  3. Unesite promjenu s testovima koji bez nje ne prolaze.
  4. Prije nego što bilo što predložite, pokrenite provjere koje projekt pokreće.
  5. 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 typecheck

Dokaz 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.

  1. Gradite i testirajte na izdavačkom klasteru, isključivo s oglednim podacima.
  2. U manifestu deklarirajte sve što aplikacija treba, i ništa više.
  3. Objavite je potpisanu, radi pregleda tvrtke Adverant i uvrštavanja u katalog.
  4. 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.

Instalirajte dodatak treće strane
Instalirajte dodatak treće strane
Administrator instalira dodatak treće strane, dodjeljujući svaki deklarirani opseg po jedinici i izostavljajući jedan. Prikaz pokazuje odbijeni poziv koji dodatak nikada nije deklarirao.

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.

  1. Pokrenite /plugin-create s repozitorijem. Analizira kod i odabire strategiju omatanja, a zatim generira pozadinski sustav, migracije, korisničko sučelje (UI), manifest i testove.
  2. Podignite manifest na ugovor v2. migrate dodaje tri rečenice pravila i premješta domain u domains[], a odbija izmisliti ulaznu točku.
  3. Svaku vrijednost zakupca koju omotač čita iz zaglavlja zamijenite zaštitom opsega iz SDK-a.
  4. Dodajte organization_id, owner_user_id i business_unit_id u svaku tablicu, s primarnim ključevima koji počinju zakupcem.
  5. Deklarirajte svaku rutu s njezinim pravom i instalirajte evidenciju odbijanja.
  6. 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-test

Dokaz 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.