HyniRezervoni një prezantim

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

22 minuta lexim

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:

  1. 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.
  2. Ekzekutoni nexusctl preflight pë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.
  3. Përdorni --explain në çdo folje nexusctl për të cilën nuk jeni të sigurt. Ai printon veprimet kubectl dhe helm pa 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.

Një sekuencë vertikale kutish të bashkuara me shigjeta poshtë: "Burimet e lëshimit u krijuan (Deployments fillojnë, secili i mbajtur nga kontejneri i tij init wait-for-schema)", më pas "Hook-u i bootstrap-it të bazës së të dhënave: baza e të dhënave, rolet, regjistri i lëshimeve", më pas "Hook-et e migrimit, një për shërbim, në një rend fiks", më pas "Çdo hook shkruan rreshtin e tij në regjistrin e lëshimeve". Nga kutia e fundit, shigjetat hapen anash në tre kuti të vogla "nexus-auth fillon", "nexus-gateway fillon", "shërbimet e tjera fillojnë". Një shënim anësor pranë kutisë së sipërme, me një shigjetë të kryqëzuar drejt fundit: "helm install --wait pret këtu për Deployments që po presin për hook-et".
Çfarë ekzekutohet, sipas radhës, kur chart-i instalohet ose përditësohet.

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

describe 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.imageRegistry dhe, 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, vendosni storage.className në 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-schema

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

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

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

Merr në pronësi këtë instalim
Merr në pronësi këtë instalim
Merrni në pronësi këtë instalim. Kodi nga terminali hyn në tre grupe, dhe faqja tregon gjurmën e plotë dixhitale në grupe prej katër për t'u krahasuar; një kod i skaduar refuzohet me CLAIM_CODE_EXPIRED dhe asgjë nuk merret në pronësi.

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

Adresa duhet të jetë e kontrolluesit tuaj ingress, dhe certifikata duhet të jetë ajo që keni instaluar për hosts.console.

Gjurma dixhitale nuk përputhet
Gjurma dixhitale nuk përputhet
Gjurmët dixhitale ndryshojnë në tre nga tetë grupet. Faqja thotë të ndaloni, shpjegon se kush mund të jetë duke u përgjigjur dhe rendit çfarë duhet të kontrolloni përpara se të provoni përsëri.

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

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

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

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

Kontrolli paraprak nuk mund të vazhdojë
Kontrolli paraprak nuk mund të vazhdojë
Kontrolli paraprak nuk mund të vazhdojë. Kontrollet e dështuara vijnë të parat, secili me zgjidhjen e tij, dhe instalimi mbetet i bllokuar me PREFLIGHT_FAILED derisa ato të kalojnë.
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.