Verżjoni 1.0.0-alpha.1l-aħħar
Kapitlu 2.17
Soluzzjoni tal-problemi
Il-problemi li l-operaturi jiltaqgħu magħhom l-aktar spiss, organizzati skont dak li tara. Kull waħda tagħti l-kawża, il-kmand li jikkonfermaha u s-soluzzjoni, u l-kapitlu jagħlaq billi jintbagħat pakkett ta' appoġġ.
Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

Il-biċċa l-kbira ta' dak li jmur ħażin f'installazzjoni ta' Nexus imur ħażin bl-istess tużżana modi, u kważi kollha kemm huma jħabbru lilhom infushom b'kodiċi. Dan il-kapitlu huwa organizzat skont dak li tara, bejn wieħed u ieħor fl-ordni li kont tiltaqa' ma' kull problema: l-installazzjoni, it-talba tas-sjieda (claiming), il-liċenzjar, imbagħad it-tħaddim. Għal kull waħda jkollok il-kawża, kmand li jikkonfermaha, u s-soluzzjoni.
L-eżempji jużaw l-installazzjoni ta' Harrow Port Authority: namespace nexus, rilaxx nexus, hosts console.harrow.example, api.harrow.example u auth.harrow.example. Ibdel dawn b'tiegħek. Tliet drawwiet jiffrankaw il-ħin ma' kull problema hawnhekk:
- Aqra l-kodiċi qabel il-messaġġ. Kull rifjut f'Nexus jispiċċa b'kodiċi tal-magna, u dan il-kapitlu huwa indiċizzat skont dak il-kodiċi.
- Erġa' ħaddem
nexusctl preflightwara kwalunkwe bidla fil-cluster jew fil-fajl tal-valuri. Dan jaqra l-cluster mingħajr ma jibdlu, u jirrapporta l-biċċa l-kbira tar-rifjuti taċ-chart b'isimhom qabel ma jagħmel dan Helm. - Uża
--explainfuq kwalunkwe verb ta'nexusctlli m'intix ċert minnu. Dan jistampa l-operazzjonijiet ta'kubectluhelmmingħajr ma jħaddimhom.
L-installazzjoni teħel
Ħaddimt l-installazzjoni u għadha ma spiċċatx. helm għadu ma rritornax wara ħmistax-il minuta, jew irritorna u l-pods għadhom f'Init jew Pending, jew l-indirizz tal-console ma jweġibx.
L-aktar kawża komuni hija helm install --wait. Nexus joħloq id-database tiegħu, ir-rwoli tiegħu u l-iskema ta' kull servizz f'post-install hooks, u l-bootstrap hook huwa dak li jagħti lil kull servizz il-password tad-database tiegħu. Bi --wait, Helm jistenna li d-Deployments ikunu lesti qabel ma jħaddem dawk il-hooks, filwaqt li d-Deployments jistennew il-hooks. L-ebda wieħed ma jiċċaqlaq. Qatt tinstalla bi --wait; installa mingħajru u stenna wara.
Il-kawżi l-oħra huma dawk ordinarji ta' Kubernetes. L-immaġnijiet ma jistgħux jinġibdu għax global.imageRegistry jindika r-reġistru ħażin, jew installazzjoni Enterprise m'għandhiex pull token. Volum jibqa' Pending għax l-istorage class ma teżistix. cert-manager huwa nieqes, u f'dak il-każ l-installazzjoni ma tieqafx tistenna: tfalli fi ftit sekondi, għax l-emittenti taċ-ċertifikati taċ-chart jeħtieġu r-riżorsi ta' cert-manager.
Ibda bil-pods u l-hook Jobs:
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.iodescribe juri żbalji fil-ġbid tal-immaġnijiet u volumi mhux marbuta fl-avvenimenti tiegħu. Hook Job li juri 0/1 tlestijiet b'pod li falla jkun waqqaf l-installazzjoni, għax il-hook Jobs għandhom limitu ta' backoff ta' 0 u qatt ma jerġgħu jiġu ppruvati fis-skiet. Il-log tiegħu jgħid għaliex.
Hawn kif issolvi kull kawża:
- Jekk Helm qed jistenna bi
--wait, waqqfu, iddiżinstalla, u erġa' installa mingħajr il-flag. Imbagħad stenna s-servizzi:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Għal żbalji fil-ġbid (pull errors), iċċekkja
global.imageRegistryu, għal Enterprise, il-pull token mill-paġna Pull tokens and install commands tal-kont tiegħek. - Għal volumi
Pending, issettjastorage.classNamegħal storage class li għandu l-cluster, jew agħmel waħda bħala default. - Għal cert-manager nieqes, installa cert-manager v1.21.3 u erġa' ħaddem l-installazzjoni.
- Għal hook li falla, irranġa dak li jsemmi l-log tiegħu u erġa' ħaddem l-installazzjoni.
Pod jistenna l-iskema tiegħu
Il-pod ta' servizz jibqa' f'Init:0/1 għal minuti sħaħ. Kull servizz li juża d-database għandu init container, wait-for-schema, li jżomm il-pod sakemm ir-reġistru tar-rilaxx (release ledger) juri li l-migrazzjonijiet tiegħu ġew applikati għall-immaġni ta' dan ir-rilaxx. Dan huwa normali għall-ewwel minuti ta' installazzjoni jew aġġornament, waqt li jaħdmu l-migration hooks. Huwa problema meta ma jispiċċax.
Aqra l-log tal-init container:
kubectl -n nexus logs <pod-name> -c wait-for-schemaIl-log isemmi l-komponent, il-ktajjen ta' migrazzjoni li qed jistenna u l-limitu ta' ħin tiegħu, imbagħad jistampa linja kull meta jinbidel l-istat tiegħu:
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
| Il-linja tal-progress tgħid | Xi tfisser |
|---|---|
| Liema ktajjen għad iridu jiġu applikati għal dan ir-rilaxx | Il-migration hooks imsemmija għadhom ma spiċċawx. Ħares lejn dawk il-Jobs. |
| Li r-reġistru tar-rilaxx ma jistax jinqara, bl-iżball tad-database | Postgres mhux qed iwieġeb, jew ir-reġistru ma jeżistix għax il-bootstrap tad-database għadu ma ħadimx. |
FAILED (<component>): after <n>s, … |
Qata' qalbu wara schemaWait.timeoutSeconds (1,800 b'mod awtomatiku). L-init container jerġa' jibda; is-servizz innifsu qatt ma beda. |
Katina li qatt ma tiġi applikata kważi dejjem tfisser li l-Job tal-migrazzjoni tagħha falla. Sibu bi kubectl -n nexus get jobs u aqra l-log tiegħu. Irranġa dak li jsemmi (diska mimlija, database esterna li l-migrator ma jistax jilħaq, kunflitt ta' rwoli) u ħaddem helm upgrade bl-istess valuri: il-hooks jerġgħu jaħdmu, u kull wieħed huwa sigur biex jerġa' jitħaddem.
Għolli schemaWait.timeoutSeconds biss meta migrazzjoni tkun bil-mod u b'saħħitha, kif tista' tkun l-ewwel migrazzjoni kbira fuq ħażna bil-mod. Li tgħollih biex taħbi Job li falla sempliċement iġġiegħel lill-pod jistenna aktar għal xi ħaġa li qatt mhu se tiġi.
Il-ħażna taċ-ċwievet hija ssiġillata
Wara qtugħ tad-dawl, reboot ta' node jew restart tar-runtime tal-container, il-pods jiġu lura u l-console titgħabba, u kull ħaġa li teħtieġ ċavetta tfalli jew tistenna. L-unsealer jibda ssiġillat wara kull restart tan-node tiegħu, u l-maħżen taċ-ċwievet (key store) ma jistax jiftaħ is-siġill tiegħu nnifsu sakemm l-unsealer ikun miftuħ.
Staqsi lil OpenBao f'kull 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 $?"L-exit 0 huwa mhux issiġillat (unsealed), 2 huwa ssiġillat (sealed), u 1 ifisser li ma setax iwieġeb (erġa' staqsi wara minuta). Ħaddem l-istess kontra openbao-0 bi -tls-server-name=openbao għall-maħżen taċ-ċwievet. Jekk l-unsealer huwa mhux issiġillat u l-maħżen taċ-ċwievet huwa ssiġillat, il-maħżen taċ-ċwievet qed jiftaħ is-siġill tiegħu nnifsu; agħtih minuta.
Biex tirranġa unsealer issiġillat, kustodju wieħed iħaddem unseal.sh taċ-chart bl-identità age tiegħu stess. Kapitlu 2.15, It-tieni jum: it-tħaddim ta' Nexus, għandu l-kmand sħiħ. L-exit tal-iskript jgħidlek x'ġara:
| Ħruġ | Tifsira | X'għandek tagħmel |
|---|---|---|
| 0 | Mhux issiġillat (Unsealed) | Iċċekkja kubectl -n nexus get deploy,statefulset fi żmien minuta. |
| 1 | Għadu ssiġillat, jew sejħa għat-tneħħija tas-siġill falliet | Aqra l-linji tas-sehem (share lines) li stampa; erġa' ħaddmu. |
| 2 | Prerekwiżit huwa nieqes | Il-messaġġ isemmih: AGE_IDENTITY, binarju bħal age jew jq, jew setting ta' direct-mode. |
| 3 | Din l-identità ma tistax tiddekriptja l-ishma (shares) | M'intix kustodju ta' din l-installazzjoni. Xejn ma ġie sottomess. Sib kustodju li hu. |
Ma tistax tidħol permezz ta' HTTP
Il-console titgħabba f'indirizz http://, jew permezz ta' kubectl port-forward għal 127.0.0.1, u l-iffirmar (signing in) ifalli. Il-prompt tal-passkey qatt ma jidher, jew l-iffirmar jerġa' jdur lura għall-bidu.
L-iffirmar jeħtieġ l-oriġini HTTPS tal-console stess. Il-console taċċetta ffirmar biss minn https://<hosts.console>, iżżomm is-sessjoni f'cookie __Host- immarkata Secure (li browser jaħżen biss fuq HTTPS), u l-passkey tal-ewwel amministratur teħtieġ paġna b'ċertifikat validu. Il-browsers jirrifjutaw il-passkeys wara żball taċ-ċertifikat. Port-forward għal http://127.0.0.1 qatt ma jista' jiffirma.
Iċċekkja x'laħaq fil-fatt il-browser:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressL-ewwel wieħed għandu jwieġeb fuq HTTPS b'ċertifikat li l-magna tiegħek tafda. It-tieni wieħed għandu juri t-tliet hosts bl-ismijiet li ssettjajt f'hosts.*.
Biex tirranġaha, ilħaq il-console f'https://console.harrow.example, l-isem eżatt f'hosts.console, b'ċertifikat li l-browser jafda. Bi tls.mode: existing, iċċekkja li tls.existingSecret iżomm ċertifikat għat-tliet hosts kollha. Bi tls.mode: cert-manager, iċċekkja li l-ClusterIssuer ħarġu. Bi tls.mode: none, it-Transport Layer Security (TLS) jispiċċa fuq il-load balancer tiegħek stess, u hemmhekk iċ-ċertifikat irid ikun tajjeb. Għal awtorità taċ-ċertifikati privata, installa ċ-ċertifikat tagħha fuq il-magni li l-amministraturi tiegħek jiffirmaw minnhom.
Il-kodiċi tat-talba skada
Fuq Claim this installation il-paġna tirrifjuta l-kodiċi bi CLAIM_CODE_EXPIRED (410). Kodiċi ta' talba (claim code) huwa tliet gruppi ta' erba' karattri. Jaħdem darba, għal 30 minuta, b'5 tentattivi. Wara dan, jew wara l-ħames tentattiv ħażin, ikun mejjet, u xejn ma ġie mitlub jew mibdul.
Oħloq kodiċi ġdid mit-terminal li għandu aċċess għall-cluster:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleDan jistampa kodiċi frisk u l-marka tas-swaba' (fingerprint) tal-installazzjoni. Daħħal il-kodiċi fuq il-paġna tat-talba fi żmien 30 minuta u erġa' qabbel il-marka tas-swaba'.
Żewġ tweġibiet relatati:
RATE_LIMITED(429) fuq il-paġna tat-talba jfisser li l-paġna kellha diversi tentattivi fl-aħħar minuta. Stenna n-numru ta' sekondi li tagħti. Jekk m'għamiltx dawk it-tentattivi int, xi ħadd ieħor fuq in-netwerk tiegħek qed jipprova l-paġna; skopri min hu qabel ma titlob is-sjieda.TRANSITION_NOT_PERMITTED(409) ifisser li l-installazzjoni diġà ntalbet, u l-paġna tat-talba tagħha hija mitfija għal kollox. Iffirma minflok. Jekk ma tlabthiex int, ittratta dan bħala inċident ta' sigurtà.
Il-marka tas-swaba' ma taqbilx
Il-paġna tat-talba turi CLAIM_FINGERPRINT_MISMATCH (403), jew tista' tara b'għajnejk stess li t-tmien gruppi ta' erbgħa fuq il-paġna huma differenti minn dawk li stampa t-terminal tiegħek. Anke grupp wieħed differenti jfisser li l-browser qed ikellem installazzjoni differenti.
Ieqaf. Tittajpjax il-kodiċi f'dik il-paġna. Xi ħaġa oħra għajr l-installazzjoni tiegħek tista' tkun qed twieġeb f'dak l-indirizz, possibilment magna mwaqqfa biex taqbad l-ewwel amministratur. Kieku tlabtha, dik il-magna kien ikollha l-organizzazzjoni tiegħek. L-installazzjoni tiegħek stess mhix mibdula u għadha mhux mitluba.
Iċċekkja fejn jipponta l-isem u liema ċertifikat wieġeb:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleL-indirizz għandu jkun tal-ingress controller tiegħek, u ċ-ċertifikat għandu jkun dak li installajt għal hosts.console.
Biex tirranġaha, agħti lit-tim tas-sigurtà tiegħek l-indirizz li wieġeb u żomm il-log tal-installazzjoni, li jirreġistra l-marka tas-swaba' li stampat l-installazzjoni. Ikkoreġi r-rekord tad-Domain Name System (DNS) jew il-proxy li bagħtek x'imkien ieħor. Imbagħad oħloq kodiċi ta' talba ġdid bi nexusctl claim-code --administrator <email> u itlob minn browser fuq netwerk li tafda, filwaqt li terġa' tqabbel it-tmien gruppi kollha.
Il-liċenzja hija rrifjutata
L-importazzjoni fuq Import the licence, Import a new licence jew nexusctl licence import twieġeb b'rifjut. Importazzjoni rrifjutata ma tibdel xejn: il-liċenzja fis-seħħ tibqa' fis-seħħ, u l-bażi tal-arloġġ (clock floor) ma tiċċaqlaqx.
Aqra l-kodiċi u l-pass:
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.jsonIl-korp tar-rifjut iġorr code, message, refused_at (il-pass li falla) u troubleshooting. Biex tara l-istat tal-liċenzja fis-seħħ, aqra GET https://auth.harrow.example/api/v1/installation/licence/state bl-istess token.
| Kodiċi | HTTP | Kawża tas-soltu | Soluzzjoni |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Il-fajl ġie editjat, ifformattjat mill-ġdid jew issejvjat mill-ġdid, jew firma waħda hija nieqsa | Erġa' niżżlu mill-kont tiegħek u importah mingħajr ma tmissu |
LICENCE_FORMAT_INVALID |
422 | Mhux liċenzja: fajl ħażin, maqtugħ, jew imgeżwer f'oġġett ieħor | Ibgħat il-fajl eżatt kif tahulek Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Iffirmat b'ċavetta li dan ir-rilaxx ma jġorrx | Aġġorna, jew itlob liċenzja ffirmata għar-rilaxx tiegħek |
LICENCE_MATRIX_MISMATCH |
422 | Miktub għal matriċi ta' edizzjoni aktar ġdida, jew jagħti grupp li dan il-build ma jafx bih | Aġġorna, jew itlob liċenzja miktuba għar-rilaxx tiegħek |
LICENCE_OTHER_INSTALLATION |
409 | Maħruġ għal installazzjoni oħra, ħafna drabi l-liċenzja tat-test cluster fuq il-produzzjoni | Itlob liċenzja għall-identità ta' din l-installazzjoni |
LICENCE_REVOKED |
403 | Adverant irtiratha | Itlob liċenzja ġdida mingħand Adverant |
LICENCE_LOCKED |
403 | Il-starts_on tagħha huwa wara d-data kurrenti |
Importaha fl-ewwel jum tagħha jew wara |
TRANSITION_NOT_PERMITTED |
409 | Din l-id tal-liċenzja diġà ġiet importata | M'hemm xejn x'tagħmel jekk tkun fis-seħħ; staqsi lil Adverant jekk it-termini jridux jinbidlu |
RECORD_NOT_FOUND |
404 | L-installazzjoni għadha ma ġietx iddikjarata, għalhekk għad m'għandhiex identità | Lesti l-pass tal-ewwel amministratur, imbagħad importa |
TENANT_NOT_A_PARAMETER |
403 | Il-korp isemmi organizzazzjoni fl-ogħla livell tiegħu | Ibgħat il-fajl tal-liċenzja waħdu bħala l-korp |
Żewġ affarijiet jidhru bħala problemi tal-liċenzja u mhumiex. Qari tal-istat li jġorr LICENCE_CLOCK_BEHIND_FLOOR ifisser li l-arloġġ tan-node jaqra qabel l-aħħar ħin li rat l-installazzjoni; irranġa l-ħin tan-node, u jekk l-arloġġ kien mar 'il quddiem u ġarr il-bażi (floor) miegħu, itlob token ta' reset tal-ħin mingħand Adverant. U liċenzja li tiġi importata u xorta turi grupp bħala teaser normalment ma tagħtix dak il-grupp: aqra l-għotjiet (grants) fuq il-paġna tal-liċenzja qabel kull ħaġa oħra.
L-ebda tweġiba mill-IA
L-assistent tal-intelliġenza artifiċjali (IA) juri MODEL_NOT_CONNECTED (503), pass tal-workflow jfalli bi NO_PROVIDER_FOR_ROLE (422), jew it-tweġibiet sempliċement jieqfu.
Il-pool tal-organizzazzjoni m'għandu l-ebda ċavetta li tista' twieġeb, jew ir-router ma jistax jilħaq il-fornitur. Kull organizzazzjoni ġġib iċ-ċavetta tal-mudell tagħha stess. Mingħajr l-ebda ċavetta fl-użu m'hemm l-ebda IA, b'disinn, u l-ebda ċavetta kondiviża ma timla l-vojt.
Iċċekkja l-pool u l-għażla tar-router, kull wieħed bit-token ta' aċċess tal-persuna stess:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
L-ewwel wieħed jelenka kull fornitur, jekk jistax iwieġeb u għaliex le ("No key in use: 1 withdrawn, 1 lapsed"), u l-istat ta' kull ċavetta. It-tieni wieħed iwieġeb bil-mudell li r-router kien juża għall-organizzazzjoni, jew ir-rifjut tiegħu fi kliem. Imbagħad iċċekkja l-mogħdija 'l barra mill-cluster b'dawn iż-żewġ kmandi:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayXi tfisser kull sejba:
| Issib | Soluzzjoni |
|---|---|
| L-ebda ċavetta fil-pool | Sid jew amministratur iżid ċavetta tal-organizzazzjoni fuq is-switchboard tal-IA jew Settings, AI models |
Ċwievet invalid, expired jew exhausted |
Żid ċavetta friska; il-qadima tibqa' elenkata bħala storja |
Ċwievet resting |
Stenna: ċavetta li tfalli tistrieħ għal 60 sekonda, u wara 5 fallimenti wara xulxin tintefa (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE bi ċwievet fl-użu |
Ir-rwol m'għandu l-ebda assenjazzjoni u xejn ma jaqbel; issettja r-rwol fil-politika tar-routing |
MODEL_CAPABILITY_UNAVAILABLE (422) |
It-talba teħtieġ kapaċità, jew residenza, li l-ebda fornitur fil-pool ma joffri; ippermetti wieħed li joffriha |
L-ebda politika nexus-operator-egress, jew il-firxiet (ranges) tal-fornitur huma nieqsa minnha |
Żid il-firxiet, miktuba fin-notazzjoni Classless Inter-Domain Routing (CIDR), ma' networkPolicy.externalEgressCIDRs u aġġorna |
| Server ta' mudell lokali li ma jweġibx | Iċċekkja ai.localProvider.baseUrl, elenka s-server f'ai.installationHosts, u ħalli l-firxa tiegħu f'networkPolicy.externalEgressCIDRs |
Ċavetta ta' fornitur ospitat li taħdem minn laptop u tfalli fuq l-installazzjoni hija kważi dejjem il-politika tan-netwerk. In-namespace jiċħad il-ħruġ (egress) b'mod awtomatiku.
Tweġibiet 429
Klijent jitwieġeb 429 Too Many Requests. Nexus għandu erba' postijiet li jistgħu jgħiduha, u l-korp jgħidlek liema.
| Fejn | Kodiċi u dettall | X'għandek tibdel |
|---|---|---|
| nexus-auth, għal kull persuna ffirmata | RATE_LIMITED bi limit, windowSeconds u retryAfterSeconds |
auth.rateLimitPerMinute (default 5000), għal awtomazzjoni tqila |
| Limitu ta' ċavetta ta' skript, app jew unità (Enterprise) | RATE_LIMITED li jsemmi ċ-ċavetta u l-limitu tagħha |
Il-limitu fuq Settings, Rate limits, b'raġuni |
| Il-paġna tat-talba tal-ewwel tħaddim | RATE_LIMITED bi retry_after_seconds |
Xejn: stenna, u skopri min ieħor qed jipprova l-paġna |
| Fornitur ta' mudell | Ir-router jittrattaha bħala falliment temporanju u jgħaddi għall-fornitur li jmiss | Żid ċavetta jew fornitur ieħor jekk jiġri spiss |
Kull wieħed iġorr header Retry-After. Klijent li jġib ruħu tajjeb jistenna dak il-ħin u ma jerġax jipprova qabel.
Jekk kull utent f'daqqa jidher li qed jaqsam limitu wieħed, iċċekkja proxy.trustedCIDRs. Meta ma jkoprix in-netwerk tal-pods tal-ingress controller tiegħek, nexus-auth ma jistax jemmen il-header X-Forwarded-For u jara kull talba bħala li ġejja mill-controller. Id-default, 10.42.0.0/16, joqgħod biss għal k3s.
kubectl get pods -A -o wideSib l-indirizz tal-pod tal-ingress controller fl-output u kun żgur li proxy.trustedCIDRs ikoprih.
Żbalji fl-aġġornament
L-aġġornament reġa' lura (rolled back). Il-paġna Upgrade turi UPGRADE_ROLLED_BACK: pass falla, kull magna reġgħet lura fuq ir-rilaxx preċedenti, u d-data ma nbidlitx. Il-paġna ssemmi l-pass. Wieħed komuni huwa volum żgħir wisq għat-tqassim il-ġdid ta' maħżen. Irranġa dak li ssemmi, erġa' ħaddem nexusctl upgrade plan --bundle <file>, imbagħad applika. Il-backup jerġa' jittieħed l-ewwel.
Iċ-chart tirrifjuta li tirrendi bi EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Is-Secret nexus-generated iżomm EXTERNAL_KEY_ENCRYPTION_KEY f'forma li ċ-chart ma tistax tuża. Irid ikun base64 ta' 32 byte, jew iċ-ċavetta mhux ipproċessata ta' 32 byte ta' installazzjoni eqdem. Xi ħadd editja jew biddel is-Secret. Erġa' poġġi ċ-ċavetta li d-data ta' din l-installazzjoni hija ssiġillata taħtha, bħala base64 tat-32 byte tagħha (printf %s "$OLD" | base64), u erġa' aġġorna. Tħallix iċ-chart tagħmel waħda ġdida: id-data ssiġillata taħt iċ-ċavetta l-qadima tibqa' ma tistax tinqara.
L-iskripts jiġu rrifjutati bi TOKEN_ORG_MISSING wara l-aġġornament. Kull servizz li jiċċekkja ċ-ċwievet tal-application programming interface (API) permezz ta' nexus-auth issa jirrifjuta ċavetta mingħajr organizzazzjoni, bi 403 TOKEN_ORG_MISSING. Agħti organizzazzjoni lil kull ċavetta bħal din, jew oħroġ ċavetta ġdida.
Iċ-ċwievet jirrapportaw l-applikazzjoni ħażina għal siegħa. Battal l-entrati taċ-ċwievet fil-cache ta' nexus-auth, il-maħżen Valkey tal-installazzjoni. Kapitlu 2.15, It-tieni jum: it-tħaddim ta' Nexus, għandu l-kmand, għall-maħżen fil-cluster u għal wieħed estern.
Migration hook falla. helm upgrade jirrapporta pre-upgrade hook li falla. L-iskema tiċċaqlaq qabel ma jidħlu l-pods il-ġodda, għalhekk ir-rilaxx li qed jaħdem għadu qed iservi. Aqra l-log tal-Job bi kubectl -n nexus logs job/<job-name>, irranġa dak li jsemmi u erġa' ħaddem l-aġġornament.
Is-servizzi ma setgħux jużaw it-tabelli tagħhom għal ftit sekondi. Fl-ewwel aġġornament ta' installazzjoni magħmula minn chart preċedenti, kull servizz jitlef id-drittijiet default qodma tat-tabella tiegħu u jieħu tiegħu stess lura mill-migrazzjoni tiegħu stess. Id-distakk huwa ta' sekondi. Aġġorna f'perjodu kwiet, jew naqqas l-iskala tas-servizzi għal żero l-ewwel.
Ir-rilaxx fuq id-diska ġie rrifjutat. Import from media juri MEDIA_SIGNATURE_INVALID (422): il-fajls mhumiex iffirmati biċ-ċavetta tar-rilaxx installata fuq din l-installazzjoni. Xejn ma tgħabba u r-rilaxx li qed jaħdem jibqa' jaħdem. Żomm il-midja għat-tim tas-sigurtà tiegħek u itlob midja ġdida mingħand Adverant permezz tal-iskambju offline.
Rifjut ta' rendering taċ-chart
helm install, helm upgrade jew helm template jieqaf qabel ma jiġi applikat xi ħaġa, b'messaġġ li jibda b'kodiċi jew isemmi valur. Iċ-chart tirrifjuta valuri li ma tistax tħaddem b'mod sigur. Xejn fuq il-cluster ma nbidel.
Irrendi ċ-chart waħedha biex tara kull rifjut mingħajr ma tmiss il-cluster. Uża ċ-chart Enterprise li niżżilt minflok l-indirizz oci:// fuq Enterprise, u ssettja networkPolicy.apiServerCIDRs fil-valuri, għax render offline ma jistax jaqrah mill-cluster:
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.yamlIl-preflight jiċċekkja l-istess valuri tal-identità fit-taqsima tiegħu "time and keys" u jirrapporta l-istess kodiċijiet. L-exit tiegħu huwa 0 meta l-installazzjoni tista' tibqa' sejra (it-twissijiet ma jimblokkawx), 1 meta mill-inqas kontroll wieħed falla, u 2 meta ma setax jaħdem.
| Rifjut | Kawża | Soluzzjoni |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName huwa vojt |
Issettjah għall-isem ta' din l-installazzjoni stess, li jaqbel ma' ^[a-z][a-z0-9-]{0,62}$. Huwa permanenti ladarba l-maħżen taċ-ċwievet jibda għall-ewwel darba |
INSTALLATION_NAME_EXAMPLE |
L-isem huwa dak fil-fajls tal-valuri ta' eżempju taċ-chart | Issettja l-isem tiegħek stess |
keys.installationName "…" does not match … |
Ittri kbar, underscores jew ċifra fil-bidu | Uża ittri żgħar, ċifri u singijiet, billi tibda b'ittra |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients huwa vojt |
Elenka r-riċevituri age tal-kustodji tiegħek, in-nofsijiet pubbliċi |
KEYS_CUSTODIAN_EXAMPLE |
Riċevitur huwa l-kustodju ta' eżempju mill-fajls tal-valuri taċ-chart, li l-identità tiegħu ħadd ma jżommha | Ibdlu bir-riċevituri tal-kustodji tiegħek stess |
keys.custody.recipients: … |
Riċevitur f'forma li l-Job tal-kustodja ma jistax jikkriptja għaliha | Uża age1…, age1tag1…, age1tagpq1…, age1pq1… jew age1se1…, b'ittri żgħar |
NEXUS_EDITION_INVALID |
edition la huwa community u lanqas enterprise |
Issettja wieħed mit-tnejn |
edition=… but enterprise.enabled=… |
It-tnejn ma jaqblux | Issettja enterprise.enabled: true eżattament meta edition ikun enterprise |
global.imageRegistry is required |
L-ebda reġistru msemmi | Issettja r-reġistru li n-nodes tiegħek jiġbdu l-immaġnijiet minnu |
hosts.<name> is required |
Host pubbliku huwa nieqes | Issettja hosts.console, hosts.api u hosts.auth |
tls.existingSecret is required when tls.mode is existing |
L-ebda Secret taċ-ċertifikat imsemmi | Semmi s-Secret, jew agħżel tls.mode ieħor |
tls.clusterIssuer is required when tls.mode is cert-manager |
L-ebda emittent imsemmi | Semmi l-ClusterIssuer tiegħek |
dataTier.<store>.external.host is required when mode is external |
Maħżen estern mingħajr indirizz | Agħti l-host tiegħu, u s-Secret tiegħu f'existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
helm template m'għandu l-ebda cluster fejn ifittixhom |
Agħti l-indirizzi tas-server tal-API bħala firxiet /32 |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
Iċ-ċavetta ġġenerata f'nexus-generated għandha l-forma ħażina |
Ara "Upgrade errors" hawn fuq |
Fajl tal-valuri li juża ċavetta li ċ-chart m'għandhiex, jew valur tat-tip ħażin, jiġi rrifjutat mill-iskema taċ-chart qabel kwalunkwe waħda minn dawn. telemetry.enabled: true huwa eżempju wieħed: l-iskema taċċetta biss false.
Kif tibgħat pakkett ta' appoġġ
Meta xejn minn dan ma jirranġaha, ibgħat support bundle lil Adverant mat-talba ta' appoġġ tiegħek.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number> huwa n-numru tat-talba li ftaħt fuq il-paġna Support and support bundles tal-kont tiegħek. Tista' tagħmel l-istess bundle mill-paġna Support bundle tal-console taħt This installation.
Il-bundle jżomm logs tal-magni mill-aħħar 24 siegħa, dettalji tas-saħħa u tal-verżjoni, settings mingħajr is-sigrieti tagħhom, u r-rapporti tal-preflight u tal-installazzjoni. Qabel ma jinkiteb, it-tħassir (redaction) jibdel l-ismijiet, is-sigrieti u l-indirizzi, u int taqra preview ta' eżattament x'inhu ħiereġ. Il-messaġġi, il-fajls u l-memorja tan-nies qatt ma jinġabru.
Tella' l-bundle fuq it-talba fil-kont tiegħek, jew issejvjah fuq midja u oħorġu jekk l-installazzjoni m'għandhiex konnessjoni ma' barra. L-inġiniera tal-appoġġ imsemmija fuq it-talba biss jistgħu jiftħuh, u jitħassar wara 30 jum. Għid fit-talba liema mill-problemi t'hawn fuq kont qed tħares lejha, u x'urew il-kontrolli f'dan il-kapitlu: dan jiffranka l-ħin.


