PrijavaZakažite brifing

Poglavlje 2.17

Rešavanje problema

Problemi sa kojima se operateri najčešće susreću, organizovani prema onome što vidite. Za svaki se navode uzrok, komanda koja ga potvrđuje i rešenje, a poglavlje se završava slanjem paketa za podršku.

Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

22 min čitanja

Većina problema na Nexus instalaciji nastaje na istih desetak načina, a gotovo svi se najavljuju kodom. Ovo poglavlje je organizovano prema onome što vidite, otprilike redosledom kojim biste nailazili na svaki problem: instalacija, preuzimanje vlasništva, licenciranje, pa rad. Za svaki problem dobijate uzrok, komandu koja ga potvrđuje i rešenje.

Primeri koriste instalaciju organizacije Harrow Port Authority: imenski prostor nexus, izdanje nexus, hostovi console.harrow.example, api.harrow.example i auth.harrow.example. Zamenite ih svojima. Tri navike štede vreme kod svakog ovde opisanog problema:

  1. Pročitajte kod pre poruke. Svako odbijanje u Nexus-u završava se mašinskim kodom, a ovo poglavlje je indeksirano upravo po kodovima.
  2. Ponovo pokrenite nexusctl preflight nakon svake izmene klastera ili datoteke sa vrednostima. Komanda čita klaster bez menjanja i većinu odbijanja chart-a prijavljuje po nazivu pre nego što to učini Helm.
  3. Koristite --explain uz svaki nexusctl glagol u koji niste sigurni. Ispisuje operacije kubectl i helm bez njihovog izvršavanja.

Instalacija stoji u mestu

Pokrenuli ste instalaciju i ona nije završena. helm se nije vratio ni posle petnaest minuta, ili se vratio, a podovi su i dalje u stanju Init ili Pending, ili adresa konzole ne odgovara.

Najčešći uzrok je helm install --wait. Nexus kreira svoju bazu podataka, svoje uloge i šemu svakog servisa u post-install hook-ovima, a bootstrap hook je taj koji svakom servisu predaje lozinku za bazu podataka. Uz --wait, Helm čeka da Deployment-i budu spremni pre nego što pokrene te hook-ove, dok Deployment-i čekaju hook-ove. Nijedno se ne pomera. Nikada ne instalirajte uz --wait; instalirajte bez toga i sačekajte nakon toga.

Vertikalni niz okvira povezanih strelicama nadole: „Kreirani resursi izdanja (Deployments se pokreću, svaki zadržan svojim wait-for-schema init kontejnerom)“, zatim „Hook za inicijalizaciju baze podataka: baza podataka, uloge, registar izdanja“, zatim „Migracioni hook-ovi, po jedan za svaki servis, utvrđenim redosledom“, zatim „Svaki hook upisuje svoj red u registar izdanja“. Iz poslednjeg okvira strelice se lepezasto šire u stranu ka tri mala okvira „nexus-auth se pokreće“, „nexus-gateway se pokreće“, „ostali servisi se pokreću“. Bočna napomena pored gornjeg okvira, sa precrtanom strelicom ka dnu: „helm install --wait ovde čeka na Deployments koji čekaju na hook-ove“.
Šta se izvršava, i kojim redosledom, kada se chart instalira ili nadograđuje.

Ostali uzroci su uobičajeni za Kubernetes. Slike ne mogu da se preuzmu jer global.imageRegistry navodi pogrešan registar, ili Enterprise instalacija nema token za preuzimanje. Volumen ostaje u stanju Pending jer klasa skladišta ne postoji. Nedostaje cert-manager, i u tom slučaju instalacija uopšte ne zastaje: ne uspeva u roku od nekoliko sekundi, jer izdavaocima sertifikata u chart-u trebaju resursi cert-manager-a.

Počnite od podova i hook Job-ova:

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 greške pri preuzimanju slika i nevezane volumene. Hook Job koji prikazuje 0/1 završetaka sa neuspelim podom zaustavio je instalaciju, jer hook Job-ovi imaju ograničenje ponovnih pokušaja 0 i nikada se ne ponavljaju neprimetno. Njegov log navodi razlog.

Evo kako da otklonite svaki uzrok:

  • Ako Helm čeka uz --wait, zaustavite ga, deinstalirajte i ponovo instalirajte bez te opcije. Zatim sačekajte servise:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Kod grešaka pri preuzimanju proverite global.imageRegistry i, za Enterprise, token za preuzimanje sa stranice Pull tokens and install commands u vašem nalogu.
  • Za volumene u stanju Pending postavite storage.className na klasu skladišta koju klaster ima ili jednu podesite kao podrazumevanu.
  • Ako nedostaje cert-manager, instalirajte cert-manager v1.21.3 i ponovo pokrenite instalaciju.
  • Za neuspeli hook otklonite ono što navodi njegov log i ponovo pokrenite instalaciju.

Pod čeka na svoju šemu

Pod nekog servisa minutima stoji u stanju Init:0/1. Svaki servis koji koristi bazu podataka ima init kontejner, wait-for-schema, koji zadržava pod dok evidencija izdanja ne pokaže da su njegove migracije primenjene za sliku ovog izdanja. To je normalno tokom prvih minuta instalacije ili nadogradnje, dok se izvršavaju hook-ovi migracija. Problem je kada se ne završava.

Pročitajte log init kontejnera:

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

Log navodi komponentu, lance migracija koje čeka i svoje vremensko ograničenje, a zatim ispisuje red pri svakoj promeni stanja:

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
Red o napretku navodi Šta znači
Koji lanci tek treba da budu primenjeni za ovo izdanje Navedeni hook-ovi migracija nisu završeni. Pogledajte te Job-ove.
Da evidencija izdanja ne može da se pročita, uz grešku baze podataka Postgres ne odgovara, ili evidencija ne postoji jer bootstrap baze podataka nije izvršen.
FAILED (<component>): after <n>s, … Odustao je nakon schemaWait.timeoutSeconds (podrazumevano 1.800). Init kontejner se ponovo pokreće; sam servis se nikada nije pokrenuo.

Lanac koji se nikada ne primeni gotovo uvek znači da njegov Job migracije nije uspeo. Pronađite ga pomoću kubectl -n nexus get jobs i pročitajte njegov log. Otklonite ono što navodi (pun disk, spoljna baza podataka do koje migrator ne može da dođe, konflikt uloga) i pokrenite helm upgrade sa istim vrednostima: hook-ovi se ponovo izvršavaju, a svaki je bezbedno ponovo pokrenuti.

Povećajte schemaWait.timeoutSeconds samo kada je migracija spora i ispravna, kakva može biti velika prva migracija na sporom skladištu. Povećanje radi prikrivanja neuspelog Job-a samo tera pod da duže čeka nešto što nikada neće stići.

Skladište ključeva je zapečaćeno

Nakon nestanka struje, ponovnog pokretanja čvora ili ponovnog pokretanja container runtime-a, podovi se vraćaju i konzola se učitava, a sve što zahteva ključ ne uspeva ili čeka. Unsealer se pokreće zapečaćen nakon svakog ponovnog pokretanja svog čvora, a skladište ključeva ne može samo da se otpečati dok unsealer nije otvoren.

Proverite 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ćen, 2 zapečaćen, a 1 znači da nije mogao da odgovori (pitajte ponovo za minut). Pokrenite isto nad openbao-0 uz -tls-server-name=openbao za skladište ključeva. Ako je unsealer otpečaćen, a skladište ključeva nije, skladište ključeva se samo otpečaćuje; sačekajte minut.

Da biste otklonili zapečaćen unsealer, jedan čuvar pokreće unseal.sh iz chart-a sa sopstvenim age identitetom. Poglavlje 2.15, Drugi dan: rad sa Nexus-om, sadrži celu komandu. Izlazni kod skripte vam govori šta se dogodilo:

Izlazni kod Značenje Šta učiniti
0 Otpečaćen Proverite kubectl -n nexus get deploy,statefulset u roku od minut.
1 I dalje zapečaćen, ili poziv za otpečaćivanje nije uspeo Pročitajte redove o delovima koje je ispisala; pokrenite je ponovo.
2 Nedostaje preduslov Poruka ga navodi: AGE_IDENTITY, izvršnu datoteku kao što je age ili jq, ili podešavanje direktnog režima.
3 Ovaj identitet ne može da dešifruje delove Vi niste čuvar ove instalacije. Ništa nije poslato. Pronađite čuvara koji jeste.

Ne možete da se prijavite preko HTTP protokola

Konzola se učitava na adresi http://, ili preko kubectl port-forward ka 127.0.0.1, i prijava ne uspeva. Upit za passkey se nikada ne pojavljuje ili se prijava vraća na početak.

Za prijavu je potreban sopstveni HTTPS izvor konzole. Konzola prihvata prijavu samo sa https://<hosts.console>, čuva sesiju u kolačiću __Host- označenom kao Secure (koji pregledač čuva samo preko HTTPS-a), a passkey prvog administratora zahteva stranicu sa važećim sertifikatom. Pregledači odbijaju passkey-eve iza greške sertifikata. Port-forward ka http://127.0.0.1 nikada ne može da se prijavi.

Proverite do čega je pregledač zaista stigao:

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

Prva bi trebalo da odgovori preko HTTPS-a sa sertifikatom kome vaš računar veruje. Druga bi trebalo da prikaže tri hosta sa imenima koja ste postavili u hosts.*.

Da biste to otklonili, pristupite konzoli na https://console.harrow.example, tačnom imenu iz hosts.console, sa sertifikatom kome pregledač veruje. Uz tls.mode: existing proverite da li tls.existingSecret sadrži sertifikat za sva tri hosta. Uz tls.mode: cert-manager proverite da li ga je ClusterIssuer izdao. Uz tls.mode: none, Transport Layer Security (TLS) se završava na vašem sopstvenom load balancer-u i tu sertifikat mora biti ispravan. Za privatno sertifikaciono telo instalirajte njegov sertifikat na računare sa kojih se vaši administratori prijavljuju.

Kod za preuzimanje je istekao

Na stranici Claim this installation stranica odbija kod uz CLAIM_CODE_EXPIRED (410). Kod za preuzimanje vlasništva sastoji se od tri grupe od po četiri znaka. Važi jednom, 30 minuta, uz 5 pokušaja. Nakon toga, ili nakon petog pogrešnog pokušaja, više ne važi, a ništa nije preuzeto niti promenjeno.

Napravite novi kod iz terminala koji ima pristup klasteru:

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

Ispisuje novi kod i otisak instalacije. Unesite kod na stranici za preuzimanje vlasništva u roku od 30 minuta i ponovo uporedite otisak.

Preuzmi ovu instalaciju
Preuzmi ovu instalaciju
Claim this installation. Kod iz terminala unosi se u tri grupe, a stranica prikazuje ceo otisak u grupama od po četiri radi poređenja; istekao kod se odbija uz CLAIM_CODE_EXPIRED i ništa nije preuzeto.

Dva povezana odgovora:

  • RATE_LIMITED (429) na stranici za preuzimanje vlasništva znači da je stranica imala nekoliko pokušaja u poslednjem minutu. Sačekajte broj sekundi koji navodi. Ako vi niste napravili te pokušaje, neko drugi na vašoj mreži pokušava da pristupi stranici; saznajte ko, pre nego što preuzmete vlasništvo.
  • TRANSITION_NOT_PERMITTED (409) znači da je vlasništvo nad instalacijom već preuzeto i da je njena stranica za preuzimanje trajno isključena. Umesto toga se prijavite. Ako vi niste preuzeli vlasništvo, tretirajte to kao bezbednosni incident.

Otisak se ne poklapa

Stranica za preuzimanje vlasništva prikazuje CLAIM_FINGERPRINT_MISMATCH (403), ili i sami vidite da se osam grupa od po četiri na stranici razlikuje od onih koje je ispisao vaš terminal. Čak i jedna različita grupa znači da pregledač komunicira sa drugom instalacijom.

Stanite. Ne unosite kod na tu stranicu. Na toj adresi možda odgovara nešto drugo osim vaše instalacije, moguće računar postavljen da uhvati prvog administratora. Ako biste preuzeli vlasništvo, taj računar bi držao vašu organizaciju. Vaša sopstvena instalacija je nepromenjena i vlasništvo nad njom i dalje nije preuzeto.

Proverite kuda ime upućuje i koji sertifikat je odgovorio:

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

Adresa bi trebalo da bude adresa vašeg ingress kontrolera, a sertifikat onaj koji ste instalirali za hosts.console.

Otisak se ne poklapa
Otisak se ne podudara
Otisci se razlikuju u tri od osam grupa. Stranica kaže da stanete, objašnjava ko bi mogao da odgovara i navodi šta treba proveriti pre ponovnog pokušaja.

Da biste to otklonili, dajte svom bezbednosnom timu adresu koja je odgovorila i sačuvajte log instalacije, koji beleži otisak koji je instalacija ispisala. Ispravite zapis u sistemu imena domena (DNS) ili proxy koji vas je poslao na drugo mesto. Zatim napravite novi kod za preuzimanje vlasništva pomoću nexusctl claim-code --administrator <email> i preuzmite vlasništvo iz pregledača na mreži kojoj verujete, ponovo upoređujući svih osam grupa.

Licenca je odbijena

Uvoz na stranici Import the licence, Import a new licence ili nexusctl licence import odgovara odbijanjem. Odbijen uvoz ništa ne menja: važeća licenca ostaje na snazi, a donja granica sata se ne pomera.

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

Telo odbijanja sadrži code, message, refused_at (korak koji nije uspeo) i troubleshooting. Da biste videli stanje važeće licence, pročitajte GET https://auth.harrow.example/api/v1/installation/licence/state sa istim tokenom.

Kod HTTP Uobičajeni uzrok Rešenje
LICENCE_SIGNATURE_INVALID 422 Datoteka je izmenjena, preformatirana ili ponovo sačuvana, ili nedostaje jedan potpis Ponovo je preuzmite sa svog naloga i uvezite je netaknutu
LICENCE_FORMAT_INVALID 422 Nije licenca: pogrešna datoteka, skraćena ili umotana u drugi objekat Pošaljite datoteku tačno onakvu kakvu Vam je Adverant dao
LICENCE_ROOT_UNKNOWN 422 Potpisana ključem koji ovo izdanje ne sadrži Nadogradite ili zatražite licencu potpisanu za vaše izdanje
LICENCE_MATRIX_MISMATCH 422 Napisana za noviju matricu edicija ili dodeljuje grupu koju ova verzija ne poznaje Nadogradite ili zatražite licencu napisanu za vaše izdanje
LICENCE_OTHER_INSTALLATION 409 Izdata za drugu instalaciju, često licenca test klastera na produkciji Zatražite licencu za identitet ove instalacije
LICENCE_REVOKED 403 Adverant ju je povukao Zatražite novu licencu od kompanije Adverant
LICENCE_LOCKED 403 Njen starts_on je posle tekućeg datuma Uvezite je na njen prvi dan ili kasnije
TRANSITION_NOT_PERMITTED 409 Ovaj ID licence je već uvezen Ništa ne treba raditi ako je na snazi; obratite se kompaniji Adverant ako uslovi moraju da se promene
RECORD_NOT_FOUND 404 Instalacija nije deklarisana, pa još nema identitet Završite korak prvog administratora, zatim uvezite
TENANT_NOT_A_PARAMETER 403 Telo navodi organizaciju na najvišem nivou Pošaljite samo datoteku licence kao telo

Dve stvari izgledaju kao problemi sa licencom, a nisu. Čitanje stanja koje sadrži LICENCE_CLOCK_BEHIND_FLOOR znači da sat čvora pokazuje ranije vreme od najkasnijeg vremena koje je instalacija videla; ispravite vreme čvora, a ako je sat išao napred i povukao donju granicu sa sobom, zatražite od kompanije Adverant token za resetovanje vremena. A licenca koja se uveze, a i dalje prikazuje grupu kao najavu, obično ne dodeljuje tu grupu: pre svega ostalog pročitajte dodele na stranici licence.

Nema AI odgovora

Asistent veštačke inteligencije (AI) prikazuje MODEL_NOT_CONNECTED (503), korak radnog toka ne uspeva uz NO_PROVIDER_FOR_ROLE (422) ili odgovori jednostavno prestaju.

Skup ključeva organizacije nema ključ koji može da odgovori ili ruter ne može da dođe do dobavljača. Svaka organizacija donosi sopstveni ključ za model. Bez ključa u upotrebi nema AI, namerno, i nijedan zajednički ključ ga ne zamenjuje.

Proverite skup ključeva i izbor rutera, svaki sa sopstvenim pristupnim tokenom te osobe:

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

Prva navodi svakog dobavljača, da li može da odgovori i zašto ne ("No key in use: 1 withdrawn, 1 lapsed"), kao i stanje svakog ključa. Druga odgovara modelom koji bi ruter koristio za organizaciju ili rečima navodi svoje odbijanje. Zatim proverite putanju iz klastera pomoću ove dve komande:

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

Šta znači svaki nalaz:

Nalazite Rešenje
Nema ključa u skupu Vlasnik ili administrator dodaje ključ organizacije na AI switchboard-u ili u Settings, AI models
Ključevi invalid, expired ili exhausted Dodajte novi ključ; stari ostaje naveden kao istorija
Ključevi resting Sačekajte: ključ koji ne uspeva miruje 60 sekundi, a nakon 5 uzastopnih neuspeha se isključuje (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE uz ključeve u upotrebi Uloga nema dodelu i ništa se ne podudara; postavite ulogu u politici rutiranja
MODEL_CAPABILITY_UNAVAILABLE (422) Zahtev traži mogućnost ili lokaciju čuvanja podataka koju ne nudi nijedan dobavljač u skupu; omogućite onog koji je nudi
Ne postoji nexus-operator-egress politika ili u njoj nedostaju opsezi dobavljača Dodajte opsege, zapisane u notaciji Classless Inter-Domain Routing (CIDR), u networkPolicy.externalEgressCIDRs i izvršite nadogradnju
Lokalni server modela koji ne odgovara Proverite ai.localProvider.baseUrl, navedite server u ai.installationHosts i dozvolite njegov opseg u networkPolicy.externalEgressCIDRs

Ključ hostovanog dobavljača koji radi sa laptopa, a ne radi na instalaciji, gotovo uvek ukazuje na mrežnu politiku. Imenski prostor podrazumevano zabranjuje odlazni saobraćaj.

Odgovori 429

Klijent dobija odgovor 429 Too Many Requests. U sistemu Nexus postoje četiri mesta koja ga mogu vratiti, a telo odgovora Vam govori koje.

Gde Kod i detalji Šta promeniti
nexus-auth, po prijavljenoj osobi RATE_LIMITED sa limit, windowSeconds i retryAfterSeconds auth.rateLimitPerMinute (podrazumevano 5000), za intenzivnu automatizaciju
Ograničenje ključa skripte, aplikacije ili jedinice (Enterprise) RATE_LIMITED sa nazivom ključa i njegovim ograničenjem Ograničenje u Settings, Rate limits, uz obrazloženje
Stranica za preuzimanje pri prvom pokretanju RATE_LIMITED sa retry_after_seconds Ništa: sačekajte i utvrdite ko još pokušava da pristupi stranici
Dobavljač modela Ruter to tretira kao privremenu grešku i prelazi na sledećeg dobavljača Dodajte još jedan ključ ili dobavljača ako se to često dešava

Svaki od njih sadrži zaglavlje Retry-After. Klijent koji se ispravno ponaša čeka toliko i ne pokušava ponovo ranije.

Ako se čini da svi korisnici istovremeno dele jedno ograničenje, proverite proxy.trustedCIDRs. Kada ne obuhvata mrežu podova Vašeg ingress kontrolera, nexus-auth ne može da veruje zaglavlju X-Forwarded-For i vidi svaki zahtev kao da dolazi od kontrolera. Podrazumevana vrednost, 10.42.0.0/16, odgovara samo za k3s.

kubectl get pods -A -o wide

Pronađite adresu poda ingress kontrolera u izlazu i proverite da li je proxy.trustedCIDRs obuhvata.

Greške pri nadogradnji

Nadogradnja je vraćena. Stranica Upgrade prikazuje UPGRADE_ROLLED_BACK: jedan korak nije uspeo, svaki mehanizam je vraćen na prethodno izdanje, a podaci nisu promenjeni. Stranica navodi korak. Čest uzrok je volumen premali za novi raspored skladišta. Ispravite ono što je navedeno, ponovo pokrenite nexusctl upgrade plan --bundle <file>, a zatim primenite. Rezervna kopija se najpre ponovo pravi.

Chart odbija renderovanje uz EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Secret nexus-generated sadrži EXTERNAL_KEY_ENCRYPTION_KEY u obliku koji chart ne može da koristi. Mora biti base64 zapis od 32 bajta ili sirovi ključ od 32 bajta iz starije instalacije. Neko je izmenio ili zamenio Secret. Vratite ključ kojim su zapečaćeni podaci ove instalacije, kao base64 zapis njegova 32 bajta (printf %s "$OLD" | base64), i ponovo izvršite nadogradnju. Ne dozvolite da chart napravi novi: podaci zapečaćeni starim ključem ostali bi nečitljivi.

Skripte se odbijaju uz TOKEN_ORG_MISSING nakon nadogradnje. Svaki servis koji proverava ključeve interfejsa za programiranje aplikacija (API) preko nexus-auth sada odbija ključ bez organizacije, uz 403 TOKEN_ORG_MISSING. Dodelite svakom takvom ključu organizaciju ili izdajte novi ključ.

Ključevi sat vremena prijavljuju pogrešnu aplikaciju. Ispraznite keširane unose ključeva u kešu servisa nexus-auth, Valkey skladištu instalacije. Poglavlje 2.15, Drugi dan: upravljanje sistemom Nexus, sadrži komandu, za skladište unutar klastera i za spoljno skladište.

Migracioni hook nije uspeo. helm upgrade prijavljuje neuspeli pre-upgrade hook. Šema se menja pre uvođenja novih podova, tako da aktuelno izdanje i dalje radi. Pročitajte log Job-a pomoću kubectl -n nexus logs job/<job-name>, ispravite ono što je navedeno i ponovo pokrenite nadogradnju.

Servisi nekoliko sekundi nisu mogli da koriste svoje tabele. Pri prvoj nadogradnji instalacije napravljene iz ranijeg chart-a, svaki servis gubi svoja stara podrazumevana prava nad tabelama i dobija sopstvena nazad kroz sopstvenu migraciju. Prekid traje nekoliko sekundi. Izvršite nadogradnju u mirnom periodu ili najpre skalirajte servise na nulu.

Izdanje sa diska je odbijeno. Uvoz sa medija prikazuje MEDIA_SIGNATURE_INVALID (422): datoteke nisu potpisane ključem izdanja instaliranim na ovoj instalaciji. Ništa nije učitano i aktuelno izdanje nastavlja da radi. Sačuvajte medij za Vaš bezbednosni tim i zatražite od kompanije Adverant novi medij putem oflajn razmene.

Odbijanje generisanja chart-a

helm install, helm upgrade ili helm template se zaustavlja pre nego što se išta primeni, uz poruku koja počinje kodom ili navodi vrednost. Chart odbija vrednosti sa kojima ne može bezbedno da radi. Na klasteru se ništa nije promenilo.

Renderujte chart zasebno da biste videli svako odbijanje bez diranja klastera. Na Enterprise izdanju koristite preuzeti Enterprise chart umesto adrese oci:// i postavite networkPolicy.apiServerCIDRs u vrednostima, jer oflajn renderovanje ne može da ga pročita 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

Preflight proverava iste vrednosti identiteta u svom odeljku „time and keys“ i prijavljuje iste kodove. Izlazni kod je 0 kada instalacija može da se nastavi (upozorenja ne blokiraju), 1 kada najmanje jedna provera nije uspela i 2 kada nije mogao da se pokrene.

Provera pre instalacije ne može da se nastavi
Preflight provera ne može da se nastavi
Preflight ne može da nastavi. Neuspele provere su navedene prve, svaka sa svojim rešenjem, a instalacija ostaje blokirana uz PREFLIGHT_FAILED dok ne prođu.
Odbijanje Uzrok Rešenje
INSTALLATION_NAME_MISSING keys.installationName je prazno Postavite ga na sopstveni naziv ove instalacije, u skladu sa ^[a-z][a-z0-9-]{0,62}$. Postaje trajno kada se skladište ključeva prvi put pokrene
INSTALLATION_NAME_EXAMPLE Naziv je onaj iz primera datoteka sa vrednostima chart-a Postavite sopstveni naziv
keys.installationName "…" does not match … Velika slova, donje crte ili cifra na početku Koristite mala slova, cifre i crtice, počevši slovom
KEYS_CUSTODIAN_MISSING keys.custody.recipients je prazno Navedite age primaoce Vaših čuvara ključeva, javne polovine
KEYS_CUSTODIAN_EXAMPLE Primalac je primer čuvara iz datoteka sa vrednostima chart-a, čiji identitet niko ne poseduje Zamenite ga primaocima Vaših čuvara ključeva
keys.custody.recipients: … Primalac u obliku za koji custody Job ne može da šifruje Koristite age1…, age1tag1…, age1tagpq1…, age1pq1… ili age1se1…, malim slovima
NEXUS_EDITION_INVALID edition nije ni community ni enterprise Postavite jednu od te dve vrednosti
edition=… but enterprise.enabled=… Te dve vrednosti se ne slažu Postavite enterprise.enabled: true tačno onda kada je edition enterprise
global.imageRegistry is required Nije naveden registar Postavite registar iz kog Vaši čvorovi preuzimaju slike
hosts.<name> is required Nedostaje javni host Postavite hosts.console, hosts.api i hosts.auth
tls.existingSecret is required when tls.mode is existing Nije naveden Secret sertifikata Navedite Secret ili izaberite drugi tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Nije naveden izdavalac Navedite svoj ClusterIssuer
dataTier.<store>.external.host is required when mode is external Spoljno skladište bez adrese Navedite njegov host i njegov Secret u existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template nema klaster u kom bi ih potražio Navedite adrese API servera kao /32 opsege
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID Generisani ključ u nexus-generated ima pogrešan oblik Pogledajte „Greške pri nadogradnji“ iznad

Datoteku sa vrednostima koja koristi ključ koji chart nema ili vrednost pogrešnog tipa odbija šema chart-a pre bilo koje od ovih provera. telemetry.enabled: true je jedan primer: šema prihvata samo false.

Slanje paketa za podršku

Kada ništa od ovoga ne reši problem, pošaljite kompaniji Adverant paket za podršku uz Vaš zahtev za podršku.

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

<request-number> je broj zahteva koji ste otvorili na stranici Support and support bundles Vašeg naloga. Isti paket možete napraviti sa stranice Support bundle u konzoli, u okviru This installation.

Paket sadrži logove mehanizama iz poslednja 24 sata, podatke o stanju i verziji, podešavanja bez tajni, kao i preflight i instalacione izveštaje. Pre nego što se zapiše, redakcija zamenjuje imena, tajne i adrese, a Vi pregledate tačno ono što se šalje. Poruke, datoteke i memorija korisnika se nikada ne prikupljaju.

Otpremite ga uz zahtev na Vašem nalogu ili ga sačuvajte na medij i iznesite ako instalacija nema spoljnu vezu. Mogu ga otvoriti samo inženjeri podrške navedeni u zahtevu, a briše se nakon 30 dana. U zahtevu navedite koji ste od gore navedenih problema ispitivali i šta su pokazale provere iz ovog poglavlja: to štedi jedan krug komunikacije.