Versija 1.0.0-alpha.1jaunākā
2.17. nodaļa
Problēmu novēršana
Problēmas, ar kurām operatori saskaras visbiežāk, sakārtotas pēc to izpausmēm. Katrai problēmai ir norādīts cēlonis, komanda tās apstiprināšanai un risinājums, un nodaļa noslēdzas ar atbalsta pakotnes nosūtīšanu.
Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

Lielākā daļa problēmu, kas rodas Nexus instalācijā, rodas vienos un tajos pašos divpadsmit veidos, un gandrīz visas tās sevi piesaka ar kodu. Šī nodaļa ir sakārtota pēc tā, ko jūs redzat, aptuveni tādā secībā, kādā jūs varētu saskarties ar katru problēmu: instalēšana, pieprasīšana, licencēšana un pēc tam darbība. Katrai problēmai ir norādīts cēlonis, komanda, kas to apstiprina, un risinājums.
Piemēros ir izmantota Harrow Port Authority instalācija: nosaukumvieta nexus, laidiens nexus, resursdatori console.harrow.example, api.harrow.example un auth.harrow.example. Aizstājiet tos ar savējiem. Trīs ieradumi ietaupa laiku ikvienai šeit aprakstītajai problēmai:
- Izlasiet kodu pirms paziņojuma. Katrs atteikums sistēmā Nexus beidzas ar mašīnkodu, un tieši pēc šiem kodiem šī nodaļa ir indeksēta.
- Palaidiet
nexusctl preflightvēlreiz pēc jebkuras izmaiņas klasterī vai vērtību failā. Tas nolasa klasteri, to nemainot, un ziņo par lielāko daļu diagrammas atteikumu pēc nosaukuma, pirms to dara Helm. - Izmantojiet
--explainjebkuramnexusctldarbības vārdam, par kuru neesat pārliecināts. Tas izdrukākubectlunhelmdarbības, tās neizpildot.
Instalēšana uzkaras
Jūs palaidāt instalēšanu, un tā nav pabeigta. helm nav atgriezis rezultātu pēc piecpadsmit minūtēm, vai arī tas ir atgriezies un podi joprojām ir stāvoklī Init vai Pending, vai arī konsoles adrese neatbild.
Visbiežākais cēlonis ir helm install --wait. Nexus izveido savu datubāzi, lomas un katra pakalpojuma shēmu pēcinstalēšanas āķos (post-install hooks), un tieši sākknēšanas āķis (bootstrap hook) nodod katram pakalpojumam tā datubāzes paroli. Izmantojot --wait, Helm gaida, līdz objekti Deployment būs gatavi, pirms tas palaiž šos āķus, savukārt objekti Deployment gaida šos āķus. Neviens no tiem nevirzās uz priekšu. Nekad neinstalējiet ar --wait; instalējiet bez tā un pagaidiet pēc tam.
Pārējie cēloņi ir ierasti sistēmai Kubernetes. Attēlus nevar izgūt, jo global.imageRegistry norāda nepareizu reģistru, vai arī Enterprise instalācijai nav izgūšanas marķiera (pull token). Sējums paliek stāvoklī Pending, jo krātuves klase neeksistē. Trūkst komponenta cert-manager, un šajā gadījumā instalēšana vispār neuzkaras: tā neizdodas dažu sekunžu laikā, jo diagrammas sertifikātu izdevējiem ir nepieciešami cert-manager resursi.
Sāciet ar podiem un āķu objektiem Job:
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 savos notikumos parāda attēlu izgūšanas kļūdas un nepiesaistītos sējumus. Āķa objekts Job, kas rāda 0/1 pabeigšanas reizes ar nesekmīgu podu, ir apturējis instalēšanu, jo āķu objektiem Job atkārtošanas ierobežojums (backoff limit) ir 0, un tie nekad netiek nemanāmi mēģināti vēlreiz. Tā žurnālā ir norādīts iemesls.
Lūk, kā novērst katru cēloni:
- Ja Helm gaida ar
--wait, apturiet to, atinstalējiet un instalējiet vēlreiz bez šī karodziņa. Pēc tam pagaidiet pakalpojumus:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Izgūšanas kļūdu gadījumā pārbaudiet
global.imageRegistryun, Enterprise gadījumā, izgūšanas marķieri sava konta lapā Izgūšanas marķieri un instalēšanas komandas (Pull tokens and install commands). - Sējumiem stāvoklī
Pendingiestatietstorage.classNameuz krātuves klasi, kas ir klasterī, vai padariet vienu no tām par noklusējuma klasi. - Ja trūkst cert-manager, instalējiet cert-manager v1.21.3 un palaidiet instalēšanu vēlreiz.
- Nesekmīga āķa gadījumā novērsiet problēmu, kas minēta tā žurnālā, un palaidiet instalēšanu vēlreiz.
Pods gaida savu shēmu
Pakalpojuma pods vairākas minūtes atrodas stāvoklī Init:0/1. Katram pakalpojumam, kas izmanto datubāzi, ir inicializācijas konteiners wait-for-schema, kas aiztur podu, līdz laidiena virsgrāmata parāda, ka šī laidiena attēlam ir lietotas tā migrācijas. Tas ir normāli pirmajās instalēšanas vai jaunināšanas minūtēs, kamēr darbojas migrācijas āķi. Tā ir problēma, ja šis process nebeidzas.
Izlasiet inicializācijas konteinera žurnālu:
kubectl -n nexus logs <pod-name> -c wait-for-schemaŽurnālā ir norādīts komponents, migrācijas ķēdes, kuras tas gaida, un tā laika ierobežojums, pēc tam tiek izdrukāta rindiņa ikreiz, kad mainās tā stāvoklis:
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
| Progresa rindiņa ziņo | Ko tas nozīmē |
|---|---|
| Kuras ķēdes šim laidienam vēl ir jālieto | Nosauktie migrācijas āķi nav pabeiguši darbu. Apskatiet šos objektus Job. |
| Ka laidiena virsgrāmatu nevar nolasīt, pievienojot datubāzes kļūdu | Postgres neatbild, vai arī virsgrāmata neeksistē, jo nav palaista datubāzes sākknēšana. |
FAILED (<component>): after <n>s, … |
Tas padevās pēc schemaWait.timeoutSeconds (pēc noklusējuma 1800). Inicializācijas konteiners tiek restartēts; pats pakalpojums tā arī nesāka darboties. |
Ķēde, kas nekad netiek lietota, gandrīz vienmēr nozīmē, ka tās migrācijas objekts Job neizdevās. Atrodiet to ar kubectl -n nexus get jobs un izlasiet tā žurnālu. Novērsiet tajā norādīto problēmu (pilns disks, ārēja datubāze, kuru migrators nevar sasniegt, lomu konflikts) un palaidiet helm upgrade ar tām pašām vērtībām: āķi tiek palaisti vēlreiz, un katru no tiem ir droši palaist atkārtoti.
Palieliniet schemaWait.timeoutSeconds tikai tad, ja migrācija ir lēna un veselīga, kāda var būt liela pirmā migrācija lēnā krātuvē. Tā palielināšana, lai noslēptu nesekmīgu objektu Job, tikai liek podam ilgāk gaidīt kaut ko tādu, kas nekad nenotiks.
Atslēgu krātuve ir bloķēta
Pēc elektroenerģijas padeves pārtraukuma, mezgla pārlādes vai konteineru izpildlaika restartēšanas podi atgriežas un konsole ielādējas, bet viss, kam nepieciešama atslēga, neizdodas vai gaida. Atslēdzējs (unsealer) pēc katras tā mezgla restartēšanas sāk darbu aizzīmogotā (sealed) stāvoklī, un atslēgu krātuve nevar pati sevi atslēgt, kamēr atslēdzējs nav atvērts.
Pajautājiet OpenBao katrā 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 $?"Izejas kods 0 nozīmē atslēgts (unsealed), 2 ir aizzīmogots (sealed), un 1 nozīmē, ka tas nevarēja atbildēt (pajautājiet vēlreiz pēc minūtes). Palaidiet to pašu pret openbao-0 ar -tls-server-name=openbao atslēgu krātuvei. Ja atslēdzējs ir atslēgts, bet atslēgu krātuve nav, atslēgu krātuve šobrīd pati sevi atslēdz; dodiet tai minūti laika.
Lai salabotu aizzīmogotu atslēdzēju, viens glabātājs (custodian) palaiž diagrammas unseal.sh ar savu age identitāti. Pilna komanda ir atrodama 2.15. nodaļā, Otrā diena: Nexus ekspluatācija. Skripta izejas kods norāda, kas notika:
| Izejas kods | Nozīme | Kā rīkoties |
|---|---|---|
| 0 | Atslēgts | Pārbaudiet kubectl -n nexus get deploy,statefulset minūtes laikā. |
| 1 | Joprojām nobloķēts vai atbloķēšanas izsaukums neizdevās | Izlasiet daļu (share) rindiņas, ko tas izdrukāja; palaidiet to vēlreiz. |
| 2 | Trūkst priekšnosacījuma | Paziņojumā tas ir nosaukts: AGE_IDENTITY, binārais fails, piemēram, age vai jq, vai tiešā režīma iestatījums. |
| 3 | Šī identitāte nevar atšifrēt daļas | Jūs neesat šīs instalācijas glabātājs. Nekas netika iesniegts. Atrodiet glabātāju, kuram ir šīs tiesības. |
Nevar pierakstīties, izmantojot HTTP
Konsole tiek ielādēta adresē http:// vai caur kubectl port-forward uz 127.0.0.1, un pierakstīšanās neizdodas. Pieejas atslēgas (passkey) uzvedne nekad neparādās, vai arī pierakstīšanās cikliski atgriežas sākumā.
Pierakstīšanās procesam ir nepieciešama pašas konsoles HTTPS izcelsme (origin). Konsole pieņem pierakstīšanos tikai no https://<hosts.console>, saglabā sesiju __Host- sīkdatnē ar atzīmi Secure (kuru pārlūkprogramma saglabā tikai, izmantojot HTTPS), un pirmā administratora pieejas atslēgai ir nepieciešama lapa ar derīgu sertifikātu. Pārlūkprogrammas atsakās izmantot pieejas atslēgas, ja ir sertifikāta kļūda. Portu pāradresācija (port-forward) uz http://127.0.0.1 nekad neļaus pierakstīties.
Pārbaudiet, ko pārlūkprogramma patiesībā sasniedza:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressPirmajam vajadzētu atbildēt, izmantojot HTTPS, ar sertifikātu, kuram jūsu iekārta uzticas. Otrajam vajadzētu parādīt trīs resursdatorus ar nosaukumiem, kurus iestatījāt hosts.*.
Lai to labotu, sasniedziet konsoli adresē https://console.harrow.example, kas ir precīzs nosaukums failā hosts.console, ar sertifikātu, kuram pārlūkprogramma uzticas. Izmantojot tls.mode: existing, pārbaudiet, vai tls.existingSecret satur sertifikātu visiem trim resursdatoriem. Izmantojot tls.mode: cert-manager, pārbaudiet, vai to ir izdevis ClusterIssuer. Izmantojot tls.mode: none, Transport Layer Security (TLS) beidzas jūsu pašu slodzes balansētājā, un tieši tur sertifikātam ir jābūt pareizam. Privātas sertifikācijas iestādes gadījumā instalējiet tās sertifikātu iekārtās, no kurām pierakstās jūsu administratori.
Pieprasījuma kodam ir beidzies derīguma termiņš
Lapā Pieprasīt šo instalāciju (Claim this installation) lapa noraida kodu ar CLAIM_CODE_EXPIRED (410). Pieprasīšanas kods sastāv no trim četru rakstzīmju grupām. Tas darbojas vienu reizi, 30 minūtes, ar 5 mēģinājumiem. Pēc tam vai pēc piektā nepareizā mēģinājuma tas vairs nav derīgs, un nekas netika pieprasīts vai mainīts.
Izveidojiet jaunu kodu no termināļa, kuram ir piekļuve klasterim:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleTas izdrukā jaunu kodu un instalācijas ciparnospiedumu (fingerprint). Ievadiet kodu pieprasīšanas lapā 30 minūšu laikā un vēlreiz salīdziniet ciparnospiedumu.
Divas saistītas atbildes:
RATE_LIMITED(429) pieprasīšanas lapā nozīmē, ka pēdējās minūtes laikā lapā ir veikti vairāki mēģinājumi. Uzgaidiet norādīto sekunžu skaitu. Ja jūs neveicāt šos mēģinājumus, kāds cits jūsu tīklā mēģina izmantot šo lapu; noskaidrojiet, kas tas ir, pirms veicat pieprasīšanu.TRANSITION_NOT_PERMITTED(409) nozīmē, ka instalācija jau ir pieprasīta un tās pieprasīšanas lapa ir neatgriezeniski izslēgta. Tā vietā pierakstieties. Ja jūs to nepieprasījāt, uztveriet to kā drošības incidentu.
Ciparnospiedums nesakrīt
Pieprasīšanas lapā ir redzams CLAIM_FINGERPRINT_MISMATCH (403), vai arī jūs pats redzat, ka astoņas četru rakstzīmju grupas lapā atšķiras no tām, kuras izdrukāja jūsu terminālis. Pat vienas grupas atšķirība nozīmē, ka pārlūkprogramma sazinās ar citu instalāciju.
Apstājieties. Neievadiet kodu šajā lapā. Šajā adresē var atbildēt kaut kas cits, nevis jūsu instalācija, iespējams, iekārta, kas uzstādīta, lai pārtvertu pirmo administratoru. Ja jūs to pieprasītu, šī iekārta iegūtu kontroli pār jūsu organizāciju. Jūsu pašu instalācija ir nemainīga un joprojām nav pieprasīta.
Pārbaudiet, uz kurieni norāda nosaukums un kurš sertifikāts atbildēja:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleAdresei ir jābūt jūsu ieejas kontroliera (ingress controller) adresei, un sertifikātam ir jābūt tam, kuru instalējāt priekš hosts.console.
Lai to labotu, nododiet savai drošības komandai adresi, kas atbildēja, un saglabājiet instalēšanas žurnālu, kurā ir reģistrēts instalācijas izdrukātais ciparnospiedums. Izlabojiet domēna nosaukumu sistēmas (DNS) ierakstu vai starpniekserveri, kas jūs novirzīja citur. Pēc tam izveidojiet jaunu pieprasīšanas kodu ar nexusctl claim-code --administrator <email> un veiciet pieprasīšanu no pārlūkprogrammas uzticamā tīklā, vēlreiz salīdzinot visas astoņas grupas.
Licence tiek noraidīta
Importēšana sadaļā Importēt licenci (Import the licence), Importēt jaunu licenci (Import a new licence) vai nexusctl licence import atbild ar atteikumu. Noraidīts imports neko nemaina: spēkā esošā licence paliek spēkā, un pulksteņa apakšējā robeža (clock floor) nemainās.
Izlasiet kodu un soli:
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.jsonAtteikuma pamattekstā ir iekļauti code, message, refused_at (solis, kas neizdevās) un troubleshooting. Lai redzētu spēkā esošās licences stāvokli, nolasiet GET https://auth.harrow.example/api/v1/installation/licence/state ar to pašu marķieri.
| Kods | HTTP | Parastais cēlonis | Risinājums |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Fails tika rediģēts, pārformatēts vai atkārtoti saglabāts, vai arī trūkst viena paraksta | Lejupielādējiet to vēlreiz no sava konta un importējiet to neskartu |
LICENCE_FORMAT_INVALID |
422 | Tā nav licence: nepareizs fails, aprauts vai ietīts citā objektā | Nosūtiet failu tieši tādu, kādu Adverant to izsniedza |
LICENCE_ROOT_UNKNOWN |
422 | Parakstīts ar atslēgu, kuras šajā laidienā nav | Jauniniet vai pieprasiet licenci, kas parakstīta jūsu laidienam |
LICENCE_MATRIX_MISMATCH |
422 | Rakstīts jaunākai izdevumu matricai vai piešķir grupu, kuru šis būvējums nepazīst | Jauniniet vai pieprasiet licenci, kas izstrādāta jūsu laidienam |
LICENCE_OTHER_INSTALLATION |
409 | Izsniegta citai instalācijai, bieži vien testa klastera licence produkcijas vidē | Pieprasiet licenci šīs instalācijas identitātei |
LICENCE_REVOKED |
403 | Adverant to atsauca | Pieprasiet Adverant jaunu licenci |
LICENCE_LOCKED |
403 | Tās starts_on ir pēc pašreizējā datuma |
Importējiet to tās pirmajā dienā vai pēc tās |
TRANSITION_NOT_PERMITTED |
409 | Šis licences ID jau tika importēts | Nav nekas jādara, ja tā ir spēkā; jautājiet Adverant, ja ir jāmaina nosacījumi |
RECORD_NOT_FOUND |
404 | Instalācija nav deklarēta, tāpēc tai vēl nav identitātes | Pabeidziet pirmā administratora soli, pēc tam importējiet |
TENANT_NOT_A_PARAMETER |
403 | Pamatteksts augšējā līmenī nosauc organizāciju | Sūtiet tikai licences failu kā pamattekstu |
Divas lietas izskatās pēc licenču problēmām, bet tādas nav. Stāvokļa nolasījums, kas satur LICENCE_CLOCK_BEHIND_FLOOR, nozīmē, ka mezgla pulkstenis rāda agrāku laiku nekā pēdējais laiks, ko instalācija ir redzējusi; izlabojiet mezgla laiku, un, ja pulkstenis bija aizskrējis uz priekšu un paņēmis līdzi apakšējo robežu, pieprasiet Adverant laika atiestatīšanas marķieri (time-reset token). Un licence, kas tiek importēta, bet joprojām rāda grupu kā demonstrācijas versiju (teaser), parasti nepiešķir šo grupu: pirms darāt ko citu, izlasiet piešķīrumus licences lapā.
Nav MI atbilžu
Mākslīgā intelekta (MI) asistents rāda MODEL_NOT_CONNECTED (503), darbplūsmas solis neizdodas ar NO_PROVIDER_FOR_ROLE (422), vai arī atbildes vienkārši apstājas.
Organizācijas pūlā nav atslēgas, kas varētu atbildēt, vai arī maršrutētājs nevar sasniegt pakalpojumu sniedzēju. Katra organizācija izmanto savu modeļa atslēgu. Ja netiek izmantota neviena atslēga, MI nedarbojas, kā tas ir paredzēts pēc uzbūves, un to neaizstāj nekāda koplietota atslēga.
Pārbaudiet pūlu un maršrutētāja izvēli, katru ar personas pašas piekļuves marķieri:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
Pirmā komanda uzskaita katru pakalpojumu sniedzēju, to, vai tas var atbildēt un kāpēc ne ("No key in use: 1 withdrawn, 1 lapsed"), un katras atslēgas stāvokli. Otrā atbild ar modeli, ko maršrutētājs izmantotu organizācijai, vai tā atteikumu vārdos. Pēc tam pārbaudiet ceļu ārpus klastera ar šīm divām komandām:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayKo nozīmē katrs atradums:
| Jūs atrodat | Risinājums |
|---|---|
| Pūlā nav atslēgas | Īpašnieks vai administrators pievieno organizācijas atslēgu MI komutatorā (AI switchboard) vai sadaļā Iestatījumi, MI modeļi (Settings, AI models) |
Atslēgas invalid, expired vai exhausted |
Pievienojiet jaunu atslēgu; vecā paliek sarakstā kā vēsture |
Atslēgas resting |
Pagaidiet: nesekmīga atslēga atpūšas 60 sekundes, un pēc 5 kļūmēm pēc kārtas tā tiek izslēgta (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE ar lietošanā esošām atslēgām |
Lomai nav piešķīruma un nekas neatbilst; iestatiet lomu maršrutēšanas politikā |
MODEL_CAPABILITY_UNAVAILABLE (422) |
Pieprasījumam ir nepieciešama spēja vai rezidence, ko nepiedāvā neviens pakalpojumu sniedzējs pūlā; iespējojiet tādu, kas to piedāvā |
Nav nexus-operator-egress politikas, vai tajā trūkst pakalpojumu sniedzēja diapazonu |
Pievienojiet diapazonus, kas pierakstīti bezklases starpdomēnu maršrutēšanas (CIDR) notācijā, pie networkPolicy.externalEgressCIDRs un jauniniet |
| Lokāls modeļa serveris, kas neatbild | Pārbaudiet ai.localProvider.baseUrl, norādiet serveri sarakstā ai.installationHosts un atļaujiet tā diapazonu iekš networkPolicy.externalEgressCIDRs |
Viesota pakalpojumu sniedzēja atslēga, kas darbojas no klēpjdatora un nedarbojas instalācijā, gandrīz vienmēr ir tīkla politikas dēļ. Nosaukumvieta pēc noklusējuma liedz izejošo datplūsmu (egress).
429 atbildes
Klientam tiek atbildēts ar 429 Too Many Requests. Sistēmā Nexus ir četras vietas, kas to var paziņot, un pamatteksts norāda, kura tā ir.
| Kur | Kods un informācija | Ko mainīt |
|---|---|---|
| nexus-auth, katrai pierakstītajai personai | RATE_LIMITED ar limit, windowSeconds un retryAfterSeconds |
auth.rateLimitPerMinute (pēc noklusējuma 5000), intensīvai automatizācijai |
| Skripta atslēgas, lietotnes vai vienības ierobežojums (Enterprise) | RATE_LIMITED, nosaucot atslēgu un tās ierobežojumu |
Ierobežojumu sadaļā Iestatījumi, Intensitātes ierobežojumi (Settings, Rate limits), norādot iemeslu |
| Pirmās palaišanas pieprasīšanas lapa | RATE_LIMITED ar retry_after_seconds |
Neko: pagaidiet un noskaidrojiet, kurš vēl mēģina izmantot šo lapu |
| Modeļa pakalpojumu sniedzējs | Maršrutētājs to uztver kā pārejošu kļūmi un pāriet pie nākamā pakalpojumu sniedzēja | Pievienojiet citu atslēgu vai pakalpojumu sniedzēju, ja tas notiek bieži |
Katrs no tiem satur Retry-After galveni. Korekts klients pagaida norādīto laiku un nemēģina atkārtoti agrāk.
Ja šķiet, ka visi lietotāji vienlaikus dala vienu ierobežojumu, pārbaudiet proxy.trustedCIDRs. Ja tas neaptver jūsu ieejas kontroliera podu tīklu, nexus-auth nevar uzticēties X-Forwarded-For galvenei un uzskata, ka katrs pieprasījums nāk no kontroliera. Noklusējuma vērtība, 10.42.0.0/16, ir piemērota tikai k3s.
kubectl get pods -A -o wideIzvadē atrodiet ieejas kontroliera poda adresi un pārliecinieties, ka proxy.trustedCIDRs to aptver.
Jaunināšanas kļūdas
Jaunināšana tika atritināta atpakaļ. Jaunināšanas lapa rāda UPGRADE_ROLLED_BACK: solis neizdevās, katrs dzinējs ir atgriezies pie iepriekšējā laidiena, un dati netika mainīti. Lapā ir nosaukts šis solis. Bieži sastopams iemesls ir pārāk mazs sējums krātuves jaunajam izkārtojumam. Izlabojiet norādīto problēmu, palaidiet nexusctl upgrade plan --bundle <file> vēlreiz un pēc tam lietojiet izmaiņas. Vispirms vēlreiz tiek izveidots dublējums.
Diagramma atsakās renderēties ar EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Objekts Secret nexus-generated satur EXTERNAL_KEY_ENCRYPTION_KEY tādā formā, kādu diagramma nevar izmantot. Tam ir jābūt 32 baitu base64 kodējumam vai vecākas instalācijas neapstrādātai 32 baitu atslēgai. Kāds ir rediģējis vai aizstājis objektu Secret. Atjaunojiet atslēgu, ar kuru ir aizzīmogoti šīs instalācijas dati, kā tās 32 baitu base64 kodējumu (printf %s "$OLD" | base64), un jauniniet vēlreiz. Neļaujiet diagrammai izveidot jaunu atslēgu: dati, kas aizzīmogoti ar veco atslēgu, paliktu nelasāmi.
Pēc jaunināšanas skripti tiek noraidīti ar TOKEN_ORG_MISSING. Katrs pakalpojums, kas pārbauda lietojumprogrammu saskarnes (API) atslēgas caur nexus-auth, tagad noraida atslēgu bez organizācijas ar kodu 403 TOKEN_ORG_MISSING. Piešķiriet katrai šādai atslēgai organizāciju vai izsniedziet jaunu atslēgu.
Atslēgas vienu stundu ziņo par nepareizu lietojumprogrammu. Iztīriet kešatmiņā saglabātos atslēgu ierakstus nexus-auth kešatmiņā, kas ir instalācijas Valkey krātuve. Komanda gan klastera iekšējai krātuvei, gan ārējai krātuvei ir atrodama 2.15. nodaļā, Otrā diena: Nexus ekspluatācija.
Migrācijas āķis neizdevās. helm upgrade ziņo par nesekmīgu pirmsjaunināšanas āķi (pre-upgrade hook). Shēma tiek pārvietota pirms jauno podu palaišanas, tāpēc esošais laidiens joprojām turpina apkalpošanu. Izlasiet objekta Job žurnālu ar kubectl -n nexus logs job/<job-name>, izlabojiet tajā norādīto problēmu un palaidiet jaunināšanu vēlreiz.
Pakalpojumi dažas sekundes nevarēja izmantot savas tabulas. Pirmajā jaunināšanas reizē instalācijai, kas izveidota no agrākas diagrammas, katrs pakalpojums zaudē savas vecās noklusējuma tabulu tiesības un atgūst savējās no savas migrācijas. Pārtraukums ilgst dažas sekundes. Veiciet jaunināšanu klusā periodā vai vispirms samaziniet pakalpojumu mērogu līdz nullei.
Diskā esošais laidiens tika noraidīts. Importēšana no datu nesēja rāda MEDIA_SIGNATURE_INVALID (422): faili nav parakstīti ar šajā instalācijā instalēto laidiena atslēgu. Nekas netika ielādēts, un esošais laidiens turpina darboties. Saglabājiet datu nesēju savai drošības komandai un pieprasiet Adverant jaunu datu nesēju, izmantojot bezsaistes apmaiņu.
Helm diagrammas atveidošanas atteikums
helm install, helm upgrade vai helm template apstājas, pirms jebkas tiek lietots, ar paziņojumu, kas sākas ar kodu vai nosauc vērtību. Diagramma noraida vērtības, kuras tā nevar droši izpildīt. Klasterī nekas nav mainījies.
Renderējiet diagrammu atsevišķi, lai redzētu katru atteikumu, neaiztiekot klasteri. Izmantojiet lejupielādēto Enterprise diagrammu oci:// adreses vietā Enterprise versijā un vērtībās iestatiet networkPolicy.apiServerCIDRs, jo bezsaistes renderēšana nevar to nolasīt no klastera:
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.yamlPirmspalaišanas pārbaude (Preflight) pārbauda tās pašas identitātes vērtības savā sadaļā "laiks un atslēgas" ("time and keys") un ziņo tos pašus kodus. Tās izejas kods ir 0, kad instalēšana var turpināties (brīdinājumi nebloķē), 1, kad vismaz viena pārbaude neizdevās, un 2, kad to nevarēja palaist.
| Noraidījums | Cēlonis | Risinājums |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName ir tukšs |
Iestatiet to uz šīs instalācijas pašas nosaukumu, kas atbilst ^[a-z][a-z0-9-]{0,62}$. Tas kļūst nemainīgs, tiklīdz atslēgu krātuve pirmo reizi sāk darboties |
INSTALLATION_NAME_EXAMPLE |
Nosaukums ir tas pats, kas diagrammas piemēra vērtību failos | Iestatiet savu nosaukumu |
keys.installationName "…" does not match … |
Lielie burti, pasvītras vai cipars sākumā | Izmantojiet mazos burtus, ciparus un defises, sākot ar burtu |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients ir tukšs |
Uzskaitiet savu glabātāju age saņēmējus (recipients), publiskās puses |
KEYS_CUSTODIAN_EXAMPLE |
Saņēmējs ir piemēra glabātājs no diagrammas vērtību failiem, kura identitāte nevienam nepieder | Aizstājiet to ar savu glabātāju saņēmējiem |
keys.custody.recipients: … |
Saņēmējs formā, kurai glabāšanas objekts Job nevar veikt šifrēšanu | Izmantojiet age1…, age1tag1…, age1tagpq1…, age1pq1… vai age1se1… ar mazajiem burtiem |
NEXUS_EDITION_INVALID |
edition nav ne community, ne enterprise |
Iestatiet vienu no šiem diviem |
edition=… but enterprise.enabled=… |
Abas vērtības ir pretrunā | Iestatiet enterprise.enabled: true tieši tad, kad edition ir enterprise |
global.imageRegistry is required |
Nav nosaukts neviens reģistrs | Iestatiet reģistru, no kura jūsu mezgli izgūst attēlus |
hosts.<name> is required |
Trūkst publiskā resursdatora | Iestatiet hosts.console, hosts.api un hosts.auth |
tls.existingSecret is required when tls.mode is existing |
Nav nosaukts sertifikāta objekts Secret | Nosauciet objektu Secret vai izvēlieties citu tls.mode |
tls.clusterIssuer is required when tls.mode is cert-manager |
Nav nosaukts neviens izdevējs | Nosauciet savu ClusterIssuer |
dataTier.<store>.external.host is required when mode is external |
Ārēja krātuve bez adreses | Norādiet tās resursdatoru un tās objektu Secret iekš existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
helm template nav klastera, kurā tos uzmeklēt |
Norādiet API servera adreses kā /32 diapazonus |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
Ģenerētajai atslēgai iekš nexus-generated ir nepareiza forma |
Skatiet "Jaunināšanas kļūdas" ("Upgrade errors") augstāk |
Vērtību failu, kurā izmantota atslēga, kādas diagrammā nav, vai nepareiza tipa vērtība, diagrammas shēma noraida pirms jebkuras no šīm pārbaudēm. telemetry.enabled: true ir viens piemērs: shēma pieņem tikai false.
Atbalsta pakotnes nosūtīšana
Ja nekas no šī nepalīdz, nosūtiet Adverant atbalsta pakotni (support bundle) kopā ar savu atbalsta pieprasījumu.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number> ir pieprasījuma numurs, kuru atvērāt sava konta lapā Atbalsts un atbalsta pakotnes (Support and support bundles). To pašu pakotni varat izveidot konsoles lapā Atbalsta pakotne (Support bundle) zem sadaļas Šī instalācija (This installation).
Pakotne satur dzinēju žurnālus par pēdējām 24 stundām, darbības stāvokļa un versiju informāciju, iestatījumus bez to noslēpumiem, kā arī pirmspalaišanas pārbaudes un instalēšanas pārskatus. Pirms tās ierakstīšanas rediģēšanas process aizstāj vārdus, noslēpumus un adreses, un jūs varat izlasīt priekšskatījumu tam, kas tieši tiek nosūtīts. Cilvēku ziņojumi, faili un atmiņa nekad netiek vākti.
Augšupielādējiet to pieprasījumā savā kontā vai saglabājiet to datu nesējā un iznesiet ārā, ja instalācijai nav ārēja savienojuma. To var atvērt tikai pieprasījumā norādītie atbalsta inženieri, un pēc 30 dienām tā tiek izdzēsta. Pieprasījumā norādiet, kuru no iepriekš minētajām problēmām jūs skatījāt un ko parādīja šajā nodaļā aprakstītās pārbaudes: tas ietaupa laiku sarakstei.


