BejelentkezésBemutató kérése

2.17. fejezet

Hibaelhárítás

A leggyakoribb problémák, amelyekkel az üzemeltetők találkoznak, a tapasztalt jelenségek szerint rendszerezve. Mindegyiknél szerepel a kiváltó ok, az azt megerősítő parancs és a megoldás, a fejezet pedig a támogatási csomag (support bundle) beküldésével zárul.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

22 perc olvasási idő

A Nexus telepítése során felmerülő hibák többsége ugyanarra a tucatnyi okra vezethető vissza, és szinte mindegyik egy kóddal jelzi magát. Ez a fejezet aszerint épül fel, hogy Ön mit tapasztal, nagyjából abban a sorrendben, ahogyan az egyes problémákkal találkozhat: telepítés, birtokbavétel, licencelés, majd futtatás. Mindegyikhez megkapja az okot, az azt megerősítő parancsot és a megoldást.

A példák a Harrow Port Authority telepítését használják: nexus névtér (namespace), nexus kiadás (release), valamint a console.harrow.example, api.harrow.example és auth.harrow.example hosztok. Cserélje le ezeket a sajátjaira. Három szokás minden itteni problémánál időt takarít meg:

  1. Olvassa el a kódot az üzenet előtt. A Nexusban minden elutasítás egy gépi kóddal végződik, és ez a fejezet a kódok szerint van indexelve.
  2. Futtassa újra a nexusctl preflight parancsot a fürt (cluster) vagy a values fájl bármilyen módosítása után. Ez módosítás nélkül olvassa ki a fürtöt, és a legtöbb chart-elutasítást név szerint jelenti, még mielőtt a Helm megtenné.
  3. Használja a --explain kapcsolót bármely nexusctl műveletnél (verb), amelyben nem biztos. Ez futtatás nélkül kiírja a kubectl és helm műveleteket.

A telepítés elakad

Elindította a telepítést, de nem fejeződött be. A helm tizenöt perc után sem tért vissza, vagy visszatért, de a podok még mindig Init vagy Pending állapotban vannak, esetleg a konzol címe nem válaszol.

A leggyakoribb ok a helm install --wait. A Nexus a telepítés utáni (post-install) hookokban hozza létre az adatbázisát, a szerepköreit és minden szolgáltatás sémáját, és a bootstrap hook az, amelyik átadja az egyes szolgáltatásoknak az adatbázis-jelszavukat. A --wait használatakor a Helm megvárja, amíg a Deploymentek készenléti (ready) állapotba kerülnek, mielőtt lefuttatná ezeket a hookokat, miközben a Deploymentek a hookokra várnak. Egyik sem mozdul. Soha ne telepítsen a --wait kapcsolóval; telepítsen nélküle, és várjon utána.

Lefelé mutató nyilakkal összekötött dobozok függőleges sorozata: "Release resources created (Deployments start, each held by its wait-for-schema init container)", majd "Database bootstrap hook: database, roles, release ledger", majd "Migration hooks, one per service, in a fixed order", végül "Each hook writes its row in the release ledger". Az utolsó dobozból nyilak ágaznak szét oldalra három kis dobozhoz: "nexus-auth starts", "nexus-gateway starts", "other services start". A legfelső doboz mellett egy oldalsó megjegyzés látható, egy áthúzott nyíllal az aljáig: "helm install --wait waits here for Deployments that are waiting for the hooks".
Mi fut le, sorrendben, amikor a chart települ vagy frissül.

A többi ok szokásos Kubernetes-probléma. A képfájlokat (image) nem lehet lehúzni, mert a global.imageRegistry rossz tárolót (registry) nevez meg, vagy egy Enterprise telepítésnek nincs lehúzási tokenje (pull token). Egy kötet Pending állapotban marad, mert a tárolási osztály (storage class) nem létezik. Hiányzik a cert-manager, amely esetben a telepítés egyáltalán nem akad el: másodperceken belül meghiúsul, mert a chart tanúsítványkibocsátóinak (certificate issuers) szükségük van a cert-manager erőforrásaira.

Kezdje a podokkal és a hook Jobokkal:

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

A describe az eseményei között megmutatja a képfájl-lehúzási hibákat és a nem csatolt köteteket. Egy olyan hook Job, amely 0/1 befejezést mutat egy sikertelen poddal, megállította a telepítést, mivel a hook Jobok backoff limitje 0, és soha nem próbálkoznak újra csendben. A naplója megmondja az okot.

Így javíthatja ki az egyes okokat:

  • Ha a Helm a --wait kapcsolóval várakozik, állítsa le, távolítsa el (uninstall), majd telepítse újra a kapcsoló nélkül. Ezután várja meg a szolgáltatásokat:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Lehúzási hibák esetén ellenőrizze a global.imageRegistry értéket, Enterprise esetén pedig a lehúzási tokent a fiókja Pull tokens and install commands (Lehúzási tokenek és telepítési parancsok) oldalán.
  • A Pending állapotú köteteknél állítsa a storage.className értéket egy olyan tárolási osztályra, amellyel a fürt rendelkezik, vagy tegyen egyet alapértelmezetté.
  • Hiányzó cert-manager esetén telepítse a cert-manager v1.21.3 verzióját, és futtassa újra a telepítést.
  • Sikertelen hook esetén javítsa ki azt, amit a naplója megnevez, és futtassa újra a telepítést.

Egy pod a sémájára vár

Egy szolgáltatás podja percekig Init:0/1 állapotban áll. Minden olyan szolgáltatásnak, amely az adatbázist használja, van egy init konténere, a wait-for-schema, amely visszatartja a podot, amíg a kiadási főkönyv (release ledger) azt nem mutatja, hogy a migrációk alkalmazva lettek az adott kiadás képfájljához. Ez a telepítés vagy frissítés első perceiben, amíg a migrációs hookok futnak, normális. Akkor jelent problémát, ha nem ér véget.

Olvassa el az init konténer naplóját:

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

A napló megnevezi a komponenst, a migrációs láncokat, amelyekre vár, és az időkorlátját, majd kiír egy sort, valahányszor az állapota megváltozik:

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
A folyamatjelző sor szövege Mit jelent
Mely láncokat kell még alkalmazni ehhez a kiadáshoz A megnevezett migrációs hookok nem fejeződtek be. Nézze meg ezeket a Jobokat.
Hogy a kiadási főkönyv nem olvasható, az adatbázis hibájával együtt A Postgres nem válaszol, vagy a főkönyv nem létezik, mert az adatbázis bootstrap nem futott le.
FAILED (<component>): after <n>s, … schemaWait.timeoutSeconds után feladta (alapértelmezés szerint 1800). Az init konténer újraindul; maga a szolgáltatás el sem indult.

Egy olyan lánc, amely soha nem kerül alkalmazásra, szinte mindig azt jelenti, hogy a migrációs Jobja meghiúsult. Keresse meg a kubectl -n nexus get jobs paranccsal, és olvassa el a naplóját. Javítsa ki, amit megnevez (megtelt lemez, külső adatbázis, amelyet a migráló nem ér el, szerepkör-ütközés), és futtassa a helm upgrade parancsot ugyanazokkal az értékekkel: a hookok újra lefutnak, és mindegyik biztonságosan újrafuttatható.

Csak akkor növelje a schemaWait.timeoutSeconds értékét, ha a migráció lassú, de egészséges, amilyen egy nagy első migráció lehet lassú tárhelyen. Ha azért növeli meg, hogy elrejtsen egy sikertelen Jobot, azzal csak arra készteti a podot, hogy tovább várjon valamire, ami soha nem fog bekövetkezni.

A kulcstár le van zárva (sealed)

Áramszünet, csomópont-újraindítás (node reboot) vagy konténer-futásidejű környezet (container runtime) újraindulása után a podok visszatérnek, a konzol betöltődik, de minden, amihez kulcs kell, meghiúsul vagy várakozik. A feloldó (unsealer) a csomópontja minden újraindulása után lezárt (sealed) állapotban indul, a kulcstároló (key store) pedig nem tudja feloldani magát, amíg a feloldó nincs nyitva.

Kérdezze le az OpenBao-t minden podban:

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

A 0 kilépési kód feloldott (unsealed), a 2 lezárt (sealed) állapotot jelent, a 1 pedig azt, hogy nem tudott válaszolni (kérdezze le újra egy perc múlva). Futtassa ugyanezt a openbao-0 ellen a -tls-server-name=openbao megadásával a kulcstárolóhoz. Ha a feloldó fel van oldva, de a kulcstároló nincs, akkor a kulcstároló éppen feloldja magát; adjon neki egy percet.

Egy lezárt feloldó javításához az egyik kulcsőr (custodian) lefuttatja a chart unseal.sh szkriptjét a saját age identitásával. A 2.15. fejezet, Második nap: a Nexus üzemeltetése tartalmazza a teljes parancsot. A szkript kilépési kódja megmondja, mi történt:

Kilépési kód Jelentés Teendők
0 Feloldva Ellenőrizze a kubectl -n nexus get deploy,statefulset állapotát egy percen belül.
1 Még mindig lezárva, vagy egy feloldási hívás sikertelen volt Olvassa el az általa kiírt kulcsrész-sorokat (share lines); futtassa újra.
2 Egy előfeltétel hiányzik Az üzenet megnevezi: AGE_IDENTITY, egy bináris, például age vagy jq, vagy egy közvetlen módú (direct-mode) beállítás.
3 Ez az identitás nem tudja visszafejteni a kulcsrészeket Ön nem kulcsőre ennek a telepítésnek. Semmi nem lett beküldve. Keressen egy olyan kulcsőrt, aki az.

Nem lehet HTTP-n keresztül bejelentkezni

A konzol betöltődik egy http:// címen, vagy egy kubectl port-forward kapcsolaton keresztül a 127.0.0.1 felé, de a bejelentkezés meghiúsul. A passkey (hozzáférési kulcs) kérése soha nem jelenik meg, vagy a bejelentkezés visszaugrik az elejére.

A bejelentkezéshez a konzol saját HTTPS eredetére (origin) van szükség. A konzol csak a https://<hosts.console> címről fogad el bejelentkezést, a munkamenetet egy Secure jelölésű __Host- sütiben (cookie) tartja (amelyet a böngésző csak HTTPS-en keresztül tárol), és az első adminisztrátor passkey-jéhez érvényes tanúsítvánnyal rendelkező oldal szükséges. A böngészők elutasítják a passkey-ket tanúsítványhiba mögött. Egy http://127.0.0.1 felé irányuló port-forwarddal soha nem lehet bejelentkezni.

Ellenőrizze, mit ért el ténylegesen a böngésző:

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

Az elsőnek HTTPS-en keresztül kell válaszolnia egy olyan tanúsítvánnyal, amelyben a gépe megbízik. A másodiknak a három hosztot kell mutatnia azokkal a nevekkel, amelyeket a hosts.* alatt állított be.

A javításhoz érje el a konzolt a https://console.harrow.example címen, pontosan a hosts.console alatt megadott néven, egy olyan tanúsítvánnyal, amelyben a böngésző megbízik. A tls.mode: existing esetén ellenőrizze, hogy a tls.existingSecret mindhárom hoszthoz tartalmaz-e tanúsítványt. A tls.mode: cert-manager esetén ellenőrizze, hogy a ClusterIssuer állította-e ki. A tls.mode: none esetén a Transport Layer Security (TLS) az Ön saját terheléselosztóján (load balancer) végződik, és a tanúsítványnak ott kell megfelelőnek lennie. Privát hitelesítésszolgáltató (certificate authority) esetén telepítse annak tanúsítványát azokra a gépekre, amelyekről az adminisztrátorok bejelentkeznek.

Az igénylőkód lejárt

A Claim this installation (Telepítés birtokbavétele) oldalon a rendszer CLAIM_CODE_EXPIRED (410) hibával elutasítja a kódot. A birtokbavételi kód (claim code) három darab négykarakteres csoportból áll. Egyszer működik, 30 percig, 5 próbálkozással. Ezután, vagy az ötödik hibás próbálkozás után érvénytelenné válik, és semmi sem lett birtokba véve vagy módosítva.

Készítsen új kódot abból a terminálból, amelynek van hozzáférése a fürthöz:

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

Ez kiír egy friss kódot és a telepítés ujjlenyomatát (fingerprint). Írja be a kódot a birtokbavételi oldalon 30 percen belül, és hasonlítsa össze újra az ujjlenyomatot.

Telepítés igénylése
Telepítés igénylése
Claim this installation (Telepítés birtokbavétele). A terminálból származó kód három csoportban kerül beírásra, az oldal pedig négyes csoportokban mutatja a teljes ujjlenyomatot az összehasonlításhoz; a lejárt kódot a rendszer CLAIM_CODE_EXPIRED hibával elutasítja, és semmi sem kerül birtokbavételre.

Két kapcsolódó válasz:

  • A RATE_LIMITED (429) a birtokbavételi oldalon azt jelenti, hogy az oldalon több próbálkozás is történt az elmúlt percben. Várja meg az általa megadott másodperceket. Ha nem Ön tette ezeket a próbálkozásokat, valaki más a hálózatán próbálkozik az oldallal; derítse ki, ki az, mielőtt birtokba venné.
  • A TRANSITION_NOT_PERMITTED (409) azt jelenti, hogy a telepítést már birtokba vették, és a birtokbavételi oldala végleg ki van kapcsolva. Ehelyett jelentkezzen be. Ha nem Ön vette birtokba, kezelje ezt biztonsági incidensként.

Az ujjlenyomat nem egyezik

A birtokbavételi oldal CLAIM_FINGERPRINT_MISMATCH (403) hibát mutat, vagy Ön is láthatja, hogy az oldalon lévő nyolc darab négyes csoport eltér azoktól, amelyeket a terminálja kiírt. Még egyetlen eltérő csoport is azt jelenti, hogy a böngésző egy másik telepítéssel kommunikál.

Álljon meg. Ne írja be a kódot arra az oldalra. Lehetséges, hogy a telepítésén kívül valami más válaszol azon a címen, esetleg egy olyan gép, amelyet az első adminisztrátor elfogására állítottak fel. Ha birtokba venné, az a gép birtokolná a szervezetét. Az Ön saját telepítése változatlan, és még mindig nincs birtokba véve.

Ellenőrizze, hová mutat a név, és melyik tanúsítvány válaszolt:

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

A címnek az Ön ingress controllerének címének kell lennie, a tanúsítványnak pedig annak, amelyet a hosts.console számára telepített.

Az ujjlenyomat nem egyezik
Az ujjlenyomat nem egyezik
Az ujjlenyomatok a nyolc csoportból háromban eltérnek. Az oldal felszólítja a megállásra, elmagyarázza, ki válaszolhat, és felsorolja, mit kell ellenőrizni az újrapróbálkozás előtt.

A javításhoz adja át a biztonsági csapatának a válaszoló címet, és őrizze meg a telepítési naplót, amely rögzíti a telepítés által kiírt ujjlenyomatot. Javítsa ki a Domain Name System (DNS) rekordot vagy a proxyt, amely máshová irányította Önt. Ezután készítsen új birtokbavételi kódot a nexusctl claim-code --administrator <email> paranccsal, és vegye birtokba egy megbízható hálózaton lévő böngészőből, újra összehasonlítva mind a nyolc csoportot.

A licenc elutasításra kerül

Az importálás az Import the licence (Licenc importálása), az Import a new licence (Új licenc importálása) oldalon vagy a nexusctl licence import végponton elutasítással válaszol. Az elutasított importálás semmin sem változtat: a hatályos licenc hatályban marad, és az óra alsó korlátja (clock floor) nem mozdul el.

Olvassa el a kódot és a lépést:

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

Az elutasítás törzse (body) tartalmazza a code, message, refused_at (a meghiúsult lépés) és troubleshooting mezőket. A hatályos licenc állapotának megtekintéséhez olvassa ki a GET https://auth.harrow.example/api/v1/installation/licence/state végpontot ugyanazzal a tokennel.

Kód HTTP Szokásos ok Megoldás
LICENCE_SIGNATURE_INVALID 422 A fájlt szerkesztették, újraformázták vagy újramentették, vagy hiányzik az egyik aláírás Töltse le újra a fiókjából, és érintetlenül importálja
LICENCE_FORMAT_INVALID 422 Nem licenc: rossz fájl, csonkolt, vagy másik objektumba van csomagolva Küldje el a fájlt pontosan úgy, ahogyan az Adverant átadta
LICENCE_ROOT_UNKNOWN 422 Olyan kulccsal írták alá, amelyet ez a kiadás nem tartalmaz Frissítsen, vagy kérjen az Ön kiadásához aláírt licencet
LICENCE_MATRIX_MISMATCH 422 Újabb kiadási mátrixhoz (edition matrix) írták, vagy olyan csoportot engedélyez, amelyet ez a build nem ismer Frissítsen, vagy kérjen az Ön kiadásához írt licencet
LICENCE_OTHER_INSTALLATION 409 Másik telepítéshez állították ki, gyakran a tesztfürt licencét használják éles környezetben Kérjen licencet ennek a telepítésnek az identitásához
LICENCE_REVOKED 403 Az Adverant visszavonta Kérjen új licencet az Adveranttól
LICENCE_LOCKED 403 A starts_on értéke az aktuális dátum után van Importálja az első napján vagy azután
TRANSITION_NOT_PERMITTED 409 Ezt a licencazonosítót már importálták Nincs teendő, ha hatályban van; forduljon az Adveranthoz, ha a feltételeken változtatni kell
RECORD_NOT_FOUND 404 A telepítést még nem deklarálták, így még nincs identitása Fejezze be az első adminisztrátori lépést, majd importáljon
TENANT_NOT_A_PARAMETER 403 A törzs a legfelső szintjén megnevez egy szervezetet Magát a licencfájlt küldje el törzsként

Két dolog licencproblémának tűnik, de nem az. Egy olyan állapotolvasás, amely LICENCE_CLOCK_BEHIND_FLOOR értéket hordoz, azt jelenti, hogy a csomópont órája korábbi időt mutat, mint a legutolsó időpont, amelyet a telepítés látott; javítsa ki a csomópont idejét, és ha az óra előreszaladt és magával vitte az alsó korlátot, kérjen az Adveranttól idő-visszaállító tokent (time-reset token). Egy olyan licenc pedig, amely importálódik, de egy csoportot mégis előzetesként (teaser) mutat, általában nem engedélyezi azt a csoportot: mindenekelőtt olvassa el a jogosultságokat (grants) a licencoldalon.

Nincsenek AI-válaszok

A mesterséges intelligencia (AI) asszisztens MODEL_NOT_CONNECTED (503) hibát mutat, egy munkafolyamat-lépés NO_PROVIDER_FOR_ROLE (422) hibával meghiúsul, vagy a válaszok egyszerűen leállnak.

A szervezet készletében (pool) nincs olyan kulcs, amely válaszolni tudna, vagy az útválasztó (router) nem éri el a szolgáltatót. Minden szervezet a saját modellkulcsát hozza. Használatban lévő kulcs nélkül nincs AI – ez szándékosan van így tervezve –, és semmilyen megosztott kulcs nem ugrik be helyette.

Ellenőrizze a készletet és az útválasztó választását, mindegyiket az adott személy saját hozzáférési tokenjével:

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

Az első felsorolja az egyes szolgáltatókat, azt, hogy tudnak-e válaszolni, és ha nem, miért ("No key in use: 1 withdrawn, 1 lapsed"), valamint minden kulcs állapotát. A második megválaszolja, melyik modellt használná az útválasztó a szervezethez, vagy szövegesen az elutasítást. Ezután ellenőrizze a fürtből kivezető útvonalat ezzel a két paranccsal:

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

Mit jelent az egyes eredmény:

Amit talál Megoldás
Nincs kulcs a készletben Egy tulajdonos vagy adminisztrátor hozzáad egy szervezeti kulcsot az AI switchboard (AI-kapcsolótábla) vagy a Settings, AI models (Beállítások, AI-modellek) oldalon
invalid, expired vagy exhausted állapotú kulcsok Adjon hozzá egy friss kulcsot; a régi előzményként felsorolva marad
resting állapotú kulcsok Várjon: a hibázó kulcs 60 másodpercig pihen, és egymás után 5 sikertelen próbálkozás után kikapcsolásra kerül (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE használatban lévő kulcsokkal A szerepkörnek nincs hozzárendelése, és semmi sem felel meg; állítsa be a szerepkört az útválasztási szabályzatban (routing policy)
MODEL_CAPABILITY_UNAVAILABLE (422) A kérés olyan képességet vagy adathelyet (residency) igényel, amelyet a készletben lévő egyetlen szolgáltató sem kínál; engedélyezzen egy olyat, amelyik igen
Nincs nexus-operator-egress szabályzat, vagy hiányoznak belőle a szolgáltató tartományai Adja hozzá a tartományokat Classless Inter-Domain Routing (CIDR) jelöléssel a networkPolicy.externalEgressCIDRs értékhez, és frissítsen
Helyi modellszerver, amely nem válaszol Ellenőrizze a ai.localProvider.baseUrl értéket, sorolja fel a szervert a ai.installationHosts alatt, és engedélyezze a tartományát a networkPolicy.externalEgressCIDRs alatt

Egy hosztolt szolgáltatói kulcs, amely laptopról működik, de a telepítésen meghiúsul, szinte mindig a hálózati szabályzat (network policy) miatt van. A névtér alapértelmezés szerint tiltja a kimenő forgalmat (egress).

429-es válaszok

Egy kliens 429 Too Many Requests választ kap. A Nexusnak négy helye van, amely ezt mondhatja, és a törzs megmondja, melyik az.

Hol Kód és részletek Mit kell módosítani
nexus-auth, bejelentkezett személyenként RATE_LIMITED, limit, windowSeconds és retryAfterSeconds mezőkkel auth.rateLimitPerMinute (alapértelmezett 5000), intenzív automatizáláshoz
Szkriptkulcs-, alkalmazás- vagy egységkorlát (Enterprise) RATE_LIMITED, amely megnevezi a kulcsot és a korlátját A korlátot a Settings, Rate limits (Beállítások, Sebességkorlátok) oldalon, indoklással
Az első futtatási birtokbavételi oldal RATE_LIMITED, retry_after_seconds mezővel Semmit: várjon, és derítse ki, ki más próbálkozik még az oldallal
Egy modellszolgáltató Az útválasztó átmeneti hibaként kezeli, és továbblép a következő szolgáltatóra Adjon hozzá másik kulcsot vagy szolgáltatót, ha ez gyakran előfordul

Mindegyik tartalmaz egy Retry-After fejlécet. Egy szabályosan működő kliens ennyi ideig vár, és nem próbálkozik újra korábban.

Ha úgy tűnik, hogy egyszerre minden felhasználó egyetlen korláton osztozik, ellenőrizze a proxy.trustedCIDRs értéket. Ha az nem fedi le az ingress controller podhálózatát, a nexus-auth nem tudja hitelesnek elfogadni a X-Forwarded-For fejlécet, és minden kérést úgy lát, mintha a controllertől érkezne. Az alapértelmezett 10.42.0.0/16 csak a k3s-hez illeszkedik.

kubectl get pods -A -o wide

Keresse meg a kimenetben az ingress controller podcímét, és győződjön meg arról, hogy a proxy.trustedCIDRs lefedi azt.

Frissítési hibák

A frissítés visszaállt (rolled back). Az Upgrade (Frissítés) oldal UPGRADE_ROLLED_BACK állapotot mutat: egy lépés meghiúsult, minden motor visszatért az előző kiadásra, és az adatok nem változtak. Az oldal megnevezi a lépést. Gyakori ok, hogy egy kötet túl kicsi egy tároló új elrendezéséhez. Javítsa ki, amit megnevez, futtassa újra a nexusctl upgrade plan --bundle <file> parancsot, majd alkalmazza. Először ismét elkészül a biztonsági mentés.

A chart elutasítja a renderelést EXTERNAL_KEY_ENCRYPTION_KEY_INVALID hibával. A nexus-generated Secret olyan formában tárolja a EXTERNAL_KEY_ENCRYPTION_KEY kulcsot, amelyet a chart nem tud használni. Ennek 32 bájt base64-kódolásának, vagy egy régebbi telepítés nyers, 32 bájtos kulcsának kell lennie. Valaki szerkesztette vagy lecserélte a Secretet. Tegye vissza azt a kulcsot, amellyel ennek a telepítésnek az adatai le vannak zárva, a 32 bájtjának base64-kódolásaként (printf %s "$OLD" | base64), és frissítsen újra. Ne hagyja, hogy a chart újat készítsen: a régi kulccsal lezárt adatok olvashatatlanok maradnának.

A szkripteket a frissítés után TOKEN_ORG_MISSING hibával elutasítják. Minden olyan szolgáltatás, amely a nexus-auth-on keresztül ellenőrzi az alkalmazásprogramozási felület (API) kulcsait, mostantól 403 TOKEN_ORG_MISSING hibával elutasítja a szervezet nélküli kulcsokat. Adjon minden ilyen kulcsnak egy szervezetet, vagy állítson ki új kulcsot.

A kulcsok egy órán keresztül rossz alkalmazást jelentenek. Ürítse ki a gyorsítótárazott kulcsbejegyzéseket a nexus-auth gyorsítótárában, a telepítés Valkey tárolójában. A 2.15. fejezet, Második nap: a Nexus üzemeltetése tartalmazza a parancsot a fürtön belüli és a külső tárolóhoz is.

Egy migrációs hook meghiúsult. A helm upgrade egy sikertelen frissítés előtti (pre-upgrade) hookot jelent. A séma azelőtt módosul, hogy az új podok elindulnának, így a futó kiadás továbbra is kiszolgál. Olvassa el a Job naplóját a kubectl -n nexus logs job/<job-name> paranccsal, javítsa ki, amit megnevez, és futtassa újra a frissítést.

A szolgáltatások néhány másodpercig nem tudták használni a tábláikat. Egy korábbi chartból készült telepítés első frissítésekor minden szolgáltatás elveszíti a régi alapértelmezett táblajogosultságait, és a saját migrációjából kapja vissza a sajátjait. A kiesés néhány másodperc. Frissítsen csendes időszakban, vagy először skálázza le a szolgáltatásokat nullára.

A lemezen lévő kiadást elutasították. Az adathordozóról történő importálás MEDIA_SIGNATURE_INVALID (422) hibát mutat: a fájlok nincsenek aláírva az ezen a telepítésen telepített kiadási kulccsal. Semmi sem töltődött be, és a futó kiadás tovább fut. Őrizze meg az adathordozót a biztonsági csapatának, és kérjen az Adveranttól új adathordozót az offline cserén keresztül.

Chart renderelési elutasítás

A helm install, helm upgrade vagy helm template leáll, mielőtt bármi alkalmazásra kerülne, egy olyan üzenettel, amely egy kóddal kezdődik vagy megnevez egy értéket. A chart elutasítja azokat az értékeket, amelyeket nem tud biztonságosan futtatni. A fürtön semmi sem változott.

Renderelje a chartot önmagában, hogy minden elutasítást lásson anélkül, hogy hozzányúlna a fürthöz. Enterprise esetén használja a letöltött Enterprise chartot az oci:// cím helyett, és állítsa be a networkPolicy.apiServerCIDRs értéket a values fájlban, mert az offline renderelés nem tudja kiolvasni azt a fürtből:

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

A Preflight (előzetes ellenőrzés) ugyanazokat az identitásértékeket ellenőrzi a "time and keys" (idő és kulcsok) szakaszában, és ugyanazokat a kódokat jelenti. A kilépési kódja 0, ha a telepítés folytatódhat (a figyelmeztetések nem blokkolnak), 1, ha legalább egy ellenőrzés meghiúsult, és 2, ha nem tudott lefutni.

Az előzetes ellenőrzés nem folytatható
Az előzetes ellenőrzés nem folytatható
A Preflight nem tudja folytatni. Először a sikertelen ellenőrzések jelennek meg, mindegyik a saját megoldásával, és a telepítés PREFLIGHT_FAILED hibával blokkolva marad, amíg át nem mennek.
Elutasítás Ok Megoldás
INSTALLATION_NAME_MISSING A keys.installationName üres Állítsa be ennek a telepítésnek a saját nevére, amely illeszkedik a(z) ^[a-z][a-z0-9-]{0,62}$ mintára. Ez végleges, amint a kulcstároló először elindul
INSTALLATION_NAME_EXAMPLE A név megegyezik a chart példa values fájljaiban szereplő névvel Állítsa be a saját nevét
keys.installationName "…" does not match … Nagybetűk, aláhúzásjelek vagy kezdő számjegy Használjon kisbetűket, számjegyeket és kötőjeleket, betűvel kezdve
KEYS_CUSTODIAN_MISSING A keys.custody.recipients üres Sorolja fel a kulcsőrei age címzettjeit (recipients), a nyilvános feleket
KEYS_CUSTODIAN_EXAMPLE Az egyik címzett a chart values fájljaiból származó példakulcsőr, akinek az identitásával senki sem rendelkezik Cserélje le a saját kulcsőrei címzettjeire
keys.custody.recipients: … Olyan formátumú címzett, amelyre a custody Job nem tud titkosítani Használja a age1…, age1tag1…, age1tagpq1…, age1pq1… vagy age1se1… egyikét, kisbetűvel
NEXUS_EDITION_INVALID A edition sem nem community, sem nem enterprise Állítsa be a kettő egyikét
edition=… but enterprise.enabled=… A kettő ellentmond egymásnak Pontosan akkor állítsa be a enterprise.enabled: true értéket, amikor a edition értéke enterprise
global.imageRegistry is required Nincs megnevezve tároló (registry) Állítsa be azt a tárolót, ahonnan a csomópontjai lehúzzák a képfájlokat
hosts.<name> is required Hiányzik egy nyilvános hoszt Állítsa be a hosts.console, hosts.api és hosts.auth értékeket
tls.existingSecret is required when tls.mode is existing Nincs megnevezve tanúsítvány Secret Nevezze meg a Secretet, vagy válasszon másik tls.mode értéket
tls.clusterIssuer is required when tls.mode is cert-manager Nincs megnevezve kibocsátó (issuer) Nevezze meg a ClusterIssuerét
dataTier.<store>.external.host is required when mode is external Külső tároló cím nélkül Adja meg a hosztját, és a Secretjét a existingSecret alatt
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read A helm template nem rendelkezik fürttel, amelyben kikereshetné őket Adja meg az API-szerver címeit /32 tartományokként
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID A nexus-generated alatt generált kulcs formátuma hibás Lásd fent a "Frissítési hibák" (Upgrade errors) részt

Egy olyan values fájlt, amely a chartban nem szereplő kulcsot vagy rossz típusú értéket használ, a chart sémája még ezek előtt elutasít. A telemetry.enabled: true egy példa erre: a séma csak a false értéket fogadja el.

Támogatási csomag beküldése

Ha ezek egyike sem oldja meg a problémát, küldjön az Adverantnak egy támogatási csomagot (support bundle) a támogatási kérelmével együtt.

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

A <request-number> annak a kérelemnek a száma, amelyet a fiókja Support and support bundles (Támogatás és támogatási csomagok) oldalán nyitott. Ugyanezt a csomagot elkészítheti a konzol Support bundle (Támogatási csomag) oldalán is, a This installation (Ez a telepítés) alatt.

A csomag tartalmazza az elmúlt 24 óra motornaplóit, az állapot- és verzióadatokat, a beállításokat a titkaik nélkül, valamint az előzetes ellenőrzési (preflight) és telepítési jelentéseket. Kiírás előtt a kitakarás (redaction) lecseréli a neveket, titkokat és címeket, Ön pedig elolvashat egy előnézetet arról, hogy pontosan mi hagyja el a rendszert. A személyek üzeneteit, fájljait és memóriáját soha nem gyűjtjük be.

Töltse fel a fiókjában lévő kérelemhez, vagy mentse adathordozóra és vigye ki, ha a telepítésnek nincs külső kapcsolata. Csak a kérelemben megnevezett támogatási mérnökök nyithatják meg, és 30 nap után törlésre kerül. Írja le a kérelemben, hogy a fenti problémák közül melyiket vizsgálta, és mit mutattak az ebben a fejezetben szereplő ellenőrzések: ezzel megspórol egy oda-vissza kört.