Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.17
Rješavanje problema
Problemi s kojima se operateri najčešće susreću, organizirani prema onome što vidite. Za svaki se navodi uzrok, naredba koja ga potvrđuje i rješenje, a poglavlje završava slanjem paketa za podršku.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Većina problema pri instalaciji sustava Nexus javlja se na istih desetak načina, a gotovo svaki od njih najavljuje se kodom. Ovo je poglavlje organizirano prema onome što vidite, otprilike redoslijedom kojim biste nailazili na pojedini problem: instaliranje, preuzimanje vlasništva, licenciranje i zatim rad. Za svaki problem navedeni su uzrok, naredba koja ga potvrđuje i rješenje.
Primjeri koriste instalaciju organizacije Harrow Port Authority: imenski prostor nexus, izdanje nexus, poslužitelje console.harrow.example, api.harrow.example i auth.harrow.example. Zamijenite ih svojima. Tri navike štede vrijeme kod svakog ovdje opisanog problema:
- Pročitajte kod prije poruke. Svako odbijanje u sustavu Nexus završava strojnim kodom, a ovo je poglavlje indeksirano upravo prema tim kodovima.
- Ponovno pokrenite
nexusctl preflightnakon svake promjene na klasteru ili u datoteci s vrijednostima. Ta naredba čita klaster bez njegovog mijenjanja i prijavljuje većinu odbijanja charta po imenu prije nego što to učini Helm. - Upotrijebite
--explainna bilo kojoj naredbi alatanexusctlu koju niste sigurni. Ispisat će operacije zakubectlihelmbez njihovog izvršavanja.
Instalacija je zastala
Pokrenuli ste instalaciju i ona nije završila. helm se nije vratio nakon petnaest minuta, ili se vratio, ali su podovi još uvijek u stanju Init ili Pending, ili adresa konzole ne odgovara.
Najčešći je uzrok helm install --wait. Nexus stvara svoju bazu podataka, uloge i shemu svake usluge u hookovima nakon instalacije, a inicijalizacijski (bootstrap) hook je taj koji svakoj usluzi predaje njezinu zaporku za bazu podataka. Uz --wait, Helm čeka da resursi Deployment budu spremni prije nego što pokrene te hookove, dok resursi Deployment čekaju na hookove. Ništa se ne pomiče. Nikada nemojte instalirati uz --wait; instalirajte bez te zastavice i pričekajte nakon toga.
Ostali su uzroci uobičajeni za Kubernetes. Slike se ne mogu povući jer global.imageRegistry navodi pogrešan registar ili instalacija izdanja Enterprise nema token za povlačenje. Volumen ostaje u stanju Pending jer klasa pohrane ne postoji. Nedostaje cert-manager, u kojem slučaju instalacija uopće ne zapne: ne uspijeva u roku od nekoliko sekundi jer izdavatelji certifikata iz charta trebaju resurse alata cert-manager.
Započnite s podovima i poslovima (Jobs) hookova:
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 u svojim događajima prikazuje pogreške pri povlačenju slika i nepovezane volumene. Posao (Job) hooka koji prikazuje 0/1 dovršetaka uz neuspjeli pod zaustavio je instalaciju jer poslovi hookova imaju ograničenje ponovnih pokušaja (backoff limit) postavljeno na 0 i nikada se ne ponavljaju tiho. Njegov zapisnik govori zašto.
Evo kako riješiti svaki od uzroka:
- Ako Helm čeka uz
--wait, zaustavite ga, deinstalirajte i ponovno instalirajte bez te zastavice. Zatim pričekajte usluge:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Za pogreške pri povlačenju provjerite
global.imageRegistryi, za izdanje Enterprise, token za povlačenje sa stranice Tokeni za povlačenje i naredbe za instalaciju na vašem računu. - Za volumene u stanju
Pending, postavitestorage.classNamena klasu pohrane koju klaster ima ili jednu od njih postavite kao zadanu. - Ako nedostaje cert-manager, instalirajte cert-manager v1.21.3 i ponovno pokrenite instalaciju.
- Za neuspjeli hook, popravite ono što je navedeno u njegovom zapisniku i ponovno pokrenite instalaciju.
Pod čeka svoju shemu
Pod usluge stoji u stanju Init:0/1 minutama. Svaka usluga koja koristi bazu podataka ima inicijalizacijski kontejner, wait-for-schema, koji zadržava pod sve dok glavna knjiga izdanja (release ledger) ne pokaže da su njezine migracije primijenjene za sliku ovog izdanja. To je normalno u prvim minutama instalacije ili nadogradnje, dok se izvršavaju migracijski hookovi. Problem je kada to ne prestaje.
Pročitajte zapisnik inicijalizacijskog kontejnera:
kubectl -n nexus logs <pod-name> -c wait-for-schemaZapisnik navodi komponentu, migracijske lance koje čeka i svoje vremensko ograničenje, a zatim ispisuje redak svaki put kada se njegovo stanje promijeni:
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
| Redak napretka kaže | Što to znači |
|---|---|
| Koji se lanci još trebaju primijeniti za ovo izdanje | Navedeni migracijski hookovi nisu završili. Pogledajte te poslove (Jobs). |
| Da se glavna knjiga izdanja ne može pročitati, uz pogrešku baze podataka | Postgres ne odgovara ili glavna knjiga ne postoji jer se inicijalizacija (bootstrap) baze podataka nije izvršila. |
FAILED (<component>): after <n>s, … |
Odustao je nakon schemaWait.timeoutSeconds (zadano 1800). Inicijalizacijski kontejner ponovno se pokreće; sama usluga nikada se nije pokrenula. |
Lanac koji se nikada ne primijeni gotovo uvijek znači da njegov migracijski posao (Job) nije uspio. Pronađite ga pomoću kubectl -n nexus get jobs i pročitajte njegov zapisnik. Popravite ono što navodi (pun disk, vanjska baza podataka do koje migrator ne može doći, sukob uloga) i pokrenite helm upgrade s istim vrijednostima: hookovi se ponovno izvršavaju, a svaki od njih siguran je za ponovno pokretanje.
Povećajte schemaWait.timeoutSeconds samo kada je migracija spora i ispravna, kakva može biti velika prva migracija na sporoj pohrani. Povećavanje te vrijednosti kako bi se sakrio neuspjeli posao (Job) samo tjera pod da dulje čeka na nešto što se nikada neće dogoditi.
Spremište ključeva je zapečaćeno
Nakon nestanka struje, ponovnog pokretanja čvora ili ponovnog pokretanja izvršnog okruženja kontejnera, podovi se vraćaju i konzola se učitava, a sve što treba ključ ne uspijeva ili čeka. Servis za otpečaćivanje (unsealer) pokreće se zapečaćen nakon svakog ponovnog pokretanja svog čvora, a spremište ključeva ne može se samo otpečatiti dok servis za otpečaćivanje nije otvoren.
Upitajte OpenBao u svakom 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 $?"Izlazni kod 0 znači otpečaćeno, 2 znači zapečaćeno, a 1 znači da nije mogao odgovoriti (pokušajte ponovno za minutu). Pokrenite isto na openbao-0 s -tls-server-name=openbao za spremište ključeva. Ako je servis za otpečaćivanje otpečaćen, a spremište ključeva nije, spremište ključeva se samo otpečaćuje; dajte mu minutu.
Kako bi popravio zapečaćeni servis za otpečaćivanje, jedan skrbnik ključeva (custodian) pokreće unseal.sh iz charta s vlastitim age identitetom. Poglavlje 2.15, Drugi dan: upravljanje sustavom Nexus, sadrži potpunu naredbu. Izlazni kod skripte govori vam što se dogodilo:
| Izlazni kod | Značenje | Što učiniti |
|---|---|---|
| 0 | Otpečaćeno | Provjerite kubectl -n nexus get deploy,statefulset u roku od minute. |
| 1 | Još uvijek zapečaćeno ili poziv za otpečaćivanje nije uspio | Pročitajte retke udjela koje je ispisao; pokrenite ga ponovno. |
| 2 | Nedostaje preduvjet | Poruka ga navodi: AGE_IDENTITY, binarna datoteka kao što je age ili jq, ili postavka izravnog načina rada. |
| 3 | Ovaj identitet ne može dešifrirati udjele | Vi niste skrbnik ključeva ove instalacije. Ništa nije poslano. Pronađite skrbnika koji jest. |
Ne možete se prijaviti putem protokola HTTP
Konzola se učitava na adresi http://, ili kroz kubectl port-forward na 127.0.0.1, a prijava ne uspijeva. Upit za pristupni ključ (passkey) se nikada ne pojavi ili se prijava u petlji vraća na početak.
Prijava zahtijeva vlastito HTTPS ishodište konzole. Konzola prihvaća prijavu samo s https://<hosts.console>, čuva sesiju u kolačiću __Host- označenom sa Secure (kojeg preglednik pohranjuje samo putem HTTPS-a), a pristupni ključ prvog administratora zahtijeva stranicu s valjanim certifikatom. Preglednici odbijaju pristupne ključeve iza pogreške certifikata. Prosljeđivanje priključka (port-forward) na http://127.0.0.1 nikada ne može izvršiti prijavu.
Provjerite do čega je preglednik zapravo došao:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressPrva bi naredba trebala odgovoriti putem HTTPS-a s certifikatom kojem vaše računalo vjeruje. Druga bi trebala prikazati tri poslužitelja s imenima koja ste postavili u hosts.*.
Da biste to riješili, pristupite konzoli na https://console.harrow.example, točnom imenu u hosts.console, s certifikatom kojem preglednik vjeruje. Uz tls.mode: existing, provjerite sadrži li tls.existingSecret certifikat za sva tri poslužitelja. Uz tls.mode: cert-manager, provjerite je li ga izdao ClusterIssuer. Uz tls.mode: none, Transport Layer Security (TLS) završava na vašem vlastitom ujednačivaču opterećenja (load balancer), i to je mjesto gdje certifikat mora biti ispravan. Za privatno certifikacijsko tijelo, instalirajte njegov certifikat na računala s kojih se vaši administratori prijavljuju.
Kod za preuzimanje je istekao
Na stranici Preuzmi ovu instalaciju stranica odbija kod uz CLAIM_CODE_EXPIRED (410). Kod za preuzimanje sastoji se od tri grupe po četiri znaka. Djeluje jednom, 30 minuta, s 5 pokušaja. Nakon toga, ili nakon petog pogrešnog pokušaja, više ne vrijedi, te ništa nije preuzeto niti promijenjeno.
Izradite novi kod u terminalu koji ima pristup klasteru:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleIspisat će svježi kod i otisak (fingerprint) instalacije. Unesite kod na stranici za preuzimanje u roku od 30 minuta i ponovno usporedite otisak.
Dva povezana odgovora:
RATE_LIMITED(429) na stranici za preuzimanje znači da je stranica imala nekoliko pokušaja u posljednjoj minuti. Pričekajte onoliko sekundi koliko je navedeno. Ako vi niste napravili te pokušaje, netko drugi na vašoj mreži pokušava pristupiti stranici; saznajte tko prije nego što preuzmete instalaciju.TRANSITION_NOT_PERMITTED(409) znači da je instalacija već preuzeta i njezina je stranica za preuzimanje trajno isključena. Umjesto toga se prijavite. Ako je niste vi preuzeli, tretirajte to kao sigurnosni incident.
Otisak se ne podudara
Stranica za preuzimanje prikazuje CLAIM_FINGERPRINT_MISMATCH (403) ili sami možete vidjeti da se osam grupa po četiri znaka na stranici razlikuje od onih koje je ispisao vaš terminal. Čak i jedna različita grupa znači da preglednik komunicira s drugom instalacijom.
Stanite. Nemojte upisivati kod na tu stranicu. Na toj adresi možda odgovara nešto drugo, a ne vaša instalacija, moguće računalo postavljeno da uhvati prvog administratora. Ako biste je preuzeli, to bi računalo imalo kontrolu nad vašom organizacijom. Vaša vlastita instalacija je nepromijenjena i još uvijek nije preuzeta.
Provjerite kamo ime pokazuje i koji je certifikat odgovorio:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleAdresa bi trebala pripadati vašem ingress kontroleru, a certifikat bi trebao biti onaj koji ste instalirali za hosts.console.
Da biste to riješili, dajte svom sigurnosnom timu adresu koja je odgovorila i sačuvajte zapisnik instalacije, koji bilježi otisak koji je instalacija ispisala. Ispravite zapis u sustavu Domain Name System (DNS) ili proxy koji vas je poslao drugamo. Zatim izradite novi kod za preuzimanje pomoću nexusctl claim-code --administrator <email> i preuzmite instalaciju iz preglednika na mreži kojoj vjerujete, ponovno uspoređujući svih osam grupa.
Licencija je odbijena
Uvoz na stranicama Uvezi licencu, Uvezi novu licencu ili nexusctl licence import odgovara odbijanjem. Odbijeni uvoz ništa ne mijenja: licenca na snazi ostaje na snazi, a donja granica sata (clock floor) se ne pomiče.
Pročitajte kod i 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.jsonTijelo odgovora o odbijanju sadrži code, message, refused_at (korak koji nije uspio) i troubleshooting. Da biste vidjeli stanje licence na snazi, pročitajte GET https://auth.harrow.example/api/v1/installation/licence/state s istim tokenom.
| Kod | HTTP | Uobičajeni uzrok | Rješenje |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Datoteka je uređivana, preoblikovana ili ponovno spremljena, ili nedostaje jedan potpis | Ponovno je preuzmite sa svog računa i uvezite netaknutu |
LICENCE_FORMAT_INVALID |
422 | Nije licenca: pogrešna datoteka, skraćena ili omotana u drugi objekt | Pošaljite datoteku točno onako kako vam ju je Adverant dao |
LICENCE_ROOT_UNKNOWN |
422 | Potpisana ključem koji ovo izdanje ne sadrži | Nadogradite sustav ili zatražite licencu potpisanu za vaše izdanje |
LICENCE_MATRIX_MISMATCH |
422 | Napisana za noviju matricu izdanja ili dodjeljuje grupu koju ova međuverzija (build) ne poznaje | Nadogradite sustav ili zatražite licencu napisanu za vaše izdanje |
LICENCE_OTHER_INSTALLATION |
409 | Izdana za drugu instalaciju, često licenca testnog klastera na produkciji | Zatražite licencu za identitet ove instalacije |
LICENCE_REVOKED |
403 | Adverant ju je povukao | Zatražite novu licencu od tvrtke Adverant |
LICENCE_LOCKED |
403 | Njezin starts_on je nakon trenutnog datuma |
Uvezite je na njezin prvi dan ili nakon njega |
TRANSITION_NOT_PERMITTED |
409 | Ovaj ID licence već je uvezen | Ne treba ništa poduzeti ako je na snazi; obratite se tvrtki Adverant ako se uvjeti moraju promijeniti |
RECORD_NOT_FOUND |
404 | Instalacija nije deklarirana, pa još nema identitet | Dovršite korak prvog administratora, a zatim uvezite |
TENANT_NOT_A_PARAMETER |
403 | Tijelo zahtjeva navodi organizaciju na svojoj najvišoj razini | Pošaljite samo datoteku licence kao tijelo zahtjeva |
Dvije stvari izgledaju kao problemi s licencom, a to nisu. Čitanje stanja koje nosi LICENCE_CLOCK_BEHIND_FLOOR znači da sat čvora pokazuje ranije vrijeme od posljednjeg vremena koje je instalacija zabilježila; popravite vrijeme na čvoru, a ako je sat otišao naprijed i povukao donju granicu sa sobom, zatražite od tvrtke Adverant token za poništavanje vremena. Također, licenca koja se uveze, a i dalje prikazuje grupu samo kao najavu (teaser), obično ne dodjeljuje tu grupu: prije svega pročitajte dodijeljena prava na stranici licence.
Nema odgovora AI-ja
Asistent pokretan umjetnom inteligencijom (AI) prikazuje MODEL_NOT_CONNECTED (503), korak tijeka rada ne uspijeva uz NO_PROVIDER_FOR_ROLE (422) ili odgovori jednostavno prestanu stizati.
Skup ključeva organizacije nema ključ koji može odgovoriti ili usmjerivač (router) ne može doći do pružatelja usluge. Svaka organizacija donosi vlastiti ključ modela. Bez ključa u upotrebi nema ni AI-ja, jer je sustav tako zamišljen, i nijedan zajednički ključ ne uskače kao zamjena.
Provjerite skup ključeva i odabir usmjerivača, svaki s vlastitim pristupnim tokenom korisnika:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
Prva naredba ispisuje svakog pružatelja usluge, može li odgovoriti i zašto ne može ("No key in use: 1 withdrawn, 1 lapsed"), te stanje svakog ključa. Druga vraća model koji bi usmjerivač upotrijebio za organizaciju ili njegovo odbijanje riječima. Zatim provjerite put izvan klastera pomoću ove dvije naredbe:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayŠto znači pojedini nalaz:
| Nalaz | Rješenje |
|---|---|
| Nema ključa u skupu | Vlasnik ili administrator dodaje ključ organizacije na AI centrali ili u Postavke, AI modeli |
Ključevi invalid, expired ili exhausted |
Dodajte novi ključ; stari ostaje naveden u povijesti |
Ključevi resting |
Pričekajte: ključ koji ne uspijeva miruje 60 sekundi, a nakon 5 uzastopnih neuspjeha se isključuje (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE s ključevima u upotrebi |
Uloga nema dodjelu i ništa se ne podudara; postavite ulogu u pravilu usmjeravanja |
MODEL_CAPABILITY_UNAVAILABLE (422) |
Zahtjev treba značajku ili rezidentnost podataka koju ne nudi nijedan pružatelj usluga u skupu; omogućite onoga koji to nudi |
Nema pravila nexus-operator-egress ili u njemu nedostaju rasponi pružatelja usluge |
Dodajte raspone, zapisane u notaciji Classless Inter-Domain Routing (CIDR), u networkPolicy.externalEgressCIDRs i nadogradite |
| Lokalni poslužitelj modela koji ne odgovara | Provjerite ai.localProvider.baseUrl, navedite poslužitelj u ai.installationHosts i dopustite njegov raspon u networkPolicy.externalEgressCIDRs |
Ključ hostiranog pružatelja usluga koji radi s prijenosnog računala, a ne uspijeva na instalaciji, gotovo je uvijek problem mrežnog pravila. Imenski prostor prema zadanim postavkama odbija izlazni promet (egress).
Odgovori 429
Klijent dobiva odgovor 429 Too Many Requests. Nexus ima četiri mjesta koja to mogu poslati, a tijelo odgovora govori vam koje je od njih.
| Gdje | Kod i pojedinosti | Što promijeniti |
|---|---|---|
| nexus-auth, po prijavljenoj osobi | RATE_LIMITED s limit, windowSeconds i retryAfterSeconds |
auth.rateLimitPerMinute (zadano 5000), za intenzivnu automatizaciju |
| Ograničenje ključa skripte, aplikacije ili jedinice (Enterprise) | RATE_LIMITED koji navodi ključ i njegovo ograničenje |
Ograničenje u Postavke, Ograničenja brzine (Rate limits), uz navođenje razloga |
| Stranica za preuzimanje pri prvom pokretanju | RATE_LIMITED s retry_after_seconds |
Ništa: pričekajte i saznajte tko još pokušava pristupiti stranici |
| Pružatelj modela | Usmjerivač to tretira kao prolaznu pogrešku i prelazi na sljedećeg pružatelja usluga | Dodajte još jedan ključ ili pružatelja usluga ako se to često događa |
Svaki od njih nosi zaglavlje Retry-After. Ispravno konfiguriran klijent čeka toliko dugo i ne pokušava ponovno prije toga.
Ako se čini da svi korisnici odjednom dijele jedno ograničenje, provjerite proxy.trustedCIDRs. Kada to ne pokriva mrežu podova vašeg ingress kontrolera, nexus-auth ne može vjerovati zaglavlju X-Forwarded-For i vidi svaki zahtjev kao da dolazi od kontrolera. Zadana vrijednost, 10.42.0.0/16, odgovara samo za k3s.
kubectl get pods -A -o widePronađite adresu poda ingress kontrolera u ispisu i provjerite pokriva li je proxy.trustedCIDRs.
Pogreške pri nadogradnji
Nadogradnja je vraćena na prethodno stanje. Stranica Nadogradnja prikazuje UPGRADE_ROLLED_BACK: korak nije uspio, svaki je pogon (engine) vraćen na prethodno izdanje, a podaci nisu promijenjeni. Stranica navodi koji je to korak. Čest je slučaj volumen koji je premalen za novi raspored spremišta. Popravite ono što je navedeno, ponovno pokrenite nexusctl upgrade plan --bundle <file>, a zatim primijenite. Sigurnosna kopija se prvo ponovno izrađuje.
Chart odbija iscrtavanje (renderiranje) uz EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Tajna (Secret) nexus-generated drži EXTERNAL_KEY_ENCRYPTION_KEY u obliku koji chart ne može upotrijebiti. Mora biti u formatu base64 od 32 bajta ili sirovi 32-bajtni ključ starije instalacije. Netko je uredio ili zamijenio tajnu. Vratite ključ pod kojim su zapečaćeni podaci ove instalacije, kao base64 njegovih 32 bajta (printf %s "$OLD" | base64), i ponovno nadogradite. Nemojte dopustiti da chart izradi novi ključ: podaci zapečaćeni pod starim ključem ostali bi nečitljivi.
Skripte se odbijaju uz TOKEN_ORG_MISSING nakon nadogradnje. Svaka usluga koja provjerava ključeve aplikacijskog programskog sučelja (API) putem servisa nexus-auth sada odbija ključ bez organizacije, uz 403 TOKEN_ORG_MISSING. Dodijelite svakom takvom ključu organizaciju ili izdajte novi ključ.
Ključevi prijavljuju pogrešnu aplikaciju sat vremena. Ispraznite predmemorirane unose ključeva u predmemoriji servisa nexus-auth, spremištu Valkey same instalacije. Poglavlje 2.15, Drugi dan: upravljanje sustavom Nexus, sadrži naredbu za spremište unutar klastera i za vanjsko spremište.
Migracijski hook nije uspio. helm upgrade prijavljuje neuspjeli hook prije nadogradnje (pre-upgrade hook). Shema se premješta prije pokretanja novih podova, tako da postojeće izdanje i dalje poslužuje zahtjeve. Pročitajte zapisnik posla (Job) pomoću kubectl -n nexus logs job/<job-name>, popravite ono što navodi i ponovno pokrenite nadogradnju.
Usluge nisu mogle koristiti svoje tablice nekoliko sekundi. Pri prvoj nadogradnji instalacije napravljene iz ranijeg charta, svaka usluga gubi svoja stara zadana prava nad tablicama i dobiva vlastita natrag iz vlastite migracije. Prekid traje nekoliko sekundi. Nadogradite u mirnom razdoblju ili prvo skalirajte usluge na nulu.
Izdanje na disku je odbijeno. Uvoz s medija prikazuje MEDIA_SIGNATURE_INVALID (422): datoteke nisu potpisane ključem izdanja instaliranim na ovoj instalaciji. Ništa nije učitano i postojeće izdanje nastavlja s radom. Sačuvajte medij za svoj sigurnosni tim i zatražite od tvrtke Adverant novi medij putem izvanmrežne razmjene.
Odbijanje iscrtavanja charta
helm install, helm upgrade ili helm template zaustavlja se prije nego što se išta primijeni, uz poruku koja počinje kodom ili navodi vrijednost. Chart odbija vrijednosti koje ne može sigurno pokrenuti. Ništa se na klasteru nije promijenilo.
Iscrtajte (renderirajte) chart samostalno kako biste vidjeli svako odbijanje bez diranja klastera. Upotrijebite Enterprise chart koji ste preuzeli umjesto adrese oci:// na izdanju Enterprise, i postavite networkPolicy.apiServerCIDRs u vrijednostima, jer izvanmrežno iscrtavanje to ne može pročitati iz klastera:
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.yamlPredprovjera (preflight) provjerava iste vrijednosti identiteta u svom odjeljku "vrijeme i ključevi" te prijavljuje iste kodove. Njezin izlazni kod je 0 kada se instalacija može nastaviti (upozorenja ne blokiraju), 1 kada barem jedna provjera nije uspjela, i 2 kada se nije mogla izvršiti.
| Odbijanje | Uzrok | Rješenje |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName je prazno |
Postavite ga na vlastito ime ove instalacije, koje odgovara ^[a-z][a-z0-9-]{0,62}$. Ono postaje trajno čim se spremište ključeva prvi put pokrene |
INSTALLATION_NAME_EXAMPLE |
Ime je ono iz oglednih datoteka s vrijednostima u chartu | Postavite vlastito ime |
keys.installationName "…" does not match … |
Velika slova, podvlake ili početna znamenka | Koristite mala slova, znamenke i crtice, počevši sa slovom |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients je prazno |
Navedite age primatelje vaših skrbnika ključeva, tj. javne polovice ključeva |
KEYS_CUSTODIAN_EXAMPLE |
Primatelj je ogledni skrbnik ključeva iz datoteka s vrijednostima u chartu, čiji identitet nitko ne posjeduje | Zamijenite ga primateljima vaših vlastitih skrbnika ključeva |
keys.custody.recipients: … |
Primatelj u obliku za koji posao (Job) skrbništva ne može izvršiti šifriranje | Upotrijebite age1…, age1tag1…, age1tagpq1…, age1pq1… ili age1se1…, malim slovima |
NEXUS_EDITION_INVALID |
edition nije ni community ni enterprise |
Postavite jedno od to dvoje |
edition=… but enterprise.enabled=… |
Te se dvije vrijednosti ne podudaraju | Postavite enterprise.enabled: true točno onda kada je edition postavljeno na enterprise |
global.imageRegistry is required |
Nije naveden registar | Postavite registar iz kojeg vaši čvorovi povlače slike |
hosts.<name> is required |
Nedostaje javni poslužitelj | Postavite hosts.console, hosts.api i hosts.auth |
tls.existingSecret is required when tls.mode is existing |
Nije navedena tajna (Secret) certifikata | Navedite tajnu ili odaberite drugi tls.mode |
tls.clusterIssuer is required when tls.mode is cert-manager |
Nije naveden izdavatelj | Navedite svoj ClusterIssuer |
dataTier.<store>.external.host is required when mode is external |
Vanjsko spremište bez adrese | Navedite njegovog poslužitelja i njegovu tajnu u existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
helm template nema klaster u kojem bi ih potražio |
Navedite adrese API poslužitelja kao raspone /32 |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
Generirani ključ u nexus-generated ima pogrešan oblik |
Pogledajte "Pogreške pri nadogradnji" iznad |
Datoteku s vrijednostima koja koristi ključ koji chart nema, ili vrijednost pogrešnog tipa, shema charta odbija prije bilo čega od navedenog. telemetry.enabled: true je jedan primjer: shema prihvaća samo false.
Slanje paketa za podršku
Kada ništa od ovoga ne riješi problem, pošaljite tvrtki Adverant paket za podršku (support bundle) uz svoj zahtjev za podršku.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number> je broj zahtjeva koji ste otvorili na stranici Podrška i paketi za podršku na svom računu. Isti paket možete izraditi sa stranice Paket za podršku u konzoli pod Ova instalacija.
Paket sadrži zapisnike pogona iz posljednja 24 sata, pojedinosti o stanju i verziji, postavke bez njihovih tajni te izvješća o predprovjeri i instalaciji. Prije nego što se zapiše, redakcija zamjenjuje imena, tajne i adrese, a vi možete pročitati pretpregled točno onoga što se šalje. Poruke, datoteke i memorija korisnika nikada se ne prikupljaju.
Prenesite ga u zahtjev na svom računu ili ga spremite na medij i iznesite ako instalacija nema vanjsku vezu. Samo inženjeri podrške navedeni na zahtjevu mogu ga otvoriti, a briše se nakon 30 dana. U zahtjevu navedite koji ste od gore navedenih problema proučavali i što su pokazale provjere u ovom poglavlju: to štedi dodatnu prepisku.


