Eseguire il backup e il ripristino dell'app nel Servizio app di Azure

È possibile ripristinare facilmente i backup delle app nel Servizio app di Azure. È anche possibile eseguire backup personalizzati su richiesta o configurare backup personalizzati pianificati. Per ripristinare un backup, è sufficiente sovrascrivere un'app esistente ripristinando una nuova app o uno slot. Questo articolo mostra come ripristinare un backup ed eseguire backup personalizzati.

Il backup e il ripristino sono supportati nei livelli Basic, Standard, Premium e Isolato. Per il livello Basic, è possibile eseguire il backup e il ripristino solo dello slot di produzione. Per altre informazioni sul ridimensionamento del piano di servizio app per usare un livello superiore, vedere Scalare un'app Web in Servizio app di Azure.

Nota

Per gli ambienti con Servizio app:

  • I backup automatici possono essere ripristinati in un'app di destinazione all'interno dell'ambiente del Servizio app stesso, non in un altro ambiente del Servizio app.
  • I backup personalizzati possono essere ripristinati in un'app di destinazione in un altro ambiente del Servizio app, ad esempio dall'ambiente del Servizio app v2 all'ambiente del Servizio app v3.
  • I backup possono essere ripristinati nell'app di destinazione disponibile nella stessa piattaforma del sistema operativo dell'app di origine.

Differenze tra backup, ripristino e ripristino di emergenza

Piattaforma Linee guida per il backup e il ripristino Indicazioni sul ripristino di emergenza
App Web del servizio app
(Piano tariffario gratuito e condiviso)
Se sono state distribuite applicazioni Web nel livello Gratuito o Condiviso e si richiede l'accesso alle funzionalità di backup e ripristino per tali app Web, passare al livello Basic o superiore. Ripristinare online le risorse del Servizio app in un'area di Azure diversa durante un'emergenza regionale.

A partire dal 31 marzo 2025, le applicazioni del Servizio app non verranno inserite in modalità di ripristino di emergenza durante un'emergenza in un'area di Azure, come indicato nell'articolo 0Ripristino da un errore a livello regionale. È consigliabile implementare le tecniche di ripristino di emergenza comunemente usate per evitare tempi di inattività e perdita di dati durante un'emergenza a livello regionale.
App Web del servizio app
(Piano tariffario Basic\Standard\Premium)
Nel Servizio app di Azure è possibile eseguire backup personalizzati su richiesta usare i backup automatici. Per ripristinare un backup, è sufficiente sovrascrivere un'app esistente ripristinando una nuova app o uno slot.

Per altre informazioni, vedere Backup e ripristino dell'app nel Servizio app di Azure.
Le indicazioni correnti su come riportare online le risorse del Servizio app in un'area di Azure diversa durante un'emergenza a livello regionale sono disponibili in Ripristino da un errore a livello regionale - Servizio app di Azure.

A partire dal 31 marzo 2025, le applicazioni Web del Servizio app di Azure non verranno più inserite in modalità di ripristino di emergenza durante un'emergenza in un'area di Azure, come illustrato nell'articoloRipristino da un errore a livello regionale. È consigliabile implementare le tecniche di ripristino di emergenza di uso comune per evitare la perdita di funzionalità o dati per le app Web in caso di emergenza a livello regionale.
Ambiente del Servizio app (V2 e V3) Nell’ambiente del Servizio app di Azure è possibile eseguire backup personalizzati su richiesta o usare i backup automatici. I backup automatici possono essere ripristinati in un'app di destinazione all'interno dello stesso ambiente del Servizio app, non in un altro ambiente del Servizio app. I backup personalizzati possono essere ripristinati in un'app di destinazione in un altro ambiente del Servizio app ( ad esempio da un ambiente del Servizio app V2 a un ambiente del Servizio app V3). I backup possono essere ripristinati nell'app di destinazione disponibile nella stessa piattaforma del sistema operativo dell'app di origine.

Per informazioni più dettagliate, vedere Backup e ripristino dell'app nel Servizio app di Azure.
È consigliabile implementare le linee guida per il ripristino di emergenza per le app Web distribuite nell'ambiente del Servizio app usando le tecniche di ripristino di emergenza di uso comune.
Funzioni di Azure:
Piano dedicato
Quando si esegue l'app per le funzioni in un piano dedicato (Servizio app), il contenuto dell'app per le funzioni richiesto viene mantenuto usando l'archiviazione predefinita. In un piano dedicato è possibile eseguire backup personalizzati su richiesta o usare backup automatici. Per ripristinare un backup, è sufficiente sovrascrivere un'app esistente ripristinando una nuova app o uno slot.

Per altre informazioni, vedere Backup e ripristino dell'app nel Servizio app di Azure.

File di Azure non viene usato in un piano dedicato. Tuttavia, se l'app non è stata configurata correttamente con una connessione a File di Azure, il backup non è supportato.
Le linee guida correnti su come portare online le risorse dell'app per le funzioni in un piano dedicato in un'area di Azure diversa durante un'emergenza regionale sono disponibili in Ripristino da un errore a livello regionale - Servizio app di Azure.

A partire dal 31 marzo 2025, le applicazioni del Servizio app non verranno inserite in modalità di ripristino di emergenza durante un'emergenza in un'area di Azure, come indicato nell'articolo 0Ripristino da un errore a livello regionale. È invece consigliabile pianificare l'affidabilità nelle app per le funzioni.

È anche possibile fare riferimento alle tecniche di ripristino di emergenza comunemente usate per le app per le funzioni in un piano dedicato.
Funzioni di Azure:
A consumo Flex,
Piani A consumo e Premium
Le app per le funzioni eseguite in un piano a consumo flessibile, in un piano a consumo o in un piano Premium non possono usare funzionalità di backup personalizzate e automatiche nel Servizio app. In questi piani di scalabilità dinamica il contenuto dell'app per le funzioni viene gestito in Archiviazione di Azure. Usare le opzioni di ridondanza di Archiviazione di Azure per assicurarsi che l'account di archiviazione soddisfi le destinazioni di disponibilità e durabilità durante un'interruzione.

È anche possibile scaricare il progetto di app per le funzioni esistente come file .zip dal portale di Azure.
È consigliabile pianificare l'affidabilità nelle app per le funzioni.

Differenze tra backup automatici e personalizzati

Il Servizioi app offre due tipi di backup. Backup automatici dell’app eseguiti regolarmente, purché il piano tariffario sia supportato. I backup personalizzati richiedono una configurazione iniziale e possono essere eseguiti su richiesta o in base a una pianificazione. La tabella seguente illustra le differenze tra i due tipi di backup.

Funzionalità Backup automatici Backup personalizzati
Piani tariffari Basic, Standard, Premium, Isolato. Basic, Standard, Premium, Isolato.
Configurazione necessaria No. Sì.
Dimensione backup 30 GB. 10 GB, di cui 4 GB si possono riferire al database collegato.
Database collegato Nessun backup eseguito. È possibile eseguire il backup dei seguenti database collegati: Database SQL, Database di Azure per MySQL, Database di Azure for PostgreSQL, MySQL in-app.
Account di archiviazione obbligatorio No. Sì.
Frequenza di backup Orario, non configurabile. Configurabile.
Conservazione 30 giorni, con configurabile.
- Giorni da 1 a 3: backup orari conservati.
- Giorni da 4 a 14: ogni terzo backup orario conservato.
- Giorni da 15 a 30: ogni sesto backup orario conservato.
0-30 giorni o indefiniti.
Scaricabile No. Sì, come BLOB di archiviazione di Azure.
Backup parziali Non supportato. Supportata.
Backup su rete virtuale Non supportato. Supportata.

Ripristinare un backup

Nota

Il Servizio app arresta l'app di destinazione o lo slot di destinazione durante il ripristino del backup. Per ridurre al minimo i tempi di inattività per l'app di produzione, ripristinare prima il backup in uno slot di distribuzione e quindi passare all'ambiente di produzione.

  1. Nel menu a sinistra della pagina di gestione delle app del portale di Azure selezionare Backup. La pagina Backup elenca tutti i backup automatici e personalizzati per l'app e lo stato di ognuno.

    Screenshot che mostra come aprire la pagina dei backup.

  2. Selezionare il backup automatico o personalizzato da ripristinare selezionando il collegamento Ripristina.

    Screenshot che mostra come selezionare il collegamento di ripristino.

  3. La sezione Dettagli backup viene popolata automaticamente.

  4. Specificare la destinazione di ripristino in Scegliere una destinazione. Per eseguire il ripristino in una nuova app, selezionare Crea nuovo nella casella Servizio app. Per eseguire il ripristino in un nuovo slot di distribuzione, selezionare Crea nuovo nella casella Slot di distribuzione.

    Se si sceglie uno slot esistente, tutti i dati esistenti nel relativo file system vengono cancellati e sovrascritti. Lo slot di produzione ha lo stesso nome dell'app.

  5. È possibile scegliere di ripristinare la configurazione del sito selezionando Opzioni avanzate.

  6. Selezionare Ripristina.

Creare un backup personalizzato

  1. Nel menu a sinistra della pagina di gestione delle app del portale di Azure selezionare Backup.

    Screenshot che mostra come aprire la pagina dei backup.

  2. Nella parte superiore della pagina Backup selezionare Configura backup personalizzati.

  3. In Account di archiviazione selezionare un account di archiviazione esistente (nella stessa sottoscrizione) o selezionare Crea nuovo. Eseguire la stessa operazione con Contenitore.

    Per eseguire backup dei database collegati, selezionare Avanti: Avanzate>Includi database e selezionare i database da includere nel backup.

    Nota

    Per visualizzare un database supportato in questo elenco, deve essere disponibile la relativa stringa di connessione nella sezione Stringhe di connessione della pagina Configurazione per l'app.

    Il backup dei database MySQL in-app viene eseguito sempre senza alcuna configurazione. Se si modificano manualmente le impostazioni dei database MySQL in-app, ad esempio si aggiungono stringhe di connessione, è possibile che i backup non vengano eseguiti correttamente.

  4. Seleziona Configura.

    Dopo avere configurato l'account di archiviazione e il contenitore è possibile avviare un backup su richiesta in qualsiasi momento. I backup su richiesta vengono conservati a tempo indeterminato.

  5. Nella parte superiore della pagina Backup selezionare Esegui backup ora.

    Screenshot che mostra come eseguire un backup su richiesta.

    Il backup personalizzato viene visualizzato nell'elenco con un indicatore di stato. Se si verifica un errore, è possibile selezionare l'elemento della riga per visualizzare il messaggio di errore.

Configurare backup pianificati personalizzati

  1. Nella pagina Configura backup personalizzati selezionare Imposta pianificazione.

  2. Configurare la pianificazione del backup in base alle esigenze e selezionare Configura.

Eseguire il backup e il ripristino di un database collegato

I backup personalizzati possono includere database collegati (tranne nei casi in cui il backup è configurato tramite una rete virtuale di Azure). Per assicurarsi che il backup includa un database collegato, eseguire le operazioni seguenti:

  1. Assicurarsi che il database collegato sia supportato.
  2. Creare una stringa di connessione che punta al database. Un database viene considerato "collegato" all'app quando è presente una stringa di connessione valida nella configurazione dell'app.
  3. Seguire la procedura descritta in Creare un backup personalizzato per selezionare il database collegato nella scheda Avanzate.

Per ripristinare un database incluso in un backup personalizzato:

  1. Seguire la procedura descritta in Ripristinare un backup.
  2. In Opzioni avanzateselezionare Includi database.

Per informazioni sulla risoluzione dei problemi, vedere Perché il database collegato non è incluso nel backup.

Eseguire il backup e il ripristino tramite la rete virtuale di Azure

I backup personalizzati permettono di eseguire il backup dei file e dei dati di configurazione dell'app in un account di archiviazione protetto dal firewall se vengono soddisfatti i requisiti seguenti:

Per eseguire il backup e il ripristino tramite la rete virtuale di Azure:

  1. Per configurare backup personalizzati, selezionare Backup/ripristino tramite l'integrazione della rete virtuale.
  2. Salvare le impostazioni selezionando Configura.

Se la casella di controllo non viene visualizzata o risulta disabilitata, verificare che le risorse soddisfino i requisiti.

Dopo aver salvato la configurazione, tutti i backup manuali, pianificati o ripristini vengono eseguiti tramite la rete virtuale. Se si apportano modifiche all'app, alla rete virtuale o all'account di archiviazione che impediscono all'app di accedere all'account di archiviazione tramite la rete virtuale, le operazioni di backup o ripristino si concludono con un esito negativo.

Configurare i backup parziali

I backup parziali sono supportati per i backup personalizzati ma non per quelli automatici. In alcuni casi non si vuole eseguire il backup di tutti gli elementi dell'app. Ecco alcuni esempi:

  • Si configurano backup settimanali dell'app che contiene contenuto statico che non cambia mai, ad esempio immagini o post di blog precedenti.
  • L'app include oltre 10 GB di contenuto, ovvero la quantità massima di cui è possibile eseguire il backup ogni volta.
  • Non si vuole eseguire il backup dei file di log.

Per escludere cartelle e file da archiviare nei backup futuri, creare un file _backup.filter nella cartella%HOME%\site\wwwroot dell'app. Specificare l'elenco di file e cartelle da escludere in questo file.

Suggerimento

È possibile accedere ai file passando a https://<app-name>.scm.azurewebsites.net/DebugConsole. Se richiesto, accedere all'account di Azure.

Identificare le cartelle da escludere dai backup. Ad esempio, si vuole applicare un filtro per la cartella e i file evidenziati.

Screenshot che mostra i file e le cartelle da escludere dai backup.

Creare un file denominato _backup.filter e inserire l'elenco precedente nel file, ma rimuovere la radice %HOME%. Elencare una directory o un file per ogni riga. Il contenuto del file dovrebbe essere analogo al seguente:

\site\wwwroot\Images\brand.png
\site\wwwroot\Images\2014
\site\wwwroot\Images\2013

Caricare il file _backup.filter nella directory D:\home\site\wwwroot\ del sito usando ftp o qualsiasi altro metodo. È anche possibile creare il file direttamente usando il comando DebugConsole in Kudu e inserire i contenuti nel file.

Eseguire i backup seguendo la normale procedura; personalizzati su richiesta o personalizzati pianificati. Eventuali file e cartelle specificati in _backup.filter verranno esclusi dai futuri backup.

Nota

_backup.filter modifica la modalità di ripristino. Senza _backup.filter, il ripristino di un backup elimina tutti i file esistenti nell'app e li sostituisce con i file nel backup. Con _backup.filter, qualsiasi contenuto nel file system dell'app incluso in _backup.filter viene mantenuto (non eliminato).

Modalità di archiviazione dei backup

Dopo l'esecuzione di uno o più backup per l'app, i backup vengono visualizzati nella pagina Contenitori dell'account di archiviazione insieme all'app. Nell'account di archiviazione ogni backup è costituito da un file con estensione .zip contenente i dati di backup e un file con estensione .xml contenente un manifesto dei contenuti del file con estensione .zip. È possibile decomprimere e sfogliare questi file se si vuole accedere ai backup senza eseguire effettivamente un ripristino delle app.

Il backup del database per l'app viene archiviato nella radice del file con estensione zip. Per un database SQ, si tratta di un file BACPAC (senza estensione) che può essere importato. Per informazioni su come creare un database nel database SQL di Azure in base all'esportazione del file BACPAC, vedere Importare un file BACPAC per creare un database nel database SQL di Azure.

Avviso

La modifica di qualsiasi file nel contenitore websitebackups può danneggiare il backup rendendolo non valido e dunque non ripristinabile.

Messaggi di errore

La pagina Backup visualizza lo stato di ogni backup. Per visualizzare i dettagli del log relativi ai backup non riusciti, selezionare la rispettiva voce nell'elenco. Usare la tabella seguente per risolvere i problemi relativi al backup. Se l'errore non è documentato nella tabella, aprire un ticket di supporto.

Error Fix
Non è stato possibile accedere allo spazio di archiviazione. Eliminare la pianificazione del backup e riconfigurarla. In alternativa, riconfigurare l'archiviazione del backup.
Le dimensioni del sito Web e del database superano il limite di {0} GB per i backup. Le dimensioni del contenuto sono {1} GB. Escludere alcuni file dal backup o rimuovere la parte del database del backup e usare i backup offerti esternamente.
Errore durante la connessione al database {0} nel server {1}: l'autenticazione con l'host '{1}' per l'utente '<username>' con il metodo 'mysql_native_password' non è riuscita e viene visualizzato il messaggio: Database '<db-name>' sconosciuto. Aggiornare la stringa di connessione del database.
Non è possibile risolvere {0}. {1} (CannotResolveStorageAccount) Eliminare la pianificazione del backup e riconfigurarla.
Accesso dell'utente {0} non riuscito. Aggiornare la stringa di connessione di database.
La creazione di una copia del database di {0} ({1}) ha generato un'eccezione. Impossibile creare la copia del database. Specificare un utente amministratore nella stringa di connessione.
L'entità server "<name>” non è in grado di accedere al database "master" nel contesto di sicurezza corrente. Impossibile aprire il database "master" richiesto dall'account di accesso. Accesso non riuscito. Accesso dell’utente '<name>' non riuscito. Specificare un utente amministratore nella stringa di connessione.
Si è verificato un errore di rete o specifico dell'istanza mentre veniva stabilita la connessione a SQL Server. Il server non è stato trovato o non è accessibile. Verificare che il nome dell'istanza sia corretto e che il server sia configurato in modo da consentire connessioni remote. (provider: provider named pipe, errore: 40 - Impossibile aprire una connessione a SQL Server). Controllare se la stringa di connessione è valida. Consentire gli indirizzi IP in uscita dell'app nelle impostazioni del server di database.
Impossibile aprire il server '<name>' richiesto dall'account di accesso. Accesso non riuscito. Controllare se la stringa di connessione è valida.
Parametri obbligatori mancanti per una firma di accesso condiviso valida. Eliminare la pianificazione del backup e riconfigurarla.
SSL connection is required. Specificare le opzioni SSL e riprovare quando si tenta di connettersi. La connettività SSL a Database di Azure per MySQL e Database di Azure per PostgreSQL non è supportata per i backup del database. Usare invece la funzionalità di backup nativa nel rispettivo database.

Automatizzazione con gli script

È possibile automatizzare la gestione backup con gli script, usando l'interfaccia della riga di comando di Azure o Azure PowerShell.

Per qualche esempio vedere:

Domande frequenti

I backup sono aggiornamenti incrementali o backup completi?

Ciascun backup è una copia offline completa dell'app, non un aggiornamento incrementale.

Funzioni di Azure supporta i backup automatici?

I backup automatici sono disponibili per Funzioni di Azure in livelli dedicati (Servizio app)Basic o Standard o Premium. I backup automatici non sono supportati per le app per le funzioni nei piani tariffari A consumo o Elastic Premium.

Cosa è incluso in un backup automatico?

La tabella seguente illustra il contenuto di cui viene eseguito il backup in un backup automatico:

Impostazione Elemento ripristinato?
App di Windows: tutto il contenuto dell'app nella directory %HOME%
App Linux: tutto il contenuto dell'app nella directory /home
Contenitori personalizzati (Windows e Linux): contenuto nello spazio di archiviazione permanente
Contenuto del pacchetto run-from-ZIP No
Contenuto di qualsiasi risorsa di archiviazione di Azure montata personalizzata, ad esempio da una condivisione di File di Azure. No

La tabella seguente illustra quale configurazione dell'app viene ripristinata quando si sceglie di ripristinare la configurazione dell'app:

Impostazione Elemento ripristinato?
Impostazioni del log nativo, incluse le impostazioni dell'account di Archiviazione di Azure e del contenitore
Configurazione di Application Insights
Controllo integrità
Funzionalità di rete, ad esempio endpoint privati, connessioni ibride e integrazione della rete virtuale No
Autenticazione No
Identità gestite No
Domini personalizzati No
TLS/SSL No
Aumentare il numero di istanze No
Diagnostica con Monitoraggio di Azure No
Avvisi e metriche No
Backup No
Slot di distribuzione associati No
Qualsiasi database collegato supportato dal backup personalizzato No

Cosa è incluso in un backup personalizzato?

Un backup personalizzato (backup su richiesta o backup pianificato) include tutto il contenuto e la configurazione inclusi in un backup automatico, oltre a qualsiasi database collegato, fino alle dimensioni massime consentite.

Quando si esegue il backup su una rete virtuale di Azure, non è possibile eseguire il backup del database collegato.

Perché il database collegato non è incluso nel backup?

Il backup dei database collegati viene eseguito solo per i backup personalizzati, fino alle dimensioni massime consentite. Se viene superata la dimensione massima del backup (10 GB) o la dimensione massima del database (4 GB), il backup non ha esito positivo. Alcuni dei motivi comuni per cui non viene eseguito il backup del database collegato sono i seguenti:

  • Il backup di Database di Azure per MySQL abilitato per TLS non è supportato. Se viene configurato un backup, vengono visualizzati errori durante il backup.
  • Il backup di Database di Azure per PostgreSQL abilitato per TLS non è supportato. Se viene configurato un backup, vengono visualizzati errori durante il backup.
  • Per i database MySQL in-app viene automaticamente eseguito un backup senza alcuna configurazione. Se si modificano manualmente le impostazioni dei database MySQL in-app, ad esempio si aggiungono stringhe di connessione, è possibile che i backup non vengano eseguiti correttamente.

Cosa accade se le dimensioni del backup superano il limite massimo consentito?

I backup automatici non possono essere ripristinati se le dimensioni del backup superano le dimensioni massime. Analogamente, i backup personalizzati hanno esito negativo se vengono superate le dimensioni massime del backup o le dimensioni massime del database. Per ridurre le dimensioni di archiviazione, è consigliabile spostare file come log, immagini, audio e video in Archiviazione di Azure, ad esempio.

È possibile usare un account di archiviazione con funzionalità di sicurezza abilitate?

È possibile eseguire il backup in un account di archiviazione protetto da firewall se fa parte della stessa topologia della rete virtuale dell'app. Vedere Eseguire il backup e il ripristino tramite la rete virtuale di Azure.

Come si esegue il ripristino in un'app in una sottoscrizione diversa?

  1. È possibile eseguire un backup personalizzato in un contenitore di Archiviazione di Azure.
  2. Scaricare il file ZIP di backup nel computer locale.
  3. Nella pagina Backup dell’app di destinazione selezionare Ripristina nel menu in alto.
  4. In Dettagli backupselezionare Archiviazione in Origine.
  5. Selezionare l'account di archiviazione preferito.
  6. In File ZIP selezionare Carica file.
  7. In Nome selezionare Sfoglia e selezionare il file ZIP scaricato.
  8. Configurare le altre sezioni, ad esempio in Ripristinare un backup.

Come si esegue il ripristino in un'app nella stessa sottoscrizione ma in un'area diversa?

La procedura è identica a quella descritta in Come eseguire il ripristino in un'app in una sottoscrizione diversa.

Dove vengono archiviati i backup automatici?

I backup automatici sono semplici, vengono archiviati nello stesso data center del Servizio app e non devono essere basati sul piano di ripristino di emergenza.

Come si arresta il backup automatico?

Non è possibile arrestare i backup automatici. Il backup automatico viene archiviato nella piattaforma e non ha alcun effetto sull'istanza dell'app sottostante o sul relativo spazio di archiviazione.

Passaggi successivi

Documentazione di Archiviazione BLOB di Azure