IdħolIbbukkja laqgħa informattiva

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ż

22 minuti qari

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:

  1. 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.
  2. Erġa' ħaddem nexusctl preflight wara 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.
  3. Uża --explain fuq kwalunkwe verb ta' nexusctl li m'intix ċert minnu. Dan jistampa l-operazzjonijiet ta' kubectl u helm mingħ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.

Sekwenza vertikali ta' kaxxi magħquda bi vleġeġ 'l isfel: "Release resources created (Deployments start, each held by its wait-for-schema init container)", imbagħad "Database bootstrap hook: database, roles, release ledger", imbagħad "Migration hooks, one per service, in a fixed order", imbagħad "Each hook writes its row in the release ledger". Mill-aħħar kaxxa, il-vleġeġ jinfirxu lejn il-ġenb għal tliet kaxxi żgħar "nexus-auth starts", "nexus-gateway starts", "other services start". Nota fil-ġenb ħdejn il-kaxxa ta' fuq, bi vleġġa maqtugħa sal-qiegħ: "helm install --wait waits here for Deployments that are waiting for the hooks".
X'jaħdem, fl-ordni, meta ċ-chart tiġi installata jew aġġornata.

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

describe 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.imageRegistry u, għal Enterprise, il-pull token mill-paġna Pull tokens and install commands tal-kont tiegħek.
  • Għal volumi Pending, issettja storage.className għ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-schema

Il-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 ingress

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

Dan 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'.

Itlob din l-installazzjoni
Itlob din l-installazzjoni
Claim this installation. Il-kodiċi mit-terminal jidħol fi tliet gruppi, u l-paġna turi l-marka tas-swaba' sħiħa fi gruppi ta' erbgħa biex tqabbilhom; kodiċi skadut jiġi rrifjutat bi CLAIM_CODE_EXPIRED u xejn ma jiġi mitlub.

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

L-indirizz għandu jkun tal-ingress controller tiegħek, u ċ-ċertifikat għandu jkun dak li installajt għal hosts.console.

Il-marka tas-swaba' diġitali ma taqbilx
Il-marka tas-swaba' diġitali ma taqbilx
Il-marki tas-swaba' huma differenti fi tlieta minn tmien gruppi. Il-paġna tgħidlek biex tieqaf, tispjega min jista' jkun qed iwieġeb, u telenka x'għandek tiċċekkja qabel ma terġa' tipprova.

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

Il-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-gateway

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

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

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

Il-preflight ma jistax ikompli
Il-preflight ma jistax ikompli
Il-preflight ma jistax ikompli. Il-kontrolli li fallew jiġu l-ewwel, kull wieħed bis-soluzzjoni tiegħu, u l-installazzjoni tibqa' mblukkata bi PREFLIGHT_FAILED sakemm jgħaddu.
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.