PrijavaRezervirajte predstavitev

Poglavje 2.25

Izdelava za posamezno izdajo

Kaj se spremeni, ko mora ena razširitev delovati v vsaki izdaji, na izolirani lokaciji brez povezave (air-gapped), na bremenu Nexus Edge ali pod lastno blagovno znamko stranke. Zajema licenčno mejo za module Enterprise in podpisano dostavo brez povezave ter matriko razlik za vsak posamezni cilj.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

17 min branja

Pri Corrán Orbital dostavljamo na več mest kot večina ekip. Naši lastni inženirji na tleh poganjajo izdajo Enterprise. Satelit CORR-3 poganja misijski paket na sistemu Nexus Edge. Dve stranki poganjata izdajo Community na enem samem strežniku, ena poganja zračno izolirano (air-gapped) namestitev Enterprise, ki nikoli ne vidi interneta, poleg tega pa smo zgradili paket za zavarovalnico na njihovi lastni namestitvi. Koda v ozadju je večinoma enaka, razlike pa se nanašajo predvsem na to, kam sme iti in kako tja pride.

To poglavje obravnava vsak cilj posebej: na podlagi česa gradite, česa se ne smete dotikati in kako rezultat pride do stranke. Matrika na koncu vse skupaj povzame na eni strani. Poglavje 2.18, Razširitveni model, pojasnjuje, kako se razlikujejo veščine (skills), vtičniki (plugins), paketi (packs) in moduli. Poglavje 2.2, Izdaje pod pokrovom, pa opisuje same izdaje.

Izdaja Community in odprto jedro

Community je odprto jedro pod licenco Apache License, različica 2.0. Lahko ga razcepite (fork) in vanj pošiljate spremembe. Datoteka NOTICE, ki ga spremlja, navaja eno stvar, ki jo je vredno vedeti, preden karkoli opremite z blagovno znamko: licenca ne podeljuje pravice do uporabe imen ali blagovnih znamk Adverant za nič drugega kot za navedbo izvora dela.

Izdajo Community razširjate na enak način kot izdajo Enterprise. Plugin SDK (komplet za razvoj programske opreme za vtičnike) je v obeh izdajah enak paket, pri čemer se ne spremenita niti predloga celotne storitve niti 22 vrat skladnosti; to obravnava poglavje 2.21, Plugin SDK. Delujejo tudi veščine. Community dobi celoten ustvarjalnik in knjižnico Skills Engine z različicami in testi, medtem ko kanarčkove izdaje (canary releases) in odobritev dveh oseb ostajajo v izdaji Enterprise.

Gradnja v izdaji Community
Gradnja v izdaji Community
Gradnja vtičnika za rezervacije na enem samem strežniku Community. Bodite pozorni na dostopno dovolilnico, ki doseže raven Propose prek storitve GitHub in ne ponuja ravni Elevate, ter na predstavitveno okno na desni, ki navaja, kaj dodaja izdaja Enterprise.

Razvijalske strani v izdaji Community ponujajo enake zlate poti s tremi razlikami, ki jih boste občutili takoj:

  1. Vaša koda živi v storitvi GitHub in ne v lastnih repozitorijih namestitve. Zlata pot za vtičnike ustvari repozitorij GitHub in razvojni prostor iz iste pripete predloge, ki jo uporablja Enterprise; zaslon DV18 prikazuje, kako ustvarja room-bookings.
  2. Zlati poti za domenske pakete in platformo sta del izdaje Enterprise. V izdaji Community gradite vtičnike in veščine ter leče (lenses) in delovne tokove na tem, kar poganjate.
  3. Dovolilnice v izdaji Community se ustavijo pod ravnjo Elevate. Na enem strežniku ni produkcijskega okolja, ki bi ga lahko dosegli iz IDE (integriranega razvojnega okolja), strežnik pa upravljate neposredno. Poskus iz okolja IDE je zavrnjen z PASS_TIER_REQUIRED.

Razvojni prostor Community na majhnem strežniku je skromen. Naš je imel 2 jedri in 8 GiB pomnilnika, bil je zaprt za vse, razen za tisto, kar določa manifest, in se je ugasnil po 7 dneh nedejavnosti.

Prispevanje nazaj v skupnost

Tudi Skills Engine je pod licenco Apache-2.0 in sprejema prispevke na običajen način. Razcepite (fork) repozitorij, ustvarite vejo iz main, izvedite spremembo skupaj z njenimi testi in zaženite preverjanja, preden odprete zahtevo za vlečenje (pull request):

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

Prispevek, ki spremeni delovanje, potrebuje test, ki brez tega prispevka spodleti. To ni le hišni slog: lastna pravila testiranja kompleta SDK določajo, da je treba za vsak nov test dokazati, da na drevesu pred spremembo spodleti, pregledovalci pa zahtevajo dokaze.

Moduli Enterprise in licenčna meja

Enterprise je Community plus licencirani moduli. Licencirani modul je ločen artefakt, ki ga storitev Community naloži ob zagonu; na ta način se funkcionalnosti Enterprise in katerikoli zaprti modul, ki ga zgradite za stranke Enterprise, priključijo na odprto jedro.

Pravilo, ki omogoča to delovanje, je licenčna meja. Zaprti modul lahko doseže izdajo Community samo prek enega paketa, @adverant/nexus-spi, ki je vmesnik ponudnika storitev (SPI). Je pod licenco Apache-2.0 in vsebuje vmesnike ter varovala tipov (type guards), ki jih gostitelj in modul uporabljata za medsebojno preverjanje, brez druge izvajalne logike. Povezovanje čez to mejo poteka prek vmesnika ali omrežnega protokola, nikoli prek izvorne kode.

Izvoz Kaj to je
RouteModule Licencirani usmerjevalni modul: id, featureGroup, bodies in register(app, ctx), ki priklopi svoje usmerjevalnike na gostiteljevo aplikacijo
SpiApp Del gostiteljeve aplikacije HTTP, ki se ga modul dotika: use
SpiContext Kaj gostitelj preda modulu: produktna vrata in varovalo obsega, bralnik licenc, nabor omejenih poizvedb (scoped-query pool), shemo storitve, zgornje (upstream) naslove in odjemalce platforme
SpiRuntime Vrednosti kompleta Plugin SDK, ki jih gostitelj preda modulu, tako da modul nikoli sam ne uvozi izvajalnega okolja SDK
SpiPlane Kaj licencirana ravnina doda poleg poti (routes), kot so na primer branja zaslonov, ki jih streže
ScreenModule Licencirana skupina zaslonov konzole: group, featureGroup, routes, screens in menu
GrantCheck (featureGroup) => Promise<{ entitled, code?: 'LICENCE_LOCKED' }>

Ogrodje HTTP in tip zaslona konzole sta tipska parametra, zato vmesnik ne veže nobenega od njiju. Tukaj je ogrodje usmerjevalnega modula s tipom obravnavalnika 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> je skupina funkcionalnosti iz matrike izdaj, ki ji modul streže. Vsaka licencirana pot teče za ctx.requireScope, gostiteljevimi produktnimi vrati in varovalom obsega, modul pa pred odgovorom preveri tudi lastno pooblastilo (grant). Modul, ki nima pravice, zavrne zahtevo z LICENCE_LOCKED in izriše predstavitveno okno funkcionalnosti, nikoli njenih podatkov. Vaš modul prav tako nikoli ne uvozi izvajalnega okolja kompleta Plugin SDK, ker je SDK paket izdaje Community, ki ga licenčna meja ne dopušča. Gostitelj mu preda vrednosti SDK, ki jih modul kliče. Preden gostitelj naloži katerikoli modul, namesti SpiHost na globalThis pod Symbol.for(SPI_HOST_KEY), ki vsebuje izvajalno okolje SDK in lasten nabor poti aplikacije. To se mora zgoditi najprej: modul, preveden v en sam sveženj, se ovrednoti kot celota, zato bi klic register prišel prepozno za kodo, ki bere vrednosti SDK med nalaganjem. Za tipe @adverant/nexus-spi/sdk/<module> ponovno izvozi deklaracije SDK, ki so nespremenjeno vključene (vendored) iz ene izdaje SDK in pripete z nadzorno vsoto (checksum), tako da vaš modul preverja tipe glede na ista telesa zavrnitev in odjemalce, kot jih uporablja vtičnik.

Zaslonski modul sledi še enemu pravilu: en modul na skupino funkcionalnosti, tako da se skupina, katere zasloni pripadajo dvema skupinama funkcionalnosti, dostavi kot dva modula, pri čemer le eden od njiju nosi vrstico v meniju.

Kaj zavrnejo vrata licenčne meje

Adverantova vrata licenčne meje zadržujejo vsak modul Enterprise na pravi strani meje, zato je vredno, da enakemu pravilu podvržete tudi svoje zaprte module. Njihova konfiguracija je ena sama datoteka:

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

Vsaka od naslednjih postavk pomeni ugotovitev z navedbo datoteke in vrstice:

  • vsak uvoz paketa pod obsegom Community, ki ni dovoljeni vmesnik ali paket Enterprise, vključno z dinamičnimi uvozi;
  • vsak določilnik, uvozna pot Go ali URL odvisnosti, ki imenuje repozitorij Community, razen če gre za modul Go, naveden v allowedCommunityGoModules;
  • relativni uvoz, ki se povzpne izven repozitorija;
  • odvisnost package.json, ki je pot file:, link:, portal: ali workspace: izven repozitorija ali Git URL do repozitorija Community;
  • go.mod replace, ki kaže izven repozitorija.

Program se zaključi s kodo 0, ko je vse čisto, in s kodo 1 ob ugotovitvah. Izhodna koda 2 pomeni zavrnitev, ker je bila konfiguracija napačna ali pa program ni pregledal ničesar. Paket vmesnika ni objavljen v registru. Znotraj svojega repozitorija hranite do bajta natančno pripeto kopijo zgrajenega paketa kot lokalni paket file:, s pripetjem SHA256SUMS in preverjanjem v vašem cevovodu, ki zavrne vsako kopijo, ki odstopa. Ker je kopija znotraj repozitorija, jo vrata sprejmejo.

Dva velika okvirja drug ob drugem. Levi okvir ima oznako »Community (Apache-2.0)« in vsebuje manjše okvirje za »Services«, »Plugin SDK« in »@adverant/nexus-spi«. Desni okvir ima oznako »Enterprise module (closed)« in vsebuje »RouteModule«, »ScreenModule« ter »GrantCheck«. Ena polna puščica prečka mejo, in sicer iz desnega okvirja samo do »@adverant/nexus-spi«, z oznako »compile against«. Dve črtkani puščici iz desnega okvirja do »Services« in »Plugin SDK« sta prečrtani in označeni z »licence-line gate: finding«.
Licenčna meja med izdajo Community in modulom Enterprise.

Izdelave za posamezne izdaje

Če se vaša razširitev dostavlja strankam na obeh izdajah, jo zgradite enkrat za vsako izdajo, vsaka gradnja pa poteka v svojem sestavljenem drevesu. Sestavljanje drevesa pomeni prevzem samo tistih datotek, ki pripadajo tej izdaji. Adverantov lastni izvoz to naredi iz mejnega seznama, v katerem je vsaka sledena datoteka dodeljena po pravilu »prvo ujemanje zmaga«: pravilo imenuje zmožnost in izdaja datoteke sledi iz ravni te zmožnosti v matriki izdaj, ali pa imenuje razred datotek, ki se z navedenim razlogom ne dostavi v nobeni izdaji. Datoteke, namenjene samo gradnji, se dostavijo v drevesu Enterprise in, kadar so tako označene, tudi v drevesu Community. Veriga migracij modula predstavlja podatke namestitvenega programa in se dostavi v drevesu vsake izdaje.

Nato v vsakem sestavljenem drevesu zaženite celotno čisto gradnjo od začetka. To pomeni vse tri ukaze, vsakič:

npm ci
npm test
npm run build

Tega smo se naučili na drag način: drevo Enterprise je uspešno opravilo teste, medtem ko je drevo Community spodletelo pri produkcijski gradnji, ker je tip, ki ga je potrebovalo, živel le v datoteki Enterprise. Uspešno opravljeni testi v enem drevesu vam ne povedo ničesar o drugem. Testi posamezne izdaje lahko uvažajo le tisto, kar vsebuje drevo te izdaje, izvoz pa zavrne test, ki seže izven njega.

Izvoz zapiše tudi licenco vsake izdaje. Datoteke Community nosijo identifikator SPDX (Software Package Data Exchange) Apache-2.0; datoteke Enterprise nosijo LicenseRef-Adverant-Enterprise, njihovo polje package.json pa navaja UNLICENSED. Teh polj ne urejajte ročno: izvoz jih prepiše, kopija, ki se ne ujema več s svojim pripetim besedilom licence, pa je zavrnjena.

Izdaja Team: samo v oblaku

Team je Community plus nabor Team in teče samo v oblaku Adverant. Samostojno gostovane izdaje Team ni. Nabor Team dodaja šest zmožnosti nad izdajo Community, med njimi združeno delovno ploščo, deljene zvezke, upravljanje knjižnice veščin in operacije delovnih tokov z napredovanjem med okolji.

Za razvijalca oblak pomeni le eno stvar: stranka Team dobi vaš vtičnik kot podpisano izdajo prek kataloga, nikoli z vaših lastnih strežnikov. Zgradite ga tako, kot ga gradi zunanji izdajatelj, na izdajateljskem gručnem sistemu (publisher cluster).

Izdajateljski gručni sistem
Izdajateljski gručni sistem
Izdajateljev lastni navidezni gručni sistem v oblaku Adverant, ki vsebuje le vzorčne podatke. Sledite aktivnemu toku na vrhu: IDE doseže izdajateljev gručni sistem in vzorčne podatke, podpisana izdaja gre skozi pregled v katalog, do nobene stranke pa ne vodi nobena pot.

Izdajateljski gručni sistem je navidezni gručni sistem v oblaku Adverant s kvoto, ki jo določi Adverant. Vsebuje samo vzorčne podatke in nima nobene poti do katerekoli stranke. Zahteva za maskirano kopijo podatkov stranke na tem mestu je zavrnjena z TENANT_BOUNDARY; stranka lahko z vami deli rezultate testiranj, nikoli pa svojih podatkov. Vaša dovolilnica na njem nikoli ne seže do stranke. Ko je izdaja pripravljena, jo Adverant podpiše in pregleda, preden je uvrščena v katalog. Vsaka stranka se nato odloči, ali jo bo namestila, in ji podeli le tisto, kar določa njen manifest, enoto za enoto. Klic česarkoli, česar manifest ni določil, je na strani stranke zavrnjen z CONNECTION_SCOPE_EXCEEDED, edini način za dodajanje pa je nova izdaja, ki jo stranka pregleda.

Stranke z izoliranim okoljem (air-gapped)

Ena od naših strank poganja Nexus tam, kjer prek omrežja nič ne gre noter ali ven. Njihova namestitev je opisana v poglavju 2.10, Zračno izolirana namestitev. Za nas je to pomenilo dostavo našega vtičnika na podpisanem nosilcu podatkov, orodje za to pa je nexus-airgap iz kompleta za suvereno dostavo @adverant/nexus-sovereign.

Zapečateni sveženj je en sam podpisan, samozadosten arhiv tarball. Vsebuje lahko slike in migracije, vnaprej podpisane veščine in uteži modelov ter SBOM (kosovnico programske opreme) z licencami vsega, kar je znotraj. Njegov manifest navaja vsako datoteko z njeno zgoščeno vrednostjo SHA-256 in je podpisan z Ed25519. Gradnja takšnega svežnja iz kode je videti takole:

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 je vaš ključ za podpisovanje izdaj. Ukaz nexus-airgap bundle naredi enako iz ukazne vrstice. Operater stranke ga nato preveri pred vsem drugim:

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

Preverjanje ponovno izračuna zgoščeno vrednost vsake datoteke glede na manifest, zavrne vsako datoteko, ki je manifest ne navaja, zahteva zaupanja vrednega podpisnika Ed25519 in zavrne vsak sveženj, katerega seznam dovoljenih omrežnih povezav ni prazen. Datoteka, spremenjena po podpisu, spodleti z BUNDLE_INTEGRITY_VIOLATION. Operaterju naročite, naj se tam ustavi in vas pokliče; obstaja tudi nestrogo stikalo, vendar ga nikoli ne smejo uporabiti.

Našo dostavo so vodila tri pravila:

  1. Zaupanja vreden ključ potuje ločeno od svežnja. Javni ključ in vrednost SHA-256 svežnja pošljemo po drugi poti kot nosilec podatkov, tako da sveženj ne more jamčiti sam zase.
  2. Nič v svežnju ob namestitvi ne sme potrebovati omrežja. Brez pridobivanja paketov, brez prenosa modelov, brez licenčnih klicev. Če vtičnik potrebuje model, ga zagotovi lastni strežnik modelov stranke prek usmerjevalnika ponudnikov UI (umetne inteligence) – AI Provider Router.
  3. Po preverjanju operater vnese izdajo prek lastnih kanalov za izdaje namestitve, natanko tako, kot bi to storila povezana stranka. Sveženj je način, kako prispejo bajti, ne pa obvoz okoli vrat za napredovanje.

Delo z zračno izoliranimi sistemi je počasnejše in tega z naše strani ni mogoče spremeniti. Napačen bajt stane nov komplet nosilcev podatkov in še eno pot, zato sveženj pred odhodom iz stavbe sami preverimo na čistem stroju z istim ukazom.

Misijski paketi Nexus Edge

Nexus Edge je manjši Nexus, ki teče na satelitih in dronih, na misijskih računalnikih, ločenih od računalnika za letenje. Gre za dodatek z licenco na platformo ali floto. Kar se spreminja od ene misije do druge, je misijski paket, in gradnja teh paketov predstavlja doberšen del moje službe.

Misijski paket nosi tisto, kar koristni tovor potrebuje za eno misijo. Poleg modelov in vmesnikov (adapters) vsebuje ontologijo z začetnim grafom, korake agentov, pravila opozarjanja, prednostne vrstne rede za to, kaj se prenese na tla najprej, razporeditveno tabelo, ki določa, kateri računalnik poganja kaj, korake okrnjenega delovanja, na katere se platforma lahko spusti ob odpovedi računalnika, in testne primere, ki jih mora uspešno opraviti na krovu.

Gradnja misijskega paketa
Gradnja misijskega paketa
Gradnja paketa Maritime watch 1.5 iz različice 1.4. Bodite pozorni na testne primere na krovu (48, vsi morajo uspeti) in razporeditveno tabelo, ki določa, kaj teče na vsaki od dveh plošč GPU (grafična procesna enota) in plošči CPU (centralna procesna enota) na vsakem koraku okrnjenega delovanja.

Paketi se gradijo in podpisujejo na tleh. Nekaj praktičnih pravil iz naših gradenj:

  • Velike dele ohranjajte stabilne. Maritime watch 1.5 je dodal vmesnik za iskanje ladij in dve pravili opozarjanja; jezikovni model in ontologija se nista spremenila, zato je bil paket velik 412 MB namesto 9.8 GB. Povezava navzgor (uplink) je ozka, osnovni modeli pa se naložijo pred izstrelitvijo.
  • Uporabite en sam model vektorske vložitve (embedding model) za celotno družino misij tako na tleh kot na koristnem tovoru, da se lahko spremembe grafa, ki se prenesejo na tla, združijo z grafom na tleh.
  • Koristni tovor nikoli ne pošlje ukaza sistemom za letenje. Prek nadzornika (supervisor) pošilja tipizirane zahteve računalniku za letenje, ki na vsako odgovori z obrazložitvijo.
  • Vsak tip strojne opreme potrebuje lastno preverjanje paketa. Namestitev paketa, ki ni bil preverjen za strojno opremo naprave, je zavrnjena z PACK_NOT_CHECKED_FOR_HARDWARE.
Podpis in pošiljanje paketa
Podpis in pošiljanje paketa
Izdaja paketa Maritime watch 1.5 na CORR-3. Potrebna sta dva od treh podpisov, tako da en sam ukraden ključ ne more izdati paketa, načrt pa prikazuje, da se paket vklopi šele, ko na krovu uspešno opravi vseh 48 testov.

Za izdajo sta potrebna dva od treh podpisov. Naš in Adverantov sta običajen par, tretji pa je ključ brez povezave (offline), ki ga hranimo v sefu za primer, ko bi se eden od drugih dveh izgubil. Paket se naloži v prosto režo (idle slot), se preveri, zažene svoje testne primere na dejanskih ploščah in se vklopi le, če vsi uspejo, pri čemer števec preprečuje ponovno namestitev starejšega paketa. Če test spodleti, platforma ostane na prejšnjem paketu, podatki o napaki pa se prenesejo na tla ob naslednjem preletu. Uvajanje izvajamo na eni platformi naenkrat, vsako po enem tednu čistega delovanja. Paketi ostanejo veljavni tudi, ko je platforma brez stika, tako da satelit brez povezave še naprej deluje s paketom, ki ga ima.

Na vozilih in plovilih lahko Edge teče na k3s. Vesoljsko plovilo namesto sistema Kubernetes poganja nadzornika s podpisanimi slikami ali statičnimi binarnimi datotekami ter fiksno razporeditveno tabelo, in prav zato razporeditvena tabela potuje znotraj paketa.

Trgovine z lastno blagovno znamko (white-label)

Dodatek Storefront / white-label omogoča stranki, da na tisto, kar vidijo njeni uporabniki, postavi lastno blagovno znamko in domeno z lastnimi prijavnimi zasloni ter sprejema plačila prek lastnih plačilnih prehodov. Podatki o karticah se nikoli ne dotaknejo sistema Nexus.

Vtičnik, zgrajen za stranko z lastno blagovno znamko (white-label), nikoli ne sme prikazati imena Adverant. Manifest nosi vse, kar je specifično za blagovno znamko, platforma pa preostanek razreši iz lastne blagovne znamke organizacije in ne iz česarkoli, kar bi bilo trdo kodirano v vaši kodi:

{
  "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> je lastna domena stranke in passkeyRpId se mora z njo ujemati, ker so ključi za dostop (passkeys) vezani na domeno, na kateri se oseba prijavi. Spletna aplikacija na lastnem izvoru (origin) prijavlja ljudi prek prijavnih pomočnikov kompleta SDK, katerih dve javni poti sta edini nevarovani poti /api, ki ju vrata obsega sprejmejo, in še to le, kadar ju manifest določi kot auth: public z allowAnonymous: true. Klici čelnega dela (frontend) potekajo prek posredniškega strežnika seznama dovoljenih povezav zalednega dela za čelni del (BFF), nikoli neposredno na naslov storitve. Skrbnik stranke konfigurira plačilno stran, od plačilnih prehodov do blagajne z blagovno znamko. Vaš vtičnik tega ne počne.

Matrika

Cilj gradnje Gradnja na podlagi Kaj naredite drugače Kako pride do stranke
Community Plugin SDK, Skills Engine Koda v storitvi GitHub; brez poti za domenske pakete ali platformo; brez ravni Elevate Namesti ga stranka; pregled za katalog ni potreben
Enterprise (vaša lastna namestitev) Plugin SDK, Skills Engine, predloge paketov Razvojni prostori, podatkovne veje, maskirane kopije z lastnikom podatkov; paketi in leče Napredovanje iz predprodukcijskega okolja (staging) v pilotno enoto, nato povsod
Modul Enterprise (zaprt) Samo @adverant/nexus-spi Pravilo licenčne meje; preverjanje pooblastila za lastno skupino funkcionalnosti; LICENCE_LOCKED, ko ni upravičen Ob zagonu ga naloži storitev Community na licenciranih namestitvah
Obe izdaji Plugin SDK Sestavite drevo vsake izdaje; npm ci, testi in produkcijska gradnja v vsakem Ena izdaja na izdajo sistema
Team Plugin SDK na izdajateljskem gručnem sistemu Samo vzorčni podatki; samo v oblaku Podpisana izdaja, pregled s strani podjetja Adverant, katalog
Zračno izolirano (Air-gapped) Plugin SDK, @adverant/nexus-sovereign Zapečateni sveženj; ključ in nadzorna vsota poslana ločeno; ob namestitvi se nič ne prenaša prek omrežja Podpisani nosilci podatkov, preverjeni, nato prek kanalov za izdaje namestitve
Nexus Edge Vsebina misijskega paketa Razporeditvena tabela, koraki okrnjenega delovanja, testi na krovu, preverjanja strojne opreme Dva od treh podpisov, prosta reža, vklop po uspešno opravljenih testih
Lastna blagovna znamka Plugin SDK domains in branding v manifestu; nikjer nobenega imena Adverant Enako kot za Enterprise, na lastni domeni stranke

Ne glede na cilj poteka uvajanje (deploy) izključno prek kanalov za izdaje namestitve. Te kanale obravnava poglavje 2.28, Izdajanje vaše razširitve. Poglavje 2.27, Scenariji gradnje, pa vsebuje recept za vsako zgornjo vrstico.