InloggenBriefing plannen

Hoofdstuk 2.17

Probleemoplossing

De problemen die beheerders het vaakst tegenkomen, geordend op wat u ziet. Bij elk probleem vindt u de oorzaak, het commando dat dit bevestigt en de oplossing, en het hoofdstuk sluit af met het versturen van een ondersteuningsbundel.

Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

22 minuten leestijd

Het meeste van wat er misgaat bij een installatie van Nexus gaat mis op dezelfde dozijn manieren, en bijna allemaal kondigen ze zichzelf aan met een code. Dit hoofdstuk is ingedeeld naar wat u ziet, in ruwweg de volgorde waarin u elk probleem zou tegenkomen: installeren, claimen, licentiëren en vervolgens draaien. Voor elk probleem krijgt u de oorzaak, een opdracht die dit bevestigt, en de oplossing.

De voorbeelden gebruiken de installatie van Harrow Port Authority: namespace nexus, release nexus, hosts console.harrow.example, api.harrow.example en auth.harrow.example. Vervang deze door die van uzelf. Drie gewoonten besparen tijd bij elk probleem dat hier wordt besproken:

  1. Lees de code vóór het bericht. Elke weigering in Nexus eindigt met een machinecode, en dit hoofdstuk is op die code geïndexeerd.
  2. Voer nexusctl preflight opnieuw uit na elke wijziging aan het cluster of het values-bestand. Het leest het cluster zonder het te wijzigen, en het meldt de meeste weigeringen van de chart bij naam voordat Helm dat doet.
  3. Gebruik --explain bij elk nexusctl-werkwoord waar u niet zeker van bent. Dit toont de kubectl- en helm-bewerkingen zonder ze uit te voeren.

De installatie loopt vast

U hebt de installatie gestart en deze is niet voltooid. helm is na vijftien minuten nog niet teruggekeerd, of is wel teruggekeerd en pods staan nog steeds in Init of Pending, of het adres van de console reageert niet.

De meest voorkomende oorzaak is helm install --wait. Nexus maakt zijn database, zijn rollen en het schema van elke service aan in post-install-hooks, en de bootstrap-hook is wat elke service zijn databasewachtwoord geeft. Met --wait wacht Helm tot de Deployments gereed zijn voordat het die hooks uitvoert, terwijl de Deployments wachten op de hooks. Geen van beide komt vooruit. Installeer nooit met --wait; installeer zonder deze vlag en wacht achteraf.

Een verticale reeks vakken verbonden door neerwaartse pijlen: "Release resources created (Deployments start, each held by its wait-for-schema init container)", vervolgens "Database bootstrap hook: database, roles, release ledger", vervolgens "Migration hooks, one per service, in a fixed order", vervolgens "Each hook writes its row in the release ledger". Vanuit het laatste vak waaieren pijlen zijwaarts uit naar drie kleine vakken "nexus-auth starts", "nexus-gateway starts", "other services start". Een kanttekening naast het bovenste vak, met een doorgestreepte pijl naar beneden: "helm install --wait waits here for Deployments that are waiting for the hooks".
Wat er op volgorde wordt uitgevoerd wanneer de chart wordt geïnstalleerd of geüpgraded.

De andere oorzaken zijn gewone Kubernetes-oorzaken. Images kunnen niet worden opgehaald omdat global.imageRegistry de verkeerde registry noemt, of omdat een Enterprise-installatie geen pull-token heeft. Een volume blijft op Pending staan omdat de opslagklasse niet bestaat. cert-manager ontbreekt, in welk geval de installatie helemaal niet blijft hangen: deze mislukt binnen enkele seconden, omdat de certificaatuitgevers van de chart de bronnen van cert-manager nodig hebben.

Begin met de pods en de 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 toont fouten bij het ophalen van images en niet-gekoppelde volumes in de bijbehorende events. Een hook-Job die 0/1 voltooiingen toont met een mislukte pod, heeft de installatie gestopt, omdat hook-Jobs een backoff-limiet van 0 hebben en nooit stilzwijgend opnieuw worden geprobeerd. In het bijbehorende logboek staat waarom.

Zo lost u elke oorzaak op:

  • Als Helm wacht met --wait, stopt u het, maakt u de installatie ongedaan en installeert u opnieuw zonder de vlag. Wacht vervolgens op de services:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Controleer bij pull-fouten global.imageRegistry en, voor Enterprise, het pull-token op de pagina Pull tokens and install commands van uw account.
  • Stel voor Pending-volumes storage.className in op een opslagklasse waarover het cluster beschikt, of maak er een de standaard.
  • Installeer bij een ontbrekende cert-manager cert-manager v1.21.3 en voer de installatie opnieuw uit.
  • Los bij een mislukte hook op wat er in het bijbehorende logboek wordt genoemd en voer de installatie opnieuw uit.

Een pod wacht op zijn schema

De pod van een service blijft minutenlang in Init:0/1 staan. Elke service die de database gebruikt, heeft een init-container, wait-for-schema, die de pod vasthoudt totdat het release-register aangeeft dat de migraties voor de image van deze release zijn toegepast. Dat is normaal gedurende de eerste minuten van een installatie of een upgrade, terwijl de migratie-hooks worden uitgevoerd. Het is een probleem wanneer het niet ophoudt.

Lees het logboek van de init-container:

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

Het logboek noemt het onderdeel, de migratieketens waarop het wacht en de tijdslimiet, en drukt vervolgens een regel af telkens wanneer de status verandert:

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
Voortgangsregel vermeldt Wat het betekent
Welke ketens nog moeten worden toegepast voor deze release De genoemde migratie-hooks zijn nog niet voltooid. Bekijk die Jobs.
Dat het release-register niet kan worden gelezen, met de foutmelding van de database Postgres reageert niet, of het register bestaat niet omdat de database-bootstrap niet is uitgevoerd.
FAILED (<component>): after <n>s, … Het heeft het opgegeven na schemaWait.timeoutSeconds (standaard 1.800). De init-container start opnieuw op; de service zelf is nooit gestart.

Een keten die nooit wordt toegepast, betekent bijna altijd dat de bijbehorende migratie-Job is mislukt. Zoek deze met kubectl -n nexus get jobs en lees het logboek. Los op wat daarin wordt genoemd (een volle schijf, een externe database die de migrator niet kan bereiken, een rolconflict) en voer helm upgrade uit met dezelfde waarden: de hooks worden opnieuw uitgevoerd, en elke hook kan veilig opnieuw worden uitgevoerd.

Verhoog schemaWait.timeoutSeconds alleen wanneer een migratie traag en gezond is, zoals een grote eerste migratie op trage opslag kan zijn. Het verhogen ervan om een mislukte Job te verbergen, zorgt er alleen maar voor dat de pod langer wacht op iets dat nooit zal komen.

De sleutelkluis is verzegeld

Na een stroomuitval, een herstart van een node of een herstart van een containerruntime komen pods weer terug en laadt de console, en alles wat een sleutel nodig heeft, mislukt of wacht. De unsealer start na elke herstart van zijn node verzegeld op, en de sleutelopslag kan zichzelf niet ontzegelen totdat de unsealer open is.

Vraag het aan OpenBao in elke 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 $?"

Exitcode 0 is ontzegeld, 2 is verzegeld en 1 betekent dat er geen antwoord kon worden gegeven (vraag het over een minuut opnieuw). Voer hetzelfde uit tegen openbao-0 met -tls-server-name=openbao voor de sleutelopslag. Als de unsealer ontzegeld is en de sleutelopslag niet, is de sleutelopslag bezig zichzelf te ontzegelen; geef het een minuut.

Om een verzegelde unsealer te herstellen, voert één beheerder (custodian) unseal.sh van de chart uit met zijn eigen age-identiteit. Hoofdstuk 2.15, Dag twee: Nexus beheren, bevat de volledige opdracht. De exitcode van het script vertelt u wat er is gebeurd:

Afsluitcode Betekenis Wat te doen
0 Ontzegeld Controleer kubectl -n nexus get deploy,statefulset binnen een minuut.
1 Nog steeds verzegeld, of een ontzegelingsaanroep is mislukt Lees de share-regels die zijn afgedrukt; voer het opnieuw uit.
2 Er ontbreekt een vereiste Het bericht noemt het: AGE_IDENTITY, een binair bestand zoals age of jq, of een instelling voor de directe modus.
3 Deze identiteit kan de shares niet ontsleutelen U bent geen beheerder (custodian) van deze installatie. Er is niets ingediend. Zoek een beheerder die dat wel is.

U kunt zich niet aanmelden via HTTP

De console laadt op een http://-adres, of via een kubectl port-forward naar 127.0.0.1, en het aanmelden mislukt. De vraag om de passkey verschijnt nooit, of het aanmelden keert in een lus terug naar het begin.

Aanmelden vereist de eigen HTTPS-oorsprong (origin) van de console. De console accepteert alleen een aanmelding vanaf https://<hosts.console>, bewaart de sessie in een __Host--cookie die is gemarkeerd als Secure (wat een browser alleen via HTTPS opslaat), en de passkey van de eerste beheerder vereist een pagina met een geldig certificaat. Browsers weigeren passkeys achter een certificaatfout. Een port-forward naar http://127.0.0.1 kan zich nooit aanmelden.

Controleer wat de browser daadwerkelijk heeft bereikt:

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

De eerste moet antwoorden via HTTPS met een certificaat dat uw machine vertrouwt. De tweede moet de drie hosts tonen met de namen die u hebt ingesteld in hosts.*.

Om dit op te lossen, bereikt u de console op https://console.harrow.example, de exacte naam in hosts.console, met een certificaat dat de browser vertrouwt. Controleer bij tls.mode: existing of tls.existingSecret een certificaat bevat voor alle drie de hosts. Controleer bij tls.mode: cert-manager of de ClusterIssuer het heeft uitgegeven. Bij tls.mode: none eindigt Transport Layer Security (TLS) op uw eigen loadbalancer, en daar moet het certificaat kloppen. Installeer voor een particuliere certificaatautoriteit het bijbehorende certificaat op de machines waarvan uw beheerders zich aanmelden.

De claimcode is verlopen

Op Claim this installation weigert de pagina de code met CLAIM_CODE_EXPIRED (410). Een claimcode bestaat uit drie groepen van vier tekens. Deze werkt één keer, gedurende 30 minuten, met 5 pogingen. Daarna, of na de vijfde foute poging, is de code ongeldig en is er niets geclaimd of gewijzigd.

Maak een nieuwe code aan vanuit de terminal die toegang heeft tot het cluster:

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

Hiermee wordt een nieuwe code en de vingerafdruk van de installatie afgedrukt. Voer de code binnen 30 minuten in op de claimpagina en vergelijk de vingerafdruk opnieuw.

Deze installatie claimen
Deze installatie claimen
Claim deze installatie. De code uit de terminal wordt in drie groepen ingevoerd, en de pagina toont de volledige vingerafdruk in groepen van vier ter vergelijking; een verlopen code wordt geweigerd met CLAIM_CODE_EXPIRED en er wordt niets geclaimd.

Twee gerelateerde antwoorden:

  • RATE_LIMITED (429) op de claimpagina betekent dat er in de afgelopen minuut verschillende pogingen op de pagina zijn gedaan. Wacht het aantal seconden dat wordt aangegeven. Als u die pogingen niet hebt gedaan, probeert iemand anders op uw netwerk de pagina te gebruiken; zoek uit wie dat is voordat u claimt.
  • TRANSITION_NOT_PERMITTED (409) betekent dat de installatie al is geclaimd en dat de bijbehorende claimpagina voorgoed is uitgeschakeld. Meld u in plaats daarvan aan. Als u deze niet hebt geclaimd, behandel dit dan als een beveiligingsincident.

De vingerafdruk komt niet overeen

De claimpagina toont CLAIM_FINGERPRINT_MISMATCH (403), of u ziet zelf dat de acht groepen van vier op de pagina afwijken van de groepen die uw terminal heeft afgedrukt. Zelfs één afwijkende groep betekent dat de browser met een andere installatie communiceert.

Stop. Typ de code niet in op die pagina. Mogelijk antwoordt er op dat adres iets anders dan uw installatie, wellicht een machine die is opgezet om de eerste beheerder te onderscheppen. Als u deze zou claimen, zou die machine uw organisatie in handen hebben. Uw eigen installatie is ongewijzigd en nog steeds niet geclaimd.

Controleer waar de naam naartoe verwijst en welk certificaat heeft geantwoord:

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

Het adres moet dat van uw ingress-controller zijn, en het certificaat moet het certificaat zijn dat u hebt geïnstalleerd voor hosts.console.

Vingerafdruk komt niet overeen
Vingerafdruk komt niet overeen
De vingerafdrukken verschillen in drie van de acht groepen. De pagina zegt te stoppen, legt uit wie er mogelijk antwoordt en geeft een overzicht van wat u moet controleren voordat u het opnieuw probeert.

Om dit op te lossen, geeft u uw beveiligingsteam het adres dat heeft geantwoord en bewaart u het installatielogboek, waarin de vingerafdruk staat die de installatie heeft afgedrukt. Corrigeer het Domain Name System (DNS)-record of de proxy die u elders heen heeft gestuurd. Maak vervolgens een nieuwe claimcode aan met nexusctl claim-code --administrator <email> en claim vanuit een browser op een netwerk dat u vertrouwt, waarbij u alle acht de groepen opnieuw vergelijkt.

De licentie wordt geweigerd

Het importeren op Import the licence, Import a new licence of nexusctl licence import antwoordt met een weigering. Een geweigerde import verandert niets: de geldende licentie blijft van kracht en de klokondergrens verschuift niet.

Lees de code en de stap:

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

De body van de weigering bevat code, message, refused_at (de stap die is mislukt) en troubleshooting. Om de status van de geldende licentie te zien, leest u GET https://auth.harrow.example/api/v1/installation/licence/state uit met hetzelfde token.

Code HTTP Gebruikelijke oorzaak Oplossing
LICENCE_SIGNATURE_INVALID 422 Het bestand is bewerkt, opnieuw opgemaakt of opnieuw opgeslagen, of er ontbreekt een handtekening Download het opnieuw vanuit uw account en importeer het ongewijzigd
LICENCE_FORMAT_INVALID 422 Geen licentie: verkeerd bestand, afgekapt of verpakt in een ander object Verstuur het bestand precies zoals Adverant het heeft verstrekt
LICENCE_ROOT_UNKNOWN 422 Ondertekend met een sleutel die deze release niet bevat Voer een upgrade uit, of vraag om een licentie die is ondertekend voor uw release
LICENCE_MATRIX_MISMATCH 422 Geschreven voor een nieuwere editiematrix, of kent een groep toe die deze build niet kent Voer een upgrade uit, of vraag om een licentie die is geschreven voor uw release
LICENCE_OTHER_INSTALLATION 409 Uitgegeven voor een andere installatie, vaak de licentie van het testcluster op productie Vraag om een licentie voor de identiteit van deze installatie
LICENCE_REVOKED 403 Adverant heeft deze ingetrokken Vraag Adverant om een nieuwe licentie
LICENCE_LOCKED 403 De starts_on ervan ligt na de huidige datum Importeer deze op of na de eerste geldigheidsdag
TRANSITION_NOT_PERMITTED 409 Deze licentie-ID is al geïmporteerd U hoeft niets te doen als deze van kracht is; vraag het aan Adverant als de voorwaarden moeten worden gewijzigd
RECORD_NOT_FOUND 404 De installatie is nog niet gedeclareerd en heeft dus nog geen identiteit Voltooi de stap voor de eerste beheerder en importeer vervolgens
TENANT_NOT_A_PARAMETER 403 De body noemt een organisatie op het hoogste niveau Stuur alleen het licentiebestand als de body

Twee dingen lijken op licentieproblemen, maar zijn dat niet. Een uitgelezen status die LICENCE_CLOCK_BEHIND_FLOOR bevat, betekent dat de klok van de node een eerdere tijd aangeeft dan de laatste tijd die de installatie heeft gezien; corrigeer de tijd van de node, en als de klok vooruit had gelopen en de ondergrens had meegetrokken, vraag Adverant dan om een tijdreset-token. En een licentie die wordt geïmporteerd en een groep nog steeds als een teaser toont, kent die groep doorgaans niet toe: lees eerst de toekenningen op de licentiepagina.

Geen AI-antwoorden

De kunstmatige-intelligentie-assistent (AI-assistent) toont MODEL_NOT_CONNECTED (503), een workflowstap mislukt met NO_PROVIDER_FOR_ROLE (422), of antwoorden houden gewoon op.

De pool van de organisatie heeft geen sleutel die kan antwoorden, of de router kan de provider niet bereiken. Elke organisatie brengt haar eigen modelsleutel mee. Als er geen sleutel in gebruik is, is er geen AI – dat is een bewuste keuze – en springt er geen gedeelde sleutel bij.

Controleer de pool en de keuze van de router, elk met het eigen toegangstoken van de persoon:

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

De eerste geeft een overzicht van elke provider, of deze kan antwoorden en waarom niet ("No key in use: 1 withdrawn, 1 lapsed"), en de status van elke sleutel. De tweede geeft als antwoord het model dat de router zou gebruiken voor de organisatie, of de weigering in woorden. Controleer vervolgens het pad het cluster uit met deze twee opdrachten:

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

Wat elke bevinding betekent:

U vindt Oplossing
Geen sleutel in de pool Een eigenaar of beheerder voegt een organisatiesleutel toe op het AI-schakelbord of via Instellingen, AI-modellen
Sleutels invalid, expired of exhausted Voeg een nieuwe sleutel toe; de oude blijft vermeld als geschiedenis
Sleutels resting Wacht: een falende sleutel rust 60 seconden, en na 5 mislukkingen op rij wordt deze uitgeschakeld (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE met sleutels in gebruik De rol heeft geen toewijzing en er komt niets overeen; stel de rol in het routeringsbeleid in
MODEL_CAPABILITY_UNAVAILABLE (422) Het verzoek vereist een mogelijkheid, of een dataverblijfplaats (residency), die geen enkele provider in de pool biedt; schakel er een in die dat wel doet
Geen nexus-operator-egress-beleid, of de bereiken van de provider ontbreken daarin Voeg de bereiken, geschreven in Classless Inter-Domain Routing (CIDR)-notatie, toe aan networkPolicy.externalEgressCIDRs en voer een upgrade uit
Een lokale modelserver die niet antwoordt Controleer ai.localProvider.baseUrl, vermeld de server in ai.installationHosts en sta het bereik ervan toe in networkPolicy.externalEgressCIDRs

Een sleutel van een gehoste provider die vanaf een laptop werkt en op de installatie mislukt, ligt bijna altijd aan het netwerkbeleid. De namespace weigert standaard uitgaand verkeer (egress).

429-antwoorden

Een client krijgt 429 Too Many Requests als antwoord. Nexus heeft vier plaatsen die dit kunnen melden, en de body vertelt u welke.

Waar Code en detail Wat u moet wijzigen
nexus-auth, per aangemelde persoon RATE_LIMITED met limit, windowSeconds en retryAfterSeconds auth.rateLimitPerMinute (standaard 5000), voor zware automatisering
Een limiet voor een scriptsleutel, app of eenheid (Enterprise) RATE_LIMITED met vermelding van de sleutel en de bijbehorende limiet De limiet onder Instellingen, Rate-limieten, met een reden
De claimpagina bij het eerste gebruik RATE_LIMITED met retry_after_seconds Niets: wacht en zoek uit wie er nog meer de pagina probeert te gebruiken
Een modelprovider De router behandelt dit als een voorbijgaande storing en gaat door naar de volgende provider Voeg een andere sleutel of provider toe als dit vaak gebeurt

Elk antwoord bevat een Retry-After-header. Een zich goed gedragende client wacht zo lang en probeert het niet eerder opnieuw.

Als alle gebruikers tegelijk één limiet lijken te delen, controleer dan proxy.trustedCIDRs. Wanneer dit het podnetwerk van uw ingress-controller niet dekt, kan nexus-auth de X-Forwarded-For-header niet vertrouwen en ziet het elk verzoek als afkomstig van de controller. De standaardwaarde, 10.42.0.0/16, past alleen bij k3s.

kubectl get pods -A -o wide

Zoek het podadres van de ingress-controller in de uitvoer en zorg ervoor dat proxy.trustedCIDRs dit dekt.

Upgradefouten

De upgrade is teruggedraaid. De pagina Upgrade toont UPGRADE_ROLLED_BACK: er is een stap mislukt, elke engine staat weer op de vorige release en de gegevens zijn niet gewijzigd. De pagina noemt de stap. Een veelvoorkomende oorzaak is een volume dat te klein is voor de nieuwe indeling van een opslag. Los op wat er wordt genoemd, voer nexusctl upgrade plan --bundle <file> opnieuw uit en pas de upgrade vervolgens toe. De back-up wordt eerst opnieuw gemaakt.

De chart weigert te renderen met EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. De Secret nexus-generated bevat EXTERNAL_KEY_ENCRYPTION_KEY in een vorm die de chart niet kan gebruiken. Het moet base64 van 32 bytes zijn, of de onbewerkte sleutel van 32 bytes van een oudere installatie. Iemand heeft de Secret bewerkt of vervangen. Zet de sleutel terug waaronder de gegevens van deze installatie zijn verzegeld, als base64 van de 32 bytes ervan (printf %s "$OLD" | base64), en voer de upgrade opnieuw uit. Laat de chart geen nieuwe aanmaken: gegevens die onder de oude sleutel zijn verzegeld, zouden onleesbaar blijven.

Scripts worden na de upgrade geweigerd met TOKEN_ORG_MISSING. Elke service die Application Programming Interface (API)-sleutels controleert via nexus-auth, weigert nu een sleutel zonder organisatie met 403 TOKEN_ORG_MISSING. Geef elk van zulke sleutels een organisatie, of geef een nieuwe sleutel uit.

Sleutels melden gedurende een uur de verkeerde applicatie. Wis de gecachte sleutelvermeldingen in de cache van nexus-auth, de Valkey-opslag van de installatie. Hoofdstuk 2.15, Dag twee: Nexus beheren, bevat de opdracht voor de opslag binnen het cluster en voor een externe opslag.

Een migratie-hook is mislukt. helm upgrade meldt een mislukte pre-upgrade-hook. Het schema wordt verplaatst voordat de nieuwe pods worden uitgerold, dus de draaiende release blijft nog steeds actief. Lees het logboek van de Job met kubectl -n nexus logs job/<job-name>, los op wat daarin wordt genoemd en voer de upgrade opnieuw uit.

Services konden hun tabellen enkele seconden niet gebruiken. Bij de eerste upgrade van een installatie die is gemaakt vanuit een eerdere chart, verliest elke service zijn oude standaard tabelrechten en krijgt deze zijn eigen rechten terug vanuit zijn eigen migratie. De onderbreking duurt enkele seconden. Voer de upgrade uit in een rustige periode, of schaal de services eerst terug naar nul.

De release op schijf is geweigerd. Importeren vanaf media toont MEDIA_SIGNATURE_INVALID (422): de bestanden zijn niet ondertekend met de releasesleutel die op deze installatie is geïnstalleerd. Er is niets geladen en de draaiende release blijft draaien. Bewaar de media voor uw beveiligingsteam en vraag Adverant om nieuwe media via de offline uitwisseling.

Een weigering bij het renderen van de chart

helm install, helm upgrade of helm template stopt voordat er iets wordt toegepast, met een bericht dat begint met een code of een waarde noemt. De chart weigert waarden die deze niet veilig kan uitvoeren. Er is niets op het cluster gewijzigd.

Render de chart afzonderlijk om elke weigering te zien zonder het cluster aan te raken. Gebruik op Enterprise de Enterprise-chart die u hebt gedownload in plaats van het oci://-adres, en stel networkPolicy.apiServerCIDRs in bij de waarden, omdat een offline render dit niet uit het cluster kan lezen:

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

Preflight controleert dezelfde identiteitswaarden in zijn sectie "time and keys" en meldt dezelfde codes. De exitcode ervan is 0 wanneer de installatie kan doorgaan (waarschuwingen blokkeren niet), 1 wanneer ten minste één controle is mislukt en 2 wanneer deze niet kon worden uitgevoerd.

Preflight kan niet doorgaan
Preflight kan niet doorgaan
Preflight kan niet doorgaan. De mislukte controles komen eerst, elk met de bijbehorende oplossing, en de installatie blijft geblokkeerd met PREFLIGHT_FAILED totdat ze slagen.
Weigering Oorzaak Oplossing
INSTALLATION_NAME_MISSING keys.installationName is leeg Stel dit in op de eigen naam van deze installatie, overeenkomend met ^[a-z][a-z0-9-]{0,62}$. Dit is permanent zodra de sleutelopslag voor het eerst start
INSTALLATION_NAME_EXAMPLE De naam is de naam uit de voorbeeld-values-bestanden van de chart Stel uw eigen naam in
keys.installationName "…" does not match … Hoofdletters, liggende streepjes of een cijfer aan het begin Gebruik kleine letters, cijfers en koppeltekens, beginnend met een letter
KEYS_CUSTODIAN_MISSING keys.custody.recipients is leeg Vermeld de age-ontvangers van uw beheerders (custodians), de openbare helften
KEYS_CUSTODIAN_EXAMPLE Een ontvanger is de voorbeeldbeheerder uit de values-bestanden van de chart, van wie niemand de identiteit bezit Vervang deze door de ontvangers van uw eigen beheerders
keys.custody.recipients: … Een ontvanger in een vorm waarnaar de custody-Job niet kan versleutelen Gebruik age1…, age1tag1…, age1tagpq1…, age1pq1… of age1se1…, in kleine letters
NEXUS_EDITION_INVALID edition is noch community, noch enterprise Stel een van de twee in
edition=… but enterprise.enabled=… De twee spreken elkaar tegen Stel enterprise.enabled: true precies in wanneer edition gelijk is aan enterprise
global.imageRegistry is required Geen registry genoemd Stel de registry in waaruit uw nodes de images ophalen
hosts.<name> is required Er ontbreekt een openbare host Stel hosts.console, hosts.api en hosts.auth in
tls.existingSecret is required when tls.mode is existing Geen certificaat-Secret genoemd Noem de Secret, of kies een andere tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Geen uitgever (issuer) genoemd Noem uw ClusterIssuer
dataTier.<store>.external.host is required when mode is external Een externe opslag zonder adres Geef de bijbehorende host op, en de bijbehorende Secret in existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template heeft geen cluster om ze in op te zoeken Geef de adressen van de API-server op als /32-bereiken
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID De gegenereerde sleutel in nexus-generated heeft de verkeerde vorm Zie "Upgradefouten" hierboven

Een values-bestand dat een sleutel gebruikt die de chart niet heeft, of een waarde van het verkeerde type, wordt vóór al deze controles geweigerd door het schema van de chart. telemetry.enabled: true is één voorbeeld: het schema accepteert alleen false.

Een ondersteuningsbundel versturen

Wanneer niets hiervan het probleem oplost, stuurt u Adverant een ondersteuningsbundel (support bundle) bij uw ondersteuningsverzoek.

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

<request-number> is het nummer van het verzoek dat u hebt geopend op de pagina Support and support bundles van uw account. U kunt dezelfde bundel maken vanaf de pagina Support bundle van de console onder This installation.

De bundel bevat enginelogboeken van de afgelopen 24 uur, status- en versiegegevens, instellingen zonder hun geheimen, en de preflight- en installatierapporten. Voordat deze wordt weggeschreven, vervangt redactie namen, geheimen en adressen, en leest u een voorbeeld van wat er precies naar buiten gaat. Berichten, bestanden en geheugen van personen worden nooit verzameld.

Upload deze bij het verzoek in uw account, of sla deze op media op en neem deze mee naar buiten als de installatie geen verbinding met buiten heeft. Alleen de ondersteuningstechnici die op het verzoek worden genoemd, kunnen de bundel openen, en deze wordt na 30 dagen gewist. Vermeld in het verzoek naar welk van de bovenstaande problemen u keek en wat de controles in dit hoofdstuk lieten zien: dat bespaart een extra berichtwisseling.