Risoluzione dei problemi di archiviazione

Questo documento fornisce indicazioni per la risoluzione dei problemi di archiviazione.

Se hai bisogno di ulteriore assistenza, contatta Assistenza clienti Google Cloud.

Impossibile collegare il volume

Questo problema può verificarsi se un disco virtuale è collegato a un'istanza virtuale errata e potrebbe essere dovuto a Numero 32727 in Kubernetes 1.12.

L'output di gkectl diagnose cluster è simile al seguente esempio:

Checking cluster object...PASS
Checking machine objects...PASS
Checking control plane pods...PASS
Checking gke-connect pods...PASS
Checking kube-system pods...PASS
Checking gke-system pods...PASS
Checking storage...FAIL
    PersistentVolume pvc-776459c3-d350-11e9-9db8-e297f465bc84: virtual disk "[datastore_nfs] kubevols/kubernetes-dynamic-pvc-776459c3-d350-11e9-9db8-e297f465bc84.vmdk" IS attached to machine "gsl-test-user-9b46dbf9b-9wdj7" but IS NOT listed in the Node.Status
1 storage errors

In questo esempio, uno o più pod sono bloccati nello stato ContainerCreating e mostrano avvisi come l'output di esempio riportato di seguito:

Events:
  Type     Reason              Age               From                     Message
  ----     ------              ----              ----                     -------
  Warning  FailedAttachVolume  6s (x6 over 31s)  attachdetach-controller  AttachVolume.Attach failed for volume "pvc-776459c3-d350-11e9-9db8-e297f465bc84" : Failed to add disk 'scsi0:6'.

Se un disco virtuale è collegato alla macchina virtuale sbagliata, puoi eseguire manualmente per scollegarlo seguendo questa procedura:

  1. Svuotare un nodo. Se vuoi, puoi includere i flag --ignore-daemonsets e --delete-local-data nel comando kubectl drain.

  2. Spegni la VM.

  3. Modifica la configurazione hardware della VM in vCenter per rimuovere il volume.

  4. Accendi la VM.

  5. Contrassegna il nodo come pianificabile.

Il volume è stato perso

Questo problema può verificarsi se un disco virtuale è stato eliminato definitivamente. Questa situazione può accadere se un operatore elimina manualmente un disco virtuale o elimina la VM a cui è collegato il disco.

Se visualizzi il messaggio "non trovato" relativo al file VMDK, è probabile che disco virtuale è stato eliminato definitivamente.

L'output di gkectl diagnose cluster è simile al seguente:

Checking cluster object...PASS
Checking machine objects...PASS
Checking control plane pods...PASS
Checking gke-connect pods...PASS
Checking kube-system pods...PASS
Checking gke-system pods...PASS
Checking storage...FAIL
    PersistentVolume pvc-52161704-d350-11e9-9db8-e297f465bc84: virtual disk "[datastore_nfs] kubevols/kubernetes-dynamic-pvc-52161704-d350-11e9-9db8-e297f465bc84.vmdk" IS NOT found
1 storage errors

Uno o più pod sono bloccati nello stato ContainerCreating, come mostrato nell'esempio di output che segue:

Events:
  Type     Reason              Age                   From                                    Message
  ----     ------              ----                  ----                                    -------
  Warning  FailedAttachVolume  71s (x28 over 42m)    attachdetach-controller                 AttachVolume.Attach failed for volume "pvc-52161704-d350-11e9-9db8-e297f465bc84" : File []/vmfs/volumes/43416d29-03095e58/kubevols/
  kubernetes-dynamic-pvc-52161704-d350-11e9-9db8-e297f465bc84.vmdk was not found

Per evitare che si verifichi questo problema, gestisci le macchine virtuali come descritto in Ridimensionare un cluster utente Upgrade dei cluster.

Per risolvere il problema, puoi ripulire manualmente le risorse Kubernetes correlate:

  1. Elimina la PVC che faceva riferimento alla PV eseguendo kubectl delete pvc [PVC_NAME].

  2. Elimina il pod che ha fatto riferimento alla PVC eseguendo kubectl delete pod [POD_NAME].

  3. Ripeti il passaggio 2 a causa di: Problema di Kubernetes n. 74374.

Impossibile scollegare il volume CSI vSphere

Questo problema si verifica se non è stato concesso il privilegio CNS > Searchable a per l'utente vSphere.

Se i pod sono bloccati nella fase ContainerCreating con avvisi FailedAttachVolume, il problema potrebbe essere dovuto a un scollegamento non riuscito su un altro nodo.

Per verificare la presenza di errori di scollegamento CSI, esegui questo comando:

kubectl get volumeattachments -o=custom-columns=NAME:metadata.name,DETACH_ERROR:status.detachError.message

L'output è simile all'esempio seguente:

NAME                                                                   DETACH_ERROR
csi-0e80d9be14dc09a49e1997cc17fc69dd8ce58254bd48d0d8e26a554d930a91e5   rpc error: code = Internal desc = QueryVolume failed for volumeID: "57549b5d-0ad3-48a9-aeca-42e64a773469". ServerFaultCode: NoPermission
csi-164d56e3286e954befdf0f5a82d59031dbfd50709c927a0e6ccf21d1fa60192d   <none>
csi-8d9c3d0439f413fa9e176c63f5cc92bd67a33a1b76919d42c20347d52c57435c   <none>
csi-e40d65005bc64c45735e91d7f7e54b2481a2bd41f5df7cc219a2c03608e8e7a8   <none>

Per risolvere il problema, aggiungi il privilegio CNS > Searchable al tuo account utente vCenter. L'operazione di scollegamento riprova automaticamente finché non viene eseguita correttamente.

Driver CSI vSphere non supportato sull'host ESXi

Questo problema si verifica quando un host ESXi nel cluster vSphere esegue una versione inferiore a ESXi 6.7U3.

L'output di gkectl check-config include il seguente avviso:

The vSphere CSI driver is not supported on current ESXi host versions.
CSI requires ESXi 6.7U3 or above. See logs for ESXi version details.

Per risolvere il problema, eseguire l'upgrade degli host ESXi alla versione 6.7U3 o successiva.

La creazione del volume CSI non riesce con l'errore NotSupported

Questo problema si verifica quando un host ESXi nel cluster vSphere esegue una versione inferiore a ESXi 6.7U3.

L'output di kubectl describe pvc include il seguente errore:

Failed to provision volume with StorageClass <standard-rwo>: rpc error:
code = Internal desc = Failed to create volume. Error: CnsFault error:
CNS: Failed to create disk.:Fault cause: vmodl.fault.NotSupported

Per risolvere il problema, eseguire l'upgrade degli host ESXi alla versione 6.7U3 o successiva.

Impossibile collegare il volume CSI vSphere

Questo Problema noto di Kubernetes nel driver CSI vSphere open source si verifica quando un nodo viene arrestato, eliminato o non funziona.

L'output di kubectl describe pod è simile al seguente:

Events:
 Type    Reason                 From                     Message
 ----    ------             ... ----                     -------
 Warning FailedAttachVolume ... attachdetach-controller  Multi-Attach error for volume
                                                         "pvc-xxxxx"
                                                         Volume is already exclusively attached to one
                                                         node and can't be attached to another

Per risolvere il problema, svolgi i seguenti passaggi:

  1. Prendi nota del nome del PersistentVolumeClaim (PVC) nell'output precedente e individua i VolumeAttachment associati al PVC:

    kubectl get volumeattachments | grep pvc-xxxxx
    

    L'esempio di output seguente mostra i nomi dei volumi collegati:

    csi-yyyyy   csi.vsphere.vmware.com   pvc-xxxxx   node-zzzzz ...
    
  2. Descrivi VolumeAttachments:

    kubectl describe volumeattachments csi-yyyyy | grep "Deletion Timestamp"
    

    Prendi nota del timestamp di eliminazione, come nell'output di esempio che segue:

    Deletion Timestamp:   2021-03-10T22:14:58Z
    
  3. Attendi fino al tempo specificato dal timestamp di eliminazione, quindi forza eliminare l'oggetto VolumeAttachment. A questo scopo, modifica l'oggetto VolumeAttachment ed elimini il finalizzatore.

    kubectl edit volumeattachment csi-yyyyy
    

    Elimina il completamento:

    [...]
      Finalizers:
       external-attacher/csi-vsphere-vmware-com
    

VolumeSnapshot di CSI vSphere non pronto a causa della versione

Questo problema si verifica quando la versione di vCenter Server o dell'host ESXi precedente alla 7.0 Aggiornamento 3.

L'output di kubectl describe volumesnapshot include errori come quello riportato nell'esempio seguente:

rpc error: code = Unimplemented desc = VC version does not support snapshot operations.

Per risolvere il problema, esegui l'upgrade di vCenter Server e degli host ESXi alla versione 7.0 Update 3 o successiva.

vSphere CSI VolumeSnapshot non pronto, numero massimo di snapshot per volume

Questo problema si verifica quando il numero di snapshot per volume raggiunge il valore massimo per il driver vSphere Container Storage. Il valore predefinito è tre.

L'output di kubectl describe volumesnapshot include gli errori come nell'esempio seguente:

rpc error: code = FailedPrecondition desc = the number of snapshots on the source volume 5394aac1-bc0a-44e2-a519-1a46b187af7b reaches the configured maximum (3)

Per risolvere il problema, segui questi passaggi per aggiornare il numero massimo di snapshot per volume:

  1. Recupera il nome del segreto che fornisce la configurazione di vSphere al controller CSI vSphere:

    kubectl --kubeconfig <var class="edit">ADMIN_CLUSTER_KUBECONFIG</var> get deployment vsphere-csi-controller \
        --namespace <var class="edit">USER_CLUSTER_NAME</var> \
        --output json \
        | jq -r '.spec.template.spec.volumes[] \
        | select(.name=="vsphere-secret") .secret.secretName'
    

    Sostituisci quanto segue:

    • ADMIN_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione
    • USER_CLUSTER_NAME: il nome del cluster utente
  2. Ottieni il valore data.config dal secret, decodificalo in base64 e salvalo in un file denominato config.txt:

    kubectl --kubeconfig <var class="edit">ADMIN_CLUSTER_KUBECONFIG</var> get secret <var class="edit">SECRET_NAME</var> \
        --namespace <var class="edit">USER_CLUSTER_NAME </var> \
        --output json | jq -r '.data["config"]' | base64 -d > config.txt
    

    Sostituisci SECRET_NAME con il nome del secret del passaggio precedente.

  3. Apri config.txt per la modifica:

    Modifica o aggiungi il campo global-max-snapshots-per-block-volume nella sezione [Snapshot], come nell'esempio seguente:

    [Global]
    cluster-id = "my-user-cluster"
    insecure-flag = "0"
    user = "my-account.local"
    password = "fxqSD@SZTUIsG"
    [VirtualCenter "my-vCenter"]
    port = "443"
    datacenters = "my-datacenter1"
    [Snapshot]
    global-max-snapshots-per-block-volume = 4
    
  4. Elimina e ricrea il secret:

    kubectl --kubeconfig <var class="edit">ADMIN_CLUSTER_KUBECONFIG</var> delete secret <var class="edit">SECRET_NAME</var> \
        --namespace <var class="edit">USER_CLUSTER_NAME</var>
    
    kubectl --kubeconfig <var class="edit">ADMIN_CLUSTER_KUBECONFIG</var> create secret generic <var class="edit">SECRET_NAME</var> \
        --namespace <var class="edit">USER_CLUSTER_NAME</var> \
        --from-file=config
    
  5. Riavvia il deployment vsphere-csi-controller:

    kubectl --kubeconfig <var class="edit">ADMIN_CLUSTER_KUBECONFIG</var> rollout restart deployment vsphere-csi-controller \
        --namespace <var class="edit">USER_CLUSTER_NAME</var>
    

Passaggi successivi

Se hai bisogno di ulteriore assistenza, contatta Assistenza clienti Google Cloud.