Verżjoni 1.0.0-alpha.1l-aħħar
Kapitlu 2.25
Il-bini għal kull edizzjoni
X'jinbidel meta estensjoni waħda trid taħdem f'kull edizzjoni, fuq sit iżolat (air-gapped), fuq tagħbija ta' Nexus Edge jew wara d-ditta proprja ta' klijent. Tkopri l-linja tal-liċenzja għall-moduli Enterprise u t-twassil offline iffirmat, b'matriċi ta' x'għandek tagħmel b'mod differenti għal kull mira.
Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

F'Corrán Orbital aħna nibagħtu f'aktar postijiet milli jagħmlu ħafna timijiet. L-inġiniera tagħna stess iħaddmu Enterprise fuq l-art. Satellita, CORR-3, tħaddem pakkett tal-missjoni fuq Nexus Edge. Żewġ klijenti jħaddmu Community fuq server wieħed, wieħed iħaddem installazzjoni Enterprise iżolata (air-gapped) li qatt ma tara l-internet, u bnejna pakkett għal assiguratur fuq l-installazzjoni tiegħu stess. Il-kodiċi ta' taħt huwa fil-biċċa l-kbira l-istess, u d-differenzi huma fil-biċċa l-kbira dwar fejn huwa permess li jmur u kif jasal hemm.
Dan il-kapitlu jgħaddi minn kull destinazzjoni waħda wara l-oħra: kontra xiex tibnu, x'ma tistgħux tmissu, u kif ir-riżultat jasal għand il-klijent. Matriċi fl-aħħar tiġbor kollox f'paġna waħda. Il-Kapitlu 2.18, Il-mudell tal-estensjonijiet, jispjega kif ivarjaw il-ħiliet, il-plugins, il-pakketti u l-moduli. Il-Kapitlu 2.2, L-edizzjonijiet minn ġewwa, jiddeskrivi l-edizzjonijiet infushom.
Community u l-qalba miftuħa
Community hija l-qalba miftuħa, taħt l-Apache License, Version 2.0. Tistgħu tagħmlu fork tagħha u tibagħtu bidliet fiha. Il-fajl NOTICE li jivvjaġġa magħha jgħid ħaġa waħda li jaqbel tkunu tafuha qabel ma timmarkaw xi ħaġa bil-marka tagħkom: il-liċenzja ma tagħtix l-użu tal-ismijiet jew tat-trademarks ta' Adverant lil hinn milli tgħid minn fejn ġej ix-xogħol.
Testendu Community bl-istess mod li testendu Enterprise. Il-Plugin SDK (software development kit) huwa l-istess pakkett fiż-żewġ edizzjonijiet, u la l-mudell tas-servizz sħiħ u lanqas it-22 xatba ta' konformità ma jinbidlu; il-kapitlu 2.21, Il-Plugin SDK, jittratta dan. Il-ħiliet jaħdmu wkoll. Community tieħu l-kreatur u l-librerija sħaħ tal-Skills Engine, b'verżjonijiet u testijiet, filwaqt li r-rilaxxi canary u l-approvazzjoni minn żewġ persuni jibqgħu ma' Enterprise.
Il-paġni tal-iżviluppaturi fuq Community joffru l-istess golden paths bi tliet differenzi li tħossuhom minnufih:
- Il-kodiċi tagħkom jinsab f'GitHub minflok fir-repożitorji tal-installazzjoni stess. Il-golden path tal-plugin joħloq repożitorju GitHub u spazju tal-iżvilupp mill-istess mudell imwaħħal li juża Enterprise; l-iskrin DV18 juri lilu joħloq
room-bookings. - Il-golden paths tal-pakkett tad-dominju u tal-pjattaforma huma ta' Enterprise. Fuq Community tibnu plugins u ħiliet, flimkien ma' lenses u workflows fuq dak li tħaddmu.
- Il-passes ta' Community jieqfu taħt il-livell Elevate. Fuq server wieħed m'hemmx produzzjoni x'tilħqu minn IDE (integrated development environment), u l-amministrazzjoni tas-server tagħmluha direttament. Tentattiv mill-IDE jiġi rrifjutat b'
PASS_TIER_REQUIRED.
Spazju tal-iżvilupp Community fuq server żgħir huwa modest. Tagħna kellu 2 cores u 8 GiB ta' memorja, magħluq għajr dak li jiddikjara l-manifest, u ntemm wara 7 ijiem inattivi.
Il-kontribuzzjoni lura
L-Skills Engine huwa wkoll Apache-2.0, u jaċċetta kontribuzzjonijiet bil-mod tas-soltu. Agħmlu fork tar-repożitorju, oħolqu branch minn main, agħmlu l-bidla bit-testijiet tagħha, u ħaddmu l-kontrolli qabel ma tiftħu pull request:
git checkout -b feature/skill-synthesis-validation
npm test
npm run lint
npm run typecheckKontribuzzjoni li tbiddel l-imġiba teħtieġ test li jfalli mingħajrha. Dan mhuwiex stil tad-dar: ir-regoli tal-ittestjar tal-SDK stess jgħidu li kull test ġdid irid jintwera li jfalli fuq is-siġra ta' qabel il-bidla, u r-reviżuri jitolbu l-evidenza.
Il-moduli Enterprise u l-linja tal-liċenzja
Enterprise hija Community flimkien ma' moduli liċenzjati. Modulu liċenzjat huwa artefatt separat li servizz Community jgħabbi meta jibda, u huwa l-mod kif il-funzjonalitajiet ta' Enterprise, u kull modulu magħluq li tibnu għall-klijenti Enterprise, jingħaqdu mal-qalba miftuħa.
Ir-regola li tagħmel dan jaħdem hija l-linja tal-liċenzja. Modulu magħluq jista' jilħaq l-edizzjoni Community permezz ta' pakkett wieħed biss, @adverant/nexus-spi, l-interfaċċa tal-fornitur tas-servizz. Huwa Apache-2.0 u fih interfaċċi flimkien mal-type guards li host u modulu jużaw biex jivverifikaw lil xulxin, mingħajr ebda loġika oħra fil-ħin tal-eżekuzzjoni. L-akkoppjar minn naħa għall-oħra tal-linja huwa interfaċċa jew protokoll tan-netwerk, qatt kodiċi sors.
| Esportazzjoni | X'inhu |
|---|---|
RouteModule |
Modulu tar-rotot liċenzjat: id, featureGroup, bodies u register(app, ctx), li jimmonta r-routers tiegħu fuq l-app tal-host |
SpiApp |
Il-parti tal-app HTTP tal-host li jmiss modulu: use |
SpiContext |
Dak li l-host jgħaddi lil modulu: ix-xatba tal-prodott u l-gwardja tal-ambitu, il-qarrej tal-liċenzja, il-pool tal-mistoqsijiet b'ambitu, l-iskema tas-servizz, l-indirizzi upstream u l-klijenti tal-pjattaforma |
SpiRuntime |
Il-valuri tal-plugin SDK li host jgħaddi lil modulu, sabiex il-modulu qatt ma jimporta r-runtime tal-SDK huwa stess |
SpiPlane |
Dak li jżid pjan liċenzjat apparti r-rotot, bħall-qari tal-iskrins li jservi |
ScreenModule |
Grupp ta' skrins liċenzjati ta' console: group, featureGroup, routes, screens u menu |
GrantCheck |
(featureGroup) => Promise<{ entitled, code?: 'LICENCE_LOCKED' }> |
Il-framework HTTP u t-tip tal-iskrin tal-console huma parametri tat-tip, għalhekk l-interfaċċa ma torbot l-ebda wieħed minnhom. Hawn hu l-iskeletru ta' modulu tar-rotot, b'tip ta' handler Express:
import type { GrantCheck, RouteModule, SpiApp, SpiContext } from "@adverant/nexus-spi";
import { Router, type RequestHandler } from "express";
export function auditTrail(checkGrant: GrantCheck): RouteModule<RequestHandler> {
return {
id: "audit-trail",
featureGroup: "<feature-group>",
bodies: [],
register(app: SpiApp<RequestHandler>, ctx: SpiContext<RequestHandler>) {
const router = Router();
router.get("/api/audit-trail", ...ctx.requireScope, async (_req, res) => {
const verdict = await checkGrant("<feature-group>");
if (!verdict.entitled) {
res.status(403).json({
error: true,
code: verdict.code,
message: "This organisation's licence does not carry the audit trail.",
troubleshooting: ["An owner or administrator can turn it on with a licence from Adverant."],
});
return;
}
res.json({ entries: [] });
});
app.use(router);
},
};
}<feature-group> huwa l-grupp ta' funzjonalitajiet tal-matriċi tal-edizzjonijiet li jservi l-modulu. Kull rotta liċenzjata taħdem wara ctx.requireScope, ix-xatba tal-prodott u l-gwardja tal-ambitu tal-host, u l-modulu jivverifika wkoll l-għotja tiegħu stess qabel ma jwieġeb. Modulu li ma għandux id-dritt jirrifjuta b'LICENCE_LOCKED u juri t-teaser tal-funzjonalità, qatt id-data tagħha. Il-modulu tagħkom lanqas qatt ma jimporta r-runtime tal-plugin SDK, għaliex l-SDK huwa pakkett Community li l-linja ma tammettix. Il-host jgħaddilu l-valuri tal-SDK li jsejjaħ. Qabel ma jgħabbi kwalunkwe modulu, il-host jinstalla SpiHost fuq globalThis taħt Symbol.for(SPI_HOST_KEY), li fih ir-runtime tal-SDK u l-kit tar-rotot tal-app stess. Dan irid isir l-ewwel: modulu kkompilat f'bundle wieħed jiġi evalwat kollu f'daqqa, u sejħa register tasal tard wisq għal kodiċi li jaqra l-valuri tal-SDK waqt li jitgħabba. Għat-tipi, @adverant/nexus-spi/sdk/<module> jerġa' jesporta d-dikjarazzjonijiet tal-SDK, ikkupjati mingħajr bidla minn rilaxx wieħed tal-SDK u mwaħħla b'checksum, sabiex il-modulu tagħkom jgħaddi l-verifika tat-tipi kontra l-istess korpi ta' rifjut u klijenti li juża plugin.
Modulu tal-iskrins isegwi regola oħra: modulu wieħed għal kull grupp ta' funzjonalitajiet, għalhekk grupp li l-iskrins tiegħu jappartjenu għal żewġ gruppi ta' funzjonalitajiet jinbagħat bħala żewġ moduli, u wieħed biss minnhom iġorr ir-ringiela tal-menu.
Dak li tirrifjuta x-xatba tal-linja tal-liċenzja
Ix-xatba tal-linja tal-liċenzja ta' Adverant iżżomm kull modulu Enterprise mal-linja, u jaqbel li żżommu l-moduli magħluqa tagħkom stess mal-istess regola. Il-konfigurazzjoni tagħha hija fajl wieħed:
{
"communityScopes": ["@adverant/", "@adverant-nexus/"],
"allowedCommunityPackages": ["@adverant/nexus-spi"],
"enterprisePrefixes": ["@adverant/enterprise-", "@adverant-enterprise/"],
"communityRepos": ["nexus-community", "nexus-core", "Adverant-Nexus-Open-Core"],
"allowedCommunityGoModules": []
}Kull wieħed minn dawn huwa sejba bil-fajl u l-linja tagħha:
- kwalunkwe import ta' pakkett taħt ambitu Community li mhuwiex l-interfaċċa permessa jew pakkett Enterprise, inklużi l-imports dinamiċi;
- kwalunkwe speċifikatur, mogħdija tal-import Go jew URL ta' dipendenza li jsemmi repożitorju Community, sakemm ma jkunx modulu Go elenkat f'
allowedCommunityGoModules; - import relattiv li joħroġ 'il barra mir-repożitorju;
- dipendenza
package.jsonli hija mogħdijafile:,link:,portal:jewworkspace:barra r-repożitorju, jew URL Git għal repożitorju Community; replaceta'go.modli tipponta barra r-repożitorju.
Toħroġ b'0 meta ma jkun hemm xejn u b'1 meta jkun hemm sejbiet. Il-ħruġ 2 ifisser li rrifjutat, għaliex il-konfigurazzjoni tagħha kienet ħażina jew ma skannjat xejn. Il-pakkett tal-interfaċċa mhuwiex ippubblikat f'reġistru. Iġorru kopja mwaħħla byte b'byte tal-pakkett mibni ġewwa r-repożitorju tagħkom bħala pakkett file: lokali, b'pin SHA256SUMS u kontroll fil-pipeline tagħkom li jirrifjuta kopja li tvarja. Peress li l-kopja tinsab ġewwa r-repożitorju, ix-xatba taċċettaha.
Binjiet skont l-edizzjoni
Jekk l-estensjoni tagħkom tinbagħat lil klijenti fuq iż-żewġ edizzjonijiet, tibnuha darba għal kull edizzjoni, u kull bini jsir fis-siġra komposta tiegħu. Il-kompożizzjoni ta' siġra tfisser li tieħdu biss il-fajls li jappartjenu għal dik l-edizzjoni. L-esportazzjoni ta' Adverant stess tagħmel dan minn lista ta' konfini li fiha kull fajl traċċat jiġi assenjat b'regoli fejn l-ewwel qbil jirbaħ: regola ssemmi kapaċità u l-edizzjoni tal-fajl ġejja mil-livell ta' dik il-kapaċità fil-matriċi tal-edizzjonijiet, jew issemmi klassi ta' fajls li ma tinbagħat f'ebda edizzjoni, b'raġuni. Il-fajls għall-bini biss jinbagħtu fis-siġra Enterprise u, meta jkunu mmarkati, fis-siġra Community ukoll. Il-katina tal-migrazzjonijiet ta' modulu hija data tal-installatur u tinbagħat fis-siġra ta' kull edizzjoni.
Imbagħad ħaddmu l-bini kollu minn stat nadif f'kull siġra komposta. Dan ifisser it-tliet kmandi kollha, kull darba:
npm ci
npm test
npm run buildTgħallimna dan bil-mod l-għali: siġra Enterprise għaddiet it-testijiet tagħha filwaqt li s-siġra Community falliet il-bini tal-produzzjoni tagħha, għaliex tip li kellha bżonn kien jinsab biss f'fajl Enterprise. Testijiet li jgħaddu f'siġra waħda ma jgħidulkom xejn dwar l-oħra. It-testijiet ta' edizzjoni jistgħu jimportaw biss dak li fiha s-siġra ta' dik l-edizzjoni, u l-esportazzjoni tirrifjuta test li jilħaq 'il barra minnha.
L-esportazzjoni tikteb ukoll il-liċenzja ta' kull edizzjoni. Il-fajls Community iġorru l-identifikatur SPDX (Software Package Data Exchange) Apache-2.0; il-fajls Enterprise iġorru LicenseRef-Adverant-Enterprise u l-package.json tagħhom jgħid UNLICENSED. Teditjawx dawk il-kampi bl-idejn: l-esportazzjoni terġa' tiktibhom, u kopja li ma tibqax taqbel mat-test tal-liċenzja mwaħħal tagħha tiġi rrifjutata.
Team: cloud biss
Team hija Community flimkien mas-sett Team, u taħdem biss fuq il-cloud ta' Adverant. M'hemmx Team self-hosted. Is-sett Team iżid sitt kapaċitajiet fuq Community, fosthom il-pannell tax-xogħol ikkonsolidat, notebooks maqsuma, l-amministrazzjoni tal-librerija tal-ħiliet u l-operazzjonijiet tal-workflows bi promozzjoni bejn l-ambjenti.
Għal min jibni, cloud biss tfisser ħaġa waħda: klijent Team jirċievi l-plugin tagħkom bħala rilaxx iffirmat permezz tal-katalgu, qatt mis-servers tagħkom stess. Tibnuh bil-mod li jibni pubblikatur estern, fuq cluster tal-pubblikatur.
Cluster tal-pubblikatur huwa cluster virtwali fuq il-cloud ta' Adverant bi kwota stabbilita minn Adverant. Fih data ta' kampjun biss u m'għandu l-ebda rotta lejn xi klijent. Talba għal kopja mgħottija tad-data ta' klijent hemmhekk tiġi rrifjutata b'TENANT_BOUNDARY; klijent jista' jaqsam magħkom ir-riżultati tat-testijiet, qatt id-data tiegħu. Il-pass tagħkom fuqu qatt ma jilħaq ġo klijent. Meta r-rilaxx ikun lest, jiġi ffirmat u rivedut minn Adverant qabel ma jiġi elenkat fil-katalgu. Kull klijent imbagħad jagħżel jekk jinstallahx u jagħtih biss dak li jiddikjara l-manifest tiegħu, unità b'unità. Sejħa għal kwalunkwe ħaġa li l-manifest ma ddikjarax tiġi rrifjutata min-naħa tal-klijent b'CONNECTION_SCOPE_EXCEEDED, u l-uniku mod kif tiżdied huwa rilaxx ġdid li l-klijent jirrevedi.
Klijenti iżolati (air-gapped)
Wieħed mill-klijenti tagħna jħaddem Nexus fejn xejn ma jidħol jew joħroġ fuq netwerk. L-installazzjoni tagħhom hija deskritta fil-kapitlu 2.10, Installazzjoni iżolata (air-gapped). Għalina dan fisser li nibagħtu l-plugin tagħna fuq midja ffirmata, u l-għodda għal dan hija nexus-airgap, mill-kit tal-kunsinna sovrana @adverant/nexus-sovereign.
Bundle issiġillat huwa tarball wieħed iffirmat u awtosuffiċjenti. Jista' jġorr images u migrazzjonijiet, ħiliet iffirmati minn qabel u piżijiet tal-mudelli, u SBOM (software bill of materials) bil-liċenzji ta' kull ma fih. Il-manifest tiegħu jelenka kull fajl bl-SHA-256 tiegħu u huwa ffirmat b'Ed25519. Il-bini ta' wieħed mill-kodiċi jidher hekk:
import { SealedBundleExporter } from "@adverant/nexus-sovereign";
const { bundleDigest } = await new SealedBundleExporter().export(source, {
outPath: "./cold-chain-0.4.0.tar.gz",
profile: "airgap",
signerPrivateKeyPem,
});signerPrivateKeyPem hija ċ-ċavetta tagħkom għall-iffirmar tar-rilaxxi. Il-kmand nexus-airgap bundle jagħmel l-istess mil-linja tal-kmand. L-operatur tal-klijent imbagħad jivverifikah qabel kull ħaġa oħra:
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapIl-verifika terġa' tikkalkula l-hash ta' kull fajl kontra l-manifest, tirrifjuta kwalunkwe fajl li l-manifest ma jelenkax, teħtieġ firmatarju Ed25519 fdat, u tirrifjuta kwalunkwe bundle li l-lista tan-netwerk permessa tiegħu mhix vojta. Fajl mibdul wara l-iffirmar ifalli b'BUNDLE_INTEGRITY_VIOLATION. Għidu lill-operatur jieqaf hemm u jċemplilkom; hemm swiċċ mhux strett, u qatt m'għandu jużah.
Tliet regoli sostnew il-kunsinna tagħna:
- Iċ-ċavetta fdata tivvjaġġa separatament mill-bundle. Nibagħtu ċ-ċavetta pubblika u l-SHA-256 tal-bundle minn rotta differenti minn dik tal-midja, sabiex bundle ma jkunx jista' jiggarantixxi għalih innifsu.
- Xejn fil-bundle ma jista' jeħtieġ in-netwerk waqt l-installazzjoni. L-ebda ġbid ta' pakketti, l-ebda tniżżil ta' mudelli, l-ebda sejħa tal-liċenzja. Jekk il-plugin ikollu bżonn mudell, is-server tal-mudelli tal-klijent stess jipprovdih permezz tal-AI (intelliġenza artifiċjali) Provider Router.
- Wara l-verifika, l-operatur idaħħal ir-rilaxx permezz tal-kanali tar-rilaxx tal-installazzjoni stess, eżattament kif jagħmel klijent konness. Il-bundle huwa l-mod kif jaslu l-bytes, mhux mod kif jiġu evitati x-xtiebi tal-promozzjoni.
Ix-xogħol iżolat (air-gapped) huwa aktar bil-mod, u ma hemm xejn x'nistgħu nagħmlu dwaru min-naħa tagħna. Byte ħażin jiswa sett ġdid ta' midja u vjaġġ ieħor, għalhekk nivverifikaw il-bundle aħna stess fuq magna nadifa bl-istess kmand qabel ma joħroġ mill-bini.
Pakketti ta' missjoni ta' Nexus Edge
Nexus Edge huwa Nexus iżgħar li jaħdem fuq satelliti u drones, fuq kompjuters tal-missjoni miżmuma separati mill-kompjuter tat-titjira. Huwa żieda b'liċenzja għal kull pjattaforma jew flotta. Dak li jinbidel minn missjoni għall-oħra huwa l-pakkett tal-missjoni, u l-bini ta' dawn huwa parti tajba mix-xogħol tiegħi.
Pakkett tal-missjoni jġorr dak li l-payload jeħtieġ għal missjoni waħda. Flimkien mal-mudelli u l-adapters tiegħu, fih l-ontoloġija b'graff tal-bidu, il-passi tal-aġenti, ir-regoli tal-allarmi, il-prijoritajiet għal dak li jinżel l-ewwel, tabella tat-tqegħid li tgħid liema kompjuter iħaddem xiex, il-passi degradati li l-pjattaforma tista' tinżel għalihom meta kompjuter ifalli, u l-każijiet tat-test li għandu jgħaddi abbord.
Il-pakketti jinbnew u jiġu ffirmati fuq l-art. Xi regoli prattiċi mill-bini tagħna:
- Żommu l-partijiet il-kbar stabbli. Maritime watch 1.5 żied adapter għas-sejbien tal-vapuri u żewġ regoli tal-allarmi; il-mudell tal-lingwa u l-ontoloġija ma nbidlux, għalhekk il-pakkett kien ta' 412 MB minflok 9.8 GB. Il-uplink huwa dejjaq, u l-mudelli bażi jitgħabbew qabel it-tlugħ.
- Użaw mudell wieħed ta' embedding għall-familja kollha tal-missjoni, kemm fuq l-art kif ukoll fuq il-payload, sabiex il-bidliet fil-graff li jinżlu jkunu jistgħu jingħaqdu mal-graff tal-art.
- Il-payload qatt ma jibgħat kmand lis-sistemi tat-titjira. Jibgħat talbiet tipizzati permezz tas-supervisor lill-kompjuter tat-titjira, li jwieġeb kull waħda b'raġuni.
- Kull tip ta' hardware jeħtieġ il-verifika tiegħu stess tal-pakkett. L-installazzjoni ta' pakkett li ma ġiex ivverifikat għall-hardware ta' apparat tiġi miċħuda b'
PACK_NOT_CHECKED_FOR_HARDWARE.
Ir-rilaxx jeħtieġ żewġ firem minn tlieta. Tagħna u ta' Adverant huma l-par tas-soltu, u t-tielet hija ċavetta offline li nżommu f'kaxxa-forti għal meta waħda miż-żewġ l-oħrajn tintilef. Il-pakkett jitla' fis-slot inattiv, jiġi vverifikat, iħaddem il-każijiet tat-test tiegħu fuq il-bordijiet reali, u jinxtegħel biss jekk kollha jgħaddu, b'counter li jwaqqaf pakkett eqdem milli jerġa' jiġi installat. Jekk test ifalli, il-pjattaforma tibqa' fuq il-pakkett preċedenti u l-falliment jinżel fil-passaġġ li jmiss. Inxerrdu pjattaforma waħda kull darba, kull waħda wara ġimgħa nadifa. Il-pakketti jibqgħu validi waqt li pjattaforma tkun barra mill-kuntatt, għalhekk satellita mingħajr link tibqa' taħdem fuq il-pakkett li għandha.
Fuq vetturi u bastimenti, Edge jista' jaħdem fuq k3s. Vettura spazjali tħaddem supervisor b'immaġnijiet iffirmati jew binarji statiċi u tabella tat-tqegħid fissa minflok Kubernetes, u huwa għalhekk li t-tabella tat-tqegħid tivvjaġġa ġewwa l-pakkett.
Ħwienet diġitali white-label
Iż-żieda Storefront / white-label tippermetti lil klijent ipoġġi l-marka u d-dominju tiegħu fuq dak li jaraw l-utenti tiegħu, bl-iskrins tad-dħul tiegħu stess, u jieħu l-pagamenti permezz tal-gateways tiegħu stess. Id-dettalji tal-karti qatt ma jmissu lil Nexus.
Plugin mibni għal klijent white-label qatt m'għandu juri lil Adverant. Il-manifest iġorr dak kollu speċifiku għall-marka, u l-pjattaforma tirrisolvi l-bqija mill-marka tal-organizzazzjoni stess u mhux minn xi ħaġa hard-coded fil-kodiċi tiegħek:
{
"domains": [
{ "primary": "<app-domain>", "aliases": ["www.<app-domain>"] }
],
"branding": {
"appName": "<app name>",
"tagline": "<one line>",
"primaryColor": "<hex>",
"accentColor": "<hex>",
"passkeyRpId": "<app-domain>",
"oauthClientRef": "brand:<plugin name>:google"
}
}<app-domain> huwa d-dominju tal-klijent stess, u passkeyRpId għandu jaqbel miegħu, għaliex il-passkeys huma marbuta mad-dominju li fuqu persuna tidħol. App tal-web fuq l-oriġini tagħha stess iddaħħal lin-nies permezz tal-helpers tad-dħul tal-SDK, li ż-żewġ rotot pubbliċi tagħhom huma l-uniċi rotot /api mhux protetti li l-iscope gate jaċċetta, u biss meta l-manifest jiddikjarahom auth: public b'allowAnonymous: true. Is-sejħiet tal-frontend jgħaddu mill-proxy tal-allow-list tal-backend for frontend, qatt direttament lejn l-indirizz ta' servizz. L-amministratur tal-klijent jikkonfigura n-naħa tal-pagamenti, mill-gateways sal-checkout bil-marka. Il-plugin tiegħek ma jagħmilx dan.
Il-matriċi
| Mira tal-bini | Ibni kontra | X'tagħmel b'mod differenti | Kif jasal għand il-klijent |
|---|---|---|---|
| Community | Plugin SDK, Skills Engine | Kodiċi f'GitHub; l-ebda domain pack jew mogħdijiet tal-pjattaforma; l-ebda Elevate | Il-klijent jinstallah; l-ebda reviżjoni tal-katalgu meħtieġa |
| Enterprise (l-installazzjoni tiegħek stess) | Plugin SDK, Skills Engine, mudelli tal-pakketti | Dev spaces, fergħat tad-dejta, kopji mgħottija mas-sid tad-dejta; pakketti u lenses | Promozzjoni minn staging għal unità pilota, imbagħad kullimkien |
| Modulu Enterprise (magħluq) | @adverant/nexus-spi biss |
Regola tal-linja tal-liċenzja; verifika tal-għotja fuq il-grupp ta' funzjonalitajiet tiegħu stess; LICENCE_LOCKED meta ma jkunx intitolat |
Jitgħabba minn servizz Community fil-bidu, fuq installazzjonijiet liċenzjati |
| Iż-żewġ edizzjonijiet | Plugin SDK | Ikkomponi s-siġra ta' kull edizzjoni; npm ci, testijiet u bini tal-produzzjoni f'kull waħda |
Rilaxx wieħed għal kull edizzjoni |
| Team | Plugin SDK fuq publisher cluster | Dejta tal-kampjun biss; cloud biss | Rilaxx iffirmat, reviżjoni ta' Adverant, katalgu |
| Air-gapped | Plugin SDK, @adverant/nexus-sovereign |
Bundle issiġillat; ċavetta u checksum mibgħuta separatament; xejn ma jinġieb waqt l-installazzjoni | Midja ffirmata, ivverifikata, imbagħad il-kanali tar-rilaxx tal-installazzjoni |
| Nexus Edge | Kontenut tal-pakkett tal-missjoni | Tabella tat-tqegħid, passi degradati, testijiet abbord, verifiki tal-hardware | Żewġ firem minn tlieta, slot inattiv, jinxtegħel wara li t-testijiet jgħaddu |
| White-label | Plugin SDK | domains u branding fil-manifest; l-ebda isem ta' Adverant imkien |
Bħal għal Enterprise, fuq id-dominju tal-klijent stess |
Tkun xi tkun il-mira, l-iskjerament isir biss permezz tal-kanali tar-rilaxx tal-installazzjoni. Il-Kapitolu 2.28, Ir-rilaxx tal-estensjoni tiegħek, ikopri dawk il-kanali. Il-Kapitolu 2.27, Xenarji tal-bini, għandu riċetta għal kull ringiela ta' hawn fuq.



