PieteiktiesPieteikt konsultāciju

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ā

25 minūšu lasīšana

Šī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
Lēmumu koks, ko lasa no augšas uz leju. Pirmais rombs jautā "Vai tam nepieciešams kods, kas darbojas visu laiku?". "Nē" ved uz rombu "Vai tās ir instrukcijas asistentam?", kura "Jā" beidzas ar "Skills Engine prasme" un "Nē" beidzas ar "Skats esošai pakotnei". "Jā" ved uz rombu "Vai tas ir vienas nozares skats uz platformu?", kura "Jā" beidzas ar "Nozares pakotne (ar tās spraudni)" un "Nē" ved uz pēdējo rombu "Vai tam jāpaliek slēgtam un licencētam?", kas beidzas ar "Enterprise modulis" atbildei "Jā" un "Spraudnis" atbildei "Nē".
No kura pamatelementa sākt.

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.

  1. Izveidojiet skills/<slug>/ un uzrakstiet SKILL.md ar frontmatter: name (kebab-case, vienāds ar mapes nosaukumu), description (līdz 500 rakstzīmēm), allowed-tools un pēc izvēles triggers, capabilities un version.
  2. Uzrakstiet pamattekstu modelim: kad izmantot prasmi, tās darbības, piemērus un to, ko tā nekad nedrīkst darīt.
  3. Pievienojiet testa gadījumus. Iekļaujiet vienu ar ievadē iestrādātu instrukciju, kurai prasme nedrīkst sekot.
  4. Validējiet, apskatiet augšupielādes plānu un tad augšupielādējiet.
  5. 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-filing

Vā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.

  1. Deklarējiet prasmi: id formātā lower_snake, tier: "host_callback", classification, kas nepārsniedz jūsu spraudņa uzticamības griestus, inputSchema, outputSchema un timeoutMs no 1 sekundes līdz 6 stundām.
  2. Aizpildiet hostCallback: sava Service nosaukumu, tā portu, relatīvu ceļu, piemēram, /internal/skills/excursion_open, abus baitu ierobežojumus (maxRequestBytes un maxResponseBytes) un tenantHeader: "X-Organization-ID".
  3. Deklarējiet maršrutu api.endpoints[] ar auth: "service-key" vai auth: "internal" un aizsargājiet to ar requireService vai serviceMiddleware, nekad ar lietotāja tvēruma aizsargu.
  4. 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-test

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

Spraudņu un MCP sinhronizācija
Spraudņu un MCP sinhronizācija
Spraudņi, kas ienes prasmes, un tas, kas tika pārbaudīts katrā sinhronizācijā. Ievērojiet spraudni, kura sinhronizācija tika atteikta kopumā, jo viena no tā piecām prasmēm izmantoja līmeni, ko drīkst mitināt tikai platforma, kamēr tā iepriekšējā versija turpināja darboties.

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.

  1. Sāciet pakotni ar nozares pakotnes zelta ceļu, pēc tam iestatiet inherits uz vecākpakotnes id.
  2. Pievienojiet savus lens klasterus, katru ar tā vietām, mērķi un leksikona atsauci.
  3. 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.
  4. 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.
  5. Pārbaudiet licenču ķēdi. Jūsu pakotne manto vecākpakotnes papildinājumu prasības.
  6. 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.

  1. Palaidiet nozares pakotnes zelta ceļu un aprakstiet pakotni: mērķi, vienības, bāzes modeli un noteikumus, ko tā atspoguļo.
  2. Izveidojiet zināšanu modeli uz bāzes modeļa un klasificējiet katru īpašību, to pievienojot.
  3. Izlasiet plānu, apstipriniet tā nospiedumu ar savu piekļuves atslēgu un izveidojiet.
  4. Veidojiet skatījumus Lens builder, katru sašaurinot no bāzes skatījuma.
  5. Uzrakstiet spraudni un visas Skills Engine prasmes, kas nepieciešamas pakotnei.
  6. Ģ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ā.
  7. 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.

  1. Deklarējiet plugin_queue prasmi ar queueName, 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ā.
  2. Uzrakstiet darbinieku, kas izgūst no rindas un izsauc ārējo sistēmu.
  3. Deklarējiet ārējās sistēmas adresi kā izejošo adresi. Viss, kas nav norādīts, tiek bloķēts.
  4. Glabājiet saņemto savā shēmā, katrā rindā ar organization_id, owner_user_id un business_unit_id.
  5. Nolasiet ārējās sistēmas akreditācijas datus pēc nosaukuma no vides un norādiet mainīgo scripts/ci/required-env.
  6. 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-env

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

  1. Nosauciet rīku un aprakstiet to vienkārši. Apraksts ir tas, ko modelis lasa, lai izlemtu, vai to izsaukt.
  2. Uzrakstiet inputSchema kā vienu objekta shēmu. Neievietojiet oneOf, allOf vai anyOf tās augstākajā līmenī.
  3. Turiet maršrutu, kas apkalpo rīku, aiz tvēruma aizsarga, tāpat kā jebkuru citu /api maršrutu, lai nomnieka piederība tiktu noteikta no izsaucēja marķiera.
  4. Validējiet manifestu.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Pierā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.

  1. Ievietojiet klienta domēnu domains[] kā primary, ar visiem aliases.
  2. Aizpildiet branding: appName, tagline, primaryColor, accentColor, passkeyRpId, kas vienāds ar domēnu, un oauthClientRef.
  3. Pierakstiet lietotājus, izmantojot SDK pierakstīšanās palīgrīkus, un precīzi deklarējiet to divus publiskos maršrutus ar auth: "public" un allowAnonymous: true.
  4. Sūtiet katru priekšgalsistēmas izsaukumu caur aizmugursistēmas priekšgalam atļauto sarakstu starpniekserveri. Nekad neievietojiet pakalpojuma adresi klientā.
  5. 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-contract

Pierā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.

  1. 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.
  2. Mainiet tikai to, kas misijai nepieciešams. Lielās daļas, valodas modeli un ontoloģiju, ja iespējams, saglabājiet nemainīgas.
  3. Pārbaudiet izvietojuma tabulu katrā degradācijas solī, lai katra plate joprojām atbilstu tam, ko tā izpilda.
  4. Izpildiet pakotnes iebūvētos testa gadījumus uz testa stenda ar tām pašām platēm.
  5. Nosūtiet to parakstīšanai: nepieciešami divi no trim parakstiem.
  6. 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.
  7. Pēc nedēļas bez problēmām izvērsiet to nākamajā platformā.
Misiju pakotnes
Misiju pakotnes
Misiju pakotņu bibliotēka, kurā redzams, ko satur katra pakotne un kurās platformās tā darbojas. Ievērojiet vecāko versiju, kas tiek saglabāta uz borta, lai varētu atgriezties pie tās, un testa gadījumu skaitu, kas katrai pakotnei jāizpilda uz savas aparatūras.

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

  1. Izveidojiet spraudni un tā attēlus tieši tāpat kā klientam ar tīkla savienojumu, ar visām pārbaudēm zaļā statusā.
  2. 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.
  3. Parakstiet to ar savu Ed25519 laidienu atslēgu.
  4. Pārbaudiet to paši tīrā datorā.
  5. Nosūtiet komplektu datu nesējā, bet savu publisko atslēgu un komplekta SHA-256 nosūtiet pa citu ceļu.
  6. 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 airgap

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

  1. Glabājiet savā repozitorijā izveidotās saskarnes pakotnes kopiju, kas piesaistīta baitu līmenī, kā lokālu file: pakotni ar tās SHA256SUMS piesaisti.
  2. Uzrakstiet RouteModule (vai ScreenModule konsoles ekrāniem), balstoties uz to, ar funkciju grupu, kuru tas apkalpo.
  3. Izpildiet katru maršrutu aiz ctx.requireScope un pirms atbildes pārbaudiet paša moduļa atļauju.
  4. Atsakiet ar LICENCE_LOCKED, ja organizācijai nav tiesību, un attēlojiet funkcijas priekšskatījumu, nekad tās datus.
  5. Uzturiet repozitoriju atbilstoši licences robežai, pēc tam izveidojiet katra izdevuma salikto koku.
npm ci
npm test
npm run build

Pierā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.

  1. Izveidojiet repozitorija atzarojumu un zaru no main.
  2. 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ā.
  3. Veiciet izmaiņas ar testiem, kas bez tām neizdodas.
  4. Pirms kaut ko piedāvājat, izpildiet pārbaudes, ko izpilda projekts.
  5. 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 typecheck

Pierā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.

  1. Veidojiet un testējiet izdevēja klasterī, izmantojot tikai parauga datus.
  2. Deklarējiet lietotnes manifestā visu, kas tai nepieciešams, un neko vairāk.
  3. Izlaidiet to parakstītu Adverant pārskatīšanai un iekļaušanai katalogā.
  4. 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.

Trešās puses spraudņa instalēšana
Trešās puses spraudņa instalēšana
Administrators instalē trešās puses spraudni, piešķirot katru deklarēto tvērumu katrai vienībai un vienu izlaižot. Attēlā redzams izsaukums, ko spraudnis nekad nav deklarējis, un tas ir atteikts.

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.

  1. Izpildiet /plugin-create ar 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.
  2. Paaugstiniet manifestu līdz v2 līgumam. migrate pievieno trīs likuma teikumus un pārvieto domain uz domains[], un tas atsakās izdomāt ieejas punktu.
  3. Aizstājiet jebkuru nomnieka vērtību, ko ietinējs nolasa no galvenēm, ar SDK tvēruma aizsargu.
  4. Pievienojiet organization_id, owner_user_id un business_unit_id katrai tabulai ar primārajām atslēgām, kas sākas ar nomnieku.
  5. Deklarējiet katru maršrutu ar tā tiesībām un instalējiet atteikumu žurnālu.
  6. 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-test

Pierā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.