Risolvere i problemi relativi agli errori di sistema in Backup per GKE

Questa pagina descrive gli errori relativi al sistema che potresti riscontrare quando utilizzi Backup per GKE, gli aspetti da considerare quando esegui il backup delle risorse e i passaggi per risolvere il problema.

Errore 100020102: modalità permissiva rigorosa - Impossibile eseguire il backup di CRD - Versione API v1beta1 non supportata

L'errore 100020102 si verifica quando un tentativo di backup di un CustomResourceDefinition originariamente applicato come versione apiextensions.k8s.io/v1beta1 non riesce perché non dispone dello schema strutturale richiesto nella versione dell'API apiextensions.k8s.io/v1. Questo errore genera il seguente messaggio di errore: Strict permissive mode - Failed to backup CRD - Unsupported v1beta1 API Version.

Questo errore si verifica perché la versione dell'API apiextensions.k8s.io/v1 è stata rimossa nella versione 1.22 di Google Kubernetes Engine. Per saperne di più sulla rimozione delle API per GKE versione 1.22, consulta Rimozioni di API per GKE v1.22.

Comportamento dell'operazione di backup in modalità non permissiva

In modalità non permissiva o in un piano di backup rigoroso, l'operazione di backup non va a buon fine se rileva una risorsa di cui non è possibile eseguire il backup, ad esempio un CustomResourceDefinition creato con l'API v1beta1. Questo errore si verifica perché la risorsa non dispone dello schema strutturale richiesto dall'API v1. La presenza di questo CustomResourceDefinition è considerata un errore critico perché potrebbe non essere ripristinato correttamente in un cluster più recente.

Per risolvere questo errore, segui queste istruzioni:

  1. Identifica il CustomResourceDefinition problematico eseguendo il comando kubectl get crd:

    kubectl get crd CRD_NAME

    Sostituisci CRD_NAME con il nome di CustomResourceDefinition del messaggio di errore.

  2. Nell'output YAML, verifica se CustomResourceDefinition è stato convertito correttamente dall'API vbeta1 all'API v1 individuando le seguenti condizioni:

    1. spec.versions: individua la condizione spec.versions esaminando ogni versione elencata nel campo spec.versions. Se in uno dei spec.versions manca il campo schema.openAIV3Schema, CustomResourceDefinition non ha uno schema strutturale definito per quella versione.

    2. status.conditions: individua la condizione status.conditions trovando la condizione type:NonStructuralSchema. Se il status.conditions's status è true, conferma esplicitamente che lo schema non è strutturale.

  3. Esegui l'upgrade di CustomResourceDefinition alla versione dell'API v1 seguendo i seguenti passaggi:

    1. Modifica il CustomResourceDefinition esistente per renderlo compatibile con lo standard v1 aggiungendo uno schema strutturale che definisca ogni campo e il relativo tipo all'interno della risorsa personalizzata. Per saperne di più su come aggiungere uno schema strutturale, consulta Specificare uno schema strutturale.

    2. Applica il manifest v1 compatibile al tuo cluster.

  4. Se l'upgrade va a buon fine, riprova l'operazione di backup. In caso contrario, utilizza uno dei seguenti metodi per risolvere il problema:

    • Elimina CustomResourceDefinition eseguendo il comando kubectl delete crd se CustomResourceDefinition non viene utilizzato nel cluster.

      kubectl delete crd CRD_NAME

      Sostituisci CRD_NAME con il nome del CustomResourceDefinitionche vuoi eliminare.

    • Attiva la modalità permissiva nel piano di backup, che consente a Backup per GKE di ignorare la risorsa, incluso CustomResourceDefinitions nella versione dell'API v1beta1, e di continuare con il resto dell'operazione di backup. Per ulteriori informazioni su come attivare la modalità permissiva, vedi Attivare la modalità permissiva su un piano di backup.

  5. Riprova a eseguire l'operazione di backup. Se l'operazione continua a non riuscire, contatta l'assistenza clienti Google Cloud per ulteriore assistenza.

Errore 100040102: Spazio dei nomi non trovato

L'errore 100040102 si verifica quando un tentativo di eseguire un'operazione di backup non va a buon fine perché non è possibile trovare uno spazio dei nomi specificato nell'ambito del backup all'interno del cluster. L'agente Backup per GKE non è riuscito a individuare uno o più spazi dei nomi elencati esplicitamente nel campo selectedNamespaces della configurazione BackupPlan. Backup per GKE richiede che tutti gli spazi dei nomi specificati siano presenti nel cluster al momento dell'avvio dell'operazione di backup. Se non viene trovato lo spazio dei nomi, viene visualizzato il seguente messaggio di errore:

Namespace [NAMESPACE_NAME] is not found.

Per risolvere il problema, segui queste istruzioni:

  1. Verifica che lo spazio dei nomi sia stato inserito correttamente controllando l'elenco selectedNamespaces nella configurazione di BackupPlan.

  2. Verifica che lo spazio dei nomi segnalato nel messaggio di errore esista eseguendo il comando kubectl get namespace:

    kubectl get namespace NAMESPACE_NAME

    Sostituisci NAMESPACE_NAME con il nome dello spazio dei nomi segnalato nel messaggio di errore.

    Se lo spazio dei nomi non esiste, viene visualizzato un messaggio che indica che lo spazio dei nomi non è stato trovato, ad esempio Error from server (NotFound): namespaces "[NAMESPACE_NAME]" not found.

  3. Correggi BackupPlan. Se lo spazio dei nomi è scritto in modo errato, aggiorna BackupPlan con il nome corretto. Se lo spazio dei nomi non esiste più e non deve essere sottoposto a backup, rimuovilo dall'elenco selectedNamespaces nella configurazione BackupPlan.

  4. Riprova l'operazione di backup dopo aver apportato le correzioni necessarie al BackupPlan e avvia un nuovo backup.

Se l'operazione continua a non riuscire, contatta l'assistenza clienti Google Cloud per ulteriore assistenza.

Passaggi successivi