AutentificareProgramați o prezentare

Capitolul 2.17

Depanare

Problemele pe care operatorii le întâlnesc cel mai des, organizate în funcție de ceea ce observați. Fiecare prezintă cauza, comanda care o confirmă și soluția, iar capitolul se încheie cu trimiterea unui pachet de asistență.

Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

22 minute de lectură

Majoritatea lucrurilor care nu funcționează la o instalare Nexus eșuează în aceleași vreo douăsprezece moduri și aproape toate se anunță printr-un cod. Acest capitol este organizat după ceea ce vedeți, aproximativ în ordinea în care ați întâlni fiecare problemă: instalarea, revendicarea, licențierea, apoi rularea. Pentru fiecare în parte primiți cauza, o comandă care o confirmă și rezolvarea.

Exemplele folosesc instalarea Harrow Port Authority: namespace nexus, versiune (release) nexus, gazde (hosts) console.harrow.example, api.harrow.example și auth.harrow.example. Înlocuiți-le cu ale dumneavoastră. Trei obiceiuri economisesc timp la fiecare problemă de aici:

  1. Citiți codul înaintea mesajului. Fiecare refuz în Nexus se termină cu un cod de mașină, iar acest capitol este indexat după acest cod.
  2. Rulați din nou nexusctl preflight după orice modificare adusă clusterului sau fișierului de valori (values). Acesta citește clusterul fără a-l modifica și raportează majoritatea refuzurilor din chart după nume, înainte de a o face Helm.
  3. Folosiți --explain la orice verb nexusctl de care nu sunteți sigur. Acesta afișează operațiunile kubectl și helm fără a le rula.

Instalarea se blochează

Ați rulat instalarea și nu s-a terminat. helm nu a returnat un răspuns după cincisprezece minute, sau a returnat și pod-urile sunt încă în Init sau Pending, sau adresa consolei nu răspunde.

Cea mai frecventă cauză este helm install --wait. Nexus își creează baza de date, rolurile și schema fiecărui serviciu în hook-uri post-instalare, iar hook-ul de bootstrap este cel care predă fiecărui serviciu parola bazei sale de date. Cu --wait, Helm așteaptă ca resursele Deployment să fie pregătite înainte de a rula acele hook-uri, în timp ce resursele Deployment așteaptă hook-urile. Niciuna nu avansează. Nu instalați niciodată cu --wait; instalați fără acesta și așteptați după aceea.

O secvență verticală de casete unite prin săgeți îndreptate în jos: "Release resources created (Deployments start, each held by its wait-for-schema init container)", apoi "Database bootstrap hook: database, roles, release ledger", apoi "Migration hooks, one per service, in a fixed order", apoi "Each hook writes its row in the release ledger". Din ultima casetă, săgețile se ramifică lateral către trei casete mici "nexus-auth starts", "nexus-gateway starts", "other services start". O notă laterală lângă caseta de sus, cu o săgeată tăiată către partea de jos: "helm install --wait waits here for Deployments that are waiting for the hooks".
Ce rulează, în ordine, atunci când chart-ul se instalează sau se actualizează.

Celelalte cauze sunt unele obișnuite pentru Kubernetes. Imaginile nu pot fi descărcate (pulled) deoarece global.imageRegistry indică un registru greșit sau o instalare Enterprise nu are un token de descărcare (pull token). Un volum rămâne Pending deoarece clasa de stocare (storage class) nu există. cert-manager lipsește, caz în care instalarea nu se blochează deloc: eșuează în câteva secunde, deoarece emitenții de certificate ai chart-ului au nevoie de resursele cert-manager.

Începeți cu pod-urile și cu resursele Job de tip hook:

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 arată erorile de descărcare a imaginilor și volumele neasociate (unbound) în evenimentele sale. Un Job de tip hook care arată 0/1 finalizări cu un pod eșuat a oprit instalarea, deoarece resursele Job de tip hook au o limită de reîncercare (backoff limit) de 0 și nu sunt niciodată reîncercate în mod silențios. Jurnalul (log-ul) său arată motivul.

Iată cum să rezolvați fiecare cauză:

  • Dacă Helm așteaptă cu --wait, opriți-l, dezinstalați și instalați din nou fără acest parametru (flag). Apoi așteptați serviciile:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Pentru erorile de descărcare (pull), verificați global.imageRegistry și, pentru Enterprise, tokenul de descărcare din pagina Pull tokens and install commands a contului dumneavoastră.
  • Pentru volumele Pending, setați storage.className la o clasă de stocare pe care o are clusterul sau setați una ca implicită.
  • Pentru un cert-manager lipsă, instalați cert-manager v1.21.3 și rulați din nou instalarea.
  • Pentru un hook eșuat, rezolvați problema indicată în jurnalul său și rulați din nou instalarea.

Un pod așteaptă schema sa

Pod-ul unui serviciu rămâne în Init:0/1 timp de câteva minute. Fiecare serviciu care folosește baza de date are un container de inițializare (init container), wait-for-schema, care reține pod-ul până când registrul versiunii (release ledger) arată că migrările sale au fost aplicate pentru imaginea acestei versiuni. Acest lucru este normal în primele minute ale unei instalări sau actualizări, în timp ce rulează hook-urile de migrare. Devine o problemă atunci când nu se mai termină.

Citiți jurnalul containerului de inițializare:

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

Jurnalul indică componenta, lanțurile de migrare pe care le așteaptă și limita sa de timp, apoi afișează o linie ori de câte ori starea sa se schimbă:

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
Linia de progres indică Ce înseamnă
Care lanțuri mai trebuie aplicate pentru această versiune Hook-urile de migrare numite nu s-au terminat. Verificați acele resurse Job.
Că registrul versiunii nu poate fi citit, împreună cu eroarea bazei de date Postgres nu răspunde sau registrul nu există deoarece bootstrap-ul bazei de date nu a rulat.
FAILED (<component>): after <n>s, … A renunțat după schemaWait.timeoutSeconds (1.800 în mod implicit). Containerul de inițializare repornește; serviciul în sine nu a pornit niciodată.

Un lanț care nu se aplică niciodată înseamnă aproape întotdeauna că resursa sa Job de migrare a eșuat. Găsiți-o cu kubectl -n nexus get jobs și citiți-i jurnalul. Rezolvați ceea ce indică (un disc plin, o bază de date externă la care migratorul nu poate ajunge, un conflict de roluri) și rulați helm upgrade cu aceleași valori: hook-urile rulează din nou și fiecare este sigur de rulat din nou.

Măriți schemaWait.timeoutSeconds doar atunci când o migrare este lentă și funcționează corect, așa cum poate fi o primă migrare amplă pe o stocare lentă. Mărirea valorii pentru a ascunde un Job eșuat nu face decât să determine pod-ul să aștepte mai mult ceva ce nu va veni niciodată.

Depozitul de chei este sigilat

După o pană de curent, o repornire a nodului sau o repornire a mediului de execuție a containerelor (container runtime), pod-urile revin și consola se încarcă, dar orice are nevoie de o cheie eșuează sau așteaptă. Serviciul de desigilare (unsealer) pornește sigilat după fiecare repornire a nodului său, iar depozitul de chei (key store) nu se poate desigila singur până când serviciul de desigilare nu este deschis.

Interogați OpenBao în fiecare pod:

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

Codul de ieșire 0 înseamnă desigilat, 2 înseamnă sigilat, iar 1 înseamnă că nu a putut răspunde (interogați din nou peste un minut). Rulați aceeași comandă pe openbao-0 cu -tls-server-name=openbao pentru depozitul de chei. Dacă serviciul de desigilare este desigilat, iar depozitul de chei nu este, depozitul de chei se desigilează singur; acordați-i un minut.

Pentru a rezolva un serviciu de desigilare sigilat, un custode rulează scriptul unseal.sh al chart-ului cu propria sa identitate age. Capitolul 2.15, Ziua a doua: operarea Nexus, conține comanda completă. Codul de ieșire al scriptului vă arată ce s-a întâmplat:

Cod de ieșire Semnificație Ce trebuie să faceți
0 Desigilat Verificați kubectl -n nexus get deploy,statefulset într-un minut.
1 Încă sigilat sau un apel de desigilare a eșuat Citiți liniile de fragmente (share) pe care le-a afișat; rulați-l din nou.
2 Lipsește o cerință preliminară Mesajul o numește: AGE_IDENTITY, un fișier binar precum age sau jq, sau o setare pentru modul direct.
3 Această identitate nu poate decripta fragmentele Nu sunteți un custode al acestei instalări. Nu a fost trimis nimic. Găsiți un custode care are acest rol.

Nu vă puteți autentifica prin HTTP

Consola se încarcă la o adresă http:// sau printr-un kubectl port-forward către 127.0.0.1, iar autentificarea eșuează. Solicitarea pentru passkey nu apare niciodată sau autentificarea revine în buclă la început.

Autentificarea are nevoie de propria origine HTTPS a consolei. Consola acceptă o autentificare doar de la https://<hosts.console>, păstrează sesiunea într-un cookie __Host- marcat Secure (pe care un browser îl stochează doar prin HTTPS), iar passkey-ul primului administrator are nevoie de o pagină cu un certificat valid. Browserele refuză passkey-urile în spatele unei erori de certificat. Un port-forward către http://127.0.0.1 nu se va putea autentifica niciodată.

Verificați la ce a ajuns efectiv browserul:

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

Prima comandă ar trebui să răspundă prin HTTPS cu un certificat în care mașina dumneavoastră are încredere. A doua ar trebui să arate cele trei gazde cu numele pe care le-ați setat în hosts.*.

Pentru a rezolva problema, accesați consola la https://console.harrow.example, numele exact din hosts.console, cu un certificat în care browserul are încredere. Cu tls.mode: existing, verificați dacă tls.existingSecret deține un certificat pentru toate cele trei gazde. Cu tls.mode: cert-manager, verificați dacă resursa ClusterIssuer l-a emis. Cu tls.mode: none, Transport Layer Security (TLS) se termină pe propriul dumneavoastră echilibrator de sarcină (load balancer), și acolo trebuie să fie corect certificatul. Pentru o autoritate de certificare privată, instalați certificatul acesteia pe mașinile de pe care se autentifică administratorii dumneavoastră.

Codul de revendicare a expirat

Pe pagina Claim this installation, pagina refuză codul cu CLAIM_CODE_EXPIRED (410). Un cod de revendicare este format din trei grupuri de câte patru caractere. Funcționează o singură dată, timp de 30 de minute, cu 5 încercări. După aceea, sau după a cincea încercare greșită, devine inactiv și nimic nu a fost revendicat sau modificat.

Generați un cod nou din terminalul care are acces la cluster:

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

Acesta afișează un cod nou și amprenta instalării. Introduceți codul pe pagina de revendicare în decurs de 30 de minute și comparați din nou amprenta.

Revendică această instalare
Revendică această instalare
Claim this installation. Codul din terminal se introduce în trei grupuri, iar pagina arată amprenta completă în grupuri de câte patru pentru comparare; un cod expirat este refuzat cu CLAIM_CODE_EXPIRED și nimic nu este revendicat.

Două răspunsuri înrudite:

  • RATE_LIMITED (429) pe pagina de revendicare înseamnă că pagina a avut mai multe încercări în ultimul minut. Așteptați numărul de secunde pe care îl indică. Dacă nu ați făcut dumneavoastră acele încercări, altcineva din rețeaua dumneavoastră încearcă pagina; aflați cine este înainte de a revendica.
  • TRANSITION_NOT_PERMITTED (409) înseamnă că instalarea este deja revendicată, iar pagina sa de revendicare este dezactivată definitiv. Autentificați-vă în schimb. Dacă nu ați revendicat-o dumneavoastră, tratați acest lucru ca pe un incident de securitate.

Amprenta nu se potrivește

Pagina de revendicare arată CLAIM_FINGERPRINT_MISMATCH (403) sau puteți vedea singur că cele opt grupuri de câte patru de pe pagină diferă de cele afișate de terminalul dumneavoastră. Chiar și un singur grup diferit înseamnă că browserul comunică cu o altă instalare.

Opriți-vă. Nu tastați codul în acea pagină. Altceva decât instalarea dumneavoastră ar putea răspunde la acea adresă, posibil o mașină configurată pentru a intercepta primul administrator. Dacă ați revendica-o, acea mașină ar deține organizația dumneavoastră. Propria dumneavoastră instalare este neschimbată și încă nerevendicată.

Verificați spre ce indică numele și ce certificat a răspuns:

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

Adresa ar trebui să fie cea a controlerului dumneavoastră de ingress, iar certificatul ar trebui să fie cel pe care l-ați instalat pentru hosts.console.

Amprenta nu corespunde
Amprenta nu corespunde
Amprentele diferă în trei din cele opt grupuri. Pagina vă spune să vă opriți, explică cine ar putea răspunde și enumeră ce trebuie să verificați înainte de a încerca din nou.

Pentru a rezolva problema, transmiteți echipei de securitate adresa care a răspuns și păstrați jurnalul de instalare, care înregistrează amprenta afișată de instalare. Corectați înregistrarea Domain Name System (DNS) sau proxy-ul care v-a trimis în altă parte. Apoi generați un nou cod de revendicare cu nexusctl claim-code --administrator <email> și revendicați dintr-un browser aflat într-o rețea în care aveți încredere, comparând din nou toate cele opt grupuri.

Licența este refuzată

Importul din Import the licence, Import a new licence sau nexusctl licence import răspunde cu un refuz. Un import refuzat nu schimbă nimic: licența în vigoare rămâne în vigoare, iar pragul minim al ceasului (clock floor) nu se modifică.

Citiți codul și pasul:

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

Corpul refuzului conține code, message, refused_at (pasul care a eșuat) și troubleshooting. Pentru a vedea starea licenței în vigoare, citiți GET https://auth.harrow.example/api/v1/installation/licence/state cu același token.

Cod HTTP Cauză uzuală Rezolvare
LICENCE_SIGNATURE_INVALID 422 Fișierul a fost editat, reformatat sau salvat din nou, sau lipsește o semnătură Descărcați-l din nou din contul dumneavoastră și importați-l nemodificat
LICENCE_FORMAT_INVALID 422 Nu este o licență: fișier greșit, trunchiat sau încapsulat într-un alt obiect Trimiteți fișierul exact așa cum l-a furnizat Adverant
LICENCE_ROOT_UNKNOWN 422 Semnată cu o cheie pe care această versiune nu o deține Actualizați sau solicitați o licență semnată pentru versiunea dumneavoastră
LICENCE_MATRIX_MISMATCH 422 Scrisă pentru o matrice de ediție mai nouă sau acordă un grup pe care acest build nu îl cunoaște Actualizați sau solicitați o licență scrisă pentru versiunea dumneavoastră
LICENCE_OTHER_INSTALLATION 409 Emisă pentru o altă instalare, adesea licența clusterului de testare pusă în producție Solicitați o licență pentru identitatea acestei instalări
LICENCE_REVOKED 403 Adverant a retras-o Solicitați de la Adverant o licență nouă
LICENCE_LOCKED 403 Valoarea sa starts_on este ulterioară datei curente Importați-o în prima sa zi sau după aceea
TRANSITION_NOT_PERMITTED 409 Acest ID de licență a fost deja importat Nu trebuie făcut nimic dacă este în vigoare; întrebați Adverant dacă termenii trebuie modificați
RECORD_NOT_FOUND 404 Instalarea nu a fost declarată, deci nu are încă o identitate Finalizați pasul pentru primul administrator, apoi importați
TENANT_NOT_A_PARAMETER 403 Corpul numește o organizație la nivelul său superior Trimiteți doar fișierul de licență drept corp al cererii

Două lucruri arată ca probleme de licență, dar nu sunt. O citire a stării care conține LICENCE_CLOCK_BEHIND_FLOOR înseamnă că ceasul nodului indică o oră anterioară celei mai recente ore pe care a văzut-o instalarea; corectați ora nodului, iar dacă ceasul a luat-o înainte și a tras după el pragul minim, solicitați de la Adverant un token de resetare a timpului. Iar o licență care se importă și arată în continuare un grup ca avanpremieră (teaser) de obicei nu acordă acel grup: citiți drepturile acordate (grants) pe pagina licenței înainte de orice altceva.

Niciun răspuns de la IA

Asistentul de inteligență artificială (IA) afișează MODEL_NOT_CONNECTED (503), un pas din fluxul de lucru eșuează cu NO_PROVIDER_FOR_ROLE (422) sau răspunsurile pur și simplu se opresc.

Rezerva (pool-ul) organizației nu are nicio cheie care poate răspunde sau ruterul nu poate ajunge la furnizor. Fiecare organizație își aduce propria cheie de model. Fără nicio cheie în uz nu există IA, prin concepție, și nicio cheie partajată nu îi ia locul.

Verificați rezerva și alegerea ruterului, fiecare cu propriul token de acces al persoanei:

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

Prima comandă listează fiecare furnizor, dacă poate răspunde și de ce nu ("No key in use: 1 withdrawn, 1 lapsed"), precum și starea fiecărei chei. A doua returnează modelul pe care ruterul l-ar folosi pentru organizație sau refuzul său exprimat în cuvinte. Apoi verificați calea de ieșire din cluster cu aceste două comenzi:

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

Ce înseamnă fiecare rezultat:

Găsiți Rezolvare
Nicio cheie în rezervă Un proprietar sau administrator adaugă o cheie de organizație în panoul de comutare IA (AI switchboard) sau în Settings, AI models
Chei invalid, expired sau exhausted Adăugați o cheie nouă; cea veche rămâne listată ca istoric
Chei resting Așteptați: o cheie care eșuează intră în repaus timp de 60 de secunde, iar după 5 eșecuri consecutive este oprită (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE cu chei în uz Rolul nu are nicio atribuire și nimic nu corespunde; setați rolul în politica de rutare
MODEL_CAPABILITY_UNAVAILABLE (422) Cererea are nevoie de o capabilitate sau de o rezidență a datelor pe care niciun furnizor din rezervă nu o oferă; activați unul care o oferă
Nicio politică nexus-operator-egress sau intervalele furnizorului lipsesc din aceasta Adăugați intervalele, scrise în notația Classless Inter-Domain Routing (CIDR), în networkPolicy.externalEgressCIDRs și actualizați
Un server de model local care nu răspunde Verificați ai.localProvider.baseUrl, listați serverul în ai.installationHosts și permiteți intervalul său în networkPolicy.externalEgressCIDRs

O cheie de furnizor găzduit care funcționează de pe un laptop și eșuează pe instalare are aproape întotdeauna drept cauză politica de rețea. Namespace-ul interzice traficul de ieșire (egress) în mod implicit.

Răspunsuri 429

Un client primește răspunsul 429 Too Many Requests. Nexus are patru locuri care pot returna acest lucru, iar corpul răspunsului vă indică despre care este vorba.

Unde Cod și detalii Ce trebuie modificat
nexus-auth, per persoană autentificată RATE_LIMITED cu limit, windowSeconds și retryAfterSeconds auth.rateLimitPerMinute (implicit 5000), pentru automatizare intensă
O limită pentru cheie de script, aplicație sau unitate (Enterprise) RATE_LIMITED numind cheia și limita acesteia Limita din Settings, Rate limits, împreună cu un motiv
Pagina de revendicare de la prima rulare RATE_LIMITED cu retry_after_seconds Nimic: așteptați și aflați cine altcineva încearcă pagina
Un furnizor de model Ruterul îl tratează ca pe un eșec trecător și trece la următorul furnizor Adăugați o altă cheie sau un alt furnizor dacă se întâmplă des

Fiecare dintre ele poartă un antet Retry-After. Un client care se comportă corect așteaptă acel interval și nu reîncearcă mai devreme.

Dacă toți utilizatorii par să împartă simultan o singură limită, verificați proxy.trustedCIDRs. Când nu acoperă rețeaua de pod-uri a controlerului dumneavoastră de ingress, nexus-auth nu poate avea încredere în antetul X-Forwarded-For și vede fiecare cerere ca venind de la controler. Valoarea implicită, 10.42.0.0/16, se potrivește doar pentru k3s.

kubectl get pods -A -o wide

Găsiți adresa pod-ului controlerului de ingress în rezultat și asigurați-vă că proxy.trustedCIDRs o acoperă.

Erori la actualizarea versiunii

Actualizarea a revenit la starea anterioară (rolled back). Pagina Upgrade afișează UPGRADE_ROLLED_BACK: un pas a eșuat, fiecare motor a revenit la versiunea anterioară, iar datele nu au fost modificate. Pagina numește pasul. Un caz frecvent este un volum prea mic pentru noua structură a unui depozit de date. Rezolvați ceea ce indică, rulați din nou nexusctl upgrade plan --bundle <file>, apoi aplicați. Copia de rezervă (backup) este creată din nou mai întâi.

Chart-ul refuză randarea cu EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Resursa Secret nexus-generated deține EXTERNAL_KEY_ENCRYPTION_KEY într-o formă pe care chart-ul nu o poate folosi. Trebuie să fie în format base64 de 32 de octeți sau cheia brută de 32 de octeți a unei instalări mai vechi. Cineva a editat sau a înlocuit resursa Secret. Puneți înapoi cheia sub care sunt sigilate datele acestei instalări, ca base64 al celor 32 de octeți ai săi (printf %s "$OLD" | base64), și actualizați din nou. Nu lăsați chart-ul să creeze una nouă: datele sigilate sub cheia veche ar rămâne ilizibile.

Scripturile sunt refuzate cu TOKEN_ORG_MISSING după actualizare. Fiecare serviciu care verifică cheile de interfață de programare a aplicațiilor (API) prin nexus-auth refuză acum o cheie fără organizație, cu 403 TOKEN_ORG_MISSING. Atribuiți fiecărei astfel de chei o organizație sau emiteți o cheie nouă.

Cheile raportează aplicația greșită timp de o oră. Goliți intrările de chei stocate în memoria cache a nexus-auth, depozitul Valkey al instalării. Capitolul 2.15, Ziua a doua: operarea Nexus, conține comanda, atât pentru depozitul din interiorul clusterului, cât și pentru unul extern.

Un hook de migrare a eșuat. helm upgrade raportează un hook pre-actualizare eșuat. Schema se modifică înainte ca noile pod-uri să fie desfășurate, astfel încât versiunea care rulează deservește în continuare cererile. Citiți jurnalul resursei Job cu kubectl -n nexus logs job/<job-name>, rezolvați ceea ce indică și rulați din nou actualizarea.

Serviciile nu și-au putut folosi tabelele timp de câteva secunde. La prima actualizare a unei instalări făcute dintr-un chart mai vechi, fiecare serviciu își pierde vechile drepturi implicite asupra tabelelor și le primește înapoi pe ale sale din propria migrare. Intervalul este de câteva secunde. Actualizați într-o perioadă liniștită sau scalați serviciile la zero mai întâi.

Versiunea de pe disc a fost refuzată. Importul de pe suportul media afișează MEDIA_SIGNATURE_INVALID (422): fișierele nu sunt semnate de cheia de versiune instalată pe această instalare. Nimic nu a fost încărcat, iar versiunea care rulează continuă să ruleze. Păstrați suportul media pentru echipa dumneavoastră de securitate și solicitați de la Adverant un nou suport media prin schimbul offline.

Un refuz de randare a diagramei (chart)

helm install, helm upgrade sau helm template se oprește înainte ca ceva să fie aplicat, cu un mesaj care începe cu un cod sau numește o valoare. Chart-ul refuză valorile pe care nu le poate rula în siguranță. Nimic din cluster nu s-a modificat.

Randați chart-ul separat pentru a vedea fiecare refuz fără a atinge clusterul. Folosiți chart-ul Enterprise pe care l-ați descărcat în locul adresei oci:// pe Enterprise și setați networkPolicy.apiServerCIDRs în valori, deoarece o randare offline nu îl poate citi din cluster:

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 verifică aceleași valori de identitate în secțiunea sa "time and keys" și raportează aceleași coduri. Codul său de ieșire este 0 atunci când instalarea poate continua (avertismentele nu blochează), 1 atunci când cel puțin o verificare a eșuat și 2 atunci când nu a putut rula.

Verificarea preliminară nu poate continua
Verificarea preliminară nu poate continua
Preflight nu poate continua. Verificările eșuate apar primele, fiecare cu rezolvarea sa, iar instalarea rămâne blocată cu PREFLIGHT_FAILED până când acestea trec cu succes.
Refuz Cauză Rezolvare
INSTALLATION_NAME_MISSING keys.installationName este gol Setați-l la numele propriu al acestei instalări, corespunzător cu ^[a-z][a-z0-9-]{0,62}$. Este permanent odată ce depozitul de chei pornește pentru prima dată
INSTALLATION_NAME_EXAMPLE Numele este cel din fișierele cu valori de exemplu ale chart-ului Setați propriul dumneavoastră nume
keys.installationName "…" does not match … Majuscule, caractere de subliniere (underscore) sau o cifră la început Folosiți litere mici, cifre și cratime, începând cu o literă
KEYS_CUSTODIAN_MISSING keys.custody.recipients este gol Listați destinatarii age ai custozilor dumneavoastră, jumătățile publice
KEYS_CUSTODIAN_EXAMPLE Un destinatar este custodele de exemplu din fișierele de valori ale chart-ului, a cărui identitate nu o deține nimeni Înlocuiți-l cu destinatarii propriilor dumneavoastră custozi
keys.custody.recipients: … Un destinatar într-o formă pentru care resursa Job de custodie nu poate cripta Folosiți age1…, age1tag1…, age1tagpq1…, age1pq1… sau age1se1…, cu litere mici
NEXUS_EDITION_INVALID edition nu este nici community, nici enterprise Setați una dintre cele două
edition=… but enterprise.enabled=… Cele două nu sunt în concordanță Setați enterprise.enabled: true exact atunci când edition este enterprise
global.imageRegistry is required Niciun registru numit Setați registrul din care nodurile dumneavoastră descarcă imaginile
hosts.<name> is required Lipsește o gazdă publică Setați hosts.console, hosts.api și hosts.auth
tls.existingSecret is required when tls.mode is existing Nicio resursă Secret de certificat numită Numiți resursa Secret sau alegeți un alt tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Niciun emitent numit Numiți resursa dumneavoastră ClusterIssuer
dataTier.<store>.external.host is required when mode is external Un depozit extern fără adresă Indicați gazda acestuia și resursa sa Secret în existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template nu are niciun cluster în care să le caute Indicați adresele serverului API ca intervale /32
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID Cheia generată în nexus-generated are forma greșită Consultați "Upgrade errors" de mai sus

Un fișier de valori care folosește o cheie pe care chart-ul nu o are, sau o valoare de tip greșit, este refuzat de schema chart-ului înaintea oricăreia dintre acestea. telemetry.enabled: true este un exemplu: schema acceptă doar false.

Trimiterea unui pachet de asistență

Când nimic din toate acestea nu rezolvă problema, trimiteți către Adverant un pachet de asistență (support bundle) împreună cu solicitarea dumneavoastră de asistență.

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

<request-number> este numărul solicitării pe care ați deschis-o în pagina Support and support bundles a contului dumneavoastră. Puteți crea același pachet din pagina Support bundle a consolei, sub This installation.

Pachetul conține jurnalele motoarelor din ultimele 24 de ore, detalii despre starea de funcționare și versiune, setările fără secretele lor, precum și rapoartele de preflight și de instalare. Înainte de a fi scris, procesul de anonimizare (redaction) înlocuiește numele, secretele și adresele, iar dumneavoastră citiți o previzualizare a ceea ce pleacă exact. Mesajele, fișierele și memoria persoanelor nu sunt colectate niciodată.

Încărcați-l în solicitarea din contul dumneavoastră sau salvați-l pe un suport media și transferați-l în exterior dacă instalarea nu are conexiune externă. Doar inginerii de asistență numiți în solicitare îl pot deschide și este șters după 30 de zile. Menționați în solicitare pe care dintre problemele de mai sus o analizați și ce au arătat verificările din acest capitol: acest lucru scutește un schimb suplimentar de mesaje.