PrijavaZakažite brifing

Poglavlje 2.27

Scenariji izgradnje

Zbirka od trinaest recepata za izgradnju, od jedne veštine do isporuke u izolovano okruženje. Svaki recept navodi cilj, gradivne elemente, korake i komande, kapiju koja potvrđuje da je uspelo i šta se menja u zavisnosti od izdanja i oblika isporuke.

Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

25 min čitanja

Ovo su recepti kojima se okrećem kada neko u kompaniji Corrán Orbital, ili kod korisnika, kaže „želimo da Nexus radi X”. Svaki je namerno kratak. Obrazloženje koraka nalazi se u prethodnim poglavljima: poglavlje 2.20, Veštine, i poglavlje 2.21, Plugin SDK, koje obrađuje komplet za razvoj softvera, zatim poglavlje 2.23, Domenski paketi, i tri poglavlja posle njega o izradi. Ovde dobijate cilj, koje gradivne blokove treba koristiti, korake, komande, kapiju koja potvrđuje da je sve uspelo, kao i napomene o izdanju i isporuci.

Kapija je najvažnija. Recept je završen kada je njegova kapija zelena. Svaka kapija u ovom poglavlju je nešto što možete sami pokrenuti ili što platforma pokreće umesto Vas, i svaka se završava kodom različitim od nule ili odbija uz kod kada uslov nije ispunjen.

Scenario Glavni gradivni blok Kapija koja to dokazuje Izdanje
Nova veština za Skills Engine Paket SKILL.md skill:validate bez ijedne greške Community i Enterprise
Veština u manifestu sa host_callback Manifest dodatka skills[] create-nexus-plugin validate i nexus-gates Community i Enterprise
Proširivanje postojećeg paketa pack.json sa inherits Provera politike prikaza na pilot kapiji Enterprise i licenca za paket
Novi paket od nule Zlatna putanja za domenski paket Kapije za staging i pilot Enterprise
Konektor za podatke Veština plugin_queue validate, nexus-gates, odbijanje izlaznog saobraćaja Community i Enterprise
MCP (Model Context Protocol) alat Manifest mcpTools[] validate (bez kombinatora na najvišem nivou) Community i Enterprise
Prodavnica pod tuđim brendom (white-label) Manifest domains i branding Javno pravilo scope-adherence Enterprise i dodatak Storefront
Misijski paket za Edge Misijski paket Test slučajevi na uređaju, dva od tri potpisa Enterprise i dodatak Nexus Edge
Isporuka u izolovano okruženje (air-gapped) Zapečaćeni paket nexus-airgap verify Enterprise
Modul samo za Enterprise @adverant/nexus-spi Kapija granice licence, verzije po izdanjima Enterprise
Forkovanje ili proširivanje otvorenog jezgra Izvorni kod Community izdanja Testovi, lint i provera tipova Community
Cloud aplikacija za izdanje Team Klaster izdavača Potpisano izdanje, pregled, dodela korisniku Team
Obuhvatanje postojeće interne aplikacije /plugin-create migrate, validate, nexus-gates Community i Enterprise
Stablo odlučivanja koje se čita odozgo nadole. Prvi romb pita "Da li mu je potreban kod koji se stalno izvršava?". "Ne" vodi do romba "Da li su to uputstva za asistenta?", čije se "Da" završava na "Veština za Skills Engine", a čije se "Ne" završava na "Prikaz na postojećem paketu". "Da" vodi do romba "Da li je to prikaz platforme za jednu industriju?", čije se "Da" završava na "Domenski paket (sa svojim pluginom)", a čije "Ne" vodi do poslednjeg romba "Da li mora da ostane zatvoren i licenciran?", koji se završava na "Modul izdanja Enterprise" za "Da" i "Plugin" za "Ne".
Od kog gradivnog bloka treba početi.

1. Nova veština za Skills Engine

Cilj je višekratno upotrebljiv skup instrukcija koji mogu da izvršavaju asistent, agenti, tokovi rada i razvojni alati, na primer provera carinske prijave u odnosu na njena pravila. Vaši gradivni blokovi su paket SKILL.md u fascikli nazvanoj po veštini, opcioni skill.yaml za okidače i oznake i opciona fascikla scripts/ koja se isporučuje uz njega.

  1. Napravite skills/<slug>/ i napišite SKILL.md sa frontmatter zaglavljem: name (kebab-case, jednako nazivu fascikle), description (do 500 znakova), allowed-tools, i opciono triggers, capabilities i version.
  2. Napišite telo namenjeno modelu: kada se veština koristi, njene korake, primere i ono što nikada ne sme da radi.
  3. Dodajte test slučajeve. Uključite jedan u kome je u ulaz podmetnuta instrukcija koju veština ne sme da izvrši.
  4. Validirajte, pregledajte plan otpremanja, a zatim otpremite.
  5. Objavite. Veština koja dodaje alat za upis zadržava se dok je ne odobre dve imenovane osobe pomoću passkey ključeva, a predlagač ne može da odobri sopstvenu izmenu.
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

Kapija je skill:validate, koja mora da prijavi nula grešaka pre nego što se bilo šta objavi. Blokirajuće greške su nedostajući naziv ili opis i dupliran slug ili tip posla. Otpremanje sadržaja koji je već objavljen vraća postojeću verziju (CONTENT_HASH_ALREADY_PUBLISHED), pa se otpremanje može bezbedno ponoviti.

Community izdanje dobija ceo alat za kreiranje, biblioteku, verzije, vraćanje na prethodnu verziju, uvoz i testove. Na izdanju Enterprise objavljivanje dodatno prolazi kroz shadow i canary faze: odobrena verzija radi u senci, zatim za jednu jedinicu iza imenovanih kapija, pa za sve, i sama se zaustavlja ako neka kapija nije ispunjena. Za korisnika u izolovanom okruženju veštine se prenose unapred potpisane unutar zapečaćenog paketa (scenario 9).

2. Veština iz manifesta sa opcijom host_callback

Cilj je deterministička obrada u Vašem sopstvenom dodatku koju platforma može da pokrene, na primer otvaranje zapisa o odstupanju na osnovu očitavanja. Koristićete red u manifestu skills[] sa nivoom host_callback i rutu /internal u Vašem backendu zaštićenu servisnim čuvarom iz SDK-a.

  1. Deklarišite veštinu: id u lower_snake obliku, tier: "host_callback", classification na nivou ili ispod gornje granice poverenja Vašeg dodatka, inputSchema, outputSchema i timeoutMs između 1 sekunde i 6 sati.
  2. Popunite hostCallback: naziv Vašeg sopstvenog servisa (Service), njegov port, relativnu putanju kao što je /internal/skills/excursion_open, oba ograničenja u bajtovima (maxRequestBytes i maxResponseBytes) i tenantHeader: "X-Organization-ID".
  3. Deklarišite rutu u api.endpoints[] sa auth: "service-key" ili auth: "internal" i zaštitite je sa requireService ili serviceMiddleware, nikada korisničkim čuvarom opsega.
  4. Validirajte, pokrenite kapije i prepustite procesu uključivanja da sinhronizuje veštine u registar preko 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 primenjuje sopstvena pravila sinhronizacije registra pre nego što se bilo šta sinhronizuje, a svako odbijanje nosi kod prijemne strane. Putanja sa šemom, // ili obrnutom kosom crtom odbija se kao putanja sa drugog porekla. Nedostajuće ograničenje u bajtovima daje ENDPOINT_BYTE_CAP_REQUIRED, polje iz drugog nivoa daje FIELD_NOT_FOR_TIER, a vremensko ograničenje van opsega daje TIMEOUT_OUT_OF_BOUNDS. Zatim nexus-gates proverava da ruta /internal nosi servisnog čuvara i da je deklarisana kao internal ili service-key. Taj par kapija je dokaz.

Sinhronizacija je deklarativna. Svaki put pošaljite ceo skup veština, jer se veština koju izostavite onemogućava, i neka Vaš korak raspoređivanja ne uspe za svaki status osim 200. Na izdanju Enterprise sinhronizacija dodatka proverava se u celini: ako jedna veština prekrši pravilo, ništa iz te sinhronizacije se ne prihvata (PLUGIN_SYNC_ALL_OR_NOTHING) i prethodna verzija nastavlja da radi. Dodatak sa poverenjem nivoa community ne može da koristi nivoe koji dopiru do modela, tool_using i llm_only; za njih je potrebno poverenje core ili verified.

Dodaci i MCP sinhronizacija
Dodaci i MCP sinhronizacija
Dodaci koji donose veštine i šta je provereno pri svakoj sinhronizaciji. Obratite pažnju na dodatak čija je sinhronizacija odbijena u celini jer je jedna od njegovih pet veština koristila nivo koji sme da hostuje samo platforma, dok je njegova prethodna verzija nastavila da radi.

3. Proširivanje postojećeg paketa

Cilj je nova industrija ili podindustrija koja ponovo koristi veći deo postojećeg paketa, na primer krediti i sporovi oko kartica nad strukturom paketa Insurance. Gradivni blok je pack.json koji navodi svoj roditeljski paket u inherits i dodaje samo sopstvene grupe prikaza i termine.

  1. Započnite paket zlatnom putanjom za domenski paket, a zatim postavite inherits na id roditeljskog paketa.
  2. Dodajte sopstvene grupe lens, svaku sa njenim mestima, namenom i referencom na leksikon.
  3. Dodajte svoje termine u leksikon, svaki sa jednostavnim objašnjenjem. Označite termin sa exact tamo gde mora biti prikazan tačno onako kako je napisan.
  4. Ponovo koristite zajedničke prikaze umesto da crtate sopstvene: režim koji je potreban u više paketa, kao što je registar eksternalizovane tehnologije, predstavlja jedan zajednički prikaz.
  5. Proverite lanac licenci. Vaš paket nasleđuje zahteve za dodacima svog roditeljskog paketa.
  6. Pregledajte svaki prikaz kao određena osoba na sintetičkoj grani.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Dokaz je provera politike na pilot kapiji, koja potvrđuje da svaki prikaz samo sužava svoj osnovni prikaz i da lična polja podrazumevano drži isključenim. Prikaz koji pokušava da pokaže ono što njegov osnovni prikaz skriva odbija se sa LENS_CANNOT_WIDEN. Što se licenciranja tiče, konzola odbija da izda licencu za Vaš paket bez dodataka koji su potrebni njegovom roditeljskom paketu; paketu Insurance potrebni su Decision rooms i zapečaćeni zapisi.

Domenski paketi su deo izdanja Enterprise i licenciraju se po paketu. Ekranima paketa na telefonu potreban je i dodatak Mobile apps. Podređeni paket ne može da menja okvir, komponente ni pravila pisanja.

4. Novi paket od nule

Cilj je pogled jedne industrije na Nexus: njen model znanja, prikazi za svaku ulogu, dokazi koje zahtevaju njena pravila i dodatak koji održava njene podatke ažurnim. Poglavlje 2.24, Izrada prilagođene vertikale od početka do kraja, detaljno prolazi kroz ovu izradu; ovde je skraćeni oblik.

  1. Pokrenite zlatnu putanju za domenski paket i opišite paket: namenu, jedinice, osnovni model i pravila koja mapira.
  2. Izgradite model znanja na osnovnom modelu i klasifikujte svako svojstvo dok ga dodajete.
  3. Pročitajte plan, potvrdite njegov otisak svojim passkey ključem i kreirajte.
  4. Oblikujte prikaze u alatu Lens builder, tako da svaki sužava osnovni prikaz.
  5. Napišite dodatak i sve veštine za Skills Engine koje su paketu potrebne.
  6. Generišite sintetičke podatke iz semena sa neobičnim slučajevima koji su Vam važni i pregledajte svaki prikaz kao određena osoba.
  7. Unapredite iz razvojnog prostora u staging, zatim u pilot jedinicu, pa u sve jedinice.

Dokaz su kapije za unapređenje: svi testovi prolaze na sintetičkim granama pre ulaska u staging, zatim dva recenzenta koji nisu autor, pa 14 dana u pilotu sa greškama ispod 1 na 1.000. Nijedan korak se ne može preskočiti (GATE_CANNOT_BE_SKIPPED). Paketi su deo izdanja Enterprise. Na izdanju Community zlatna putanja za domenski paket nije ponuđena.

5. Konektor podataka

Cilj je da podaci iz spoljnog sistema po rasporedu teku u sopstvene tabele Vašeg dodatka, na primer događaji na kapiji iz operativnog sistema terminala. Gradivni blokovi su veština plugin_queue, worker koji preuzima Vaš red, migracija za ciljnu tabelu i izlazna adresa deklarisana u manifestu.

  1. Deklarišite veštinu plugin_queue sa queueName napisanim kao <plugin name>.<name>. Dvotačka nije dozvoljena, a naziv mora biti u manifestu, jer orkestrator stavlja poslove direktno u taj red.
  2. Napišite worker koji preuzima red i poziva spoljni sistem.
  3. Deklarišite adresu spoljnog sistema kao izlaznu adresu. Sve što nije navedeno je blokirano.
  4. Čuvajte ono što pristiže u sopstvenoj šemi, sa organization_id, owner_user_id i business_unit_id u svakom redu.
  5. Učitajte akreditiv spoljnog sistema po nazivu iz okruženja i navedite promenljivu u scripts/ci/required-env.
  6. Pokrećite preuzimanja preko UNO-a, mehanizma za tokove rada, nikada pomoću tajmera koji direktno 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 proverava naziv reda i vremensko ograničenje u odnosu na pravila sinhronizacije registra. Tri kapije dokazuju da ne postoji akreditiv za model, da nema direktne obrade i da je tabela pravilno ograničena opsegom. Pokrenite ceo nexus-gates pre slanja, jer --only sužava pokretanje i to navodi u svom rezimeu. U toku rada, poziv ka adresi koju manifest nije deklarisao zaustavlja se na ivici sa EGRESS_NOT_DECLARED.

Sopstveni konektori platforme za diskove, wiki sisteme, skladišta pošte i nasleđene sisteme, sa praćenjem izmena i poreklom podataka, dolaze uz dodatak Data connectors. Konektor koji sami napravite je dodatak i radi na svakom izdanju. Dodavanje izlazne adrese u kasnijem izdanju predstavlja proširenje i zadržava se dok ga dva recenzenta ne prihvate.

6. MCP alat

Cilj je alat koji Claude Code, agenti i drugi MCP (Model Context Protocol) klijenti mogu da pozovu, na primer za pregled istorije inspekcija broda. Gradivni blok je stavka u manifestu mcpTools[], sa name, description i inputSchema.

  1. Imenujte alat i opišite ga jednostavno. Opis je ono što model čita da bi odlučio da li će ga pozvati.
  2. Napišite inputSchema kao jednu šemu objekta. Ne stavljajte oneOf, allOf ili anyOf na njen najviši nivo.
  3. Držite rutu koja služi alat iza čuvara opsega, kao i svaku drugu rutu /api, tako da zakupac proizlazi iz tokena pozivaoca.
  4. Validirajte manifest.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Dokaz je validate: kombinator na najvišem nivou odbija se već pri kreiranju, jer bi u toku rada doveo do toga da alat ne radi ni za jednog MCP podagenta koji ga uvozi, pa bi alat postojao, a niko ne bi mogao da ga pozove.

Na izdanju Enterprise svaki alat koji IDE (integrisano razvojno okruženje) može da pozove naveden je u katalogu Workbench tools sa svojim nivoom, informacijom da li menja podatke, fiksiranim otiskom i ulogama koje smeju da ga koriste. Ako se opis Vašeg alata promeni u novom izdanju, katalog zadržava alat dok osoba ne pregleda izmenu. To je namerno: izmenjeni opis je način na koji alat može početi da traži od modela nešto što ne bi smeo. Poziv ka bilo čemu van propusnice pozivaoca odbija se sa CONNECTION_SCOPE_EXCEEDED.

7. White-label izlog

Cilj je aplikacija koju koriste kupci Vašeg korisnika, na domenu korisnika i u njegovom brendu, bez ikakvog traga kompanije Adverant. Gradivni blokovi su blokovi manifesta domains i branding, pomoćne funkcije za prijavu iz SDK-a i korisnikov dodatak Storefront / white-label.

  1. Unesite domen korisnika u domains[] kao primary, uz eventualne aliases.
  2. Popunite branding: appName, tagline, primaryColor, accentColor, passkeyRpId jednak domenu i oauthClientRef.
  3. Prijavljujte korisnike preko pomoćnih funkcija za prijavu iz SDK-a i tačno deklarišite njihove dve javne rute, sa auth: "public" i allowAnonymous: true.
  4. Šaljite svaki poziv iz frontenda preko proksija sa listom dozvoljenih adresa u backendu za frontend. Nikada ne stavljajte adresu servisa u klijent.
  5. Plaćanja prepustite administratoru korisnika, koji povezuje platne servise i podešava brendirano plaćanje.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Dokaz je scope-adherence. On dozvoljava nezaštićenu rutu /api samo kada manifest deklariše taj tačan metod i putanju kao javne i kada je putanja jedna od ruta za prijavu; svaka druga javna deklaracija ne prolazi i navodi dve dozvoljene putanje. Zatim api-contract upoređuje deklarisane rute sa stvarnim u oba smera. definePlugin takođe odbija frontend.basePath koji nije relativna putanja sa istog porekla.

White-label je dodatak Storefront / white-label u okviru izdanja Enterprise, koji licencira i plaćanja. Podaci o platnim karticama nikada ne dolaze do sistema Nexus. Brendom upravlja administrator klijenta, a platforma ga određuje na osnovu organizacije, a ne na osnovu vašeg koda.

8. Paket misije za Edge

Cilj je nova ili ažurirana misija za satelit ili dron koji pokreće Nexus Edge, na primer dodavanje adaptera za pronalaženje brodova u misiju pomorskog nadzora. Gradivni element je paket misije, izgrađen i potpisan na zemlji.

  1. Počnite od trenutnog paketa na stranici Izgradnja paketa misije, koja izrađuje nacrt nove verzije na osnovu stare i označava svaku izmenu.
  2. Menjajte samo ono što je misiji potrebno. Kada je moguće, velike delove, jezički model i ontologiju, zadržite nepromenjenim.
  3. Proverite tabelu raspoređivanja na svakom koraku degradacije, kako bi svaka ploča i dalje mogla da podrži ono što izvršava.
  4. Pokrenite testne slučajeve paketa na uređaju na probnoj postavci sa 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 slot i aktivira se tek nakon što njegovi testni slučajevi prođu na uređaju.
  7. Uvedite ga na sledeću platformu nakon nedelju dana bez problema.
Paketi misija
Paketi misija
Biblioteka paketa misija, sa sadržajem svakog paketa i platformama na kojima se izvršava. Obratite pažnju na stariju verziju koja se čuva na uređaju radi povratka, kao i na broj testnih slučajeva koje svaki paket mora da prođe na svom hardveru.

U ovom receptu nema komandi; sve se obavlja na stranicama Nexus Edge u konzoli. Dokaz su testni slučajevi na uređaju, koji svi moraju da prođu pre nego što se paket aktivira, kao i dva potpisa. Ako test ne prođe na uređaju, platforma ostaje na prethodnom paketu, a podaci o grešci se preuzimaju pri sledećem preletu. Instaliranje paketa na hardver za koji nije proveren odbija se uz PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge je dodatak koji se licencira po platformi ili po floti. Paketi ostaju važeći dok platforma nije na vezi. Kanal za prenos ka platformi je uzak, pa veličine planirajte u skladu s tim: naše izdanje 1.5 imalo je 412 MB, naspram 9.8 GB za paket sa novim jezičkim modelom.

9. Isporuka klijentu u izolovano okruženje (air-gapped)

Cilj je da vaš plugin ili paket bude instaliran na lokaciji klijenta bez mreže. Gradivni elementi su zapečaćeni paket iz @adverant/nexus-sovereign, vaš ključ za potpisivanje izdanja i sopstveni kanali izdanja klijenta.

  1. Izgradite plugin i njegove slike potpuno isto kao za klijenta sa mrežom, uz sve provere u zelenom.
  2. Napravite zapečaćeni paket sa profilom airgap, koji sadrži slike, migracije, unapred potpisane veštine i SBOM (spisak softverskih komponenti) sa licencama.
  3. Potpišite ga svojim Ed25519 ključem za izdanja.
  4. Sami ga proverite na čistoj mašini.
  5. Pošaljite paket na medijumu, a svoj javni ključ i SHA-256 paketa pošaljite drugim putem.
  6. Operater klijenta proverava paket vašim ključem, a zatim uvodi izdanje kroz sopstvene kanale 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 na osnovu vaše konfiguracije paketa. Dokaz je nexus-airgap verify na strani klijenta. Ponovo izračunava heš svake datoteke, odbija svaku datoteku koja nije navedena u manifestu, zahteva pouzdanog potpisnika i odbija paket čija lista dozvoljenih mrežnih adresa nije prazna. Izmenjena datoteka ne prolazi proveru uz BUNDLE_INTEGRITY_VIOLATION. Niko nikada ne bi trebalo da isključi strogu proveru da bi to zaobišao.

Instalacije bez mrežne veze deo su izdanja Enterprise. Ništa u paketu ne sme ništa da preuzima tokom instalacije, a model koji je pluginu potreban dolazi sa sopstvenog servera modela klijenta preko AI (veštačka inteligencija) Provider Router-a.

10. Modul samo za izdanje Enterprise

Cilj je zatvorena, licencirana funkcionalnost koja se povezuje na otvoreno jezgro, na primer revizijski trag sa dugim čuvanjem koji se prodaje samo klijentima izdanja Enterprise. Gradivni element je paket interfejsa @adverant/nexus-spi, i ništa drugo iz izdanja Community.

  1. Čuvajte kopiju izgrađenog paketa interfejsa, fiksiranu na nivou bajtova, u svom repozitorijumu kao lokalni file: paket, sa njegovim SHA256SUMS fiksiranjem.
  2. Napišite RouteModule (ili ScreenModule za ekrane konzole) prema njemu, sa grupom funkcionalnosti kojoj služi.
  3. Svaku rutu izvršavajte iza ctx.requireScope i proverite sopstvenu dozvolu modula pre odgovora.
  4. Odbijte uz LICENCE_LOCKED kada organizacija nema pravo, i prikažite najavu funkcionalnosti, nikada njene podatke.
  5. Uskladite repozitorijum sa granicom licence, a zatim izgradite složeno stablo za svako izdanje.
npm ci
npm test
npm run build

Dokaz je pravilo granice licence: nema uvoza iz opsega Community osim paketa interfejsa, nema relativnog uvoza izvan repozitorijuma i nema zavisnosti file:, link: ili workspace: izvan njega. Zatim tri gorenavedene komande moraju da prođu u složenom stablu svakog 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 servis izdanja Community pri pokretanju, na instalacijama čija licenca obuhvata njegovu grupu funkcionalnosti. Bez te dozvole on odbija rad, pa se ista verzija isporučuje svuda i ne radi ništa tamo gde nije licencirana.

11. Grananje (forking) ili proširivanje otvorenog jezgra

Cilj je izmena samog izdanja Community, koja se zadržava u vašem forku ili se vraća projektu. Gradivni element je izvorni kod izdanja Community pod licencom Apache License, Version 2.0.

  1. Napravite fork repozitorijuma i granu iz main.
  2. Ako ono što želite može biti plugin ili veština, prednost dajte tome. Izmenu jezgra morate sami da održavate u svakom izdanju.
  3. Izvršite izmenu uz testove koji bez nje ne prolaze.
  4. Pokrenite provere koje projekat pokreće pre nego što bilo šta predložite.
  5. Zadržite datoteku NOTICE i ne koristite nazive ni žigove kompanije Adverant osim radi navođenja porekla rada.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Dokaz je uspešno prolaženje te tri provere, kao i dokaz da svaki novi test nije prolazio pre vaše izmene. U svom forku očuvajte jedno svojstvo otvorenog jezgra: Community izvršava agenta od početka do kraja na lokalnom modelu, bez ključa i bez mreže. Izmena koja to naruši narušava ono što izdanje Community čini samostalno upotrebljivim.

Ovo važi samo za Community. Sve što mora da ostane zatvoreno pripada modulu izdanja Enterprise (scenario 10), kako bi granica licence ostala na mestu na koje svako može da ukaže.

12. Aplikacija u oblaku za izdanje Team

Cilj je aplikacija koju klijenti izdanja Team mogu da instaliraju. Team radi samo na Adverant cloud-u, pa aplikacija do njih stiže samo preko kataloga. Gradivni elementi su plugin i klaster izdavača: vaš sopstveni virtuelni klaster na Adverant cloud-u sa uzorkom podataka.

  1. Gradite i testirajte na klasteru izdavača, isključivo sa uzorkom podataka.
  2. U manifestu deklarišite sve što je aplikaciji potrebno, i ništa više.
  3. Objavite je potpisanu, radi pregleda od strane kompanije Adverant i uvrštavanja u katalog.
  4. Svaki klijent je instalira, dodeljujući svaki deklarisani opseg jedinicu po jedinicu.

Dokaz se sastoji iz dva dela. Potpisano, pregledano izdanje uvodi vas u katalog. Zatim dozvola klijenta određuje čemu aplikacija može da pristupi na njegovoj lokaciji, a svaki poziv koji nije deklarisan odbija se uz CONNECTION_SCOPE_EXCEEDED. Opseg koji nedostaje možete dodati samo u novom izdanju koje klijent pregleda.

Instalirajte dodatak treće strane
Instalirajte dodatak treće strane
Administrator instalira plugin treće strane, dodeljujući svaki deklarisani opseg po jedinici i izostavljajući jedan. Prikaz pokazuje poziv koji plugin nikada nije deklarisao, odbijen.

Klaster izdavača nema putanju ni do jednog klijenta, a zahtev za podacima klijenta na njemu odbija se uz TENANT_BOUNDARY. Klijenti mogu da dele rezultate testova sa vama, ali nikada svoje podatke. Team obuhvata funkcionalnost za operacije nad tokovima rada, pa ako vaša aplikacija isporučuje tokove rada, klijenti izdanja Team mogu sami da ih prenose između okruženja.

13. Omotavanje postojeće interne aplikacije u dodatak

Cilj je aplikacija koju vaša kompanija već koristi, uvedena u Nexus kako bi nasledila prijavu, izolaciju i upravljanje. Gradivni elementi su veština /plugin-create za prvi nacrt, kao i alati za manifest i provere iz SDK-a za završetak.

  1. Pokrenite /plugin-create nad repozitorijumom. Ona analizira kod i bira strategiju omotavanja, a zatim generiše backend, migracije, korisnički interfejs (UI), manifest i testove.
  2. Podignite manifest na ugovor v2. migrate dodaje tri rečenice pravila i premešta domain u domains[], a odbija da izmisli ulaznu tačku.
  3. Svaku vrednost zakupca koju omotač čita iz zaglavlja zamenite zaštitom opsega iz SDK-a.
  4. Dodajte organization_id, owner_user_id i business_unit_id u svaku tabelu, sa primarnim ključevima koji počinju zakupcem.
  5. Deklarišite svaku rutu sa njenim pravom i instalirajte evidenciju odbijanja.
  6. Pokrećite provere dok ne budu u zelenom.
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 se nexus-gates završava kodom 0, pri čemu scope-adherence, one-fence, migrations-are-scoped, crud-adherence i api-contract svi prolaze. Očekujte da prvo pokretanje ne prođe većinu njih; naše je prijavilo svaku rutu kao rutu bez opsega, jer se nacrt oslanjao na zaglavlja koja je pregledač mogao da postavi. Provere namerno nemaju opciju za automatsko ispravljanje.

Omotane aplikacije rade na svakom izdanju. Raspoređivanje se vrši isključivo kroz kanale izdanja instalacije, pa zanemarite sve datoteke za raspoređivanje koje je nacrt napisao. Najviše vremena odlazi na rad na izolaciji: za stvarnu aplikaciju planirajte danima, a ne satima.