Esercitazione: Eseguire il backup dei volumi di Azure Files nei cluster AKS

Questa esercitazione illustra come configurare il backup e il ripristino per un cluster del servizio Azure Kubernetes che usa volumi persistenti basati su File di Azure. Backup di Azure per AKS ora supporta il backup di applicazioni con volumi di Condivisione file di Azure (protocollo SMB) insieme ai volumi basati su dischi di Azure e le risorse Kubernetes.

I volumi basati su File di Azure vengono sottoposti a backup come snapshot archiviati insieme alla condivisione file nello stesso account di archiviazione. Questo fornisce operazioni di backup e ripristino veloci per le applicazioni con stato usando condivisioni di file.

In questa esercitazione apprenderai a:

Prerequisiti

Prima di configurare il backup per i cluster AKS con volumi di File di Azure, assicurati che siano soddisfatti i seguenti prerequisiti:

• Un insieme di credenziali di Backup di Azure nella stessa area del cluster AKS.
• Un cluster AKS con driver CSI versione 1.32 o superiore.
• Volumi persistenti basati su File di Azure di cui è stato effettuato il provisioning tramite il driver CSI di Azure Kubernetes (file.csi.azure.com) usando il protocollo SMB.
• Condivisioni file con endpoint di rete accessibili pubblicamente (tipo di endpoint di rete impostato su Tutti).
• Volumi permanenti configurati con i criteri di recupero impostati su Mantieni per garantire che gli snapshot rimangano disponibili anche se il PVC viene eliminato.
• Estensione di backup installata nel cluster AKS.

Impostare i criteri di recupero su Mantieni

Per assicurarsi che gli snapshot di Azure Files rimangano disponibili anche se il PVC viene eliminato, impostare il criterio di ripristino a Mantieni:

kubectl patch pv <your-pv-name> --patch '{"spec":{"persistentVolumeReclaimPolicy":"Retain"}}'

Sostituire <your-pv-name> con il nome del volume permanente. È possibile trovarla eseguendo:

kubectl get pv

Configurare una nuova istanza di backup

Questa sezione illustra come configurare una nuova istanza di backup per il cluster AKS con volumi di Azure Files.

Installare l'estensione backup

Se l'estensione backup non è già stata installata, seguire questa procedura:

1. Nel portale di Azure, vai al cluster AKS.

2. Nel menu delle risorse selezionare Backup in Impostazioni.

3. Selezionare Installa estensione.

4. Specificare un account di archiviazione e un contenitore di blob. Questo contenitore archivia gli YAMls e i log di backup della risorsa Kubernetes.

5. Selezionare Crea e attendere il completamento dell'installazione dell'estensione.

Configurare il backup per il cluster AKS con Azure Files

1. Nel portale di Azure, vai al cluster AKS.

2. Nel menu delle risorse selezionare Backup e quindi selezionare Configura backup.

3. Selezionare un insieme di credenziali di backup nella stessa area del cluster del servizio Azure Kubernetes.

4. Concedere l'accesso attendibile tra il vault di backup e il cluster AKS selezionando Concedi autorizzazione. Assegnare anche i ruoli necessari al vault di backup. Una volta terminato, seleziona Avanti.

   Annotazioni

   Verificare che l'insieme di credenziali di backup sia situato nella stessa area del cluster di Azure Kubernetes Service (AKS).

5. Nella scheda Criteri di backup creare un nuovo criterio di backup o selezionare uno esistente.

   Importante

   • Per i volumi basati su File di Azure, la conservazione dei backup è limitata a 30 giorni al massimo.
   • Il backup del Vault Tier non è supportato per i volumi di Azure Files. Assicurarsi che i criteri di backup includano solo le regole di conservazione del livello operativo.
   • Se è necessario eseguire il backup di volumi di Azure Disk e Azure Files con diverse destinazioni di backup (deposito e snapshot), creare istanze di backup separate, una per ogni tipo di risorsa.

6. Nella scheda Origini dati selezionare Aggiungi/Modifica per definire la configurazione dell'istanza di backup.

7. Nel riquadro Seleziona risorse da eseguire il backup :

   • Configurazione backup: definire le risorse del cluster di cui eseguire il backup.
   • Volumi permanenti: selezionare File di Azure per eseguire il backup dei volumi basati su File di Azure.
   • Segreti: abilitare i segreti di backup se si usano segreti Kubernetes per archiviare le chiavi dell'account di archiviazione (necessarie per le operazioni di ripristino).

   

8. Per Gruppo di risorse snapshot selezionare il gruppo di risorse per archiviare gli snapshot del disco di Azure (obbligatorio anche se si esegue solo il backup dei volumi di File di Azure). Quindi selezionare Convalida.

9. Se la convalida non riesce a causa di autorizzazioni mancanti, selezionare Assegna ruoli mancanti per concedere l'accesso necessario.

10. Al termine della convalida, selezionare Avanti e quindi selezionare Configura backup.

L'istanza di backup viene creata e verrà avviato il backup del cluster del servizio Azure Kubernetes in base ai criteri configurati.

Creare un backup su richiesta

Per creare un backup immediato:

1. Aprire l'istanza di backup creata.

2. Selezionare Backup ora nella parte superiore della pagina.

3. Tenere traccia dello stato di avanzamento del backup nei processi di backup.

4. Al termine del backup, verificare lo snapshot di Azure File.

   1. Passare all'account di archiviazione contenente la condivisione file.
   2. Passare alla condivisione file usata dal volume permanente.
   3. Selezionare Snapshot per visualizzare lo snapshot di backup creato da Backup di Azure.

Verificare la configurazione del backup

Per verificare che venga eseguito il backup dei volumi di File di Azure:

1. Nel portale di Azure andare all'insieme di credenziali di Backup.

2. Selezionare Istanze di backup in Gestisci.

3. Trova l'istanza di backup del tuo cluster AKS e verifica che il suo stato mostri Backup in corso o Pronto.

4. Selezionare Processi di backup per visualizzare le operazioni di backup completate e in corso.

Modificare un'istanza di backup esistente

Questa sezione illustra come modificare un'istanza di backup esistente e avviare il backup dei volumi permanenti basati su File di Azure.

Modificare la configurazione della protezione

1. Nel portale di Azure andare all'insieme di credenziali di Backup.

2. Selezionare Istanze di backup in Gestisci.

3. Trovare l'istanza di backup del cluster AKS, aprirla e fare clic su Modifica istanza di backup in alto.

   

4. Nella nuova schermata sono disponibili opzioni per modificare i criteri di backup, l'identità gestita usata dall'insieme di credenziali di backup e la configurazione dell'istanza di backup. Fare clic su Seleziona nella sezione Modifica istanza di backup

   

5. Nel riquadro laterale destro, per includere volumi basati su file di cui eseguire il backup, aprire l'elenco a discesa Seleziona tipi di volume e selezionare la casella di controllo per Condivisioni file SMB di Azure. Selezionare anche la casella di controllo Includi segreti. È possibile usare questo riquadro per aggiornare qualsiasi altra configurazione di backup esistente, incluse le etichette. Fare quindi clic su Seleziona.

   

6. Dopo aver aggiornato la configurazione del backup, fare clic su Convalida per assicurarsi che siano soddisfatti tutti i prerequisiti per l'uso di File di Azure. Se mancano ruoli obbligatori per l'identità del Backup vault, verrà visualizzato un errore di assegnazione di ruolo. Se si dispone delle autorizzazioni necessarie per le risorse pertinenti, è possibile risolverlo facendo clic su Concedi autorizzazioni.

7. Fare clic su Applica per completare la modifica della configurazione dell'istanza di backup.

Ripristinare i volumi di File di Azure

Backup di Azure per il servizio Azure Kubernetes consente di ripristinare i volumi persistenti basati su File di Azure da qualsiasi punto di ripristino. È possibile eseguire il ripristino nel cluster originale o in un cluster alternativo all'interno della stessa sottoscrizione e area.

Eseguire il ripristino nel cluster originale

Questo scenario è utile quando lo spazio dei nomi dell'applicazione, il PVC sottostante o i file all'interno della condivisione di file sono stati eliminati ed è necessario ripristinarli, ma gli snapshot originali esistono ancora.

1. Prima di avviare il ripristino, se il PVC esiste ancora nel cluster, eliminarlo:

   kubectl delete pvc <pvc-name> -n <namespace>
   

2. Nel portale di Azure andare all'insieme di credenziali di Backup.

3. Selezionare Istanze di backup in Gestisci e quindi selezionare l'istanza di backup del cluster del servizio Azure Kubernetes.

4. Selezionare Ripristina nella parte superiore della pagina.

5. Nella pagina Seleziona punto di ripristino scegliere il punto di ripristino da cui si vuole eseguire il ripristino in base all'ora di creazione. Per impostazione predefinita, il punto di ripristino più recente è selezionato. Seleziona Avanti.

6. Nella pagina Ripristina parametri :

   • Cluster di destinazione: selezionare il cluster del servizio Azure Kubernetes originale.
   • Configurazione di ripristino: definire le risorse da ripristinare. È possibile selezionare spazi dei nomi specifici o ripristinare tutte le risorse di cui è stato eseguito il backup.
   • Gestione dei conflitti: scegliere Ignora per ignorare le risorse già esistenti nel cluster (opzione predefinita).

7. Selezionare Convalida per verificare se sono presenti tutte le autorizzazioni necessarie.

8. Se viene visualizzato un errore di convalida per i ruoli mancanti, selezionare Assegna ruoli mancanti per concedere le autorizzazioni necessarie. Al termine, selezionare Riconvalida.

   Annotazioni

   Il cluster AKS di destinazione deve avere il ruolo Contributore privilegiato ai dati dei file di archiviazione sull'account di archiviazione che ospita le condivisioni di file per eseguire operazioni di ripristino.

9. Al termine della convalida, selezionare Avanti e quindi selezionare Ripristina.

10. Tenere traccia dello stato di avanzamento del ripristino in Processi di ripristino nell'istanza di backup.

Ripristinare in un cluster alternativo

È possibile ripristinare il backup in un cluster del servizio Azure Kubernetes diverso all'interno della stessa sottoscrizione e area.

1. Seguire la stessa procedura del ripristino nel cluster originale, ma selezionare un cluster di destinazione diverso nella pagina Parametri di ripristino .

2. Assicurarsi che il cluster di destinazione:

   • L'estensione backup è installata.
   • L'accesso attendibile è stato abilitato nell'insieme di credenziali di Backup.
   • Ha il ruolo Collaboratore privilegiato per i dati dei file di archiviazione assegnato sull'account di archiviazione (per i volumi con provisioning statico, questo deve essere assegnato manualmente).

3. Completare il processo di convalida e ripristino come descritto nella sezione precedente.

Eseguire il ripristino con la classe di archiviazione personalizzata

Se si vuole eseguire il ripristino in un cluster alternativo e modificare la classe di archiviazione dell'attestazione del volume permanente, è possibile usare un oggetto ConfigMap del modificatore di risorse.

1. Creare un file YAML per l'oggetto ConfigMap del modificatore di risorse:

   version: v1
   resourceModifierRules:
     - conditions:
         groupResource: persistentvolumeclaims
       patches:
         - operation: replace
           path: "/spec/storageClassName"
           value: "azurefile-csi-premium"
   

   Sostituire azurefile-csi-premium con il nome della classe di archiviazione desiderata.

2. Distribuire ConfigMap nel cluster di destinazione:

   kubectl create cm <configmap-name> --from-file=<path-to-yaml-file> -n <namespace>
   

   Per esempio:

   kubectl create cm resource-modifier-configmap --from-file=resource-modifier.yaml -n dataprotection-microsoft
   

3. Durante il processo di ripristino, nella sezione Configurazione di ripristino fare riferimento a questo ConfigMap in Modificatore risorse.

4. La classe di archiviazione dei pvC ripristinati verrà sostituita con il valore specificato.

Considerazioni per i volumi con provisioning statico

Se si esegue il ripristino dei volumi di File di Azure con provisioning statico (creati manualmente anziché dinamicamente dal cluster):

• Assicurarsi di aver eseguito il backup dei segreti Kubernetes usati per accedere alle condivisioni file. Abilitare i segreti di backup nella configurazione di backup.

• Assegnare manualmente il ruolo Collaboratore con privilegi per i dati dei file di archiviazione al cluster AKS di destinazione nell'account di archiviazione in cui si trovano o verranno ripristinate le condivisioni file.

• Verificare che la condivisione file esista nell'account di archiviazione prima di tentare il ripristino o che l'operazione di ripristino non riesca.

Verificare il completamento del ripristino

Al termine dell'operazione di ripristino:

1. Verificare che le risorse siano state ripristinate nel cluster di destinazione:

   kubectl get pods -n <namespace>
   kubectl get pvc -n <namespace>
   kubectl get pv
   

2. Verificare che l'applicazione possa accedere ai dati ripristinati connettendosi al pod e verificando la condivisione file montata:

   kubectl exec -it <pod-name> -n <namespace> -- ls /mnt/azure
   

3. Verificare che lo snapshot della condivisione file sia ancora disponibile nell'account di storage per i ripristini futuri.

Pulire le risorse

Se sono state create risorse per questa esercitazione che non sono più necessarie, è possibile pulirle:

1. Eliminare l'istanza di backup dal caveau di backup se non si ha più bisogno di conservare i backup.
2. Interrompere la protezione del cluster AKS se i backup regolari non proseguono.
3. Rimuovere l'estensione backup dal cluster del servizio Azure Kubernetes se non è più necessaria la funzionalità di backup.

Passaggi successivi

Dopo aver appreso come configurare il backup e il ripristino per i cluster AKS con volumi di Azure Files, puoi esplorare:

Contenuti correlati

• Comprendere i concetti di backup di AKS
• Gestire i backup del cluster AKS
• Risolvere i problemi relativi al backup del servizio Azure Kubernetes