Kirjaudu sisäänVaraa esittely

Luku 2.25

Rakentaminen eri versioille

Mikä muuttuu, kun yhden laajennuksen on toimittava jokaisessa versiossa, ilmavälitteisessä ympäristössä, Nexus Edge -kokoonpanossa tai asiakkaan oman brändin alla. Käsittelee Enterprise-moduulien lisenssirajan ja allekirjoitetun offline-toimituksen sekä sisältää matriisin siitä, mitä kussakin kohteessa on tehtävä toisin.

Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

17 minuutin lukuaika

Corrán Orbitalissa toimitamme useampaan paikkaan kuin useimmat tiimit. Omat insinöörimme käyttävät Enterpriseä maassa. Satelliitti CORR-3 ajaa tehtäväpakettia Nexus Edgellä. Kaksi asiakasta käyttää Communityä yhdellä palvelimella, yksi käyttää ilmaeristettyä Enterprise-asennusta, joka ei koskaan ole yhteydessä internetiin, ja olemme rakentaneet paketin vakuutusyhtiölle sen omaan asennukseen. Taustalla oleva koodi on pääosin sama, ja erot liittyvät pääosin siihen, minne se saa mennä ja miten se sinne päätyy.

Tässä luvussa käydään läpi kukin kohde vuorollaan: mitä vasten rakennatte, mihin ette saa koskea ja miten tulos päätyy asiakkaalle. Lopussa oleva matriisi kokoaa kaiken yhdelle sivulle. Luvussa 2.18, Laajennusmalli, selitetään, miten taidot, liitännäiset, paketit ja moduulit eroavat toisistaan. Luvussa 2.2, Versiot konepellin alla, kuvataan itse versiot.

Community ja avoin ydin

Community on avoin ydin, joka on lisensoitu Apache License, Version 2.0 -lisenssillä. Voitte haarauttaa sen ja toimittaa siihen tekemiänne muutoksia. Sen mukana kulkeva NOTICE-tiedosto kertoo yhden asian, joka kannattaa tietää ennen kuin brändäätte mitään: lisenssi ei myönnä oikeutta käyttää Adverantin nimiä tai tavaramerkkejä muuten kuin kertomaan, mistä työ on peräisin.

Communityä laajennetaan samalla tavalla kuin Enterpriseä. Plugin SDK (ohjelmistokehityspaketti) on sama paketti molemmissa versioissa, eikä täyden palvelun malli tai 22 noudattamisporttia muutu; luku 2.21, Plugin SDK, käsittelee sen. Myös taidot toimivat. Community saa koko Skills Enginen luontityökalun ja kirjaston versioineen ja testeineen, kun taas canary-julkaisut ja kahden henkilön hyväksyntä jäävät Enterpriseen.

Rakentaminen Communityssa
Rakentaminen Communityssa
Varausliitännäisen rakentaminen yhdellä Community-palvelimella. Huomatkaa käyttöoikeuspassi, joka ulottuu Propose-tasolle GitHubin kautta eikä tarjoa Elevate-tasoa, sekä oikealla oleva esittely, jossa luetellaan, mitä Enterprise tuo lisää.

Communityn kehittäjäsivut tarjoavat samat kultaiset polut kolmella erolla, jotka huomaatte heti:

  1. Koodinne sijaitsee GitHubissa eikä asennuksen omissa repositorioissa. Liitännäisen kultainen polku luo GitHub-repositorion ja kehitystilan samasta kiinnitetystä mallista, jota Enterprise käyttää; näkymä DV18 näyttää sen luovan room-bookings.
  2. Toimialapaketin ja alustan kultaiset polut kuuluvat Enterpriseen. Communityssä rakennatte liitännäisiä ja taitoja sekä linssejä ja työnkulkuja ajamienne asioiden päälle.
  3. Communityn passit päättyvät Elevate-tason alapuolelle. Yhdellä palvelimella ei ole tuotantoympäristöä, johon IDE:stä (integroidusta kehitysympäristöstä) voisi ulottua, ja palvelinta hallinnoidaan suoraan. IDE:stä tehty yritys hylätään koodilla PASS_TIER_REQUIRED.

Community-kehitystila pienellä palvelimella on vaatimaton. Meidän tilassamme oli 2 ydintä ja 8 GiB muistia, se oli suljettu manifestissa ilmoitettua lukuun ottamatta, ja se päättyi 7 käyttämättömän päivän jälkeen.

Takaisin osallistuminen

Myös Skills Engine on Apache-2.0-lisensoitu, ja se ottaa vastaan kontribuutioita tavanomaiseen tapaan. Haarauttakaa repositorio, luokaa haara kohdasta main, tehkää muutos testeineen ja ajakaa tarkistukset ennen kuin avaatte pull requestin:

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

Toimintaa muuttava kontribuutio tarvitsee testin, joka epäonnistuu ilman sitä. Se ei ole talon tyyli: SDK:n omien testaussääntöjen mukaan jokaisen uuden testin on osoitettava epäonnistuvan puussa ennen muutosta, ja tarkastajat pyytävät näyttöä.

Enterprise-moduulit ja lisenssiraja

Enterprise on Community plus lisensoidut moduulit. Lisensoitu moduuli on erillinen artefakti, jonka Community-palvelu lataa käynnistyessään, ja sen avulla Enterprise-ominaisuudet sekä mikä tahansa Enterprise-asiakkaille rakentamanne suljettu moduuli liitetään avoimeen ytimeen.

Tämän toimivuuden takaava sääntö on lisenssiraja. Suljettu moduuli saa ulottua Community-versioon vain yhden paketin kautta, @adverant/nexus-spi, joka on palveluntarjoajan rajapinta. Se on Apache-2.0-lisensoitu ja sisältää rajapintoja sekä tyyppivahteja, joilla isäntä ja moduuli tarkistavat toisensa, eikä mitään muuta ajonaikaista logiikkaa. Kytkentä rajan yli on rajapinta tai verkkoprotokolla, ei koskaan lähdekoodi.

Vienti Mikä se on
RouteModule Lisensoitu reittimoduuli: id, featureGroup, bodies ja register(app, ctx), joka liittää reitittimensä isännän sovellukseen
SpiApp Isäntäjärjestelmän HTTP-sovelluksen osa, johon moduuli koskee: use
SpiContext Mitä isäntä antaa moduulille: tuoteportin ja laajuusvahdin, lisenssinlukijan, rajattujen kyselyjen poolin, palvelun skeeman, ylävirran osoitteet ja alustan asiakasohjelmat
SpiRuntime Plugin SDK:n arvot, jotka isäntä antaa moduulille, jotta moduuli ei koskaan itse tuo SDK:n ajonaikaista osaa
SpiPlane Mitä lisensoitu taso lisää reittien lisäksi, kuten sen tarjoamat näkymien lukuoperaatiot
ScreenModule Konsolin lisensoitu näkymäryhmä: group, featureGroup, routes, screens ja menu
GrantCheck (featureGroup) => Promise<{ entitled, code?: 'LICENCE_LOCKED' }>

HTTP-kehys ja konsolin näkymätyyppi ovat tyyppiparametreja, joten rajapinta ei sido kumpaakaan. Tässä on reittimoduulin runko Express-käsittelijätyypillä:

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> on se versiomatriisin ominaisuusryhmä, jota moduuli palvelee. Jokainen lisensoitu reitti ajetaan ctx.requireScope:n takana, joka on isännän tuoteportti ja laajuusvahti, ja moduuli tarkistaa myös oman oikeutensa ennen vastaamista. Moduuli, jolla ei ole oikeutta, kieltäytyy koodilla LICENCE_LOCKED ja näyttää ominaisuuden esittelyn, ei koskaan sen tietoja. Moduulinne ei myöskään koskaan tuo plugin SDK:n ajonaikaista osaa, koska SDK on Community-paketti, jota raja ei päästä läpi. Isäntä antaa sille SDK-arvot, joita se kutsuu. Ennen kuin isäntä lataa yhtään moduulia, se asentaa SpiHost:n kohteeseen globalThis avaimella Symbol.for(SPI_HOST_KEY), ja se sisältää SDK:n ajonaikaisen osan ja sovelluksen oman reittipaketin. Sen on tapahduttava ensin: yhdeksi paketiksi käännetty moduuli arvioidaan kokonaisuutena, ja register-kutsu tulisi liian myöhään koodille, joka lukee SDK-arvoja latautuessaan. Tyyppejä varten @adverant/nexus-spi/sdk/<module> vie uudelleen SDK:n määrittelyt, jotka on sisällytetty muuttamattomina yhdestä SDK-julkaisusta ja kiinnitetty tarkistussummalla, joten moduulinne tyyppitarkistetaan samoja hylkäysrunkoja ja asiakasohjelmia vasten, joita liitännäinen käyttää.

Näkymämoduuli noudattaa yhtä lisäsääntöä: yksi moduuli ominaisuusryhmää kohden, joten ryhmä, jonka näkymät kuuluvat kahteen ominaisuusryhmään, toimitetaan kahtena moduulina, ja vain toinen niistä sisältää valikkorivin.

Mitä lisenssirajan portti hylkää

Adverantin lisenssirajan portti pitää jokaisen Enterprise-moduulin rajan sisällä, ja omat suljetut moduulinne kannattaa pitää saman säännön alaisina. Sen konfiguraatio on yksi tiedosto:

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

Kukin seuraavista on löydös tiedostoineen ja riveineen:

  • mikä tahansa Community-laajuuden alaisen paketin tuonti, joka ei ole sallittu rajapinta tai Enterprise-paketti, dynaamiset tuonnit mukaan lukien;
  • mikä tahansa määrite, Go-tuontipolku tai riippuvuuden URL, joka nimeää Community-repositorion, ellei se ole kohdassa allowedCommunityGoModules lueteltu Go-moduuli;
  • suhteellinen tuonti, joka nousee repositorion ulkopuolelle;
  • package.json-riippuvuus, joka on repositorion ulkopuolinen file:-, link:-, portal:- tai workspace:-polku tai Git-URL Community-repositorioon;
  • go.mod replace, joka osoittaa repositorion ulkopuolelle.

Se palauttaa koodin 0, kun löydöksiä ei ole, ja 1, kun niitä on. Koodi 2 tarkoittaa, että se kieltäytyi, koska sen konfiguraatio oli virheellinen tai se ei tarkistanut mitään. Rajapintapakettia ei julkaista rekisteriin. Kuljetatte rakennetun paketin tavutasolla kiinnitettyä kopiota repositoriossanne paikallisena file:-pakettina, SHA256SUMS-kiinnityksen ja putkessanne olevan tarkistuksen kanssa, joka hylkää poikkeavan kopion. Koska kopio on repositorion sisällä, portti hyväksyy sen.

Kaksi suurta laatikkoa vierekkäin. Vasemman laatikon otsikko on "Community (Apache-2.0)", ja siinä on pienemmät laatikot "Services", "Plugin SDK" ja "@adverant/nexus-spi". Oikean laatikon otsikko on "Enterprise module (closed)", ja siinä ovat "RouteModule", "ScreenModule" ja "GrantCheck". Yksi yhtenäinen nuoli ylittää rajan oikeasta laatikosta vain kohteeseen "@adverant/nexus-spi", ja sen nimike on "compile against". Kaksi katkoviivanuolta oikeasta laatikosta kohteisiin "Services" ja "Plugin SDK" on yliviivattu, ja niiden nimike on "licence-line gate: finding".
Lisenssiraja Communityn ja Enterprise-moduulin välillä.

Versiokohtaiset koontiversiot

Jos laajennuksenne toimitetaan asiakkaille molemmissa versioissa, rakennatte sen kerran kutakin versiota kohden, ja kukin koonti tehdään omassa kootussa puussaan. Puun kokoaminen tarkoittaa, että otetaan vain kyseiseen versioon kuuluvat tiedostot. Adverantin oma vienti tekee tämän rajaluettelon perusteella, jossa jokainen seurattu tiedosto osoitetaan ensimmäinen osuma voittaa -säännöillä: sääntö nimeää kyvykkyyden, ja tiedoston versio määräytyy kyseisen kyvykkyyden tasosta versiomatriisissa, tai se nimeää tiedostoluokan, jota ei toimiteta kummassakaan versiossa, perusteluineen. Vain koontia varten olevat tiedostot toimitetaan Enterprise-puussa ja merkittyinä myös Community-puussa. Moduulin migraatioketju on asennusohjelman dataa, ja se toimitetaan jokaisen version puussa.

Ajakaa sitten koko koonti puhtaalta pöydältä kussakin kootussa puussa. Se tarkoittaa kaikkia kolmea komentoa, joka kerta:

npm ci
npm test
npm run build

Opimme tämän kalliilla tavalla: Enterprise-puu läpäisi testinsä, kun taas Community-puun tuotantokoonti epäonnistui, koska sen tarvitsema tyyppi oli vain Enterprise-tiedostossa. Yhdessä puussa läpäistyt testit eivät kerro mitään toisesta. Version testit saavat tuoda vain sitä, mitä kyseisen version puu sisältää, ja vienti hylkää testin, joka ulottuu sen ulkopuolelle.

Vienti kirjoittaa myös kunkin version lisenssin. Community-tiedostoissa on SPDX (Software Package Data Exchange) -tunniste Apache-2.0; Enterprise-tiedostoissa on LicenseRef-Adverant-Enterprise, ja niiden package.json on UNLICENSED. Älkää muokatko näitä kenttiä käsin: vienti kirjoittaa ne uudelleen, ja kopio, joka ei enää vastaa kiinnitettyä lisenssitekstiään, hylätään.

Team: vain pilvessä

Team on Community plus Team-kokonaisuus, ja se toimii vain Adverant-pilvessä. Itse ylläpidettävää Teamia ei ole. Team-kokonaisuus lisää Communityn päälle kuusi kyvykkyyttä, muun muassa yhdistetyn työpaneelin, jaetut muistikirjat, taitokirjaston hallinnan sekä työnkulkujen operoinnin ja ylennyksen ympäristöjen välillä.

Rakentajalle pelkkä pilvi tarkoittaa yhtä asiaa: Team-asiakas saa liitännäisenne allekirjoitettuna julkaisuna luettelon kautta, ei koskaan omilta palvelimiltanne. Rakennatte sen samalla tavalla kuin ulkopuolinen julkaisija rakentaa, julkaisijaklusterissa.

Julkaisijaklusteri
Julkaisijaklusteri
Julkaisijan oma virtuaaliklusteri Adverant-pilvessä, vain esimerkkidatalla. Seuratkaa reaaliaikaista kulkua yläreunassa: IDE ulottuu julkaisijan klusteriin ja esimerkkidataan, allekirjoitettu julkaisu kulkee tarkastuksen kautta luetteloon, eikä polkua mihinkään asiakkaaseen ole.

Julkaisijaklusteri on virtuaaliklusteri Adverant-pilvessä, ja sen kiintiön asettaa Adverant. Se sisältää vain esimerkkidataa, eikä sieltä ole reittiä mihinkään asiakkaaseen. Pyyntö saada siellä maskattu kopio asiakkaan datasta hylätään koodilla TENANT_BOUNDARY; asiakas voi jakaa testituloksia kanssanne, ei koskaan dataansa. Siellä oleva passinne ei koskaan ulotu asiakkaaseen. Kun julkaisu on valmis, se allekirjoitetaan ja Adverant tarkastaa sen ennen kuin se listataan luetteloon. Kukin asiakas päättää sitten, asentaako sen, ja myöntää sille vain sen, mitä sen manifesti ilmoittaa, yksikkö kerrallaan. Kutsu mihin tahansa, mitä manifesti ei ilmoittanut, hylätään asiakkaan päässä koodilla CONNECTION_SCOPE_EXCEEDED, ja ainoa tapa lisätä se on uusi julkaisu, jonka asiakas tarkastaa.

Ilmaeristettyjä ympäristöjä käyttävät asiakkaat

Yksi asiakkaistamme käyttää Nexusta ympäristössä, jossa mitään ei kulje sisään tai ulos verkon kautta. Heidän asennuksensa kuvataan luvussa 2.10, Ilmaeristetty asennus. Meille se tarkoitti liitännäisemme toimittamista allekirjoitetulla medialla, ja työkalu siihen on nexus-airgap suvereenin toimituksen paketista @adverant/nexus-sovereign.

Sinetöity paketti on yksi allekirjoitettu, itsenäinen tarball-arkisto. Se voi sisältää kuvia ja migraatioita, valmiiksi allekirjoitettuja taitoja ja mallien painoja sekä SBOM:n (ohjelmiston osaluettelon), jossa on kaiken sisällön lisenssit. Sen manifesti luettelee jokaisen tiedoston SHA-256-tiivisteineen, ja se on allekirjoitettu Ed25519:llä. Sellaisen rakentaminen koodista näyttää tältä:

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 on julkaisujenne allekirjoitusavain. Komento nexus-airgap bundle tekee saman komentoriviltä. Asiakkaan operaattori tarkistaa sen sitten ennen mitään muuta:

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

Varmennus laskee jokaisen tiedoston tiivisteen uudelleen manifestia vasten, hylkää kaikki tiedostot, joita manifesti ei luettele, edellyttää luotettua Ed25519-allekirjoittajaa ja hylkää kaikki paketit, joiden verkon sallittujen luettelo ei ole tyhjä. Allekirjoituksen jälkeen muutettu tiedosto epäonnistuu koodilla BUNDLE_INTEGRITY_VIOLATION. Kehottakaa operaattoria pysähtymään siihen ja soittamaan teille; käytettävissä on ei-tiukka kytkin, eikä sitä pidä koskaan käyttää.

Toimituksemme perustui kolmeen sääntöön:

  1. Luotettu avain kulkee erillään paketista. Lähetämme julkisen avaimen ja paketin SHA-256-tiivisteen eri reittiä kuin median, jotta paketti ei voi taata itseään.
  2. Mikään paketissa ei saa tarvita verkkoa asennuksen aikana. Ei pakettien noutoa, ei mallien latausta, ei lisenssikutsua. Jos liitännäinen tarvitsee mallin, asiakkaan oma mallipalvelin tarjoaa sen tekoälyn (AI) Provider Routerin kautta.
  3. Varmennuksen jälkeen operaattori tuo julkaisun sisään asennuksen omien julkaisukanavien kautta, täsmälleen kuten verkkoon yhdistetty asiakas tekisi. Paketti on tapa, jolla tavut saapuvat, ei tapa kiertää ylennysportteja.

Ilmaeristetty työ on hitaampaa, eikä sitä voi korjata meidän puolestamme. Väärä tavu maksaa uuden mediasarjan ja uuden matkan, joten varmennamme paketin itse puhtaalla koneella samalla komennolla ennen kuin se lähtee talosta.

Nexus Edge -tehtäväpaketit

Nexus Edge on pienempi Nexus, joka toimii satelliiteissa ja drooneissa, lennonohjaustietokoneesta erillään pidetyillä tehtävätietokoneilla. Se on lisäosa, jonka lisenssi myönnetään alustakohtaisesti tai laivastokohtaisesti. Tehtävästä toiseen muuttuu tehtäväpaketti, ja niiden rakentaminen on hyvä osa työtäni.

Tehtäväpaketti sisältää sen, mitä hyötykuorma tarvitsee yhtä tehtävää varten. Mallien ja sovittimien lisäksi se sisältää ontologian aloitusgraafeineen, agenttivaiheet, hälytyssäännöt, prioriteetit sille, mikä lähetetään alas ensin, sijoittelutaulukon, joka kertoo, mikä tietokone suorittaa mitäkin, heikennetyt vaiheet, joihin alusta voi pudota tietokoneen vikaantuessa, sekä testitapaukset, jotka sen on läpäistävä aluksella.

Rakenna tehtäväpaketti
Rakenna tehtäväpaketti
Maritime watch 1.5:n rakentaminen versiosta 1.4. Huomaa aluksella suoritettavat testitapaukset (48, kaikkien on läpäistävä) sekä sijoittelutaulukko, joka kertoo, mitä kullakin kahdella GPU-kortilla (grafiikkasuoritin) ja CPU-kortilla (keskusyksikkö) suoritetaan kussakin heikennetyssä vaiheessa.

Paketit rakennetaan ja allekirjoitetaan maassa. Joitakin käytännön sääntöjä omista rakennuksistamme:

  • Pidä suuret osat vakaina. Maritime watch 1.5 lisäsi aluksentunnistussovittimen ja kaksi hälytyssääntöä; kielimalli ja ontologia eivät muuttuneet, joten paketin koko oli 412 MB eikä 9.8 GB. Ylöslinkki on kapea, ja perusmallit ladataan ennen laukaisua.
  • Käytä yhtä upotusmallia koko tehtäväperheelle sekä maassa että hyötykuormassa, jotta alas tulevat graafimuutokset voidaan yhdistää maagraafiin.
  • Hyötykuorma ei koskaan lähetä komentoa lentojärjestelmille. Se lähettää tyypitettyjä pyyntöjä valvojan kautta lennonohjaustietokoneelle, joka vastaa jokaiseen perusteluineen.
  • Jokainen laitteistotyyppi tarvitsee oman tarkistuksensa paketista. Sellaisen paketin asennus, jota ei ole tarkistettu laitteen laitteistolle, hylätään virheellä PACK_NOT_CHECKED_FOR_HARDWARE.
Allekirjoita ja lähetä paketti
Allekirjoita ja lähetä paketti
Maritime watch 1.5:n julkaiseminen alustalle CORR-3. Tarvitaan kaksi kolmesta allekirjoituksesta, joten yksi varastettu avain ei voi julkaista pakettia, ja suunnitelma näyttää, että paketti otetaan käyttöön vasta, kun sen 48 testiä on läpäisty aluksella.

Julkaisu edellyttää kahta kolmesta allekirjoituksesta. Tavallisesti pari muodostuu meidän ja Adverantin allekirjoituksesta, ja kolmas on offline-avain, jota säilytämme kassakaapissa sen varalta, että jompikumpi kahdesta muusta katoaa. Paketti lähetetään joutilaaseen paikkaan, se varmennetaan, sen testitapaukset suoritetaan todellisilla korteilla, ja se otetaan käyttöön vain, jos ne kaikki läpäistään, ja laskuri estää vanhemman paketin uudelleenasennuksen. Jos testi epäonnistuu, alusta jatkaa edellisellä paketilla ja virhe lähetetään alas seuraavalla ylilennolla. Otamme paketin käyttöön alusta kerrallaan, kukin vasta viikon virheettömän toiminnan jälkeen. Paketit pysyvät voimassa, kun alusta on yhteyden ulkopuolella, joten satelliitti, jolla ei ole yhteyttä, jatkaa toimintaa nykyisellä paketillaan.

Ajoneuvoissa ja aluksissa Edge voi toimia k3s:n päällä. Avaruusaluksessa on Kubernetesin sijaan valvoja, jossa on allekirjoitetut levykuvat tai staattiset binäärit ja kiinteä sijoittelutaulukko, ja siksi sijoittelutaulukko kulkee paketin sisällä.

White-label-kauppapaikat

Storefront / white-label -lisäosan avulla asiakas voi käyttää omaa brändiään ja verkkotunnustaan siinä, mitä hänen käyttäjänsä näkevät, omilla kirjautumisnäkymillään, ja vastaanottaa maksuja omien maksuyhdyskäytäviensä kautta. Korttitiedot eivät koskaan kulje Nexuksen kautta.

White-label-asiakkaalle rakennettu laajennus ei saa koskaan näyttää Adverantia. Manifesti sisältää kaiken brändikohtaisen, ja alusta selvittää loput organisaation omasta brändistä eikä mistään koodiinne kovakoodatusta:

{
  "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> on asiakkaan oma verkkotunnus, ja passkeyRpId on vastattava sitä, koska pääsyavaimet on sidottu verkkotunnukseen, jolla henkilö kirjautuu. Omalla alkuperällään toimiva verkkosovellus kirjaa ihmiset sisään SDK:n kirjautumisapureiden kautta, joiden kaksi julkista reittiä ovat ainoat suojaamattomat /api-reitit, jotka käyttöoikeusportti hyväksyy, ja vain, kun manifesti määrittelee ne auth: public ja niille on lisäksi määritetty allowAnonymous: true. Käyttöliittymän kutsut kulkevat backend for frontend -sallittujen luettelon välityspalvelimen kautta, ei koskaan suoraan palvelun osoitteeseen. Asiakkaan järjestelmänvalvoja määrittää maksupuolen maksuyhdyskäytävistä brändättyyn kassaan. Teidän laajennuksenne ei tee sitä.

Matriisi

Rakennuskohde Rakennuspohja Mitä teette toisin Miten se päätyy asiakkaalle
Community Plugin SDK, Skills Engine Koodi GitHubissa; ei toimialapakettia tai alustapolkuja; ei Elevatea Asiakas asentaa sen; luettelotarkastusta ei tarvita
Enterprise (oma asennuksenne) Plugin SDK, Skills Engine, pakettipohjat Kehitystilat, datahaarat, maskatut kopiot tiedon omistajan kanssa; paketit ja näkymät Siirto testiympäristöstä pilottiyksikköön ja sitten kaikkialle
Enterprise-moduuli (suljettu) Vain @adverant/nexus-spi Lisenssirajasääntö; oikeustarkistus omalle ominaisuusryhmälleen; LICENCE_LOCKED, kun oikeutta ei ole Community-palvelu lataa sen käynnistyksessä lisensoiduissa asennuksissa
Molemmat versiot Plugin SDK Kokoa kunkin version puu; npm ci, testit ja tuotantokäännös kussakin Yksi julkaisu versiota kohden
Team Plugin SDK julkaisijaklusterissa Vain esimerkkidataa; vain pilvi Allekirjoitettu julkaisu, Adverantin tarkastus, luettelo
Eristetty verkko Plugin SDK, @adverant/nexus-sovereign Sinetöity paketti; avain ja tarkistussumma lähetetään erikseen; asennuksessa ei noudeta mitään Allekirjoitettu media, varmennettu, sitten asennuksen julkaisukanavat
Nexus Edge Tehtäväpaketin sisältö Sijoittelutaulukko, heikennetyt vaiheet, aluksella suoritettavat testit, laitteistotarkistukset Kaksi kolmesta allekirjoituksesta, joutilas paikka, käyttöönotto testien läpäisyn jälkeen
Valkoinen nimike Plugin SDK domains ja branding manifestissa; Adverantin nimeä ei missään Kuten Enterprisessa, asiakkaan omalla verkkotunnuksella

Kohteesta riippumatta käyttöönotto tapahtuu vain asennuksen julkaisukanavien kautta. Luku 2.28, Laajennuksen julkaiseminen, käsittelee näitä kanavia. Luvussa 2.27, Rakennusskenaariot, on ohje kullekin yllä olevalle riville.