Logg innBestill en gjennomgang

Kapittel 2.17

Feilsøking

Problemene operatører oftest møter, organisert etter hva du ser. Hvert tilfelle oppgir årsaken, kommandoen som bekrefter den og løsningen, og kapittelet avsluttes med å sende en støttepakke.

Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

22 minutter å lese

Det meste som går galt på en Nexus-installasjon, går galt på de samme tolv måtene, og nesten alle sammen melder fra med en kode. Dette kapittelet er organisert etter det du ser, i omtrent den rekkefølgen du vil støte på hvert problem: installering, overtakelse, lisensiering og deretter kjøring. For hvert av dem får du årsaken, en kommando som bekrefter den, og løsningen.

Eksemplene bruker installasjonen til Harrow Port Authority: navnerom nexus, utgivelse nexus, verter console.harrow.example, api.harrow.example og auth.harrow.example. Bytt dem ut med dine egne. Tre vaner sparer tid ved hvert problem her:

  1. Les koden før meldingen. Hver avvisning i Nexus slutter med en maskinkode, og det er denne koden dette kapittelet er indeksert etter.
  2. Kjør nexusctl preflight på nytt etter enhver endring i klyngen eller verdifilen. Den leser klyngen uten å endre den, og den rapporterer de fleste chart-avvisninger ved navn før Helm gjør det.
  3. Bruk --explain på ethvert nexusctl-verb du er usikker på. Det skriver ut kubectl- og helm-operasjonene uten å kjøre dem.

Installasjonen henger

Du kjørte installasjonen, og den er ikke ferdig. helm har ikke returnert etter femten minutter, eller den returnerte og podene er fortsatt i Init eller Pending, eller konsolladressen svarer ikke.

Den vanligste årsaken er helm install --wait. Nexus oppretter databasen sin, rollene sine og hver tjenestes skjema i post-install-hooks, og det er bootstrap-hooken som gir hver tjeneste sitt databasepassord. Med --wait venter Helm på at Deployments skal bli klare før den kjører disse hookene, mens Deployments venter på hookene. Ingen av dem kommer videre. Installer aldri med --wait; installer uten det og vent etterpå.

En vertikal sekvens av bokser forbundet med nedoverpekende piler: «Utgivelsesressurser opprettet (Deployments starter, hver holdt igjen av sin wait-for-schema init-kontainer)», deretter «Database-bootstrap-hook: database, roller, utgivelsesprotokoll», deretter «Migrerings-hooks, én per tjeneste, i en fast rekkefølge», deretter «Hver hook skriver sin rad i utgivelsesprotokollen». Fra den siste boksen brer piler seg ut til siden til tre små bokser: «nexus-auth starter», «nexus-gateway starter», «andre tjenester starter». En sidenotat ved siden av den øverste boksen, med en overstrøket pil til bunnen: «helm install --wait venter her på Deployments som venter på hooks».
Hva som kjører, i rekkefølge, når chartet installeres eller oppgraderes.

De andre årsakene er vanlige Kubernetes-årsaker. Bilder kan ikke hentes fordi global.imageRegistry oppgir feil register, eller fordi en Enterprise-installasjon mangler pull-token. Et volum blir stående i Pending fordi lagringsklassen ikke finnes. cert-manager mangler, og i så fall henger ikke installasjonen i det hele tatt: den feiler i løpet av sekunder, fordi chartets sertifikatutstedere trenger ressursene til cert-manager.

Start med podene og hook-Job-ene:

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 viser feil ved bildehenting og ubundne volumer i hendelsene sine. En hook-Job som viser 0/1 fullføringer med en feilet pod, har stoppet installasjonen, fordi hook-Job-er har en backoff-grense på 0 og aldri prøves på nytt i det stille. Loggen dens forteller hvorfor.

Slik løser du hver årsak:

  • Hvis Helm venter med --wait, stopper du den, avinstallerer og installerer på nytt uten flagget. Vent deretter på tjenestene:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Ved feil under henting sjekker du global.imageRegistry og, for Enterprise, pull-tokenet fra kontoens side «Pull tokens and install commands».
  • For Pending-volumer setter du storage.className til en lagringsklasse som klyngen har, eller gjør en til standard.
  • Hvis cert-manager mangler, installerer du cert-manager v1.21.3 og kjører installasjonen på nytt.
  • Ved en feilet hook retter du det loggen oppgir, og kjører installasjonen på nytt.

En pod venter på skjemaet sitt

Poden til en tjeneste blir stående i Init:0/1 i flere minutter. Hver tjeneste som bruker databasen, har en init-container, wait-for-schema, som holder igjen poden til utgivelsesprotokollen viser at migreringene er lagt inn for bildet til denne utgivelsen. Det er normalt de første minuttene av en installasjon eller oppgradering, mens migrerings-hookene kjører. Det er et problem når det ikke tar slutt.

Les loggen til init-containeren:

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

Loggen oppgir komponenten, migreringskjedene den venter på, og tidsgrensen dens, og skriver deretter ut en linje hver gang tilstanden endrer seg:

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
Fremdriftslinjen sier Hva det betyr
Hvilke kjeder som ennå ikke er lagt inn for denne utgivelsen De navngitte migrerings-hookene er ikke ferdige. Se på disse Job-ene.
At utgivelsesprotokollen ikke kan leses, med databasens feilmelding Postgres svarer ikke, eller protokollen finnes ikke fordi database-bootstrap ikke har kjørt.
FAILED (<component>): after <n>s, … Den ga opp etter schemaWait.timeoutSeconds (1800 som standard). Init-containeren starter på nytt; selve tjenesten startet aldri.

En kjede som aldri blir lagt inn, betyr nesten alltid at migrerings-Job-en dens feilet. Finn den med kubectl -n nexus get jobs og les loggen dens. Rett det den oppgir (en full disk, en ekstern database migratoren ikke når, en rollekonflikt) og kjør helm upgrade med de samme verdiene: hookene kjører på nytt, og hver av dem er trygg å kjøre flere ganger.

Øk schemaWait.timeoutSeconds bare når en migrering er treg og frisk, slik en stor første migrering på treg lagring kan være. Å øke den for å skjule en feilet Job gjør bare at poden venter lenger på noe som aldri kommer.

Nøkkellageret er forseglet

Etter et strømbrudd, en omstart av en node eller en omstart av container-kjøremiljøet kommer podene tilbake og konsollen lastes inn, mens alt som trenger en nøkkel, feiler eller venter. Opplåseren starter forseglet etter hver omstart av noden sin, og nøkkellageret kan ikke låse opp seg selv før opplåseren er åpen.

Spør OpenBao i hver pod:

kubectl -n nexus exec openbao-unsealer-0 -c openbao -- \
  bao status -format=json -address=https://127.0.0.1:8200 \
  -ca-cert=/openbao/tls/ca.crt -tls-server-name=openbao-unsealer
echo "exit $?"

Returkode 0 er ulåst, 2 er forseglet, og 1 betyr at den ikke kunne svare (spør igjen om et minutt). Kjør det samme mot openbao-0 med -tls-server-name=openbao for nøkkellageret. Hvis opplåseren er ulåst og nøkkellageret ikke er det, er nøkkellageret i ferd med å låse opp seg selv; gi det et minutt.

For å fikse en forseglet opplåser kjører én nøkkelforvalter chartets unseal.sh med sin egen age-identitet. Kapittel 2.15, Dag to: drift av Nexus, har hele kommandoen. Skriptets returkode forteller hva som skjedde:

Avslutningskode Betydning Hva du skal gjøre
0 Ulåst Sjekk kubectl -n nexus get deploy,statefulset innen et minutt.
1 Fortsatt forseglet, eller et åpningskall mislyktes Les del-linjene det skrev ut; kjør det på nytt.
2 En forutsetning mangler Meldingen oppgir den: AGE_IDENTITY, en binærfil som age eller jq, eller en innstilling for direktemodus.
3 Denne identiteten kan ikke dekryptere delene Du er ikke nøkkelforvalter for denne installasjonen. Ingenting ble sendt inn. Finn en nøkkelforvalter som er det.

Du kan ikke logge inn over HTTP

Konsollen lastes inn på en http://-adresse, eller gjennom en kubectl port-forward til 127.0.0.1, og pålogging feiler. Passnøkkel-forespørselen vises aldri, eller påloggingen går i løkke tilbake til starten.

Pålogging krever konsollens eget HTTPS-opphav. Konsollen godtar pålogging kun fra https://<hosts.console>, lagrer økten i en __Host--informasjonskapsel merket Secure (som en nettleser kun lagrer over HTTPS), og den første administratorens passnøkkel krever en side med et gyldig sertifikat. Nettlesere avviser passnøkler bak en sertifikatfeil. En port-forward til http://127.0.0.1 kan aldri logge på.

Sjekk hva nettleseren faktisk nådde:

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

Den første skal svare over HTTPS med et sertifikat maskinen din stoler på. Den andre skal vise de tre vertene med navnene du satte i hosts.*.

For å løse dette må du nå konsollen på https://console.harrow.example, det nøyaktige navnet i hosts.console, med et sertifikat nettleseren stoler på. Med tls.mode: existing sjekker du at tls.existingSecret inneholder et sertifikat for alle tre vertene. Med tls.mode: cert-manager sjekker du at ClusterIssuer har utstedt det. Med tls.mode: none avsluttes Transport Layer Security (TLS) på din egen lastbalanserer, og det er der sertifikatet må være riktig. For en privat sertifikatautoritet installerer du sertifikatet dens på maskinene administratorene logger på fra.

Kravkoden er utløpt

På «Claim this installation» avviser siden koden med CLAIM_CODE_EXPIRED (410). En overtakelseskode består av tre grupper på fire tegn. Den fungerer én gang, i 30 minutter, med 5 forsøk. Etter det, eller etter det femte feilforsøket, er den ubrukelig, og ingenting ble overtatt eller endret.

Lag en ny kode fra terminalen som har klyngetilgang:

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

Den skriver ut en fersk kode og installasjonens fingeravtrykk. Skriv inn koden på overtakelsessiden innen 30 minutter og sammenlign fingeravtrykket på nytt.

Gjør krav på denne installasjonen
Gjør krav på denne installasjonen
«Claim this installation». Koden fra terminalen skrives inn i tre grupper, og siden viser hele fingeravtrykket i grupper på fire for sammenligning; en utløpt kode avvises med CLAIM_CODE_EXPIRED og ingenting overtas.

To relaterte svar:

  • RATE_LIMITED (429) på overtakelsessiden betyr at siden har hatt flere forsøk det siste minuttet. Vent det antallet sekunder den oppgir. Hvis du ikke gjorde disse forsøkene, er det noen andre på nettverket ditt som prøver seg på siden; finn ut hvem før du overtar.
  • TRANSITION_NOT_PERMITTED (409) betyr at installasjonen allerede er overtatt, og at overtakelsessiden er slått av for godt. Logg på i stedet. Hvis det ikke var du som overtok den, må du behandle dette som en sikkerhetshendelse.

Fingeravtrykket stemmer ikke

Overtakelsessiden viser CLAIM_FINGERPRINT_MISMATCH (403), eller du kan selv se at de åtte gruppene på fire på siden avviker fra dem terminalen din skrev ut. Selv én gruppe som avviker, betyr at nettleseren snakker med en annen installasjon.

Stopp. Ikke skriv inn koden på den siden. Noe annet enn installasjonen din kan svare på den adressen, muligens en maskin som er satt opp for å fange opp den første administratoren. Hvis du overtok den, ville den maskinen sitte med organisasjonen din. Din egen installasjon er uendret og fortsatt ikke overtatt.

Sjekk hvor navnet peker og hvilket sertifikat som svarte:

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

Adressen skal være ingress-kontrolleren din sin, og sertifikatet skal være det du installerte for hosts.console.

Fingeravtrykket stemmer ikke
Fingeravtrykket stemmer ikke
Fingeravtrykkene avviker i tre av åtte grupper. Siden ber deg stoppe, forklarer hvem som kan svare, og lister opp hva du må sjekke før du prøver igjen.

For å løse dette gir du sikkerhetsteamet ditt adressen som svarte, og tar vare på installasjonsloggen, som inneholder fingeravtrykket installasjonen skrev ut. Korriger Domain Name System (DNS)-oppføringen eller proxyen som sendte deg et annet sted. Lag deretter en ny overtakelseskode med nexusctl claim-code --administrator <email> og gjennomfør overtakelsen fra en nettleser på et nettverk du stoler på, mens du sammenligner alle åtte gruppene på nytt.

Lisensen blir avvist

Importen på «Import the licence», «Import a new licence» eller nexusctl licence import svarer med en avvisning. En avvist import endrer ingenting: den gjeldende lisensen forblir gjeldende, og klokkegulvet flytter seg ikke.

Les koden og trinnet:

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

Avvisningskroppen inneholder code, message, refused_at (trinnet som feilet) og troubleshooting. For å se tilstanden til den gjeldende lisensen leser du GET https://auth.harrow.example/api/v1/installation/licence/state med det samme tokenet.

Kode HTTP Vanlig årsak Løsning
LICENCE_SIGNATURE_INVALID 422 Filen ble redigert, omformatert eller lagret på nytt, eller én signatur mangler Last den ned på nytt fra kontoen din og importer den urørt
LICENCE_FORMAT_INVALID 422 Ikke en lisens: feil fil, avkortet eller pakket inn i et annet objekt Send filen nøyaktig slik Adverant ga den
LICENCE_ROOT_UNKNOWN 422 Signert med en nøkkel denne utgivelsen ikke har med seg Oppgrader, eller be om en lisens signert for utgivelsen din
LICENCE_MATRIX_MISMATCH 422 Skrevet for en nyere utgavematrise, eller tildeler en gruppe dette bygget ikke kjenner Oppgrader, eller be om en lisens skrevet for utgivelsen din
LICENCE_OTHER_INSTALLATION 409 Utstedt for en annen installasjon, ofte testklyngens lisens brukt i produksjon Be om en lisens for denne installasjonens identitet
LICENCE_REVOKED 403 Adverant trakk den tilbake Be Adverant om en ny lisens
LICENCE_LOCKED 403 Dens starts_on er etter dagens dato Importer den på eller etter dens første dag
TRANSITION_NOT_PERMITTED 409 Denne lisens-ID-en er allerede importert Ingenting å gjøre hvis den er gjeldende; kontakt Adverant hvis vilkårene må endres
RECORD_NOT_FOUND 404 Installasjonen er ikke deklarert, så den har ingen identitet ennå Fullfør trinnet for første administrator, og importer deretter
TENANT_NOT_A_PARAMETER 403 Kroppen oppgir en organisasjon på toppnivået sitt Send lisensfilen alene som kropp

To ting ser ut som lisensproblemer uten å være det. En tilstandsavlesning som inneholder LICENCE_CLOCK_BEHIND_FLOOR, betyr at nodens klokke viser et tidligere tidspunkt enn det siste tidspunktet installasjonen har sett; korriger tiden på noden, og hvis klokken hadde gått for raskt og trukket gulvet med seg, ber du Adverant om et token for tilbakestilling av tid. Og en lisens som lar seg importere, men fortsatt viser en gruppe som en smakebit, tildeler vanligvis ikke den gruppen: les tildelingene på lisenssiden før du gjør noe annet.

Ingen KI-svar

Assistenten for kunstig intelligens (KI) viser MODEL_NOT_CONNECTED (503), et arbeidsflyttrinn feiler med NO_PROVIDER_FOR_ROLE (422), eller svarene bare stopper opp.

Organisasjonens samling har ingen nøkkel som kan svare, eller ruteren når ikke leverandøren. Hver organisasjon tar med sin egen modellnøkkel. Uten en nøkkel i bruk er det ingen KI, slik det er utformet, og ingen delt nøkkel trer inn.

Sjekk samlingen og ruterens valg, hver med personens eget tilgangstoken:

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

Den første lister opp hver leverandør, om den kan svare og hvorfor ikke («No key in use: 1 withdrawn, 1 lapsed»), samt tilstanden for hver nøkkel. Den andre svarer med modellen ruteren ville brukt for organisasjonen, eller avslaget formulert med ord. Sjekk deretter veien ut av klyngen med disse to kommandoene:

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

Hva hvert funn betyr:

Du finner Løsning
Ingen nøkkel i samlingen En eier eller administrator legger til en organisasjonsnøkkel i KI-sentralen eller under Innstillinger, KI-modeller
Nøkler invalid, expired eller exhausted Legg til en ny nøkkel; den gamle blir stående i listen som historikk
Nøkler resting Vent: en feilende nøkkel hviler i 60 sekunder, og etter 5 feil på rad slås den av (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE med nøkler i bruk Rollen har ingen tilordning og ingenting samsvarer; angi rollen i rutingspolicyen
MODEL_CAPABILITY_UNAVAILABLE (422) Forespørselen krever en kapabilitet eller en datalokasjon som ingen leverandør i samlingen tilbyr; aktiver en som gjør det
Ingen nexus-operator-egress-policy, eller leverandørens adresseområder mangler i den Legg til adresseområdene, skrevet i Classless Inter-Domain Routing (CIDR)-notasjon, i networkPolicy.externalEgressCIDRs og oppgrader
En lokal modellserver som ikke svarer Sjekk ai.localProvider.baseUrl, før opp serveren i ai.installationHosts, og tillat adresseområdet dens i networkPolicy.externalEgressCIDRs

En nøkkel til en ekstern leverandør som fungerer fra en bærbar PC og feiler på installasjonen, skyldes nesten alltid nettverkspolicyen. Navnerommet nekter utgående trafikk som standard.

429-svar

En klient får svaret 429 Too Many Requests. Nexus har fire steder som kan gi dette svaret, og meldingskroppen forteller deg hvilket.

Hvor Kode og detaljer Hva som må endres
nexus-auth, per pålogget person RATE_LIMITED med limit, windowSeconds og retryAfterSeconds auth.rateLimitPerMinute (standard 5000), for tung automatisering
En grense for skriptnøkkel, app eller enhet (Enterprise) RATE_LIMITED som navngir nøkkelen og grensen dens Grensen under Innstillinger, Hastighetsgrenser, med en begrunnelse
Kravsiden ved førstegangs kjøring RATE_LIMITED med retry_after_seconds Ingenting: vent, og finn ut hvem andre som prøver siden
En modelleverandør Ruteren behandler det som en forbigående feil og går videre til neste leverandør Legg til en annen nøkkel eller leverandør hvis det skjer ofte

Hver av dem har en Retry-After-header. En veloppdragen klient venter så lenge og prøver ikke på nytt tidligere.

Hvis alle brukere samtidig ser ut til å dele én grense, må du sjekke proxy.trustedCIDRs. Når den ikke dekker pod-nettverket til ingress-kontrolleren din, kan ikke nexus-auth stole på X-Forwarded-For-headeren og ser hver forespørsel som om den kommer fra kontrolleren. Standarden, 10.42.0.0/16, passer kun for k3s.

kubectl get pods -A -o wide

Finn pod-adressen til ingress-kontrolleren i utdataene og sørg for at proxy.trustedCIDRs dekker den.

Oppgraderingsfeil

Oppgraderingen ble rullet tilbake. Oppgraderingssiden viser UPGRADE_ROLLED_BACK: et trinn feilet, hver motor er tilbake på forrige utgivelse, og data ble ikke endret. Siden navngir trinnet. En vanlig årsak er et volum som er for lite for et lagers nye oppsett. Rett opp det den navngir, kjør nexusctl upgrade plan --bundle <file> på nytt, og bruk deretter endringene. Sikkerhetskopien tas på nytt først.

Chartet nekter å generere med EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Secret-objektet nexus-generated inneholder EXTERNAL_KEY_ENCRYPTION_KEY i et format chartet ikke kan bruke. Det må være base64 av 32 byte, eller den rå nøkkelen på 32 byte fra en eldre installasjon. Noen har redigert eller erstattet Secret-objektet. Legg tilbake nøkkelen som denne installasjonens data er forseglet under, som base64 av dens 32 byte (printf %s "$OLD" | base64), og oppgrader på nytt. Ikke la chartet lage en ny: data forseglet under den gamle nøkkelen vil forbli uleselige.

Skript avvises med TOKEN_ORG_MISSING etter oppgraderingen. Hver tjeneste som sjekker nøkler for programmeringsgrensesnitt (API) gjennom nexus-auth, avviser nå en nøkkel uten organisasjon, med 403 TOKEN_ORG_MISSING. Gi hver slik nøkkel en organisasjon, eller utsted en ny nøkkel.

Nøkler rapporterer feil applikasjon i en time. Tøm de hurtiglagrede nøkkeloppføringene i hurtiglageret til nexus-auth, som er installasjonens Valkey-lager. Kapittel 2.15, Dag to: drift av Nexus, har kommandoen for lageret i klyngen og for et eksternt lager.

En migrerings-hook feilet. helm upgrade rapporterer en feilet pre-upgrade-hook. Skjemaet flyttes før de nye podene rulles ut, så den kjørende utgivelsen betjener fortsatt trafikk. Les loggen til Job-objektet med kubectl -n nexus logs job/<job-name>, rett opp det den navngir, og kjør oppgraderingen på nytt.

Tjenester kunne ikke bruke tabellene sine i noen sekunder. Ved første oppgradering av en installasjon laget fra et tidligere chart, mister hver tjeneste sine gamle standard tabellrettigheter og får sine egne tilbake fra sin egen migrering. Oppholdet varer i noen sekunder. Oppgrader i en rolig periode, eller skaler tjenestene til null først.

Utgivelsen på disken ble avvist. Import fra medier viser MEDIA_SIGNATURE_INVALID (422): filene er ikke signert av utgivelsesnøkkelen som er installert på denne installasjonen. Ingenting ble lastet inn, og den kjørende utgivelsen fortsetter å kjøre. Ta vare på mediet for sikkerhetsteamet ditt og be Adverant om nytt medium gjennom den frakoblede utvekslingen.

Avvisning ved gjengivelse av chart

helm install, helm upgrade eller helm template stopper før noe tas i bruk, med en melding som starter med en kode eller navngir en verdi. Chartet avviser verdier det ikke kan kjøre trygt. Ingenting i klyngen ble endret.

Generer chartet alene for å se hvert avslag uten å berøre klyngen. Bruk Enterprise-chartet du lastet ned i stedet for oci://-adressen på Enterprise, og sett networkPolicy.apiServerCIDRs i verdiene, fordi en frakoblet generering ikke kan lese det fra klyngen:

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

Forhåndskontrollen sjekker de samme identitetsverdiene i delen «tid og nøkler» og rapporterer de samme kodene. Avslutningskoden er 0 når installasjonen kan fortsette (advarsler blokkerer ikke), 1 når minst én sjekk feilet, og 2 når den ikke kunne kjøre.

Forhåndssjekk kan ikke fortsette
Forhåndssjekk kan ikke fortsette
Forhåndskontrollen kan ikke fortsette. De feilende sjekkene kommer først, hver med sin løsning, og installasjonen forblir blokkert med PREFLIGHT_FAILED til de er bestått.
Avvisning Årsak Løsning
INSTALLATION_NAME_MISSING keys.installationName er tom Sett den til denne installasjonens eget navn, slik at den samsvarer med ^[a-z][a-z0-9-]{0,62}$. Det er permanent når nøkkellageret først starter
INSTALLATION_NAME_EXAMPLE Navnet er det som står i chartets eksempelverdifiler Angi ditt eget navn
keys.installationName "…" does not match … Store bokstaver, understreker eller et innledende siffer Bruk små bokstaver, sifre og bindestreker, og start med en bokstav
KEYS_CUSTODIAN_MISSING keys.custody.recipients er tom Før opp nøkkelforvalternes age-mottakere, de offentlige halvdelene
KEYS_CUSTODIAN_EXAMPLE En mottaker er eksempelforvalteren fra chartets verdifiler, hvis identitet ingen eier Erstatt den med dine egne nøkkelforvalteres mottakere
keys.custody.recipients: … En mottaker i et format som forvaltnings-Job-objektet ikke kan kryptere til Bruk age1…, age1tag1…, age1tagpq1…, age1pq1… eller age1se1…, med små bokstaver
NEXUS_EDITION_INVALID edition er verken community eller enterprise Angi en av de to
edition=… but enterprise.enabled=… De to stemmer ikke overens Sett enterprise.enabled: true nøyaktig når edition er enterprise
global.imageRegistry is required Intet register navngitt Angi registeret som nodene dine henter avbildningene fra
hosts.<name> is required En offentlig vert mangler Sett hosts.console, hosts.api og hosts.auth
tls.existingSecret is required when tls.mode is existing Intet sertifikat-Secret navngitt Navngi Secret-objektet, eller velg en annen tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Ingen utsteder navngitt Navngi din ClusterIssuer
dataTier.<store>.external.host is required when mode is external Et eksternt lager uten adresse Oppgi verten, og dens Secret i existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template har ingen klynge å slå dem opp i Oppgi API-serverens adresser som /32-områder
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID Den genererte nøkkelen i nexus-generated har feil format Se «Oppgraderingsfeil» ovenfor

En verdifil som bruker en nøkkel chartet ikke har, eller en verdi av feil type, avvises av chartets skjema før noen av disse. telemetry.enabled: true er ett eksempel: skjemaet godtar kun false.

Sende en støttepakke

Når ingenting av dette løser problemet, sender du Adverant en støttepakke sammen med støtteforespørselen din.

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

<request-number> er nummeret på forespørselen du åpnet på kontoens side for Støtte og støttepakker. Du kan lage den samme pakken fra konsollens side Støttepakke under Denne installasjonen.

Pakken inneholder motorlogger fra de siste 24 timene, helse- og versjonsdetaljer, innstillinger uten hemmeligheter, samt rapportene fra forhåndskontroll og installasjon. Før den skrives, erstatter sladding navn, hemmeligheter og adresser, og du leser en forhåndsvisning av nøyaktig hva som sendes ut. Folks meldinger, filer og minne samles aldri inn.

Last den opp på forespørselen i kontoen din, eller lagre den på et medium og ta den med ut hvis installasjonen ikke har forbindelse utad. Kun støtteteknikerne som er navngitt på forespørselen kan åpne den, og den slettes etter 30 dager. Oppgi i forespørselen hvilket av problemene ovenfor du så på, og hva sjekkene i dette kapittelet viste: det sparer en ekstra runde.