Sínigh isteachCuir cruinniú eolais in áirithe

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

22 nóiméad le léamh

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:

  1. 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.
  2. Rith nexusctl preflight arí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 é.
  3. Úsáid --explain ar aon bhriathar nexusctl nach bhfuil tú cinnte faoi. Priontálann sé na hoibríochtaí kubectl agus helm gan 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.

Seicheamh ingearach de bhoscaí ceangailte le saigheada síos: "Acmhainní eisiúna cruthaithe (tosaíonn Deployments, gach ceann acu coinnithe ag a choimeádán túsaithe wait-for-schema)", ansin "Crúca tosaithe bunachair sonraí: bunachar sonraí, róil, mórleabhar eisiúna", ansin "Crúcaí aistrithe, ceann amháin in aghaidh na seirbhíse, in ord seasta", ansin "Scríobhann gach crúca a ró féin i mórleabhar na heisiúna". Ón mbosca deireanach, leathann saigheada amach go cliathánach chuig trí bhosca bheaga "tosaíonn nexus-auth", "tosaíonn nexus-gateway", "tosaíonn seirbhísí eile". Nóta taobh le hais an bhosca uachtaraigh, le saighead crosáilte amach go dtí an bun: "fanann helm install --wait anseo le Deployments atá ag fanacht leis na crúcaí".
An méid a ritheann, in ord, nuair a shuiteáiltear nó nuair a uasghrádaítear an chairt.

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.io

Taispeá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.imageRegistry agus, le haghaidh Enterprise, an comhartha tarraingthe ó leathanach Comharthaí tarraingthe agus orduithe suiteála do chuntais.
  • I gcás imleabhar Pending, socraigh storage.className ar 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-schema

Ainmní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 ingress

Ba 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.example

Priontá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.

Éiligh an tsuiteáil seo
Éiligh an tsuiteáil seo
Éiligh an tsuiteáil seo. Téann an cód ón teirminéal isteach i dtrí ghrúpa, agus taispeánann an leathanach an méarlorg iomlán i ngrúpaí de cheithre cinn le cur i gcomparáid; diúltaítear do chód atá imithe in éag le CLAIM_CODE_EXPIRED agus ní éilítear aon rud.

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.example

Ba 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.

Níl an méarlorg ag teacht leis
Níl an méarlorg ag teacht leis
Tá na méarloirg difriúil i dtrí cinn as ocht ngrúpa. Deir an leathanach stopadh, míníonn sé cé a d'fhéadfadh a bheith ag tabhairt freagra, agus liostaíonn sé cad is gá a sheiceáil sula ndéantar iarracht arís.

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.json

Iompraí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-gateway

Cad 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 wide

Aimsigh 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.yaml

Seiceá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.

Ní féidir leis an réamhsheiceáil leanúint ar aghaidh
Ní féidir leis an réamhsheiceáil leanúint ar aghaidh
Ní féidir le Preflight leanúint ar aghaidh. Tagann na seiceálacha teipthe ar dtús, gach ceann acu lena réiteach, agus fanann bac ar an tsuiteáil le PREFLIGHT_FAILED go dtí go n-éiríonn leo.
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.gz

Is é <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.