HyniRezervoni një prezantim

Kapitulli 2.27

Skenarët e ndërtimit

Një libër recetash me trembëdhjetë ndërtime, nga një aftësi e vetme deri te një shpërndarje e izoluar nga rrjeti (air-gapped). Çdo recetë jep qëllimin, blloqet ndërtuese, hapat dhe komandat, portën e kontrollit që vërteton se funksionoi, dhe çfarë ndryshon sipas edicionit dhe formës së shpërndarjes.

Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

25 minuta lexim

Këto janë recetat që përdor kur dikush në Corrán Orbital, ose te një klient, thotë "duam që Nexus të bëjë X". Secila është e shkurtër me qëllim. Arsyetimi pas hapave ndodhet në kapitujt para këtij: kapitulli 2.20, Aftësitë, dhe kapitulli 2.21, Plugin SDK, që mbulon kompletin e zhvillimit të softuerit, pastaj kapitulli 2.23, Paketat e domenit, dhe tre kapitujt pas tij mbi ndërtimin. Këtu gjeni qëllimin, cilat blloqe ndërtimi të përdorni, hapat, komandat, portën që ju tregon se funksionoi, si dhe shënimet për edicionin dhe dorëzimin.

Porta ka më shumë rëndësi. Një recetë përfundon kur porta e saj është e gjelbër. Çdo portë në këtë kapitull është diçka që mund ta ekzekutoni ose diçka që platforma e ekzekuton për ju, dhe secila del me kod jo zero ose refuzon me një kod kur nuk plotësohet.

Skenari Blloku kryesor i ndërtimit Porta që e provon Edicioni
Një aftësi e re e Skills Engine Paketë SKILL.md skill:validate me zero gabime Community dhe Enterprise
Një aftësi manifesti me host_callback Manifesti i plugin-it skills[] create-nexus-plugin validate dhe nexus-gates Community dhe Enterprise
Zgjerimi i një pakete ekzistuese pack.json me inherits Kontrolli i politikës së lenteve në portën pilot Enterprise dhe një licencë pakete
Një paketë e re nga zeroja Rruga e artë e paketës së domenit Portat e staging dhe pilot Enterprise
Një lidhës të dhënash Aftësi plugin_queue validate, nexus-gates, refuzimi i daljes Community dhe Enterprise
Një mjet MCP (Model Context Protocol) Manifesti mcpTools[] validate (pa kombinatorë në nivelin e sipërm) Community dhe Enterprise
Një dyqan white-label Manifesti domains dhe branding Rregulli publik scope-adherence Enterprise dhe shtesa Storefront
Një paketë misioni Edge Paketë misioni Raste testimi në bord, dy nga tre nënshkrime Enterprise dhe shtesa Nexus Edge
Një dorëzim i izoluar (air-gapped) Paketë e vulosur nexus-airgap verify Enterprise
Një modul vetëm për Enterprise @adverant/nexus-spi Porta e linjës së licencës, ndërtimet e edicioneve Enterprise
Forkimi ose zgjerimi i bërthamës së hapur Burimi i Community Testet, lint dhe kontrolli i tipeve Community
Një aplikacion cloud i edicionit Team Klaster botuesi Publikim i nënshkruar, rishikim, dhënie te klienti Team
Mbështjellja e një aplikacioni të brendshëm ekzistues /plugin-create migrate, validate, nexus-gates Community dhe Enterprise
Një pemë vendimi që lexohet nga lart poshtë. Rombi i parë pyet "A ka nevojë për kod që ekzekutohet gjatë gjithë kohës?". "Jo" çon te një romb "A janë udhëzime për një asistent?", "Po" e të cilit përfundon te "Aftësi e Skills Engine" dhe "Jo" e të cilit përfundon te "Lente mbi një paketë ekzistuese". "Po" çon te një romb "A është pamja e një industrie të vetme mbi platformën?", "Po" e të cilit përfundon te "Paketë domeni (me plugin-in e saj)" dhe "Jo" e të cilit çon te një romb i fundit "A duhet të mbetet e mbyllur dhe e licencuar?", që përfundon te "Modul Enterprise" për "Po" dhe "Plugin" për "Jo".
Nga cili bllok ndërtimi të nisni.

1. Një aftësi e re e Skills Engine

Qëllimi është një pjesë udhëzimi e ripërdorshme që asistenti, agjentët, rrjedhat e punës dhe mjetet e zhvilluesve mund ta ekzekutojnë të gjithë, si kontrolli i një deklarate doganore kundrejt rregullave të saj. Blloqet tuaja të ndërtimit janë një paketë SKILL.md në një dosje të emërtuar sipas aftësisë, një skill.yaml opsional për shkaktuesit dhe etiketat, dhe një dosje opsionale scripts/ e përfshirë bashkë me të.

  1. Krijoni skills/<slug>/ dhe shkruani SKILL.md me frontmatter: name (kebab-case, i njëjtë me emrin e dosjes), description (deri në 500 karaktere), allowed-tools, dhe opsionalisht triggers, capabilities dhe version.
  2. Shkruani trupin për modelin: kur të përdoret aftësia, hapat e saj, shembujt dhe çfarë nuk duhet të bëjë kurrë.
  3. Shtoni raste testimi. Përfshini një me një udhëzim të vendosur në hyrje që aftësia nuk duhet ta ndjekë.
  4. Validoni, shikoni planin e ngarkimit, pastaj ngarkoni.
  5. Publikoni. Një aftësi që shton një mjet shkrimi mbahet derisa dy persona të emërtuar ta miratojnë me passkey, dhe propozuesi nuk mund ta miratojë ndryshimin e vet.
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

Porta është skill:validate, e cila duhet të raportojë zero gabime para se të mund të publikohet ndonjë gjë. Gabimet bllokuese janë mungesa e emrit ose përshkrimit dhe një slug ose lloj pune i dyfishuar. Ngarkimi i përmbajtjes që është tashmë e publikuar kthen versionin ekzistues (CONTENT_HASH_ALREADY_PUBLISHED), kështu që ngarkimi mund të përsëritet pa rrezik.

Community merr krijuesin e plotë, bibliotekën, versionet, kthimin mbrapa, importin dhe testet. Në Enterprise, publikimi kalon gjithashtu përmes shadow dhe canary: versioni i miratuar ekzekutohet në shadow, pastaj për një njësi pas portave të emërtuara, pastaj për të gjithë, dhe ndalon vetë nëse një portë nuk plotësohet. Për një klient të izoluar (air-gapped), aftësitë udhëtojnë të nënshkruara paraprakisht brenda paketës së vulosur (skenari 9).

2. Një aftësi manifesti me host_callback

Qëllimi është llogaritje deterministe në plugin-in tuaj që platforma mund ta shpërndajë, si hapja e një regjistri devijimi nga një lexim. Do të përdorni një rresht në skills[] të manifestit me nivelin host_callback, dhe një rrugë /internal në backend-in tuaj të mbrojtur nga roja e shërbimit e SDK-së.

  1. Deklaroni aftësinë: id në lower_snake, tier: "host_callback", një classification në ose nën tavanin e besimit të plugin-it tuaj, inputSchema, outputSchema dhe një timeoutMs midis 1 sekonde dhe 6 orësh.
  2. Plotësoni hostCallback: emrin e Service-it tuaj, portin e tij, një shteg relativ si /internal/skills/excursion_open, të dy kufijtë e bajteve (maxRequestBytes dhe maxResponseBytes), dhe tenantHeader: "X-Organization-ID".
  3. Deklaroni rrugën në api.endpoints[] me auth: "service-key" ose auth: "internal", dhe mbrojeni me requireService ose serviceMiddleware, kurrë me rojën e fushës së përdoruesit.
  4. Validoni, ekzekutoni portat dhe lëreni procesin e onboarding të sinkronizojë aftësitë në regjistër përmes compileRegistry. Nuk shkruani kurrë SQL të regjistrit me dorë.
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 zbaton rregullat e vetë sinkronizimit të regjistrit para se të sinkronizohet ndonjë gjë, secila e refuzuar me kodin e marrësit. Një shteg me skemë, // ose vijë të pjerrët mbrapa refuzohet si cross-origin. Një kufi bajtesh që mungon është ENDPOINT_BYTE_CAP_REQUIRED, një fushë nga një nivel tjetër është FIELD_NOT_FOR_TIER, dhe një kohë pritjeje jashtë intervalit është TIMEOUT_OUT_OF_BOUNDS. Pastaj nexus-gates kontrollon që rruga /internal të mbajë rojën e shërbimit dhe të jetë deklaruar internal ose service-key. Ky çift portash është prova.

Sinkronizimi është deklarativ. Dërgoni grupin e plotë të aftësive çdo herë, sepse një aftësi që e lini jashtë çaktivizohet, dhe dështojeni hapin e vendosjes për çdo status përveç 200. Në Enterprise, një sinkronizim plugin-i kontrollohet i tëri: nëse një aftësi shkel një rregull, asgjë nga ai sinkronizim nuk merret (PLUGIN_SYNC_ALL_OR_NOTHING) dhe versioni i mëparshëm vazhdon të funksionojë. Një plugin me besim community nuk mund të përdorë nivelet që arrijnë një model, tool_using dhe llm_only; ato kërkojnë besim core ose verified.

Shtojcat dhe sinkronizimi MCP
Shtojcat dhe sinkronizimi MCP
Plugin-et që sjellin aftësi dhe për çfarë u kontrollua secili sinkronizim. Vini re plugin-in, sinkronizimi i të cilit u refuzua i tëri sepse njëra nga pesë aftësitë e tij përdori një nivel që vetëm platforma mund ta mbajë, ndërsa versioni i tij i mëparshëm vazhdoi të funksionojë.

3. Zgjerimi i një pakete ekzistuese

Qëllimi është një industri ose nënindustri e re që ripërdor pjesën më të madhe të një pakete ekzistuese, si huadhënia dhe kontestimet e kartave mbi formën e paketës Insurance. Blloku i ndërtimit është një pack.json që emërton prindin e vet në inherits dhe shton vetëm grupimet e veta të lenteve dhe fjalët.

  1. Nisni paketën me rrugën e artë të paketës së domenit, pastaj vendosni inherits në id-në e paketës prind.
  2. Shtoni grupimet tuaja lens, secili me vendet, qëllimin dhe referencën e leksikut.
  3. Shtoni fjalët tuaja në leksik me një shpjegim të thjeshtë për secilën. Shënoni një term exact kur duhet shfaqur ashtu siç është shkruar.
  4. Ripërdorni lentet e përbashkëta në vend që të vizatoni tuajat: një regjim që u nevojitet disa paketave, si një regjistër i teknologjisë së kontraktuar jashtë, është një lente e përbashkët.
  5. Kontrolloni zinxhirin e licencave. Paketa juaj trashëgon kërkesat për shtesa të prindit të saj.
  6. Shikoni paraprakisht çdo lente si një person në një degë sintetike.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Prova është kontrolli i politikës në portën pilot, i cili konfirmon që çdo lente vetëm ngushton bazën e saj dhe i mban fushat personale të fikura si parazgjedhje. Një lente që përpiqet të shfaqë atë që baza e saj fsheh refuzohet me LENS_CANNOT_WIDEN. Nga ana e licencimit, konsola refuzon të lëshojë licencë për paketën tuaj pa shtesat që i nevojiten prindit të saj; paketa Insurance kërkon Dhomat e vendimeve dhe regjistrat e vulosur.

Paketat e domenit janë Enterprise dhe licencohen për paketë. Ekranet e telefonit të një pakete kërkojnë gjithashtu shtesën Aplikacionet mobile. Një paketë fëmijë nuk mund të ndryshojë shell-in, komponentët ose rregullat e shkrimit.

4. Një paketë e re nga e para

Qëllimi është pamja e një industrie mbi Nexus: modeli i saj i njohurive, lentet për çdo rol, provat që kërkojnë rregullat e saj dhe plugin-i që i mban të dhënat e saj të përditësuara. Kapitulli 2.24, Ndërtimi i një vertikali të personalizuar nga fillimi në fund, e përshkon këtë ndërtim plotësisht; këtu është forma e shkurtër.

  1. Ekzekutoni rrugën e artë të paketës së domenit dhe përshkruani paketën: qëllimin, njësitë, modelin bazë dhe rregullat që harton.
  2. Ndërtoni modelin e njohurive mbi një model bazë dhe klasifikoni çdo veti ndërsa e shtoni.
  3. Lexoni planin, konfirmoni gjurmën e tij me passkey-n tuaj dhe krijoni.
  4. Formësoni lentet në Lens builder, secila duke ngushtuar një lente bazë.
  5. Shkruani plugin-in dhe çdo aftësi të Skills Engine që i nevojitet paketës.
  6. Gjeneroni të dhëna sintetike me farë me rastet e veçanta që ju interesojnë, dhe shikoni paraprakisht çdo lente si një person.
  7. Promovoni nga hapësira dev në staging, në një njësi pilot, pastaj në të gjitha njësitë.

Prova janë portat e promovimit: të gjitha testet që kalojnë në degët sintetike drejt staging, pastaj dy rishikues që nuk janë autori, pastaj 14 ditë në pilot me gabime nën 1 në 1,000. Asnjë hap nuk mund të anashkalohet (GATE_CANNOT_BE_SKIPPED). Paketat janë Enterprise. Në Community rruga e artë e paketës së domenit nuk ofrohet.

5. Një lidhës të dhënash

Qëllimi është që të dhënat nga një sistem i jashtëm të rrjedhin në tabelat e plugin-it tuaj sipas një orari, si ngjarjet e portës nga një sistem operativ terminali. Blloqet e ndërtimit janë një aftësi plugin_queue, një worker që tërheq radhën tuaj, një migrim për tabelën e synuar dhe një adresë dalëse e deklaruar në manifest.

  1. Deklaroni një aftësi plugin_queue me queueName të shkruar <plugin name>.<name>. Nuk lejohet dypikësh, dhe emri duhet të jetë në manifest, sepse orkestruesi e vendos drejtpërdrejt në radhë.
  2. Shkruani worker-in që tërheq radhën dhe thërret sistemin e jashtëm.
  3. Deklaroni adresën e sistemit të jashtëm si adresë dalëse. Çdo gjë që nuk është e listuar bllokohet.
  4. Ruani atë që mbërrin në skemën tuaj, me organization_id, owner_user_id dhe business_unit_id në çdo rresht.
  5. Lexoni kredencialin e sistemit të jashtëm sipas emrit nga mjedisi dhe listoni variablin në scripts/ci/required-env.
  6. Shpërndajini tërheqjet përmes UNO, motorit të rrjedhave të punës, kurrë me një kohëmatës që thërret motorët drejtpërdrejt.
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 kontrollon emrin e radhës dhe kohën e pritjes kundrejt rregullave të sinkronizimit të regjistrit. Tri portat provojnë që nuk ka kredencial modeli, as llogaritje të drejtpërdrejtë dhe se tabela ka fushë të duhur. Ekzekutoni nexus-gates të plotë para se të bëni push, pasi --only e ngushton ekzekutimin dhe e thotë këtë në përmbledhjen e vet. Gjatë ekzekutimit, një thirrje drejt një adrese që manifesti nuk e deklaroi ndalet në skaj me EGRESS_NOT_DECLARED.

Lidhësit e vetë platformës me disqe, wiki, depo postash dhe sisteme të trashëguara, me kapjen e ndryshimeve dhe gjurmimin e prejardhjes, vijnë me shtesën Lidhësit e të dhënave. Një lidhës që e ndërtoni vetë është plugin dhe funksionon në çdo edicion. Shtimi i një adrese dalëse në një publikim të mëvonshëm është zgjerim, i mbajtur derisa dy rishikues ta pranojnë.

6. Një mjet MCP

Qëllimi është një mjet që Claude Code, agjentët dhe klientë të tjerë MCP (Model Context Protocol) mund ta thërrasin, si kërkimi i historikut të inspektimeve të një anijeje. Blloku i ndërtimit është një hyrje në mcpTools[] të manifestit, me një name, një description dhe një inputSchema.

  1. Emërtoni mjetin dhe përshkruajeni qartë. Përshkrimi është ajo që lexon një model për të vendosur nëse ta thërrasë.
  2. Shkruani inputSchema si një skemë objekti të vetme. Mos vendosni oneOf, allOf ose anyOf në nivelin e saj të sipërm.
  3. Mbajeni rrugën që shërben mjetin pas rojës së fushës, si çdo rrugë tjetër /api, që përkatësia e tenant-it të vijë nga tokeni i thirrësit.
  4. Validoni manifestin.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Prova është validate: një kombinator në nivelin e sipërm refuzohet në kohën e krijimit, sepse gjatë ekzekutimit do ta bënte mjetin të dështonte për çdo nënagjent MCP që e importon, dhe mjeti do të ekzistonte pa e pasur askush mundësinë ta thërrasë.

Në Enterprise, çdo mjet që një IDE (mjedis i integruar zhvillimi) mund ta thërrasë listohet në katalogun e mjeteve të Workbench me nivelin e tij, nëse ndryshon gjëra, një gjurmë të fiksuar dhe rolet që mund ta përdorin. Nëse përshkrimi i mjetit tuaj ndryshon në një publikim të ri, katalogu e mban mjetin derisa një person ta rishikojë ndryshimin. Kjo është e qëllimshme: një përshkrim i ndryshuar është mënyra se si një mjet mund të fillojë t'i kërkojë një modeli diçka që nuk duhet. Një thirrje drejt çdo gjëje jashtë lejes së thirrësit refuzohet me CONNECTION_SCOPE_EXCEEDED.

7. Një vitrinë dixhitale white-label

Qëllimi është një aplikacion që e përdorin vetë klientët e klientit tuaj, në domenin e klientit dhe me markën e tyre, pa asnjë gjurmë të Adverant. Blloqet e ndërtimit janë blloqet domains dhe branding të manifestit, ndihmësit e hyrjes të SDK-së dhe shtesa Storefront / white-label e klientit.

  1. Vendosni domenin e klientit në domains[] si primary, me çdo aliases.
  2. Plotësoni branding: appName, tagline, primaryColor, accentColor, një passkeyRpId të barabartë me domenin, dhe oauthClientRef.
  3. Identifikoni personat përmes ndihmësve të hyrjes të SDK-së dhe deklaroni saktësisht dy rrugët e tyre publike, me auth: "public" dhe allowAnonymous: true.
  4. Dërgoni çdo thirrje të frontend-it përmes proxy-t me listë të lejuar backend for frontend. Mos vendosni kurrë adresë shërbimi në klient.
  5. Pagesat lërini te administratori i klientit, i cili lidh portat e pagesave dhe konfiguron arkën me markë.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Prova është scope-adherence. Ajo pranon një rrugë /api të pambrojtur vetëm kur manifesti deklaron atë metodë dhe shteg të saktë si publike dhe shtegu është një nga rrugët e hyrjes; çdo deklaratë tjetër publike dështon dhe emërton dy shtigjet e lejuara. api-contract pastaj krahason rrugët e deklaruara me ato reale në të dy drejtimet. definePlugin refuzon gjithashtu një frontend.basePath që nuk është shteg relativ me të njëjtën origjinë.

White-label është shtesa Storefront / white-label në Enterprise, e cila licencon edhe pagesat. Të dhënat e kartës nuk prekin kurrë Nexus. Administratori i klientit zotëron markën, dhe platforma e përcakton atë nga organizata dhe jo nga kodi juaj.

8. Një paketë misioni Edge

Qëllimi është një mision i ri ose i përditësuar për një satelit ose dron që ekzekuton Nexus Edge, si shtimi i një përshtatësi për gjetjen e anijeve në një mision vëzhgimi detar. Blloku ndërtues është një paketë misioni, e ndërtuar dhe e nënshkruar në tokë.

  1. Filloni nga paketa aktuale në faqen Ndërtoni një paketë misioni, e cila harton versionin e ri nga i vjetri dhe shënon çdo ndryshim.
  2. Ndryshoni vetëm atë që i nevojitet misionit. Mbajini të qëndrueshme pjesët e mëdha, modelin gjuhësor dhe ontologjinë, kur të jetë e mundur.
  3. Kontrolloni tabelën e vendosjes në çdo hap të degraduar, që çdo pllakë të përshtatet ende me atë që ekzekuton.
  4. Ekzekutoni rastet e testimit në bord të paketës në një stol testimi me të njëjtat pllaka.
  5. Dërgojeni për nënshkrim: nevojiten dy nga tre nënshkrime.
  6. Lëshojeni në një platformë. Ajo vendoset në slotin joaktiv dhe aktivizohet vetëm pasi rastet e saj të testimit të kalojnë në bord.
  7. Shpërndajeni në platformën tjetër pas një jave pa probleme.
Paketat e misionit
Paketat e misionit
Biblioteka e paketave të misionit, me atë që përmban secila paketë dhe platformat që e ekzekutojnë. Vini re versionin më të vjetër të mbajtur në bord për t'u kthyer tek ai, dhe numrin e rasteve të testimit që çdo paketë duhet të kalojë në harduerin e saj.

Në këtë recetë nuk ka komanda; ajo kryhet në faqet Nexus Edge të konsolës. Prova janë rastet e testimit në bord, të cilat duhet të kalojnë të gjitha përpara se paketa të aktivizohet, dhe dy nënshkrimet. Nëse një test dështon në bord, platforma mbetet në paketën e mëparshme dhe dështimi shkarkohet në kalimin e radhës. Instalimi i një pakete në harduer për të cilin nuk është kontrolluar refuzohet me PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge është një shtesë, e licencuar për platformë ose për flotë. Paketat mbeten të vlefshme ndërkohë që një platformë është jashtë kontaktit. Lidhja në ngjitje është e ngushtë, prandaj planifikoni madhësitë në përputhje me të: versioni ynë 1.5 ishte 412 MB, krahasuar me 9.8 GB për një paketë me një model gjuhësor të ri.

9. Një shpërndarje e izoluar nga rrjeti (air-gapped) për një klient

Qëllimi është plugin-i ose paketa juaj e instaluar në një vendndodhje të klientit pa rrjet. Blloqet ndërtuese janë një paketë e vulosur nga @adverant/nexus-sovereign, çelësi juaj i nënshkrimit të versioneve dhe kanalet e versioneve të vetë klientit.

  1. Ndërtoni plugin-in dhe imazhet e tij saktësisht si për një klient të lidhur, me çdo portë të gjelbër.
  2. Krijoni një paketë të vulosur me profilin airgap, që përmban imazhet, migrimet, aftësitë e nënshkruara paraprakisht dhe një SBOM (listë e përbërësve të softuerit) me licencat.
  3. Nënshkruajeni me çelësin tuaj të versioneve Ed25519.
  4. Verifikojeni vetë në një makinë të pastër.
  5. Dërgojeni paketën në media fizike, dhe dërgoni çelësin tuaj publik dhe SHA-256 të paketës nëpërmjet një rruge të veçantë.
  6. Operatori i klientit e verifikon paketën me çelësin tuaj, pastaj e sjell versionin nëpërmjet kanaleve të veta të versioneve.
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 e ndërton paketën nga konfigurimi juaj i paketës. Prova është nexus-airgap verify në anën e klientit. Ai rillogaritë hash-in e çdo skedari, refuzon çdo skedar që manifesti nuk e liston, kërkon një nënshkrues të besuar dhe refuzon një paketë, lista e lejimeve të rrjetit e së cilës nuk është bosh. Një skedar i ndryshuar dështon me BUNDLE_INTEGRITY_VIOLATION. Askush nuk duhet ta çaktivizojë kurrë kontrollin strikt për ta anashkaluar.

Instalimet e izoluara nga rrjeti (air-gapped) janë Enterprise. Asgjë në paketë nuk mund të shkarkojë diçka gjatë instalimit, dhe një model që i nevojitet plugin-it vjen nga serveri i modeleve i vetë klientit nëpërmjet AI (inteligjencës artificiale) Provider Router.

10. Një modul vetëm për Enterprise

Qëllimi është një aftësi e mbyllur dhe e licencuar që lidhet me bërthamën e hapur, si një gjurmë auditimi me ruajtje të gjatë e shitur vetëm për klientët Enterprise. Blloku ndërtues është paketa e ndërfaqes @adverant/nexus-spi, dhe asgjë tjetër nga Community.

  1. Mbani në depon tuaj një kopje të fiksuar në nivel bajti të paketës së ndërtuar të ndërfaqes si paketë lokale file:, me fiksimin e saj SHA256SUMS.
  2. Shkruani një RouteModule (ose një ScreenModule për ekranet e konsolës) mbi të, me grupin e veçorive që shërben.
  3. Ekzekutoni çdo rrugë pas ctx.requireScope, dhe kontrolloni autorizimin e vetë modulit përpara se të përgjigjeni.
  4. Refuzoni me LICENCE_LOCKED kur organizata nuk ka të drejtë, dhe shfaqni pamjen paraprake të veçorisë, kurrë të dhënat e saj.
  5. Mbajeni depon brenda vijës së licencës, pastaj ndërtoni pemën e përbërë të çdo edicioni.
npm ci
npm test
npm run build

Prova është rregulli i vijës së licencës: asnjë import nga një fushë Community përveç paketës së ndërfaqes, asnjë import relativ jashtë depos dhe asnjë varësi file:, link: ose workspace: jashtë saj. Pastaj tri komandat e mësipërme duhet të kalojnë në çdo pemë të përbërë të edicionit, jo vetëm në pemën tuaj të punës. Kapitulli 2.25, Ndërtimi për çdo edicion, përmban skeletin e modulit.

Një modul ngarkohet në një shërbim Community gjatë nisjes, në instalimet licenca e të cilave përmban grupin e tij të veçorive. Pa atë autorizim ai refuzon, kështu që i njëjti build shpërndahet kudo dhe nuk bën asgjë aty ku nuk është i licencuar.

11. Degëzimi ose zgjerimi i bërthamës së hapur

Qëllimi është një ndryshim në vetë Community, i mbajtur në fork-un tuaj ose i kontribuuar mbrapsht. Blloku ndërtues është kodi burimor i Community nën Apache License, Version 2.0.

  1. Bëni fork të depos dhe krijoni një degë nga main.
  2. Preferoni një plugin ose një aftësi nëse ajo që dëshironi mund të jetë e tillë. Një ndryshim në bërthamë është juaji për ta mirëmbajtur në çdo version.
  3. Bëni ndryshimin me teste që dështojnë pa të.
  4. Ekzekutoni kontrollet që ekzekuton projekti përpara se të propozoni diçka.
  5. Ruani skedarin NOTICE, dhe mos përdorni emrat ose markat tregtare të Adverant përtej përmendjes së prejardhjes së punës.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Prova është kalimi i atyre tri kontrolleve, plus dëshmia që çdo test i ri dështonte para ndryshimit tuaj. Mbajeni të vërtetë në fork-un tuaj një veti të bërthamës së hapur: Community ekzekuton një agjent nga fillimi në fund mbi një model lokal pa çelës dhe pa rrjet. Një ndryshim që e prish këtë prish atë që e bën Community të përdorshëm më vete.

Kjo vlen vetëm për Community. Çdo gjë që duhet të mbetet e mbyllur i përket një moduli Enterprise (skenari 10), në mënyrë që vija e licencës të mbetet diku ku kushdo mund ta tregojë.

12. Një aplikacion cloud i edicionit Team

Qëllimi është një aplikacion që klientët Team mund ta instalojnë. Team funksionon vetëm në cloud-in e Adverant, kështu që aplikacioni u arrin vetëm nëpërmjet katalogut. Blloqet ndërtuese janë një plugin dhe një klaster botuesi: klasteri juaj virtual në cloud-in e Adverant me të dhëna shembull.

  1. Ndërtoni dhe testoni në klasterin e botuesit, vetëm me të dhëna shembull.
  2. Deklaroni në manifestin e aplikacionit gjithçka që i nevojitet, dhe asgjë më shumë.
  3. Lëshojeni të nënshkruar, për shqyrtimin nga Adverant dhe për listim në katalog.
  4. Çdo klient e instalon, duke dhënë çdo fushë të deklaruar njësi për njësi.

Prova vjen në dy pjesë. Versioni i nënshkruar dhe i shqyrtuar ju fut në katalog. Pastaj autorizimi i klientit vendos se çfarë mund të arrijë aplikacioni në vendndodhjen e tij, dhe çdo thirrje që ai nuk ka deklaruar refuzohet me CONNECTION_SCOPE_EXCEEDED. Një fushë që mungon mund ta shtoni vetëm në një version të ri që klienti e shqyrton.

Instaloni një shtojcë të palës së tretë
Instaloni një shtojcë të palës së tretë
Një administrator që instalon një plugin të palës së tretë, duke dhënë çdo fushë të deklaruar për njësi dhe duke lënë jashtë njërën. Pllaka tregon një thirrje që plugin-i nuk e ka deklaruar kurrë, të refuzuar.

Një klaster botuesi nuk ka asnjë rrugë drejt ndonjë klienti, dhe kërkimi i të dhënave të një klienti aty refuzohet me TENANT_BOUNDARY. Klientët mund të ndajnë me ju rezultatet e testeve, kurrë të dhënat e tyre. Team përfshin aftësinë e operacioneve të rrjedhave të punës, kështu që nëse aplikacioni juaj përmban rrjedha pune, klientët Team mund t'i promovojnë vetë ato ndërmjet mjediseve.

13. Mbështjellja e një aplikacioni të brendshëm ekzistues si shtojcë

Qëllimi është një aplikacion që kompania juaj e ekzekuton tashmë, i sjellë në Nexus në mënyrë që të trashëgojë hyrjen, izolimin dhe qeverisjen. Blloqet ndërtuese janë aftësia /plugin-create për draftin e parë, dhe mjetet e manifestit dhe portat e SDK-së për ta përfunduar.

  1. Ekzekutoni /plugin-create me depon. Ai analizon kodin dhe zgjedh një strategji mbështjellëse, pastaj gjeneron backend-in, migrimet, ndërfaqen e përdoruesit (UI), manifestin dhe testet.
  2. Ngrijeni manifestin në kontratën v2. migrate shton tri fjalitë e ligjit dhe zhvendos domain në domains[], dhe refuzon të shpikë një pikë hyrjeje.
  3. Zëvendësoni çdo vlerë qiramarrësi që mbështjellësi lexon nga kokat me mbrojtësin e fushës së SDK-së.
  4. Shtoni organization_id, owner_user_id dhe business_unit_id në çdo tabelë, me çelësa primarë që fillojnë me qiramarrësin.
  5. Deklaroni çdo rrugë me të drejtën e saj, dhe instaloni regjistrin e refuzimeve.
  6. Ekzekutoni portat derisa të bëhen të gjelbra.
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

Prova është që nexus-gates del me 0, me scope-adherence, one-fence, migrations-are-scoped, crud-adherence dhe api-contract që kalojnë të gjitha. Prisni që ekzekutimi i parë të dështojë në shumicën e tyre; i yni raportoi çdo rrugë si pa fushë, sepse drafti u besonte kokave që shfletuesi mund t'i vendoste. Portat nuk kanë çelës rregullimi, qëllimisht.

Aplikacionet e mbështjella funksionojnë në çdo edicion. Vendosja bëhet vetëm nëpërmjet kanaleve të versioneve të instalimit, prandaj injoroni çdo skedar vendosjeje që ka shkruar drafti. Puna e izolimit është ajo ku shkon koha: planifikoni ditë për një aplikacion real, jo orë.