BejelentkezésBemutató kérése

2.25. fejezet

Fejlesztés az egyes kiadásokra

Mi változik, amikor egyetlen kiegészítőnek minden kiadásban, zárt (air-gapped) telephelyen, Nexus Edge csomagban vagy az ügyfél saját márkaneve alatt is működnie kell. Kitér az Enterprise modulok licenchatáraira és az aláírt offline szállításra, egy mátrixszal együtt, amely bemutatja, mit kell másképp csinálni az egyes célkörnyezetek esetében.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

17 perc olvasási idő

A Corrán Orbitalnál több helyre szállítunk, mint a legtöbb csapat. Saját mérnökeink a földön Enterprise-t futtatnak. Egy műhold, a CORR-3, egy küldetéscsomagot futtat Nexus Edge-en. Két ügyfelünk egyetlen szerveren Community-t futtat, egy pedig olyan hálózattól elzárt (air-gapped) Enterprise-telepítést, amely soha nem kapcsolódik az internethez, és egy biztosítónak is készítettünk csomagot a saját telepítésükre. Az alatta lévő kód nagyrészt ugyanaz, a különbségek pedig főként arról szólnak, hová kerülhet, és hogyan jut el oda.

Ez a fejezet sorra veszi az egyes célkörnyezeteket: mire épít, mihez nem nyúlhat, és hogyan jut el az eredmény az ügyfélhez. A fejezet végén egy mátrix egy oldalon foglalja össze mindezt. A 2.18. fejezet (A bővítési modell) elmagyarázza, miben különböznek a skillek, a pluginok, a csomagok és a modulok. A 2.2. fejezet (A kiadások a motorháztető alatt) magukat a kiadásokat írja le.

A Community kiadás és a nyílt alaprendszer

A Community a nyílt mag, az Apache License, Version 2.0 alatt. Forkolhatja, és módosításokat szállíthat hozzá. A vele együtt terjesztett NOTICE fájl egy dolgot mond, amelyet érdemes tudni, mielőtt bármit márkajelzéssel látna el: a licenc nem ad jogot az Adverant nevének vagy védjegyeinek használatára azon túl, hogy megjelöli, honnan származik a mű.

A Community-t ugyanúgy bővíti, mint az Enterprise-t. A Plugin SDK (szoftverfejlesztői készlet) mindkét kiadáson ugyanaz a csomag, és sem a teljes szolgáltatássablon, sem a 22 megfelelőségi kapu nem változik; ezt a 2.21. fejezet (A Plugin SDK) tárgyalja. A skillek is működnek. A Community megkapja a teljes Skills Engine létrehozót és könyvtárat, verziókkal és tesztekkel, míg a canary kiadások és a kétszemélyes jóváhagyás az Enterprise-nál maradnak.

Fejlesztés a Community kiadáson
Fejlesztés a Community kiadáson
Foglalási plugin készítése egyetlen Community-szerveren. Figyelje meg a hozzáférési jogosítványt, amely a GitHubon keresztül eléri a Propose szintet, és nem kínál Elevate szintet, valamint a jobb oldali ízelítőt, amely felsorolja, mit ad hozzá az Enterprise.

A Community fejlesztői oldalai ugyanazokat az arany utakat kínálják, három különbséggel, amelyeket azonnal érezni fog:

  1. A kódja a GitHubon él, nem a telepítés saját tárolóiban. A plugin arany út egy GitHub-tárolót és egy fejlesztői teret hoz létre ugyanabból a rögzített sablonból, amelyet az Enterprise használ; a DV18 képernyő mutatja, ahogy létrehozza a következőt: room-bookings.
  2. A tartománycsomag és a platform arany útjai az Enterprise részei. Community-n pluginokat és skilleket készít, valamint lencséket és munkafolyamatokat arra, amit futtat.
  3. A Community jogosítványai az Elevate szint alatt megállnak. Egyetlen szerveren nincs olyan éles környezet, amelyet egy IDE-ből (integrált fejlesztői környezet) el lehetne érni, és a szervert közvetlenül adminisztrálja. Az IDE-ből tett kísérletet a rendszer a következővel utasítja el: PASS_TIER_REQUIRED.

Egy kis szerveren a Community fejlesztői tér szerény. A miénk 2 maggal és 8 GiB memóriával rendelkezett, zárva volt, kivéve azt, amit a manifest deklarál, és 7 tétlen nap után megszűnt.

Hozzájárulás visszafelé

A Skills Engine szintén Apache-2.0 licencű, és a szokásos módon fogad hozzájárulásokat. Forkolja a tárolót, ágaztasson le a(z) main ágból, végezze el a módosítást a tesztjeivel együtt, és futtassa az ellenőrzéseket, mielőtt pull requestet nyit:

git checkout -b feature/skill-synthesis-validation
npm test
npm run lint
npm run typecheck

A viselkedést megváltoztató hozzájáruláshoz olyan teszt szükséges, amely nélküle sikertelen. Ez nem házi stílus: az SDK saját tesztelési szabályai szerint minden új tesztről igazolni kell, hogy a módosítás előtti kódfán sikertelen, és a bírálók kérik a bizonyítékot.

Enterprise modulok és a licenchatár

Az Enterprise a Community plusz licencelt modulok. A licencelt modul egy különálló artefaktum, amelyet egy Community-szolgáltatás indításkor tölt be, és ezen keresztül kapcsolódnak a nyílt maghoz az Enterprise-funkciók, valamint bármely zárt modul, amelyet Enterprise-ügyfelek számára készít.

Ezt a licenchatár teszi működőképessé. Egy zárt modul csak egyetlen csomagon keresztül érheti el a Community kiadást: ez a(z) @adverant/nexus-spi, a szolgáltatói interfész. Apache-2.0 licencű, és interfészeket, valamint azokat a típusőröket tartalmazza, amelyekkel a gazda és a modul ellenőrzik egymást, más futásidejű logika nélkül. A határon átívelő csatolás interfész vagy hálózati protokoll, soha nem forráskód.

Export Mi ez
RouteModule Licencelt útvonalmodul: id, featureGroup, bodies és register(app, ctx), amely a routereit a gazda alkalmazására csatolja
SpiApp A kiszolgáló HTTP-alkalmazásának azon része, amelyhez egy modul hozzányúl: use
SpiContext Amit a gazda átad egy modulnak: a termékkapu és a hatókörőr, a licencolvasó, a hatókörös lekérdezési készlet, a szolgáltatás sémája, a felső szintű címek és a platformkliensek
SpiRuntime A Plugin SDK azon értékei, amelyeket a gazda átad egy modulnak, így a modul soha nem importálja maga az SDK futásidejű részét
SpiPlane Amit egy licencelt sík az útvonalakon túl hozzáad, például az általa kiszolgált képernyőolvasások
ScreenModule Egy konzol licencelt képernyőcsoportja: group, featureGroup, routes, screens és menu
GrantCheck (featureGroup) => Promise<{ entitled, code?: 'LICENCE_LOCKED' }>

A HTTP-keretrendszer és a konzol képernyőtípusa típusparaméterek, így az interfész egyikhez sem kötődik. Íme egy útvonalmodul váza Express-kezelőtípussal:

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);
    },
  };
}

A(z) <feature-group> a kiadási mátrix azon funkciócsoportja, amelyet a modul kiszolgál. Minden licencelt útvonal a(z) ctx.requireScope mögött fut, amely a gazda termékkapuja és hatókörőre, és a modul is ellenőrzi a saját jogosultságát, mielőtt válaszol. Egy jogosultsággal nem rendelkező modul a(z) LICENCE_LOCKED hibával utasít el, és a funkció ízelítőjét jeleníti meg, soha nem annak adatait. A modulja soha nem importálja a Plugin SDK futásidejű részét sem, mert az SDK egy Community-csomag, amelyet a határ nem enged át. A gazda adja át neki az általa hívott SDK-értékeket. Mielőtt bármely modult betöltene, a gazda telepít egy SpiHost elemet a(z) globalThis objektumra a(z) Symbol.for(SPI_HOST_KEY) kulcs alatt, amely az SDK futásidejű részét és az alkalmazás saját útvonalkészletét tartalmazza. Ennek kell elsőként megtörténnie: egy egyetlen csomagba fordított modul egészként értékelődik ki, és egy register hívás túl későn érkezne az olyan kódhoz, amely betöltés közben olvassa az SDK-értékeket. A típusokhoz a(z) @adverant/nexus-spi/sdk/<module> újraexportálja az SDK deklarációit, amelyek változatlanul, egyetlen SDK-kiadásból átvéve és ellenőrzőösszeggel rögzítve kerültek be, így a modulja ugyanazokkal az elutasítási törzsekkel és kliensekkel szemben esik típusellenőrzés alá, amelyeket egy plugin használ.

Egy képernyőmodulra még egy szabály vonatkozik: funkciócsoportonként egy modul, így egy olyan csoport, amelynek képernyői két funkciócsoporthoz tartoznak, két modulként kerül szállításra, és közülük csak az egyik tartalmazza a menüsort.

Amit a licenchatár-kapu elutasít

Az Adverant licenchatár-kapuja minden Enterprise-modult a határhoz köt, és érdemes saját zárt moduljaira is ugyanezt a szabályt alkalmaznia. A konfigurációja egyetlen fájl:

{
  "communityScopes": ["@adverant/", "@adverant-nexus/"],
  "allowedCommunityPackages": ["@adverant/nexus-spi"],
  "enterprisePrefixes": ["@adverant/enterprise-", "@adverant-enterprise/"],
  "communityRepos": ["nexus-community", "nexus-core", "Adverant-Nexus-Open-Core"],
  "allowedCommunityGoModules": []
}

Az alábbiak mindegyike egy-egy megállapítás, a fájllal és a sorral együtt:

  • bármely Community-hatókörbe tartozó csomag importálása, amely nem az engedélyezett interfész vagy egy Enterprise-csomag, beleértve a dinamikus importokat is;
  • bármely specifikátor, Go importútvonal vagy függőségi URL, amely Community-tárolót nevez meg, kivéve, ha az a(z) allowedCommunityGoModules beállításban felsorolt Go-modul;
  • olyan relatív import, amely kilép a tárolóból;
  • olyan package.json függőség, amely a tárolón kívüli file:, link:, portal: vagy workspace: útvonal, vagy egy Community-tárolóra mutató Git URL;
  • olyan go.mod replace, amely a tárolón kívülre mutat.

Tiszta eredmény esetén 0, megállapítások esetén 1 kóddal lép ki. A 2-es kilépési kód azt jelenti, hogy megtagadta a futást, mert a konfigurációja hibás volt, vagy semmit sem vizsgált. Az interfészcsomag nem kerül közzétételre egyetlen registryben sem. A lefordított csomag bájtpontosan rögzített másolatát a tárolóján belül, helyi file: csomagként tartja, egy SHA256SUMS rögzítéssel és egy olyan ellenőrzéssel a pipeline-jában, amely elutasítja az eltérő másolatot. Mivel a másolat a tárolón belül van, a kapu elfogadja.

Két nagy doboz egymás mellett. A bal oldali doboz felirata „Community (Apache-2.0)”, és kisebb dobozokat tartalmaz „Services”, „Plugin SDK” és „@adverant/nexus-spi” felirattal. A jobb oldali doboz felirata „Enterprise module (closed)”, és a „RouteModule”, „ScreenModule” és „GrantCheck” elemeket tartalmazza. Egyetlen folytonos nyíl lépi át a határvonalat, a jobb oldali dobozból kizárólag a „@adverant/nexus-spi” elemhez, „compile against” felirattal. A jobb oldali dobozból a „Services” és „Plugin SDK” elemhez vezető két szaggatott nyíl át van húzva, és „licence-line gate: finding” felirattal van ellátva.
A licenchatár a Community és egy Enterprise-modul között.

Kiadásspecifikus buildek

Ha a bővítménye mindkét kiadás ügyfeleihez eljut, kiadásonként egyszer építi meg, és minden build a saját összeállított fájában történik. Egy fa összeállítása azt jelenti, hogy csak az adott kiadáshoz tartozó fájlokat veszi át. Az Adverant saját exportja ezt egy határlista alapján végzi, amelyben minden nyomon követett fájl az első egyezés elve szerint kerül besorolásra: egy szabály vagy egy képességet nevez meg, és a fájl kiadása az adott képesség kiadási mátrixbeli szintjéből következik, vagy egy olyan fájlosztályt nevez meg, amely egyik kiadásban sem kerül szállításra, indoklással. A csak buildhez szükséges fájlok az Enterprise-fában, és megjelölés esetén a Community-fában is szállításra kerülnek. Egy modul migrációs lánca telepítői adat, és minden kiadás fájában szállításra kerül.

Ezután futtassa a teljes buildet tiszta állapotból minden összeállított fában. Ez mindhárom parancsot jelenti, minden alkalommal:

npm ci
npm test
npm run build

Ezt drága áron tanultuk meg: egy Enterprise-fa sikeresen átment a tesztjein, miközben a Community-fa éles buildje meghiúsult, mert egy szükséges típus csak egy Enterprise-fájlban létezett. Az egyik fában sikeres tesztek semmit sem árulnak el a másikról. Egy kiadás tesztjei csak azt importálhatják, amit az adott kiadás fája tartalmaz, és az export elutasítja az azon kívülre nyúló tesztet.

Az export minden kiadás licencét is megírja. A Community-fájlok az SPDX (Software Package Data Exchange) azonosítót viselik: Apache-2.0; az Enterprise-fájlok a(z) LicenseRef-Adverant-Enterprise azonosítót viselik, és a(z) package.json mezőjük értéke UNLICENSED. Ne szerkessze kézzel ezeket a mezőket: az export felülírja őket, és a rögzített licencszövegével már nem egyező másolatot elutasítja.

Team: kizárólag felhőalapú

A Team a Community plusz a Team-készlet, és csak az Adverant felhőben fut. Saját üzemeltetésű Team nem létezik. A Team-készlet hat képességet ad a Community-hez, köztük az egységes munkapanelt, a megosztott jegyzetfüzeteket, a skillkönyvtár adminisztrációját és a munkafolyamat-műveleteket a környezetek közötti előléptetéssel.

Egy fejlesztő számára a csak felhős működés egyetlen dolgot jelent: a Team-ügyfél aláírt kiadásként, a katalóguson keresztül kapja meg a pluginját, soha nem az Ön saját szervereiről. Ugyanúgy építi meg, ahogy egy külső kiadó, egy kiadói fürtön.

Kiadói fürt
Kiadói fürt
Egy kiadó saját virtuális fürtje az Adverant felhőben, kizárólag mintaadatokkal. Kövesse az élő folyamatot a felső részen: az IDE eléri a kiadó fürtjét és a mintaadatokat, egy aláírt kiadás felülvizsgálaton keresztül kerül a katalógusba, és egyetlen ügyfélhez sem vezet út.

A kiadói fürt egy virtuális fürt az Adverant felhőben, az Adverant által meghatározott kvótával. Kizárólag mintaadatokat tartalmaz, és nincs útvonala egyetlen ügyfélhez sem. Ha ott egy ügyfél adatainak maszkolt másolatát kéri, a rendszer a(z) TENANT_BOUNDARY hibával utasítja el; az ügyfél megoszthatja Önnel a teszteredményeket, az adatait azonban soha. Az ezen érvényes jogosítványa soha nem nyúl be egy ügyfélhez. Amikor a kiadás elkészül, aláírják, és az Adverant felülvizsgálja, mielőtt felkerülne a katalógusba. Ezután minden ügyfél eldönti, hogy telepíti-e, és csak azt engedélyezi számára, amit a manifestje deklarál, egységről egységre. Bármely, a manifestben nem deklarált elem hívását az ügyfél oldalán a(z) CONNECTION_SCOPE_EXCEEDED hibával utasítja el a rendszer, és ennek hozzáadására az egyetlen mód egy új kiadás, amelyet az ügyfél felülvizsgál.

Zárt hálózatú (air-gapped) ügyfelek

Egyik ügyfelünk olyan környezetben futtatja a Nexust, ahol semmi sem jut be vagy ki hálózaton keresztül. A telepítésüket a 2.10. fejezet (Hálózattól elzárt telepítés) írja le. Számunkra ez azt jelentette, hogy a pluginunkat aláírt adathordozón kellett szállítanunk, és ennek eszköze a(z) nexus-airgap, a(z) @adverant/nexus-sovereign szuverén szállítási készletből.

A lezárt csomag egyetlen aláírt, önálló tarball. Tartalmazhat image-eket és migrációkat, előre aláírt skilleket és modellsúlyokat, valamint egy SBOM-ot (szoftverösszetevő-jegyzék) a benne lévő összes elem licencével. A manifestje minden fájlt felsorol a SHA-256 értékével együtt, és Ed25519-cel van aláírva. Egy ilyen csomag kódból történő építése így néz ki:

import { SealedBundleExporter } from "@adverant/nexus-sovereign";

const { bundleDigest } = await new SealedBundleExporter().export(source, {
  outPath: "./cold-chain-0.4.0.tar.gz",
  profile: "airgap",
  signerPrivateKeyPem,
});

A(z) signerPrivateKeyPem az Ön kiadás-aláíró kulcsa. A(z) nexus-airgap bundle parancs ugyanezt végzi a parancssorból. Az ügyfél üzemeltetője ezután minden más előtt ellenőrzi a csomagot:

nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgap

Az ellenőrzés minden fájl hash-ét újraszámolja a manifesthez képest, elutasít minden olyan fájlt, amelyet a manifest nem sorol fel, megbízható Ed25519-aláírót követel meg, és elutasít minden olyan csomagot, amelynek hálózati engedélyezőlistája nem üres. Az aláírás után módosított fájl a(z) BUNDLE_INTEGRITY_VIOLATION hibával bukik el. Mondja meg az üzemeltetőnek, hogy ilyenkor álljon meg, és hívja Önt; létezik egy nem szigorú kapcsoló, de soha ne használja.

Három szabály vitte sikerre a szállításunkat:

  1. A megbízható kulcs a csomagtól elkülönítve utazik. A nyilvános kulcsot és a csomag SHA-256 értékét az adathordozótól eltérő úton küldjük, így egy csomag nem kezeskedhet önmagáért.
  2. A csomagban semminek sem szabad hálózatot igényelnie a telepítéskor. Nincs csomaglekérés, nincs modellletöltés, nincs licenchívás. Ha a pluginnak modellre van szüksége, azt az ügyfél saját modellszervere biztosítja az AI (mesterséges intelligencia) Provider Routeren keresztül.
  3. Az ellenőrzés után az üzemeltető a telepítés saját kiadási csatornáin keresztül hozza be a kiadást, pontosan úgy, ahogy egy hálózatra kapcsolt ügyfél tenné. A csomag az a mód, ahogyan a bájtok megérkeznek, nem pedig az előléptetési kapuk megkerülésének eszköze.

A hálózattól elzárt munka lassabb, és ezen a mi oldalunkról nem lehet segíteni. Egy hibás bájt egy új adathordozó-készletbe és egy újabb útba kerül, ezért mielőtt a csomag elhagyná az épületet, mi magunk is ellenőrizzük egy tiszta gépen ugyanazzal a paranccsal.

Nexus Edge küldetéscsomagok

A Nexus Edge egy kisebb Nexus, amely műholdakon és drónokon fut, a repülésvezérlő számítógéptől elkülönített küldetésszámítógépeken. Kiegészítő modul, platformonkénti vagy flottánkénti licenccel. Küldetésről küldetésre a küldetéscsomag változik, és ezek összeállítása munkám jelentős részét teszi ki.

A küldetéscsomag azt tartalmazza, amire a hasznos tehernek egy küldetéshez szüksége van. Modelljei és adapterei mellett tartalmazza az ontológiát egy kiinduló gráffal, az ágenslépéseket, a riasztási szabályokat, annak prioritásait, hogy mi kerüljön le elsőként, egy elhelyezési táblát, amely megadja, melyik számítógép mit futtat, azokat a csökkentett üzemmódú lépéseket, amelyekre a platform egy számítógép meghibásodásakor visszaléphet, valamint azokat a teszteseteket, amelyeken a fedélzeten meg kell felelnie.

Küldetéscsomag összeállítása
Küldetéscsomag összeállítása
A Maritime watch 1.5 összeállítása az 1.4-ből. Figyelje meg a fedélzeti teszteseteket (48, mindegyiknek sikeresnek kell lennie) és az elhelyezési táblát, amely megadja, mi fut a két GPU- (grafikus feldolgozóegység) kártyán és a CPU- (központi feldolgozóegység) kártyán az egyes csökkentett üzemmódú lépésekben.

A csomagokat a földön állítják össze és írják alá. Néhány gyakorlati szabály a saját összeállításainkból:

  • A nagy részeket tartsa változatlanul. A Maritime watch 1.5 egy hajókereső adaptert és két riasztási szabályt adott hozzá; a nyelvi modell és az ontológia nem változott, így a csomag 9.8 GB helyett 412 MB lett. A feltöltési kapcsolat keskeny, az alapmodellek pedig az indítás előtt töltődnek be.
  • Az egész küldetéscsaládhoz egyetlen beágyazási modellt használjon, a földön és a hasznos terhen egyaránt, hogy a lekerülő gráfváltozások egyesíthetők legyenek a földi gráffal.
  • A hasznos teher soha nem küld parancsot a repülési rendszereknek. Típusos kéréseket küld a felügyelőn keresztül a repülésvezérlő számítógépnek, amely mindegyikre indoklással válaszol.
  • Minden hardvertípushoz külön ellenőrizni kell a csomagot. Az eszköz hardverére nem ellenőrzött csomag telepítését a rendszer PACK_NOT_CHECKED_FOR_HARDWARE hibával elutasítja.
Csomag aláírása és elküldése
Csomag aláírása és elküldése
A Maritime watch 1.5 kiadása a CORR-3 számára. Három aláírásból kettő szükséges, így egyetlen ellopott kulccsal nem lehet csomagot kiadni, a terv pedig azt mutatja, hogy a csomag csak azután kapcsol be, hogy 48 tesztje sikeresen lefutott a fedélzeten.

A kiadáshoz három aláírásból kettő szükséges. A miénk és az Adverant-é a szokásos pár, a harmadik pedig egy offline kulcs, amelyet széfben őrzünk arra az esetre, ha a másik kettő egyike elveszne. A csomag a tétlen tárhelyre kerül fel, ellenőrzésre kerül, lefuttatja teszteseteit a valódi kártyákon, és csak akkor kapcsol be, ha mindegyik sikeres, egy számlálóval, amely megakadályozza egy régebbi csomag újratelepítését. Ha egy teszt sikertelen, a platform az előző csomagon marad, és a hiba a következő áthaladáskor kerül le. Egyszerre egy platformon vezetjük be, mindegyiken egy hiba nélküli hét után. A csomagok érvényesek maradnak, amíg a platform nincs kapcsolatban, így egy kapcsolat nélküli műhold tovább dolgozik a meglévő csomagjával.

Járműveken és hajókon az Edge futhat k3s-en. Egy űreszköz Kubernetes helyett felügyelőt futtat aláírt image-ekkel vagy statikus binárisokkal és rögzített elhelyezési táblával, ezért utazik az elhelyezési tábla a csomagon belül.

Saját márkás (white-label) áruházak

A Storefront / white-label kiegészítő lehetővé teszi, hogy az ügyfél saját márkáját és domainjét helyezze el azon, amit a felhasználói látnak, saját bejelentkezési képernyőkkel, és saját fizetési átjáróin keresztül fogadjon fizetéseket. A kártyaadatok soha nem érintik a Nexust.

Egy white-label ügyfél számára készült bővítmény soha nem jelenítheti meg az Adverant nevet. A manifest tartalmaz minden márkaspecifikus elemet, a többit pedig a platform a szervezet saját márkájából oldja fel, nem a kódjában rögzített értékekből:

{
  "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"
  }
}

A <app-domain> az ügyfél saját domainje, és a passkeyRpId értékének egyeznie kell vele, mert a passkey-k ahhoz a domainhez kötődnek, amelyen a felhasználó bejelentkezik. A saját originen futó webalkalmazás az SDK bejelentkezési segédfüggvényein keresztül jelentkezteti be a felhasználókat, amelyek két nyilvános útvonala az egyetlen védelem nélküli /api útvonal, amelyet a hatókörkapu elfogad, és csak akkor, ha a manifest ezeket auth: public formában, allowAnonymous: true értékkel deklarálja. A frontendhívások a backend for frontend engedélyezőlistás proxyn keresztül haladnak, soha nem közvetlenül egy szolgáltatáscímre. A fizetési oldalt az átjáróktól a márkázott fizetési felületig az ügyfél adminisztrátora konfigurálja. Az Ön bővítménye nem.

A mátrix

Build-cél Build alapja Amit másként csinál Hogyan jut el az ügyfélhez
Community Plugin SDK, Skills Engine Kód a GitHubon; nincs domaincsomag és platformútvonal; nincs Elevate Az ügyfél telepíti; katalógus-felülvizsgálat nem szükséges
Enterprise (saját telepítés) Plugin SDK, Skills Engine, csomagsablonok Fejlesztői terek, adatágak, maszkolt másolatok az adatgazdával; csomagok és nézetek Előléptetés stagingről egy pilot egységre, majd mindenhová
Enterprise modul (zárt) Csak @adverant/nexus-spi Licenchatár-szabály; jogosultság-ellenőrzés a saját funkciócsoportján; LICENCE_LOCKED, ha nincs jogosultság Egy Community szolgáltatás tölti be induláskor, licencelt telepítéseken
Mindkét kiadás Plugin SDK Mindkét kiadás fájlfájának összeállítása; npm ci, tesztek és éles build mindegyikben Kiadásonként egy release
Team Plugin SDK egy kiadói fürtön Csak mintaadatok; csak felhő Aláírt release, Adverant-felülvizsgálat, katalógus
Air-gapped Plugin SDK, @adverant/nexus-sovereign Lezárt csomag; a kulcs és az ellenőrzőösszeg külön kerül elküldésre; telepítéskor semmi sem töltődik le Aláírt adathordozó, ellenőrzés, majd a telepítés kiadási csatornái
Nexus Edge Küldetéscsomag tartalma Elhelyezési tábla, csökkentett üzemmódú lépések, fedélzeti tesztek, hardverellenőrzések Háromból két aláírás, tétlen tárhely, bekapcsolás a sikeres tesztek után
Saját márkás megjelenés (White-label) Plugin SDK domains és branding a manifestben; sehol nem szerepel az Adverant név Mint az Enterprise esetében, az ügyfél saját domainjén

Bármi is a cél, a telepítés kizárólag a telepítés kiadási csatornáin keresztül történik. Ezeket a csatornákat a 2.28. fejezet, A bővítmény kiadása tárgyalja. A 2.27. fejezet, Build-forgatókönyvek, a fenti táblázat minden sorához tartalmaz receptet.