Leagan 1.0.0-alpha.1is déanaí
Caibidil 2.17
Fabhtcheartú
Na fadhbanna is minice a bhuaileann le hoibreoirí, eagraithe de réir an méid a fheiceann tú. Tugann gach ceann acu an chúis, an t-ordú a dheimhníonn é agus an réiteach, agus críochnaíonn an chaibidil le beart tacaíochta a sheoladh.
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

Tarlaíonn an chuid is mó de na rudaí a théann amú ar shuiteáil Nexus sa dosaen bealach céanna, agus fógraíonn beagnach gach ceann acu iad féin le cód. Tá an chaibidil seo eagraithe de réir an méid a fheiceann tú, a bheag nó a mhór san ord ina dtiocfá ar gach fadhb: suiteáil, éileamh, ceadúnú, agus ansin rith. Do gach ceann acu, gheobhaidh tú an chúis, ordú a dheimhníonn í, agus an réiteach.
Úsáideann na samplaí suiteáil Harrow Port Authority: ainmspás nexus, eisiúint nexus, óstaigh console.harrow.example, api.harrow.example agus auth.harrow.example. Cuir do chuid féin ina n-áit. Sábhálann trí nós am le gach fadhb anseo:
- Léigh an cód roimh an teachtaireacht. Críochnaíonn gach diúltú in Nexus le cód meaisín, agus is de réir an chóid sin atá an chaibidil seo innéacsaithe.
- Rith
nexusctl preflightarís tar éis aon athraithe ar an mbraisle nó ar an gcomhad luachanna. Léann sé an bhraisle gan í a athrú, agus tuairiscíonn sé formhór na ndiúltuithe cairte faoi ainm sula ndéanann Helm é. - Úsáid
--explainar aon bhriatharnexusctlnach bhfuil tú cinnte faoi. Priontálann sé na hoibríochtaíkubectlagushelmgan iad a rith.
Crochann an tsuiteáil
Rith tú an tsuiteáil agus níl sí críochnaithe. Níl helm tar éis filleadh i ndiaidh cúig nóiméad déag, nó d'fhill sé agus tá podanna fós in Init nó in Pending, nó ní thugann seoladh an chonsóil freagra.
Is é helm install --wait an chúis is coitianta. Cruthaíonn Nexus a bhunachar sonraí, a róil agus scéimre gach seirbhíse i gcrúcaí iar-shuiteála, agus is é an crúca tosaithe a thugann a pasfhocal bunachair sonraí do gach seirbhís. Le --wait, fanann Helm go mbeidh na Deployments réidh sula ritheann sé na crúcaí sin, fad is a fhanann na Deployments leis na crúcaí. Ní bhogann ceachtar acu. Ná suiteáil le --wait riamh; suiteáil gan é agus fan ina dhiaidh sin.
Is gnáthchúiseanna Kubernetes iad na cúiseanna eile. Ní féidir íomhánna a tharraingt toisc go n-ainmníonn global.imageRegistry an clárlann mhícheart, nó níl aon chomhartha tarraingthe ag suiteáil Enterprise. Fanann imleabhar Pending toisc nach bhfuil an rang stórála ann. Tá cert-manager ar iarraidh, agus sa chás sin ní stadann an tsuiteáil ar chor ar bith: teipeann uirthi laistigh de shoicindí, toisc go bhfuil acmhainní cert-manager ag teastáil ó eisitheoirí deimhnithe na cairte.
Tosaigh leis na podanna agus na Jobs crúca:
kubectl -n nexus get pods,jobs
kubectl -n nexus describe pod <pod-name>
kubectl -n nexus logs job/<job-name>
kubectl get crd certificates.cert-manager.ioTaispeánann describe earráidí tarraingthe íomhá agus imleabhair neamhcheangailte ina chuid imeachtaí. Tá Job crúca a thaispeánann 0/1 críochnú le pod teipthe tar éis an tsuiteáil a stopadh, toisc go bhfuil teorainn chúlaithe de 0 ag Jobs crúca agus ní dhéantar iarracht eile orthu go ciúin riamh. Deir a logchomhad cén fáth.
Seo mar a réitítear gach cúis:
- Má tá Helm ag fanacht le
--wait, stop é, díshuiteáil, agus suiteáil arís gan an bhratach. Ansin fan leis na seirbhísí:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- I gcás earráidí tarraingthe, seiceáil
global.imageRegistryagus, le haghaidh Enterprise, an comhartha tarraingthe ó leathanach Comharthaí tarraingthe agus orduithe suiteála do chuntais. - I gcás imleabhar
Pending, socraighstorage.classNamear rang stórála atá ag an mbraisle, nó déan ceann amháin mar réamhshocrú. - I gcás cert-manager atá ar iarraidh, suiteáil cert-manager v1.21.3 agus rith an tsuiteáil arís.
- I gcás crúca teipthe, socraigh an méid a ainmníonn a logchomhad agus rith an tsuiteáil arís.
Fanann pod lena scéimre
Fanann pod seirbhíse in Init:0/1 ar feadh nóiméad. Tá coimeádán túsaithe, wait-for-schema, ag gach seirbhís a úsáideann an bunachar sonraí, a choinníonn an pod go dtí go dtaispeánann mórleabhar na heisiúna go bhfuil a chuid aistrithe curtha i bhfeidhm d'íomhá na heisiúna seo. Tá sé sin gnáth do na chéad nóiméid de shuiteáil nó d'uasghrádú, fad is a ritheann na crúcaí aistrithe. Is fadhb é nuair nach dtagann deireadh leis.
Léigh logchomhad an choimeádáin túsaithe:
kubectl -n nexus logs <pod-name> -c wait-for-schemaAinmníonn an logchomhad an chomhpháirt, na slabhraí aistrithe a bhfuil sé ag fanacht leo agus a theorainn ama, agus ansin priontálann sé líne aon uair a athraíonn a staid:
wait-for-schema: nexus-auth waits for nexus_release.schema_applied (read as nexus_ledger_reader) to show: nexus-auth-migrations=sha256:…; gives up after 1800s
| Deir an líne dul chun cinn | Cad is brí leis |
|---|---|
| Cé na slabhraí atá fós le cur i bhfeidhm don eisiúint seo | Níl na crúcaí aistrithe ainmnithe críochnaithe. Féach ar na Jobs sin. |
| Nach féidir mórleabhar na heisiúna a léamh, le hearráid an bhunachair sonraí | Níl Postgres ag tabhairt freagra, nó níl an mórleabhar ann toisc nár rith tosú an bhunachair sonraí. |
FAILED (<component>): after <n>s, … |
D'éirigh sé as tar éis schemaWait.timeoutSeconds (1,800 de réir réamhshocraithe). Atosaíonn an coimeádán túsaithe; níor thosaigh an tseirbhís féin riamh. |
Is ionann slabhra nach gcuirtear i bhfeidhm riamh, beagnach i gcónaí, agus gur theip ar a Job aistrithe. Aimsigh é le kubectl -n nexus get jobs agus léigh a logchomhad. Socraigh an méid a ainmníonn sé (diosca lán, bunachar sonraí seachtrach nach féidir leis an aistritheoir a bhaint amach, coimhlint ról) agus rith helm upgrade leis na luachanna céanna: ritheann na crúcaí arís, agus tá gach ceann acu sábháilte le hathrith.
Ná hardaigh schemaWait.timeoutSeconds ach amháin nuair atá aistriú mall agus sláintiúil, mar is féidir le céad aistriú mór ar stóráil mhall a bheith. Má ardaítear é chun Job teipthe a cheilt, ní dhéanann sé ach an pod a choinneáil ag fanacht níos faide le rud nach dtiocfaidh riamh.
Tá an stór eochracha séalaithe
Tar éis cliseadh cumhachta, atosú nóid nó atosú am rite coimeádáin, tagann podanna ar ais agus lódálann an consól, agus teipeann ar aon rud a dteastaíonn eochair uaidh nó fanann sé. Tosaíonn an díshéalaitheoir séalaithe tar éis gach atosú ar a nód, agus ní féidir leis an stór eochracha é féin a dhíshéalú go dtí go mbíonn an díshéalaitheoir oscailte.
Fiafraigh de OpenBao i ngach pod:
kubectl -n nexus exec openbao-unsealer-0 -c openbao -- \
bao status -format=json -address=https://127.0.0.1:8200 \
-ca-cert=/openbao/tls/ca.crt -tls-server-name=openbao-unsealer
echo "exit $?"Ciallaíonn scor 0 go bhfuil sé díshéalaithe, ciallaíonn 2 go bhfuil sé séalaithe, agus ciallaíonn 1 nach raibh sé in ann freagra a thabhairt (fiafraigh arís i gceann nóiméid). Rith an rud céanna i gcoinne openbao-0 le -tls-server-name=openbao don stór eochracha. Má tá an díshéalaitheoir díshéalaithe agus mura bhfuil an stór eochracha, tá an stór eochracha á dhíshéalú féin; tabhair nóiméad dó.
Chun díshéalaitheoir séalaithe a shocrú, ritheann caomhnóir amháin unseal.sh na cairte lena n-aitheantas age féin. Tá an t-ordú iomlán in Caibidil 2.15, An dara lá: Nexus a oibriú. Insíonn scor na scripte duit cad a tharla:
| Scor | Brí | Cad ba cheart a dhéanamh |
|---|---|---|
| 0 | Díshéalaithe | Seiceáil kubectl -n nexus get deploy,statefulset laistigh de nóiméad. |
| 1 | Fós séalaithe, nó theip ar ghlaoch díshéalaithe | Léigh na línte scaire a phriontáil sé; rith arís é. |
| 2 | Tá réamhriachtanas ar iarraidh | Ainmníonn an teachtaireacht é: AGE_IDENTITY, dénártha amhail age nó jq, nó socrú mód díreach. |
| 3 | Ní féidir leis an aitheantas seo na scaireanna a dhíchriptiú | Ní caomhnóir thú ar an tsuiteáil seo. Níor cuireadh aon rud isteach. Aimsigh caomhnóir arb ea é nó í. |
Ní féidir leat síniú isteach thar HTTP
Lódálann an consól ag seoladh http://, nó trí kubectl port-forward go 127.0.0.1, agus teipeann ar shíniú isteach. Ní thagann leid na pas-eochrach aníos riamh, nó lúbann an síniú isteach ar ais go dtí an tús.
Teastaíonn bunús HTTPS an chonsóil féin don síniú isteach. Ní ghlacann an consól le síniú isteach ach ó https://<hosts.console>, coinníonn sé an seisiún i bhfianán __Host- atá marcáilte Secure (nach stórálann brabhsálaí ach thar HTTPS), agus teastaíonn leathanach le deimhniú bailí ó phas-eochair an chéad riarthóra. Diúltaíonn brabhsálaithe do phas-eochracha taobh thiar d'earráid deimhnithe. Ní féidir le cur ar aghaidh poirt go http://127.0.0.1 síniú isteach riamh.
Seiceáil an méid a shroich an brabhsálaí i ndáiríre:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressBa cheart don chéad cheann freagra a thabhairt thar HTTPS le deimhniú a bhfuil muinín ag do mheaisín as. Ba cheart don dara ceann na trí óstach a thaispeáint leis na hainmneacha a shocraigh tú in hosts.*.
Chun é a shocrú, sroich an consól ag https://console.harrow.example, an t-ainm cruinn in hosts.console, le deimhniú a bhfuil muinín ag an mbrabhsálaí as. Le tls.mode: existing, seiceáil go bhfuil deimhniú ag tls.existingSecret do na trí óstach go léir. Le tls.mode: cert-manager, seiceáil gur eisigh an ClusterIssuer é. Le tls.mode: none, críochnaíonn Slándáil an Chiseal Iompair (TLS) ar do chothromóir ualaigh féin, agus is ann a chaithfidh an deimhniú a bheith ceart. I gcás údaráis deimhniúcháin phríobháidigh, suiteáil a dheimhniú ar na meaisíní a shíníonn do riarthóirí isteach uathu.
Chuaigh an cód éilimh in éag
Ar Éiligh an tsuiteáil seo diúltaíonn an leathanach don chód le CLAIM_CODE_EXPIRED (410). Is éard atá i gcód éilimh ná trí ghrúpa de cheithre charachtar. Oibríonn sé uair amháin, ar feadh 30 nóiméad, le 5 iarracht. Ina dhiaidh sin, nó tar éis na cúigiú hiarrachta míchearta, tá sé marbh, agus níor éilíodh ná níor athraíodh aon rud.
Cruthaigh cód nua ón teirminéal a bhfuil rochtain bhraisle aige:
nexusctl claim-code --administrator aoife.brennan@harrow.examplePriontálann sé cód úr agus méarlorg na suiteála. Cuir an cód isteach ar an leathanach éilimh laistigh de 30 nóiméad agus cuir an méarlorg i gcomparáid arís.
Dhá fhreagra ghaolmhara:
- Ciallaíonn
RATE_LIMITED(429) ar an leathanach éilimh go ndearnadh roinnt iarrachtaí ar an leathanach sa nóiméad deireanach. Fan an líon soicindí a thugann sé. Mura ndearna tú na hiarrachtaí sin, tá duine éigin eile ar do líonra ag triail an leathanaigh; faigh amach cé hé nó hí sula ndéanann tú éileamh. - Ciallaíonn
TRANSITION_NOT_PERMITTED(409) go bhfuil an tsuiteáil éilithe cheana féin, agus go bhfuil a leathanach éilimh múchta go deo. Sínigh isteach ina ionad sin. Murar éiligh tú í, caith leis sin mar theagmhas slándála.
Níl an méarlorg ag teacht leis
Taispeánann an leathanach éilimh CLAIM_FINGERPRINT_MISMATCH (403), nó is féidir leat a fheiceáil duit féin go bhfuil na hocht ngrúpa de cheithre cinn ar an leathanach difriúil ó na cinn a phriontáil do theirminéal. Ciallaíonn fiú grúpa amháin difriúil go bhfuil an brabhsálaí ag caint le suiteáil dhifriúil.
Stop. Ná clóscríobh an cód isteach sa leathanach sin. D'fhéadfadh rud éigin seachas do shuiteáil a bheith ag tabhairt freagra ag an seoladh sin, b'fhéidir meaisín a cuireadh ar bun chun an chéad riarthóir a ghabháil. Dá n-éileofá é, bheadh d'eagraíocht i seilbh an mheaisín sin. Tá do shuiteáil féin gan athrú agus fós gan éileamh.
Seiceáil cá bhfuil an t-ainm ag díriú agus cén deimhniú a thug freagra:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleBa cheart gurb é an seoladh seoladh do rialaitheora iontrála, agus ba cheart gurb é an deimhniú an ceann a shuiteáil tú le haghaidh hosts.console.
Chun é a shocrú, tabhair an seoladh a thug freagra do d'fhoireann slándála agus coinnigh an logchomhad suiteála, a thaifeadann an méarlorg a phriontáil an tsuiteáil. Ceartaigh taifead an Chórais Ainmneacha Fearainn (DNS) nó an seachfhreastalaí a chuir go dtí áit eile thú. Ansin cruthaigh cód éilimh nua le nexusctl claim-code --administrator <email> agus déan éileamh ó bhrabhsálaí ar líonra a bhfuil muinín agat as, agus na hocht ngrúpa go léir á gcur i gcomparáid arís.
Diúltaítear don cheadúnas
Tugann an t-iompórtáil ar Iompórtáil an ceadúnas, Iompórtáil ceadúnas nua nó nexusctl licence import freagra le diúltú. Ní athraíonn iompórtáil dhiúltaithe aon rud: fanann an ceadúnas atá i bhfeidhm i bhfeidhm, agus ní bhogann urlár an chloig.
Léigh an cód agus an chéim:
curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence \
-H "Authorization: Bearer <access-token>" \
-H "Content-Type: application/json" \
--data-binary @harrow-2027.licence.jsonIompraíonn corp an diúltaithe code, message, refused_at (an chéim ar theip uirthi) agus troubleshooting. Chun staid an cheadúnais atá i bhfeidhm a fheiceáil, léigh GET https://auth.harrow.example/api/v1/installation/licence/state leis an gcomhartha céanna.
| Cód | HTTP | Cúis choitianta | Réiteach |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Cuireadh an comhad in eagar, athfhormáidíodh nó athshábháladh é, nó tá síniú amháin ar iarraidh | Íoslódáil arís é ó do chuntas agus iompórtáil gan tadhall é |
LICENCE_FORMAT_INVALID |
422 | Ní ceadúnas é: comhad mícheart, teasctha, nó fillte i réad eile | Seol an comhad díreach mar a thug Adverant é |
LICENCE_ROOT_UNKNOWN |
422 | Sínithe le heochair nach n-iompraíonn an eisiúint seo | Uasghrádaigh, nó iarr ceadúnas atá sínithe do d'eisiúint |
LICENCE_MATRIX_MISMATCH |
422 | Scríofa do mhaitrís eagráin níos nuaí, nó deonaíonn sé grúpa nach bhfuil aithne ag an tógáil seo air | Uasghrádaigh, nó iarr ceadúnas atá scríofa i gcoinne d'eisiúna |
LICENCE_OTHER_INSTALLATION |
409 | Eisithe do shuiteáil eile, go minic ceadúnas na braisle tástála ar tháirgeadh | Iarr ceadúnas d'aitheantas na suiteála seo |
LICENCE_REVOKED |
403 | Tharraing Adverant siar é | Iarr ceadúnas nua ar Adverant |
LICENCE_LOCKED |
403 | Tá a starts_on tar éis an dáta reatha |
Iompórtáil é ar a chéad lá nó ina dhiaidh |
TRANSITION_NOT_PERMITTED |
409 | Iompórtáladh an t-aitheantas ceadúnais seo cheana féin | Dada le déanamh má tá sé i bhfeidhm; fiafraigh de Adverant má chaithfidh na téarmaí athrú |
RECORD_NOT_FOUND |
404 | Níl an tsuiteáil dearbhaithe, mar sin níl aon aitheantas aici fós | Críochnaigh céim an chéad riarthóra, ansin iompórtáil |
TENANT_NOT_A_PARAMETER |
403 | Ainmníonn an corp eagraíocht ag a leibhéal uachtarach | Seol comhad an cheadúnais ina aonar mar an corp |
Breathnaíonn dhá rud mar fhadhbanna ceadúnais ach ní hea. Ciallaíonn léamh staide a iompraíonn LICENCE_CLOCK_BEHIND_FLOOR go léann clog an nóid níos luaithe ná an t-am is déanaí a chonaic an tsuiteáil; socraigh am an nóid, agus má bhí an clog tar éis rith chun tosaigh agus an t-urlár a thabhairt leis, iarr comhartha athshocraithe ama ar Adverant. Agus de ghnáth ní dheonaíonn ceadúnas a iompórtálann agus a thaispeánann grúpa mar bhlaiseadh fós an grúpa sin: léigh na deontais ar leathanach an cheadúnais roimh aon rud eile.
Níl aon fhreagraí AI ann
Taispeánann an cúntóir intleachta saorga (AI) MODEL_NOT_CONNECTED (503), teipeann ar chéim sreafa oibre le NO_PROVIDER_FOR_ROLE (422), nó stadann na freagraí go simplí.
Níl aon eochair ag linn na heagraíochta ar féidir léi freagra a thabhairt, nó ní féidir leis an ródaire an soláthraí a bhaint amach. Tugann gach eagraíocht a heochair mhúnla féin léi. Gan aon eochair in úsáid níl aon AI ann, d'aon ghnó, agus ní líonann aon eochair roinnte an bhearna.
Seiceáil an linn agus rogha an ródaire, gach ceann acu le comhartha rochtana an duine féin:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
Liostaíonn an chéad cheann gach soláthraí, an féidir leis freagra a thabhairt agus cén fáth nach féidir ("Gan eochair in úsáid: 1 tarraingthe siar, 1 imithe in éag"), agus staid gach eochrach. Freagraíonn an dara ceann an múnla a d'úsáidfeadh an ródaire don eagraíocht, nó a dhiúltú i bhfocail. Ansin seiceáil an cosán amach as an mbraisle leis an dá ordú seo:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayCad a chiallaíonn gach toradh:
| Aimsíonn tú | Réiteach |
|---|---|
| Gan aon eochair sa linn | Cuireann úinéir nó riarthóir eochair eagraíochta leis ar an lasc-chlár AI nó Socruithe, Múnlaí AI |
Eochracha invalid, expired nó exhausted |
Cuir eochair úr leis; fanann an seancheann liostaithe mar stair |
Eochracha resting |
Fan: glacann eochair theipthe sos ar feadh 60 soicind, agus tar éis 5 theip as a chéile múchtar í (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE le heochracha in úsáid |
Níl aon sannadh ag an ról agus ní mheaitseálann aon rud; socraigh an ról sa bheartas ródaithe |
MODEL_CAPABILITY_UNAVAILABLE (422) |
Teastaíonn cumas, nó cónaitheacht, ón iarratas nach dtugann aon soláthraí sa linn; cumasaigh ceann a thugann |
Gan aon bheartas nexus-operator-egress, nó raonta an tsoláthraí ar iarraidh uaidh |
Cuir na raonta, scríofa i nodaireacht Ródú Idir-Fhearainn gan Rang (CIDR), le networkPolicy.externalEgressCIDRs agus uasghrádaigh |
| Freastalaí múnla áitiúil nach dtugann freagra | Seiceáil ai.localProvider.baseUrl, liostaigh an freastalaí in ai.installationHosts, agus ceadaigh a raon in networkPolicy.externalEgressCIDRs |
Is é an beartas líonra beagnach i gcónaí is cúis le heochair sholáthraí óstáilte a oibríonn ó ríomhaire glúine agus a theipeann ar an tsuiteáil. Diúltaíonn an t-ainmspás do dhul amach de réir réamhshocraithe.
Freagraí 429
Tugtar 429 Too Many Requests mar fhreagra do chliant. Tá ceithre áit ag Nexus ar féidir leo é a rá, agus insíonn an corp duit cé acu ceann.
| Cá háit | Cód agus sonraí | Cad is gá a athrú |
|---|---|---|
| nexus-auth, in aghaidh an duine atá sínithe isteach | RATE_LIMITED le limit, windowSeconds agus retryAfterSeconds |
auth.rateLimitPerMinute (réamhshocrú 5000), le haghaidh uathoibriú trom |
| Teorainn eochrach scripte, aipe nó aonaid (Enterprise) | RATE_LIMITED ag ainmniú na heochrach agus a teorann |
An teorainn ar Socruithe, Teorainneacha ráta, le cúis |
| An leathanach éilimh chéad-rite | RATE_LIMITED le retry_after_seconds |
Dada: fan, agus faigh amach cé eile atá ag triail an leathanaigh |
| Soláthraí múnla | Caitheann an ródaire leis mar theip shealadach agus bogann sé go dtí an chéad soláthraí eile | Cuir eochair nó soláthraí eile leis má tharlaíonn sé go minic |
Iompraíonn gach ceann acu ceanntásc Retry-After. Fanann cliant dea-iompair an fad sin agus ní dhéanann sé iarracht eile níos luaithe.
Má bhíonn an chuma ar an scéal go bhfuil gach úsáideoir ag an am céanna ag roinnt teorann amháin, seiceáil proxy.trustedCIDRs. Nuair nach gclúdaíonn sé líonra pod do rialaitheora iontrála, ní féidir le nexus-auth an ceanntásc X-Forwarded-For a chreidiúint agus feiceann sé gach iarratas mar cheann a thagann ón rialaitheoir. Ní oireann an réamhshocrú, 10.42.0.0/16, ach do k3s amháin.
kubectl get pods -A -o wideAimsigh seoladh pod an rialaitheora iontrála san aschur agus déan cinnte go gclúdaíonn proxy.trustedCIDRs é.
Earráidí uasghrádaithe
rolladh an t-uasghrádú siar. Taispeánann an leathanach Uasghrádaithe UPGRADE_ROLLED_BACK: theip ar chéim, tá gach inneall ar ais ar an eisiúint roimhe seo, agus níor athraíodh sonraí. Ainmníonn an leathanach an chéim. Ceann coitianta is ea imleabhar atá róbheag do leagan amach nua stóir. Socraigh an méid a ainmníonn sé, rith nexusctl upgrade plan --bundle <file> arís, agus ansin cuir i bhfeidhm é. Tógtar an cúltaca arís ar dtús.
Diúltaíonn an chairt do rindreáil le EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Coinníonn an Secret nexus-generated EXTERNAL_KEY_ENCRYPTION_KEY i gcruth nach féidir leis an gcairt a úsáid. Caithfidh sé a bheith ina base64 de 32 bheart, nó ina eochair amh 32-beart de shuiteáil níos sine. Chuir duine éigin an Secret in eagar nó chuir sé ceann eile ina áit. Cuir ar ais an eochair a bhfuil sonraí na suiteála seo séalaithe fúithi, mar base64 dá 32 bheart (printf %s "$OLD" | base64), agus uasghrádaigh arís. Ná lig don chairt ceann nua a dhéanamh: d'fhanfadh sonraí a séalaíodh faoin seaneochair do-léite.
Diúltaítear do scripteanna le TOKEN_ORG_MISSING tar éis an uasghrádaithe. Diúltaíonn gach seirbhís a sheiceálann eochracha comhéadain ríomhchlárúcháin feidhmchláir (API) trí nexus-auth d'eochair gan eagraíocht anois, le 403 TOKEN_ORG_MISSING. Tabhair eagraíocht do gach eochair den sórt sin, nó eisigh eochair nua.
Tuairiscíonn eochracha an feidhmchlár mícheart ar feadh uair an chloig. Sruthlaigh na hiontrálacha eochrach i dtaisce i dtaisce nexus-auth, stór Valkey na suiteála. Tá an t-ordú in Caibidil 2.15, An dara lá: Nexus a oibriú, don stór sa bhraisle agus do cheann seachtrach.
Theip ar chrúca aistrithe. Tuairiscíonn helm upgrade crúca réamh-uasghrádaithe teipthe. Bogann an scéimre sula rollann na podanna nua, mar sin tá an eisiúint atá ag rith fós ag freastal. Léigh logchomhad an Job le kubectl -n nexus logs job/<job-name>, socraigh an méid a ainmníonn sé agus rith an t-uasghrádú arís.
Ní raibh seirbhísí in ann a gcuid táblaí a úsáid ar feadh cúpla soicind. Ar an gcéad uasghrádú ar shuiteáil a rinneadh ó chairt níos luaithe, cailleann gach seirbhís a seanchearta tábla réamhshocraithe agus faigheann sí a cuid féin ar ais óna haistriú féin. Soicindí atá sa bhearna. Déan an t-uasghrádú le linn tréimhse chiúin, nó scálaigh na seirbhísí go nialas ar dtús.
Diúltaíodh don eisiúint ar an diosca. Taispeánann Iompórtáil ó mheáin MEDIA_SIGNATURE_INVALID (422): níl na comhaid sínithe ag an eochair eisiúna atá suiteáilte ar an tsuiteáil seo. Níor lódáladh aon rud agus leanann an eisiúint atá ag rith uirthi ag rith. Coinnigh na meáin do d'fhoireann slándála agus iarr meáin nua ar Adverant tríd an malartú as líne.
Diúltú rindreála cairte
Stadann helm install, helm upgrade nó helm template sula gcuirtear aon rud i bhfeidhm, le teachtaireacht a thosaíonn le cód nó a ainmníonn luach. Diúltaíonn an chairt do luachanna nach féidir léi a rith go sábháilte. Níor athraigh aon rud ar an mbraisle.
Rindreáil an chairt léi féin chun gach diúltú a fheiceáil gan tadhall leis an mbraisle. Úsáid an chairt Enterprise a d'íoslódáil tú in áit an tseolta oci:// ar Enterprise, agus socraigh networkPolicy.apiServerCIDRs sna luachanna, toisc nach féidir le rindreáil as líne é a léamh ón mbraisle:
helm template nexus oci://registry.adverant.ai/nexus/charts/nexus --version <version> \
-n nexus -f harrow-values.yaml > /dev/null
nexusctl preflight --context harrow-prod --values harrow-values.yamlSeiceálann Preflight na luachanna aitheantais céanna ina chuid "am agus eochracha" agus tuairiscíonn sé na cóid chéanna. Is é 0 a scor nuair is féidir leis an tsuiteáil dul ar aghaidh (ní chuireann rabhaidh bac air), 1 nuair a theip ar sheiceáil amháin ar a laghad, agus 2 nuair nach raibh sé in ann rith.
| Diúltú | Cúis | Réiteach |
|---|---|---|
INSTALLATION_NAME_MISSING |
Tá keys.installationName folamh |
Socraigh é ar ainm na suiteála seo féin, ag meaitseáil ^[a-z][a-z0-9-]{0,62}$. Tá sé buan a luaithe a thosaíonn an stór eochracha den chéad uair |
INSTALLATION_NAME_EXAMPLE |
Is é an t-ainm an ceann i gcomhaid luachanna samplacha na cairte | Socraigh d'ainm féin |
keys.installationName "…" does not match … |
Ceannlitreacha, fostríoca nó digit tosaigh | Úsáid litreacha cás íochtair, digití agus fleiscíní, ag tosú le litir |
KEYS_CUSTODIAN_MISSING |
Tá keys.custody.recipients folamh |
Liostaigh faighteoirí age do chaomhnóirí, na leatha poiblí |
KEYS_CUSTODIAN_EXAMPLE |
Is é an faighteoir an caomhnóir samplach ó chomhaid luachanna na cairte, nach bhfuil a aitheantas i seilbh aon duine | Cuir faighteoirí do chaomhnóirí féin ina áit |
keys.custody.recipients: … |
Faighteoir i bhfoirm nach féidir leis an Job caomhnóireachta criptiú chuige | Úsáid age1…, age1tag1…, age1tagpq1…, age1pq1… nó age1se1…, i gcás íochtair |
NEXUS_EDITION_INVALID |
Ní community ná enterprise é edition |
Socraigh ceann amháin den dá cheann |
edition=… but enterprise.enabled=… |
Ní aontaíonn an dá cheann | Socraigh enterprise.enabled: true go díreach nuair is enterprise é edition |
global.imageRegistry is required |
Gan aon chlárlann ainmnithe | Socraigh an chlárlann a dtarraingíonn do nóid na híomhánna uaithi |
hosts.<name> is required |
Tá óstach poiblí ar iarraidh | Socraigh hosts.console, hosts.api agus hosts.auth |
tls.existingSecret is required when tls.mode is existing |
Gan aon Secret deimhnithe ainmnithe | Ainmnigh an Secret, nó roghnaigh tls.mode eile |
tls.clusterIssuer is required when tls.mode is cert-manager |
Gan aon eisitheoir ainmnithe | Ainmnigh do ClusterIssuer |
dataTier.<store>.external.host is required when mode is external |
Stór seachtrach gan aon seoladh | Tabhair a óstach, agus a Secret in existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
Níl aon bhraisle ag helm template chun iad a chuardach inti |
Tabhair seoltaí an fhreastalaí API mar raonta /32 |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
Tá an cruth mícheart ar an eochair ginte in nexus-generated |
Féach "Earráidí uasghrádaithe" thuas |
Diúltaíonn scéimre na cairte do chomhad luachanna a úsáideann eochair nach bhfuil ag an gcairt, nó luach den chineál mícheart, roimh aon cheann díobh seo. Is sampla amháin é telemetry.enabled: true: ní ghlacann an scéimre ach le false.
Beart tacaíochta a sheoladh
Nuair nach réitíonn aon cheann de seo é, seol beart tacaíochta chuig Adverant le d'iarratas tacaíochta.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gzIs é <request-number> uimhir an iarratais a d'oscail tú ar leathanach Tacaíocht agus bearta tacaíochta do chuntais. Is féidir leat an beart céanna a dhéanamh ó leathanach Beart tacaíochta an chonsóil faoi An tsuiteáil seo.
Coinníonn an beart logchomhaid innill ón 24 uair an chloig dheireanacha, sonraí sláinte agus leagain, socruithe gan a gcuid rún, agus na tuarascálacha réamheitilte agus suiteála. Sula scríobhtar é, cuirtear rud eile in ionad ainmneacha, rún agus seoltaí trí fholú, agus léann tú réamhamharc ar an méid cruinn a imíonn. Ní bhailítear teachtaireachtaí, comhaid ná cuimhne daoine riamh.
Uaslódáil é ar an iarratas i do chuntas, nó sábháil ar mheáin é agus tabhair amach é mura bhfuil aon nasc seachtrach ag an tsuiteáil. Ní féidir ach leis na hinnealtóirí tacaíochta atá ainmnithe ar an iarratas é a oscailt, agus scriostar é tar éis 30 lá. Abair san iarratas cé acu de na fadhbanna thuas a raibh tú ag breathnú orthu, agus cad a thaispeáin na seiceálacha sa chaibidil seo: sábhálann sé turas anonn is anall.


