Versioon 1.0.0-alpha.1uusim
Peatükk 2.17
Tõrkeotsing
Probleemid, millega operaatorid kõige sagedamini kokku puutuvad, järjestatuna sümptomite järgi. Iga punkti juures on toodud põhjus, seda kinnitav käsk ja lahendus ning peatükk lõpeb rikketoe paketi saatmisega.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Enamik sellest, mis Nexuse paigaldusel valesti läheb, juhtub samal tosinal viisil ja pea kõik neist annavad endast märku veakoodiga. See peatükk on üles ehitatud selle järgi, mida te näete, umbkaudu samas järjekorras, nagu te iga probleemiga kokku puutuksite: paigaldamine, omastamine, litsentsimine ja seejärel käitamine. Iga probleemi puhul tuuakse välja põhjus, seda kinnitav käsk ja lahendus.
Näidetes kasutatakse Harrow Port Authority paigaldust: nimeruum nexus, väljalase nexus, hostid console.harrow.example, api.harrow.example ja auth.harrow.example. Asendage need enda omadega. Kolm harjumust säästavad siin iga probleemi puhul aega:
- Lugege enne teadet koodi. Iga keeldumine Nexuses lõpeb masinkoodiga ja see peatükk on indekseeritud just selle koodi järgi.
- Käivitage
nexusctl preflightuuesti pärast iga muudatust klastris või väärtuste failis. See loeb klastrit ilma seda muutmata ja teatab enamikust paketi keeldumistest nimepidi enne, kui Helm seda teeb. - Kasutage lippu
--explainiganexusctltegusõnaga, milles te pole kindel. See kuvabkubectljahelmtoimingud ilma neid käivitamata.
Paigaldus jääb ootele
Käivitasite paigalduse ja see pole lõppenud. helm pole viieteistkümne minuti pärast tagasi pöördunud või pöördus tagasi, kuid podid on endiselt olekus Init või Pending, või konsooli aadress ei vasta.
Kõige tavalisem põhjus on helm install --wait. Nexus loob oma andmebaasi, rollid ja iga teenuse skeemi paigaldusjärgsetes haakides (post-install hooks) ning alglaadimishaak on see, mis annab igale teenusele üle selle andmebaasi parooli. Lipuga --wait ootab Helm enne nende haakide käivitamist, kuni Deploymentid on valmis, samal ajal kui Deploymentid ootavad haake. Kumbki ei liigu edasi. Ärge kunagi paigaldage lipuga --wait; paigaldage ilma selleta ja oodake pärast.
Teised põhjused on tavalised Kubernetese omad. Tõmmiseid ei saa alla laadida, kuna global.imageRegistry nimetab vale registri või puudub Enterprise'i paigaldusel tõmbamisluba (pull token). Andmekandja jääb olekusse Pending, kuna salvestusklassi pole olemas. cert-manager puudub, millisel juhul paigaldus ei jää üldse ootele: see nurjub sekunditega, sest paketi sertifikaatide väljaandjad vajavad cert-manageri ressursse.
Alustage podidest ja haakide Jobidest:
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 näitab oma sündmustes tõmmiste tõmbamise vigu ja sidumata andmekandjaid. Haagi Job, mis näitab 0/1 lõpetamist nurjunud podiga, on paigalduse peatanud, sest haagi Jobide tagasipõrke limiit (backoff limit) on 0 ja neid ei proovita kunagi vaikselt uuesti. Selle logi ütleb, miks.
Siin on juhised iga põhjuse lahendamiseks:
- Kui Helm ootab lipuga
--wait, peatage see, eemaldage paigaldus ja paigaldage uuesti ilma liputa. Seejärel oodake teenuseid:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Tõmbamisvigade korral kontrollige väärtust
global.imageRegistryja Enterprise'i puhul tõmbamisluba oma konto lehelt „Pull tokens and install commands”. - Olekus
Pendingandmekandjate puhul määrakestorage.classNameväärtuseks salvestusklass, mis klastris olemas on, või muutke üks neist vaikimisi klassiks. - Puuduva cert-manageri korral paigaldage cert-manager v1.21.3 ja käivitage paigaldus uuesti.
- Nurjunud haagi korral parandage see, mida selle logi nimetab, ja käivitage paigaldus uuesti.
Pod ootab oma skeemi
Teenuse pod püsib minutite kaupa olekus Init:0/1. Igal andmebaasi kasutaval teenusel on lähtestuskonteiner (init container) wait-for-schema, mis hoiab podi kinni, kuni väljalaske pearaamat (release ledger) näitab, et selle väljalaske tõmmise migratsioonid on rakendatud. See on paigalduse või uuendamise esimestel minutitel, mil migratsioonihaagid töötavad, täiesti tavaline. Probleem on see siis, kui see ei lõpe.
Lugege lähtestuskonteineri logi:
kubectl -n nexus logs <pod-name> -c wait-for-schemaLogi nimetab komponendi, migratsiooniahelad, mida see ootab, ja ajalimiidi ning prindib seejärel rea iga kord, kui selle olek muutub:
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
| Edenemisrida ütleb | Mida see tähendab |
|---|---|
| Millised ahelad tuleb selle väljalaske jaoks veel rakendada | Nimetatud migratsioonihaagid pole lõpetanud. Vaadake neid Jobe. |
| Et väljalaske pearaamatut ei saa lugeda, koos andmebaasi veaga | Postgres ei vasta või pearaamatut pole olemas, kuna andmebaasi alglaadimine pole käivitunud. |
FAILED (<component>): after <n>s, … |
See loobus pärast schemaWait.timeoutSeconds möödumist (vaikimisi 1800). Lähtestuskonteiner taaskäivitub; teenus ise ei käivitunudki. |
Ahel, mida kunagi ei rakendata, tähendab peaaegu alati, et selle migratsiooni Job nurjus. Leidke see käsuga kubectl -n nexus get jobs ja lugege selle logi. Parandage see, mida logi nimetab (täis ketas, väline andmebaas, milleni migreerija ei ulatu, rollikonflikt) ja käivitage helm upgrade samade väärtustega: haagid käivituvad uuesti ja igaüht neist on ohutu uuesti käivitada.
Suurendage väärtust schemaWait.timeoutSeconds ainult siis, kui migratsioon on aeglane ja korras, nagu suur esimene migratsioon aeglasel salvestusseadmel võib olla. Selle suurendamine nurjunud Jobi varjamiseks paneb podi lihtsalt kauem ootama midagi, mida kunagi ei tule.
Võtmehoidla on suletud (sealed)
Pärast elektrikatkestust, sõlme taaskäivitust või konteineri käituskeskkonna taaskäivitust tulevad podid tagasi ja konsool laadib end ära, kuid kõik, mis vajab võtit, nurjub või ootab. Lahtipitseerija (unsealer) käivitub pärast iga oma sõlme taaskäivitust pitseerituna ning võtmehoidla ei saa ennast lahti pitseerida enne, kui lahtipitseerija on avatud.
Küsige OpenBaolt igas podis:
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 $?"Väljumiskood 0 tähendab lahtipitseeritud, 2 pitseeritud ja 1 tähendab, et see ei saanud vastata (küsige minuti pärast uuesti). Käivitage sama võtmehoidla jaoks openbao-0 vastu lipuga -tls-server-name=openbao. Kui lahtipitseerija on lahti pitseeritud ja võtmehoidla ei ole, siis võtmehoidla pitseerib end parajasti lahti; andke sellele minut aega.
Pitseeritud lahtipitseerija parandamiseks käivitab üks võtmehoidja (custodian) paketi skripti unseal.sh omaenda age-identiteediga. Peatükis 2.15, „Teine päev: Nexuse käitamine”, on täielik käsk. Skripti väljumiskood ütleb teile, mis juhtus:
| Väljumiskood | Tähendus | Mida teha |
|---|---|---|
| 0 | Lahti pitseeritud | Kontrollige kubectl -n nexus get deploy,statefulset minuti jooksul. |
| 1 | Endiselt pitseeritud või avamispäring ebaõnnestus | Lugege osakute ridu, mille see printis; käivitage see uuesti. |
| 2 | Eeltingimus puudub | Teade nimetab selle: AGE_IDENTITY, binaarfail nagu age või jq, või otserežiimi seadistus. |
| 3 | See identiteet ei saa osakuid dekrüpteerida | Te ei ole selle paigalduse võtmehoidja. Midagi ei esitatud. Leidke võtmehoidja, kes on. |
Üle HTTP ei saa sisse logida
Konsool laadib aadressil http:// või läbi kubectl port-forward suunamisega 127.0.0.1 peale, kuid sisselogimine nurjub. Passkey viip ei ilmu kunagi või suunab sisselogimine algusesse tagasi.
Sisselogimine vajab konsooli enda HTTPS-päritolu (origin). Konsool aktsepteerib sisselogimist ainult aadressilt https://<hosts.console>, hoiab seanssi __Host- küpsises märkega Secure (mida brauser salvestab ainult üle HTTPS-i) ning esimese administraatori passkey vajab kehtiva sertifikaadiga lehte. Brauserid keelduvad passkeydest sertifikaadivea taga. Pordi edasisuunamine (port-forward) teenusele http://127.0.0.1 ei saa kunagi sisse logida.
Kontrollige, milleni brauser tegelikult jõudis:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressEsimene peaks vastama üle HTTPS-i sertifikaadiga, mida teie masin usaldab. Teine peaks näitama kolme hosti nimedega, mille määrasite võtmes hosts.*.
Selle parandamiseks avage konsool aadressil https://console.harrow.example, mis on täpne nimi võtmes hosts.console, sertifikaadiga, mida brauser usaldab. Väärtuse tls.mode: existing puhul kontrollige, et tls.existingSecret sisaldaks sertifikaati kõigi kolme hosti jaoks. Väärtuse tls.mode: cert-manager puhul kontrollige, et ClusterIssuer oleks selle välja andnud. Väärtuse tls.mode: none puhul lõpeb transpordikihi turbeprotokoll (TLS) teie enda koormusejaoturis ja just seal peab sertifikaat õige olema. Privaatse sertifitseerimiskeskuse puhul paigaldage selle sertifikaat masinatesse, kust teie administraatorid sisse logivad.
Omastamiskood on aegunud
Lehel „Claim this installation” lükkab leht koodi tagasi veaga CLAIM_CODE_EXPIRED (410). Omastamiskood (claim code) koosneb kolmest neljakohalisest tähemärkide rühmast. See töötab ühe korra, 30 minutit ja 5 katsega. Pärast seda või pärast viiendat valet katset on see kehtetu ning midagi ei omastatud ega muudetud.
Looge uus kood terminalist, millel on juurdepääs klastrile:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleSee prindib värske koodi ja paigalduse sõrmejälje. Sisestage kood omastamislehele 30 minuti jooksul ja võrrelge sõrmejälge uuesti.
Kaks seotud vastust:
RATE_LIMITED(429) omastamislehel tähendab, et lehel on viimase minuti jooksul tehtud mitu katset. Oodake vastuses antud sekundite arv. Kui teie neid katseid ei teinud, proovib lehte keegi teine teie võrgus; enne omastamist tehke kindlaks, kes see on.TRANSITION_NOT_PERMITTED(409) tähendab, et paigaldus on juba omastatud ja selle omastamisleht on jäädavalt välja lülitatud. Logige selle asemel sisse. Kui teie seda ei omastanud, käsitlege seda turvaintsidendina.
Sõrmejälg ei klapi
Omastamisleht näitab viga CLAIM_FINGERPRINT_MISMATCH (403) või näete ise, et lehel olevad kaheksa neljast rühma erinevad nendest, mille teie terminal printis. Isegi ühe rühma erinevus tähendab, et brauser suhtleb teise paigaldusega.
Peatuge. Ärge sisestage koodi sellele lehele. Sellel aadressil võib vastata miski muu peale teie paigalduse, võimalik, et masin, mis on üles seatud esimese administraatori püüdmiseks. Kui te selle omastaksite, saaks see masin teie organisatsiooni endale. Teie enda paigaldus on muutmata ja endiselt omastamata.
Kontrollige, kuhu nimi viitab ja milline sertifikaat vastas:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleAadress peaks olema teie ingress-kontrolleri oma ja sertifikaat peaks olema see, mille paigaldasite hosti hosts.console jaoks.
Selle lahendamiseks andke oma turvameeskonnale vastanud aadress ja hoidke alles paigalduslogi, kus on kirjas paigalduse prinditud sõrmejälg. Parandage domeeninimede süsteemi (DNS) kirje või puhverserver, mis teid mujale suunas. Seejärel looge käsuga nexusctl claim-code --administrator <email> uus omastamiskood ja omastage paigaldus brauserist võrgus, mida usaldate, võrreldes uuesti kõiki kaheksat rühma.
Litsents lükatakse tagasi
Importimine lehel „Import the licence”, „Import a new licence” või liideses nexusctl licence import vastab keeldumisega. Tagasilükatud import ei muuda midagi: kehtiv litsents jääb kehtima ja kella alamtsiht (clock floor) ei liigu.
Lugege koodi ja sammu:
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.jsonKeeldumise sisu sisaldab välju code, message, refused_at (nurjunud samm) ja troubleshooting. Kehtiva litsentsi oleku nägemiseks lugege sama loaga aadressi GET https://auth.harrow.example/api/v1/installation/licence/state.
| Kood | HTTP | Tavaline põhjus | Lahendus |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Faili muudeti, vormindati ümber või salvestati uuesti või puudub üks allkiri | Laadige see oma kontolt uuesti alla ja importige puutumatul kujul |
LICENCE_FORMAT_INVALID |
422 | Pole litsents: vale fail, kärbitud või mähitud teise objekti sisse | Saatke fail täpselt nii, nagu Adverant selle andis |
LICENCE_ROOT_UNKNOWN |
422 | Allkirjastatud võtmega, mida sellel väljalaskel pole | Uuendage süsteemi või küsige oma väljalaske jaoks allkirjastatud litsentsi |
LICENCE_MATRIX_MISMATCH |
422 | Kirjutatud uuema väljaandemaatriksi jaoks või annab õiguse rühmale, mida see järk (build) ei tunne | Uuendage süsteemi või küsige oma väljalaske jaoks kirjutatud litsentsi |
LICENCE_OTHER_INSTALLATION |
409 | Välja antud teisele paigaldusele, sageli testklastri litsents toodanguklastris | Küsige litsentsi selle paigalduse identiteedi jaoks |
LICENCE_REVOKED |
403 | Adverant tühistas selle | Küsige Adverantilt uus litsents |
LICENCE_LOCKED |
403 | Selle starts_on on praegusest kuupäevast hilisem |
Importige see selle esimesel kehtivuspäeval või pärast seda |
TRANSITION_NOT_PERMITTED |
409 | See litsentsi ID on juba imporditud | Kui see kehtib, pole vaja midagi teha; kui tingimused peavad muutuma, küsige Adverantilt |
RECORD_NOT_FOUND |
404 | Paigaldust pole deklareeritud, seega pole sel veel identiteeti | Lõpetage esimese administraatori samm, seejärel importige |
TENANT_NOT_A_PARAMETER |
403 | Päringu sisu nimetab oma kõrgeimal tasemel organisatsiooni | Saatke päringu sisuna ainult litsentsifail |
Kaks asja näevad välja nagu litsentsiprobleemid, kuid ei ole seda. Oleku lugemine, mis sisaldab väärtust LICENCE_CLOCK_BEHIND_FLOOR, tähendab, et sõlme kell näitab varasemat aega kui hiliseim aeg, mida paigaldus on näinud; parandage sõlme kellaaeg ja kui kell oli ette jooksnud ning kella alamtsihi endaga kaasa vedanud, küsige Adverantilt aja lähtestamise luba (time-reset token). Ja litsents, mis küll imporditakse, kuid näitab rühma endiselt eelvaatena (teaser), tavaliselt seda rühma ei võimalda: lugege enne kõike muud litsentsilehelt antud õigusi (grants).
AI vastuseid ei tule
Tehisintellekti (AI) assistent näitab viga MODEL_NOT_CONNECTED (503), töövoo samm nurjub veaga NO_PROVIDER_FOR_ROLE (422) või vastused lihtsalt lakkavad.
Organisatsiooni kogumis (pool) pole ühtegi võtit, mis saaks vastata, või marsruuter ei ulatu teenusepakkujani. Iga organisatsioon toob kaasa oma mudelivõtme. Kui ühtegi võtit pole kasutusel, siis AI-d kavandatult ei ole ja ükski jagatud võti seda ei asenda.
Kontrollige kogumit ja marsruuteri valikut, mõlemat kasutaja enda juurdepääsuloaga:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
Esimene loetleb iga teenusepakkuja, kas see saab vastata ja miks mitte („No key in use: 1 withdrawn, 1 lapsed”) ning iga võtme oleku. Teine vastab mudeliga, mida marsruuter organisatsiooni jaoks kasutaks, või selle keeldumisega sõnades. Seejärel kontrollige teekonda klastrist välja nende kahe käsuga:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayMida iga leid tähendab:
| Leid | Lahendus |
|---|---|
| Kogumis pole ühtegi võtit | Omanik või administraator lisab organisatsiooni võtme AI kommutaatoris (AI switchboard) või lehel Settings, AI models |
Võtmed olekus invalid, expired või exhausted |
Lisage värske võti; vana jääb ajaloona nimekirja |
Võtmed olekus resting |
Oodake: tõrkuv võti puhkab 60 sekundit ja pärast 5 järjestikust tõrget lülitatakse see välja (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE koos kasutusel olevate võtmetega |
Rollil pole määramist ja miski ei sobi; määrake roll marsruutimispoliitikas |
MODEL_CAPABILITY_UNAVAILABLE (422) |
Päring vajab võimekust või andmete asukohta (residency), mida ükski kogumis olev teenusepakkuja ei paku; lubage mõni, mis seda pakub |
Puudub nexus-operator-egress poliitika või puuduvad sellest teenusepakkuja aadressivahemikud |
Lisage klassideta domeenidevahelise marsruutimise (CIDR) tähistuses kirjutatud vahemikud võtmesse networkPolicy.externalEgressCIDRs ja uuendage paigaldust |
| Kohalik mudeliserver, mis ei vasta | Kontrollige väärtust ai.localProvider.baseUrl, lisage server loendisse ai.installationHosts ja lubage selle vahemik võtmes networkPolicy.externalEgressCIDRs |
Majutatud teenusepakkuja võti, mis töötab sülearvutist, kuid nurjub paigaldusel, viitab peaaegu alati võrgupoliitikale. Nimeruum keelab vaikimisi väljuva liikluse (egress).
429 vastused
Kliendile vastatakse veaga 429 Too Many Requests. Nexuses on neli kohta, mis võivad seda öelda, ja vastuse sisu ütleb teile, milline neist.
| Kus | Kood ja üksikasjad | Mida muuta |
|---|---|---|
| nexus-auth, sisseloginud isiku kohta | RATE_LIMITED koos väljadega limit, windowSeconds ja retryAfterSeconds |
auth.rateLimitPerMinute (vaikimisi 5000), mahuka automatiseerimise jaoks |
| Skriptivõtme, rakenduse või üksuse piirang (Enterprise) | RATE_LIMITED, mis nimetab võtme ja selle piirangu |
Piirang lehel Settings, Rate limits, koos põhjendusega |
| Esmakäivituse omastamisleht | RATE_LIMITED koos väljaga retry_after_seconds |
Mitte midagi: oodake ja uurige välja, kes veel lehte proovib |
| Mudeli teenusepakkuja | Marsruuter käsitleb seda mööduva tõrkena ja liigub järgmise teenusepakkuja juurde | Lisage teine võti või teenusepakkuja, kui seda juhtub sageli |
Igaüks neist kannab päist Retry-After. Korrektselt käituv klient ootab nii kaua ega proovi varem uuesti.
Kui tundub, et kõik kasutajad korraga jagavad ühte piirangut, kontrollige väärtust proxy.trustedCIDRs. Kui see ei kata teie ingress-kontrolleri podide võrku, ei saa nexus-auth uskuda päist X-Forwarded-For ja näeb iga päringut kontrollerist tulevana. Vaikeväärtus 10.42.0.0/16 sobib ainult k3s-ile.
kubectl get pods -A -o wideLeidke väljundist ingress-kontrolleri podi aadress ja veenduge, et proxy.trustedCIDRs katab selle.
Versiooniuuenduse vead
Uuendus pöörati tagasi. Uuendamise leht (Upgrade) näitab olekut UPGRADE_ROLLED_BACK: samm nurjus, kõik mootorid on tagasi eelmisel väljalaskel ja andmeid ei muudetud. Leht nimetab selle sammu. Sage põhjus on andmekandja, mis on hoidla uue paigutuse jaoks liiga väike. Parandage nimetatud probleem, käivitage nexusctl upgrade plan --bundle <file> uuesti ja seejärel rakendage. Esmalt tehakse uuesti varukoopia.
Pakett keeldub renderdamast veaga EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Secret nexus-generated hoiab väärtust EXTERNAL_KEY_ENCRYPTION_KEY kujul, mida pakett ei saa kasutada. See peab olema 32 baidi base64-kuju või vanema paigalduse toores 32-baidine võti. Keegi muutis Secretit või asendas selle. Pange tagasi võti, mille alla selle paigalduse andmed on pitseeritud, selle 32 baidi base64-kujul (printf %s "$OLD" | base64), ja uuendage uuesti. Ärge laske paketil uut luua: vana võtme alla pitseeritud andmed jääksid loetamatuks.
Skriptid lükatakse pärast uuendust tagasi veaga TOKEN_ORG_MISSING. Iga teenus, mis kontrollib rakendusliidese (API) võtmeid läbi nexus-authi, keeldub nüüd ilma organisatsioonita võtmest veaga 403 TOKEN_ORG_MISSING. Andke igale sellisele võtmele organisatsioon või väljastage uus võti.
Võtmed teatavad tund aega valet rakendust. Tühjendage vahemällu salvestatud võtmekirjed nexus-authi vahemälus, mis asub paigalduse Valkey hoidlas. Peatükis 2.15, „Teine päev: Nexuse käitamine”, on käsk nii klastri-sisese kui ka välise hoidla jaoks.
Migratsioonihaak nurjus. helm upgrade teatab nurjunud uuenduseelsest haagist (pre-upgrade hook). Skeem liigub enne uute podide käivitumist, seega töötav väljalase teenindab endiselt edasi. Lugege Jobi logi käsuga kubectl -n nexus logs job/<job-name>, parandage seal nimetatud probleem ja käivitage uuendus uuesti.
Teenused ei saanud mõne sekundi jooksul oma tabeleid kasutada. Varasemast paketist tehtud paigalduse esimesel uuendamisel kaotab iga teenus oma vanad vaikimisi tabeliõigused ja saab enda omad tagasi omaenda migratsioonist. Vahe on mõni sekund. Uuendage vaiksel perioodil või skaleerige teenused esmalt nulli.
Kettal olev väljalase lükati tagasi. Andmekandjalt importimine näitab viga MEDIA_SIGNATURE_INVALID (422): failid ei ole allkirjastatud sellele paigaldusele paigaldatud väljalaskevõtmega. Midagi ei laaditud ja töötav väljalase töötab edasi. Hoidke andmekandja oma turvameeskonna jaoks alles ja küsige Adverantilt võrguvälise vahetuse kaudu uus andmekandja.
Helm-charti renderdamisest keeldumine
helm install, helm upgrade või helm template peatub enne millegi rakendamist teatega, mis algab koodiga või nimetab väärtuse. Pakett keeldub väärtustest, millega see ei saa ohutult töötada. Klastris ei muutunud midagi.
Renderdage pakett eraldi, et näha iga keeldumist ilma klastrit puutumata. Kasutage Enterprise'i puhul aadressi oci:// asemel allalaaditud Enterprise'i paketti ja määrake väärtustes networkPolicy.apiServerCIDRs, sest võrguväline renderdus ei saa seda klastrist lugeda:
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.yamlEelkontroll (preflight) kontrollib samu identiteediväärtusi oma jaotises „time and keys” ja teatab samad koodid. Selle väljumiskood on 0, kui paigaldusega saab edasi minna (hoiatused ei blokeeri), 1, kui vähemalt üks kontroll nurjus, ja 2, kui see ei saanud käivituda.
| Keeldumine | Põhjus | Lahendus |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName on tühi |
Määrake selleks paigalduse enda nimi, mis vastab mustrile ^[a-z][a-z0-9-]{0,62}$. See on püsiv, kui võtmehoidla esimest korda käivitub |
INSTALLATION_NAME_EXAMPLE |
Nimi on sama, mis paketi näidisväärtuste failides | Määrake omaenda nimi |
keys.installationName "…" does not match … |
Suurtähed, alakriipsud või number alguses | Kasutage väiketähti, numbreid ja sidekriipse, alustades tähega |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients on tühi |
Loetlege oma võtmehoidjate age-saajad (recipients), st avalikud pooled |
KEYS_CUSTODIAN_EXAMPLE |
Saaja on paketi väärtuste failide näidisvõtmehoidja, kelle identiteeti pole kellelgi | Asendage see omaenda võtmehoidjate saajatega |
keys.custody.recipients: … |
Saaja on kujul, millele võtmehalduse Job ei saa krüpteerida | Kasutage väiketähtedega väärtust age1…, age1tag1…, age1tagpq1…, age1pq1… või age1se1… |
NEXUS_EDITION_INVALID |
edition ei ole community ega enterprise |
Määrake üks neist kahest |
edition=… but enterprise.enabled=… |
Need kaks on vastuolus | Määrake enterprise.enabled: true täpselt siis, kui edition on enterprise |
global.imageRegistry is required |
Ühtegi registrit pole nimetatud | Määrake register, kust teie sõlmed tõmmiseid tõmbavad |
hosts.<name> is required |
Avalik host puudub | Määrake hosts.console, hosts.api ja hosts.auth |
tls.existingSecret is required when tls.mode is existing |
Ühtegi sertifikaadi Secretit pole nimetatud | Nimetage Secret või valige teine tls.mode |
tls.clusterIssuer is required when tls.mode is cert-manager |
Ühtegi väljaandjat pole nimetatud | Nimetage oma ClusterIssuer |
dataTier.<store>.external.host is required when mode is external |
Ilma aadressita väline hoidla | Andke selle host ja selle Secret võtmes existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
Käsk helm template ei oma klastrit, kust neid otsida |
Andke API-serveri aadressid /32 vahemikena |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
Genereeritud võti võtmes nexus-generated on vale kujuga |
Vt ülal „Uuendamisvead” |
Väärtuste fail, mis kasutab võtit, mida paketil pole, või valet tüüpi väärtust, lükatakse paketi skeemi poolt tagasi enne kõiki neid kontrolle. telemetry.enabled: true on üks näide: skeem aktsepteerib ainult väärtust false.
Rikketoe paketi saatmine
Kui miski sellest probleemi ei lahenda, saatke Adverantile koos oma tugipäringuga tugipakett (support bundle).
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number> on päringu number, mille avasite oma konto lehel „Support and support bundles”. Sama paketi saate luua konsooli lehelt „Support bundle” jaotise „This installation” alt.
Pakett sisaldab viimase 24 tunni mootorilogisid, tervise- ja versiooniandmeid, seadistusi ilma saladusteta ning eelkontrolli ja paigalduse aruandeid. Enne paketi kirjutamist asendab redigeerimine nimed, saladused ja aadressid ning te näete täpset eelvaadet sellest, mis välja saadetakse. Inimeste sõnumeid, faile ja mälu ei koguta kunagi.
Laadige see üles oma kontol oleva päringu juurde või salvestage andmekandjale ja viige välja, kui paigaldusel puudub välisühendus. Seda saavad avada ainult päringus nimetatud tugiinsenerid ja see kustutatakse 30 päeva pärast. Märkige päringus, millist ülaltoodud probleemidest te uurisite ja mida selles peatükis toodud kontrollid näitasid: see säästab edasi-tagasi suhtlust.


