InnskráningBóka kynningu

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

22 mínútna lestur

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:

  1. Lestu kóðann á undan skilaboðunum. Hver synjun í Nexus endar á vélrænum kóða og kaflinn er flokkaður eftir þeim kóða.
  2. Keyrðu nexusctl preflight aftur 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ð.
  3. Notaðu --explain með hvaða nexusctl-sögn sem þú ert óviss um. Það prentar kubectl- og helm-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.

Lóðrétt röð af kössum tengdum með örvum sem vísa niður: „Tilföng útgáfu búin til (Deployments ræsast, hvert haldið af sínum wait-for-schema frumstillingargámi)“, síðan „Ræsikrókur gagnagrunns: gagnagrunnur, hlutverk, útgáfubók“, síðan „Færslukrókar, einn á hverja þjónustu, í fastri röð“, síðan „Hver krókur skrifar sína röð í útgáfubókina“. Úr síðasta kassanum kvíslast örvar til hliðar í þrjá litla kassa: „nexus-auth ræsist“, „nexus-gateway ræsist“, „aðrar þjónustur ræsast“. Hliðarathugasemd við hliðina á efsta kassanum, með yfirstrikaðri ör niður á botn: „helm install --wait bíður hér eftir Deployments sem eru að bíða eftir krókunum“.
Hvað keyrir, í réttri röð, þegar kortið (chart) er sett upp eða uppfært.

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.io

describe 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.imageRegistry og, fyrir Enterprise, sóknartókann á síðunni Sóknartókar og uppsetningarskipanir (Pull tokens and install commands) á reikningnum þínum.
  • Fyrir Pending gagnageymslur skaltu stilla storage.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-schema

Atburð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 ingress

Sú 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.example

Hú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.

Virkja þessa uppsetningu
Virkja þessa uppsetningu
Gera tilkall til þessarar uppsetningar. Kóðinn úr skipanalínunni fer inn í þremur hópum og síðan sýnir allt fingrafarið í fjögurra stafa hópum til samanburðar; útrunnum kóða er hafnað með CLAIM_CODE_EXPIRED og ekkert er tekið yfir.

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.example

Vistfangið ætti að vera hjá inngangsstýringunni (ingress controller) þinni og skilríkið ætti að vera það sem þú settir upp fyrir hosts.console.

Fingrafar stemmir ekki
Fingrafar stemmir ekki
Fingraförin eru ólík í þremur af átta hópum. Síðan segir þér að stansa, útskýrir hver gæti verið að svara og telur upp hvað skuli athuga áður en reynt er aftur.

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.json

Meginmá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-gateway

Hvað 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 wide

Finndu 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.yaml

Forathugun (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.

Undirbúningsathugun getur ekki haldið áfram
Undirbúningsathugun getur ekki haldið áfram
Forathugun getur ekki haldið áfram. Athuganirnar sem mistókust koma fyrst, hver með sinni lausn, og uppsetningin helst stöðvuð með PREFLIGHT_FAILED þar til þær standast.
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.