PrijavaRezervirajte prezentaciju

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

22 min čitanja

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:

  1. Pročitajte kod prije poruke. Svako odbijanje u sustavu Nexus završava strojnim kodom, a ovo je poglavlje indeksirano upravo prema tim kodovima.
  2. Ponovno pokrenite nexusctl preflight nakon 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.
  3. Upotrijebite --explain na bilo kojoj naredbi alata nexusctl u koju niste sigurni. Ispisat će operacije za kubectl i helm bez 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.

Okomiti niz okvira povezanih strelicama prema dolje: "Stvoreni resursi izdanja (pokreću se resursi Deployment, svaki zadržan svojim inicijalizacijskim kontejnerom wait-for-schema)", zatim "Hook za inicijalizaciju baze podataka: baza podataka, uloge, glavna knjiga izdanja", zatim "Migracijski hookovi, jedan po usluzi, fiksnim redoslijedom", zatim "Svaki hook zapisuje svoj redak u glavnu knjigu izdanja". Iz posljednjeg okvira strelice se šire bočno prema tri mala okvira "nexus-auth se pokreće", "nexus-gateway se pokreće", "ostale usluge se pokreću". Bočna napomena pored gornjeg okvira, s prekriženom strelicom prema dnu: "helm install --wait ovdje čeka na resurse Deployment koji čekaju na hookove".
Što se pokreće, po redu, kada se chart instalira ili nadograđuje.

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

describe 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.imageRegistry i, 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, postavite storage.className na 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-schema

Zapisnik 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 ingress

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

Ispisat će svježi kod i otisak (fingerprint) instalacije. Unesite kod na stranici za preuzimanje u roku od 30 minuta i ponovno usporedite otisak.

Preuzmi ovu instalaciju
Preuzmi ovu instalaciju
Preuzmi ovu instalaciju. Kod iz terminala unosi se u tri grupe, a stranica prikazuje puni otisak u grupama od po četiri znaka radi usporedbe; istekli kod odbija se uz CLAIM_CODE_EXPIRED i ništa se ne preuzima.

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

Adresa bi trebala pripadati vašem ingress kontroleru, a certifikat bi trebao biti onaj koji ste instalirali za hosts.console.

Otisak se ne podudara
Otisak se ne podudara
Otisci se razlikuju u tri od osam grupa. Stranica kaže da stanete, objašnjava tko bi mogao odgovarati i navodi što treba provjeriti prije ponovnog pokušaja.

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

Tijelo 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 wide

Pronađ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.yaml

Predprovjera (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.

Predprovjera se ne može nastaviti
Predprovjera se ne može nastaviti
Predprovjera se ne može nastaviti. Prvo se prikazuju neuspjele provjere, svaka sa svojim rješenjem, a instalacija ostaje blokirana uz PREFLIGHT_FAILED dok one ne prođu.
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.