Versija 1.0.0-alpha.1naujausia
2.17 skyrius
Trikčių šalinimas
Problemos, su kuriomis operatoriai susiduria dažniausiai, suskirstytos pagal tai, ką matote. Prie kiekvienos nurodoma priežastis, ją patvirtinanti komanda ir sprendimas, o skyrius baigiamas pagalbos paketo išsiuntimu.
Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

Dauguma Nexus diegimo gedimų kartojasi tais pačiais keliolika būdų, ir beveik visi jie praneša apie save kodu. Šis skyrius suskirstytas pagal tai, ką matote, maždaug ta tvarka, kuria susidurtumėte su kiekviena problema: diegimas, perėmimas, licencijavimas, tada veikimas. Kiekvienai problemai pateikiama priežastis, ją patvirtinanti komanda ir sprendimas.
Pavyzdžiuose naudojamas Harrow Port Authority diegimas: vardų sritis nexus, leidimas nexus, pagrindiniai kompiuteriai console.harrow.example, api.harrow.example ir auth.harrow.example. Pakeiskite juos savaisiais. Trys įpročiai sutaupo laiko sprendžiant kiekvieną čia aprašytą problemą:
- Pirmiausia perskaitykite kodą, tik tada pranešimą. Kiekvienas Nexus atsisakymas baigiasi mašininiu kodu, ir būtent pagal kodą sudarytas šio skyriaus turinys.
- Po kiekvieno klasterio ar reikšmių failo pakeitimo dar kartą paleiskite
nexusctl preflight. Ši komanda nuskaito klasterį jo nekeisdama ir daugumą chart atsisakymų nurodo pavadinimu dar prieš Helm. - Naudokite
--explainsu bet kuriuonexusctlveiksmažodžiu, dėl kurio nesate tikri. Jis išspausdinakubectlirhelmoperacijas jų nevykdydamas.
Diegimas pakimba
Paleidote diegimą, ir jis nesibaigė. helm negrąžino rezultato po penkiolikos minučių, arba grąžino, bet podai vis dar yra būsenos Init ar Pending, arba konsolės adresas neatsako.
Dažniausia priežastis yra helm install --wait. Nexus sukuria savo duomenų bazę, roles ir kiekvienos paslaugos schemą post-install kabliuose (hooks), o būtent pradinio paleidimo kablys perduoda kiekvienai paslaugai jos duomenų bazės slaptažodį. Naudojant --wait, Helm laukia, kol Deployment objektai bus parengti, ir tik tada vykdo tuos kablius, o Deployment objektai laukia kablių. Niekas nejuda. Niekada nediekite su --wait; diekite be jo ir laukite po to.
Kitos priežastys yra įprastos Kubernetes priežastys. Atvaizdų nepavyksta parsisiųsti, nes global.imageRegistry nurodo neteisingą registrą arba Enterprise diegimas neturi parsisiuntimo žetono. Tomas lieka būsenos Pending, nes saugyklos klasė neegzistuoja. Trūksta cert-manager – tokiu atveju diegimas visai nestringa: jis nepavyksta per kelias sekundes, nes chart sertifikatų išdavėjams reikia cert-manager išteklių.
Pradėkite nuo podų ir kablių Job objektų:
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 savo įvykiuose rodo atvaizdų parsisiuntimo klaidas ir nesusietus tomus. Kablio Job, rodantis 0/1 užbaigimų su nepavykusiu podu, sustabdė diegimą, nes kablių Job objektų atsitraukimo riba yra 0 ir jie niekada nekartojami tyliai. Jo žurnale nurodyta priežastis.
Štai kaip pašalinti kiekvieną priežastį:
- Jei Helm laukia su
--wait, sustabdykite jį, pašalinkite diegimą ir įdiekite iš naujo be šios vėliavėlės. Tada palaukite paslaugų:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Esant parsisiuntimo klaidoms, patikrinkite
global.imageRegistry, o Enterprise atveju – parsisiuntimo žetoną savo paskyros puslapyje „Parsisiuntimo žetonai ir diegimo komandos“. - Esant
Pendingtomams, nustatykitestorage.classNameį klasteryje esančią saugyklos klasę arba nustatykite vieną iš jų numatytąja. - Jei trūksta cert-manager, įdiekite cert-manager v1.21.3 ir paleiskite diegimą iš naujo.
- Jei kablys nepavyko, pašalinkite jo žurnale nurodytą problemą ir paleiskite diegimą iš naujo.
Podas laukia savo schemos
Paslaugos podas kelias minutes lieka būsenos Init:0/1. Kiekviena duomenų bazę naudojanti paslauga turi inicializavimo konteinerį wait-for-schema, kuris laiko podą, kol leidimų žurnale bus parodyta, kad šio leidimo atvaizdo migracijos pritaikytos. Pirmosiomis diegimo ar atnaujinimo minutėmis, kol vykdomi migracijų kabliai, tai normalu. Problema atsiranda, kai tai nesibaigia.
Perskaitykite inicializavimo konteinerio žurnalą:
kubectl -n nexus logs <pod-name> -c wait-for-schemaŽurnale nurodomas komponentas, migracijų grandinės, kurių jis laukia, ir jo laiko riba, o tada išspausdinama eilutė kiekvieną kartą, kai pasikeičia jo būsena:
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
| Eigos eilutėje nurodyta | Ką tai reiškia |
|---|---|
| Kurias grandines šiam leidimui dar reikia pritaikyti | Nurodyti migracijų kabliai nebaigti. Peržiūrėkite tuos Job objektus. |
| Kad leidimų žurnalo nepavyksta nuskaityti, kartu su duomenų bazės klaida | Postgres neatsako arba žurnalas neegzistuoja, nes duomenų bazės pradinis paleidimas neįvyko. |
FAILED (<component>): after <n>s, … |
Jis pasidavė po schemaWait.timeoutSeconds (pagal numatytuosius nustatymus 1800). Inicializavimo konteineris paleidžiamas iš naujo; pati paslauga taip ir nepasileido. |
Niekada nepritaikoma grandinė beveik visada reiškia, kad jos migracijos Job nepavyko. Raskite jį su kubectl -n nexus get jobs ir perskaitykite jo žurnalą. Pašalinkite nurodytą problemą (pilnas diskas, išorinė duomenų bazė, kurios migratorius negali pasiekti, rolių konfliktas) ir paleiskite helm upgrade su tomis pačiomis reikšmėmis: kabliai vykdomi iš naujo, ir kiekvieną iš jų saugu vykdyti pakartotinai.
Didinkite schemaWait.timeoutSeconds tik tada, kai migracija lėta, bet sveika, kaip gali būti su didele pirmąja migracija lėtoje saugykloje. Didinant ją norint paslėpti nepavykusį Job, podas tik ilgiau lauks to, kas niekada neįvyks.
Raktų saugykla užplombuota
Po elektros dingimo, mazgo perkrovimo ar konteinerių vykdymo aplinkos paleidimo iš naujo podai grįžta ir konsolė įsikelia, tačiau viskas, kam reikia rakto, nepavyksta arba laukia. Atrakintuvas po kiekvieno savo mazgo paleidimo iš naujo pasileidžia užrakintas, o raktų saugykla negali atsirakinti pati, kol atrakintuvas neatidarytas.
Paklauskite OpenBao kiekviename pode:
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 $?"Išėjimo kodas 0 reiškia atrakinta, 2 – užrakinta, o 1 reiškia, kad nepavyko atsakyti (paklauskite dar kartą po minutės). Raktų saugyklai paleiskite tą patį su openbao-0 ir -tls-server-name=openbao. Jei atrakintuvas atrakintas, o raktų saugykla ne, raktų saugykla atsirakina pati; palaukite minutę.
Norint atrakinti užrakintą atrakintuvą, vienas saugotojas paleidžia chart unseal.sh su savo age tapatybe. Visa komanda pateikta 2.15 skyriuje „Antroji diena: Nexus eksploatavimas“. Scenarijaus išėjimo kodas parodo, kas įvyko:
| Išėjimo kodas | Reikšmė | Ką daryti |
|---|---|---|
| 0 | Atrakinta | Per minutę patikrinkite kubectl -n nexus get deploy,statefulset. |
| 1 | Vis dar užblokuota arba atblokavimo kvietimas nepavyko | Perskaitykite jo išspausdintas dalių eilutes; paleiskite jį dar kartą. |
| 2 | Trūksta būtinos sąlygos | Pranešime ji nurodyta: AGE_IDENTITY, dvejetainis failas, pvz., age ar jq, arba tiesioginio režimo nustatymas. |
| 3 | Ši tapatybė negali iššifruoti dalių | Nesate šio diegimo saugotojas. Niekas nebuvo pateikta. Raskite saugotoją, kuris juo yra. |
Negalite prisijungti per HTTP
Konsolė įsikelia http:// adresu arba per kubectl port-forward į 127.0.0.1, ir prisijungti nepavyksta. Prieigos rakto (passkey) užklausa niekada nepasirodo arba prisijungimas sugrįžta į pradžią.
Prisijungimui reikia pačios konsolės HTTPS kilmės. Konsolė priima prisijungimą tik iš https://<hosts.console>, seansą saugo __Host- slapuke, pažymėtame Secure (naršyklė jį saugo tik per HTTPS), o pirmojo administratoriaus prieigos raktui reikia puslapio su galiojančiu sertifikatu. Naršyklės atsisako prieigos raktų, kai yra sertifikato klaida. Per port-forward į http://127.0.0.1 prisijungti niekada neįmanoma.
Patikrinkite, ką naršyklė iš tikrųjų pasiekė:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressPirmoji turėtų atsakyti per HTTPS su sertifikatu, kuriuo jūsų kompiuteris pasitiki. Antroji turėtų rodyti tris pagrindinius kompiuterius su vardais, kuriuos nustatėte hosts.*.
Norėdami tai ištaisyti, pasiekite konsolę adresu https://console.harrow.example, tiksliu vardu iš hosts.console, su sertifikatu, kuriuo naršyklė pasitiki. Naudodami tls.mode: existing, patikrinkite, ar tls.existingSecret turi sertifikatą visiems trims pagrindiniams kompiuteriams. Naudodami tls.mode: cert-manager, patikrinkite, ar jį išdavė ClusterIssuer. Naudojant tls.mode: none, transporto lygmens saugumas (TLS) baigiasi jūsų pačių apkrovos balansavimo įrenginyje, ir būtent ten sertifikatas turi būti teisingas. Jei naudojate privačią sertifikavimo įstaigą, įdiekite jos sertifikatą kompiuteriuose, iš kurių jungiasi jūsų administratoriai.
Perėmimo kodas nebegalioja
Puslapyje „Perimti šį diegimą“ kodas atmetamas su CLAIM_CODE_EXPIRED (410). Perėmimo kodą sudaro trys grupės po keturis simbolius. Jis veikia vieną kartą, 30 minučių, su 5 bandymais. Po to arba po penktojo neteisingo bandymo jis nebegalioja, ir niekas nebuvo perimta ar pakeista.
Sukurkite naują kodą iš terminalo, turinčio prieigą prie klasterio:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleJis išspausdina naują kodą ir diegimo kontrolinį kodą (fingerprint). Per 30 minučių įveskite kodą perėmimo puslapyje ir dar kartą palyginkite kontrolinį kodą.
Du susiję atsakymai:
RATE_LIMITED(429) perėmimo puslapyje reiškia, kad per paskutinę minutę puslapyje buvo keli bandymai. Palaukite nurodytą sekundžių skaičių. Jei tų bandymų nedarėte, kažkas kitas jūsų tinkle bando naudoti puslapį; prieš perimdami išsiaiškinkite, kas.TRANSITION_NOT_PERMITTED(409) reiškia, kad diegimas jau perimtas, ir jo perėmimo puslapis išjungtas visam laikui. Vietoj to prisijunkite. Jei jo neperėmėte, laikykite tai saugumo incidentu.
Kontrolinis kodas nesutampa
Perėmimo puslapis rodo CLAIM_FINGERPRINT_MISMATCH (403), arba patys matote, kad aštuonios keturių simbolių grupės puslapyje skiriasi nuo tų, kurias išspausdino jūsų terminalas. Net viena besiskirianti grupė reiškia, kad naršyklė bendrauja su kitu diegimu.
Sustokite. Neįveskite kodo tame puslapyje. Tuo adresu gali atsakyti kažkas kita nei jūsų diegimas, galbūt kompiuteris, parengtas sugauti pirmąjį administratorių. Jei jį perimtumėte, tas kompiuteris valdytų jūsų organizaciją. Jūsų paties diegimas nepakitęs ir vis dar neperimtas.
Patikrinkite, kur nukreiptas vardas ir kuris sertifikatas atsakė:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleAdresas turėtų būti jūsų ingress valdiklio, o sertifikatas turėtų būti tas, kurį įdiegėte hosts.console.
Norėdami tai ištaisyti, perduokite savo saugumo komandai atsakiusį adresą ir išsaugokite diegimo žurnalą, kuriame užfiksuotas diegimo išspausdintas kontrolinis kodas. Pataisykite domenų vardų sistemos (DNS) įrašą arba tarpinį serverį, kuris jus nukreipė kitur. Tada sukurkite naują perėmimo kodą su nexusctl claim-code --administrator <email> ir perimkite iš naršyklės patikimame tinkle, dar kartą palygindami visas aštuonias grupes.
Licencija atmesta
Importavimas puslapiuose „Importuoti licenciją“, „Importuoti naują licenciją“ arba per nexusctl licence import atsako atsisakymu. Atmestas importavimas nieko nekeičia: galiojanti licencija lieka galioti, o laikrodžio žemutinė riba nepasislenka.
Perskaitykite kodą ir žingsnį:
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.jsonAtsisakymo turinyje yra code, message, refused_at (nepavykęs žingsnis) ir troubleshooting. Norėdami matyti galiojančios licencijos būseną, nuskaitykite GET https://auth.harrow.example/api/v1/installation/licence/state su tuo pačiu žetonu.
| Kodas | HTTP | Įprasta priežastis | Sprendimas |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Failas buvo redaguotas, performatuotas ar įrašytas iš naujo, arba trūksta vieno parašo | Atsisiųskite jį dar kartą iš savo paskyros ir importuokite nepakeistą |
LICENCE_FORMAT_INVALID |
422 | Tai ne licencija: netinkamas failas, sutrumpintas arba įvilktas į kitą objektą | Siųskite failą tiksliai tokį, kokį jį davė Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Pasirašyta raktu, kurio šis leidimas neturi | Atnaujinkite arba paprašykite licencijos, pasirašytos jūsų leidimui |
LICENCE_MATRIX_MISMATCH |
422 | Parašyta naujesnei leidimų matricai arba suteikia grupę, kurios šis build nežino | Atnaujinkite arba paprašykite licencijos, parašytos jūsų leidimui |
LICENCE_OTHER_INSTALLATION |
409 | Išduota kitam diegimui, dažnai bandomojo klasterio licencija gamybinėje aplinkoje | Paprašykite licencijos šio diegimo tapatybei |
LICENCE_REVOKED |
403 | Adverant ją atšaukė | Paprašykite Adverant naujos licencijos |
LICENCE_LOCKED |
403 | Jos starts_on yra vėlesnė nei dabartinė data |
Importuokite ją pirmąją jos galiojimo dieną arba vėliau |
TRANSITION_NOT_PERMITTED |
409 | Šis licencijos id jau buvo importuotas | Nieko daryti nereikia, jei ji galioja; jei sąlygos turi keistis, kreipkitės į Adverant |
RECORD_NOT_FOUND |
404 | Diegimas nebuvo deklaruotas, todėl dar neturi tapatybės | Užbaikite pirmojo administratoriaus žingsnį, tada importuokite |
TENANT_NOT_A_PARAMETER |
403 | Turinio aukščiausiame lygmenyje nurodyta organizacija | Siųskite tik licencijos failą kaip turinį |
Du dalykai atrodo kaip licencijos problemos, bet jomis nėra. Būsenos nuskaitymas su LICENCE_CLOCK_BEHIND_FLOOR reiškia, kad mazgo laikrodis rodo ankstesnį laiką nei vėliausias diegimo matytas laikas; pataisykite mazgo laiką, o jei laikrodis buvo nubėgęs į priekį ir nusinešė žemutinę ribą kartu, paprašykite Adverant laiko atstatymo žetono. O licencija, kuri importuojama, bet grupę vis tiek rodo kaip peržiūrą, paprastai tos grupės nesuteikia: visų pirma perskaitykite suteikimus licencijos puslapyje.
Nėra DI atsakymų
Dirbtinio intelekto (DI) asistentas rodo MODEL_NOT_CONNECTED (503), darbo eigos žingsnis nepavyksta su NO_PROVIDER_FOR_ROLE (422) arba atsakymai tiesiog nutrūksta.
Organizacijos telkinyje nėra rakto, kuris galėtų atsakyti, arba maršrutizatorius negali pasiekti teikėjo. Kiekviena organizacija naudoja savo modelio raktą. Jei nenaudojamas joks raktas, DI nėra – taip numatyta, ir joks bendras raktas jo nepakeičia.
Patikrinkite telkinį ir maršrutizatoriaus pasirinkimą, kiekvieną su paties asmens prieigos žetonu:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
Pirmoji išvardija kiekvieną teikėją, ar jis gali atsakyti ir kodėl ne („No key in use: 1 withdrawn, 1 lapsed“), bei kiekvieno rakto būseną. Antroji pateikia modelį, kurį maršrutizatorius naudotų organizacijai, arba jo atsisakymą žodžiais. Tada patikrinkite kelią iš klasterio šiomis dviem komandomis:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayKą reiškia kiekvienas radinys:
| Randate | Sprendimas |
|---|---|
| Telkinyje nėra rakto | Savininkas arba administratorius prideda organizacijos raktą DI skirstytuve arba skiltyje „Nustatymai“, „DI modeliai“ |
Raktai invalid, expired arba exhausted |
Pridėkite naują raktą; senasis lieka sąraše kaip istorija |
Raktai resting |
Palaukite: nepavykstantis raktas ilsisi 60 sekundžių, o po 5 nesėkmių iš eilės jis išjungiamas (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE, kai raktai naudojami |
Rolei nepriskirta ir niekas neatitinka; nustatykite rolę maršrutizavimo politikoje |
MODEL_CAPABILITY_UNAVAILABLE (422) |
Užklausai reikia galimybės arba duomenų buvimo vietos, kurios nesiūlo nė vienas telkinio teikėjas; įjunkite tokį, kuris ją siūlo |
Nėra nexus-operator-egress politikos arba joje trūksta teikėjo adresų intervalų |
Įrašykite intervalus, užrašytus beklasio tarpdomeninio maršrutizavimo (CIDR) notacija, į networkPolicy.externalEgressCIDRs ir atnaujinkite |
| Vietinis modelių serveris, kuris neatsako | Patikrinkite ai.localProvider.baseUrl, įtraukite serverį į ai.installationHosts ir leiskite jo intervalą networkPolicy.externalEgressCIDRs |
Talpinamo teikėjo raktas, kuris veikia iš nešiojamojo kompiuterio, bet neveikia diegime, beveik visada rodo tinklo politikos problemą. Vardų sritis pagal numatytuosius nustatymus draudžia išeinantį srautą.
429 atsakymai
Klientas gauna atsakymą 429 Too Many Requests. Nexus jį gali grąžinti keturiose vietose, o atsakymo turinys nurodo, kurioje.
| Kur | Kodas ir išsami informacija | Ką pakeisti |
|---|---|---|
| nexus-auth, kiekvienam prisijungusiam asmeniui | RATE_LIMITED su limit, windowSeconds ir retryAfterSeconds |
auth.rateLimitPerMinute (numatytoji reikšmė 5000), intensyviam automatizavimui |
| Scenarijaus rakto, programos ar padalinio limitas (Enterprise) | RATE_LIMITED, nurodantis raktą ir jo limitą |
Limitas, nustatytas skiltyje Settings, Rate limits, su priežastimi |
| Pirmojo paleidimo perėmimo puslapis | RATE_LIMITED su retry_after_seconds |
Nieko: palaukite ir išsiaiškinkite, kas dar bando atidaryti puslapį |
| Modelių teikėjas | Maršrutizatorius tai laiko laikinu gedimu ir pereina prie kito teikėjo | Jei tai kartojasi dažnai, pridėkite dar vieną raktą arba teikėją |
Kiekvienas jų turi antraštę Retry-After. Tinkamai veikiantis klientas laukia tiek laiko ir nebando kartoti anksčiau.
Jei atrodo, kad visi naudotojai dalijasi vienu limitu, patikrinkite proxy.trustedCIDRs. Kai jis neapima jūsų įėjimo valdiklio podų tinklo, nexus-auth negali pasitikėti antrašte X-Forwarded-For ir visas užklausas laiko gautomis iš valdiklio. Numatytoji reikšmė 10.42.0.0/16 tinka tik k3s.
kubectl get pods -A -o wideIšvestyje raskite įėjimo valdiklio podo adresą ir įsitikinkite, kad proxy.trustedCIDRs jį apima.
Versijos atnaujinimo klaidos
Atnaujinimas atšauktas. Puslapyje Upgrade rodoma UPGRADE_ROLLED_BACK: vienas veiksmas nepavyko, visi varikliai grąžinti į ankstesnę laidą, o duomenys nepakeisti. Puslapyje nurodomas veiksmas. Dažna priežastis – per mažas tomas naujai saugyklos struktūrai. Ištaisykite tai, kas nurodyta, dar kartą paleiskite nexusctl upgrade plan --bundle <file>, tada pritaikykite. Prieš tai atsarginė kopija sukuriama iš naujo.
Diagrama atsisako generuotis su EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Secret objekte nexus-generated laikomas EXTERNAL_KEY_ENCRYPTION_KEY tokio pavidalo, kurio diagrama negali naudoti. Jis turi būti 32 baitų base64 arba senesnio diegimo neapdorotas 32 baitų raktas. Kažkas redagavo arba pakeitė Secret objektą. Grąžinkite raktą, kuriuo užsandarinti šio diegimo duomenys, kaip jo 32 baitų base64 (printf %s "$OLD" | base64), ir atnaujinkite dar kartą. Neleiskite diagramai sukurti naujo: senuoju raktu užsandarinti duomenys liktų neperskaitomi.
Po atnaujinimo scenarijai atmetami su TOKEN_ORG_MISSING. Kiekviena paslauga, tikrinanti taikomųjų programų sąsajos (API) raktus per nexus-auth, dabar atmeta raktą be organizacijos, grąžindama 403 TOKEN_ORG_MISSING. Kiekvienam tokiam raktui priskirkite organizaciją arba išduokite naują raktą.
Raktai valandą nurodo neteisingą programą. Išvalykite podėlyje laikomus raktų įrašus nexus-auth podėlyje – diegimo Valkey saugykloje. 2.15 skyriuje „Antroji diena: Nexus eksploatavimas“ pateikta komanda tiek klasterio vidinei, tiek išorinei saugyklai.
Nepavyko migracijos kabliukas. helm upgrade praneša apie nepavykusį pre-upgrade kabliuką. Schema pakeičiama prieš įdiegiant naujus podus, todėl veikianti laida vis dar aptarnauja. Perskaitykite Job žurnalą naudodami kubectl -n nexus logs job/<job-name>, ištaisykite tai, kas nurodyta, ir paleiskite atnaujinimą dar kartą.
Paslaugos kelias sekundes negalėjo naudoti savo lentelių. Pirmą kartą atnaujinant diegimą, sukurtą iš ankstesnės diagramos, kiekviena paslauga netenka senųjų numatytųjų lentelių teisių ir atgauna savąsias per savo migraciją. Pertrauka trunka kelias sekundes. Atnaujinkite ramiu laikotarpiu arba prieš tai sumažinkite paslaugų mastą iki nulio.
Diske esanti laida atmesta. Importuojant iš laikmenos rodoma MEDIA_SIGNATURE_INVALID (422): failai nepasirašyti šiame diegime įdiegtu laidos raktu. Niekas neįkelta, o veikianti laida toliau veikia. Išsaugokite laikmeną savo saugumo komandai ir per neprisijungusio režimo mainus paprašykite Adverant naujos laikmenos.
Diagramos generavimo atmetimas
helm install, helm upgrade arba helm template sustoja prieš ką nors pritaikydama, pateikdama pranešimą, kuris prasideda kodu arba nurodo reikšmę. Diagrama atmeta reikšmes, su kuriomis negali saugiai veikti. Klasteryje niekas nepasikeitė.
Sugeneruokite diagramą atskirai, kad pamatytumėte visus atmetimus neliesdami klasterio. Enterprise atveju vietoj oci:// adreso naudokite atsisiųstą Enterprise diagramą ir reikšmėse nustatykite networkPolicy.apiServerCIDRs, nes neprisijungus generuojant jo negalima nuskaityti iš klasterio:
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.yamlIšankstinė patikra tikrina tas pačias tapatybės reikšmes skiltyje „laikas ir raktai“ ir pateikia tuos pačius kodus. Jos išėjimo kodas yra 0, kai diegti galima (įspėjimai neblokuoja), 1, kai nepavyko bent viena patikra, ir 2, kai jos nepavyko paleisti.
| Atmetimas | Priežastis | Sprendimas |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName yra tuščias |
Nustatykite jį pagal šio diegimo pavadinimą, atitinkantį ^[a-z][a-z0-9-]{0,62}$. Kai raktų saugykla paleidžiama pirmą kartą, jis tampa nekeičiamas |
INSTALLATION_NAME_EXAMPLE |
Pavadinimas yra tas, kuris nurodytas diagramos pavyzdiniuose reikšmių failuose | Nustatykite savo pavadinimą |
keys.installationName "…" does not match … |
Didžiosios raidės, pabraukimai arba skaitmuo pradžioje | Naudokite mažąsias raides, skaitmenis ir brūkšnelius, pradėdami raide |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients yra tuščias |
Išvardykite savo saugotojų age gavėjus – viešąsias dalis |
KEYS_CUSTODIAN_EXAMPLE |
Gavėjas yra pavyzdinis saugotojas iš diagramos reikšmių failų, kurio tapatybės niekas neturi | Pakeiskite jį savo saugotojų gavėjais |
keys.custody.recipients: … |
Gavėjas tokiu pavidalu, kuriam saugojimo Job negali šifruoti | Naudokite age1…, age1tag1…, age1tagpq1…, age1pq1… arba age1se1… mažosiomis raidėmis |
NEXUS_EDITION_INVALID |
edition nėra nei community, nei enterprise |
Nustatykite vieną iš jų |
edition=… but enterprise.enabled=… |
Šios dvi reikšmės nesutampa | Nustatykite enterprise.enabled: true tik tada, kai edition yra enterprise |
global.imageRegistry is required |
Nenurodytas registras | Nustatykite registrą, iš kurio jūsų mazgai atsisiunčia atvaizdus |
hosts.<name> is required |
Trūksta viešojo pagrindinio kompiuterio | Nustatykite hosts.console, hosts.api ir hosts.auth |
tls.existingSecret is required when tls.mode is existing |
Nenurodytas sertifikato Secret objektas | Nurodykite Secret objektą arba pasirinkite kitą tls.mode |
tls.clusterIssuer is required when tls.mode is cert-manager |
Nenurodytas išdavėjas | Nurodykite savo ClusterIssuer |
dataTier.<store>.external.host is required when mode is external |
Išorinė saugykla be adreso | Nurodykite jos pagrindinį kompiuterį ir jos Secret objektą existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
helm template neturi klasterio, kuriame juos būtų galima rasti |
Nurodykite API serverio adresus kaip /32 intervalus |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
Sugeneruotas raktas nexus-generated yra netinkamo pavidalo |
Žr. „Atnaujinimo klaidos“ aukščiau |
Reikšmių failą, kuriame naudojamas diagramoje nesantis raktas arba netinkamo tipo reikšmė, diagramos schema atmeta prieš visas šias patikras. telemetry.enabled: true yra vienas pavyzdys: schema priima tik false.
Pagalbos paketo siuntimas
Jei niekas iš to nepadeda, kartu su pagalbos užklausa nusiųskite Adverant pagalbos rinkinį.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number> yra užklausos, kurią pateikėte savo paskyros puslapyje „Pagalba ir pagalbos rinkiniai“, numeris. Tą patį rinkinį galite sukurti konsolės puslapyje „Pagalbos rinkinys“, skiltyje „Šis diegimas“.
Rinkinyje yra paskutinių 24 valandų variklių žurnalai, būsenos ir versijų informacija, nustatymai be slaptųjų duomenų bei išankstinės patikros ir diegimo ataskaitos. Prieš jį įrašant, redagavimas pakeičia vardus, slaptuosius duomenis ir adresus, o jūs peržiūrite tiksliai tai, kas bus perduota. Žmonių pranešimai, failai ir atmintis niekada nerenkami.
Įkelkite jį prie užklausos savo paskyroje arba, jei diegimas neturi išorinio ryšio, išsaugokite jį laikmenoje ir išneškite. Jį gali atidaryti tik užklausoje nurodyti pagalbos inžinieriai, o po 30 dienų jis ištrinamas. Užklausoje nurodykite, kurią iš aukščiau aprašytų problemų nagrinėjote ir ką parodė šio skyriaus patikros: taip išvengsite papildomo susirašinėjimo.


