PrijavaRezervirajte predstavitev

Poglavje 2.17

Odpravljanje težav

Težave, s katerimi se upravljavci najpogosteje srečujejo, razvrščene glede na opažene simptome. Pri vsaki so navedeni vzrok, ukaz za potrditev in rešitev, poglavje pa se zaključi s pošiljanjem podpornega paketa.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

22 min branja

Večina težav pri namestitvi sistema Nexus se zgodi na enakih nekaj več kot deset načinov in skoraj vse se oglasijo s kodo. To poglavje je urejeno glede na to, kar vidite, v približno takšnem vrstnem redu, v kakršnem bi naleteli na posamezno težavo: namestitev, prevzem, licenciranje in nato delovanje. Za vsako dobite vzrok, ukaz, ki ga potrdi, in rešitev.

Primeri uporabljajo namestitev organizacije Harrow Port Authority: imenski prostor nexus, izdaja nexus, gostitelji console.harrow.example, api.harrow.example in auth.harrow.example. Zamenjajte jih s svojimi. Tri navade prihranijo čas pri vsaki tukaj opisani težavi:

  1. Preberite kodo pred sporočilom. Vsaka zavrnitev v sistemu Nexus se konča s strojno kodo in po teh kodah je urejeno kazalo tega poglavja.
  2. Po vsaki spremembi gruče ali datoteke z vrednostmi znova zaženite nexusctl preflight. Ta prebere gručo, ne da bi jo spremenil, in večino zavrnitev paketa chart sporoči po imenu, še preden to stori Helm.
  3. Uporabite --explain pri vsakem glagolu ukaza nexusctl, o katerem niste prepričani. Izpiše operacije kubectl in helm, ne da bi jih izvedel.

Namestitev obvisi

Zagnali ste namestitev, vendar se ni dokončala. helm se po petnajstih minutah ni vrnil ali pa se je vrnil in so podi še vedno v stanju Init ali Pending oziroma se naslov konzole ne odziva.

Najpogostejši vzrok je helm install --wait. Nexus ustvari svojo podatkovno zbirko, vloge in shemo vsake storitve v kavljih po namestitvi (post-install hooks), kavelj za začetni zagon (bootstrap hook) pa je tisti, ki vsaki storitvi preda geslo za njeno podatkovno zbirko. Pri uporabi --wait Helm čaka, da so objekti Deployment pripravljeni, preden zažene te kavlje, medtem ko objekti Deployment čakajo na kavlje. Nič se ne premakne. Nikoli ne nameščajte z --wait; namestite brez te zastavice in počakajte po tem.

Navpično zaporedje okvirov, povezanih s puščicami navzdol: »Ustvarjeni viri izdaje (objekti Deployment se zaženejo, vsakega zadržuje njegov začetni vsebnik wait-for-schema)«, nato »Kavelj za začetni zagon podatkovne zbirke: podatkovna zbirka, vloge, glavna knjiga izdaj«, nato »Migracijski kavlji, eden na storitev, v določenem vrstnem redu«, nato »Vsak kavelj zapiše svojo vrstico v glavno knjigo izdaj«. Iz zadnjega okvira se puščice pahljačasto razširijo vstran do treh manjših okvirov »nexus-auth se zažene«, »nexus-gateway se zažene«, »druge storitve se zaženejo«. Stranska opomba poleg zgornjega okvira s prečrtano puščico proti dnu: »helm install --wait tukaj čaka na objekte Deployment, ki čakajo na kavlje«.
Kaj se v vrstnem redu izvede, ko se paket chart namesti ali nadgradi.

Drugi vzroki so običajni za Kubernetes. Slik ni mogoče prevzeti (pull), ker global.imageRegistry navaja napačen register ali pa namestitev Enterprise nima žetona za prevzem. Nosilec ostane v stanju Pending, ker razred shranjevanja (storage class) ne obstaja. Manjka cert-manager, pri čemer namestitev sploh ne obvisi: odpove v nekaj sekundah, ker izdajatelji potrdil v paketu chart potrebujejo vire komponente cert-manager.

Začnite s podi in opravili Job kavljev:

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 v svojih dogodkih prikaže napake pri prevzemu slik in nevezane nosilce. Opravilo Job kavlja, ki prikazuje 0/1 dokončanj z neuspešnim podom, je ustavilo namestitev, saj imajo opravila Job kavljev omejitev ponovnih poskusov (backoff limit) nastavljeno na 0 in se nikoli tiho ne ponovijo. Njegov dnevnik pove, zakaj.

Tukaj je opisano, kako odpraviti posamezen vzrok:

  • Če Helm čaka z zastavico --wait, ga ustavite, odstranite namestitev in znova namestite brez zastavice. Nato počakajte na storitve:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Pri napakah prevzema preverite global.imageRegistry, za izdajo Enterprise pa žeton za prevzem s strani z žetoni za prevzem in ukazi za namestitev v vašem računu.
  • Za nosilce v stanju Pending nastavite storage.className na razred shranjevanja, ki ga gruča ima, ali pa enega določite kot privzetega.
  • Če manjka cert-manager, namestite cert-manager v1.21.3 in znova zaženite namestitev.
  • Pri neuspešnem kavlju odpravite tisto, kar navaja njegov dnevnik, in znova zaženite namestitev.

Pod čaka na svojo shemo

Pod storitve več minut ostaja v stanju Init:0/1. Vsaka storitev, ki uporablja podatkovno zbirko, ima začetni vsebnik (init container), wait-for-schema, ki zadržuje pod, dokler glavna knjiga izdaj (release ledger) ne pokaže, da so bile njene migracije za sliko te izdaje izvedene. To je običajno v prvih minutah namestitve ali nadgradnje, medtem ko se izvajajo migracijski kavlji. Težava nastane, ko se to ne konča.

Preberite dnevnik začetnega vsebnika:

kubectl -n nexus logs <pod-name> -c wait-for-schema

Dnevnik navede komponento, migracijske verige, na katere čaka, in svojo časovno omejitev, nato pa izpiše vrstico vsakič, ko se njegovo stanje spremeni:

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
Vrstica napredka pravi Kaj pomeni
Katere verige je še treba uveljaviti za to izdajo Imenovani migracijski kavlji se še niso dokončali. Poglejte ta opravila Job.
Da glavne knjige izdaj ni mogoče prebrati, skupaj z napako podatkovne zbirke Postgres se ne odziva ali pa glavna knjiga ne obstaja, ker se začetni zagon podatkovne zbirke ni izvedel.
FAILED (<component>): after <n>s, … Obupal je po schemaWait.timeoutSeconds (privzeto 1.800). Začetni vsebnik se znova zažene; sama storitev se sploh ni zagnala.

Veriga, ki se nikoli ne uveljavi, skoraj vedno pomeni, da je njeno migracijsko opravilo Job spodletelo. Poiščite ga z kubectl -n nexus get jobs in preberite njegov dnevnik. Odpravite tisto, kar navaja (poln disk, zunanja podatkovna zbirka, ki je migrator ne more doseči, spor glede vlog), in zaženite helm upgrade z istimi vrednostmi: kavlji se znova izvedejo in vsakega je varno znova zagnati.

Zvišajte schemaWait.timeoutSeconds le takrat, ko je migracija počasna in zdrava, kakršna je lahko velika prva migracija na počasni shrambi. Zviševanje te vrednosti z namenom prikrivanja neuspešnega opravila Job povzroči le, da pod dlje časa čaka na nekaj, kar se ne bo nikoli zgodilo.

Shramba ključev je zapečatena

Po izpadu električne energije, ponovnem zagonu vozlišča ali ponovnem zagonu izvajalnega okolja vsebnikov se podi vrnejo in konzola se naloži, vse, kar potrebuje ključ, pa odpove ali čaka. Odklepalnik (unsealer) se po vsakem ponovnem zagonu svojega vozlišča zažene zaklenjen (sealed), shramba ključev pa se ne more sama odkleniti, dokler ni odprt odklepalnik.

Povprašajte OpenBao v vsakem podu:

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 $?"

Izhodna koda 0 pomeni odklenjeno, 2 pomeni zaklenjeno, 1 pa pomeni, da ni mogel odgovoriti (vprašajte znova čez eno minuto). Enako zaženite proti openbao-0 z -tls-server-name=openbao za shrambo ključev. Če je odklepalnik odklenjen, shramba ključev pa ne, se shramba ključev pravkar odklepa sama; počakajte eno minuto.

Za odpravo zaklenjenega odklepalnika eden od skrbnikov ključev (custodian) zažene skript unseal.sh iz paketa chart s svojo lastno identiteto age. Poglavje 2.15, Drugi dan: upravljanje sistema Nexus, vsebuje celoten ukaz. Izhodna koda skripta vam pove, kaj se je zgodilo:

Izhodna koda Pomen Kaj storiti
0 Odklenjeno V eni minuti preverite kubectl -n nexus get deploy,statefulset.
1 Še vedno zapečateno ali pa klic za odpečatenje ni uspel Preberite vrstice o deležih, ki jih je izpisal; zaženite ga znova.
2 Manjka predpogoj Sporočilo ga poimenuje: AGE_IDENTITY, binarna datoteka, kot je age ali jq, ali nastavitev neposrednega načina.
3 Ta identiteta ne more dešifrirati deležev Niste skrbnik ključev te namestitve. Nič ni bilo oddano. Poiščite skrbnika ključev, ki to je.

Prijava prek protokola HTTP ni mogoča

Konzola se naloži na naslovu http:// ali prek posredovanja vrat kubectl port-forward na 127.0.0.1, prijava pa ne uspe. Poziv za potrdilo passkey se sploh ne prikaže ali pa se prijava v zanki vrača na začetek.

Prijava potrebuje lastni izvor HTTPS konzole. Konzola sprejme prijavo samo iz https://<hosts.console>, sejo hrani v piškotku __Host- z oznako Secure (ki ga brskalnik shrani le prek protokola HTTPS), potrdilo passkey prvega skrbnika pa potrebuje stran z veljavnim digitalnim potrdilom. Brskalniki zavrnejo potrdila passkey za napako digitalnega potrdila. Posredovanje vrat (port-forward) na http://127.0.0.1 se ne more nikoli prijaviti.

Preverite, kaj je brskalnik dejansko dosegel:

curl -sI https://console.harrow.example
kubectl -n nexus get ingress

Prvi bi moral odgovoriti prek protokola HTTPS z digitalnim potrdilom, ki mu vaš računalnik zaupa. Drugi bi moral prikazati tri gostitelje z imeni, ki ste jih nastavili v hosts.*.

Za odpravo težave odprite konzolo na https://console.harrow.example, točnem imenu v hosts.console, z digitalnim potrdilom, ki mu brskalnik zaupa. Pri tls.mode: existing preverite, ali tls.existingSecret vsebuje potrdilo za vse tri gostitelje. Pri tls.mode: cert-manager preverite, ali ga je izdal ClusterIssuer. Pri tls.mode: none se protokol Transport Layer Security (TLS) zaključi na vašem lastnem izravnalniku obremenitve in tam mora biti potrdilo pravilno. Pri zasebnem overitelju digitalnih potrdil namestite njegovo potrdilo na računalnike, s katerih se prijavljajo vaši skrbniki.

Koda za prevzem je potekla

Na strani Prevzem te namestitve stran zavrne kodo s CLAIM_CODE_EXPIRED (410). Koda za prevzem je sestavljena iz treh skupin po štiri znake. Deluje enkrat, 30 minut, s 5 poskusi. Po tem ali po petem napačnem poskusu postane neveljavna, nič pa ni bilo prevzeto ali spremenjeno.

Ustvarite novo kodo v terminalu, ki ima dostop do gruče:

nexusctl claim-code --administrator aoife.brennan@harrow.example

Izpiše svežo kodo in prstni odtis namestitve. Vnesite kodo na strani za prevzem v 30 minutah in znova primerjajte prstni odtis.

Prevzemi to namestitev
Prevzemi to namestitev
Prevzem te namestitve. Koda iz terminala se vnese v treh skupinah, stran pa za primerjavo prikaže celoten prstni odtis v skupinah po štiri; pretečena koda je zavrnjena s CLAIM_CODE_EXPIRED in nič ni prevzeto.

Dva sorodna odgovora:

  • RATE_LIMITED (429) na strani za prevzem pomeni, da je bilo na strani v zadnji minuti opravljenih več poskusov. Počakajte toliko sekund, kot je navedeno. Če teh poskusov niste opravili vi, stran poskuša uporabiti nekdo drug v vašem omrežju; ugotovite, kdo, preden opravite prevzem.
  • TRANSITION_NOT_PERMITTED (409) pomeni, da je namestitev že prevzeta in je njena stran za prevzem trajno izklopljena. Namesto tega se prijavite. Če je niste prevzeli vi, to obravnavajte kot varnostni incident.

Prstni odtis se ne ujema

Stran za prevzem prikaže CLAIM_FINGERPRINT_MISMATCH (403) ali pa sami vidite, da se osem skupin po štiri znake na strani razlikuje od tistih, ki jih je izpisal vaš terminal. Že ena sama drugačna skupina pomeni, da brskalnik komunicira z drugo namestitvijo.

Ustavite se. Ne vpisujte kode na to stran. Na tem naslovu morda odgovarja nekaj drugega kot vaša namestitev, po možnosti sistem, postavljen za prestrezanje prvega skrbnika. Če bi jo prevzeli, bi ta sistem dobil nadzor nad vašo organizacijo. Vaša lastna namestitev je nespremenjena in še vedno neprevzeta.

Preverite, kam kaže ime in katero digitalno potrdilo je odgovorilo:

nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.example

Naslov mora pripadati vašemu krmilniku vstopnih točk (ingress controller), potrdilo pa mora biti tisto, ki ste ga namestili za hosts.console.

Prstni odtis se ne ujema
Prstni odtis se ne ujema
Prstna odtisa se razlikujeta v treh od osmih skupin. Stran vam naroči, da se ustavite, pojasni, kdo bi lahko odgovarjal, in navede, kaj je treba preveriti pred ponovnim poskusom.

Za odpravo težave predajte svoji varnostni ekipi naslov, ki je odgovoril, in shranite dnevnik namestitve, v katerem je zabeležen prstni odtis, ki ga je izpisala namestitev. Popravite zapis v sistemu domenskih imen (DNS) ali posredniški strežnik (proxy), ki vas je preusmeril drugam. Nato ustvarite novo kodo za prevzem z nexusctl claim-code --administrator <email> in opravite prevzem v brskalniku v omrežju, ki mu zaupate, ter znova primerjajte vseh osem skupin.

Licenca je zavrnjena

Uvoz na strani Uvoz licence, Uvoz nove licence ali nexusctl licence import odgovori z zavrnitvijo. Zavrnjen uvoz ne spremeni ničesar: veljavna licenca ostane v veljavi in spodnja časovna meja (clock floor) se ne premakne.

Preberite kodo in korak:

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

Telo zavrnitve vsebuje code, message, refused_at (korak, ki ni uspel) in troubleshooting. Če želite videti stanje veljavne licence, preberite GET https://auth.harrow.example/api/v1/installation/licence/state z istim žetonom.

Koda HTTP Običajni vzrok Rešitev
LICENCE_SIGNATURE_INVALID 422 Datoteka je bila urejena, preoblikovana ali znova shranjena ali pa manjka en podpis Znova jo prenesite iz svojega računa in jo uvozite nedotaknjeno
LICENCE_FORMAT_INVALID 422 Ni licenca: napačna datoteka, okrnjena ali ovita v drug objekt Pošljite datoteko natanko takšno, kot vam jo je dal Adverant
LICENCE_ROOT_UNKNOWN 422 Podpisana s ključem, ki ga ta izdaja ne vsebuje Nadgradite ali zaprosite za licenco, podpisano za vašo izdajo
LICENCE_MATRIX_MISMATCH 422 Napisana za novejšo matriko izdaj ali pa dodeljuje skupino, ki je ta gradnja ne pozna Nadgradite ali zaprosite za licenco, napisano za vašo izdajo
LICENCE_OTHER_INSTALLATION 409 Izdana za drugo namestitev, pogosto licenca testne gruče v produkciji Zaprosite za licenco za identiteto te namestitve
LICENCE_REVOKED 403 Adverant jo je umaknil Zaprosite Adverant za novo licenco
LICENCE_LOCKED 403 Njen starts_on je po trenutnem datumu Uvozite jo na njen prvi dan ali po njem
TRANSITION_NOT_PERMITTED 409 Ta id licence je bil že uvožen Ničesar ni treba storiti, če je v veljavi; obrnite se na Adverant, če se morajo pogoji spremeniti
RECORD_NOT_FOUND 404 Namestitev še ni bila deklarirana, zato še nima identitete Dokončajte korak prvega skrbnika in nato uvozite
TENANT_NOT_A_PARAMETER 403 Telo zahtevka na najvišji ravni imenuje organizacijo Kot telo zahtevka pošljite samo licenčno datoteko

Dve stvari sta videti kot težavi z licenco, vendar to nista. Branje stanja, ki vsebuje LICENCE_CLOCK_BEHIND_FLOOR, pomeni, da ura vozlišča kaže zgodnejši čas od najnovejšega časa, ki ga je namestitev že zaznala; popravite čas vozlišča, in če je ura prehitevala ter s seboj premaknila spodnjo časovno mejo, zaprosite Adverant za žeton za ponastavitev časa. Licenca, ki se uvozi, a še vedno prikazuje skupino kot predogled (teaser), te skupine običajno ne dodeljuje: pred vsem drugim preberite dodelitve na strani licence.

UI ne vrača odgovorov

Pomočnik z umetno inteligenco (UI) prikaže MODEL_NOT_CONNECTED (503), korak delovnega toka odpove s NO_PROVIDER_FOR_ROLE (422) ali pa se odgovori preprosto ustavijo.

Nabor ključev organizacije nima ključa, ki bi lahko odgovoril, ali pa usmerjevalnik ne more doseči ponudnika. Vsaka organizacija prinese svoj lastni ključ modela. Če v uporabi ni nobenega ključa, UI zasnovano ne deluje in noben deljeni ključ ne vskoči kot zamenjava.

Preverite nabor ključev in izbiro usmerjevalnika, vsakega z lastnim žetonom za dostop zadevne osebe:

GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective

Prvi izpiše vsakega ponudnika, ali lahko odgovori in zakaj ne (»No key in use: 1 withdrawn, 1 lapsed«), ter stanje vsakega ključa. Drugi odgovori z modelom, ki bi ga usmerjevalnik uporabil za organizacijo, ali pa z besedami opiše svojo zavrnitev. Nato preverite pot iz gruče s tema dvema ukazoma:

kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gateway

Kaj pomeni posamezna ugotovitev:

Ugotovitev Rešitev
V naboru ni ključa Lastnik ali skrbnik doda ključ organizacije na preklopni plošči UI ali v Nastavitve, Modeli UI
Ključi v stanju invalid, expired ali exhausted Dodajte svež ključ; stari ostane naveden kot zgodovina
Ključi v stanju resting Počakajte: ključ, ki odpoveduje, počiva 60 sekund, po 5 zaporednih napakah pa se izklopi (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE s ključi v uporabi Vloga nima dodelitve in nič se ne ujema; nastavite vlogo v pravilniku usmerjanja
MODEL_CAPABILITY_UNAVAILABLE (422) Zahteva potrebuje zmogljivost ali lokacijo hrambe podatkov (residency), ki je ne ponuja noben ponudnik v naboru; omogočite takšnega, ki jo ponuja
Ni pravilnika nexus-operator-egress ali pa v njem manjkajo obsegi ponudnika Dodajte obsege, zapisane v notaciji Classless Inter-Domain Routing (CIDR), v networkPolicy.externalEgressCIDRs in nadgradite
Lokalni strežnik modela, ki se ne odziva Preverite ai.localProvider.baseUrl, navedite strežnik v ai.installationHosts in dovolite njegov obseg v networkPolicy.externalEgressCIDRs

Ključ gostujočega ponudnika, ki deluje iz prenosnika, na namestitvi pa odpove, je skoraj vedno posledica omrežnega pravilnika. Imenski prostor privzeto zavrača izhodni promet (egress).

Odgovori 429

Odjemalec prejme odgovor 429 Too Many Requests. Nexus ima štiri mesta, ki lahko to sporočijo, telo odgovora pa vam pove, katero je.

Kje Koda in podrobnosti Kaj spremeniti
nexus-auth, na prijavljeno osebo RATE_LIMITED z limit, windowSeconds in retryAfterSeconds auth.rateLimitPerMinute (privzeto 5000), za obsežno avtomatizacijo
Omejitev ključa skripta, aplikacije ali enote (Enterprise) RATE_LIMITED z navedbo ključa in njegove omejitve Omejitev v Nastavitve, Omejitve hitrosti, z navedbo razloga
Stran za prevzem ob prvem zagonu RATE_LIMITED z retry_after_seconds Nič: počakajte in ugotovite, kdo drug še poskuša uporabiti stran
Ponudnik modela Usmerjevalnik to obravnava kot prehodno napako in se premakne k naslednjemu ponudniku Dodajte še en ključ ali ponudnika, če se to pogosto dogaja

Vsak izmed njih vsebuje glavo Retry-After. Pravilno delujoč odjemalec počaka toliko časa in ne poskuša znova prej.

Če je videti, kot da si vsi uporabniki hkrati delijo eno omejitev, preverite proxy.trustedCIDRs. Ko ta ne pokriva omrežja podov vašega krmilnika vstopnih točk (ingress controller), nexus-auth ne more zaupati glavi X-Forwarded-For in vsako zahtevo vidi, kot da prihaja od krmilnika. Privzeta vrednost, 10.42.0.0/16, ustreza samo okolju k3s.

kubectl get pods -A -o wide

V izpisu poiščite naslov poda krmilnika vstopnih točk in poskrbite, da ga proxy.trustedCIDRs pokriva.

Napake pri nadgradnji

Nadgradnja je bila povrnjena v prejšnje stanje. Stran Nadgradnja prikazuje UPGRADE_ROLLED_BACK: korak ni uspel, vsi pogoni so znova na prejšnji izdaji in podatki niso bili spremenjeni. Stran poimenuje ta korak. Pogost primer je nosilec, ki je premajhen za novo razporeditev shrambe. Odpravite tisto, kar navaja, znova zaženite nexusctl upgrade plan --bundle <file> in nato uveljavite. Najprej se znova ustvari varnostna kopija.

Paket chart zavrne upodabljanje z EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Objekt Secret nexus-generated hrani EXTERNAL_KEY_ENCRYPTION_KEY v obliki, ki je paket chart ne more uporabiti. Biti mora zapis base64 32 bajtov ali surovi 32-bajtni ključ starejše namestitve. Nekdo je uredil ali zamenjal objekt Secret. Vrnite ključ, pod katerim so zaklenjeni podatki te namestitve, kot zapis base64 njegovih 32 bajtov (printf %s "$OLD" | base64), in znova nadgradite. Ne dovolite paketu chart, da ustvari novega: podatki, zaklenjeni pod starim ključem, bi ostali neberljivi.

Skripti so po nadgradnji zavrnjeni z TOKEN_ORG_MISSING. Vsaka storitev, ki preverja ključe aplikacijskega programskega vmesnika (API) prek komponente nexus-auth, zdaj zavrne ključ brez organizacije z 403 TOKEN_ORG_MISSING. Vsakemu takemu ključu dodelite organizacijo ali izdajte nov ključ.

Ključi eno uro poročajo napačno aplikacijo. Izpraznite predpomnjene vnose ključev v predpomnilniku komponente nexus-auth, to je v shrambi Valkey namestitve. Poglavje 2.15, Drugi dan: upravljanje sistema Nexus, vsebuje ukaz za shrambo v gruči in za zunanjo shrambo.

Migracijski kavelj ni uspel. helm upgrade poroča o neuspešnem kavlju pred nadgradnjo (pre-upgrade hook). Shema se premakne, preden se uvedejo novi podi, tako da delujoča izdaja še vedno streže prometu. Preberite dnevnik opravila Job z kubectl -n nexus logs job/<job-name>, odpravite tisto, kar navaja, in znova zaženite nadgradnjo.

Storitve nekaj sekund niso mogle uporabljati svojih tabel. Ob prvi nadgradnji namestitve, narejene iz starejšega paketa chart, vsaka storitev izgubi svoje stare privzete pravice do tabel in dobi nazaj svoje lastne iz svoje lastne migracije. Premor traja nekaj sekund. Nadgradite v mirnem obdobju ali pa storitve najprej zmanjšajte (scale) na nič.

Izdaja na disku je bila zavrnjena. Uvoz z medija prikaže MEDIA_SIGNATURE_INVALID (422): datoteke niso podpisane s ključem izdaje, nameščenim v tej namestitvi. Nič ni bilo naloženo in delujoča izdaja deluje naprej. Medij shranite za svojo varnostno ekipo in prek izmenjave brez povezave zaprosite Adverant za nov medij.

Zavrnitev izrisa paketa Helm (chart)

helm install, helm upgrade ali helm template se ustavi, preden se kar koli uveljavi, s sporočilom, ki se začne s kodo ali poimenuje vrednost. Paket chart zavrne vrednosti, ki jih ne more varno izvajati. V gruči se ni nič spremenilo.

Upodobite paket chart samostojno, da vidite vsako zavrnitev, ne da bi se dotaknili gruče. V izdaji Enterprise uporabite preneseni paket chart Enterprise namesto naslova oci:// in v vrednostih nastavite networkPolicy.apiServerCIDRs, saj upodabljanje brez povezave tega ne more prebrati iz gruče:

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

Predhodni pregled (preflight) preveri iste vrednosti identitete v svojem razdelku »time and keys« in poroča iste kode. Njegova izhodna koda je 0, ko se namestitev lahko nadaljuje (opozorila ne blokirajo), 1, ko vsaj eno preverjanje ni uspelo, in 2, ko se ni mogel izvesti.

Predpoletni pregled se ne more nadaljevati
Predpoletni pregled se ne more nadaljevati
Predhodni pregled se ne more nadaljevati. Neuspešna preverjanja so prikazana na prvem mestu, vsako s svojo rešitvijo, namestitev pa ostane blokirana s PREFLIGHT_FAILED, dokler niso uspešno opravljena.
Zavrnitev Vzrok Rešitev
INSTALLATION_NAME_MISSING keys.installationName je prazen Nastavite ga na lastno ime te namestitve, ki se ujema z ^[a-z][a-z0-9-]{0,62}$. Ko se shramba ključev prvič zažene, postane trajno
INSTALLATION_NAME_EXAMPLE Ime je tisto iz primerov datotek z vrednostmi v paketu chart Nastavite svoje lastno ime
keys.installationName "…" does not match … Velike črke, podčrtaji ali vodilna števka Uporabite male črke, števke in vezaje, pri čemer mora biti prvi znak črka
KEYS_CUSTODIAN_MISSING keys.custody.recipients je prazen Navedite prejemnike age svojih skrbnikov ključev, to je javne polovice
KEYS_CUSTODIAN_EXAMPLE Prejemnik je primer skrbnika ključev iz datotek z vrednostmi v paketu chart, katerega identitete nima nihče Zamenjajte ga s prejemniki svojih lastnih skrbnikov ključev
keys.custody.recipients: … Prejemnik v obliki, za katero opravilo Job skrbništva ne more šifrirati Uporabite age1…, age1tag1…, age1tagpq1…, age1pq1… ali age1se1…, z malimi črkami
NEXUS_EDITION_INVALID edition ni niti community niti enterprise Nastavite eno od obeh vrednosti
edition=… but enterprise.enabled=… Vrednosti se ne ujemata Nastavite enterprise.enabled: true natanko takrat, ko je edition nastavljen na enterprise
global.imageRegistry is required Noben register ni imenovan Nastavite register, iz katerega vaša vozlišča prevzemajo slike
hosts.<name> is required Manjka javni gostitelj Nastavite hosts.console, hosts.api in hosts.auth
tls.existingSecret is required when tls.mode is existing Imenovan ni noben objekt Secret za digitalno potrdilo Poimenujte objekt Secret ali izberite drug tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Imenovan ni noben izdajatelj Poimenujte svoj ClusterIssuer
dataTier.<store>.external.host is required when mode is external Zunanja shramba brez naslova Podajte njenega gostitelja in njen objekt Secret v existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template nima gruče, v kateri bi jih lahko poiskal Podajte naslove strežnika API kot obsege /32
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID Ustvarjeni ključ v nexus-generated ima napačno obliko Glejte »Napake pri nadgradnji« zgoraj

Datoteko z vrednostmi, ki uporablja ključ, ki ga paket chart nima, ali vrednost napačne vrste, shema paketa chart zavrne pred vsemi temi preverjanji. telemetry.enabled: true je en tak primer: shema sprejme samo false.

Pošiljanje podpornega paketa

Če nič od tega ne odpravi težave, pošljite podjetju Adverant paket za podporo (support bundle) skupaj s svojo zahtevo za podporo.

nexusctl support-bundle --out harrow-support-<request-number>.tar.gz

<request-number> je številka zahteve, ki ste jo odprli na strani Podpora in paketi za podporo v svojem računu. Enak paket lahko ustvarite na strani Paket za podporo v konzoli pod razdelkom Ta namestitev.

Paket vsebuje dnevnike pogonov iz zadnjih 24 ur, podrobnosti o zdravju in različicah, nastavitve brez njihovih skrivnosti ter poročili o predhodnem pregledu in namestitvi. Preden se zapiše, redakcija zamenja imena, skrivnosti in naslove, vi pa preberete predogled točno tistega, kar bo poslano. Sporočila, datoteke in spomin oseb se nikoli ne zbirajo.

Naložite ga k zahtevi v svojem računu ali pa ga shranite na medij in prenesite, če namestitev nima zunanje povezave. Odprejo ga lahko samo inženirji podpore, imenovani na zahtevi, po 30 dneh pa se izbriše. V zahtevi navedite, katero od zgornjih težav ste reševali in kaj so pokazala preverjanja v tem poglavju: s tem prihranite eno izmenjavo sporočil.