Vai al contenuto principale

Risoluzione dei problemi — Kubernetes

Il cluster resta in creazione o passa a Error​

Causa: il provisioning del control plane o dei nodi non va a buon fine, oppure la piattaforma non è riuscita ad applicare l'ultima modifica del cluster. In quest'ultimo caso, il cluster passa allo stato Error; può continuare a funzionare con la configurazione precedente.

Soluzione:

  1. In Infrastructure > Kubernetes, verifichi lo stato del cluster. Un cluster appena creato passa da Creating a Ready in pochi minuti. Il filtro di stato dell'elenco consente di visualizzare i cluster Ready o Error.
  2. Nella pagina di dettaglio, verifichi in Node Pools che i nodi diventino attivi.
  3. Se lo stato non cambia, oppure se il cluster è in Error, contatti il supporto indicando il nome del cluster e il progetto.

La creazione del primo cluster attende «Preparing the Kubernetes environment»​

Causa: il primo cluster di un progetto può essere creato solo quando l'ambiente Kubernetes del progetto è pronto, operazione che richiede alcuni minuti. Un cluster successivo può incontrare brevemente la stessa attesa, durante una modifica del progetto come un cambio di quota.

Soluzione:

  1. Lasci aperta la procedura guidata: mostra «Preparing the project's Kubernetes environment; creation will resume automatically.» e rilancia da sola la creazione, senza perdere la configurazione inserita. Il pulsante Cancel interrompe l'attesa.
  2. Se la console mostra «The project's Kubernetes environment is still not ready. Your configuration is kept: try again in a few minutes.», faccia di nuovo clic su Create cluster qualche minuto più tardi.
  3. Se la console mostra Error during creation con un messaggio che le chiede di contattare il supporto (ad esempio «The project's Kubernetes environment failed to deploy. Contact support.»), non riprovi: contatti il supporto indicando il progetto.

Se crea i suoi cluster tramite l'API, questi casi corrispondono ai codici di errore 70205 (ambiente in preparazione: invii di nuovo la stessa richiesta qualche minuto più tardi), 70207 e 70208 (non riprovi, contatti il supporto).

La procedura guidata blocca la creazione (quota)​

Causa: il progetto non dispone di quota CPU, memoria o storage sufficiente. La quota è calcolata sul control plane e sul numero massimo di nodi di ogni gruppo, disco dei nodi compreso («Storage quota exceeded for this project (including maximum auto-scaling)»).

Soluzione:

  1. Consulti gli indicatori Project Quotas della procedura guidata per identificare la risorsa superata.
  2. Riduca i Maximum nodes, il tipo di istanza o la Node disk size dei gruppi.
  3. Se l'esigenza è reale, chieda un aumento della quota al supporto.

Il download del kubeconfig non riesce​

Causa: la console mostra «Could not download the kubeconfig file.» quando il cluster non è ancora pronto o il servizio è momentaneamente non disponibile.

Soluzione:

  1. Attenda che il cluster abbia lo stato Ready.
  2. Faccia di nuovo clic su Kubeconfig nella sezione Actions della pagina di dettaglio.
  3. Se l'errore persiste, contatti il supporto.

Il pulsante Kubeconfig è disattivato o il download viene rifiutato​

Causa: il kubeconfig conferisce un accesso amministratore al cluster; il suo download è riservato agli amministratori del progetto. Per gli altri membri, il pulsante Kubeconfig è disattivato con la dicitura «Reserved for project administrators.» Se la richiesta viene rifiutata dalla piattaforma, la console mostra «The kubeconfig grants administrator access to the cluster: it is reserved for project administrators.»

Soluzione:

  1. Si rivolga a un amministratore del progetto.
  2. Per un accesso limitato al cluster, un amministratore può anche crearle un account dedicato con RBAC nel cluster (vedere Accesso e strumenti).

Kubeconfig scaduto o non valido​

Causa: kubectl restituisce x509: certificate has expired, Unauthorized, oppure non raggiunge più il server (ad esempio, file di un cluster eliminato e poi ricreato).

Soluzione:

  1. Scarichi un nuovo kubeconfig dalla pagina di dettaglio del cluster (pulsante Kubeconfig).
  2. Sostituisca il vecchio file: 
    export KUBECONFIG=~/Downloads/kubeconfig-<nome-del-cluster>.yaml
  3. Verifichi la connettività: 
    kubectl cluster-info

Nodi nello stato NotReady​

Causa: uno o più nodi non rispondono più al control plane. Ciò può dipendere da risorse insufficienti, da un disco dei nodi saturo o da un malfunzionamento del kubelet.

Soluzione:

  1. Verifichi lo stato dei nodi e le relative condizioni: 
    kubectl get nodes
    kubectl describe node <nome-del-nodo>
  2. Consulti gli eventi per identificare la causa (DiskPressure, MemoryPressure, PIDPressure): 
    kubectl get events -A --sort-by='.lastTimestamp'
  3. In caso di DiskPressure, aumenti la Node disk size del gruppo (Edit > Node groups).
  4. Verifichi che il tipo di istanza fornisca risorse sufficienti per i workload distribuiti.
  5. Se il problema persiste, contatti il supporto.

Pod in Pending (risorse insufficienti)​

Causa: nessun nodo dispone di CPU o memoria sufficienti per pianificare il pod.

Soluzione:

  1. Identifichi il motivo del Pending: 
    kubectl describe pod <nome-del-pod>
    Cerchi il messaggio FailedScheduling negli eventi.
  2. Verifichi le risorse disponibili sui nodi: 
    kubectl top nodes
  3. Se i nodi sono saturi e il gruppo ha raggiunto il suo massimo, aumenti i Maximum nodes (Edit > Node groups), oppure aggiunga un gruppo con un tipo di istanza più grande.
  4. Se il pod è bloccato su un PVC, verifichi che il PVC sia stato correttamente provisionato: 
    kubectl get pvc

L'Ingress restituisce 404 o non risponde​

Causa: la risorsa Ingress è configurata in modo errato, l'addon Ingress NGINX non è attivato oppure nessun gruppo di nodi ospita il controller.

Soluzione:

  1. Verifichi nella pagina di dettaglio del cluster che Ingress NGINX compaia nella sezione Extensions. In caso contrario, lo attivi tramite Edit > Extensions & Addons.
  2. Verifichi che almeno un gruppo di nodi sia Exposed on the internet (Public IP) e che il controller abbia un IP esterno: 
    kubectl get svc -A | grep ingress-nginx-controller
  3. Verifichi che l'ingressClassName sia specificato nel suo Ingress:
    ingress.yaml
    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: my-app
    spec:
      ingressClassName: nginx
      rules:
        - host: app.example.com
          http:
            paths:
              - path: /
                pathType: Prefix
                backend:
                  service:
                    name: my-app-svc
                    port:
                      number: 80
  4. Verifichi che il backend (Service e pod) funzioni: 
    kubectl get pods -l app=my-app
    kubectl get svc my-app-svc
  5. Verifichi che il suo record DNS punti all'IP esterno del controller, nonché la configurazione dell'host e del path nella regola Ingress.

PVC nello stato Pending​

Causa: la classe di storage richiesta non esiste nel cluster oppure la capacità di storage è insufficiente.

Soluzione:

  1. Elenchi le classi di storage disponibili nel cluster: 
    kubectl get storageclass
  2. Si assicuri che il nome utilizzato nel PVC corrisponda a una classe esistente, ad esempio replicated:
    pvc.yaml
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: my-data
    spec:
      accessModes:
        - ReadWriteOnce
      storageClassName: replicated
      resources:
        requests:
          storage: 10Gi
  3. Verifichi gli eventi relativi al PVC: 
    kubectl describe pvc my-data
  4. Se la capacità è insufficiente, riduca la dimensione richiesta o contatti il supporto Hikube.

Il salvataggio delle modifiche non riesce​

Causa: la console mostra un errore dopo Save, ad esempio «Conflict during the update (e.g. resource in use).» oppure un messaggio di convalida.

Soluzione:

  1. Legga il messaggio: indica il campo da correggere (ad esempio, GPU aggiunte a un gruppo esistente, massimo inferiore al minimo, YAML di sovrascrittura non valido, versione inferiore a quella attuale). Un ritorno a una versione inferiore di Kubernetes viene rifiutato (version downgrades are not supported, codice 70206): scelga la versione attuale o una versione superiore.
  2. In caso di conflitto, attenda il termine dell'operazione in corso sul cluster, ricarichi la pagina di modifica e riprovi.
  3. Per aggiungere GPU, crei un nuovo gruppo di nodi anziché modificare un gruppo esistente senza GPU.