Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.17
Bilanagreining
Vandamálin sem rekstraraðilar mæta oftast, flokkuð eftir því sem þú sérð. Hvert þeirra gefur til kynna orsökina, skipunina sem staðfestir hana og lausnina, og kaflinn endar á því að senda þjónustupakka.
Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

Flest sem fer úrskeiðis við uppsetningu á Nexus fer úrskeiðis á sömu tólf vegu, og næstum öll tilvikin gera vart við sig með kóða. Þessi kafli er skipulagður eftir því sem þú sérð, nokkurn veginn í þeirri röð sem þú myndir mæta hverju vandamáli: við uppsetningu, tilkall, leyfisveitingu og síðan rekstur. Fyrir hvert þeirra færðu orsökina, skipun sem staðfestir hana og lausnina.
Dæmin nota uppsetningu Harrow Port Authority: nafnarýmið nexus, útgáfuna nexus, hýslana console.harrow.example, api.harrow.example og auth.harrow.example. Skiptu þeim út fyrir þína eigin. Þrjár venjur spara tíma við hvert vandamál hér:
- Lestu kóðann á undan skilaboðunum. Hver synjun í Nexus endar á vélrænum kóða og kaflinn er flokkaður eftir þeim kóða.
- Keyrðu
nexusctl preflightaftur eftir hverja breytingu á klasanum eða gildisskránni. Skipunin les klasann án þess að breyta honum og tilkynnir flestar synjanir kortsins (chart) með nafni áður en Helm gerir það. - Notaðu
--explainmeð hvaðanexusctl-sögn sem þú ert óviss um. Það prentarkubectl- oghelm-aðgerðirnar án þess að keyra þær.
Uppsetningin frýs
Þú keyrðir uppsetninguna og henni er ekki lokið. helm hefur ekki skilað svari eftir fimmtán mínútur, eða hún skilaði svari og poddar eru enn í Init eða Pending, eða vistfang stjórnborðsins svarar ekki.
Algengasta orsökin er helm install --wait. Nexus býr til gagnagrunn sinn, hlutverk og skema hverrar þjónustu í krókum eftir uppsetningu (post-install hooks), og ræsikrókurinn (bootstrap hook) er sá sem afhendir hverri þjónustu lykilorð sitt að gagnagrunninum. Með --wait bíður Helm eftir að Deployments verði tilbúin áður en það keyrir þessa króka, á meðan Deployments bíða eftir krókunum. Hvorugt hreyfist. Settu aldrei upp með --wait; settu upp án þess og bíddu á eftir.
Hinar orsakirnar eru venjulegar Kubernetes-orsakir. Ekki er hægt að sækja myndir (images) vegna þess að global.imageRegistry nefnir ranga myndaskrá (registry), eða Enterprise-uppsetning er ekki með sóknartóka (pull token). Gagnageymsla (volume) helst í Pending vegna þess að geymsluflokkurinn (storage class) er ekki til. cert-manager vantar, en í því tilviki frýs uppsetningin alls ekki: hún mistekst á nokkrum sekúndum vegna þess að útgefendur skilríkja í kortinu þurfa tilföng frá cert-manager.
Byrjaðu á poddunum og króksverkunum (hook Jobs):
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.iodescribe sýnir villur við að sækja myndir og ótengdar gagnageymslur í atburðum sínum. Króksverk (hook Job) sem sýnir 0/1 verklok með misheppnuðum pod hefur stöðvað uppsetninguna, vegna þess að króksverk hafa endurtekningarmörk (backoff limit) upp á 0 og eru aldrei endurtekin án tilkynningar. Annálaskrá þess sýnir ástæðuna.
Svona er hver orsök lagfærð:
- Ef Helm bíður með
--wait, stöðvaðu það, fjarlægðu uppsetninguna og settu upp aftur án flaggsins. Bíddu síðan eftir þjónustunum:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Fyrir villur við að sækja myndir skaltu athuga
global.imageRegistryog, fyrir Enterprise, sóknartókann á síðunni Sóknartókar og uppsetningarskipanir (Pull tokens and install commands) á reikningnum þínum. - Fyrir
Pendinggagnageymslur skaltu stillastorage.classNameá geymsluflokk sem klasinn hefur, eða gera einn þeirra sjálfgefinn. - Ef cert-manager vantar skaltu setja upp cert-manager v1.21.3 og keyra uppsetninguna aftur.
- Fyrir misheppnaðan krók skaltu laga það sem atburðaskráin nefnir og keyra uppsetninguna aftur.
Pod bíður eftir skema sínu
Poddur þjónustu situr í Init:0/1 í nokkrar mínútur. Hver þjónusta sem notar gagnagrunninn er með frumstillingargám (init container), wait-for-schema, sem heldur poddinum þar til útgáfubókin (release ledger) sýnir að færslum (migrations) hans hafi verið beitt fyrir mynd þessarar útgáfu. Það er eðlilegt fyrstu mínúturnar í uppsetningu eða uppfærslu á meðan færslukrókarnir keyra. Það er vandamál þegar því lýkur ekki.
Lestu atburðaskrá frumstillingargámsins:
kubectl -n nexus logs <pod-name> -c wait-for-schemaAtburðaskráin nefnir eininguna, færslukeðjurnar sem hún bíður eftir og tímamörk hennar, og prentar síðan línu í hvert skipti sem staða hennar breytist:
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
| Framvindulína segir | Hvað það þýðir |
|---|---|
| Hvaða keðjum á enn eftir að beita fyrir þessa útgáfu | Tilgreindir færslukrókar hafa ekki lokið keyrslu. Skoðaðu þau verk (Jobs). |
| Að ekki sé hægt að lesa útgáfubókina, ásamt villu gagnagrunnsins | Postgres svarar ekki, eða bókin er ekki til vegna þess að ræsing gagnagrunnsins (database bootstrap) hefur ekki keyrt. |
FAILED (<component>): after <n>s, … |
Hann gafst upp eftir schemaWait.timeoutSeconds (sjálfgefið 1.800). Frumstillingargámurinn endurræsir sig; þjónustan sjálf fór aldrei í gang. |
Keðja sem virkjast aldrei þýðir næstum alltaf að færsluverkið (migration Job) hennar mistókst. Finndu það með kubectl -n nexus get jobs og lestu atburðaskrá þess. Lagaðu það sem hún nefnir (fullur diskur, ytri gagnagrunnur sem færsluforritið nær ekki til, árekstur hlutverka) og keyrðu helm upgrade með sömu gildum: krókarnir keyra aftur og óhætt er að endurkeyra hvern og einn.
Hækkaðu schemaWait.timeoutSeconds aðeins þegar færsla er hæg og eðlileg, eins og stór fyrsta færsla á hægri geymslu getur verið. Að hækka gildið til að fela misheppnað verk lætur poddinn bara bíða lengur eftir einhverju sem kemur aldrei.
Lyklageymslan er innsigluð
Eftir rafmagnsleysi, endurræsingu hnúts eða endurræsingu gámakeyrsluumhverfis koma poddar til baka og stjórnborðið hleðst inn, en allt sem þarf lykil bilar eða bíður. Afþéttirinn (unsealer) ræsist innsiglaður eftir hverja endurræsingu á hnúti sínum og lyklageymslan getur ekki opnað innsigli sitt fyrr en afþéttirinn er opinn.
Spyrðu OpenBao í hverjum podd:
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 $?"Lokakóði 0 er óinnsiglaður, 2 er innsiglaður og 1 þýðir að hann gat ekki svarað (spyrðu aftur eftir mínútu). Keyrðu það sama á openbao-0 með -tls-server-name=openbao fyrir lyklageymsluna. Ef afþéttirinn er óinnsiglaður en lyklageymslan ekki, er lyklageymslan að opna innsigli sitt; gefðu henni mínútu.
Til að laga innsiglaðan afþétti keyrir einn vörsluaðili (custodian) unseal.sh kortsins með sínu eigin age-auðkenni. Kafli 2.15, Dagur tvö: rekstur Nexus, geymir alla skipunina. Lokakóði skriftunnar segir þér hvað gerðist:
| Útgöngukóði | Merking | Hvað skal gera |
|---|---|---|
| 0 | Óinnsiglað | Athugaðu kubectl -n nexus get deploy,statefulset innan mínútu. |
| 1 | Enn innsiglað, eða afinnsiglunarkall mistókst | Lestu hlutalínurnar (share lines) sem hún prentaði; keyrðu hana aftur. |
| 2 | Forsendu vantar | Skilaboðin nefna hana: AGE_IDENTITY, keyrsluskrá eins og age eða jq, eða stillingu fyrir beinan ham (direct-mode). |
| 3 | Þetta auðkenni getur ekki afkóðað hlutana | Þú ert ekki vörsluaðili þessarar uppsetningar. Ekkert var sent inn. Finndu vörsluaðila sem er það. |
Þú getur ekki skráð þig inn yfir HTTP
Stjórnborðið hleðst inn á http:// vistfangi, eða í gegnum kubectl port-forward á 127.0.0.1, og innskráning mistekst. Beiðnin um aðgangslykil (passkey) birtist aldrei, eða innskráningin fer í hring aftur á byrjunarreit.
Innskráning krefst eigin HTTPS-uppruna stjórnborðsins. Stjórnborðið samþykkir innskráningu aðeins frá https://<hosts.console>, geymir lotuna í __Host- vafraköku sem er merkt Secure (sem vafri geymir aðeins yfir HTTPS), og aðgangslykill fyrsta kerfisstjórans krefst síðu með gildu skilríki. Vafrar hafna aðgangslyklum á bak við skilríkisvillu. Gáttaráframsending (port-forward) á http://127.0.0.1 getur aldrei skráð inn.
Athugaðu hvað vafrinn náði í raun sambandi við:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressSú fyrri ætti að svara yfir HTTPS með skilríki sem vélin þín treystir. Sú síðari ætti að sýna hýslana þrjá með nöfnunum sem þú stilltir í hosts.*.
Til að laga þetta skaltu opna stjórnborðið á https://console.harrow.example, nákvæmlega nafninu í hosts.console, með skilríki sem vafrinn treystir. Með tls.mode: existing skaltu athuga hvort tls.existingSecret geymi skilríki fyrir alla þrjá hýslana. Með tls.mode: cert-manager skaltu athuga hvort ClusterIssuer hafi gefið það út. Með tls.mode: none endar Transport Layer Security (TLS) á þínum eigin álagsdreifara (load balancer), og þar þarf skilríkið að vera rétt. Fyrir einkarekna vottunarstöð (private CA) skaltu setja skilríki hennar upp á vélunum sem kerfisstjórarnir þínir skrá sig inn frá.
Tilkallskóðinn er útrunninn
Á síðunni Gera tilkall til þessarar uppsetningar (Claim this installation) hafnar síðan kóðanum með CLAIM_CODE_EXPIRED (410). Tilkallskóði er þrír hópar af fjórum stöfum. Hann virkar einu sinni, í 30 mínútur, með 5 tilraunum. Eftir það, eða eftir fimmtu röngu tilraunina, er hann ónýtur og ekkert var tekið yfir eða breytt.
Búðu til nýjan kóða í skipanalínunni sem hefur aðgang að klasanum:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleHún prentar nýjan kóða og fingrafar uppsetningarinnar. Sláðu kóðann inn á tilkallssíðunni innan 30 mínútna og berðu fingrafarið saman aftur.
Tvö tengd svör:
RATE_LIMITED(429) á tilkallssíðunni þýðir að gerðar hafa verið nokkrar tilraunir á síðunni á síðustu mínútu. Bíddu í þann sekúndufjölda sem hún gefur upp. Ef þú gerðir ekki þessar tilraunir er einhver annar á netinu þínu að reyna við síðuna; komdust að því hver það er áður en þú gerir tilkall.TRANSITION_NOT_PERMITTED(409) þýðir að þegar hefur verið gert tilkall til uppsetningarinnar og tilkallssíða hennar er óvirk fyrir fullt og allt. Skráðu þig inn í staðinn. Ef þú gerðir ekki tilkall til hennar skaltu meðhöndla það sem öryggisatvik.
Fingrafarið passar ekki
Tilkallssíðan sýnir CLAIM_FINGERPRINT_MISMATCH (403), eða þú sérð sjálf(ur) að átta hóparnir af fjórum stöfum á síðunni eru ólíkir þeim sem skipanalínan þín prentaði. Jafnvel þótt bara einn hópur sé ólíkur þýðir það að vafrinn er að tala við aðra uppsetningu.
Stansaðu. Ekki slá kóðann inn á þessa síðu. Eitthvað annað en uppsetningin þín gæti verið að svara á þessu vistfangi, hugsanlega vél sem var sett upp til að veiða fyrsta kerfisstjórann. Ef þú gerðir tilkall til hennar myndi sú vél halda utan um fyrirtækið þitt. Þín eigin uppsetning er óbreytt og enn án tilkalls.
Athugaðu hvert nafnið vísar og hvaða skilríki svaraði:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleVistfangið ætti að vera hjá inngangsstýringunni (ingress controller) þinni og skilríkið ætti að vera það sem þú settir upp fyrir hosts.console.
Til að laga þetta skaltu láta öryggisteymið þitt fá vistfangið sem svaraði og halda eftir uppsetningarskránni (install log), sem skráir fingrafarið sem uppsetningin prentaði. Leiðréttu færsluna í nafnaþjónustunni (Domain Name System, DNS) eða milliþjóninn (proxy) sem sendi þig annað. Búðu síðan til nýjan tilkallskóða með nexusctl claim-code --administrator <email> og gerðu tilkall úr vafra á neti sem þú treystir, og berðu alla átta hópana saman aftur.
Leyfinu er hafnað
Innflutningurinn á Flytja inn leyfið (Import the licence), Flytja inn nýtt leyfi (Import a new licence) eða nexusctl licence import svarar með synjun. Synjaður innflutningur breytir engu: leyfið sem er í gildi helst í gildi og klukkugólfið (clock floor) hreyfist ekki.
Lestu kóðann og skrefið:
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.jsonMeginmál synjunarinnar inniheldur code, message, refused_at (skrefið sem mistókst) og troubleshooting. Til að sjá stöðu leyfisins sem er í gildi skaltu lesa GET https://auth.harrow.example/api/v1/installation/licence/state með sama tóka.
| Kóði | HTTP | Algeng orsök | Lausn |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Skránni var breytt, hún endursniðin eða endurvistuð, eða eina undirskrift vantar | Sæktu hana aftur af reikningnum þínum og flyttu hana inn óbreytta |
LICENCE_FORMAT_INVALID |
422 | Ekki leyfi: röng skrá, afhöggvin eða vafin inn í annan hlut | Sendu skrána nákvæmlega eins og Adverant afhenti hana |
LICENCE_ROOT_UNKNOWN |
422 | Undirritað með lykli sem þessi útgáfa inniheldur ekki | Uppfærðu, eða biddu um leyfi sem er undirritað fyrir þína útgáfu |
LICENCE_MATRIX_MISMATCH |
422 | Skrifað fyrir nýrra útgáfufylki (edition matrix), eða veitir hóp sem þessi smíð (build) þekkir ekki | Uppfærðu, eða biddu um leyfi sem er skrifað fyrir þína útgáfu |
LICENCE_OTHER_INSTALLATION |
409 | Gefið út fyrir aðra uppsetningu, oft leyfi prófunarklasans sett á raunumhverfi | Biddu um leyfi fyrir auðkenni þessarar uppsetningar |
LICENCE_REVOKED |
403 | Adverant afturkallaði það | Biddu Adverant um nýtt leyfi |
LICENCE_LOCKED |
403 | starts_on þess er eftir núverandi dagsetningu |
Flyttu það inn á eða eftir fyrsta gildisdegi þess |
TRANSITION_NOT_PERMITTED |
409 | Þetta leyfisauðkenni var þegar flutt inn | Ekkert þarf að gera ef það er í gildi; spurðu Adverant ef skilmálarnir þurfa að breytast |
RECORD_NOT_FOUND |
404 | Uppsetningin hefur ekki verið lýst yfir (declared), þannig að hún hefur ekkert auðkenni ennþá | Ljúktu við skref fyrsta kerfisstjórans og flyttu síðan inn |
TENANT_NOT_A_PARAMETER |
403 | Meginmálið nefnir fyrirtæki á efsta stigi sínu | Sendu leyfisskrána eina og sér sem meginmál |
Tvennt lítur út eins og leyfisvandamál en er það ekki. Stöðulestur sem inniheldur LICENCE_CLOCK_BEHIND_FLOOR þýðir að klukka hnútsins sýnir tíma sem er á eftir nýjasta tímanum sem uppsetningin hefur séð; lagaðu tíma hnútsins, og ef klukkan hafði hlaupið á undan og tekið gólfið með sér skaltu biðja Adverant um tóka til að endurstilla tímann (time-reset token). Og leyfi sem flyst inn en sýnir samt hóp sem kynningu (teaser) veitir venjulega ekki þann hóp: lestu heimildirnar á leyfissíðunni áður en nokkuð annað er gert.
Engin svör frá gervigreind
Gervigreindaraðstoðarmaðurinn (artificial intelligence, AI) sýnir MODEL_NOT_CONNECTED (503), verkferlisskref bilar með NO_PROVIDER_FOR_ROLE (422), eða svör hætta einfaldlega að berast.
Lyklasafn fyrirtækisins hefur engan lykil sem getur svarað, eða beinirinn (router) nær ekki sambandi við veituna. Hvert fyrirtæki kemur með sinn eigin líkanalykil. Þegar enginn lykill er í notkun er engin gervigreind til staðar, samkvæmt hönnun, og enginn samnýttur lykill hleypur í skarðið.
Athugaðu lyklasafnið og val beinisins, hvort tveggja með eigin aðgangstóka viðkomandi notanda:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
Sú fyrri telur upp hverja veitu, hvort hún geti svarað og hvers vegna ekki („Enginn lykill í notkun: 1 afturkallaður, 1 útrunninn“), og stöðu hvers lykils. Sú síðari svarar með líkaninu sem beinirinn myndi nota fyrir fyrirtækið, eða synjun hans í orðum. Athugaðu síðan leiðina út úr klasanum með þessum tveimur skipunum:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayHvað hver niðurstaða þýðir:
| Þú finnur | Lausn |
|---|---|
| Enginn lykill í safninu | Eigandi eða kerfisstjóri bætir við fyrirtækislykli á skiptiborði gervigreindar (AI switchboard) eða undir Stillingar, Gervigreindarlíkön (Settings, AI models) |
Lyklar invalid, expired eða exhausted |
Bættu við nýjum lykli; sá gamli helst á skrá sem saga |
Lyklar resting |
Bíddu: lykill sem bilar hvílir í 60 sekúndur, og eftir 5 bilanir í röð er slökkt á honum (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE með lykla í notkun |
Hlutverkið hefur enga úthlutun og ekkert passar; stilltu hlutverkið í beinistefnunni (routing policy) |
MODEL_CAPABILITY_UNAVAILABLE (422) |
Beiðnin krefst getu, eða staðsetningar gagna (residency), sem engin veita í safninu býður upp á; virkjaðu veitu sem gerir það |
Engin nexus-operator-egress stefna, eða vistfangabil veitunnar vantar í hana |
Bættu bilunum, skrifuðum með Classless Inter-Domain Routing (CIDR) rithætti, við networkPolicy.externalEgressCIDRs og uppfærðu |
| Staðbundinn líkanaþjónn sem svarar ekki | Athugaðu ai.localProvider.baseUrl, skráðu þjóninn í ai.installationHosts og leyfðu vistfangabil hans í networkPolicy.externalEgressCIDRs |
Lykill að hýstri veitu sem virkar úr fartölvu en bilar á uppsetningunni er næstum alltaf netstefnan (network policy). Nafnarýmið hafnar útleiðum (egress) sjálfgefið.
429-svör
Biðlara er svarað með 429 Too Many Requests. Nexus hefur fjóra staði sem geta sagt þetta og meginmálið segir þér hvaða staður það er.
| Hvar | Kóði og nánari upplýsingar | Hverju á að breyta |
|---|---|---|
| nexus-auth, á hvern innskráðan einstakling | RATE_LIMITED með limit, windowSeconds og retryAfterSeconds |
auth.rateLimitPerMinute (sjálfgefið 5000), fyrir mikla sjálfvirkni |
| Takmörk á skriftulykil, forrit eða einingu (Enterprise) | RATE_LIMITED sem nefnir lykilinn og takmörk hans |
Takmörkin undir Stillingar, Tíðnitakmörk (Settings, Rate limits), ásamt ástæðu |
| Tilkallssíðan við fyrstu keyrslu | RATE_LIMITED með retry_after_seconds |
Ekkert: bíddu og komdust að því hver annar er að reyna við síðuna |
| Líkanaveita | Beinirinn meðhöndlar þetta sem tímabundna bilun og færir sig yfir á næstu veitu | Bættu við öðrum lykli eða veitu ef þetta gerist oft |
Hvert svar inniheldur Retry-After haus. Biðlari sem hagar sér rétt bíður svo lengi og reynir ekki aftur fyrr.
Ef allir notendur virðast deila einum takmörkum í einu skaltu athuga proxy.trustedCIDRs. Þegar það nær ekki yfir poddanet inngangsstýringarinnar þinnar getur nexus-auth ekki treyst X-Forwarded-For hausnum og lítur á allar beiðnir sem svo að þær komi frá stýringunni. Sjálfgefna gildið, 10.42.0.0/16, passar aðeins fyrir k3s.
kubectl get pods -A -o wideFinndu vistfang podds inngangsstýringarinnar í úttakinu og gakktu úr skugga um að proxy.trustedCIDRs nái yfir það.
Uppfærsluvillur
Uppfærslan gekk til baka. Uppfærslusíðan (Upgrade page) sýnir UPGRADE_ROLLED_BACK: skref mistókst, hver vél er komin aftur á fyrri útgáfu og gögnum var ekki breytt. Síðan nefnir skrefið. Algengt dæmi er gagnageymsla sem er of lítil fyrir nýtt skipulag geymslu. Lagaðu það sem hún nefnir, keyrðu nexusctl upgrade plan --bundle <file> aftur og virkjaðu síðan. Afritið er tekið aftur fyrst.
Kortið neitar að teikna (render) með EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Leyndarmálið (Secret) nexus-generated geymir EXTERNAL_KEY_ENCRYPTION_KEY á sniði sem kortið getur ekki notað. Það verður að vera base64 af 32 bætum, eða hrái 32 bæta lykillinn úr eldri uppsetningu. Einhver breytti eða skipti út leyndarmálinu. Settu aftur inn lykilinn sem gögn þessarar uppsetningar eru innsigluð undir, sem base64 af 32 bætum hans (printf %s "$OLD" | base64), og uppfærðu aftur. Ekki láta kortið búa til nýjan: gögn sem eru innsigluð undir gamla lyklinum yrðu áfram ólæsileg.
Skriftum er hafnað með TOKEN_ORG_MISSING eftir uppfærsluna. Hver þjónusta sem athugar forritaskilalykla (application programming interface, API) í gegnum nexus-auth hafnar nú lykli sem hefur ekkert fyrirtæki, með 403 TOKEN_ORG_MISSING. Gefðu hverjum slíkum lykli fyrirtæki, eða gefðu út nýjan lykil.
Lyklar tilkynna rangt forrit í klukkustund. Hreinsaðu skyndiminni lyklafærslna í skyndiminni nexus-auth, Valkey-geymslu uppsetningarinnar. Kafli 2.15, Dagur tvö: rekstur Nexus, geymir skipunina, bæði fyrir geymslu innan klasans og ytri geymslu.
Færslukrókur (migration hook) mistókst. helm upgrade tilkynnir um misheppnaðan krók fyrir uppfærslu (pre-upgrade hook). Skemað færist áður en nýju poddarnir rúlla inn, þannig að útgáfan sem er í gangi þjónustar enn. Lestu atburðaskrá verksins með kubectl -n nexus logs job/<job-name>, lagaðu það sem hún nefnir og keyrðu uppfærsluna aftur.
Þjónustur gátu ekki notað töflurnar sínar í nokkrar sekúndur. Við fyrstu uppfærslu á uppsetningu sem gerð var úr eldra korti missir hver þjónusta sín gömlu sjálfgefnu töflurétindi og fær sín eigin til baka úr sinni eigin færslu. Bilið varir í nokkrar sekúndur. Uppfærðu á rólegum tíma, eða skalaðu þjónusturnar niður í núll fyrst.
Útgáfunni á diski var hafnað. Innflutningur af miðli (Import from media) sýnir MEDIA_SIGNATURE_INVALID (422): skrárnar eru ekki undirritaðar með útgáfulyklinum sem settur er upp á þessari uppsetningu. Ekkert var hlaðið inn og útgáfan sem er í gangi heldur áfram að keyra. Geymdu miðilinn fyrir öryggisteymið þitt og biddu Adverant um nýjan miðil í gegnum ótengdu skiptin (offline exchange).
Höfnun við teikningu korts
helm install, helm upgrade eða helm template stöðvast áður en nokkru er beitt, með skilaboðum sem byrja á kóða eða nefna gildi. Kortið hafnar gildum sem það getur ekki keyrt á öruggan hátt. Ekkert breyttist á klasanum.
Teiknaðu (render) kortið eitt og sér til að sjá hverja synjun án þess að snerta klasann. Notaðu Enterprise-kortið sem þú sóttir í stað oci:// vistfangsins á Enterprise, og stilltu networkPolicy.apiServerCIDRs í gildunum, vegna þess að ótengd teikning getur ekki lesið það úr klasanum:
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.yamlForathugun (Preflight) athugar sömu auðkennisgildi í hlutanum „tími og lyklar“ og tilkynnir sömu kóða. Lokakóði hennar er 0 þegar uppsetningin getur haldið áfram (viðvaranir stöðva ekki), 1 þegar að minnsta kosti ein athugun mistókst og 2 þegar hún gat ekki keyrt.
| Höfnun | Orsök | Lausn |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName er tómt |
Stilltu það á eigið nafn þessarar uppsetningar, í samræmi við ^[a-z][a-z0-9-]{0,62}$. Það er varanlegt um leið og lyklageymslan ræsist í fyrsta sinn |
INSTALLATION_NAME_EXAMPLE |
Nafnið er það sama og í dæmagildisskrám kortsins | Stilltu þitt eigið nafn |
keys.installationName "…" does not match … |
Hástafir, undirstrik eða tölustafur fremst | Notaðu lágstafi, tölustafi og bandstrik, og byrjaðu á bókstaf |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients er tómt |
Skráðu age-viðtakendur vörsluaðila þinna, opinberu helmingana |
KEYS_CUSTODIAN_EXAMPLE |
Viðtakandi er dæmavörsluaðilinn úr gildisskrám kortsins, en enginn hefur auðkenni hans undir höndum | Skiptu honum út fyrir viðtakendur þinna eigin vörsluaðila |
keys.custody.recipients: … |
Viðtakandi á sniði sem vörsluverkið (custody Job) getur ekki dulkóðað fyrir | Notaðu age1…, age1tag1…, age1tagpq1…, age1pq1… eða age1se1…, í lágstöfum |
NEXUS_EDITION_INVALID |
edition er hvorki community né enterprise |
Stilltu annað hvort þeirra |
edition=… but enterprise.enabled=… |
Þetta tvennt stangast á | Stilltu enterprise.enabled: true nákvæmlega þegar edition er enterprise |
global.imageRegistry is required |
Engin myndaskrá (registry) nefnd | Stilltu myndaskrána sem hnútarnir þínir sækja myndirnar úr |
hosts.<name> is required |
Opinberan hýsil vantar | Stilltu hosts.console, hosts.api og hosts.auth |
tls.existingSecret is required when tls.mode is existing |
Ekkert skilríkjaleyndarmál (certificate Secret) nefnt | Nefndu leyndarmálið, eða veldu annað tls.mode |
tls.clusterIssuer is required when tls.mode is cert-manager |
Enginn útgefandi nefndur | Nefndu þinn ClusterIssuer |
dataTier.<store>.external.host is required when mode is external |
Ytri geymsla án vistfangs | Gefðu upp hýsil hennar og leyndarmál hennar í existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
helm template hefur engan klasa til að fletta þeim upp í |
Gefðu upp vistföng API-þjónsins sem /32 bil |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
Framleiddi lykillinn í nexus-generated hefur ranga lögun |
Sjá „Uppfærsluvillur“ hér að ofan |
Gildisskrá sem notar lykil sem kortið hefur ekki, eða gildi af rangri gerð, er hafnað af skema kortsins á undan öllum þessum. telemetry.enabled: true er eitt dæmi: skemað samþykkir aðeins false.
Senda þjónustupakka
Þegar ekkert af þessu lagar vandann skaltu senda Adverant þjónustupakka (support bundle) með þjónustubeiðninni þinni.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number> er númer beiðninnar sem þú opnaðir á síðunni Þjónusta og þjónustupakkar (Support and support bundles) á reikningnum þínum. Þú getur búið til sama pakka á síðunni Þjónustupakki (Support bundle) á stjórnborðinu undir Þessi uppsetning (This installation).
Pakkinn geymir atburðaskrár véla frá síðustu 24 klukkustundum, upplýsingar um heilbrigði og útgáfur, stillingar án leyndarmála sinna og skýrslur úr forathugun og uppsetningu. Áður en hann er skrifaður skiptir hreinsun (redaction) út nöfnum, leyndarmálum og vistföngum, og þú lest forskoðun á nákvæmlega því sem fer út. Skilaboðum fólks, skrám og minni er aldrei safnað.
Hladdu honum upp á beiðnina á reikningnum þínum, eða vistaðu hann á miðil og fluttu hann út ef uppsetningin hefur enga tengingu út á við. Aðeins þjónustuverkfræðingarnir sem nefndir eru á beiðninni geta opnað hann og honum er eytt eftir 30 daga. Segðu í beiðninni hvaða vandamál hér að ofan þú varst að skoða og hvað athuganirnar í þessum kafla sýndu: það sparar fram og til baka samskipti.


