Verzió 1.0.0-alpha.1legújabb
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

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:
- 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.
- Futtassa újra a
nexusctl preflightparancsot 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é. - Használja a
--explainkapcsolót bármelynexusctlműveletnél (verb), amelyben nem biztos. Ez futtatás nélkül kiírja akubectléshelmmű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.
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.ioA 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
--waitkapcsoló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 astorage.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-schemaA 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 ingressAz 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.exampleEz 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.
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.exampleA 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.
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.jsonAz 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-gatewayMit 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 wideKeresse 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.yamlA 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.
| 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.gzA <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.


