Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.17
Zgjidhja e problemeve
Problemet që operatorët hasin më shpesh, të organizuara sipas asaj që shihni. Secili jep shkakun, komandën që e konfirmon atë dhe zgjidhjen, dhe kapitulli përfundon me dërgimin e një pakete mbështetjeje.
Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

Shumica e problemeve që ndodhin në një instalim të Nexus ndodhin në të njëjtat dymbëdhjetë mënyra, dhe pothuajse të gjitha lajmërohen me një kod. Ky kapitull është i organizuar sipas asaj që shihni, përafërsisht në rendin që do të hasnit secilin problem: instalimi, marrja në pronësi, licencimi dhe më pas ekzekutimi. Për secilin prej tyre merrni shkakun, një komandë që e konfirmon atë dhe zgjidhjen.
Shembujt përdorin instalimin e Harrow Port Authority: hapësirën e emrave nexus, lëshimin nexus, hostet console.harrow.example, api.harrow.example dhe auth.harrow.example. Zëvendësojini ato me tuajat. Tre zakone kursejnë kohë me çdo problem këtu:
- Lexoni kodin përpara mesazhit. Çdo refuzim në Nexus përfundon me një kod makine, dhe kodi është ai sipas të cilit është indeksuar ky kapitull.
- Ekzekutoni
nexusctl preflightpërsëri pas çdo ndryshimi në klaster ose në skedarin e vlerave. Ai lexon klasterin pa e ndryshuar atë dhe raporton shumicën e refuzimeve të chart-it me emër përpara se ta bëjë Helm. - Përdorni
--explainnë çdo foljenexusctlpër të cilën nuk jeni të sigurt. Ai printon veprimetkubectldhehelmpa i ekzekutuar ato.
Instalimi ngec
Keni ekzekutuar instalimin dhe nuk ka përfunduar. helm nuk është përgjigjur pas pesëmbëdhjetë minutash, ose është përgjigjur dhe pod-et janë ende në Init ose Pending, ose adresa e konsolës nuk përgjigjet.
Shkaku më i zakonshëm është helm install --wait. Nexus krijon bazën e tij të të dhënave, rolet e tij dhe skemën e çdo shërbimi në hook-et pas instalimit, dhe hook-u i bootstrap-it është ai që i jep çdo shërbimi fjalëkalimin e bazës së të dhënave. Me --wait, Helm pret që Deployments të jenë gati përpara se të ekzekutojë ato hook-e, ndërsa Deployments presin për hook-et. Asnjëra nuk lëviz. Mos instaloni kurrë me --wait; instaloni pa të dhe prisni më pas.
Shkaqet e tjera janë të zakonshme për Kubernetes. Imazhet nuk mund të tërhiqen sepse global.imageRegistry emërton regjistrin e gabuar, ose një instalim Enterprise nuk ka token tërheqjeje. Një volum mbetet Pending sepse klasa e ruajtjes nuk ekziston. Mungon cert-manager, rast në të cilin instalimi nuk bllokohet fare: ai dështon brenda sekondave, sepse lëshuesit e certifikatave të chart-it kanë nevojë për burimet e cert-manager.
Filloni me pod-et dhe Jobs të hook-eve:
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 tregon gabimet e tërheqjes së imazheve dhe volumet e palidhura në ngjarjet e tij. Një Job i hook-ut që tregon 0/1 përfundime me një pod të dështuar e ka ndaluar instalimin, sepse Jobs të hook-ut kanë një kufi przmbrapsjeje (backoff limit) prej 0 dhe nuk provohen kurrë përsëri në heshtje. Regjistri (log) i tij tregon pse.
Ja se si të rregulloni secilin shkak:
- Nëse Helm po pret me
--wait, ndalojeni, çinstalojeni dhe instalojeni përsëri pa flamurin (flag). Më pas prisni për shërbimet:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Për gabimet e tërheqjes, kontrolloni
global.imageRegistrydhe, për Enterprise, tokenin e tërheqjes nga faqja e tokeneve të tërheqjes dhe komandave të instalimit të llogarisë suaj. - Për volumet
Pending, vendosnistorage.classNamenë një klasë ruajtjeje që klasteri e ka, ose bëjeni një të tillë si parazgjedhje. - Për mungesën e cert-manager, instaloni cert-manager v1.21.3 dhe ekzekutoni instalimin përsëri.
- Për një hook të dështuar, rregulloni atë që përmend regjistri i tij dhe ekzekutoni instalimin përsëri.
Një pod pret skemën e tij
Pod-i i një shërbimi qëndron në Init:0/1 për minuta të tëra. Çdo shërbim që përdor bazën e të dhënave ka një kontejner init, wait-for-schema, që e mban pod-in derisa regjistri i lëshimeve (release ledger) të tregojë migrimet e tij të aplikuara për imazhin e këtij lëshimi. Kjo është normale për minutat e para të një instalimi ose përditësimi, ndërsa ekzekutohen hook-et e migrimit. Është problem kur nuk përfundon.
Lexoni regjistrin e kontejnerit init:
kubectl -n nexus logs <pod-name> -c wait-for-schemaRegjistri emërton komponentin, zinxhirët e migrimit që pret dhe kufirin e tij kohor, më pas printon një rresht sa herë që gjendja e tij ndryshon:
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
| Rreshti i ecurisë thotë | Çfarë do të thotë |
|---|---|
| Cilët zinxhirë duhet të aplikohen ende për këtë lëshim | Hook-et e emërtuara të migrimit nuk kanë përfunduar. Shikoni ato Jobs. |
| Që regjistri i lëshimeve nuk mund të lexohet, me gabimin e bazës së të dhënave | Postgres nuk po përgjigjet, ose regjistri nuk ekziston sepse bootstrap-i i bazës së të dhënave nuk është ekzekutuar. |
FAILED (<component>): after <n>s, … |
Ai hoqi dorë pas schemaWait.timeoutSeconds (1,800 si parazgjedhje). Kontejneri init riniset; vetë shërbimi nuk filloi kurrë. |
Një zinxhir që nuk aplikohet kurrë pothuajse gjithmonë do të thotë se Job-i i migrimit të tij dështoi. Gjejeni atë me kubectl -n nexus get jobs dhe lexoni regjistrin e tij. Rregulloni atë që emërton (një disk i mbushur, një bazë të dhënash e jashtme që migratori nuk mund ta arrijë, një konflikt rolesh) dhe ekzekutoni helm upgrade me të njëjtat vlera: hook-et ekzekutohen përsëri, dhe secili prej tyre është i sigurt për t'u riekzekutuar.
Rrisni schemaWait.timeoutSeconds vetëm kur një migrim është i ngadaltë dhe i shëndetshëm, siç mund të jetë një migrim i parë i madh në një ruajtje të ngadaltë. Rritja e tij për të fshehur një Job të dështuar thjesht e bën pod-in të presë më gjatë për diçka që nuk do të vijë kurrë.
Ruajtësja e çelësave është e vulosur
Pas një ndërprerjeje të energjisë, një rinisjeje të nyjës (node) ose një rinisjeje të runtime-it të kontejnerit, pod-et kthehen dhe konsola ngarkohet, dhe çdo gjë që ka nevojë për një çelës dështon ose pret. Unsealer-i fillon i vulosur (sealed) pas çdo rinisjeje të nyjës së tij, dhe depoja e çelësave nuk mund të çvuloset (unseal) vetë derisa unsealer-i të jetë i hapur.
Pyesni OpenBao në secilin 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 $?"Dalja 0 është e çvulosur, 2 është e vulosur, dhe 1 do të thotë se nuk mund të përgjigjej (pyesni përsëri pas një minute). Ekzekutoni të njëjtën gjë kundrejt openbao-0 me -tls-server-name=openbao për depon e çelësave. Nëse unsealer-i është i çvulosur dhe depoja e çelësave nuk është, depoja e çelësave po çvuloset vetë; jepini një minutë.
Për të rregulluar një unsealer të vulosur, një kujdestar (custodian) ekzekuton unseal.sh të chart-it me identitetin e tij age. Kapitulli 2.15, Dita e dytë: operimi i Nexus, ka komandën e plotë. Dalja e skriptit ju tregon se çfarë ndodhi:
| Dalja | Kuptimi | Çfarë duhet të bëni |
|---|---|---|
| 0 | I çvulosur | Kontrolloni kubectl -n nexus get deploy,statefulset brenda një minute. |
| 1 | Ende i vulosur, ose një thirrje çvulosjeje dështoi | Lexoni rreshtat e pjesëve (shares) që printoi; ekzekutojeni përsëri. |
| 2 | Mungon një parakusht | Mesazhi e emërton atë: AGE_IDENTITY, një binar si age ose jq, ose një cilësim i mënyrës së drejtpërdrejtë. |
| 3 | Ky identitet nuk mund t'i deshifrojë pjesët | Ju nuk jeni kujdestar i këtij instalimi. Asgjë nuk u dërgua. Gjeni një kujdestar që është. |
Nuk mund të identifikoheni përmes HTTP
Konsola ngarkohet në një adresë http://, ose përmes një kubectl port-forward në 127.0.0.1, dhe identifikimi dështon. Kërkesa për çelës kalimi (passkey) nuk shfaqet kurrë, ose identifikimi kthehet përsëri në fillim.
Identifikimi ka nevojë për origjinën e vet HTTPS të konsolës. Konsola pranon një identifikim vetëm nga https://<hosts.console>, e mban sesionin në një cookie __Host- të shënuar si Secure (të cilën një shfletues e ruan vetëm përmes HTTPS), dhe çelësi i kalimit i administratorit të parë ka nevojë për një faqe me një certifikatë të vlefshme. Shfletuesit refuzojnë çelësat e kalimit pas një gabimi certifikate. Një port-forward në http://127.0.0.1 nuk mund të identifikohet kurrë.
Kontrolloni se çfarë arriti në të vërtetë shfletuesi:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressE para duhet të përgjigjet përmes HTTPS me një certifikatë që makina juaj i beson. E dyta duhet të tregojë tre hostet me emrat që keni vendosur në hosts.*.
Për ta rregulluar atë, arrini konsolën në https://console.harrow.example, emrin e saktë në hosts.console, me një certifikatë që shfletuesi i beson. Me tls.mode: existing, kontrolloni që tls.existingSecret mban një certifikatë për të tre hostet. Me tls.mode: cert-manager, kontrolloni që ClusterIssuer e ka lëshuar atë. Me tls.mode: none, Transport Layer Security (TLS) përfundon në balancuesin tuaj të ngarkesës (load balancer), dhe aty duhet të jetë e saktë certifikata. Për një autoritet certifikimi privat, instaloni certifikatën e tij në makinat nga të cilat identifikohen administratorët tuaj.
Kodi i marrjes në pronësi ka skaduar
Në Merrni në pronësi këtë instalim, faqja refuzon kodin me CLAIM_CODE_EXPIRED (410). Një kod marrjeje në pronësi përbëhet nga tre grupe me nga katër karaktere. Ai funksionon një herë, për 30 minuta, me 5 prova. Pas kësaj, ose pas provës së pestë të gabuar, ai është i pavlefshëm, dhe asgjë nuk u mor në pronësi apo u ndryshua.
Krijoni një kod të ri nga terminali që ka qasje në klaster:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleAi printon një kod të ri dhe gjurmën dixhitale (fingerprint) të instalimit. Vendosni kodin në faqen e marrjes në pronësi brenda 30 minutave dhe krahasoni përsëri gjurmën dixhitale.
Dy përgjigje të lidhura:
RATE_LIMITED(429) në faqen e marrjes në pronësi do të thotë se faqja ka pasur disa tentativa në minutën e fundit. Prisni numrin e sekondave që jep. Nëse nuk i keni bërë ju ato tentativa, dikush tjetër në rrjetin tuaj po provon faqen; zbuloni se kush është përpara se ta merrni në pronësi.TRANSITION_NOT_PERMITTED(409) do të thotë se instalimi është marrë tashmë në pronësi, dhe faqja e tij e marrjes në pronësi është e çaktivizuar përgjithmonë. Në vend të kësaj, identifikohuni. Nëse nuk e keni marrë ju në pronësi, trajtojeni këtë si një incident sigurie.
Gjurma dixhitale nuk përputhet
Faqja e marrjes në pronësi tregon CLAIM_FINGERPRINT_MISMATCH (403), ose mund të shihni vetë se tetë grupet me nga katër në faqe ndryshojnë nga ato që printoi terminali juaj. Edhe një grup i vetëm i ndryshëm do të thotë se shfletuesi po komunikon me një instalim tjetër.
Ndaloni. Mos e shkruani kodin në atë faqe. Diçka tjetër përveç instalimit tuaj mund të jetë duke u përgjigjur në atë adresë, ndoshta një makinë e ngritur për të kapur administratorin e parë. Nëse do ta merrnit në pronësi, ajo makinë do të mbante organizatën tuaj. Instalimi juaj është i pandryshuar dhe ende i pamarrë në pronësi.
Kontrolloni se ku tregon emri dhe cila certifikatë u përgjigj:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleAdresa duhet të jetë e kontrolluesit tuaj ingress, dhe certifikata duhet të jetë ajo që keni instaluar për hosts.console.
Për ta rregulluar atë, jepini ekipit tuaj të sigurisë adresën që u përgjigj dhe mbani regjistrin e instalimit, i cili regjistron gjurmën dixhitale që printoi instalimi. Korrigjoni rekordin e Domain Name System (DNS) ose proxy-n që ju dërgoi diku tjetër. Më pas krijoni një kod të ri marrjeje në pronësi me nexusctl claim-code --administrator <email> dhe merrni në pronësi nga një shfletues në një rrjet që i besoni, duke krahasuar përsëri të tetë grupet.
Licenca refuzohet
Importimi në Importo licencën, Importo një licencë të re ose nexusctl licence import përgjigjet me një refuzim. Një importim i refuzuar nuk ndryshon asgjë: licenca në fuqi mbetet në fuqi, dhe kufiri i poshtëm i orës (clock floor) nuk lëviz.
Lexoni kodin dhe hapin:
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.jsonTrupi i refuzimit përmban code, message, refused_at (hapin që dështoi) dhe troubleshooting. Për të parë gjendjen e licencës në fuqi, lexoni GET https://auth.harrow.example/api/v1/installation/licence/state me të njëjtin token.
| Kodi | HTTP | Shkaku i zakonshëm | Zgjidhja |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Skedari u modifikua, u riformatua ose u ruajt përsëri, ose mungon një nënshkrim | Shkarkojeni përsëri nga llogaria juaj dhe importojeni të paprekur |
LICENCE_FORMAT_INVALID |
422 | Nuk është licencë: skedar i gabuar, i cunguar ose i mbështjellë në një objekt tjetër | Dërgoni skedarin saktësisht siç e ka dhënë Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Nënshkruar me një çelës që ky lëshim nuk e mbart | Përditësoni, ose kërkoni një licencë të nënshkruar për lëshimin tuaj |
LICENCE_MATRIX_MISMATCH |
422 | Shkruar për një matricë edicioni më të re, ose jep një grup që ky ndërtim (build) nuk e njeh | Përditësoni, ose kërkoni një licencë të shkruar kundrejt lëshimit tuaj |
LICENCE_OTHER_INSTALLATION |
409 | Lëshuar për një instalim tjetër, shpesh licenca e klasterit të testimit në prodhim | Kërkoni një licencë për identitetin e këtij instalimi |
LICENCE_REVOKED |
403 | Adverant e tërhoqi atë | Kërkojini Adverant një licencë të re |
LICENCE_LOCKED |
403 | starts_on e saj është pas datës aktuale |
Importojeni atë në ose pas ditës së saj të parë |
TRANSITION_NOT_PERMITTED |
409 | Kjo ID licence është importuar tashmë | Asgjë për të bërë nëse është në fuqi; pyesni Adverant nëse kushtet duhet të ndryshojnë |
RECORD_NOT_FOUND |
404 | Instalimi nuk është deklaruar, kështu që nuk ka ende identitet | Përfundoni hapin e administratorit të parë, më pas importoni |
TENANT_NOT_A_PARAMETER |
403 | Trupi emërton një organizatë në nivelin e tij më të lartë | Dërgoni vetëm skedarin e licencës si trup |
Dy gjëra duken si probleme licence por nuk janë. Një lexim i gjendjes që mbart LICENCE_CLOCK_BEHIND_FLOOR do të thotë se ora e nyjës tregon më herët se koha e fundit që ka parë instalimi; rregulloni orën e nyjës, dhe nëse ora kishte ecur përpara dhe kishte marrë kufirin e poshtëm me vete, kërkojini Adverant një token për rivendosjen e kohës. Dhe një licencë që importohet dhe ende tregon një grup si pamje paraprake (teaser) zakonisht nuk e jep atë grup: lexoni të drejtat e dhëna (grants) në faqen e licencës përpara çdo gjëje tjetër.
Nuk ka përgjigje nga AI
Asistenti i inteligjencës artificiale (AI) tregon MODEL_NOT_CONNECTED (503), një hap i rrjedhës së punës dështon me NO_PROVIDER_FOR_ROLE (422), ose përgjigjet thjesht ndalojnë.
Grupi (pool) i organizatës nuk ka asnjë çelës që mund të përgjigjet, ose ruteri nuk mund të arrijë ofruesin. Çdo organizatë sjell çelësin e vet të modelit. Pa asnjë çelës në përdorim nuk ka AI, sipas dizajnit, dhe asnjë çelës i përbashkët nuk e zëvendëson atë.
Kontrolloni grupin dhe zgjedhjen e ruterit, secilën me tokenin e qasjes së vetë personit:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
E para rendit çdo ofrues, nëse mund të përgjigjet dhe pse jo ("No key in use: 1 withdrawn, 1 lapsed"), dhe gjendjen e çdo çelësi. E dyta përgjigjet me modelin që ruteri do të përdorte për organizatën, ose refuzimin e tij me fjalë. Më pas kontrolloni rrugën jashtë klasterit me këto dy komanda:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayÇfarë do të thotë secili zbulim:
| Ju gjeni | Zgjidhja |
|---|---|
| Asnjë çelës në grup | Një pronar ose administrator shton një çelës organizate në panelin e AI ose te Cilësimet, modelet e AI |
Çelësat invalid, expired ose exhausted |
Shtoni një çelës të ri; i vjetri mbetet i renditur si histori |
Çelësat resting |
Prisni: një çelës që dështon pushon për 60 sekonda, dhe pas 5 dështimeve radhazi ai çaktivizohet (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE me çelësa në përdorim |
Roli nuk ka caktim dhe asgjë nuk përputhet; vendosni rolin në politikën e rutimit |
MODEL_CAPABILITY_UNAVAILABLE (422) |
Kërkesa ka nevojë për një aftësi, ose një rezidencë, që asnjë ofrues në grup nuk e ofron; aktivizoni një që e ofron |
Asnjë politikë nexus-operator-egress, ose mungojnë diapazonet e ofruesit nga ajo |
Shtoni diapazonet, të shkruara në notacionin Classless Inter-Domain Routing (CIDR), në networkPolicy.externalEgressCIDRs dhe përditësoni |
| Një server lokal i modelit që nuk përgjigjet | Kontrolloni ai.localProvider.baseUrl, renditni serverin në ai.installationHosts, dhe lejoni diapazonin e tij në networkPolicy.externalEgressCIDRs |
Një çelës ofruesi i hostuar që funksionon nga një laptop dhe dështon në instalim është pothuajse gjithmonë politika e rrjetit. Hapësira e emrave mohon daljen (egress) si parazgjedhje.
Përgjigjet 429
Një klienti i përgjigjet 429 Too Many Requests. Nexus ka katër vende që mund ta thonë këtë, dhe trupi ju tregon se cili.
| Ku | Kodi dhe detaji | Çfarë duhet ndryshuar |
|---|---|---|
| nexus-auth, për çdo person të identifikuar | RATE_LIMITED me limit, windowSeconds dhe retryAfterSeconds |
auth.rateLimitPerMinute (parazgjedhja 5000), për automatizim të rëndë |
| Kufiri i një çelësi skripti, aplikacioni ose njësie (Enterprise) | RATE_LIMITED duke emërtuar çelësin dhe kufirin e tij |
Kufiri te Cilësimet, Kufijtë e normës (Rate limits), me një arsye |
| Faqja e marrjes në pronësi në ekzekutimin e parë | RATE_LIMITED me retry_after_seconds |
Asgjë: prisni dhe zbuloni se kush tjetër po provon faqen |
| Një ofrues modeli | Ruteri e trajton atë si një dështim kalimtar dhe kalon te ofruesi tjetër | Shtoni një çelës ose ofrues tjetër nëse ndodh shpesh |
Secili mbart një kokë (header) Retry-After. Një klient i sjellshëm pret aq gjatë dhe nuk provon përsëri më herët.
Nëse çdo përdorues në të njëjtën kohë duket se ndan një kufi të vetëm, kontrolloni proxy.trustedCIDRs. Kur nuk mbulon rrjetin e pod-eve të kontrolluesit tuaj ingress, nexus-auth nuk mund t'i besojë kokës X-Forwarded-For dhe e sheh çdo kërkesë sikur vjen nga kontrolluesi. Parazgjedhja, 10.42.0.0/16, i përshtatet vetëm k3s.
kubectl get pods -A -o wideGjeni adresën e pod-it të kontrolluesit ingress në dalje dhe sigurohuni që proxy.trustedCIDRs e mbulon atë.
Gabimet e përmirësimit
Përditësimi u kthye mbrapsht. Faqja e Përditësimit tregon UPGRADE_ROLLED_BACK: një hap dështoi, çdo motor është kthyer në lëshimin e mëparshëm dhe të dhënat nuk u ndryshuan. Faqja emërton hapin. Një rast i zakonshëm është një volum shumë i vogël për strukturën e re të një depoje. Rregulloni atë që emërton, ekzekutoni nexusctl upgrade plan --bundle <file> përsëri, më pas aplikoni. Kopja rezervë (backup) merret përsëri e para.
Chart-i refuzon të renderohet me EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Sekreti nexus-generated mban EXTERNAL_KEY_ENCRYPTION_KEY në një formë që chart-i nuk mund ta përdorë. Ai duhet të jetë base64 prej 32 bajtësh, ose çelësi i papërpunuar prej 32 bajtësh i një instalimi më të vjetër. Dikush e ka modifikuar ose zëvendësuar Sekretin. Ktheni çelësin nën të cilin janë vulosur të dhënat e këtij instalimi, si base64 të 32 bajtëve të tij (printf %s "$OLD" | base64), dhe përditësoni përsëri. Mos lejoni që chart-i të krijojë një të ri: të dhënat e vulosura nën çelësin e vjetër do të mbeteshin të palexueshme.
Skriptet refuzohen me TOKEN_ORG_MISSING pas përditësimit. Çdo shërbim që kontrollon çelësat e ndërfaqes së programimit të aplikacioneve (API) përmes nexus-auth tani refuzon një çelës pa organizatë, me 403 TOKEN_ORG_MISSING. Jepini çdo çelësi të tillë një organizatë, ose lëshoni një çelës të ri.
Çelësat raportojnë aplikacionin e gabuar për një orë. Pastroni hyrjet e çelësave të ruajtura në memorien e përkohshme (cache) të nexus-auth, depon Valkey të instalimit. Kapitulli 2.15, Dita e dytë: operimi i Nexus, ka komandën, për depon brenda klasterit dhe për një të jashtme.
Një hook migrimi dështoi. helm upgrade raporton një hook para-përditësimi të dështuar. Skema lëviz përpara se të rrotullohen pod-et e reja, kështu që lëshimi në ekzekutim është ende duke shërbyer. Lexoni regjistrin e Job-it me kubectl -n nexus logs job/<job-name>, rregulloni atë që emërton dhe ekzekutoni përditësimin përsëri.
Shërbimet nuk mund t'i përdornin tabelat e tyre për disa sekonda. Në përditësimin e parë të një instalimi të bërë nga një chart më i hershëm, çdo shërbim humbet të drejtat e tij të vjetra të parazgjedhura të tabelës dhe merr të vetat përsëri nga migrimi i tij. Hendeku është disa sekonda. Përditësoni në një periudhë të qetë, ose shkallëzoni shërbimet në zero fillimisht.
Lëshimi në disk u refuzua. Importimi nga media tregon MEDIA_SIGNATURE_INVALID (422): skedarët nuk janë të nënshkruar nga çelësi i lëshimit i instaluar në këtë instalim. Asgjë nuk u ngarkua dhe lëshimi në ekzekutim vazhdon të ekzekutohet. Mbani median për ekipin tuaj të sigurisë dhe kërkojini Adverant media të reja përmes shkëmbimit jashtë linje (offline).
Refuzim i gjenerimit të chart-it
helm install, helm upgrade ose helm template ndalon përpara se të aplikohet ndonjë gjë, me një mesazh që fillon me një kod ose emërton një vlerë. Chart-i refuzon vlerat që nuk mund t'i ekzekutojë në mënyrë të sigurt. Asgjë në klaster nuk ndryshoi.
Renderoni chart-in më vete për të parë çdo refuzim pa prekur klasterin. Përdorni chart-in Enterprise që keni shkarkuar në vend të adresës oci:// në Enterprise, dhe vendosni networkPolicy.apiServerCIDRs në vlerat, sepse një renderim jashtë linje nuk mund ta lexojë atë nga klasteri:
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.yamlKontrolli paraprak (Preflight) kontrollon të njëjtat vlera identiteti në seksionin e tij "koha dhe çelësat" dhe raporton të njëjtat kode. Dalja e tij është 0 kur instalimi mund të vazhdojë (paralajmërimet nuk bllokojnë), 1 kur të paktën një kontroll dështoi, dhe 2 kur nuk mund të ekzekutohej.
| Refuzimi | Shkaku | Zgjidhja |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName është bosh |
Vendoseni atë në emrin e vetë këtij instalimi, duke u përputhur me ^[a-z][a-z0-9-]{0,62}$. Është i përhershëm pasi depoja e çelësave fillon për herë të parë |
INSTALLATION_NAME_EXAMPLE |
Emri është ai në skedarët e vlerave të shembullit të chart-it | Vendosni emrin tuaj |
keys.installationName "…" does not match … |
Shkronja të mëdha, nënviza ose një shifër në fillim | Përdorni shkronja të vogla, shifra dhe viza ndarëse, duke filluar me një shkronjë |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients është bosh |
Renditni marrësit age të kujdestarëve tuaj, gjysmat publike |
KEYS_CUSTODIAN_EXAMPLE |
Një marrës është kujdestari shembull nga skedarët e vlerave të chart-it, identitetin e të cilit nuk e mban askush | Zëvendësojeni atë me marrësit e kujdestarëve tuaj |
keys.custody.recipients: … |
Një marrës në një formë në të cilën Job-i i kujdestarisë nuk mund të enkriptojë | Përdorni age1…, age1tag1…, age1tagpq1…, age1pq1… ose age1se1…, me shkronja të vogla |
NEXUS_EDITION_INVALID |
edition nuk është as community as enterprise |
Vendosni njërën nga të dyja |
edition=… but enterprise.enabled=… |
Të dyja nuk përputhen | Vendosni enterprise.enabled: true saktësisht kur edition është enterprise |
global.imageRegistry is required |
Asnjë regjistër i emërtuar | Vendosni regjistrin nga i cili nyjet tuaja tërheqin imazhet |
hosts.<name> is required |
Mungon një host publik | Vendosni hosts.console, hosts.api dhe hosts.auth |
tls.existingSecret is required when tls.mode is existing |
Asnjë Sekret certifikate i emërtuar | Emërtoni Sekretin, ose zgjidhni një tls.mode tjetër |
tls.clusterIssuer is required when tls.mode is cert-manager |
Asnjë lëshues i emërtuar | Emërtoni ClusterIssuer tuaj |
dataTier.<store>.external.host is required when mode is external |
Një depo e jashtme pa adresë | Jepni hostin e saj, dhe Sekretin e saj në existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
helm template nuk ka klaster për t'i kërkuar ato |
Jepni adresat e serverit API si diapazone /32 |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
Çelësi i gjeneruar në nexus-generated ka formën e gabuar |
Shihni "Gabimet e përditësimit" më lart |
Një skedar vlerash që përdor një çelës që chart-i nuk e ka, ose një vlerë të llojit të gabuar, refuzohet nga skema e chart-it përpara çdo njërit prej tyre. telemetry.enabled: true është një shembull: skema pranon vetëm false.
Dërgimi i një pakete mbështetjeje
Kur asnjë nga këto nuk e rregullon atë, dërgojini Adverant një paketë mbështetjeje (support bundle) bashkë me kërkesën tuaj për mbështetje.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number> është numri i kërkesës që keni hapur në faqen Mbështetja dhe paketat e mbështetjes të llogarisë suaj. Mund të krijoni të njëjtën paketë nga faqja Paketa e mbështetjes e konsolës nën Këtë instalim.
Paketa mban regjistrat e motorit nga 24 orët e fundit, detajet e shëndetit dhe versionit, cilësimet pa sekretet e tyre, si dhe raportet e kontrollit paraprak dhe të instalimit. Përpara se të shkruhet, redaktimi zëvendëson emrat, sekretet dhe adresat, dhe ju lexoni një pamje paraprake të asaj që del saktësisht. Mesazhet, skedarët dhe kujtesa e njerëzve nuk mblidhen kurrë.
Ngarkojeni atë në kërkesën në llogarinë tuaj, ose ruajeni në media dhe nxirreni jashtë nëse instalimi nuk ka lidhje të jashtme. Vetëm inxhinierët e mbështetjes të emërtuar në kërkesë mund ta hapin atë, dhe ajo fshihet pas 30 ditësh. Tregoni në kërkesë se cilin nga problemet e mësipërme po shikonit, dhe çfarë treguan kontrollet në këtë kapitull: kjo kursen një shkëmbim mesazhesh.


