Versio 1.0.0-alpha.1uusin
Luku 2.27
Rakennusskenaariot
Kolmentoista toteutuksen keittokirja yksittäisestä taidosta aina ilmavälitteiseen toimitukseen. Jokainen resepti sisältää tavoitteen, rakennuspalikat, vaiheet ja komennot, toimivuuden todentavan tarkistusportin sekä tiedot siitä, mikä muuttuu version ja toimitusmuodon mukaan.
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

Nämä ovat ne reseptit, joihin tartun, kun joku Corrán Orbital -yhtiössä tai asiakkaalla sanoo: "haluamme, että Nexus tekee X:n". Jokainen on tarkoituksella lyhyt. Vaiheiden perustelut löytyvät tätä edeltävistä luvuista: luku 2.20, Skills, ja luku 2.21, The Plugin SDK, joka käsittelee ohjelmistokehityspakettia, sitten luku 2.23, Toimialapaketit, sekä sen jälkeiset kolme rakentamista käsittelevää lukua. Tästä saatte tavoitteen, käytettävät rakennuspalikat, vaiheet, komennot, portin, joka kertoo onnistumisesta, sekä versio- ja toimitushuomautukset.
Portti on tärkein. Resepti on valmis, kun sen portti on vihreä. Jokainen tämän luvun portti on jotain, minkä voitte ajaa itse tai minkä alusta ajaa puolestanne, ja jokainen päättyy nollasta poikkeavaan paluuarvoon tai hylkää koodilla, kun se ei täyty.
| Skenaario | Pääasiallinen rakennuspalikka | Sen todistava portti | Versio |
|---|---|---|---|
| Uusi Skills Engine -taito | SKILL.md-paketti |
skill:validate ilman virheitä |
Community ja Enterprise |
Manifestitaito, jossa on host_callback |
Laajennuksen manifesti skills[] |
create-nexus-plugin validate ja nexus-gates |
Community ja Enterprise |
| Olemassa olevan paketin laajentaminen | pack.json kentällä inherits |
Linssikäytännön tarkistus pilottiportilla | Enterprise ja pakettilisenssi |
| Uusi paketti alusta alkaen | Toimialapaketin kultainen polku | Staging- ja pilottiportit | Enterprise |
| Tietoliitin | plugin_queue-taito |
validate, nexus-gates, lähtevän liikenteen hylkäys |
Community ja Enterprise |
| MCP (Model Context Protocol) -työkalu | Manifestin mcpTools[] |
validate (ei ylätason kombinaattoreita) |
Community ja Enterprise |
| White label -verkkokauppa | Manifestin domains ja branding |
scope-adherence-julkisuussääntö |
Enterprise ja Storefront-lisäosa |
| Edge-tehtäväpaketti | Tehtäväpaketti | Laitteella ajettavat testitapaukset, kaksi kolmesta allekirjoituksesta | Enterprise ja Nexus Edge -lisäosa |
| Ilmaeristetty toimitus | Sinetöity paketti | nexus-airgap verify |
Enterprise |
| Vain Enterprise-versioon kuuluva moduuli | @adverant/nexus-spi |
Lisenssirajaportti, versiokohtaiset koonnit | Enterprise |
| Avoimen ytimen haarauttaminen tai laajentaminen | Community-lähdekoodi | Testit, lint ja tyyppitarkistus | Community |
| Team-version pilvisovellus | Julkaisijaklusteri | Allekirjoitettu julkaisu, katselmointi, asiakkaan käyttöoikeus | Team |
| Olemassa olevan sisäisen sovelluksen kääriminen | /plugin-create |
migrate, validate, nexus-gates |
Community ja Enterprise |
1. Uusi Skills Engine -taito
Tavoitteena on uudelleenkäytettävä ohje, jota avustaja, agentit, työnkulut ja kehittäjätyökalut voivat kaikki ajaa, esimerkiksi tulli-ilmoituksen tarkistaminen sen sääntöjä vasten. Rakennuspalikoitanne ovat SKILL.md-paketti taidon mukaan nimetyssä kansiossa, valinnainen skill.yaml laukaisimia ja tunnisteita varten sekä valinnainen sen mukana paketoitu scripts/-kansio.
- Luokaa
skills/<slug>/ja kirjoittakaaSKILL.md, jossa on frontmatter:name(kebab-case, sama kuin kansion nimi),description(enintään 500 merkkiä),allowed-toolssekä valinnaisestitriggers,capabilitiesjaversion. - Kirjoittakaa runko mallille: milloin taitoa käytetään, sen vaiheet, esimerkit ja mitä se ei saa koskaan tehdä.
- Lisätkää testitapauksia. Sisällyttäkää yksi, jonka syötteeseen on istutettu ohje, jota taito ei saa noudattaa.
- Validoikaa, tarkastelkaa latussuunnitelmaa ja ladatkaa sitten.
- Julkaiskaa. Kirjoitustyökalun lisäävä taito pidätetään, kunnes kaksi nimettyä henkilöä hyväksyy sen pääsyavaimilla, eikä ehdottaja voi hyväksyä omaa muutostaan.
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing --dry-run
npm run skill:upload skills/check-a-customs-filingPortti on skill:validate, jonka on raportoitava nolla virhettä ennen kuin mitään voidaan julkaista. Estäviä virheitä ovat puuttuva nimi tai kuvaus sekä päällekkäinen slug tai työtyyppi. Jo julkaistun sisällön lataaminen palauttaa olemassa olevan version (CONTENT_HASH_ALREADY_PUBLISHED), joten latauksen voi turvallisesti toistaa.
Community sisältää koko luontityökalun, kirjaston, versiot, takaisin vaihtamisen, tuonnin ja testit. Enterprise-versiossa julkaisu kulkee lisäksi varjo- ja canary-vaiheen kautta: hyväksytty versio ajetaan varjossa, sitten yhdessä yksikössä nimettyjen porttien takana ja sitten kaikille, ja se pysäyttää itsensä, jos jokin portti ei täyty. Ilmaeristetylle asiakkaalle taidot toimitetaan valmiiksi allekirjoitettuina sinetöidyn paketin sisällä (skenaario 9).
2. Manifestitaito ja host_callback
Tavoitteena on omassa laajennuksessanne oleva deterministinen laskenta, jonka alusta voi välittää suoritettavaksi, esimerkiksi poikkeamatietueen avaaminen lukemasta. Käytätte manifestin skills[]-osion riviä, jonka taso on host_callback, sekä taustajärjestelmänne /internal-reittiä, jota suojaa SDK:n palveluvartija.
- Määritelkää taito:
idlower_snake-muodossa,tier: "host_callback",classification, joka on enintään laajennuksenne luottamuskaton tasolla,inputSchema,outputSchemasekätimeoutMsväliltä 1 sekunti – 6 tuntia. - Täyttäkää
hostCallback: oman palvelunne nimi, sen portti, suhteellinen polku kuten/internal/skills/excursion_open, molemmat tavurajat (maxRequestBytesjamaxResponseBytes) sekätenantHeader: "X-Organization-ID". - Määritelkää reitti
api.endpoints[]:ssä käyttäenauth: "service-key"taiauth: "internal", ja suojatkaa se vartijallarequireServicetaiserviceMiddleware, ei koskaan käyttäjän scope-vartijalla. - Validoikaa, ajakaa portit ja antakaa käyttöönoton synkronoida taidot rekisteriin
compileRegistry:n kautta. Rekisterin SQL:ää ei koskaan kirjoiteta käsin.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testvalidate soveltaa rekisterisynkronoinnin omia sääntöjä ennen kuin mitään synkronoidaan, ja kukin hylätään vastaanottajan koodilla. Polku, jossa on skeema, // tai kenoviiva, hylätään eri alkuperää olevana. Puuttuva tavuraja on ENDPOINT_BYTE_CAP_REQUIRED, toisen tason kenttä on FIELD_NOT_FOR_TIER ja sallitun alueen ulkopuolinen aikakatkaisu on TIMEOUT_OUT_OF_BOUNDS. Sitten nexus-gates tarkistaa, että /internal-reitillä on palveluvartija ja että se on määritelty internal tai service-key. Tämä porttipari on todiste.
Synkronointi on deklaratiivinen. Lähettäkää koko taitojoukko joka kerta, koska pois jätetty taito poistetaan käytöstä, ja antakaa käyttöönottovaiheen epäonnistua mistä tahansa muusta tilasta kuin 200. Enterprise-versiossa laajennuksen synkronointi tarkistetaan kokonaisuutena: jos yksi taito rikkoo sääntöä, mitään kyseisestä synkronoinnista ei oteta vastaan (PLUGIN_SYNC_ALL_OR_NOTHING) ja edellinen versio jatkaa toimintaansa. Community-luottamustason laajennus ei voi käyttää malliin ulottuvia tasoja tool_using ja llm_only; ne edellyttävät luottamustasoa core tai verified.
3. Olemassa olevan paketin laajentaminen
Tavoitteena on uusi toimiala tai alatoimiala, joka käyttää uudelleen suurimman osan olemassa olevasta paketista, esimerkiksi luotonanto ja korttiriidat Insurance-paketin rakenteen päällä. Rakennuspalikka on pack.json, joka nimeää emopakettinsa kentässä inherits ja lisää vain omat linssiklusterinsa ja sanansa.
- Aloittakaa paketti toimialapaketin kultaisella polulla ja asettakaa sitten
inheritsemopaketin tunnisteeksi. - Lisätkää omat
lens-klusterinne, kukin istuimineen, tarkoituksineen ja sanastoviitteineen. - Lisätkää sananne sanastoon, kullekin selkokielinen selite. Merkitkää termi
exact, kun se on näytettävä kirjoitetussa muodossa. - Käyttäkää jaettuja linssejä uudelleen omien piirtämisen sijaan: useiden pakettien tarvitsema sääntely, kuten ulkoistetun teknologian rekisteri, on yksi jaettu linssi.
- Tarkistakaa lisenssiketju. Pakettinne perii emopakettinsa lisäosavaatimukset.
- Esikatselkaa jokainen linssi henkilönä synteettisessä haarassa.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Todisteena on pilottiportin käytäntötarkistus, joka varmistaa, että kukin linssi vain kaventaa pohjaansa ja pitää henkilötietokentät oletuksena piilossa. Linssi, joka yrittää näyttää pohjansa piilottamaa tietoa, hylätään koodilla LENS_CANNOT_WIDEN. Lisensoinnin puolella konsoli kieltäytyy myöntämästä lisenssiä pakettiinne ilman emopaketin tarvitsemia lisäosia; Insurance-paketti tarvitsee päätöshuoneet ja sinetöidyt tietueet.
Toimialapaketit kuuluvat Enterprise-versioon, ja ne lisensoidaan pakettikohtaisesti. Paketin puhelinnäkymät edellyttävät lisäksi Mobile apps -lisäosaa. Lapsipaketti ei voi muuttaa kuorta, komponentteja eikä kirjoitussääntöjä.
4. Uusi paketti alusta alkaen
Tavoitteena on yhden toimialan näkymä Nexukseen: sen tietomalli, kunkin roolin linssit, sen sääntöjen vaatima näyttö ja laajennus, joka pitää sen tiedot ajan tasalla. Luku 2.24, Mukautetun vertikaalin rakentaminen alusta loppuun, käy tämän rakennuksen läpi kokonaisuudessaan; tässä on lyhyt versio.
- Ajakaa toimialapaketin kultainen polku ja kuvatkaa paketti: tarkoitus, yksiköt, pohjamalli ja säännöt, joihin se kohdistuu.
- Rakentakaa tietomalli pohjamallin päälle ja luokitelkaa jokainen ominaisuus sitä lisätessänne.
- Lukekaa suunnitelma, vahvistakaa sen sormenjälki pääsyavaimellanne ja luokaa.
- Muotoilkaa linssit Lens builderissa siten, että kukin kaventaa pohjalinssiä.
- Kirjoittakaa laajennus ja paketin tarvitsemat Skills Engine -taidot.
- Luokaa siemennettyä synteettistä dataa niillä poikkeustapauksilla, joista välitätte, ja esikatselkaa kukin linssi henkilönä.
- Ylentäkää kehitystilasta stagingiin, pilottiyksikköön ja sitten kaikkiin yksiköihin.
Todisteena ovat ylennysportit: kaikki testit läpi synteettisissä haaroissa ennen stagingia, sitten kaksi katselmoijaa, jotka eivät ole tekijä, ja sitten 14 päivää pilotissa virheiden ollessa alle 1/1 000. Mitään vaihetta ei voi ohittaa (GATE_CANNOT_BE_SKIPPED). Paketit kuuluvat Enterprise-versioon. Community-versiossa toimialapaketin kultaista polkua ei tarjota.
5. Dataliitin
Tavoitteena on, että ulkoisen järjestelmän tiedot virtaavat laajennuksenne omiin tauluihin aikataulun mukaan, esimerkiksi porttitapahtumat terminaalin käyttöjärjestelmästä. Rakennuspalikat ovat plugin_queue-taito, jononne noutava worker, kohdetaulun migraatio ja manifestissa määritelty lähtevä osoite.
- Määritelkää
plugin_queue-taito, jonkaqueueNamekirjoitetaan muodossa<plugin name>.<name>. Kaksoispiste ei ole sallittu, ja nimen on oltava manifestissa, koska orkestroija lisää tehtäviä suoraan sen jonoon. - Kirjoittakaa worker, joka noutaa jonon ja kutsuu ulkoista järjestelmää.
- Määritelkää ulkoisen järjestelmän osoite lähteväksi osoitteeksi. Kaikki luettelon ulkopuolinen estetään.
- Tallentakaa saapuva tieto omaan skeemaanne siten, että jokaisella rivillä on
organization_id,owner_user_idjabusiness_unit_id. - Lukekaa ulkoisen järjestelmän tunnistetieto nimellä ympäristöstä ja luetelkaa muuttuja kohdassa
scripts/ci/required-env. - Välittäkää noudot UNO-työnkulkumoottorin kautta, ei koskaan ajastimella, joka kutsuu moottoreita suoraan.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only no-credentials --only no-direct-compute --only migrations-are-scoped
node scripts/ci/required-envvalidate tarkistaa jonon nimen ja aikakatkaisun rekisterisynkronoinnin sääntöjä vasten. Kolme porttia todistavat, ettei mallin tunnistetietoa ole, ettei suoraa laskentaa ole ja että taulu on rajattu asianmukaisesti. Ajakaa täysi nexus-gates ennen pushia, koska --only rajaa ajoa ja kertoo sen yhteenvedossaan. Ajon aikana kutsu osoitteeseen, jota manifesti ei määritellyt, pysäytetään reunalla koodilla EGRESS_NOT_DECLARED.
Alustan omat liittimet asemiin, wikeihin, sähköpostivarastoihin ja vanhoihin järjestelmiin muutosten kaappauksineen ja jäljitettävyyksineen sisältyvät Data connectors -lisäosaan. Itse rakentamanne liitin on laajennus ja toimii missä tahansa versiossa. Lähtevän osoitteen lisääminen myöhemmässä julkaisussa on laajennus oikeuksiin, ja se pidätetään, kunnes kaksi katselmoijaa hyväksyy sen.
6. MCP-työkalu
Tavoitteena on työkalu, jota Claude Code, agentit ja muut MCP (Model Context Protocol) -asiakkaat voivat kutsua, esimerkiksi aluksen tarkastushistorian hakeminen. Rakennuspalikka on merkintä manifestin mcpTools[]-osiossa, jossa on name, description ja inputSchema.
- Nimetkää työkalu ja kuvatkaa se selkeästi. Kuvaus on se, minkä malli lukee päättäessään, kutsuuko se työkalua.
- Kirjoittakaa
inputSchemayhtenä objektiskeemana. Älkää sijoittakooneOf,allOftaianyOfsen ylätasolle. - Pitäkää työkalua palveleva reitti scope-vartijan takana kuten kaikki muutkin
/api-reitit, jotta vuokralaisuus määräytyy kutsujan tunnuksesta. - Validoikaa manifesti.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonTodisteena on validate: ylätason kombinaattori hylätään jo laadintavaiheessa, koska ajon aikana se saisi työkalun epäonnistumaan jokaisessa sen tuovassa MCP-aliagentissa, ja työkalu olisi olemassa ilman, että kukaan voisi kutsua sitä.
Enterprise-versiossa jokainen IDE:n (integroitu kehitysympäristö) kutsuttavissa oleva työkalu on lueteltu Workbench-työkaluluettelossa tasoineen, tietoineen siitä, muuttaako se asioita, kiinnitettyine sormenjälkineen ja sitä käyttämään oikeutettuine rooleineen. Jos työkalunne kuvaus muuttuu uudessa julkaisussa, luettelo pidättää työkalun, kunnes henkilö katselmoi muutoksen. Tämä on tarkoituksellista: muuttunut kuvaus on keino, jolla työkalu voi alkaa pyytää mallilta jotain, mitä sen ei pitäisi. Kutsu mihin tahansa kutsujan kulkuluvan ulkopuolelle hylätään koodilla CONNECTION_SCOPE_EXCEEDED.
7. White-label-kauppapaikka
Tavoitteena on sovellus, jota asiakkaanne omat asiakkaat käyttävät asiakkaan verkkotunnuksessa ja tämän brändillä ilman jälkeäkään Adverantista. Rakennuspalikat ovat manifestin domains- ja branding-lohkot, SDK:n kirjautumisapurit ja asiakkaan Storefront / white-label -lisäosa.
- Asettakaa asiakkaan verkkotunnus kohtaan
domains[]muodossaprimarymahdollisinealiases-arvoineen. - Täyttäkää
branding:appName,tagline,primaryColor,accentColor, verkkotunnusta vastaavapasskeyRpIdsekäoauthClientRef. - Kirjatkaa ihmiset sisään SDK:n kirjautumisapureilla ja määritelkää niiden kaksi julkista reittiä täsmälleen käyttäen
auth: "public"jaallowAnonymous: true. - Ohjatkaa jokainen frontend-kutsu backend for frontend -sallittujen luettelon välityspalvelimen kautta. Älkää koskaan sijoittako palvelun osoitetta asiakasohjelmaan.
- Jättäkää maksut asiakkaan ylläpitäjälle, joka yhdistää maksuyhdyskäytävät ja määrittää brändätyn kassan.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractTodisteena on scope-adherence. Se hyväksyy suojaamattoman /api-reitin vain, kun manifesti määrittelee juuri kyseisen metodin ja polun julkiseksi ja polku on yksi kirjautumisreiteistä; mikä tahansa muu julkinen määrittely epäonnistuu ja nimeää kaksi sallittua polkua. api-contract vertaa sitten määriteltyjä reittejä todellisiin molempiin suuntiin. definePlugin hylkää myös frontend.basePath:n, joka ei ole suhteellinen saman alkuperän polku.
White-label on Enterprisen Storefront / white-label -lisäosa, joka lisensoi myös maksut. Korttitiedot eivät koskaan kulje Nexuksen kautta. Asiakkaan pääkäyttäjä omistaa brändin, ja alusta määrittää sen organisaation perusteella eikä teidän koodistanne.
8. Edge-tehtäväpaketti
Tavoitteena on uusi tai päivitetty tehtävä satelliitille tai droonille, jossa on käytössä Nexus Edge, esimerkiksi aluksentunnistussovittimen lisääminen merivalvontatehtävään. Rakennuspalikkana on tehtäväpaketti, joka rakennetaan ja allekirjoitetaan maassa.
- Aloittakaa nykyisestä paketista Rakenna tehtäväpaketti -sivulla, joka luonnostelee uuden version vanhasta ja merkitsee jokaisen muutoksen.
- Muuttakaa vain sitä, mitä tehtävä edellyttää. Pitäkää suuret osat, kielimalli ja ontologia, vakaina aina kun mahdollista.
- Tarkistakaa sijoittelutaulukko jokaisessa heikennetyssä vaiheessa, jotta jokainen piirilevy riittää edelleen sille, mitä se suorittaa.
- Suorittakaa paketin aluksella ajettavat testitapaukset testipenkissä, jossa on samat piirilevyt.
- Lähettäkää se allekirjoitettavaksi: tarvitaan kaksi kolmesta allekirjoituksesta.
- Julkaiskaa se yhdelle alustalle. Se asennetaan joutilaaseen paikkaan ja otetaan käyttöön vasta, kun sen testitapaukset läpäistään aluksella.
- Ottakaa se käyttöön seuraavalla alustalla viikon virheettömän toiminnan jälkeen.
Tässä ohjeessa ei ole komentoja; se tehdään konsolin Nexus Edge -sivuilla. Todisteena ovat aluksella ajettavat testitapaukset, joiden kaikkien on läpäistävä ennen paketin käyttöönottoa, sekä kaksi allekirjoitusta. Jos testi epäonnistuu aluksella, alusta pysyy edellisessä paketissaan ja virhe ladataan alas seuraavalla ylilennolla. Paketin asentaminen laitteistoon, jota varten sitä ei ole tarkistettu, hylätään virheellä PACK_NOT_CHECKED_FOR_HARDWARE.
Nexus Edge on lisäosa, joka lisensoidaan alustakohtaisesti tai laivastokohtaisesti. Paketit pysyvät voimassa, vaikka alustaan ei olisi yhteyttä. Nousevan siirtoyhteyden kaista on kapea, joten suunnitelkaa koot sen mukaan: versiomme 1.5 oli 412 MB, kun taas uuden kielimallin sisältävä paketti oli 9.8 GB.
9. Ilmaeristetty toimitus asiakkaalle
Tavoitteena on, että laajennuksenne tai pakettinne asennetaan asiakkaan toimipaikkaan, jossa ei ole verkkoyhteyttä. Rakennuspalikoina ovat @adverant/nexus-sovereign:n sinetöity paketti, julkaisujen allekirjoitusavaimenne ja asiakkaan omat julkaisukanavat.
- Rakentakaa laajennus ja sen kuvat täsmälleen kuten verkkoon yhdistetylle asiakkaalle, kaikki tarkistukset vihreinä.
- Luokaa sinetöity paketti
airgap-profiililla, ja sisällyttäkää siihen kuvat, migraatiot, valmiiksi allekirjoitetut taidot sekä SBOM (ohjelmiston osaluettelo) lisensseineen. - Allekirjoittakaa se Ed25519-julkaisuavaimellanne.
- Varmentakaa se itse puhtaalla koneella.
- Lähettäkää paketti tallennusvälineellä, ja lähettäkää julkinen avaimenne ja paketin SHA-256 erillistä reittiä.
- Asiakkaan operaattori varmentaa paketin avaimellanne ja tuo julkaisun sitten sisään omien julkaisukanaviensa kautta.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapnexus-airgap bundle rakentaa paketin pakettimäärityksestänne. Todisteena on nexus-airgap verify asiakkaan puolella. Se laskee jokaisen tiedoston tiivisteen uudelleen, hylkää kaikki tiedostot, joita manifesti ei luettele, edellyttää luotettua allekirjoittajaa ja hylkää paketin, jonka verkon sallittujen luettelo ei ole tyhjä. Muutettu tiedosto epäonnistuu virheellä BUNDLE_INTEGRITY_VIOLATION. Kenenkään ei pidä koskaan poistaa tiukkaa tarkistusta käytöstä päästäkseen sen ohi.
Ilmaeristetyt asennukset kuuluvat Enterpriseen. Mikään paketissa ei saa noutaa mitään asennuksen aikana, ja laajennuksen tarvitsema malli tulee asiakkaan omalta mallipalvelimelta tekoälyn (AI, artificial intelligence) Provider Routerin kautta.
10. Vain Enterprise-versioon tarkoitettu moduuli
Tavoitteena on suljettu, lisensoitu ominaisuus, joka liitetään avoimeen ytimeen, esimerkiksi pitkän säilytysajan kirjausketju, jota myydään vain Enterprise-asiakkaille. Rakennuspalikkana on rajapintapaketti @adverant/nexus-spi, eikä mitään muuta Communitystä.
- Pitäkää repositoriossanne tavutarkasti kiinnitetty kopio rakennetusta rajapintapaketista paikallisena
file:-pakettinaSHA256SUMS-kiinnityksineen. - Kirjoittakaa sitä vasten
RouteModule(tai konsolinäkymiä vartenScreenModule) sekä ominaisuusryhmä, jota se palvelee. - Ajakaa jokainen reitti
ctx.requireScope:n takana ja tarkistakaa moduulin oma oikeus ennen vastaamista. - Hylätkää pyyntö virheellä
LICENCE_LOCKED, kun organisaatiolla ei ole oikeutta, ja näyttäkää ominaisuuden esittely, ei koskaan sen tietoja. - Pitäkää repositorio lisenssirajan mukaisena ja rakentakaa sitten kunkin version koottu puu.
npm ci
npm test
npm run buildTodisteena on lisenssirajan sääntö: ei tuontia Community-alueelta rajapintapakettia lukuun ottamatta, ei suhteellista tuontia repositorion ulkopuolelta eikä file:-, link:- tai workspace:-riippuvuutta sen ulkopuolella. Lisäksi yllä olevien kolmen komennon on läpäistävä jokaisessa kootussa versiopuussa, ei vain työpuussanne. Luvussa 2.25, Rakentaminen kullekin versiolle, on moduulin runko.
Moduuli latautuu Community-palveluun käynnistyksen yhteydessä niissä asennuksissa, joiden lisenssi sisältää sen ominaisuusryhmän. Ilman tätä oikeutta se kieltäytyy, joten sama koontiversio toimitetaan kaikkialle eikä tee mitään siellä, missä sitä ei ole lisensoitu.
11. Avoimen ytimen haarauttaminen tai laajentaminen
Tavoitteena on muutos itse Communityyn, joka säilytetään haarassanne tai palautetaan projektiin. Rakennuspalikkana on Community-lähdekoodi, joka on lisensoitu Apache License, Version 2.0 -lisenssillä.
- Haarauttakaa repositorio ja luokaa haara
main:stä. - Suosikaa laajennusta tai taitoa, jos haluamanne voidaan toteuttaa sellaisena. Ytimeen tehty muutos on teidän ylläpidettävänne jokaisessa julkaisussa.
- Tehkää muutos testien kanssa, jotka epäonnistuvat ilman sitä.
- Ajakaa projektin käyttämät tarkistukset ennen kuin ehdotatte mitään.
- Säilyttäkää NOTICE-tiedosto, älkääkä käyttäkö Adverantin nimiä tai tavaramerkkejä muuten kuin kertoaksenne, mistä työ on peräisin.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckTodisteena on, että nämä kolme tarkistusta läpäistään, sekä näyttö siitä, että jokainen uusi testi epäonnistui ennen muutostanne. Pitäkää haarassanne voimassa yksi avoimen ytimen ominaisuus: Community suorittaa agentin alusta loppuun paikallisella mallilla ilman avainta ja ilman verkkoa. Muutos, joka rikkoo tämän, rikkoo sen, mikä tekee Communitystä käyttökelpoisen sellaisenaan.
Tämä koskee vain Communitya. Kaikki, minkä on pysyttävä suljettuna, kuuluu sen sijaan Enterprise-moduuliin (skenaario 10), jotta lisenssiraja pysyy paikassa, johon kuka tahansa voi osoittaa.
12. Team-version pilvisovellus
Tavoitteena on sovellus, jonka Team-asiakkaat voivat asentaa. Team toimii vain Adverant-pilvessä, joten sovellus tavoittaa heidät vain luettelon kautta. Rakennuspalikoina ovat laajennus ja julkaisijaklusteri: oma virtuaaliklusterinne Adverant-pilvessä esimerkkiaineistoineen.
- Rakentakaa ja testatkaa julkaisijaklusterissa käyttäen vain esimerkkiaineistoa.
- Ilmoittakaa sovelluksen manifestissa kaikki, mitä se tarvitsee, eikä mitään muuta.
- Julkaiskaa se allekirjoitettuna Adverantin tarkastettavaksi ja luetteloon listattavaksi.
- Kukin asiakas asentaa sen ja myöntää jokaisen ilmoitetun käyttöalueen yksikkö kerrallaan.
Todiste muodostuu kahdesta osasta. Allekirjoitettu ja tarkastettu julkaisu vie teidät luetteloon. Sen jälkeen asiakkaan myöntämät oikeudet ratkaisevat, mihin sovellus pääsee käsiksi asiakkaan ympäristössä, ja jokainen kutsu, jota sovellus ei ole ilmoittanut, hylätään virheellä CONNECTION_SCOPE_EXCEEDED. Puuttuvan käyttöalueen voi lisätä vain uudessa julkaisussa, jonka asiakas tarkastaa.
Julkaisijaklusterista ei ole reittiä yhdenkään asiakkaan luo, ja asiakkaan tietojen pyytäminen siellä hylätään virheellä TENANT_BOUNDARY. Asiakkaat voivat jakaa testitulokset kanssanne, mutta eivät koskaan tietojaan. Team sisältää työnkulkujen hallintaominaisuuden, joten jos sovelluksenne sisältää työnkulkuja, Team-asiakkaat voivat itse siirtää niitä ympäristöjen välillä.
13. Olemassa olevan sisäisen sovelluksen paketointi liitännäiseksi
Tavoitteena on yrityksenne jo käyttämä sovellus, joka tuodaan Nexukseen niin, että se perii kirjautumisen, eristyksen ja hallinnan. Rakennuspalikoina ovat /plugin-create-taito ensimmäistä luonnosta varten sekä SDK:n manifestityökalut ja tarkistukset sen viimeistelyyn.
- Ajakaa
/plugin-createrepositoriota vasten. Se analysoi koodin ja valitsee käärintästrategian ja luo sitten taustajärjestelmän, migraatiot, käyttöliittymän (UI), manifestin ja testit. - Nostakaa manifesti v2-sopimuksen tasolle.
migratelisää kolme lakilausetta ja siirtäädomain:n kohtaandomains[], ja se kieltäytyy keksimästä aloituspistettä. - Korvatkaa kaikki vuokralaisarvot, jotka kääre lukee otsakkeista, SDK:n käyttöaluesuojalla.
- Lisätkää
organization_id,owner_user_idjabusiness_unit_idjokaiseen tauluun, ja käyttäkää perusavaimia, jotka alkavat vuokralaisella. - Ilmoittakaa jokainen reitti oikeuksineen ja asentakaa hylkäyskirjanpito.
- Ajakaa tarkistuksia, kunnes ne ovat vihreinä.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin migrate nexus.manifest.json --write
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testTodisteena on, että nexus-gates päättyy koodilla 0 ja scope-adherence, one-fence, migrations-are-scoped, crud-adherence ja api-contract läpäistään kaikki. Odottakaa ensimmäisen ajon epäonnistuvan useimmissa niistä; meidän ajomme raportoi jokaisen reitin rajaamattomaksi, koska luonnos luotti otsakkeisiin, jotka selain pystyi asettamaan. Tarkistuksissa ei tarkoituksella ole korjausvalitsinta.
Käärityt sovellukset toimivat kaikissa versioissa. Käyttöönotto tapahtuu vain asennuksen julkaisukanavien kautta, joten jättäkää huomiotta kaikki luonnoksen kirjoittamat käyttöönottotiedostot. Aika kuluu eristystyöhön: varautukaa todellisen sovelluksen kohdalla päiviin, ei tunteihin.


