Versija 1.0.0-alpha.1jaunākā
2.27. nodaļa
Būvēšanas scenāriji
Trīspadsmit būvējumu rokasgrāmata — no vienas prasmes līdz piegādei izolētā (air-gapped) vidē. Katra recepte sniedz mērķi, pamatelementus, darbības un komandas, pārbaudes posmu, kas apliecina tās darbību, un to, kas mainās atkarībā no izdevuma un piegādes veida.
Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

Šīs ir receptes, pie kurām es ķeros, kad kāds uzņēmumā Corrán Orbital vai pie klienta saka: "mēs vēlamies, lai Nexus dara X". Katra no tām ir apzināti īsa. Darbību pamatojums ir izklāstīts iepriekšējās nodaļās: 2.20. nodaļā "Prasmes" un 2.21. nodaļā "Plugin SDK", kas aptver programmatūras izstrādes rīkkopu, pēc tam 2.23. nodaļā "Nozaru pakotnes" un trīs nākamajās nodaļās par izstrādi. Šeit jūs atradīsiet mērķi, izmantojamos pamatelementus, darbības, komandas, pārbaudes vārtus, kas apliecina, ka viss izdevies, kā arī piezīmes par izdevumu un piegādi.
Vissvarīgākie ir vārti. Recepte ir pabeigta, kad tās vārti ir zaļi. Katri vārti šajā nodaļā ir kaut kas, ko varat palaist jūs pats vai ko jūsu vietā palaiž platforma, un katri no tiem beidzas ar kodu, kas nav nulle, vai atteikumu ar kodu, ja nosacījums nav izpildīts.
| Scenārijs | Galvenais pamatelements | Vārti, kas to apliecina | Redakcija |
|---|---|---|---|
| Jauna Skills Engine prasme | SKILL.md pakotne |
skill:validate bez kļūdām |
Community un Enterprise |
Manifesta prasme ar host_callback |
Spraudņa manifests skills[] |
create-nexus-plugin validate un nexus-gates |
Community un Enterprise |
| Esošas pakotnes paplašināšana | pack.json ar inherits |
Skatījuma politikas pārbaude pilota vārtos | Enterprise un pakotnes licence |
| Jauna pakotne no nulles | Nozares pakotnes zelta ceļš | Sagatavošanas un pilota vārti | Enterprise |
| Datu savienotājs | plugin_queue prasme |
validate, nexus-gates, izejošās plūsmas atteikums |
Community un Enterprise |
| MCP (Model Context Protocol) rīks | Manifests mcpTools[] |
validate (bez augstākā līmeņa kombinatoriem) |
Community un Enterprise |
| Baltās etiķetes veikals | Manifests domains un branding |
scope-adherence publiskā maršruta noteikums |
Enterprise un Storefront papildinājums |
| Edge misijas pakotne | Misijas pakotne | Testa gadījumi uz borta, divi no trim parakstiem | Enterprise un Nexus Edge papildinājums |
| Piegāde izolētā vidē | Noslēgta pakete | nexus-airgap verify |
Enterprise |
| Tikai Enterprise modulis | @adverant/nexus-spi |
Licences robežas vārti, izdevumu būvējumi | Enterprise |
| Atvērtā kodola atzarošana vai paplašināšana | Community pirmkods | Testi, lint un tipu pārbaude | Community |
| Team izdevuma mākoņlietotne | Izdevēja klasteris | Parakstīts laidiens, pārskatīšana, piešķiršana klientam | Team |
| Esošas iekšējās lietotnes ietīšana | /plugin-create |
migrate, validate, nexus-gates |
Community un Enterprise |
1. Jauna Skills Engine prasme
Mērķis ir atkārtoti izmantojama instrukcija, ko var izpildīt asistents, aģenti, darbplūsmas un izstrādātāju rīki, piemēram, muitas deklarācijas pārbaude atbilstoši tās noteikumiem. Jūsu pamatelementi ir SKILL.md pakotne mapē, kas nosaukta prasmes vārdā, neobligāts skill.yaml aktivizētājiem un birkām, kā arī neobligāta scripts/ mape, kas iekļauta kopā ar to.
- Izveidojiet
skills/<slug>/un uzrakstietSKILL.mdar frontmatter:name(kebab-case, vienāds ar mapes nosaukumu),description(līdz 500 rakstzīmēm),allowed-toolsun pēc izvēlestriggers,capabilitiesunversion. - Uzrakstiet pamattekstu modelim: kad izmantot prasmi, tās darbības, piemērus un to, ko tā nekad nedrīkst darīt.
- Pievienojiet testa gadījumus. Iekļaujiet vienu ar ievadē iestrādātu instrukciju, kurai prasme nedrīkst sekot.
- Validējiet, apskatiet augšupielādes plānu un tad augšupielādējiet.
- Publicējiet. Prasme, kas pievieno rakstīšanas rīku, tiek aizturēta, līdz to ar piekļuves atslēgām apstiprina divas konkrētas personas, un ierosinātājs nevar apstiprināt pats savas izmaiņas.
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-filingVārti ir skill:validate, kam jāuzrāda nulle kļūdu, pirms kaut ko var publicēt. Bloķējošās kļūdas ir trūkstošs nosaukums vai apraksts un dublēts slug vai darba tips. Jau publicēta satura augšupielāde atgriež esošo versiju (CONTENT_HASH_ALREADY_PUBLISHED), tāpēc augšupielādi var droši atkārtot.
Community izdevumā ir pieejams viss veidotājs, bibliotēka, versijas, atgriešanās pie iepriekšējās, imports un testi. Enterprise izdevumā publicēšana iziet arī ēnas un canary posmus: apstiprinātā versija vispirms darbojas ēnas režīmā, tad vienā vienībā aiz nosauktiem vārtiem, tad visiem, un tā pati apstājas, ja kādi vārti nav izpildīti. Klientam izolētā vidē prasmes tiek piegādātas iepriekš parakstītas noslēgtajā paketē (9. scenārijs).
2. Manifesta prasme ar host_callback
Mērķis ir deterministiska skaitļošana jūsu paša spraudnī, ko platforma var nosūtīt izpildei, piemēram, novirzes ieraksta atvēršana pēc rādījuma. Jūs izmantosiet rindu manifesta skills[] ar līmeni host_callback un /internal maršrutu savā aizmugursistēmā, ko aizsargā SDK pakalpojuma aizsargs.
- Deklarējiet prasmi:
idformātā lower_snake,tier: "host_callback",classification, kas nepārsniedz jūsu spraudņa uzticamības griestus,inputSchema,outputSchemauntimeoutMsno 1 sekundes līdz 6 stundām. - Aizpildiet
hostCallback: sava Service nosaukumu, tā portu, relatīvu ceļu, piemēram,/internal/skills/excursion_open, abus baitu ierobežojumus (maxRequestBytesunmaxResponseBytes) untenantHeader: "X-Organization-ID". - Deklarējiet maršrutu
api.endpoints[]arauth: "service-key"vaiauth: "internal"un aizsargājiet to arrequireServicevaiserviceMiddleware, nekad ar lietotāja tvēruma aizsargu. - Validējiet, palaidiet vārtus un ļaujiet ieviešanas procesam sinhronizēt prasmes ar reģistru, izmantojot
compileRegistry. Reģistra SQL jūs nekad nerakstāt manuāli.
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 pirms jebkādas sinhronizācijas piemēro pašas reģistra sinhronizācijas noteikumus, un katrs atteikums tiek sniegts ar saņēmēja kodu. Ceļš ar shēmu, // vai atpakaļvērsto slīpsvītru tiek atteikts kā citas izcelsmes ceļš. Trūkstošs baitu ierobežojums ir ENDPOINT_BYTE_CAP_REQUIRED, lauks no cita līmeņa ir FIELD_NOT_FOR_TIER, un taimauts ārpus diapazona ir TIMEOUT_OUT_OF_BOUNDS. Pēc tam nexus-gates pārbauda, vai /internal maršrutam ir pakalpojuma aizsargs un vai tas ir deklarēts kā internal vai service-key. Šis vārtu pāris ir pierādījums.
Sinhronizācija ir deklaratīva. Katru reizi nosūtiet pilnu prasmju kopu, jo prasme, kuru izlaižat, tiek atspējota, un pārtrauciet izvietošanas soli ar kļūdu pie jebkura statusa, kas nav 200. Enterprise izdevumā spraudņa sinhronizācija tiek pārbaudīta kopumā: ja kaut viena prasme pārkāpj noteikumu, nekas no šīs sinhronizācijas netiek pieņemts (PLUGIN_SYNC_ALL_OR_NOTHING), un turpina darboties iepriekšējā versija. Spraudnis ar kopienas uzticamības līmeni nevar izmantot līmeņus, kas sasniedz modeli, tool_using un llm_only; tiem nepieciešama uzticamība core vai verified.
3. Esošas pakotnes paplašināšana
Mērķis ir jauna nozare vai apakšnozare, kas lielākoties atkārtoti izmanto esošu pakotni, piemēram, kreditēšana un karšu strīdi, balstoties uz Insurance pakotnes struktūru. Pamatelements ir pack.json, kas inherits norāda savu vecākpakotni un pievieno tikai savus skatījumu klasterus un terminus.
- Sāciet pakotni ar nozares pakotnes zelta ceļu, pēc tam iestatiet
inheritsuz vecākpakotnes id. - Pievienojiet savus
lensklasterus, katru ar tā vietām, mērķi un leksikona atsauci. - Pievienojiet savus terminus leksikonam, katram ar vienkāršu skaidrojumu. Atzīmējiet terminu kā
exact, ja tas jārāda tieši tā, kā rakstīts. - Atkārtoti izmantojiet koplietojamos skatījumus, nevis veidojiet savus: regulējums, kas nepieciešams vairākām pakotnēm, piemēram, ārpakalpojumu tehnoloģiju reģistrs, ir viens koplietojams skatījums.
- Pārbaudiet licenču ķēdi. Jūsu pakotne manto vecākpakotnes papildinājumu prasības.
- Priekšskatiet katru skatījumu konkrētas personas lomā sintētiskā atzarā.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Pierādījums ir pilota vārtu politikas pārbaude, kas apstiprina, ka katrs skatījums tikai sašaurina savu bāzi un pēc noklusējuma neattēlo personiskos laukus. Skatījums, kas mēģina rādīt to, ko tā bāze slēpj, tiek atteikts ar LENS_CANNOT_WIDEN. Licencēšanas pusē konsole atsakās izsniegt licenci jūsu pakotnei bez papildinājumiem, kas nepieciešami tās vecākpakotnei; Insurance pakotnei nepieciešamas lēmumu telpas un noslēgti ieraksti.
Nozaru pakotnes ir Enterprise funkcija un tiek licencētas katra atsevišķi. Pakotnes tālruņa ekrāniem nepieciešams arī Mobile apps papildinājums. Pakārtotā pakotne nevar mainīt čaulu, komponentus vai rakstības noteikumus.
4. Jauna pakotne no nulles
Mērķis ir vienas nozares skats uz Nexus: tās zināšanu modelis, skatījumi katrai lomai, pierādījumi, ko pieprasa tās noteikumi, un spraudnis, kas uztur tās datus aktuālus. 2.24. nodaļa "Pielāgotas vertikāles izveide no sākuma līdz beigām" pilnībā apraksta šo izveidi; šeit ir saīsinātā versija.
- Palaidiet nozares pakotnes zelta ceļu un aprakstiet pakotni: mērķi, vienības, bāzes modeli un noteikumus, ko tā atspoguļo.
- Izveidojiet zināšanu modeli uz bāzes modeļa un klasificējiet katru īpašību, to pievienojot.
- Izlasiet plānu, apstipriniet tā nospiedumu ar savu piekļuves atslēgu un izveidojiet.
- Veidojiet skatījumus Lens builder, katru sašaurinot no bāzes skatījuma.
- Uzrakstiet spraudni un visas Skills Engine prasmes, kas nepieciešamas pakotnei.
- Ģenerējiet sintētiskus datus no sākumvērtības ar jums svarīgajiem netipiskajiem gadījumiem un priekšskatiet katru skatījumu konkrētas personas lomā.
- Paaugstiniet no izstrādes vides uz sagatavošanas vidi, uz pilota vienību un pēc tam uz visām vienībām.
Pierādījums ir paaugstināšanas vārti: visi testi sintētiskajos atzaros ir izpildīti, lai nonāktu sagatavošanas vidē, pēc tam divi recenzenti, kas nav autori, pēc tam 14 dienas pilotā ar kļūdu līmeni zem 1 no 1 000. Nevienu soli nevar izlaist (GATE_CANNOT_BE_SKIPPED). Pakotnes ir Enterprise funkcija. Community izdevumā nozares pakotnes zelta ceļš netiek piedāvāts.
5. Datu savienotājs
Mērķis ir dati no ārējas sistēmas, kas pēc grafika plūst jūsu spraudņa tabulās, piemēram, vārtu notikumi no termināļa operētājsistēmas. Pamatelementi ir plugin_queue prasme, darbinieks, kas izgūst no jūsu rindas, migrācija mērķa tabulai un manifestā deklarēta izejošā adrese.
- Deklarējiet
plugin_queueprasmi arqueueName, kas rakstīts kā<plugin name>.<name>. Kols nav atļauts, un nosaukumam jābūt manifestā, jo orķestrētājs ievieto darbus rindā tieši tajā. - Uzrakstiet darbinieku, kas izgūst no rindas un izsauc ārējo sistēmu.
- Deklarējiet ārējās sistēmas adresi kā izejošo adresi. Viss, kas nav norādīts, tiek bloķēts.
- Glabājiet saņemto savā shēmā, katrā rindā ar
organization_id,owner_user_idunbusiness_unit_id. - Nolasiet ārējās sistēmas akreditācijas datus pēc nosaukuma no vides un norādiet mainīgo
scripts/ci/required-env. - Nosūtiet izguves caur UNO, darbplūsmu dzinēju, nekad ar taimeri, kas tieši izsauc dzinējus.
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 pārbauda rindas nosaukumu un taimautu atbilstoši reģistra sinhronizācijas noteikumiem. Trīs vārti apliecina, ka nav modeļa akreditācijas datu, nav tiešas skaitļošanas un tabulai ir pareizs tvērums. Pirms nosūtīšanas palaidiet pilno nexus-gates, jo --only sašaurina izpildi un to norāda kopsavilkumā. Izpildes laikā izsaukums uz adresi, kuru manifests nedeklarēja, tiek apturēts malā ar EGRESS_NOT_DECLARED.
Platformas pašas savienotāji ar diskiem, wiki, pasta krātuvēm un mantotajām sistēmām, ar izmaiņu tveršanu un izcelsmes izsekošanu, ir pieejami ar Data connectors papildinājumu. Paša veidots savienotājs ir spraudnis un darbojas jebkurā izdevumā. Izejošās adreses pievienošana vēlākā laidienā ir paplašināšana, kas tiek aizturēta, līdz to pieņem divi recenzenti.
6. MCP rīks
Mērķis ir rīks, ko var izsaukt Claude Code, aģenti un citi MCP (Model Context Protocol) klienti, piemēram, kuģa inspekciju vēstures uzmeklēšana. Pamatelements ir ieraksts manifesta mcpTools[] ar name, description un inputSchema.
- Nosauciet rīku un aprakstiet to vienkārši. Apraksts ir tas, ko modelis lasa, lai izlemtu, vai to izsaukt.
- Uzrakstiet
inputSchemakā vienu objekta shēmu. NeievietojietoneOf,allOfvaianyOftās augstākajā līmenī. - Turiet maršrutu, kas apkalpo rīku, aiz tvēruma aizsarga, tāpat kā jebkuru citu
/apimaršrutu, lai nomnieka piederība tiktu noteikta no izsaucēja marķiera. - Validējiet manifestu.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonPierādījums ir validate: augstākā līmeņa kombinators tiek atteikts jau izveides laikā, jo izpildes laikā tas liktu rīkam neizdoties katram MCP apakšaģentam, kas to importē, un rīks pastāvētu, bet neviens nevarētu to izsaukt.
Enterprise izdevumā katrs rīks, ko var izsaukt IDE (integrētā izstrādes vide), ir norādīts Workbench rīku katalogā ar tā līmeni, norādi, vai tas veic izmaiņas, piesaistītu nospiedumu un lomām, kas drīkst to izmantot. Ja jūsu rīka apraksts jaunā laidienā mainās, katalogs aiztur rīku, līdz izmaiņas pārskata cilvēks. Tas ir apzināti: mainīts apraksts ir veids, kā rīks var sākt prasīt modelim kaut ko, ko tam nevajadzētu. Izsaukums uz jebko ārpus izsaucēja atļaujas tiek atteikts ar CONNECTION_SCOPE_EXCEEDED.
7. Baltā marķējuma (white-label) veikals
Mērķis ir lietotne, ko izmanto jūsu klienta paša klienti, klienta domēnā un klienta zīmolā, bez jebkādām Adverant pēdām. Pamatelementi ir manifesta domains un branding bloki, SDK pierakstīšanās palīgrīki un klienta Storefront / white-label papildinājums.
- Ievietojiet klienta domēnu
domains[]kāprimary, ar visiemaliases. - Aizpildiet
branding:appName,tagline,primaryColor,accentColor,passkeyRpId, kas vienāds ar domēnu, unoauthClientRef. - Pierakstiet lietotājus, izmantojot SDK pierakstīšanās palīgrīkus, un precīzi deklarējiet to divus publiskos maršrutus ar
auth: "public"unallowAnonymous: true. - Sūtiet katru priekšgalsistēmas izsaukumu caur aizmugursistēmas priekšgalam atļauto sarakstu starpniekserveri. Nekad neievietojiet pakalpojuma adresi klientā.
- Atstājiet maksājumus klienta administratora ziņā, kurš pievieno maksājumu vārtejas un iestata zīmolota norēķinu procesu.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractPierādījums ir scope-adherence. Tas pieļauj neaizsargātu /api maršrutu tikai tad, ja manifests deklarē tieši šo metodi un ceļu kā publisku un ceļš ir viens no pierakstīšanās maršrutiem; jebkura cita publiska deklarācija neizdodas un nosauc abus atļautos ceļus. Pēc tam api-contract salīdzina deklarētos maršrutus ar faktiskajiem abos virzienos. definePlugin arī atsaka frontend.basePath, kas nav relatīvs tās pašas izcelsmes ceļš.
Baltā zīmola funkcija ir Enterprise papildinājums Storefront / baltais zīmols, kas licencē arī maksājumus. Kartes dati nekad nenonāk Nexus. Zīmolu pārvalda klienta administrators, un platforma to nosaka pēc organizācijas, nevis pēc jūsu koda.
8. Edge misijas pakotne
Mērķis ir jauna vai atjaunināta misija satelītam vai dronam, kurā darbojas Nexus Edge, piemēram, kuģu meklēšanas adaptera pievienošana jūras novērošanas misijai. Pamatelements ir misijas pakotne, kas tiek izveidota un parakstīta uz zemes.
- Sāciet no pašreizējās pakotnes lapā Misijas pakotnes izveide, kas sagatavo jauno versiju no vecās un atzīmē katras izmaiņas.
- Mainiet tikai to, kas misijai nepieciešams. Lielās daļas, valodas modeli un ontoloģiju, ja iespējams, saglabājiet nemainīgas.
- Pārbaudiet izvietojuma tabulu katrā degradācijas solī, lai katra plate joprojām atbilstu tam, ko tā izpilda.
- Izpildiet pakotnes iebūvētos testa gadījumus uz testa stenda ar tām pašām platēm.
- Nosūtiet to parakstīšanai: nepieciešami divi no trim parakstiem.
- Izlaidiet to vienā platformā. Tā tiek ievietota neaktīvajā slotā un tiek ieslēgta tikai pēc tam, kad tās testa gadījumi uz borta ir izpildīti sekmīgi.
- Pēc nedēļas bez problēmām izvērsiet to nākamajā platformā.
Šajā receptē nav komandu; tā tiek izpildīta konsoles Nexus Edge lapās. Pierādījums ir testa gadījumi uz borta, kuriem visiem jābūt izpildītiem sekmīgi, pirms pakotne tiek ieslēgta, un divi paraksti. Ja tests uz borta neizdodas, platforma paliek pie iepriekšējās pakotnes, un kļūme tiek nosūtīta lejup nākamajā pārlidojumā. Pakotnes instalēšana uz aparatūras, kurai tā nav pārbaudīta, tiek atteikta ar PACK_NOT_CHECKED_FOR_HARDWARE.
Nexus Edge ir papildinājums, ko licencē katrai platformai vai katrai flotei. Pakotnes paliek derīgas, kamēr platformai nav sakaru. Augšupsaite ir šaura, tāpēc plānojiet izmērus atbilstoši tai: mūsu 1.5 laidiens bija 412 MB, salīdzinot ar 9.8 GB pakotnei ar jaunu valodas modeli.
9. Piegāde klientam izolētā (air-gapped) vidē
Mērķis ir jūsu spraudnis vai pakotne, kas instalēta klienta vietnē bez tīkla. Pamatelementi ir noslēgts komplekts no @adverant/nexus-sovereign, jūsu laidienu parakstīšanas atslēga un klienta paša laidienu kanāli.
- Izveidojiet spraudni un tā attēlus tieši tāpat kā klientam ar tīkla savienojumu, ar visām pārbaudēm zaļā statusā.
- Izveidojiet noslēgtu komplektu ar profilu
airgap, kas satur attēlus, migrācijas, iepriekš parakstītas prasmes un SBOM (programmatūras materiālu sarakstu) ar licencēm. - Parakstiet to ar savu Ed25519 laidienu atslēgu.
- Pārbaudiet to paši tīrā datorā.
- Nosūtiet komplektu datu nesējā, bet savu publisko atslēgu un komplekta SHA-256 nosūtiet pa citu ceļu.
- Klienta operators pārbauda komplektu ar jūsu atslēgu un pēc tam ievieš laidienu, izmantojot savus laidienu kanālus.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle izveido komplektu no jūsu komplekta konfigurācijas. Pierādījums ir nexus-airgap verify klienta pusē. Tas atkārtoti aprēķina katra faila jaucējvērtību, noraida jebkuru failu, kas nav norādīts manifestā, pieprasa uzticamu parakstītāju un atsakās pieņemt komplektu, kura tīkla atļauju saraksts nav tukšs. Mainīts fails izraisa kļūmi BUNDLE_INTEGRITY_VIOLATION. Neviens nekad nedrīkst izslēgt stingro pārbaudi, lai to apietu.
Instalācijas bez tīkla savienojuma ir Enterprise. Nekas komplektā nedrīkst instalēšanas laikā neko lejupielādēt, un modelis, kas nepieciešams spraudnim, tiek iegūts no klienta paša modeļu servera, izmantojot MI (mākslīgā intelekta) Provider Router.
10. Tikai Enterprise paredzēts modulis
Mērķis ir slēgta, licencēta funkcionalitāte, kas pievienojas atvērtajam kodolam, piemēram, ilgstošas glabāšanas audita pieraksts, ko pārdod tikai Enterprise klientiem. Pamatelements ir saskarnes pakotne @adverant/nexus-spi un nekas cits no Community.
- Glabājiet savā repozitorijā izveidotās saskarnes pakotnes kopiju, kas piesaistīta baitu līmenī, kā lokālu
file:pakotni ar tāsSHA256SUMSpiesaisti. - Uzrakstiet
RouteModule(vaiScreenModulekonsoles ekrāniem), balstoties uz to, ar funkciju grupu, kuru tas apkalpo. - Izpildiet katru maršrutu aiz
ctx.requireScopeun pirms atbildes pārbaudiet paša moduļa atļauju. - Atsakiet ar
LICENCE_LOCKED, ja organizācijai nav tiesību, un attēlojiet funkcijas priekšskatījumu, nekad tās datus. - Uzturiet repozitoriju atbilstoši licences robežai, pēc tam izveidojiet katra izdevuma salikto koku.
npm ci
npm test
npm run buildPierādījums ir licences robežas noteikums: nekāda importa no Community tvēruma, izņemot saskarnes pakotni, nekāda relatīva importa ārpus repozitorija un nekādu file:, link: vai workspace: atkarību ārpus tā. Pēc tam trim iepriekš minētajām komandām jābūt izpildītām sekmīgi katrā saliktajā izdevuma kokā, nevis tikai jūsu darba kokā. 2.25. nodaļā Veidošana katram izdevumam ir moduļa skelets.
Modulis tiek ielādēts Community servisā startēšanas laikā tajās instalācijās, kuru licence ietver tā funkciju grupu. Bez šīs atļaujas tas atsakās darboties, tāpēc viens un tas pats būvējums tiek piegādāts visur un neko nedara tur, kur tas nav licencēts.
11. Atvērtā kodola atzarošana vai paplašināšana
Mērķis ir izmaiņas pašā Community, kas saglabātas jūsu atzarojumā vai nodotas atpakaļ projektam. Pamatelements ir Community pirmkods saskaņā ar Apache License, Version 2.0.
- Izveidojiet repozitorija atzarojumu un zaru no
main. - Dodiet priekšroku spraudnim vai prasmei, ja to, ko vēlaties, var realizēt šādā veidā. Kodola izmaiņas jums būs jāuztur katrā laidienā.
- Veiciet izmaiņas ar testiem, kas bez tām neizdodas.
- Pirms kaut ko piedāvājat, izpildiet pārbaudes, ko izpilda projekts.
- Saglabājiet NOTICE failu un neizmantojiet Adverant nosaukumus vai preču zīmes, izņemot norādi, no kurienes darbs ir cēlies.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckPierādījums ir šo trīs pārbaužu sekmīga izpilde, kā arī apliecinājums, ka katrs jaunais tests pirms jūsu izmaiņām neizdevās. Saglabājiet savā atzarojumā vienu atvērtā kodola īpašību: Community izpilda aģentu pilnībā ar lokālu modeli bez atslēgas un bez tīkla. Izmaiņas, kas to sabojā, sabojā to, kas padara Community lietojamu patstāvīgi.
Tas attiecas tikai uz Community. Viss, kam jāpaliek slēgtam, tā vietā pieder Enterprise modulim (10. scenārijs), lai licences robeža paliktu vietā, uz kuru ikviens var norādīt.
12. Team izdevuma mākoņlietotne
Mērķis ir lietotne, ko Team klienti var instalēt. Team darbojas tikai Adverant mākonī, tāpēc lietotne tos sasniedz tikai caur katalogu. Pamatelementi ir spraudnis un izdevēja klasteris: jūsu pašu virtuālais klasteris Adverant mākonī ar parauga datiem.
- Veidojiet un testējiet izdevēja klasterī, izmantojot tikai parauga datus.
- Deklarējiet lietotnes manifestā visu, kas tai nepieciešams, un neko vairāk.
- Izlaidiet to parakstītu Adverant pārskatīšanai un iekļaušanai katalogā.
- Katrs klients to instalē, piešķirot katru deklarēto tvērumu katrai vienībai atsevišķi.
Pierādījums sastāv no divām daļām. Parakstīts, pārskatīts laidiens nodrošina iekļaušanu katalogā. Pēc tam klienta piešķirtā atļauja nosaka, kam lietotne var piekļūt viņa vietnē, un jebkurš izsaukums, ko tā nav deklarējusi, tiek atteikts ar CONNECTION_SCOPE_EXCEEDED. Trūkstošu tvērumu varat pievienot tikai jaunā laidienā, ko klients pārskata.
Izdevēja klasterim nav maršruta uz nevienu klientu, un pieprasījums pēc klienta datiem tajā tiek atteikts ar TENANT_BOUNDARY. Klienti var kopīgot ar jums testu rezultātus, nekad savus datus. Team ietver darbplūsmu operāciju funkcionalitāti, tāpēc, ja jūsu lietotne piegādā darbplūsmas, Team klienti var paši tās pārvietot starp vidēm.
13. Esošas iekšējās lietotnes iekapsulēšana spraudnī
Mērķis ir lietotne, ko jūsu uzņēmums jau izmanto, ievesta Nexus, lai tā mantotu pierakstīšanos, izolāciju un pārvaldību. Pamatelementi ir prasme /plugin-create pirmajam melnrakstam un SDK manifesta rīki un pārbaudes tā pabeigšanai.
- Izpildiet
/plugin-createar repozitoriju. Tā analizē kodu un izvēlas ietīšanas stratēģiju, pēc tam ģenerē aizmugursistēmu, migrācijas, lietotāja saskarni (UI), manifestu un testus. - Paaugstiniet manifestu līdz v2 līgumam.
migratepievieno trīs likuma teikumus un pārvietodomainuzdomains[], un tas atsakās izdomāt ieejas punktu. - Aizstājiet jebkuru nomnieka vērtību, ko ietinējs nolasa no galvenēm, ar SDK tvēruma aizsargu.
- Pievienojiet
organization_id,owner_user_idunbusiness_unit_idkatrai tabulai ar primārajām atslēgām, kas sākas ar nomnieku. - Deklarējiet katru maršrutu ar tā tiesībām un instalējiet atteikumu žurnālu.
- Izpildiet pārbaudes, līdz tās ir zaļas.
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-testPierādījums ir nexus-gates izeja ar kodu 0, kad scope-adherence, one-fence, migrations-are-scoped, crud-adherence un api-contract visas ir izpildītas sekmīgi. Sagaidiet, ka pirmajā izpildē lielākā daļa no tām neizdosies; mūsējā ziņoja, ka neviens maršruts nav tvērumā, jo melnraksts uzticējās galvenēm, kuras varēja iestatīt pārlūkprogramma. Pārbaudēm apzināti nav labošanas slēdža.
Ietītās lietotnes darbojas jebkurā izdevumā. Izvietošana notiek tikai caur instalācijas laidienu kanāliem, tāpēc ignorējiet visus izvietošanas failus, ko uzrakstīja melnraksts. Visvairāk laika aizņem izolācijas darbs: reālai lietotnei plānojiet dienas, nevis stundas.


