Različica 1.0.0-alpha.1najnovejša
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

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:
- 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.
- 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. - Uporabite
--explainpri vsakem glagolu ukazanexusctl, o katerem niste prepričani. Izpiše operacijekubectlinhelm, 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.
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.iodescribe 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
Pendingnastavitestorage.classNamena 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-schemaDnevnik 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 ingressPrvi 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.exampleIzpiše svežo kodo in prstni odtis namestitve. Vnesite kodo na strani za prevzem v 30 minutah in znova primerjajte prstni odtis.
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.exampleNaslov mora pripadati vašemu krmilniku vstopnih točk (ingress controller), potrdilo pa mora biti tisto, ki ste ga namestili za hosts.console.
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.jsonTelo 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-gatewayKaj 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 wideV 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.yamlPredhodni 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.
| 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.


