Logg innBestill en gjennomgang

Kapittel 2.27

Byggescenarioer

En kokebok med tretten bygg, fra én enkelt ferdighet til en luftgapet levering. Hver oppskrift gir målet, byggeklossene, trinnene og kommandoene, kontrollpunktet som beviser at det fungerte, og hva som endres etter utgave og leveringsform.

Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

25 minutter å lese

Dette er oppskriftene jeg tyr til når noen hos Corrán Orbital, eller hos en kunde, sier «vi vil at Nexus skal gjøre X». Hver av dem er kort med vilje. Begrunnelsen for stegene står i kapitlene før dette: kapittel 2.20, Ferdigheter, og kapittel 2.21, Plugin SDK, som dekker programvareutviklingssettet, deretter kapittel 2.23, Domenepakker, og de tre kapitlene etter det om bygging. Her får du målet, hvilke byggeklosser du skal bruke, stegene, kommandoene, porten som forteller deg at det fungerte, og merknadene om utgave og levering.

Porten er det viktigste. En oppskrift er ferdig når porten er grønn. Hver port i dette kapitlet er noe du kan kjøre eller noe plattformen kjører for deg, og hver av dem avslutter med en annen kode enn null eller avviser med en kode når den ikke er oppfylt.

Scenario Hovedbyggekloss Porten som beviser det Utgave
En ny ferdighet i Skills Engine SKILL.md-pakke skill:validate uten feil Community og Enterprise
En manifestferdighet med host_callback Pluginmanifest skills[] create-nexus-plugin validate og nexus-gates Community og Enterprise
Utvide en eksisterende pakke pack.json med inherits Policykontroll av linser ved pilotporten Enterprise og en pakkelisens
En ny pakke fra bunnen av Standardveien for domenepakker Staging- og pilotporter Enterprise
En datakobling plugin_queue-ferdighet validate, nexus-gates, avvisning av utgående trafikk Community og Enterprise
Et MCP-verktøy (Model Context Protocol) Manifest mcpTools[] validate (ingen kombinatorer på toppnivå) Community og Enterprise
En white-label-butikk Manifest domains og branding Offentlig regel i scope-adherence Enterprise og Storefront-tillegget
En Edge-oppdragspakke Oppdragspakke Testtilfeller om bord, to av tre signaturer Enterprise og Nexus Edge-tillegget
En luftgapet levering Forseglet pakke nexus-airgap verify Enterprise
En modul kun for Enterprise @adverant/nexus-spi Lisensgrenseport, utgavebygg Enterprise
Forgrene eller utvide den åpne kjernen Community-kildekoden Tester, lint og typekontroll Community
En skyapp for Team-utgaven Utgiverklynge Signert utgivelse, gjennomgang, kundetildeling Team
Pakke inn en eksisterende intern app /plugin-create migrate, validate, nexus-gates Community og Enterprise
Et beslutningstre som leses ovenfra og ned. Den første ruten spør «Trenger den kode som kjører hele tiden?». «Nei» fører til en rute «Er det instruksjoner for en assistent?», der «Ja» ender i «Skills Engine-ferdighet» og «Nei» ender i «Linse på en eksisterende pakke». «Ja» fører til en rute «Er det én bransjes visning av plattformen?», der «Ja» ender i «Domenepakke (med sitt programtillegg)» og «Nei» fører til en siste rute «Må den forbli lukket og lisensiert?», som ender i «Enterprise-modul» for «Ja» og «Programtillegg» for «Nei».
Hvilken byggekloss du skal starte med.

1. En ny Skills Engine-ferdighet

Målet er en gjenbrukbar instruksjon som assistenten, agenter, arbeidsflyter og utviklerverktøy alle kan kjøre, for eksempel å kontrollere en tolldeklarasjon mot reglene for den. Byggeklossene dine er en SKILL.md-pakke i en mappe oppkalt etter ferdigheten, en valgfri skill.yaml for utløsere og tagger, og en valgfri scripts/-mappe som følger med.

  1. Opprett skills/<slug>/ og skriv SKILL.md med frontmatter: name (kebab-case, lik mappenavnet), description (opptil 500 tegn), allowed-tools, og eventuelt triggers, capabilities og version.
  2. Skriv innholdet for modellen: når ferdigheten skal brukes, stegene, eksempler og hva den aldri må gjøre.
  3. Legg til testtilfeller. Ta med ett med en instruksjon plantet i inndataene som ferdigheten ikke må følge.
  4. Valider, se gjennom opplastingsplanen, og last deretter opp.
  5. Publiser. En ferdighet som legger til et skriveverktøy, holdes tilbake til to navngitte personer godkjenner den med passnøkler, og forslagsstilleren kan ikke godkjenne sin egen endring.
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

Porten er skill:validate, som må rapportere null feil før noe kan publiseres. De blokkerende feilene er manglende navn eller beskrivelse og duplisert slug eller jobbtype. Opplasting av innhold som allerede er publisert, returnerer den eksisterende versjonen (CONTENT_HASH_ALREADY_PUBLISHED), så opplastingen er trygg å gjenta.

Community får hele verktøyet for å lage ferdigheter, biblioteket, versjoner, tilbakestilling, import og tester. På Enterprise går publisering også gjennom skygge- og kanarifase: den godkjente versjonen kjører i skygge, deretter for én enhet bak navngitte porter, deretter for alle, og den stopper seg selv hvis en port ikke er oppfylt. For en luftgapet kunde reiser ferdighetene forhåndssignert inne i den forseglede pakken (scenario 9).

2. En manifestferdighet med host_callback

Målet er deterministisk beregning i din egen plugin som plattformen kan sende jobber til, for eksempel å åpne en avviksregistrering ut fra en måling. Du bruker en rad i manifestets skills[] med nivået host_callback, og en /internal-rute i backend som er beskyttet av SDK-ens tjenestevakt.

  1. Deklarer ferdigheten: id i lower_snake, tier: "host_callback", en classification på eller under pluginens tillitstak, inputSchema, outputSchema og en timeoutMs mellom 1 sekund og 6 timer.
  2. Fyll ut hostCallback: navnet på din egen Service, porten, en relativ sti som /internal/skills/excursion_open, begge bytegrensene (maxRequestBytes og maxResponseBytes), og tenantHeader: "X-Organization-ID".
  3. Deklarer ruten i api.endpoints[] med auth: "service-key" eller auth: "internal", og beskytt den med requireService eller serviceMiddleware, aldri med brukeromfangsvakten.
  4. Valider, kjør portene, og la onboardingen synkronisere ferdighetene til registeret gjennom compileRegistry. Du skriver aldri register-SQL for hånd.
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 noe synkroniseres, og hvert brudd avvises med mottakerens kode. En sti med et skjema, // eller en omvendt skråstrek avvises som kryssopprinnelse. En manglende bytegrense gir ENDPOINT_BYTE_CAP_REQUIRED, et felt fra et annet nivå gir FIELD_NOT_FOR_TIER, og et tidsavbrudd utenfor området gir TIMEOUT_OUT_OF_BOUNDS. Deretter kontrollerer nexus-gates at /internal-ruten har tjenestevakten og er deklarert internal eller service-key. Det portparet er beviset.

Synkronisering er deklarativ. Send hele settet med ferdigheter hver gang, fordi en ferdighet du utelater, blir deaktivert, og la distribusjonssteget feile ved enhver annen status enn 200. På Enterprise kontrolleres en pluginsynkronisering samlet: hvis én ferdighet bryter en regel, tas ingenting av den synkroniseringen inn (PLUGIN_SYNC_ALL_OR_NOTHING), og den forrige versjonen fortsetter å kjøre. En plugin med community-tillit kan ikke bruke nivåene som når en modell, tool_using og llm_only; de krever tillit core eller verified.

Plugins og MCP-synkronisering
Plugins og MCP-synkronisering
Plugins som tilfører ferdigheter, og hva hver synkronisering ble kontrollert for. Legg merke til pluginen der hele synkroniseringen ble avvist fordi én av de fem ferdighetene brukte et nivå som bare plattformen kan være vert for, mens den forrige versjonen fortsatte å kjøre.

3. Utvide en eksisterende pakke

Målet er en ny bransje eller underbransje som gjenbruker det meste av en eksisterende pakke, for eksempel utlån og korttvister basert på strukturen i Insurance-pakken. Byggeklossen er en pack.json som angir forelderen i inherits og bare legger til egne linseklynger og ord.

  1. Start pakken med standardveien for domenepakker, og sett deretter inherits til forelderpakkens id.
  2. Legg til dine egne lens-klynger, hver med sine plasser, formål og leksikonreferanse.
  3. Legg ordene dine til i leksikonet med en enkel forklaring for hvert. Merk et begrep exact der det må vises slik det er skrevet.
  4. Gjenbruk delte linser i stedet for å lage dine egne: et regelverk som flere pakker trenger, for eksempel et register over utkontraktert teknologi, er én delt linse.
  5. Kontroller lisenskjeden. Pakken din arver forelderens krav til tillegg.
  6. Forhåndsvis hver linse som en person på en syntetisk gren.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Beviset er pilotportens policykontroll, som bekrefter at hver linse bare snevrer inn basen sin og holder personopplysningsfelt avslått som standard. En linse som prøver å vise det basen skjuler, avvises med LENS_CANNOT_WIDEN. På lisenssiden nekter konsollen å utstede en lisens for pakken din uten tilleggene forelderen trenger; Insurance-pakken trenger Beslutningsrom og forseglede registreringer.

Domenepakker er Enterprise og lisensieres per pakke. En pakkes telefonskjermer krever også tillegget Mobilapper. En underpakke kan ikke endre skallet, komponentene eller skrivereglene.

4. En ny pakke fra bunnen av

Målet er én bransjes syn på Nexus: kunnskapsmodellen, linsene for hver rolle, dokumentasjonen reglene krever, og pluginen som holder dataene oppdatert. Kapittel 2.24, Bygge en tilpasset vertikal fra start til slutt, går gjennom denne byggingen i sin helhet; her er kortversjonen.

  1. Kjør standardveien for domenepakker og beskriv pakken: formål, enheter, basismodellen og reglene den kartlegger.
  2. Bygg kunnskapsmodellen på en basismodell og klassifiser hver egenskap etter hvert som du legger den til.
  3. Les planen, bekreft fingeravtrykket med passnøkkelen din, og opprett.
  4. Form linsene i Lens builder, der hver snevrer inn en basislinse.
  5. Skriv pluginen og eventuelle Skills Engine-ferdigheter pakken trenger.
  6. Generer seedede syntetiske data med de uvanlige tilfellene du bryr deg om, og forhåndsvis hver linse som en person.
  7. Forfrem fra utviklingsområdet til staging, til en pilotenhet og deretter til alle enheter.

Beviset er forfremmelsesportene: alle tester bestått på de syntetiske grenene inn i staging, deretter to kontrollører som ikke er forfatteren, deretter 14 dager i piloten med færre enn 1 feil per 1 000. Ingen steg kan hoppes over (GATE_CANNOT_BE_SKIPPED). Pakker er Enterprise. På Community tilbys ikke standardveien for domenepakker.

5. En datatilkobling

Målet er at data fra et eksternt system flyter inn i pluginens egne tabeller etter en tidsplan, for eksempel porthendelser fra et terminaloperativsystem. Byggeklossene er en plugin_queue-ferdighet, en arbeider som henter fra køen din, en migrering for måltabellen og en utgående adresse deklarert i manifestet.

  1. Deklarer en plugin_queue-ferdighet med queueName skrevet <plugin name>.<name>. Kolon er ikke tillatt, og navnet må stå i manifestet, fordi orkestratoren legger jobber direkte i den.
  2. Skriv arbeideren som henter fra køen og kaller det eksterne systemet.
  3. Deklarer det eksterne systemets adresse som en utgående adresse. Alt som ikke er oppført, blokkeres.
  4. Lagre det som kommer inn i ditt eget skjema, med organization_id, owner_user_id og business_unit_id på hver rad.
  5. Les det eksterne systemets legitimasjon ved navn fra miljøet, og oppfør variabelen i scripts/ci/required-env.
  6. Send hentingene gjennom UNO, arbeidsflytmotoren, aldri med en timer som kaller 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 tidsavbruddet mot registersynkroniseringens regler. De tre portene beviser at det ikke finnes modellegitimasjon, ingen direkte beregning og en tabell med riktig omfang. Kjør hele nexus-gates før du pusher, siden --only snevrer inn kjøringen og sier det i sammendraget. Ved kjøring stoppes et kall til en adresse manifestet ikke deklarerte, ved kanten med EGRESS_NOT_DECLARED.

Plattformens egne koblinger til disker, wikier, e-postlagre og eldre systemer, med endringsregistrering og datalinje, følger med tillegget Datakoblinger. En kobling du bygger selv, er en plugin og fungerer på alle utgaver. Å legge til en utgående adresse i en senere utgivelse er en utvidelse, som holdes tilbake til to kontrollører godtar den.

6. Et MCP-verktøy

Målet er et verktøy som Claude Code, agenter og andre MCP-klienter (Model Context Protocol) kan kalle, for eksempel for å slå opp et fartøys inspeksjonshistorikk. Byggeklossen er en oppføring i manifestets mcpTools[], med en name, en description og et inputSchema.

  1. Gi verktøyet et navn og beskriv det tydelig. Beskrivelsen er det en modell leser for å avgjøre om den skal kalle det.
  2. Skriv inputSchema som ett objektskjema. Ikke plasser oneOf, allOf eller anyOf på toppnivået.
  3. Hold ruten som betjener verktøyet bak omfangsvakten, som alle andre /api-ruter, slik at leietakertilhørighet kommer fra innringerens token.
  4. Valider manifestet.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Beviset er validate: en kombinator på toppnivå avvises allerede under utformingen, fordi den ved kjøring ville få verktøyet til å feile for alle MCP-underagenter som importerer det, og verktøyet ville eksistere uten at noen kunne kalle det.

På Enterprise er hvert verktøy et IDE (integrert utviklingsmiljø) kan kalle, oppført i Workbench-verktøykatalogen med nivå, om det endrer noe, et fastlåst fingeravtrykk og rollene som kan bruke det. Hvis verktøyets beskrivelse endres i en ny utgivelse, holder katalogen verktøyet tilbake til en person har gjennomgått endringen. Det er tilsiktet: en endret beskrivelse er måten et verktøy kan begynne å be en modell om noe det ikke burde. Et kall til noe utenfor innringerens tilgang avvises med CONNECTION_SCOPE_EXCEEDED.

7. En white-label-butikkfront

Målet er en app som kundens egne kunder bruker, på kundens domene og i kundens merkevare, uten spor av Adverant. Byggeklossene er manifestets domains- og branding-blokker, SDK-ens påloggingshjelpere og kundens Storefront / white-label-tillegg.

  1. Sett kundens domene i domains[] som primary, med eventuelle aliases.
  2. Fyll ut branding: appName, tagline, primaryColor, accentColor, en passkeyRpId lik domenet, og oauthClientRef.
  3. Logg inn personer gjennom SDK-ens påloggingshjelpere, og deklarer de to offentlige rutene deres nøyaktig, med auth: "public" og allowAnonymous: true.
  4. Send alle frontend-kall gjennom tillatelseslisteproxyen i backend for frontend. Legg aldri en tjenesteadresse i klienten.
  5. Overlat betalinger til kundens administrator, som kobler til betalingsløsninger og setter opp den merkevaretilpassede kassen.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Beviset er scope-adherence. Den godtar en ubeskyttet /api-rute bare når manifestet deklarerer nøyaktig den metoden og stien som offentlig og stien er en av påloggingsrutene; enhver annen offentlig deklarasjon feiler og angir de to tillatte stiene. api-contract sammenligner deretter de deklarerte rutene med de faktiske i begge retninger. definePlugin avviser også en frontend.basePath som ikke er en relativ sti med samme opprinnelse.

White-label er tillegget Storefront / white-label på Enterprise, som også lisensierer betalinger. Kortopplysninger berører aldri Nexus. Kundens administrator eier merkevaren, og plattformen henter den fra organisasjonen i stedet for fra koden din.

8. En Edge-oppdragspakke

Målet er et nytt eller oppdatert oppdrag for en satellitt eller drone som kjører Nexus Edge, for eksempel å legge til en skipssøkeradapter i et maritimt overvåkingsoppdrag. Byggesteinen er en oppdragspakke, bygget og signert på bakken.

  1. Start fra den gjeldende pakken på siden Bygg en oppdragspakke, som lager et utkast til den nye versjonen fra den gamle og markerer hver endring.
  2. Endre bare det oppdraget trenger. Hold de store delene, språkmodellen og ontologien, stabile når du kan.
  3. Kontroller plasseringstabellen ved hvert degradert trinn, slik at hvert kort fortsatt passer til det det kjører.
  4. Kjør pakkens testtilfeller om bord på en testrigg med de samme kortene.
  5. Send den til signering: to av tre signaturer kreves.
  6. Frigi den til én plattform. Den legges i det ledige sporet og aktiveres først etter at testtilfellene består om bord.
  7. Rull ut til neste plattform etter en uke uten feil.
Oppdragspakker
Oppdragspakker
Biblioteket med oppdragspakker, med hva hver pakke inneholder og plattformene som kjører den. Legg merke til den eldre versjonen som beholdes om bord for å kunne gå tilbake, og antallet testtilfeller hver pakke må bestå på maskinvaren sin.

Det finnes ingen kommandoer i denne oppskriften; den utføres på Nexus Edge-sidene i konsollen. Beviset er testtilfellene om bord, som alle må bestå før pakken aktiveres, og de to signaturene. Hvis en test feiler om bord, forblir plattformen på sin forrige pakke, og feilen sendes ned ved neste passering. Installasjon av en pakke på maskinvare den ikke er kontrollert for, avvises med PACK_NOT_CHECKED_FOR_HARDWARE.

Nexus Edge er et tillegg, lisensiert per plattform eller per flåte. Pakker forblir gyldige mens en plattform er uten kontakt. Opplinken er smal, så planlegg størrelser ut fra den: vår 1.5-utgivelse var på 412 MB, mot 9.8 GB for en pakke med en ny språkmodell.

9. En luftgapet levering til en kunde

Målet er at programtillegget eller pakken din installeres hos en kunde uten nettverk. Byggesteinene er en forseglet pakke fra @adverant/nexus-sovereign, signeringsnøkkelen din for utgivelser og kundens egne utgivelseskanaler.

  1. Bygg programtillegget og avbildningene nøyaktig som for en tilkoblet kunde, med alle kontrollpunkter grønne.
  2. Lag en forseglet pakke med profilen airgap, som inneholder avbildningene, migreringene, forhåndssignerte ferdigheter og en SBOM (programvarestykkliste) med lisensene.
  3. Signer den med Ed25519-utgivelsesnøkkelen din.
  4. Verifiser den selv på en ren maskin.
  5. Send pakken på et lagringsmedium, og send den offentlige nøkkelen din og pakkens SHA-256 via en separat kanal.
  6. Kundens operatør verifiserer pakken med nøkkelen din og tar deretter inn utgivelsen gjennom sine egne utgivelseskanaler.
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 pakken fra pakkekonfigurasjonen din. Beviset er nexus-airgap verify på kundens side. Den beregner hash for hver fil på nytt, avviser alle filer som manifestet ikke oppgir, krever en klarert signatar og avviser en pakke der listen over tillatte nettverk ikke er tom. En endret fil feiler med BUNDLE_INTEGRITY_VIOLATION. Ingen skal noen gang slå av streng kontroll for å komme forbi dette.

Luftgapede installasjoner er Enterprise. Ingenting i pakken kan hente noe ved installasjon, og en modell som programtillegget trenger, kommer fra kundens egen modellserver via KI-leverandørruteren (kunstig intelligens).

10. En modul kun for Enterprise

Målet er en lukket, lisensiert funksjon som kobles til den åpne kjernen, for eksempel et revisjonsspor med lang lagringstid som bare selges til Enterprise-kunder. Byggesteinen er grensesnittpakken @adverant/nexus-spi, og ingenting annet fra Community.

  1. Ha en byte-låst kopi av den bygde grensesnittpakken i repositoriet ditt som en lokal file:-pakke, med sin SHA256SUMS-låsing.
  2. Skriv en RouteModule (eller en ScreenModule for konsollskjermer) mot den, med funksjonsgruppen den betjener.
  3. Kjør hver rute bak ctx.requireScope, og kontroller modulens egen tildeling før du svarer.
  4. Avvis med LICENCE_LOCKED når organisasjonen ikke har rett til den, og vis funksjonens smakebit, aldri dataene.
  5. Hold repositoriet innenfor lisensgrensen, og bygg deretter hver utgaves sammensatte tre.
npm ci
npm test
npm run build

Beviset er lisensgrenseregelen: ingen import fra et Community-omfang unntatt grensesnittpakken, ingen relativ import ut av repositoriet og ingen file:-, link:- eller workspace:-avhengighet utenfor det. Deretter må de tre kommandoene ovenfor bestå i hvert sammensatte utgavetre, ikke bare i arbeidstreet ditt. Kapittel 2.25, Bygging for hver utgave, inneholder modulskjelettet.

En modul lastes inn i en Community-tjeneste ved oppstart, på installasjoner der lisensen omfatter funksjonsgruppen. Uten den tildelingen avviser den, så det samme bygget leveres overalt og gjør ingenting der det ikke er lisensiert.

11. Forgrene eller utvide den åpne kjernen

Målet er en endring i selve Community, beholdt i forken din eller bidratt tilbake. Byggesteinen er Community-kildekoden under Apache License, Version 2.0.

  1. Fork repositoriet og lag en gren fra main.
  2. Velg heller et programtillegg eller en ferdighet hvis det du ønsker kan være det. En endring i kjernen må du selv vedlikeholde ved hver utgivelse.
  3. Gjør endringen med tester som feiler uten den.
  4. Kjør kontrollene prosjektet kjører før du foreslår noe.
  5. Behold NOTICE-filen, og ikke bruk Adverants navn eller varemerker utover å oppgi hvor arbeidet kom fra.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Beviset er at disse tre kontrollene består, i tillegg til dokumentasjon på at hver nye test feilet før endringen din. Bevar én egenskap ved den åpne kjernen i forken din: Community kjører en agent fra ende til ende på en lokal modell uten nøkkel og uten nettverk. En endring som bryter dette, bryter det som gjør Community brukbar på egen hånd.

Dette gjelder bare Community. Alt som må forbli lukket, hører i stedet hjemme i en Enterprise-modul (scenario 10), slik at lisensgrensen forblir et sted alle kan peke på.

12. En skyapp for Team-utgaven

Målet er en app som Team-kunder kan installere. Team kjører bare på Adverant cloud, så appen når dem bare gjennom katalogen. Byggesteinene er et programtillegg og en utgiverklynge: din egen virtuelle klynge på Adverant cloud med eksempeldata.

  1. Bygg og test på utgiverklyngen, kun med eksempeldata.
  2. Deklarer alt appen trenger i manifestet, og ikke noe mer.
  3. Frigi den signert, for gjennomgang hos Adverant og oppføring i katalogen.
  4. Hver kunde installerer den og tildeler hvert deklarerte omfang enhet for enhet.

Beviset kommer i to deler. Den signerte, gjennomgåtte utgivelsen gir deg plass i katalogen. Deretter avgjør kundens tildeling hva appen kan nå hos kunden, og ethvert kall den ikke har deklarert, avvises med CONNECTION_SCOPE_EXCEEDED. Du kan bare legge til et manglende omfang i en ny utgivelse som kunden gjennomgår.

Installer en tredjeparts plugin
Installer en tredjeparts plugin
En administrator som installerer et programtillegg fra en tredjepart, tildeler hvert deklarerte omfang per enhet og utelater ett. Bildet viser et kall programtillegget aldri deklarerte, avvist.

En utgiverklynge har ingen rute til noen kunde, og forespørsler om en kundes data der avvises med TENANT_BOUNDARY. Kunder kan dele testresultater med deg, aldri dataene sine. Team inkluderer funksjonen for arbeidsflytdrift, så hvis appen din leverer arbeidsflyter, kan Team-kunder selv flytte dem mellom miljøer.

13. Pakke inn en eksisterende intern app som en plugin

Målet er en app bedriften din allerede kjører, tatt inn i Nexus slik at den arver pålogging, isolasjon og styring. Byggesteinene er ferdigheten /plugin-create for det første utkastet, og SDK-ens manifestverktøy og kontrollpunkter for å fullføre det.

  1. Kjør /plugin-create med repositoriet. Den analyserer koden og velger en innpakningsstrategi, og genererer deretter backend, migreringer, brukergrensesnitt (UI), manifest og tester.
  2. Løft manifestet til v2-kontrakten. migrate legger til de tre lovsetningene og flytter domain til domains[], og den nekter å finne opp et inngangspunkt.
  3. Erstatt alle leietakerverdier som innpakningen leser fra hoder, med SDK-ens omfangsvakt.
  4. Legg til organization_id, owner_user_id og business_unit_id i hver tabell, med primærnøkler som starter med leietaker.
  5. Deklarer hver rute med sin rettighet, og installer avvisningsloggen.
  6. Kjør kontrollpunktene til 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 avslutter med 0, med scope-adherence, one-fence, migrations-are-scoped, crud-adherence og api-contract bestått. Regn med at den første kjøringen feiler på de fleste av dem; vår rapporterte hver rute som uten omfang, fordi utkastet stolte på hoder som nettleseren kunne sette. Kontrollpunktene har med vilje ingen bryter for automatisk retting.

Innpakkede apper fungerer på alle utgaver. Utrulling skjer bare gjennom installasjonens utgivelseskanaler, så se bort fra eventuelle utrullingsfiler utkastet har skrevet. Det er isolasjonsarbeidet som tar tid: planlegg for dager på en reell app, ikke timer.