AccediPrenota un briefing

Capitolo 2.17

Risoluzione dei problemi

I problemi che gli operatori incontrano più spesso, organizzati in base a ciò che si osserva. Per ciascuno vengono forniti la causa, il comando che la conferma e la soluzione; il capitolo si conclude con l'invio di un bundle di supporto.

Questa pagina è stata tradotta dall'IA a partire dall'originale in inglese. In caso di dubbi, fa fede la pagina in inglese. Legga questa pagina in inglese

22 minuti di lettura

La maggior parte dei problemi che si verificano in un'installazione di Nexus rientra nella stessa dozzina di casistiche, e quasi tutte si annunciano con un codice. Questo capitolo è organizzato in base a ciò che si osserva, all'incirca nell'ordine in cui si incontrerebbe ciascun problema: installazione, rivendicazione, licenza, quindi esecuzione. Per ciascuno sono indicati la causa, un comando che la conferma e la soluzione.

Gli esempi utilizzano l'installazione di Harrow Port Authority: namespace nexus, release nexus, host console.harrow.example, api.harrow.example e auth.harrow.example. Sostituiteli con i vostri. Tre abitudini fanno risparmiare tempo con ogni problema descritto qui:

  1. Leggete il codice prima del messaggio. Ogni rifiuto in Nexus termina con un codice macchina, ed è in base a tale codice che è indicizzato questo capitolo.
  2. Eseguite nuovamente nexusctl preflight dopo qualsiasi modifica al cluster o al file dei valori. Legge il cluster senza modificarlo e segnala per nome la maggior parte dei rifiuti del chart prima che lo faccia Helm.
  3. Usate --explain su qualsiasi verbo di nexusctl di cui non siete sicuri. Stampa le operazioni kubectl e helm senza eseguirle.

L'installazione si blocca

Avete avviato l'installazione e non è terminata. helm non ha restituito il controllo dopo quindici minuti, oppure lo ha restituito e i pod sono ancora in Init o Pending, oppure l'indirizzo della console non risponde.

La causa più comune è helm install --wait. Nexus crea il proprio database, i propri ruoli e lo schema di ogni servizio negli hook post-installazione, ed è l'hook di bootstrap a consegnare a ciascun servizio la relativa password del database. Con --wait, Helm attende che i Deployment siano pronti prima di eseguire tali hook, mentre i Deployment attendono gli hook. Nessuno dei due procede. Non installate mai con --wait; installate senza di esso e attendete in seguito.

Una sequenza verticale di riquadri uniti da frecce rivolte verso il basso: "Risorse della release create (i Deployment si avviano, ciascuno trattenuto dal proprio init container wait-for-schema)", quindi "Hook di bootstrap del database: database, ruoli, registro delle release", quindi "Hook di migrazione, uno per servizio, in un ordine fisso", quindi "Ciascun hook scrive la propria riga nel registro delle release". Dall'ultimo riquadro, le frecce si diramano lateralmente verso tre piccoli riquadri "nexus-auth si avvia", "nexus-gateway si avvia", "gli altri servizi si avviano". Una nota laterale accanto al riquadro superiore, con una freccia barrata verso il basso: "helm install --wait attende qui i Deployment che stanno attendendo gli hook".
Cosa viene eseguito, in ordine, quando il chart viene installato o aggiornato.

Le altre cause sono quelle ordinarie di Kubernetes. Impossibile scaricare le immagini perché global.imageRegistry indica il registro errato, oppure un'installazione Enterprise è priva di pull token. Un volume rimane in stato Pending perché la storage class non esiste. Manca cert-manager, nel qual caso l'installazione non si blocca affatto: fallisce in pochi secondi, perché gli emettitori di certificati del chart necessitano delle risorse di cert-manager.

Iniziate con i pod e i Job degli hook:

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 mostra nei suoi eventi gli errori di pull delle immagini e i volumi non associati. Un Job di hook che mostra 0/1 completamenti con un pod fallito ha arrestato l'installazione, poiché i Job di hook hanno un limite di backoff pari a 0 e non vengono mai ritentati silenziosamente. Il relativo log ne indica il motivo.

Ecco come risolvere ciascuna causa:

  • Se Helm è in attesa con --wait, fermatelo, disinstallate e installate nuovamente senza il flag. Quindi attendete i servizi:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  • Per gli errori di pull, verificate global.imageRegistry e, per Enterprise, il pull token dalla pagina Pull token e comandi di installazione del vostro account.
  • Per i volumi Pending, impostate storage.className su una storage class presente nel cluster, oppure impostatene una come predefinita.
  • Per un cert-manager mancante, installate cert-manager v1.21.3 ed eseguite nuovamente l'installazione.
  • Per un hook fallito, correggete quanto indicato nel relativo log ed eseguite nuovamente l'installazione.

Un pod resta in attesa del proprio schema

Il pod di un servizio rimane in Init:0/1 per minuti. Ogni servizio che utilizza il database ha un init container, wait-for-schema, che trattiene il pod finché il registro delle release non mostra che le relative migrazioni sono state applicate per l'immagine di questa release. Ciò è normale per i primi minuti di un'installazione o di un aggiornamento, mentre vengono eseguiti gli hook di migrazione. È un problema quando non termina.

Leggete il log dell'init container:

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

Il log indica il componente, le catene di migrazione che attende e il relativo limite di tempo, quindi stampa una riga ogni volta che il suo stato cambia:

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
La riga di avanzamento indica Cosa significa
Quali catene devono ancora essere applicate per questa release Gli hook di migrazione nominati non sono terminati. Controllate quei Job.
Che il registro delle release non può essere letto, con l'errore del database Postgres non risponde, oppure il registro non esiste perché il bootstrap del database non è stato eseguito.
FAILED (<component>): after <n>s, … Ha rinunciato dopo schemaWait.timeoutSeconds (1.800 per impostazione predefinita). L'init container si riavvia; il servizio stesso non si è mai avviato.

Una catena che non viene mai applicata significa quasi sempre che il relativo Job di migrazione è fallito. Trovatelo con kubectl -n nexus get jobs e leggetene il log. Correggete ciò che indica (un disco pieno, un database esterno che il migratore non riesce a raggiungere, un conflitto di ruoli) ed eseguite helm upgrade con gli stessi valori: gli hook vengono eseguiti nuovamente e ciascuno può essere rieseguito in sicurezza.

Aumentate schemaWait.timeoutSeconds solo quando una migrazione è lenta e sana, come può esserlo una prima migrazione di grandi dimensioni su uno storage lento. Aumentarlo per nascondere un Job fallito fa solo attendere più a lungo il pod per qualcosa che non arriverà mai.

L'archivio delle chiavi è sigillato

Dopo un'interruzione di corrente, il riavvio di un nodo o il riavvio del container runtime, i pod tornano attivi e la console si carica, e tutto ciò che necessita di una chiave fallisce o attende. L'unsealer si avvia sigillato dopo ogni riavvio del relativo nodo e il key store non può desigillarsi da solo finché l'unsealer non è aperto.

Interrogate OpenBao in ciascun 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 $?"

L'uscita 0 indica che è desigillato, 2 che è sigillato e 1 significa che non ha potuto rispondere (riprovate tra un minuto). Eseguite lo stesso comando su openbao-0 con -tls-server-name=openbao per il key store. Se l'unsealer è desigillato e il key store non lo è, il key store si sta desigillando da solo; dategli un minuto.

Per risolvere il problema di un unsealer sigillato, un custode esegue unseal.sh del chart con la propria identità age. Il Capitolo 2.15, Giorno due: gestione operativa di Nexus, riporta il comando completo. Il codice di uscita dello script indica cosa è accaduto:

Uscita Significato Cosa fare
0 Desigillato Controllate kubectl -n nexus get deploy,statefulset entro un minuto.
1 Ancora sigillato, oppure una chiamata di sblocco non è riuscita Leggete le righe delle quote che ha stampato; eseguitelo di nuovo.
2 Manca un prerequisito Il messaggio lo indica per nome: AGE_IDENTITY, un binario come age o jq, oppure un'impostazione della modalità diretta.
3 Questa identità non può decifrare le quote Non siete un custode di questa installazione. Non è stato inviato nulla. Trovate un custode che lo sia.

Impossibile effettuare l'accesso tramite HTTP

La console si carica a un indirizzo http://, o tramite un kubectl port-forward verso 127.0.0.1, e l'accesso fallisce. La richiesta della passkey non appare mai, oppure l'accesso torna in ciclo all'inizio.

L'accesso richiede la propria origine HTTPS della console. La console accetta un accesso solo da https://<hosts.console>, mantiene la sessione in un cookie __Host- contrassegnato come Secure (che un browser memorizza solo tramite HTTPS) e la passkey del primo amministratore richiede una pagina con un certificato valido. I browser rifiutano le passkey dietro un errore di certificato. Un port-forward verso http://127.0.0.1 non potrà mai effettuare l'accesso.

Verificate cosa ha effettivamente raggiunto il browser:

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

Il primo dovrebbe rispondere tramite HTTPS con un certificato ritenuto attendibile dalla vostra macchina. Il secondo dovrebbe mostrare i tre host con i nomi che avete impostato in hosts.*.

Per risolvere il problema, raggiungete la console all'indirizzo https://console.harrow.example, il nome esatto in hosts.console, con un certificato ritenuto attendibile dal browser. Con tls.mode: existing, verificate che tls.existingSecret contenga un certificato per tutti e tre gli host. Con tls.mode: cert-manager, verificate che il ClusterIssuer lo abbia emesso. Con tls.mode: none, Transport Layer Security (TLS) termina sul vostro bilanciatore di carico, ed è lì che il certificato deve essere corretto. Per un'autorità di certificazione privata, installate il relativo certificato sulle macchine da cui accedono i vostri amministratori.

Il codice di rivendicazione è scaduto

Su Rivendica questa installazione la pagina rifiuta il codice con CLAIM_CODE_EXPIRED (410). Un codice di rivendicazione è composto da tre gruppi di quattro caratteri. Funziona una sola volta, per 30 minuti, con 5 tentativi. Dopodiché, o dopo il quinto tentativo errato, non è più valido e nulla è stato rivendicato o modificato.

Generate un nuovo codice dal terminale che ha accesso al cluster:

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

Stampa un nuovo codice e l'impronta digitale dell'installazione. Inserite il codice nella pagina di rivendicazione entro 30 minuti e confrontate nuovamente l'impronta digitale.

Riscatta questa installazione
Riscatta questa installazione
Rivendica questa installazione. Il codice del terminale va inserito in tre gruppi e la pagina mostra l'impronta digitale completa in gruppi di quattro per il confronto; un codice scaduto viene rifiutato con CLAIM_CODE_EXPIRED e nulla viene rivendicato.

Due risposte correlate:

  • RATE_LIMITED (429) sulla pagina di rivendicazione significa che la pagina ha ricevuto diversi tentativi nell'ultimo minuto. Attendete il numero di secondi indicato. Se non avete effettuato voi quei tentativi, qualcun altro sulla vostra rete sta provando ad accedere alla pagina; scoprite chi è prima di effettuare la rivendicazione.
  • TRANSITION_NOT_PERMITTED (409) significa che l'installazione è già stata rivendicata e la relativa pagina di rivendicazione è disattivata definitivamente. Effettuate invece l'accesso. Se non l'avete rivendicata voi, trattate il fatto come un incidente di sicurezza.

L'impronta digitale non corrisponde

La pagina di rivendicazione mostra CLAIM_FINGERPRINT_MISMATCH (403), oppure potete vedere voi stessi che gli otto gruppi di quattro sulla pagina differiscono da quelli stampati dal vostro terminale. Anche un solo gruppo diverso significa che il browser sta comunicando con un'installazione diversa.

Fermatevi. Non digitate il codice in quella pagina. Qualcos'altro oltre alla vostra installazione potrebbe rispondere a quell'indirizzo, possibilmente una macchina predisposta per intercettare il primo amministratore. Se la rivendicaste, quella macchina deterrebbe la vostra organizzazione. La vostra installazione è invariata e ancora non rivendicata.

Verificate dove punta il nome e quale certificato ha risposto:

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

L'indirizzo dovrebbe essere quello del vostro ingress controller e il certificato dovrebbe essere quello che avete installato per hosts.console.

L'impronta digitale non corrisponde
L'impronta digitale non corrisponde
Le impronte digitali differiscono in tre degli otto gruppi. La pagina dice di fermarsi, spiega chi potrebbe rispondere ed elenca cosa verificare prima di riprovare.

Per risolvere il problema, fornite al vostro team di sicurezza l'indirizzo che ha risposto e conservate il log di installazione, che registra l'impronta digitale stampata dall'installazione. Correggete il record del Domain Name System (DNS) o il proxy che vi ha indirizzato altrove. Quindi generate un nuovo codice di rivendicazione con nexusctl claim-code --administrator <email> ed effettuate la rivendicazione da un browser su una rete di cui vi fidate, confrontando nuovamente tutti gli otto gruppi.

La licenza viene rifiutata

L'importazione su Importa la licenza, Importa una nuova licenza o nexusctl licence import risponde con un rifiuto. Un'importazione rifiutata non modifica nulla: la licenza in vigore rimane in vigore e la soglia minima dell'orologio non si sposta.

Leggete il codice e il passaggio:

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

Il corpo del rifiuto riporta code, message, refused_at (il passaggio fallito) e troubleshooting. Per vedere lo stato della licenza in vigore, leggete GET https://auth.harrow.example/api/v1/installation/licence/state con lo stesso token.

Codice HTTP Causa abituale Soluzione
LICENCE_SIGNATURE_INVALID 422 Il file è stato modificato, riformattato o risalvato, oppure manca una firma Scaricatelo di nuovo dal vostro account e importatelo intatto
LICENCE_FORMAT_INVALID 422 Non è una licenza: file errato, troncato o racchiuso in un altro oggetto Invii il file esattamente come fornito da Adverant
LICENCE_ROOT_UNKNOWN 422 Firmata con una chiave non inclusa in questa release Effettuate l'aggiornamento, oppure richiedete una licenza firmata per la vostra release
LICENCE_MATRIX_MISMATCH 422 Scritta per una matrice di edizioni più recente, oppure concede un gruppo che questa build non conosce Effettuate l'aggiornamento, oppure richiedete una licenza scritta per la vostra release
LICENCE_OTHER_INSTALLATION 409 Emessa per un'altra installazione, spesso la licenza del cluster di test in produzione Richiedete una licenza per l'identità di questa installazione
LICENCE_REVOKED 403 Adverant l'ha ritirata Richiedete ad Adverant una nuova licenza
LICENCE_LOCKED 403 Il suo starts_on è successivo alla data corrente Importatela a partire dal suo primo giorno di validità
TRANSITION_NOT_PERMITTED 409 Questo id di licenza è già stato importato Nulla da fare se è in vigore; chiedete ad Adverant se i termini devono cambiare
RECORD_NOT_FOUND 404 L'installazione non è stata dichiarata, quindi non ha ancora un'identità Completate il passaggio del primo amministratore, quindi importate
TENANT_NOT_A_PARAMETER 403 Il corpo indica un'organizzazione al suo livello superiore Inviate solo il file di licenza come corpo

Due cose sembrano problemi di licenza ma non lo sono. Una lettura di stato che riporta LICENCE_CLOCK_BEHIND_FLOOR significa che l'orologio del nodo segna un'ora precedente all'ultima ora vista dall'installazione; correggete l'ora del nodo e, se l'orologio era andato avanti trascinando con sé la soglia minima, richiedete ad Adverant un token di ripristino dell'ora. Inoltre, una licenza che viene importata e mostra comunque un gruppo come anteprima di solito non concede quel gruppo: prima di qualsiasi altra cosa, leggete le concessioni sulla pagina della licenza.

Nessuna risposta dall'IA

L'assistente di intelligenza artificiale (IA) mostra MODEL_NOT_CONNECTED (503), un passaggio del flusso di lavoro fallisce con NO_PROVIDER_FOR_ROLE (422), oppure le risposte si interrompono semplicemente.

Il pool dell'organizzazione non ha alcuna chiave in grado di rispondere, oppure il router non riesce a raggiungere il fornitore. Ogni organizzazione porta la propria chiave di modello. Senza alcuna chiave in uso non c'è IA, per scelta progettuale, e nessuna chiave condivisa subentra.

Verificate il pool e la scelta del router, ciascuno con il token di accesso personale dell'utente:

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

Il primo elenca ciascun fornitore, se può rispondere e perché non può farlo ("No key in use: 1 withdrawn, 1 lapsed"), e lo stato di ogni chiave. Il secondo risponde indicando il modello che il router utilizzerebbe per l'organizzazione, oppure il suo rifiuto a parole. Quindi verificate il percorso in uscita dal cluster con questi due comandi:

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

Cosa significa ciascun risultato:

Risultato Soluzione
Nessuna chiave nel pool Un proprietario o un amministratore aggiunge una chiave dell'organizzazione sul pannello di controllo IA o in Impostazioni, Modelli di IA
Chiavi invalid, expired o exhausted Aggiungete una nuova chiave; quella vecchia rimane elencata nello storico
Chiavi resting Attendete: una chiave che fallisce rimane in pausa per 60 secondi e dopo 5 fallimenti consecutivi viene disattivata (PROVIDER_KEY_SWITCHED_OFF)
NO_PROVIDER_FOR_ROLE con chiavi in uso Il ruolo non ha alcuna assegnazione e nulla corrisponde; impostate il ruolo nella policy di routing
MODEL_CAPABILITY_UNAVAILABLE (422) La richiesta necessita di una capacità, o di una residenza dei dati, che nessun fornitore nel pool offre; abilitatene uno che la offra
Nessuna policy nexus-operator-egress, o intervalli del fornitore mancanti da essa Aggiungete gli intervalli, scritti nella notazione Classless Inter-Domain Routing (CIDR), a networkPolicy.externalEgressCIDRs ed effettuate l'aggiornamento
Un server di modelli locale che non risponde Verificate ai.localProvider.baseUrl, elencate il server in ai.installationHosts e consentite il relativo intervallo in networkPolicy.externalEgressCIDRs

Una chiave di un fornitore ospitato che funziona da un laptop e fallisce sull'installazione dipende quasi sempre dalla policy di rete. Il namespace nega il traffico in uscita per impostazione predefinita.

Risposte 429

Un client riceve la risposta 429 Too Many Requests. Nexus ha quattro punti che possono emetterla, e il corpo indica quale.

Dove Codice e dettaglio Cosa modificare
nexus-auth, per persona che ha effettuato l'accesso RATE_LIMITED con limit, windowSeconds e retryAfterSeconds auth.rateLimitPerMinute (predefinito 5000), per automazione intensiva
Un limite di chiave di script, app o unità (Enterprise) RATE_LIMITED che indica il nome della chiave e il relativo limite Il limite in Impostazioni, Limiti di frequenza, con una motivazione
La pagina di rivendicazione al primo avvio RATE_LIMITED con retry_after_seconds Nulla: attendete e scoprite chi altro sta provando ad accedere alla pagina
Un fornitore di modelli Il router lo tratta come un errore temporaneo e passa al fornitore successivo Aggiungete un'altra chiave o un altro fornitore se accade spesso

Ciascuno riporta un'intestazione Retry-After. Un client che si comporta correttamente attende quel tempo e non riprova prima.

Se sembra che tutti gli utenti contemporaneamente condividano un unico limite, verificate proxy.trustedCIDRs. Quando non copre la rete dei pod del vostro ingress controller, nexus-auth non può considerare attendibile l'intestazione X-Forwarded-For e vede ogni richiesta come proveniente dal controller. Il valore predefinito, 10.42.0.0/16, è adatto solo a k3s.

kubectl get pods -A -o wide

Trovate l'indirizzo del pod dell'ingress controller nell'output e assicuratevi che proxy.trustedCIDRs lo copra.

Errori di aggiornamento

L'aggiornamento ha eseguito il rollback. La pagina Aggiornamento mostra UPGRADE_ROLLED_BACK: un passaggio è fallito, ogni motore è tornato alla release precedente e i dati non sono stati modificati. La pagina indica il nome del passaggio. Uno comune è un volume troppo piccolo per il nuovo layout di uno store. Correggete ciò che indica, eseguite nuovamente nexusctl upgrade plan --bundle <file>, quindi applicate. Prima viene nuovamente eseguito il backup.

Il chart si rifiuta di eseguire il rendering con EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. Il Secret nexus-generated contiene EXTERNAL_KEY_ENCRYPTION_KEY in una forma che il chart non può utilizzare. Deve essere in base64 di 32 byte, oppure la chiave grezza di 32 byte di un'installazione precedente. Qualcuno ha modificato o sostituito il Secret. Rimettete la chiave con cui sono sigillati i dati di questa installazione, in base64 dei suoi 32 byte (printf %s "$OLD" | base64), ed effettuate nuovamente l'aggiornamento. Non lasciate che il chart ne crei una nuova: i dati sigillati con la vecchia chiave rimarrebbero illeggibili.

Gli script vengono rifiutati con TOKEN_ORG_MISSING dopo l'aggiornamento. Ogni servizio che verifica le chiavi dell'interfaccia di programmazione delle applicazioni (API) tramite nexus-auth ora rifiuta una chiave priva di organizzazione, con 403 TOKEN_ORG_MISSING. Assegnate un'organizzazione a ciascuna di tali chiavi, oppure emettete una nuova chiave.

Le chiavi segnalano l'applicazione errata per un'ora. Svuotate le voci delle chiavi memorizzate nella cache di nexus-auth, lo store Valkey dell'installazione. Il Capitolo 2.15, Giorno due: gestione operativa di Nexus, riporta il comando, per lo store interno al cluster e per uno esterno.

Un hook di migrazione è fallito. helm upgrade segnala un hook di pre-aggiornamento fallito. Lo schema si aggiorna prima che vengano distribuiti i nuovi pod, quindi la release in esecuzione sta ancora erogando il servizio. Leggete il log del Job con kubectl -n nexus logs job/<job-name>, correggete ciò che indica ed eseguite nuovamente l'aggiornamento.

I servizi non hanno potuto utilizzare le proprie tabelle per alcuni secondi. Al primo aggiornamento di un'installazione creata da un chart precedente, ogni servizio perde i propri vecchi diritti predefiniti sulle tabelle e riottiene i propri dalla propria migrazione. L'intervallo è di pochi secondi. Effettuate l'aggiornamento in un periodo di basso traffico, oppure riducete prima i servizi a zero.

La release su disco è stata rifiutata. L'importazione da supporto mostra MEDIA_SIGNATURE_INVALID (422): i file non sono firmati dalla chiave di release installata su questa installazione. Non è stato caricato nulla e la release in esecuzione continua a funzionare. Conservate il supporto per il vostro team di sicurezza e richiedete ad Adverant un nuovo supporto tramite lo scambio offline.

Rifiuto di rendering del chart

helm install, helm upgrade o helm template si interrompe prima che venga applicato alcunché, con un messaggio che inizia con un codice o indica un valore. Il chart rifiuta i valori che non può eseguire in sicurezza. Nulla sul cluster è cambiato.

Eseguite il rendering del chart da solo per vedere ogni rifiuto senza toccare il cluster. Utilizzate il chart Enterprise che avete scaricato al posto dell'indirizzo oci:// su Enterprise, e impostate networkPolicy.apiServerCIDRs nei valori, poiché un rendering offline non può leggerlo dal cluster:

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

Il preflight verifica gli stessi valori di identità nella sua sezione "time and keys" e segnala gli stessi codici. Il suo codice di uscita è 0 quando l'installazione può procedere (gli avvisi non bloccano), 1 quando almeno una verifica è fallita e 2 quando non è stato possibile eseguirlo.

Il controllo preliminare non può proseguire
Il controllo preliminare non può proseguire
Il preflight non può continuare. Le verifiche fallite vengono mostrate per prime, ciascuna con la relativa soluzione, e l'installazione rimane bloccata con PREFLIGHT_FAILED finché non vengono superate.
Rifiuto Causa Soluzione
INSTALLATION_NAME_MISSING keys.installationName è vuoto Impostatelo sul nome proprio di questa installazione, corrispondente a ^[a-z][a-z0-9-]{0,62}$. È permanente una volta che il key store si avvia per la prima volta
INSTALLATION_NAME_EXAMPLE Il nome è quello presente nei file dei valori di esempio del chart Impostate il vostro nome
keys.installationName "…" does not match … Lettere maiuscole, trattini bassi o una cifra iniziale Usare lettere minuscole, cifre e trattini, iniziando con una lettera
KEYS_CUSTODIAN_MISSING keys.custody.recipients è vuoto Elencate i destinatari age dei vostri custodi, le metà pubbliche
KEYS_CUSTODIAN_EXAMPLE Un destinatario è il custode di esempio dei file dei valori del chart, la cui identità non è detenuta da nessuno Sostituitelo con i destinatari dei vostri custodi
keys.custody.recipients: … Un destinatario in una forma per la quale il Job di custodia non può eseguire la cifratura Usate age1…, age1tag1…, age1tagpq1…, age1pq1… o age1se1…, in minuscolo
NEXUS_EDITION_INVALID edition non è né community né enterprise Impostate uno dei due
edition=… but enterprise.enabled=… I due non concordano Impostate enterprise.enabled: true esattamente quando edition è enterprise
global.imageRegistry is required Nessun registro indicato Impostate il registro da cui i vostri nodi scaricano le immagini
hosts.<name> is required Manca un host pubblico Impostate hosts.console, hosts.api e hosts.auth
tls.existingSecret is required when tls.mode is existing Nessun Secret del certificato indicato Indicate il nome del Secret, oppure scegliete un altro tls.mode
tls.clusterIssuer is required when tls.mode is cert-manager Nessun emettitore indicato Indicate il nome del vostro ClusterIssuer
dataTier.<store>.external.host is required when mode is external Uno store esterno privo di indirizzo Fornite il relativo host e il relativo Secret in existingSecret
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read helm template non ha alcun cluster in cui cercarli Fornite gli indirizzi dell'API server come intervalli /32
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID La chiave generata in nexus-generated ha la forma errata Vedete "Errori di aggiornamento" sopra

Un file dei valori che utilizza una chiave non prevista dal chart, o un valore del tipo errato, viene rifiutato dallo schema del chart prima di uno qualsiasi di questi controlli. telemetry.enabled: true ne è un esempio: lo schema accetta solo false.

Inviare un bundle di supporto

Quando nessuna di queste soluzioni risolve il problema, inviate ad Adverant un pacchetto di supporto insieme alla vostra richiesta di supporto.

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

<request-number> è il numero della richiesta che avete aperto nella pagina Supporto e pacchetti di supporto del vostro account. Potete creare lo stesso pacchetto dalla pagina Pacchetto di supporto della console sotto Questa installazione.

Il pacchetto contiene i log dei motori delle ultime 24 ore, i dettagli sullo stato di salute e sulla versione, le impostazioni prive dei relativi segreti e i report di preflight e di installazione. Prima che venga scritto, l'offuscamento sostituisce nomi, segreti e indirizzi, e potete leggere un'anteprima di ciò che viene esattamente inviato. I messaggi, i file e la memoria delle persone non vengono mai raccolti.

Caricatelo sulla richiesta nel vostro account, oppure salvatelo su un supporto ed esportatelo se l'installazione non ha connessioni esterne. Solo i tecnici del supporto nominati nella richiesta possono aprirlo, e viene cancellato dopo 30 giorni. Indicate nella richiesta quale dei problemi sopra indicati stavate esaminando e cosa hanno mostrato le verifiche di questo capitolo: fa risparmiare uno scambio di comunicazioni.