Logi sisseBroneerige tutvustus

Peatükk 2.27

Ehitusstsenaariumid

Kolmeteistkümnest ehitusest koosnev retseptiraamat alates üksikust oskusest kuni õhuvahega tarneni. Iga retsept annab eesmärgi, ehitusplokid, sammud ja käsud, kontrollvärava, mis tõestab selle toimimist, ning selle, mis muutub olenevalt väljaandest ja tarnevormist.

Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

25 minutit lugemist

Need on retseptid, mille poole ma pöördun, kui keegi Corrán Orbitalis või kliendi juures ütleb: „me tahame, et Nexus teeks X“. Igaüks neist on meelega lühike. Sammude taga olev põhjendus on sellele eelnevates peatükkides: peatükk 2.20, Oskused, ja peatükk 2.21, Plugin SDK, mis käsitleb tarkvaraarenduskomplekti, seejärel peatükk 2.23, Valdkonnapaketid, ning sellele järgnevad kolm ehitamist käsitlevat peatükki. Siit leiate eesmärgi, kasutatavad ehitusplokid, sammud, käsud, kontrollvärava, mis näitab, et kõik toimis, ning väljaande- ja tarnemärkused.

Kõige olulisem on kontrollvärav. Retsept on valmis, kui selle kontrollvärav on roheline. Iga selle peatüki kontrollvärav on midagi, mida saate ise käivitada või mida platvorm teie eest käivitab, ning igaüks neist lõpeb nullist erineva väljumiskoodiga või keeldub koodiga, kui tingimus pole täidetud.

Stsenaarium Peamine ehitusplokk Seda tõendav kontrollvärav Väljaanne
Uus Skills Engine’i oskus SKILL.md-pakett skill:validate null veaga Community ja Enterprise
Manifestioskus koos host_callback-ga Plugina manifest skills[] create-nexus-plugin validate ja nexus-gates Community ja Enterprise
Olemasoleva paketi laiendamine pack.json koos väljaga inherits Läätse poliitikakontroll pilootväraval Enterprise ja paketi litsents
Uus pakett nullist Valdkonnapaketi kuldne rada Testkeskkonna ja piloodi kontrollväravad Enterprise
Andmeühendus plugin_queue-oskus validate, nexus-gates, väljuva liikluse keelamine Community ja Enterprise
MCP (Model Context Protocol) tööriist Manifest mcpTools[] validate (ülemise taseme kombinaatoriteta) Community ja Enterprise
Valge sildiga e-pood Manifest domains ja branding scope-adherence avalik reegel Enterprise ja lisamoodul Storefront
Edge’i missioonipakett Missioonipakett Pardal tehtavad testjuhtumid, kaks allkirja kolmest Enterprise ja lisamoodul Nexus Edge
Võrgust eraldatud tarne Suletud komplekt nexus-airgap verify Enterprise
Ainult Enterprise’i moodul @adverant/nexus-spi Litsentsipiiri kontrollvärav, väljaandepõhised järgud Enterprise
Avatud tuuma hargnemine või laiendamine Community lähtekood Testid, lint ja tüübikontroll Community
Team-väljaande pilverakendus Avaldaja klaster Allkirjastatud väljalase, ülevaatus, kliendile õiguse andmine Team
Olemasoleva siserakenduse mähkimine /plugin-create migrate, validate, nexus-gates Community ja Enterprise
Otsustuspuu, mida loetakse ülevalt alla. Esimene romb küsib: „Kas see vajab pidevalt töötavat koodi?“. „Ei“ viib rombini „Kas see on juhised assistendile?“, mille „Jah“ lõpeb valikuga „Skills Engine'i oskus“ ja „Ei“ valikuga „Lääts olemasoleval paketil“. „Jah“ viib rombini „Kas see on ühe tööstusharu vaade platvormile?“, mille „Jah“ lõpeb valikuga „Domeenipakett (koos pistikprogrammiga)“ ja „Ei“ viib viimase rombini „Kas see peab jääma suletuks ja litsentsituks?“, mis lõpeb „Jah“ korral valikuga „Enterprise'i moodul“ ja „Ei“ korral valikuga „Pistikprogramm“.
Millisest ehitusplokist alustada.

1. Uus Skills Engine'i oskus

Eesmärk on taaskasutatav juhiste osa, mida assistent, agendid, töövood ja arendustööriistad saavad kõik käivitada, näiteks tollideklaratsiooni kontrollimine selle reeglite alusel. Teie ehitusplokid on SKILL.md-pakett oskuse järgi nimetatud kaustas, valikuline skill.yaml päästikute ja siltide jaoks ning sellega kaasa pakitud valikuline scripts/-kaust.

  1. Looge skills/<slug>/ ja kirjutage SKILL.md koos esiosaga: name (kebab-case, võrdne kausta nimega), description (kuni 500 tähemärki), allowed-tools ning valikuliselt triggers, capabilities ja version.
  2. Kirjutage sisu mudelile: millal oskust kasutada, selle sammud, näited ja see, mida see kunagi teha ei tohi.
  3. Lisage testjuhtumid. Lisage üks, mille sisendisse on peidetud juhis, mida oskus ei tohi järgida.
  4. Valideerige, vaadake üle üleslaadimisplaan ja laadige seejärel üles.
  5. Avaldage. Oskus, mis lisab kirjutustööriista, jääb ootele, kuni kaks nimeliselt määratud isikut selle pääsuvõtmetega kinnitavad, ning ettepaneku tegija ei saa oma muudatust ise kinnitada.
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

Kontrollvärav on skill:validate, mis peab enne avaldamist näitama null viga. Blokeerivad vead on puuduv nimi või kirjeldus ning dubleeritud slug või tööülesande tüüp. Juba avaldatud sisu üleslaadimine tagastab olemasoleva versiooni (CONTENT_HASH_ALREADY_PUBLISHED), seega on üleslaadimist ohutu korrata.

Community saab kogu loomistööriista, teegi, versioonid, tagasipöördumise, impordi ja testid. Enterprise’is läbib avaldamine ka varju- ja kanaarifaasi: kinnitatud versioon töötab varjus, seejärel ühes üksuses nimeliste kontrollväravate taga ja seejärel kõigile ning peatab end ise, kui mõni kontrollvärav pole täidetud. Võrgust eraldatud kliendi puhul liiguvad oskused eelallkirjastatult suletud komplekti sees (stsenaarium 9).

2. Manifestipõhine oskus koos host_callback-iga

Eesmärk on deterministlik arvutus teie enda pluginas, mida platvorm saab välja kutsuda, näiteks näidu põhjal kõrvalekalde kirje avamine. Kasutate manifesti skills[]-s rida tasemega host_callback ja oma taustsüsteemis /internal-marsruuti, mida kaitseb SDK teenusekaitse.

  1. Deklareerige oskus: id kujul lower_snake, tier: "host_callback", classification, mis on teie plugina usalduse ülempiiril või sellest madalam, inputSchema, outputSchema ja timeoutMs vahemikus 1 sekund kuni 6 tundi.
  2. Täitke hostCallback: teie enda Service’i nimi, selle port, suhteline tee, näiteks /internal/skills/excursion_open, mõlemad baidipiirangud (maxRequestBytes ja maxResponseBytes) ning tenantHeader: "X-Organization-ID".
  3. Deklareerige marsruut failis api.endpoints[] väärtusega auth: "service-key" või auth: "internal" ja kaitske seda kaitsega requireService või serviceMiddleware, mitte kunagi kasutaja ulatuse kaitsega.
  4. Valideerige, käivitage kontrollväravad ja laske juurutamisel sünkroonida oskused registrisse compileRegistry kaudu. Te ei kirjuta kunagi registri SQL-i käsitsi.
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 rakendab enne sünkroonimist registri sünkroonimise enda reegleid ning iga keeldumine tagastab vastuvõtja koodi. Skeemi, // või kaldkriipsuga tee lükatakse tagasi kui päritoluülene. Puuduv baidipiirang annab ENDPOINT_BYTE_CAP_REQUIRED, teise taseme väli annab FIELD_NOT_FOR_TIER ja vahemikust väljas aegumine annab TIMEOUT_OUT_OF_BOUNDS. Seejärel kontrollib nexus-gates, et /internal-marsruudil oleks teenusekaitse ja see oleks deklareeritud kui internal või service-key. See kontrollväravate paar on tõend.

Sünkroonimine on deklaratiivne. Postitage iga kord kogu oskuste komplekt, sest välja jäetud oskus keelatakse, ning laske juurutamisetapil ebaõnnestuda mis tahes olekukoodi korral peale 200. Enterprise’is kontrollitakse plugina sünkroonimist tervikuna: kui üks oskus rikub reeglit, ei võeta sellest sünkroonimisest midagi vastu (PLUGIN_SYNC_ALL_OR_NOTHING) ja eelmine versioon jätkab tööd. Kogukonna usaldustasemega plugin ei saa kasutada mudelini ulatuvaid tasemeid tool_using ja llm_only; need nõuavad usaldust core või verified.

Pistikprogrammid ja MCP sünkroonimine
Pistikprogrammid ja MCP sünkroonimine
Oskusi toovad pluginad ja see, mida iga sünkroonimise puhul kontrolliti. Pange tähele pluginat, mille sünkroonimine lükati tervikuna tagasi, sest üks selle viiest oskusest kasutas taset, mida tohib majutada ainult platvorm, samal ajal kui selle eelmine versioon jätkas tööd.

3. Olemasoleva paketi laiendamine

Eesmärk on uus tööstusharu või alamharu, mis taaskasutab suurema osa olemasolevast paketist, näiteks laenud ja kaardivaidlused Insurance-paketi struktuuri peal. Ehitusplokk on pack.json, mis nimetab oma vanema väljas inherits ja lisab ainult oma läätseklastrid ja sõnad.

  1. Alustage paketti valdkonnapaketi kuldse rajaga ja seejärel määrake inherits väärtuseks vanempaketi ID.
  2. Lisage oma lens-klastrid, igaüks oma kohtade, eesmärgi ja leksikoniviitega.
  3. Lisage oma sõnad leksikoni, igaühele lihtne seletus. Märkige termin exact, kui seda tuleb näidata kirjapildis muutmata kujul.
  4. Taaskasutage jagatud läätsi, selle asemel et oma joonistada: režiim, mida vajavad mitu paketti, näiteks väljasisseostetud tehnoloogia register, on üks jagatud lääts.
  5. Kontrollige litsentsiahelat. Teie pakett pärib oma vanema lisamoodulite nõuded.
  6. Eelvaadake iga läätse isikuna sünteetilises harus.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Tõend on pilootvärava poliitikakontroll, mis kinnitab, et iga lääts ainult kitsendab oma alust ja hoiab isikuandmete väljad vaikimisi välja lülitatuna. Lääts, mis üritab näidata seda, mida tema alus peidab, lükatakse tagasi koodiga LENS_CANNOT_WIDEN. Litsentsimise poolel keeldub konsool teie paketile litsentsi väljastamast ilma lisamooduliteta, mida selle vanem vajab; Insurance-pakett vajab otsustusruume ja suletud kirjeid.

Valdkonnapaketid on Enterprise’i funktsioon ja litsentsitakse paketipõhiselt. Paketi telefonivaated vajavad ka lisamoodulit Mobile apps. Alampakett ei saa muuta kesta, komponente ega kirjutamisreegleid.

4. Uus pakett nullist

Eesmärk on ühe tööstusharu vaade Nexusele: selle teadmusmudel, iga rolli läätsed, selle reeglite nõutavad tõendid ja plugin, mis hoiab selle andmed ajakohasena. Peatükk 2.24, Kohandatud vertikaali ehitamine algusest lõpuni, käsitleb seda ehitust täielikult; siin on lühivorm.

  1. Käivitage valdkonnapaketi kuldne rada ja kirjeldage paketti: eesmärk, üksused, alusmudel ja reeglid, mida see kaardistab.
  2. Ehitage teadmusmudel alusmudelile ja klassifitseerige iga omadus selle lisamisel.
  3. Lugege plaan läbi, kinnitage selle sõrmejälg oma pääsuvõtmega ja looge.
  4. Kujundage läätsed Lens builderis, igaüks kitsendamas üht alusläätse.
  5. Kirjutage plugin ja kõik Skills Engine’i oskused, mida pakett vajab.
  6. Genereerige seemnega sünteetilised andmed koos teile oluliste erijuhtudega ja eelvaadake iga läätse isikuna.
  7. Edendage arendusruumist testkeskkonda, pilootüksusesse ja seejärel kõikidesse üksustesse.

Tõend on edendamise kontrollväravad: kõik testid läbitud sünteetilistes harudes enne testkeskkonda, seejärel kaks ülevaatajat, kes pole autor, ning seejärel 14 päeva piloodis vigadega alla 1 1 000-st. Ühtki sammu ei saa vahele jätta (GATE_CANNOT_BE_SKIPPED). Paketid on Enterprise’i funktsioon. Community’s valdkonnapaketi kuldset rada ei pakuta.

5. Andmekonnektor

Eesmärk on, et välise süsteemi andmed voolaksid ajakava järgi teie plugina enda tabelitesse, näiteks väravasündmused terminali operatsioonisüsteemist. Ehitusplokid on plugin_queue-oskus, teie järjekorda lugev töötaja, sihttabeli migratsioon ja manifestis deklareeritud väljuv aadress.

  1. Deklareerige plugin_queue-oskus, mille queueName on kirjutatud kujul <plugin name>.<name>. Koolon pole lubatud ja nimi peab olema manifestis, sest orkestraator lisab selle otse järjekorda.
  2. Kirjutage töötaja, mis loeb järjekorda ja kutsub välist süsteemi.
  3. Deklareerige välise süsteemi aadress väljuva aadressina. Kõik loetlemata on blokeeritud.
  4. Salvestage saabuv oma skeemi, iga rea juures organization_id, owner_user_id ja business_unit_id.
  5. Lugege välise süsteemi mandaat keskkonnast nime järgi ja loetlege muutuja failis scripts/ci/required-env.
  6. Käivitage päringud UNO, töövoomootori kaudu, mitte kunagi taimeriga, mis kutsub mootoreid otse.
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 kontrollib järjekorra nime ja aegumist registri sünkroonimise reeglite alusel. Kolm kontrollväravat tõendavad, et puudub mudeli mandaat, puudub otsene arvutus ja tabel on õigesti piiritletud. Käivitage enne tõukamist täielik nexus-gates, sest --only kitsendab käivitust ja märgib seda oma kokkuvõttes. Käitusajal peatatakse kutse aadressile, mida manifest ei deklareerinud, servas koodiga EGRESS_NOT_DECLARED.

Platvormi enda ühendused ketaste, wikide, postihoidlate ja pärandsüsteemidega koos muutuste püüdmise ja andmepõlvnemisega on saadaval lisamooduliga Data connectors. Ise ehitatud ühendus on plugin ja töötab igas väljaandes. Väljuva aadressi lisamine hilisemas väljalaskes on laiendamine, mis jääb ootele, kuni kaks ülevaatajat selle heaks kiidavad.

6. MCP-tööriist

Eesmärk on tööriist, mida Claude Code, agendid ja teised MCP (Model Context Protocol) kliendid saavad kutsuda, näiteks laeva ülevaatusajaloo otsimine. Ehitusplokk on kirje manifesti mcpTools[]-s koos name, description ja inputSchema-ga.

  1. Nimetage tööriist ja kirjeldage seda lihtsalt. Kirjeldus on see, mida mudel loeb, et otsustada, kas seda kutsuda.
  2. Kirjutage inputSchema ühe objektiskeemina. Ärge pange selle ülemisele tasemele oneOf, allOf ega anyOf.
  3. Hoidke tööriista teenindav marsruut ulatuse kaitse taga nagu iga teist /api-marsruuti, et rentniku kuuluvus tuleks kutsuja tokenist.
  4. Valideerige manifest.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Tõend on validate: ülemise taseme kombinaator lükatakse tagasi juba koostamise ajal, sest käitusajal paneks see tööriista ebaõnnestuma iga MCP alamagendi jaoks, mis selle impordib, ning tööriist oleks olemas, ilma et keegi saaks seda kutsuda.

Enterprise’is on iga tööriist, mida IDE (integreeritud arenduskeskkond) saab kutsuda, loetletud Workbenchi tööriistakataloogis koos selle taseme, selle, kas see muudab midagi, fikseeritud sõrmejälje ja seda kasutada lubatud rollidega. Kui teie tööriista kirjeldus uues väljalaskes muutub, hoiab kataloog tööriista ootel, kuni inimene muudatuse üle vaatab. See on taotluslik: muudetud kirjeldus on viis, kuidas tööriist võib hakata mudelilt küsima midagi, mida ei tohiks. Kutse millelegi väljaspool kutsuja pääset lükatakse tagasi koodiga CONNECTION_SCOPE_EXCEEDED.

7. Valge sildiga e-pood

Eesmärk on rakendus, mida kasutavad teie kliendi enda kliendid, kliendi domeenil ja tema brändis, ilma igasuguse jäljeta Adverantist. Ehitusplokid on manifesti domains- ja branding-plokid, SDK sisselogimisabilised ning kliendi lisamoodul Storefront / white-label.

  1. Pange kliendi domeen domains[]-sse kujul primary koos võimalike aliases-dega.
  2. Täitke branding: appName, tagline, primaryColor, accentColor, domeeniga võrdne passkeyRpId ja oauthClientRef.
  3. Logige inimesed sisse SDK sisselogimisabiliste kaudu ja deklareerige nende kaks avalikku marsruuti täpselt, koos auth: "public" ja allowAnonymous: true-ga.
  4. Saatke iga esiosa kutse läbi esiosa taustsüsteemi lubatute loendi puhverserveri. Ärge kunagi pange teenuse aadressi klienti.
  5. Jätke maksed kliendi administraatorile, kes ühendab makselüüsid ja seadistab brändiga kassa.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Tõend on scope-adherence. See lubab kaitsmata /api-marsruudi ainult siis, kui manifest deklareerib täpselt selle meetodi ja tee avalikuna ning tee on üks sisselogimismarsruutidest; iga muu avalik deklaratsioon ebaõnnestub ja nimetab kaks lubatud teed. Seejärel võrdleb api-contract deklareeritud marsruute tegelikega mõlemas suunas. definePlugin lükkab tagasi ka frontend.basePath, mis pole suhteline sama päritoluga tee.

Valge märgistus on Enterprise'i Storefront / white-label lisamoodul, mis litsentsib ka makseid. Kaardiandmed ei puutu kunagi Nexusega kokku. Brändi omanik on kliendi administraator ning platvorm tuletab selle organisatsioonist, mitte teie koodist.

8. Edge'i missioonipakett

Eesmärk on uus või uuendatud missioon satelliidile või droonile, mis töötab Nexus Edge'iga, näiteks laevaotsija adapteri lisamine merevalve missioonile. Ehitusplokk on missioonipakett, mis koostatakse ja allkirjastatakse maapealselt.

  1. Alustage praegusest paketist lehel Missioonipaketi koostamine, mis koostab uue versiooni mustandi vanast ja märgib iga muudatuse.
  2. Muutke ainult seda, mida missioon vajab. Hoidke suured osad, keelemudel ja ontoloogia, võimaluse korral stabiilsena.
  3. Kontrollige paigutustabelit igal vähendatud režiimi astmel, et iga plaat mahutaks endiselt seda, mida see käitab.
  4. Käivitage paketi pardatestid samade plaatidega katsestendil.
  5. Saatke see allkirjastamiseks: vaja on kahte allkirja kolmest.
  6. Väljastage see ühele platvormile. See paigaldatakse ootel pessa ja lülitatakse sisse alles pärast seda, kui selle testid on pardal läbitud.
  7. Laiendage järgmisele platvormile pärast nädalat ilma probleemideta.
Missioonipaketid
Missioonipaketid
Missioonipakettide teek, kus on näha, mida iga pakett sisaldab ja millised platvormid seda käitavad. Pange tähele pardale tagasipöördumiseks alles hoitud vanemat versiooni ning testide arvu, mille iga pakett peab oma riistvaral läbima.

Selles juhendis ei ole käske; kõik tehakse konsooli Nexus Edge'i lehtedel. Tõendiks on pardatestid, mis kõik peavad olema läbitud enne paketi sisselülitamist, ning kaks allkirja. Kui test pardal ebaõnnestub, jääb platvorm oma eelmisele paketile ja tõrketeave laaditakse alla järgmisel ülelennul. Paketi paigaldamine riistvarale, mille jaoks seda ei kontrollitud, keelatakse koodiga PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge on lisamoodul, mida litsentsitakse platvormi või pargi kaupa. Paketid jäävad kehtima ka siis, kui platvormiga puudub ühendus. Üleslink on kitsas, seega planeerige mahud selle järgi: meie väljalase 1.5 oli 412 MB, uue keelemudeliga pakett aga 9.8 GB.

9. Õhuvahega tarne kliendile

Eesmärk on teie pistikprogramm või pakett, mis on paigaldatud võrguühenduseta kliendi asukohas. Ehitusplokid on @adverant/nexus-sovereign loodud suletud kimp, teie väljalaske allkirjavõti ja kliendi enda väljalaskekanalid.

  1. Koostage pistikprogramm ja selle kujutised täpselt nagu võrguühendusega kliendi jaoks, kõik kontrollväravad rohelised.
  2. Looge profiiliga airgap suletud kimp, mis sisaldab kujutisi, migratsioone, eelallkirjastatud oskusi ja litsentsidega SBOM-i (tarkvara koostisosade loend).
  3. Allkirjastage see oma Ed25519 väljalaskevõtmega.
  4. Kontrollige seda ise puhtal masinal.
  5. Saatke kimp andmekandjal ning saatke oma avalik võti ja kimbu SHA-256 eraldi kanali kaudu.
  6. Kliendi operaator kontrollib kimpu teie võtmega ja toob seejärel väljalaske sisse oma väljalaskekanalite kaudu.
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 koostab kimbu teie kimbu konfiguratsioonist. Tõendiks on nexus-airgap verify kliendi poolel. See arvutab iga faili räsi uuesti, lükkab tagasi kõik failid, mida manifestis ei ole, nõuab usaldusväärset allkirjastajat ja keeldub kimbust, mille võrgu lubatud loend ei ole tühi. Muudetud fail annab tõrke BUNDLE_INTEGRITY_VIOLATION. Keegi ei tohiks kunagi range kontrolli välja lülitada, et sellest mööda pääseda.

Võrgust eraldatud paigaldused kuuluvad Enterprise'i juurde. Miski kimbus ei tohi paigaldamisel midagi alla laadida ning pistikprogrammi vajatav mudel tuleb kliendi enda mudeliserverist AI (tehisintellekti) Provider Routeri kaudu.

10. Ainult Enterprise'i moodul

Eesmärk on suletud litsentsitud võimekus, mis ühendub avatud tuumaga, näiteks pika säilitusajaga auditijälg, mida müüakse ainult Enterprise'i klientidele. Ehitusplokk on liidesepakett @adverant/nexus-spi ja mitte midagi muud Communityst.

  1. Hoidke koostatud liidesepaketi baidipõhiselt fikseeritud koopiat oma hoidlas kohaliku file: paketina koos selle SHA256SUMS fikseeringuga.
  2. Kirjutage selle vastu RouteModule (või konsooli kuvade jaoks ScreenModule) koos funktsioonirühmaga, mida see teenindab.
  3. Käitage iga marsruuti ctx.requireScope taga ja kontrollige enne vastamist mooduli enda õigust.
  4. Keelduge koodiga LICENCE_LOCKED, kui organisatsioonil puudub õigus, ja kuvage funktsiooni tutvustus, mitte kunagi selle andmeid.
  5. Hoidke hoidla litsentsipiiri sees, seejärel koostage iga väljaande komponeeritud puu.
npm ci
npm test
npm run build

Tõendiks on litsentsipiiri reegel: ühtegi importi Community skoobist peale liidesepaketi, ühtegi suhtelist importi hoidlast välja ega ühtegi file:, link: või workspace: sõltuvust väljaspool seda. Seejärel peavad ülaltoodud kolm käsku läbima igas komponeeritud väljaande puus, mitte ainult teie tööpuus. Peatükis 2.25, Koostamine iga väljaande jaoks, on mooduli põhi.

Moodul laaditakse Community teenusesse käivitamisel nendes paigaldustes, mille litsents sisaldab selle funktsioonirühma. Ilma selle õiguseta see keeldub, nii et sama koost tarnitakse kõikjale ega tee midagi seal, kus see pole litsentsitud.

11. Avatud tuuma harutamine (forking) või laiendamine

Eesmärk on muudatus Communitysse endasse, mida hoitakse teie harus või panustatakse tagasi. Ehitusplokk on Community lähtekood Apache License, Version 2.0 alusel.

  1. Looge hoidlast haru (fork) ja tehke haru main pealt.
  2. Eelistage pistikprogrammi või oskust, kui soovitu saab sellena teostada. Tuuma muudatust peate ise igas väljalaskes hooldama.
  3. Tehke muudatus koos testidega, mis ilma selleta ebaõnnestuvad.
  4. Käitage projekti kontrolle enne, kui midagi ette panete.
  5. Säilitage NOTICE-fail ja ärge kasutage Adveranti nimesid ega kaubamärke rohkem kui selleks, et öelda, kust töö pärineb.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Tõendiks on nende kolme kontrolli läbimine ning tõend, et iga uus test ebaõnnestus enne teie muudatust. Säilitage oma harus üks avatud tuuma omadus: Community käitab agenti algusest lõpuni kohalikul mudelil ilma võtme ja võrguta. Muudatus, mis selle rikub, rikub selle, mis teeb Community iseseisvalt kasutatavaks.

See on ainult Community jaoks. Kõik, mis peab jääma suletuks, kuulub hoopis Enterprise'i moodulisse (stsenaarium 10), et litsentsipiir jääks kohta, millele igaüks saab osutada.

12. Team-väljaande pilverakendus

Eesmärk on rakendus, mida Team-kliendid saavad paigaldada. Team töötab ainult Adverant cloudis, seega jõuab rakendus nendeni ainult kataloogi kaudu. Ehitusplokid on pistikprogramm ja väljaandja klaster: teie oma virtuaalne klaster Adverant cloudis näidisandmetega.

  1. Koostage ja testige väljaandja klastris ainult näidisandmetega.
  2. Deklareerige rakenduse manifestis kõik, mida see vajab, ja mitte midagi enamat.
  3. Väljastage see allkirjastatuna Adveranti ülevaatuseks ja kataloogi lisamiseks.
  4. Iga klient paigaldab selle, andes iga deklareeritud ulatuse üksuse kaupa.

Tõend koosneb kahest osast. Allkirjastatud ja üle vaadatud väljalase viib teid kataloogi. Seejärel otsustab kliendi antud õigus, millele rakendus tema juures ligi pääseb, ja iga deklareerimata kutse keelatakse koodiga CONNECTION_SCOPE_EXCEEDED. Puuduva ulatuse saate lisada ainult uues väljalaskes, mille klient üle vaatab.

Kolmanda osapoole pistikprogrammi paigaldamine
Kolmanda osapoole pistikprogrammi paigaldamine
Administraator paigaldab kolmanda osapoole pistikprogrammi, andes iga deklareeritud ulatuse üksuse kaupa ja jättes ühe välja. Plaadil on näha kutse, mida pistikprogramm kunagi ei deklareerinud, keelatuna.

Väljaandja klastril puudub marsruut ühegi kliendini ja kliendi andmete küsimine seal keelatakse koodiga TENANT_BOUNDARY. Kliendid saavad teiega jagada testitulemusi, mitte kunagi oma andmeid. Team sisaldab töövoogude haldamise võimekust, nii et kui teie rakendus tarnib töövooge, saavad Team-kliendid neid ise keskkondade vahel edasi viia.

13. Olemasoleva siserakenduse pakendamine pistikprogrammina

Eesmärk on rakendus, mida teie ettevõte juba käitab, tuuakse Nexusesse, et see pärandaks sisselogimise, isolatsiooni ja juhtimise. Ehitusplokid on oskus /plugin-create esimese mustandi jaoks ning SDK manifestitööriistad ja kontrollväravad selle lõpetamiseks.

  1. Käivitage /plugin-create koos hoidlaga. See analüüsib koodi ja valib mähkimisstrateegia, seejärel genereerib taustsüsteemi, migratsioonid, kasutajaliidese (UI), manifesti ja testid.
  2. Tõstke manifest v2 lepingu tasemele. migrate lisab kolm seaduselauset ja viib domain üle domains[] alla ning keeldub sisenemispunkti välja mõtlemast.
  3. Asendage kõik rentniku väärtused, mida mähis loeb päistest, SDK ulatuse kaitsega.
  4. Lisage igasse tabelisse organization_id, owner_user_id ja business_unit_id, rentnikust algavate primaarvõtmetega.
  5. Deklareerige iga marsruut koos selle õigusega ja paigaldage keeldumiste register.
  6. Käitage kontrollväravaid, kuni need on rohelised.
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

Tõendiks on nexus-gates väljumine koodiga 0, kusjuures scope-adherence, one-fence, migrations-are-scoped, crud-adherence ja api-contract kõik läbivad. Arvestage, et esimene käivitus ebaõnnestub enamikul neist; meil teatati kõik marsruudid ulatuseta olevaks, sest mustand usaldas päiseid, mida brauser sai määrata. Kontrollväravatel ei ole meelega parandamise lülitit.

Mähitud rakendused töötavad igas väljaandes. Juurutamine toimub ainult paigalduse väljalaskekanalite kaudu, seega eirake kõiki juurutusfaile, mille mustand kirjutas. Aega kulub peamiselt isolatsioonitööle: arvestage päris rakenduse puhul päevade, mitte tundidega.