Sínigh isteachCuir cruinniú eolais in áirithe

Caibidil 2.27

Cásanna tógála

Leabhar cócaireachta de thrí thógáil déag, ó scil aonair go seachadadh aerbhearnaithe. Tugann gach oideas an sprioc, na bloic thógála, na céimeanna agus na horduithe, an geata a chruthaíonn gur oibrigh sé, agus an méid a athraíonn de réir eagráin agus foirm sheachadta.

d'aistrigh AI an leathanach seo ón mbunleagan Béarla. Má tá aon rud doiléir, is é an leathanach Béarla an tagairt. Léigh an leathanach seo i mBéarla

25 nóiméad le léamh

Seo iad na hoidis a úsáidim nuair a deir duine éigin in Corrán Orbital, nó ag custaiméir, "ba mhaith linn go ndéanfadh Nexus X". Tá gach ceann acu gearr d'aon ghnó. Tá an réasúnaíocht atá taobh thiar de na céimeanna sna caibidlí roimh an gceann seo: caibidil 2.20, Scileanna, agus caibidil 2.21, The Plugin SDK, a phléann leis an bhfoireann forbartha bogearraí, ansin caibidil 2.23, Pacáistí fearainn, agus na trí chaibidil ina diaidh faoi thógáil. Anseo gheobhaidh tú an sprioc, na bloic thógála atá le húsáid, na céimeanna, na horduithe, an geata a léiríonn gur éirigh leis, agus na nótaí faoin eagrán agus faoin seachadadh.

Is é an geata an rud is tábhachtaí. Bíonn oideas críochnaithe nuair a bhíonn a gheata glas. Is rud é gach geata sa chaibidil seo is féidir leat a rith nó a ritheann an t-ardán duit, agus scoireann gach ceann acu le luach nach náid é nó diúltaíonn sé le cód nuair nach gcomhlíontar é.

Cás Príomhbhloc tógála An geata a chruthaíonn é Eagrán
Scil nua de chuid Skills Engine Pacáiste SKILL.md skill:validate gan aon earráid Community agus Enterprise
Scil léiriúcháin le host_callback Léiriúchán breiseáin skills[] create-nexus-plugin validate agus nexus-gates Community agus Enterprise
Pacáiste atá ann cheana a leathnú pack.json le inherits Seiceáil polasaí lionsa ag an ngeata píolótach Enterprise agus ceadúnas pacáiste
Pacáiste nua ón tús Cosán órga na bpacáistí fearainn Geataí stáitsithe agus píolótacha Enterprise
Nascóir sonraí Scil plugin_queue validate, nexus-gates, diúltú do thrácht amach Community agus Enterprise
Uirlis MCP (Model Context Protocol) mcpTools[] an léiriúcháin validate (gan aon chomhcheanglóirí ag an mbarrleibhéal) Community agus Enterprise
Siopa ar líne lipéid bháin domains agus branding an léiriúcháin Riail phoiblí scope-adherence Enterprise agus an breiseán Storefront
Pacáiste misin Edge Pacáiste misin Cásanna tástála ar bord, dhá cheann de thrí shíniú Enterprise agus an breiseán Nexus Edge
Seachadadh le bearna aeir Beart séalaithe nexus-airgap verify Enterprise
Modúl do Enterprise amháin @adverant/nexus-spi Geata na líne ceadúnais, tógálacha eagráin Enterprise
An croí oscailte a fhorcáil nó a leathnú Foinse Community Tástálacha, lint agus seiceáil cineálacha Community
Aip néil an eagráin Team Braisle foilsitheora Eisiúint shínithe, athbhreithniú, deonú don chustaiméir Team
Aip inmheánach atá ann cheana a fhilleadh /plugin-create migrate, validate, nexus-gates Community agus Enterprise
Crann cinntí a léitear ó bharr go bun. Fiafraíonn an chéad diamant "An gá cód a bheith ag rith an t-am ar fad?". Tugann "Ní gá" chuig diamant "An treoracha do chúntóir atá ann?", a gcríochnaíonn a "Is ea" ag "Scil Skills Engine" agus a gcríochnaíonn a "Ní hea" ag "Lionsa ar phacáiste atá ann cheana". Tugann "Is gá" chuig diamant "An amharc tionscail amháin ar an ardán atá ann?", a gcríochnaíonn a "Is ea" ag "Pacáiste fearainn (lena bhreiseán)" agus a dtugann a "Ní hea" chuig diamant deiridh "An gcaithfidh sé fanacht dúnta agus ceadúnaithe?", ag críochnú ag "Modúl Enterprise" do "Caithfidh" agus "Breiseán" do "Ní chaithfidh".
Cén bloc tógála ar cheart tosú uaidh.

1. Scil nua Skills Engine

Is é an sprioc píosa treorach in-athúsáidte is féidir leis an gcúntóir, le gníomhairí, le sreafaí oibre agus le huirlisí forbróra go léir a rith, mar shampla comhdú custaim a sheiceáil i gcoinne a rialacha. Is iad do bhloic thógála pacáiste SKILL.md i bhfillteán atá ainmnithe as an scil, skill.yaml roghnach le haghaidh truicear agus clibeanna, agus fillteán roghnach scripts/ atá cuachta leis.

  1. Cruthaigh skills/<slug>/ agus scríobh SKILL.md le réamhábhar: name (kebab-case, cothrom le hainm an fhillteáin), description (suas le 500 carachtar), allowed-tools, agus go roghnach triggers, capabilities agus version.
  2. Scríobh an corp don mhúnla: cathain is ceart an scil a úsáid, a céimeanna, samplaí, agus an rud nach mór di gan é a dhéanamh choíche.
  3. Cuir cásanna tástála leis. Cuir ceann isteach ina bhfuil treoir curtha san ionchur nach mór don scil gan í a leanúint.
  4. Bailíochtaigh, féach ar an bplean uaslódála, ansin uaslódáil.
  5. Foilsigh. Coinnítear scil a chuireann uirlis scríbhneoireachta leis go dtí go gceadaíonn beirt ainmnithe í le heochracha pasála, agus ní féidir leis an moltóir a athrú féin a cheadú.
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-filing

Is é skill:validate an geata, agus ní mór dó nialas earráidí a thuairisciú sular féidir aon rud a fhoilsiú. Is iad na hearráidí blocála ainm nó cur síos ar iarraidh agus slug nó cineál poist dúblach. Má uaslódáiltear ábhar atá foilsithe cheana, filltear an leagan atá ann (CONTENT_HASH_ALREADY_PUBLISHED), mar sin is sábháilte an uaslódáil a athdhéanamh.

Faigheann Community an cruthaitheoir iomlán, an leabharlann, leaganacha, aistriú siar, iompórtáil agus tástálacha. Ar Enterprise, téann an foilsiú trí scáth agus canárach freisin: ritheann an leagan ceadaithe i scáth, ansin d'aonad amháin taobh thiar de gheataí ainmnithe, ansin do chách, agus stopann sé é féin mura gcomhlíontar geata. Do chustaiméir le bearna aeir, taistealaíonn scileanna réamhshínithe taobh istigh den bheart séalaithe (cás 9).

2. Scil forógra le host_callback

Is é an sprioc ríomh cinntitheach i do bhreiseán féin is féidir leis an ardán a sheoladh, mar shampla taifead eachtra a oscailt ó léamh. Úsáidfidh tú ró in skills[] an léiriúcháin leis an tsraith host_callback, agus bealach /internal i do chúlchóras atá cosanta ag garda seirbhíse an SDK.

  1. Fógair an scil: id i lower_snake, tier: "host_callback", classification ag uasteorainn iontaoibhe do bhreiseáin nó faoina bun, inputSchema, outputSchema agus timeoutMs idir 1 soicind agus 6 uair an chloig.
  2. Líon hostCallback: ainm do Service féin, a phort, cosán coibhneasta mar /internal/skills/excursion_open, an dá uasteorainn beart (maxRequestBytes agus maxResponseBytes), agus tenantHeader: "X-Organization-ID".
  3. Fógair an bealach in api.endpoints[] le auth: "service-key" nó auth: "internal", agus cosain é le requireService nó serviceMiddleware, agus ná húsáid garda raon an úsáideora choíche.
  4. Bailíochtaigh, rith na geataí, agus lig don ionduchtú na scileanna a shioncronú leis an gclárlann trí compileRegistry. Ní scríobhann tú SQL na clárlainne de láimh choíche.
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-test

Cuireann validate rialacha shioncronú na clárlainne féin i bhfeidhm sula ndéantar aon rud a shioncronú, agus diúltaítear do gach ceann le cód an ghlacadóra. Diúltaítear do chosán ina bhfuil scéim, // nó cúlslais mar thrasbhunús. Is é ENDPOINT_BYTE_CAP_REQUIRED uasteorainn beart ar iarraidh, is é FIELD_NOT_FOR_TIER réimse ó shraith eile, agus is é TIMEOUT_OUT_OF_BOUNDS teorainn ama lasmuigh den raon. Ansin seiceálann nexus-gates go bhfuil an garda seirbhíse ar an mbealach /internal agus go bhfuil sé fógartha internal nó service-key. Is é an péire geataí sin an cruthúnas.

Is sioncronú dearbhaithe é. Postáil an tacar iomlán scileanna gach uair, mar díchumasaítear scil a fhágann tú amach, agus cuir do chéim imscartha ar ceal ar aon stádas seachas 200. Ar Enterprise, seiceáiltear sioncronú breiseáin ina iomláine: má sháraíonn scil amháin riail, ní ghlactar le haon chuid den sioncronú sin (PLUGIN_SYNC_ALL_OR_NOTHING) agus leanann an leagan roimhe ar aghaidh ag rith. Ní féidir le breiseán le hiontaoibh pobail na sraitheanna a shroicheann múnla a úsáid, tool_using agus llm_only; teastaíonn iontaoibh core nó verified uathu sin.

Breiseáin agus sioncronú MCP
Breiseáin agus sioncronú MCP
Breiseáin a thugann scileanna leo, agus an rud ar seiceáladh gach sioncronú ina leith. Tabhair faoi deara an breiseán ar diúltaíodh dá shioncronú ina iomláine toisc gur úsáid ceann amháin dá chúig scil sraith nach féidir ach leis an ardán í a óstáil, agus lean a leagan roimhe ar aghaidh ag rith.

3. Pacáiste atá ann cheana a leathnú

Is é an sprioc tionscal nó fothionscal nua a athúsáideann an chuid is mó de phacáiste atá ann cheana, mar shampla iasachtú agus díospóidí cártaí bunaithe ar chruth an phacáiste Árachais. Is é an bloc tógála pack.json a ainmníonn a thuismitheoir in inherits agus nach gcuireann leis ach a bhraislí lionsa agus a fhocail féin.

  1. Tosaigh an pacáiste le cosán órga na bpacáistí fearainn, ansin socraigh inherits ar aitheantas an phacáiste thuismitheora.
  2. Cuir do bhraislí lens féin leis, gach ceann lena shuíocháin, a chuspóir agus a thagairt foclóra.
  3. Cuir d'fhocail leis an bhfoclóir le gluais shimplí do gach ceann. Marcáil téarma exact nuair nach mór é a thaispeáint mar atá sé scríofa.
  4. Athúsáid lionsaí comhroinnte seachas do chuid féin a tharraingt: is lionsa comhroinnte amháin é córas rialála a theastaíonn ó roinnt pacáistí, mar shampla clár de theicneolaíocht sheachfhoinsithe.
  5. Seiceáil an slabhra ceadúnais. Faigheann do phacáiste riachtanais bhreiseáin a thuismitheora le hoidhreacht.
  6. Réamhamharc ar gach lionsa mar dhuine ar bhrainse sintéiseach.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Is é an cruthúnas seiceáil pholasaí an gheata phíolótaigh, a dhearbhaíonn nach ndéanann gach lionsa ach a bhonn a chúngú agus go gcoinníonn sé réimsí pearsanta as de réir réamhshocraithe. Diúltaítear le LENS_CANNOT_WIDEN do lionsa a dhéanann iarracht an rud a cheileann a bhonn a thaispeáint. Ó thaobh an cheadúnaithe de, diúltaíonn an consól ceadúnas a eisiúint do do phacáiste gan na breiseáin a theastaíonn óna thuismitheoir; teastaíonn Seomraí cinnidh agus taifid shéalaithe ón bpacáiste Árachais.

Is de chuid Enterprise iad pacáistí fearainn agus ceadúnaítear iad in aghaidh an phacáiste. Teastaíonn an breiseán Aipeanna móibíleacha freisin ó scáileáin ghutháin pacáiste. Ní féidir le pacáiste linbh an bhlaosc, na comhpháirteanna ná na rialacha scríbhneoireachta a athrú.

4. Pacáiste nua ón tús

Is é an sprioc amharc tionscail amháin ar Nexus: a mhúnla eolais, na lionsaí do gach ról, an fhianaise a iarrann a rialacha, agus an breiseán a choinníonn a shonraí cothrom le dáta. Téann Caibidil 2.24, Ingearach saincheaptha a thógáil ó cheann ceann, tríd an tógáil seo go hiomlán; seo an leagan gearr.

  1. Rith cosán órga na bpacáistí fearainn agus déan cur síos ar an bpacáiste: cuspóir, aonaid, an bunmhúnla agus na rialacha a mhapálann sé.
  2. Tóg an múnla eolais ar bhunmhúnla agus aicmigh gach airí agus tú á chur leis.
  3. Léigh an plean, deimhnigh a mhéarlorg le d'eochair phasála, agus cruthaigh.
  4. Múnlaigh na lionsaí sa Tógálaí lionsaí, gach ceann ag cúngú bunlionsa.
  5. Scríobh an breiseán agus aon scileanna Skills Engine a theastaíonn ón bpacáiste.
  6. Gin sonraí sintéiseacha síolaithe leis na cásanna corra is cás leat, agus réamhamharc ar gach lionsa mar dhuine.
  7. Ardaigh ón spás forbartha go stáitsiú, go haonad píolótach, ansin go gach aonad.

Is é an cruthúnas na geataí ardaithe: gach tástáil ag éirí leo ar na brainsí sintéiseacha isteach sa stáitsiú, ansin beirt athbhreithneoirí nach iad an t-údar, ansin 14 lá sa phíolóta le hearráidí faoi 1 as 1,000. Ní féidir aon chéim a scipeáil (GATE_CANNOT_BE_SKIPPED). Is de chuid Enterprise iad pacáistí. Ar Community ní thairgtear cosán órga na bpacáistí fearainn.

5. Nascóir sonraí

Is é an sprioc sonraí ó chóras seachtrach a bheith ag sreabhadh isteach i dtáblaí do bhreiseáin féin de réir sceidil, mar shampla imeachtaí geata ó chóras oibriúcháin teirminéil. Is iad na bloic thógála scil plugin_queue, oibrí a tharraingíonn do scuaine, imirce don sprioctábla, agus seoladh amach atá fógartha sa léiriúchán.

  1. Fógair scil plugin_queue le queueName litrithe <plugin name>.<name>. Ní cheadaítear idirstad, agus caithfidh an t-ainm a bheith sa léiriúchán, mar cuireann an t-ceolfhoirneoir isteach sa scuaine sin go díreach.
  2. Scríobh an t-oibrí a tharraingíonn an scuaine agus a ghlaonn ar an gcóras seachtrach.
  3. Fógair seoladh an chórais sheachtraigh mar sheoladh amach. Cuirtear bac ar aon rud nach bhfuil liostaithe.
  4. Stóráil a dtagann isteach i do scéimre féin, le organization_id, owner_user_id agus business_unit_id ar gach ró.
  5. Léigh dintiúr an chórais sheachtraigh de réir ainm ón timpeallacht, agus liostaigh an athróg in scripts/ci/required-env.
  6. Seol na tarraingtí trí UNO, an t-inneall sreafa oibre, agus ná húsáid amadóir a ghlaonn ar innill go díreach choíche.
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-env

Seiceálann validate ainm na scuaine agus an teorainn ama i gcoinne rialacha shioncronú na clárlainne. Cruthaíonn na trí gheata nach bhfuil aon dintiúr múnla ann, nach bhfuil aon ríomh díreach ann agus go bhfuil an tábla raonaithe i gceart. Rith nexus-gates iomlán sula ndéanann tú brú, mar cúngaíonn --only an rith agus deir sé amhlaidh ina achoimre. Ag am rite, stoptar glao ar sheoladh nár fhógair an léiriúchán ag an imeall le EGRESS_NOT_DECLARED.

Tagann nascóirí an ardáin féin le tiomántáin, vicithe, stórais phoist agus córais oidhreachta, le gabháil athruithe agus le líneáiste, leis an mbreiseán Nascóirí sonraí. Is breiseán é nascóir a thógann tú féin agus oibríonn sé ar aon eagrán. Is leathnú é seoladh amach a chur leis in eisiúint níos déanaí, agus coinnítear é go dtí go nglacann beirt athbhreithneoirí leis.

6. Uirlis MCP

Is é an sprioc uirlis ar féidir le Claude Code, le gníomhairí agus le cliaint eile MCP (Model Context Protocol) glaoch uirthi, mar shampla stair iniúchta árthaigh a chuardach. Is é an bloc tógála iontráil in mcpTools[] an léiriúcháin, le name, description agus inputSchema.

  1. Ainmnigh an uirlis agus déan cur síos simplí uirthi. Is é an cur síos an rud a léann múnla chun cinneadh a dhéanamh an nglaofaidh sé uirthi.
  2. Scríobh inputSchema mar scéimre réada amháin. Ná cuir oneOf, allOf ná anyOf ag a bharrleibhéal.
  3. Coinnigh an bealach a fhreastalaíonn ar an uirlis taobh thiar den gharda raoin, cosúil le gach bealach /api eile, ionas go dtagann an tionóntacht ó chomhartha an ghlaoiteora.
  4. Bailíochtaigh an léiriúchán.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Is é validate an cruthúnas: diúltaítear do chomhcheanglóir barrleibhéil ag am an údaraithe, mar ag am rite chuirfeadh sé an uirlis ar ceal do gach fo-ghníomhaire MCP a iompórtálann í, agus bheadh an uirlis ann gan aon duine in ann glaoch uirthi.

Ar Enterprise, liostaítear gach uirlis ar féidir le IDE (timpeallacht forbartha comhtháite) glaoch uirthi i gcatalóg uirlisí Workbench lena sraith, cé acu an athraíonn sí rudaí nó nach n-athraíonn, méarlorg greamaithe agus na róil a fhéadfaidh í a úsáid. Má athraíonn cur síos d'uirlise in eisiúint nua, coinníonn an chatalóg an uirlis go dtí go ndéanann duine athbhreithniú ar an athrú. Is d'aon ghnó é sin: is trí chur síos athraithe is féidir le huirlis tosú ag iarraidh ar mhúnla rud nár cheart di. Diúltaítear le CONNECTION_SCOPE_EXCEEDED do ghlao ar aon rud lasmuigh de phas an ghlaoiteora.

7. Aghaidh siopa lipéad bán

Is é an sprioc aip a úsáideann custaiméirí do chustaiméara féin, ar fhearann an chustaiméara agus ina bhranda, gan rian ar bith de Adverant. Is iad na bloic thógála bloic domains agus branding an léiriúcháin, cúntóirí síniú isteach an SDK, agus breiseán Storefront / lipéad bán an chustaiméara.

  1. Cuir fearann an chustaiméara in domains[] mar primary, le haon aliases.
  2. Líon branding: appName, tagline, primaryColor, accentColor, passkeyRpId cothrom leis an bhfearann, agus oauthClientRef.
  3. Sínigh daoine isteach trí chúntóirí síniú isteach an SDK, agus fógair a dhá bhealach phoiblí go beacht, le auth: "public" agus allowAnonymous: true.
  4. Seol gach glao tosaigh tríd an seachfhreastalaí liosta ceadaithe cúlchórais don tosach. Ná cuir seoladh seirbhíse sa chliant choíche.
  5. Fág íocaíochtaí faoi riarthóir an chustaiméara, a nascann geataí íocaíochta agus a shocraíonn an tseiceáil amach brandáilte.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Is é scope-adherence an cruthúnas. Ní ligeann sé isteach bealach /api gan gharda ach amháin nuair a fhógraíonn an léiriúchán an modh agus an cosán beacht sin mar phoiblí agus gur ceann de na bealaí síniú isteach é an cosán; teipeann ar aon fhógra poiblí eile agus ainmníonn sé an dá chosán cheadaithe. Ansin déanann api-contract difríocht idir na bealaí fógartha agus na bealaí fíora sa dá threo. Diúltaíonn definePlugin freisin do frontend.basePath nach cosán coibhneasta den bhunús céanna é.

Is é an breiseán Storefront / lipéad bán ar Enterprise atá i gceist le lipéad bán, agus ceadúnaíonn sé íocaíochtaí freisin. Ní théann sonraí cárta i dteagmháil le Nexus riamh. Is le riarthóir an chustaiméara an branda, agus aimsíonn an t-ardán é ón eagraíocht seachas ó do chód.

8. Pacáiste misin Edge

Is é an sprioc misean nua nó nuashonraithe do shatailít nó do dhrón a ritheann Nexus Edge, mar shampla cuibheoir aimsithe long a chur le misean faire muirí. Is é an bloc tógála pacáiste misin, a thógtar agus a shínítear ar an talamh.

  1. Tosaigh ón bpacáiste reatha ar an leathanach Pacáiste misin a thógáil, a dhréachtaíonn an leagan nua ón seanleagan agus a mharcálann gach athrú.
  2. Ná hathraigh ach a bhfuil de dhíth ar an misean. Coinnigh na codanna móra, an tsamhail teanga agus an t-ointeolaíocht, seasmhach nuair is féidir.
  3. Seiceáil an tábla socrúcháin ag gach céim laghdaithe, ionas go n-oireann gach clár fós don rud a ritheann sé.
  4. Rith cásanna tástála ar bord an phacáiste ar rig tástála leis na cláir chéanna.
  5. Seol é le síniú: tá dhá shíniú as trí ag teastáil.
  6. Eisigh é chuig ardán amháin. Téann sé isteach sa sliotán díomhaoin agus ní chuirtear ar siúl é ach amháin tar éis dá chásanna tástála pas a fháil ar bord.
  7. Leathnaigh amach chuig an gcéad ardán eile tar éis seachtain gan fadhb.
Pacáistí misin
Pacáistí misin
Leabharlann na bpacáistí misin, leis an méid a iompraíonn gach pacáiste agus na hardáin a ritheann é. Tabhair faoi deara an leagan níos sine a choinnítear ar bord le filleadh air, agus líon na gcásanna tástála a chaithfidh gach pacáiste a rith go rathúil ar a chrua-earraí.

Níl aon orduithe san oideas seo; déantar é i leathanaigh Nexus Edge an chonsóil. Is é an cruthúnas na cásanna tástála ar bord, a chaithfidh pas a fháil uile sula gcuirtear an pacáiste ar siúl, agus an dá shíniú. Má theipeann ar thástáil ar bord, fanann an t-ardán ar a phacáiste roimhe sin agus íoslódáiltear an teip ar an gcéad phas eile. Diúltaítear le PACK_NOT_CHECKED_FOR_HARDWARE pacáiste a shuiteáil ar chrua-earraí nár seiceáladh dó é.

Is breiseán é Nexus Edge, a cheadúnaítear in aghaidh an ardáin nó in aghaidh an chabhlaigh. Fanann pacáistí bailí fad atá ardán as teagmháil. Tá an nasc suas cúng, mar sin pleanáil méideanna dá réir: bhí ár n-eisiúint 1.5 412 MB, i gcomparáid le 9.8 GB do phacáiste le samhail teanga nua.

9. Seachadadh aerbhearnaithe chuig custaiméir

Is é an sprioc do bhreiseán nó do phacáiste a bheith suiteáilte ag láthair custaiméara gan aon líonra. Is iad na bloic tógála cuachta séalaithe ó @adverant/nexus-sovereign, d'eochair sínithe eisiúna, agus bealaí eisiúna an chustaiméara féin.

  1. Tóg an breiseán agus a íomhánna díreach mar a dhéanfá do chustaiméir ceangailte, agus gach geata glas.
  2. Déan cuachta séalaithe leis an bpróifíl airgap, ina bhfuil na híomhánna, na himirceanna, na scileanna réamhshínithe agus SBOM (bille ábhar bogearraí) leis na ceadúnais.
  3. Sínigh é le d'eochair eisiúna Ed25519.
  4. Fíoraigh é tú féin ar mheaisín glan.
  5. Seol an cuachta ar mheáin, agus seol d'eochair phoiblí agus SHA-256 an chuachta ar bhealach ar leith.
  6. Fíoraíonn oibreoir an chustaiméara an cuachta le d'eochair, agus ansin tugann sé an eisiúint isteach trína bhealaí eisiúna féin.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgap

Tógann nexus-airgap bundle an cuachta ó chumraíocht do chuachta. Is é an cruthúnas nexus-airgap verify ar thaobh an chustaiméara. Déanann sé gach comhad a haiseáil arís, diúltaíonn sé d'aon chomhad nach liostaíonn an léiriú, éilíonn sé sínitheoir iontaofa, agus diúltaíonn sé do chuachta nach bhfuil a liosta ceadaithe líonra folamh. Teipeann ar chomhad athraithe le BUNDLE_INTEGRITY_VIOLATION. Níor cheart d'aon duine an seiceáil dhian a mhúchadh riamh chun dul thairis.

Is le Enterprise suiteálacha scoite ón líonra. Ní cheadaítear d'aon rud sa chuachta aon rud a fháil le linn suiteála, agus tagann samhail a theastaíonn ón mbreiseán ó fhreastalaí samhlacha an chustaiméara féin tríd an AI (intleacht shaorga) Provider Router.

10. Modúl Enterprise amháin

Is é an sprioc cumas dúnta ceadúnaithe a cheanglaíonn leis an gcroí oscailte, mar shampla rian iniúchta le coinneáil fhada nach ndíoltar ach le custaiméirí Enterprise. Is é an bloc tógála an pacáiste comhéadain @adverant/nexus-spi, agus gan aon rud eile ó Community.

  1. Coinnigh cóip den phacáiste comhéadain tógtha, greamaithe ag leibhéal beart, i do stór mar phacáiste áitiúil file:, lena ghreamú SHA256SUMS.
  2. Scríobh RouteModule (nó ScreenModule do scáileáin chonsóil) ina choinne, leis an ngrúpa gné a bhfreastalaíonn sé air.
  3. Rith gach bealach taobh thiar de ctx.requireScope, agus seiceáil deontas an mhodúil féin sula bhfreagraíonn tú.
  4. Diúltaigh le LICENCE_LOCKED nuair nach bhfuil teideal ag an eagraíocht, agus taispeáin réamhbhlaiseadh na gné, ní a cuid sonraí riamh.
  5. Coinnigh an stór taobh istigh den líne ceadúnais, agus ansin tóg crann comhdhéanta gach eagráin.
npm ci
npm test
npm run build

Is é an cruthúnas riail na líne ceadúnais: gan aon iompórtáil ó raon Community ach amháin an pacáiste comhéadain, gan aon iompórtáil choibhneasta amach as an stór, agus gan aon spleáchas file:, link: ná workspace: lasmuigh de. Ansin caithfidh na trí ordú thuas pas a fháil i ngach crann eagráin comhdhéanta, ní i do chrann oibre amháin. Tá creatlach an mhodúil in Caibidil 2.25, Tógáil do gach eagrán.

Lódálann modúl isteach i seirbhís Community ag an tús, ar shuiteálacha a bhfuil a ghrúpa gné ar a gceadúnas. Gan an deontas sin diúltaíonn sé, mar sin seoltar an tógáil chéanna i ngach áit agus ní dhéanann sé faic san áit nach bhfuil sé ceadúnaithe.

11. An croí oscailte a fhorcáil nó a leathnú

Is é an sprioc athrú ar Community féin, a choinnítear i do ghabhlóg nó a chuirtear ar ais. Is é an bloc tógála foinse Community faoin Apache License, Version 2.0.

  1. Gabhlaigh an stór agus déan brainse ó main.
  2. Is fearr breiseán nó scil más féidir leis an rud atá uait a bheith ina cheann díobh. Is ortsa a bheidh athrú ar an gcroí a chothabháil ar gach eisiúint.
  3. Déan an t-athrú le tástálacha a theipeann gan é.
  4. Rith na seiceálacha a ritheann an tionscadal sula moltar aon rud.
  5. Coinnigh an comhad NOTICE, agus ná húsáid ainmneacha ná trádmharcanna Adverant thar a rá cárb as a dtáinig an obair.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Is é an cruthúnas na trí sheiceáil sin a bheith ag éirí, móide an fhianaise gur theip ar gach tástáil nua roimh d'athrú. Coinnigh airí amháin den chroí oscailte fíor i do ghabhlóg: ritheann Community gníomhaire ó cheann ceann ar shamhail áitiúil gan eochair agus gan líonra. Briseann athrú a bhriseann é sin an rud a fhágann Community inúsáidte ann féin.

Is le Community amháin é seo. Baineann aon rud nach mór a choinneáil dúnta le modúl Enterprise (cás 10) ina ionad, ionas go bhfanfaidh an líne ceadúnais in áit ar féidir le duine ar bith í a aithint.

12. Aip néil d'eagrán Team

Is é an sprioc aip ar féidir le custaiméirí Team a shuiteáil. Ní ritheann Team ach ar néal Adverant, mar sin ní shroicheann an aip iad ach tríd an gcatalóg. Is iad na bloic tógála breiseán agus braisle foilsitheora: do bhraisle fhíorúil féin ar néal Adverant le sonraí samplacha.

  1. Tóg agus tástáil ar an mbraisle foilsitheora, le sonraí samplacha amháin.
  2. Fógair gach rud a theastaíonn ón aip ina léiriú, agus faic níos mó.
  3. Eisigh é sínithe, le haghaidh athbhreithniú Adverant agus liostú sa chatalóg.
  4. Suiteálann gach custaiméir é, ag deonú gach raon fógartha aonad ar aonad.

Tagann an cruthúnas in dhá chuid. Cuireann an eisiúint shínithe athbhreithnithe isteach sa chatalóg thú. Ansin cinneann deontas an chustaiméara cad is féidir leis an aip a shroicheadh ag a láthair, agus diúltaítear le CONNECTION_SCOPE_EXCEEDED d'aon ghlao nár fhógair sí. Ní féidir leat raon atá in easnamh a chur leis ach in eisiúint nua a ndéanann an custaiméir athbhreithniú uirthi.

Suiteáil breiseán tríú páirtí
Suiteáil breiseán tríú páirtí
Riarthóir ag suiteáil breiseáin tríú páirtí, ag deonú gach raon fógartha in aghaidh an aonaid agus ag fágáil ceann amháin ar lár. Taispeánann an pláta glao nár fhógair an breiseán riamh, á dhiúltú.

Níl aon bhealach ag braisle foilsitheora chuig aon chustaiméir, agus diúltaítear le TENANT_BOUNDARY d'iarratas ar shonraí custaiméara ansin. Is féidir le custaiméirí torthaí tástála a roinnt leat, ach ní a gcuid sonraí riamh. Áirítear le Team an cumas oibríochtaí sreabha oibre, mar sin má sheolann d'aip sreabha oibre, is féidir le custaiméirí Team iad a chur chun cinn idir timpeallachtaí iad féin.

13. Aip inmheánach atá ann cheana a chuimsiú mar bhreiseán

Is é an sprioc aip a ritheann do chuideachta cheana féin, tugtha isteach in Nexus ionas go bhfaigheann sí síniú isteach, leithlisiú agus rialachas mar oidhreacht. Is iad na bloic tógála an scil /plugin-create don chéad dréacht, agus uirlisí léirithe agus geataí an SDK chun é a chríochnú.

  1. Rith /plugin-create leis an stór. Déanann sé anailís ar an gcód agus roghnaíonn sé straitéis fhillte, agus ansin gineann sé an t-inneall cúil, na himirceanna, an comhéadan úsáideora (UI), an léiriú agus na tástálacha.
  2. Ardaigh an léiriú go conradh v2. Cuireann migrate na trí abairt dlí leis agus bogann sé domain go domains[], agus diúltaíonn sé pointe iontrála a chumadh.
  3. Cuir garda raoin an SDK in ionad aon luach tionónta a léann an fillteán ó cheanntásca.
  4. Cuir organization_id, owner_user_id agus business_unit_id le gach tábla, le príomheochracha a thosaíonn leis an tionónta.
  5. Fógair gach bealach lena cheart, agus suiteáil mórleabhar na ndiúltuithe.
  6. Rith na geataí go mbeidh siad glas.
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-test

Is é an cruthúnas nexus-gates ag scor le 0, agus scope-adherence, one-fence, migrations-are-scoped, crud-adherence agus api-contract uile ag éirí. Bí ag súil go dteipfidh ar an gcéad rith ar fhormhór díobh; thuairiscigh ár gceann féin gach bealach mar bhealach gan raon, toisc go raibh muinín ag an dréacht as ceanntásca a d'fhéadfadh an brabhsálaí a shocrú. Níl aon lasc deisiúcháin ag na geataí, d'aon ghnó.

Oibríonn aipeanna fillte ar aon eagrán. Ní dhéantar imscaradh ach trí bhealaí eisiúna na suiteála, mar sin déan neamhaird d'aon chomhaid imscartha a scríobh an dréacht. Is ar an obair leithlisithe a chaitear an t-am: pleanáil ar laethanta d'aip fhíor, ní uaireanta.