PrisijungtiUžsisakyti pristatymą

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

22 min. skaitymo

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ą:

  1. Pirmiausia perskaitykite kodą, tik tada pranešimą. Kiekvienas Nexus atsisakymas baigiasi mašininiu kodu, ir būtent pagal kodą sudarytas šio skyriaus turinys.
  2. 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.
  3. Naudokite --explain su bet kuriuo nexusctl veiksmažodžiu, dėl kurio nesate tikri. Jis išspausdina kubectl ir helm operacijas 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.

Vertikali langelių seka, sujungta žemyn nukreiptomis rodyklėmis: „Sukuriami laidos ištekliai (Deployments paleidžiami, kiekvieną sulaiko jo wait-for-schema init konteineris)“, tada „Duomenų bazės paruošimo kabliukas: duomenų bazė, vaidmenys, laidų žurnalas“, tada „Migracijos kabliukai, po vieną kiekvienai paslaugai, nustatyta tvarka“, tada „Kiekvienas kabliukas įrašo savo eilutę laidų žurnale“. Iš paskutinio langelio rodyklės išsiskleidžia į šonus link trijų mažų langelių: „paleidžiamas nexus-auth“, „paleidžiamas nexus-gateway“, „paleidžiamos kitos paslaugos“. Šalia viršutinio langelio yra šoninė pastaba su perbraukta rodykle į apačią: „helm install --wait čia laukia Deployments, kurie laukia kabliukų“.
Kas ir kokia tvarka vykdoma, kai chart diegiamas ar atnaujinamas.

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

describe 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 Pending tomams, nustatykite storage.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 ingress

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

Jis išspausdina naują kodą ir diegimo kontrolinį kodą (fingerprint). Per 30 minučių įveskite kodą perėmimo puslapyje ir dar kartą palyginkite kontrolinį kodą.

Perimti šią įdiegtą sistemą
Perimti šią įdiegtą sistemą
Perimti šį diegimą. Kodas iš terminalo įvedamas trimis grupėmis, o puslapyje rodomas visas kontrolinis kodas grupėmis po keturis palyginimui; nebegaliojantis kodas atmetamas su CLAIM_CODE_EXPIRED, ir niekas neperimama.

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

Adresas turėtų būti jūsų ingress valdiklio, o sertifikatas turėtų būti tas, kurį įdiegėte hosts.console.

Kontrolinis kodas nesutampa
Kontrolinis kodas nesutampa
Kontroliniai kodai skiriasi trijose iš aštuonių grupių. Puslapis nurodo sustoti, paaiškina, kas galėtų atsakyti, ir išvardija, ką patikrinti prieš bandant dar kartą.

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

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

Ką 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 wide

Iš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.yaml

Iš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.

Išankstinės patikros tęsti negalima
Išankstinės patikros tęsti negalima
Išankstinės patikros tęsti negalima. Pirmiausia pateikiamos nepavykusios patikros, kiekviena su pataisymu, o diegimas lieka užblokuotas su PREFLIGHT_FAILED, kol jos bus išlaikytos.
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.