Log indBook en briefing

Kapitel 2.27

Byggescenarier

En kogebog med tretten builds, fra en enkelt færdighed til en air-gapped levering. Hver opskrift angiver målet, byggestenene, trinene og kommandoerne, kontrolporten, der beviser, at det virkede, og hvad der ændrer sig afhængigt af udgave og leveringsform.

Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

25 minutters læsetid

Dette er de opskrifter, jeg griber til, når nogen hos Corrán Orbital eller hos en kunde siger "vi vil have Nexus til at gøre X". Hver enkelt er bevidst kort. Begrundelsen for trinene findes i kapitlerne før dette: kapitel 2.20, Skills, og kapitel 2.21, Plugin SDK'et, som dækker softwareudviklingssættet, derefter kapitel 2.23, Domænepakker, og de tre kapitler efter det om at bygge. Her får De målet, hvilke byggesten De skal bruge, trinene, kommandoerne, den kontrol, der viser Dem, at det virkede, samt noter om udgave og levering.

Kontrollen er det vigtigste. En opskrift er færdig, når dens kontrol er grøn. Hver kontrol i dette kapitel er noget, De kan køre, eller noget, platformen kører for Dem, og hver enkelt afslutter med en kode forskellig fra nul eller afviser med en kode, når den ikke er opfyldt.

Scenarie Primær byggesten Kontrollen, der beviser det Udgave
En ny Skills Engine-skill SKILL.md-pakke skill:validate med nul fejl Community og Enterprise
En manifest-skill med host_callback Plugin-manifest skills[] create-nexus-plugin validate og nexus-gates Community og Enterprise
Udvidelse af en eksisterende pakke pack.json med inherits Lens-politikkontrol ved pilotkontrollen Enterprise og en pakkelicens
En ny pakke fra bunden Standardforløbet for domænepakker Staging- og pilotkontroller Enterprise
En dataconnector plugin_queue-skill validate, nexus-gates, afvisning af udgående trafik Community og Enterprise
Et MCP-værktøj (Model Context Protocol) Manifest mcpTools[] validate (ingen kombinatorer på øverste niveau) Community og Enterprise
En white-label-butiksfacade Manifest domains og branding scope-adherence-reglen for offentlige ruter Enterprise og Storefront-tilføjelsen
En Edge-missionspakke Missionspakke Testcases om bord, to ud af tre signaturer Enterprise og Nexus Edge-tilføjelsen
En air-gapped levering Forseglet bundt nexus-airgap verify Enterprise
Et modul kun til Enterprise @adverant/nexus-spi Licensgrænsekontrol, udgavebuilds Enterprise
Forking eller udvidelse af den åbne kerne Community-kildekoden Tests, lint og typekontrol Community
En cloudapp til Team-udgaven Udgiverklynge Signeret release, gennemgang, kundetildeling Team
Indpakning af en eksisterende intern app /plugin-create migrate, validate, nexus-gates Community og Enterprise
Et beslutningstræ, der læses oppefra og ned. Den første rombe spørger "Kræver det kode, der kører hele tiden?". "Nej" fører til en rombe "Er det instruktioner til en assistent?", hvis "Ja" ender ved "Skills Engine-skill" og hvis "Nej" ender ved "Lens på en eksisterende pakke". "Ja" fører til en rombe "Er det én branches syn på platformen?", hvis "Ja" ender ved "Domænepakke (med sit plugin)" og hvis "Nej" fører til en sidste rombe "Skal det forblive lukket og licenseret?", der ender ved "Enterprise-modul" for "Ja" og "Plugin" for "Nej".
Hvilken byggesten De skal starte fra.

1. En ny Skills Engine-færdighed

Målet er et genbrugeligt stykke instruktion, som assistenten, agenter, workflows og udviklerværktøjer alle kan køre, f.eks. kontrol af en toldangivelse mod dens regler. Deres byggesten er en SKILL.md-pakke i en mappe opkaldt efter skillen, en valgfri skill.yaml til triggere og tags samt en valgfri scripts/-mappe, der følger med.

  1. Opret skills/<slug>/, og skriv SKILL.md med frontmatter: name (kebab-case, lig med mappenavnet), description (op til 500 tegn), allowed-tools og eventuelt triggers, capabilities og version.
  2. Skriv brødteksten til modellen: hvornår skillen skal bruges, dens trin, eksempler, og hvad den aldrig må gøre.
  3. Tilføj testcases. Medtag én med en instruktion plantet i inputtet, som skillen ikke må følge.
  4. Validér, se uploadplanen igennem, og upload derefter.
  5. Udgiv. En skill, der tilføjer et skriveværktøj, tilbageholdes, indtil to navngivne personer godkender den med passkeys, og den, der foreslår ændringen, kan ikke godkende sin egen ændring.
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

Kontrollen er skill:validate, som skal rapportere nul fejl, før noget kan udgives. De blokerende fejl er et manglende navn eller en manglende beskrivelse samt en dubleret slug eller jobtype. Upload af indhold, der allerede er udgivet, returnerer den eksisterende version (CONTENT_HASH_ALREADY_PUBLISHED), så uploaden kan trygt gentages.

Community får hele editoren, biblioteket, versioner, tilbageskift, import og tests. På Enterprise gennemgår udgivelse også shadow og canary: Den godkendte version kører i shadow, derefter for én enhed bag navngivne kontroller og derefter for alle, og den stopper sig selv, hvis en kontrol ikke er opfyldt. For en air-gapped kunde leveres skills forhåndssigneret i det forseglede bundt (scenarie 9).

2. En manifest-færdighed med host_callback

Målet er deterministisk beregning i Deres eget plugin, som platformen kan afsende, f.eks. åbning af en afvigelsesregistrering ud fra en måling. De bruger en række i manifestets skills[] med niveauet host_callback og en /internal-rute i Deres backend, beskyttet af SDK'ets service guard.

  1. Deklarér skillen: id i lower_snake, tier: "host_callback", et classification på eller under Deres plugins tillidsloft, inputSchema, outputSchema og en timeoutMs mellem 1 sekund og 6 timer.
  2. Udfyld hostCallback: Deres eget Service-navn, dens port, en relativ sti såsom /internal/skills/excursion_open, begge bytegrænser (maxRequestBytes og maxResponseBytes) samt tenantHeader: "X-Organization-ID".
  3. Deklarér ruten i api.endpoints[] med auth: "service-key" eller auth: "internal", og beskyt den med requireService eller serviceMiddleware, aldrig med brugerens scope guard.
  4. Validér, kør kontrollerne, og lad onboardingen synkronisere skills til registret via compileRegistry. De skriver aldrig registry-SQL i hånden.
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 anvender registersynkroniseringens egne regler, før noget synkroniseres, og hver afvisning sker med modtagerens kode. En sti med et skema, // eller en backslash afvises som cross-origin. En manglende bytegrænse er ENDPOINT_BYTE_CAP_REQUIRED, et felt fra et andet niveau er FIELD_NOT_FOR_TIER, og en timeout uden for intervallet er TIMEOUT_OUT_OF_BOUNDS. Derefter kontrollerer nexus-gates, at /internal-ruten har service guard og er deklareret internal eller service-key. Det par af kontroller er beviset.

Synkronisering er deklarativ. Send hele sættet af skills hver gang, fordi en skill, De udelader, deaktiveres, og lad Deres deploytrin fejle ved enhver anden status end 200. På Enterprise kontrolleres en pluginsynkronisering samlet: Hvis én skill bryder en regel, modtages intet fra den synkronisering (PLUGIN_SYNC_ALL_OR_NOTHING), og den tidligere version fortsætter med at køre. Et plugin med community-tillid kan ikke bruge de niveauer, der når en model, tool_using og llm_only; de kræver tillid core eller verified.

Plugins og MCP-synkronisering
Plugins og MCP-synkronisering
Plugins, der leverer skills, og hvad hver synkronisering blev kontrolleret for. Bemærk det plugin, hvis synkronisering blev afvist samlet, fordi én af dets fem skills brugte et niveau, som kun platformen må hoste, mens dets tidligere version fortsatte med at køre.

3. Udvidelse af en eksisterende pakke

Målet er en ny branche eller underbranche, der genbruger det meste af en eksisterende pakke, f.eks. udlån og korttvister oven på Insurance-pakkens struktur. Byggestenen er en pack.json, der navngiver sin overordnede pakke i inherits og kun tilføjer sine egne lens-klynger og ord.

  1. Start pakken med standardforløbet for domænepakker, og sæt derefter inherits til den overordnede pakkes id.
  2. Tilføj Deres egne lens-klynger, hver med sine pladser, sit formål og sin leksikonreference.
  3. Tilføj Deres ord til leksikonet med en enkel forklaring til hvert. Markér et begreb exact, hvor det skal vises som skrevet.
  4. Genbrug delte lenses i stedet for at tegne Deres egne: Et regelsæt, som flere pakker har brug for, f.eks. et register over outsourcet teknologi, er én delt lens.
  5. Kontrollér licenskæden. Deres pakke arver sin overordnede pakkes krav til tilføjelser.
  6. Forhåndsvis hver lens som en person på en syntetisk gren.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Beviset er pilotkontrollens politikkontrol, som bekræfter, at hver lens kun indsnævrer sin base og som standard holder personfelter slået fra. En lens, der forsøger at vise, hvad dens base skjuler, afvises med LENS_CANNOT_WIDEN. På licenssiden nægter konsollen at udstede en licens til Deres pakke uden de tilføjelser, dens overordnede pakke kræver; Insurance-pakken kræver Decision rooms og forseglede registreringer.

Domænepakker er Enterprise og licenseres pr. pakke. En pakkes telefonskærme kræver også tilføjelsen Mobile apps. En underordnet pakke kan ikke ændre skallen, komponenterne eller skrivereglerne.

4. En ny pakke fra bunden

Målet er én branches visning af Nexus: dens vidensmodel, lenses for hver rolle, den dokumentation, dens regler kræver, og det plugin, der holder dens data opdateret. Kapitel 2.24, Opbygning af en brugerdefineret vertikal fra start til slut, gennemgår denne opbygning fuldt ud; her er den korte version.

  1. Kør standardforløbet for domænepakker, og beskriv pakken: formål, enheder, basismodellen og de regler, den kortlægger.
  2. Byg vidensmodellen på en basismodel, og klassificér hver egenskab, efterhånden som De tilføjer den.
  3. Læs planen, bekræft dens fingeraftryk med Deres passkey, og opret.
  4. Form lenses i Lens builder, så hver enkelt indsnævrer en basis-lens.
  5. Skriv pluginnet og eventuelle Skills Engine-skills, som pakken har brug for.
  6. Generér seedede syntetiske data med de særtilfælde, De interesserer Dem for, og forhåndsvis hver lens som en person.
  7. Fremryk fra udviklingsområdet til staging, til en pilotenhed og derefter til alle enheder.

Beviset er fremrykningskontrollerne: alle tests bestået på de syntetiske grene ind i staging, derefter to korrekturlæsere, der ikke er forfatteren, derefter 14 dage i piloten med fejl under 1 ud af 1.000. Intet trin kan springes over (GATE_CANNOT_BE_SKIPPED). Pakker er Enterprise. På Community tilbydes standardforløbet for domænepakker ikke.

5. En dataconnector

Målet er data fra et eksternt system, der efter en tidsplan strømmer ind i Deres plugins egne tabeller, f.eks. gate-hændelser fra et terminaldriftssystem. Byggestenene er en plugin_queue-skill, en worker, der henter fra Deres kø, en migrering til måltabellen og en udgående adresse deklareret i manifestet.

  1. Deklarér en plugin_queue-skill med queueName stavet <plugin name>.<name>. Kolon er ikke tilladt, og navnet skal stå i manifestet, fordi orkestratoren sætter direkte i kø på det.
  2. Skriv den worker, der henter fra køen og kalder det eksterne system.
  3. Deklarér det eksterne systems adresse som en udgående adresse. Alt, der ikke er angivet, blokeres.
  4. Gem det, der modtages, i Deres eget skema med organization_id, owner_user_id og business_unit_id på hver række.
  5. Læs det eksterne systems legitimationsoplysninger ved navn fra miljøet, og angiv variablen i scripts/ci/required-env.
  6. Afsend hentningerne via UNO, workflowmotoren, aldrig med en timer, der kalder motorer direkte.
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 kontrollerer kønavnet og timeouten mod registersynkroniseringens regler. De tre kontroller beviser, at der ikke er nogen modellegitimation, ingen direkte beregning og en korrekt afgrænset tabel. Kør hele nexus-gates, før De pusher, da --only indsnævrer kørslen og angiver det i sin opsummering. Ved kørsel stoppes et kald til en adresse, som manifestet ikke har deklareret, ved kanten med EGRESS_NOT_DECLARED.

Platformens egne connectorer til drev, wikier, mailarkiver og ældre systemer, med ændringsregistrering og dataafstamning, følger med tilføjelsen Data connectors. En connector, De selv bygger, er et plugin og fungerer på alle udgaver. Tilføjelse af en udgående adresse i en senere release er en udvidelse, der tilbageholdes, indtil to korrekturlæsere accepterer den.

6. Et MCP-værktøj

Målet er et værktøj, som Claude Code, agenter og andre MCP-klienter (Model Context Protocol) kan kalde, f.eks. til opslag i et fartøjs inspektionshistorik. Byggestenen er en post i manifestets mcpTools[] med en name, en description og et inputSchema.

  1. Navngiv værktøjet, og beskriv det enkelt. Beskrivelsen er det, en model læser for at afgøre, om den skal kalde det.
  2. Skriv inputSchema som ét objektskema. Placér ikke oneOf, allOf eller anyOf på dets øverste niveau.
  3. Hold den rute, der betjener værktøjet, bag scope guard, ligesom alle andre /api-ruter, så tenancy kommer fra kalderens token.
  4. Validér manifestet.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Beviset er validate: En kombinator på øverste niveau afvises allerede ved udarbejdelsen, fordi den ved kørsel ville få værktøjet til at fejle for hver MCP-subagent, der importerer det, og værktøjet ville eksistere, uden at nogen kunne kalde det.

På Enterprise er hvert værktøj, som et IDE (integreret udviklingsmiljø) kan kalde, opført i Workbench-værktøjskataloget med sit niveau, om det ændrer noget, et fastlåst fingeraftryk og de roller, der må bruge det. Hvis Deres værktøjs beskrivelse ændres i en ny release, tilbageholder kataloget værktøjet, indtil en person har gennemgået ændringen. Det er bevidst: En ændret beskrivelse er den måde, hvorpå et værktøj kan begynde at bede en model om noget, det ikke burde. Et kald til noget uden for kalderens adgangstilladelse afvises med CONNECTION_SCOPE_EXCEEDED.

7. En white-label-butiksfacade

Målet er en app, som Deres kundes egne kunder bruger, på kundens domæne og i kundens brand, uden spor af Adverant. Byggestenene er manifestets domains- og branding-blokke, SDK'ets hjælpefunktioner til login og kundens tilføjelse Storefront / white-label.

  1. Angiv kundens domæne i domains[] som primary med eventuelle aliases.
  2. Udfyld branding: appName, tagline, primaryColor, accentColor, en passkeyRpId lig med domænet samt oauthClientRef.
  3. Log personer ind via SDK'ets hjælpefunktioner til login, og deklarér deres to offentlige ruter præcist med auth: "public" og allowAnonymous: true.
  4. Send hvert frontendkald gennem backend-for-frontend-proxyen med tilladelsesliste. Placér aldrig en tjenesteadresse i klienten.
  5. Overlad betalinger til kundens administrator, som tilslutter betalingsgateways og opsætter den brandede checkout.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Beviset er scope-adherence. Den tillader kun en ubeskyttet /api-rute, når manifestet deklarerer netop den metode og sti som offentlig, og stien er en af login-ruterne; enhver anden offentlig deklaration fejler og navngiver de to tilladte stier. api-contract sammenligner derefter de deklarerede ruter med de faktiske i begge retninger. definePlugin afviser også en frontend.basePath, der ikke er en relativ sti med samme oprindelse.

White-label er tilføjelsen Storefront / white-label på Enterprise, som også giver licens til betalinger. Kortoplysninger berører aldrig Nexus. Kundens administrator ejer brandet, og platformen udleder det fra organisationen frem for fra Deres kode.

8. En Edge-missionspakke

Målet er en ny eller opdateret mission til en satellit eller drone, der kører Nexus Edge, for eksempel at tilføje en adapter til skibssøgning til en maritim overvågningsmission. Byggestenen er en missionspakke, der bygges og signeres på jorden.

  1. Tag udgangspunkt i den aktuelle pakke på siden Byg en missionspakke, som udarbejder den nye version ud fra den gamle og markerer hver ændring.
  2. Ændr kun det, missionen kræver. Hold de store dele, sprogmodellen og ontologien, stabile, når De kan.
  3. Kontrollér placeringstabellen ved hvert nedgraderet trin, så hvert board stadig kan rumme det, det kører.
  4. Kør pakkens testcases om bord på en testopstilling med de samme boards.
  5. Send den til signering: to ud af tre signaturer er påkrævet.
  6. Frigiv den til én platform. Den lægges i den ledige plads og aktiveres først, når dens testcases er bestået om bord.
  7. Udrul til den næste platform efter en uge uden fejl.
Missionspakker
Missionspakker
Biblioteket med missionspakker, med hvad hver pakke indeholder og de platforme, der kører den. Bemærk den ældre version, der bevares om bord, så man kan vende tilbage til den, og antallet af testcases, som hver pakke skal bestå på sin hardware.

Der er ingen kommandoer i denne opskrift; den udføres på konsollens Nexus Edge-sider. Beviset er testcasene om bord, som alle skal bestås, før pakken aktiveres, og de to signaturer. Hvis en test fejler om bord, forbliver platformen på sin tidligere pakke, og fejlen sendes ned ved næste overflyvning. Installation af en pakke på hardware, den ikke er kontrolleret til, afvises med PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge er en tilføjelse med licens pr. platform eller pr. flåde. Pakker forbliver gyldige, mens en platform er uden forbindelse. Uplinket er smalt, så planlæg størrelserne efter det: vores 1.5-udgivelse var 412 MB mod 9.8 GB for en pakke med en ny sprogmodel.

9. En air-gapped levering til en kunde

Målet er Deres plugin eller pakke installeret hos en kunde uden netværk. Byggestenene er et forseglet bundt fra @adverant/nexus-sovereign, Deres signeringsnøgle til udgivelser og kundens egne udgivelseskanaler.

  1. Byg pluginnet og dets images nøjagtigt som for en tilsluttet kunde, med alle kontroller grønne.
  2. Lav et forseglet bundt med profilen airgap, der indeholder images, migreringer, forhåndssignerede skills og en SBOM (software bill of materials) med licenserne.
  3. Signer det med Deres Ed25519-udgivelsesnøgle.
  4. Verificér det selv på en ren maskine.
  5. Send bundtet på et medie, og send Deres offentlige nøgle og bundtets SHA-256 ad en separat vej.
  6. Kundens operatør verificerer bundtet med Deres nøgle og fører derefter udgivelsen ind via sine egne udgivelseskanaler.
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 bygger bundtet ud fra Deres bundtkonfiguration. Beviset er nexus-airgap verify på kundens side. Den beregner hashværdien af hver fil igen, afviser enhver fil, som manifestet ikke angiver, kræver en betroet signatar og afviser et bundt, hvis netværkstilladelsesliste ikke er tom. En ændret fil fejler med BUNDLE_INTEGRITY_VIOLATION. Ingen bør nogensinde slå den strenge kontrol fra for at komme forbi den.

Air-gappede installationer er Enterprise. Intet i bundtet må hente noget under installationen, og en model, som pluginnet har brug for, kommer fra kundens egen modelserver via AI (kunstig intelligens) Provider Router.

10. Et modul kun til Enterprise

Målet er en lukket, licenseret funktion, der kobles på den åbne kerne, for eksempel et revisionsspor med lang opbevaring, der kun sælges til Enterprise-kunder. Byggestenen er interfacepakken @adverant/nexus-spi og intet andet fra Community.

  1. Hav en byte-fastlåst kopi af den byggede interfacepakke i Deres repository som en lokal file:-pakke med dens SHA256SUMS-fastlåsning.
  2. Skriv et RouteModule (eller et ScreenModule til konsolskærme) op imod den, med den funktionsgruppe, det betjener.
  3. Kør hver route bag ctx.requireScope, og kontrollér modulets egen tildeling, før der svares.
  4. Afvis med LICENCE_LOCKED, når organisationen ikke har ret til det, og vis funktionens teaser, aldrig dens data.
  5. Hold repositoryet til licensgrænsen, og byg derefter hver udgaves sammensatte træ.
npm ci
npm test
npm run build

Beviset er licensgrænsereglen: ingen import fra et Community-scope bortset fra interfacepakken, ingen relativ import ud af repositoryet og ingen file:-, link:- eller workspace:-afhængighed uden for det. Derefter skal de tre kommandoer ovenfor bestå i hver udgaves sammensatte træ, ikke kun i Deres arbejdstræ. Kapitel 2.25, Bygning til hver udgave, indeholder modulskelettet.

Et modul indlæses i en Community-tjeneste ved opstart på installationer, hvis licens omfatter dets funktionsgruppe. Uden den tildeling afviser det, så det samme build leveres overalt og intet gør, hvor det ikke er licenseret.

11. Forgrening eller udvidelse af open core

Målet er en ændring af selve Community, der bevares i Deres fork eller bidrages tilbage. Byggestenen er Community-kildekoden under Apache License, Version 2.0.

  1. Fork repositoryet, og lav en branch fra main.
  2. Foretræk et plugin eller en skill, hvis det, De ønsker, kan være det. En ændring af kernen skal De selv vedligeholde ved hver udgivelse.
  3. Foretag ændringen med tests, der fejler uden den.
  4. Kør de kontroller, projektet kører, før De foreslår noget.
  5. Bevar NOTICE-filen, og brug ikke Adverants navne eller varemærker ud over at angive, hvor arbejdet stammer fra.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Beviset er, at de tre kontroller består, samt dokumentation for, at hver ny test fejlede før Deres ændring. Bevar én egenskab ved den åbne kerne i Deres fork: Community kører en agent fra ende til anden på en lokal model uden nøgle og uden netværk. En ændring, der bryder det, bryder det, der gør Community anvendelig på egen hånd.

Dette gælder kun Community. Alt, der skal forblive lukket, hører i stedet hjemme i et Enterprise-modul (scenarie 10), så licensgrænsen forbliver et sted, alle kan pege på.

12. En cloud-app til Team-udgaven

Målet er en app, som Team-kunder kan installere. Team kører kun på Adverant cloud, så appen når kun ud til dem via kataloget. Byggestenene er et plugin og en udgiverklynge: Deres egen virtuelle klynge på Adverant cloud med eksempeldata.

  1. Byg og test på udgiverklyngen, kun med eksempeldata.
  2. Angiv alt, hvad appen har brug for, i dens manifest, og intet mere.
  3. Udgiv den signeret til Adverants gennemgang og en optagelse i kataloget.
  4. Hver kunde installerer den og tildeler hvert angivet scope enhed for enhed.

Beviset kommer i to dele. Den signerede, gennemgåede udgivelse bringer Dem ind i kataloget. Derefter afgør kundens tildeling, hvad appen kan nå hos kunden, og ethvert kald, den ikke har angivet, afvises med CONNECTION_SCOPE_EXCEEDED. De kan kun tilføje et manglende scope i en ny udgivelse, som kunden gennemgår.

Installer et tredjeparts-plugin
Installer et tredjeparts-plugin
En administrator, der installerer et tredjepartsplugin, tildeler hvert angivet scope pr. enhed og udelader ét. Pladen viser et kald, som pluginnet aldrig har angivet, blive afvist.

En udgiverklynge har ingen forbindelse til nogen kunde, og en anmodning om en kundes data dér afvises med TENANT_BOUNDARY. Kunder kan dele testresultater med Dem, aldrig deres data. Team omfatter funktionen til workflowdrift, så hvis Deres app leverer workflows, kan Team-kunder selv flytte dem mellem miljøer.

13. Indpakning af en eksisterende intern app som et plugin

Målet er en app, som Deres virksomhed allerede kører, bragt ind i Nexus, så den arver login, isolation og governance. Byggestenene er skillen /plugin-create til det første udkast og SDK'ets manifestværktøjer og kontroller til at færdiggøre den.

  1. Kør /plugin-create med repositoryet. Den analyserer koden og vælger en indpakningsstrategi og genererer derefter backend, migreringer, brugergrænseflade (UI), manifest og tests.
  2. Løft manifestet til v2-kontrakten. migrate tilføjer de tre lovsætninger og flytter domain til domains[], og den nægter at opfinde et entrypoint.
  3. Erstat enhver tenantværdi, som indpakningen læser fra headers, med SDK'ets scope guard.
  4. Tilføj organization_id, owner_user_id og business_unit_id til hver tabel, med primærnøgler, der starter med tenant.
  5. Angiv hver route med dens rettighed, og installér afvisningsloggen.
  6. Kør kontrollerne, indtil de er grønne.
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

Beviset er, at nexus-gates afslutter med 0, og at scope-adherence, one-fence, migrations-are-scoped, crud-adherence og api-contract alle består. Forvent, at den første kørsel fejler på de fleste af dem; vores rapporterede hver route som uden scope, fordi udkastet stolede på headers, som browseren kunne sætte. Kontrollerne har bevidst ingen rettelsesknap.

Indpakkede apps fungerer på enhver udgave. Udrulning sker kun via installationens udgivelseskanaler, så se bort fra eventuelle udrulningsfiler, som udkastet har skrevet. Isolationsarbejdet er det, der tager tid: planlæg med dage for en rigtig app, ikke timer.