Resolver problemas de erros de armazenamento no Backup para GKE

Nesta página, descrevemos erros relacionados ao armazenamento que podem ocorrer ao usar o Backup para GKE, o que considerar ao realizar a ação e as etapas para resolver o problema.

Erro 100010105: falha ao fazer backup do PersistentVolumeClaim. O disco referenciado pelo PersistentVolume não existe.

O erro 100010105 ocorre quando uma tentativa de fazer backup de um PersistentVolumeClaim falha porque faz referência a um disco que não existe, resultando em uma mensagem de erro informando Failed to backup PersistentVolumeClaim - Disk referenced by PersistentVolume does not exist.

No Google Kubernetes Engine, PersistentVolumeClaims solicita armazenamento de PersistentVolumes. Um PersistentVolume, por sua vez, representa uma parte do armazenamento, geralmente um disco permanente do Compute Engine. Um erro pode ocorrer quando um PersistentVolumeClaim é vinculado a um PersistentVolume e a configuração do PersistentVolume especifica um disco permanente do Compute Engine. No entanto, o disco real com o nome e o local especificados na configuração PersistentVolume não pode ser encontrado no projeto Google Cloud . Assim, o Backup para GKE não pode fazer backup de um disco inexistente, e ocorre uma falha.

Para resolver esse erro, siga estas instruções:

  1. Identifique o PersistentVolumeClaim e o PersistentVolume problemáticos. Os nomes do PersistentVolumeClaim problemático e do PersistentVolume associado estão listados no campo state reason da operação com falha do Backup para GKE. Recomendamos documentar o nome do PersistentVolumeClaim, o namespace dele e o nome do PersistentVolume.

  2. Inspecione o PersistentVolume. Para descrever o PersistentVolume, use o nome PersistentVolume identificado no campo "Motivo do estado" no comando a seguir:

    kubectl describe pv PERSISTENTVOLUME_NAME

    Substitua PERSISTENTVOLUME_NAME pelo nome do PersistentVolume.

  3. Na saída, examine a seção source, especificamente em csi. Esta seção descreve o VolumeHandle que o PersistentVolume está tentando referenciar. Exemplo:

    Source:
  Type: GCEPersistentDisk (a Persistent Disk resource in Google Compute Engine)
PDName: my-non-existent-disk
FSType: ext4
Partition: 0
ReadOnly: false
            In this example, the PD name is my-non-existent-disk.

    Source:
  Type:       CSI (a Container Storage Interface (CSI) volume)
  Driver:     pd.csi.storage.gke.io
  VolumeHandle: projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
...

    Neste exemplo, VolumeHandle contém o caminho completo para o disco, incluindo o nome e o local. Por exemplo, projects/my-gcp-project/zones/us-central1-a/disks/my-disk-name.

  4. Use o VolumeHandle obtido na descrição PersistentVolume para identificar o nome e a zona do disco.

  5. Verifique se o disco existe no projeto Google Cloud usando um dos seguintes métodos:

    Disco zonal

    Se você estiver usando um disco zonal, use a Google Cloud CLI para executar o comando gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME \
    --zone=ZONE_NAME \
    --project=PROJECT_ID

    Substitua:

    • DISK_NAME: o nome do disco que você recebeu na descrição PersistentVolume.

    • ZONE_NAME: a zona do disco que você obteve na descrição PersistentVolume.

    • PROJECT_ID: o ID do projeto Google Cloud .

    Disco regional

    Se você estiver usando um disco regional, use a Google Cloud CLI para executar o comando gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME \
    --region=REGION_NAME \
    --project=PROJECT_ID

    Substitua:

    • DISK_NAME: o nome do disco que você recebeu na descrição PersistentVolume.

    • REGION_NAME: a região do disco que você extraiu da descrição de PersistentVolume.

    • PROJECT_ID: o ID do projeto Google Cloud .

    Se você receber uma mensagem de erro Resource not found ou The resource DISK_NAME was not found, o disco não existe. Use um dos seguintes métodos para resolver o problema, dependendo do cenário que melhor atende às suas necessidades:

    • Se o disco foi excluído ou nomeado incorretamente por engano e você quer manter os dados ou PersistentVolumeClaim, ou se o PersistentVolume foi configurado com um nome de disco incorreto, use um dos seguintes métodos para resolver o problema:

      • Restaure o disco: se você tiver um backup, restaure-o com o mesmo nome e local que o PersistentVolume referencia.

      • Crie um novo disco: se não for possível restaurar o disco, crie um novo com o mesmo nome e local da configuração PersistentVolume.

    • Se o PersistentVolumeClaim ou PersistentVolume, os dados deles ou o aplicativo não forem mais necessários, recomendamos remover a entidade desnecessária:

      • Exclua o PersistentVolumeClaim: exclua o PersistentVolumeClaim usando a ferramenta de linha de comando kubectl para executar o comando kubectl delete pvc:
      kubectl delete pvc PVC_NAME -n NAMESPACE

      Substitua:

      • PVC_NAME: o nome do PersistentVolumeClaim que você quer excluir.

      • NAMESPACE: o namespace do PersistentVolumeClaim que você quer excluir.

    • O PersistentVolume ainda está presente depois que você exclui o PersistentVolumeClaim: se o PersistentVolumeReclaimPolicy do PersistentVolume estiver definido como Delete, o PersistentVolume será excluído automaticamente quando o PersistentVolumeClaim for excluído. Se o persistentVolumeReclaimPolicy estiver definido como Retain, será necessário excluir manualmente o PersistentVolume depois que o PersistentVolumeClaim for excluído. Para excluir o PersistentVolume, use a ferramenta de linha de comando kubectl para executar o comando kubectl delete pv:

      kubectl delete pv PV_NAME

      Substitua PV_NAME pelo nome do PersistentVolume que você quer excluir.

Se a operação continuar falhando, entre em contato com o Cloud Customer Care para receber mais ajuda.