Ripristino di emergenza

AccessPoint viene eseguito interamente nel proprio abbonamento Azure. La pianificazione del ripristino di emergenza sfrutta le funzionalità integrate di ridondanza e ripristino di Azure. L'editore non detiene alcun dato del cliente, pertanto il ripristino è completamente sotto il proprio controllo.

Obiettivi di ripristino

Backup e ripristino

Database

• Ripristino temporizzato (PITR): Automatico, fino a 35 giorni. Non è necessaria alcuna configurazione manuale.
• Conservazione a lungo termine (LTR): Configurare backup settimanali, mensili o annuali per la conformità. Configurazione tramite Portale Azure > SQL Database > Backup > Criteri di conservazione.
• Backup con ridondanza geografica: Abilitato per impostazione predefinita sui livelli Standard e Premium. Consente il ripristino in un'area Azure associata in caso di interruzione regionale.

Blob Storage

• Eliminazione temporanea: Abilitare l'eliminazione temporanea per blob e contenitori per recuperare i documenti eliminati accidentalmente. Conservazione consigliata: 30 giorni.
• Controllo delle versioni: Abilitare il controllo delle versioni dei blob per mantenere le versioni precedenti dei documenti sovrascritti.

Configurazione

Esportare o documentare i propri pacchetti di configurazione prima di apportare modifiche importanti. Se una modifica alla configurazione deve essere annullata, l'unica opzione è il ripristino da un backup del database.

Procedure di rollback

Rollback dell'API

L'API viene distribuita come pacchetto zip in Azure App Service. Per ripristinare una distribuzione precedente:

1. Aprire il Portale Azure e passare al proprio App Service
2. Andare a Centro distribuzione > Cronologia distribuzioni
3. Individuare la distribuzione precedente riuscita
4. Selezionarla e fare clic su Ridistribuisci
5. Verificare che l'applicazione funzioni correttamente

Se si utilizzano slot di distribuzione, tornare allo slot precedente tramite Slot di distribuzione > Scambia.

Rollback del database

Le distribuzioni DacPac sono additive per impostazione predefinita — vengono aggiunte nuove colonne e tabelle, ma gli oggetti esistenti non vengono rimossi. Ciò fornisce una rete di sicurezza per la maggior parte delle modifiche allo schema.

Per problemi relativi ai dati (dati corrotti o errati), utilizzare il ripristino temporizzato di Azure SQL:

1. Ripristinare il database a un momento precedente al problema
2. Verificare il contenuto del database ripristinato
3. Aggiornare la stringa di connessione dell'App Service per puntare al database ripristinato oppure rinominare i database per scambiarli

Rollback SPFx

Per ripristinare la Web Part SPFx a una versione precedente:

1. Scaricare il pacchetto .sppkg della versione precedente dal portale Realizer
2. Aprire il Catalogo app di SharePoint
3. Caricare il pacchetto precedente, sostituendo la versione corrente
4. Fare clic su Distribuisci

Rollback della configurazione

I pacchetti di configurazione sono additivi — l'importazione di un pacchetto aggiunge o aggiorna gli elementi, ma non rimuove quelli esistenti. Per annullare le modifiche alla configurazione, ripristinare il database da un backup temporizzato effettuato prima della modifica.

Scenari di ripristino di emergenza

Scenario 1: Eliminazione accidentale dei dati

1. Documenti eliminati da Blob Storage: Se l'eliminazione temporanea è abilitata, recuperare i blob entro la finestra di conservazione configurata
2. Record del database eliminati: Utilizzare il ripristino temporizzato di Azure SQL al momento precedente all'eliminazione. Copiare i record necessari dal database ripristinato alla produzione.

Scenario 2: Interruzione di un'area Azure

Se l'area Azure che ospita la distribuzione diventa non disponibile:

1. Azure SQL: Ripristinare dai backup con ridondanza geografica su un nuovo SQL Server in un'area diversa
2. Blob Storage: Se si utilizza l'archiviazione con ridondanza geografica (GRS o RA-GRS), avviare un failover dell'account. Se si utilizza l'archiviazione con ridondanza locale (LRS), i dati devono essere ripristinati da un backup esterno.
3. App Service: Ridistribuire utilizzando il modello Bicep nell'area di ripristino
4. DNS e URL dell'API: Aggiornare l'entità di archiviazione dell'URL dell'API AccessPoint in SharePoint per puntare al nuovo URL dell'App Service

Scenario 3: Ricostruzione completa dell'ambiente

L'intero ambiente AccessPoint può essere ricostruito da zero utilizzando gli artefatti di distribuzione pubblicati:

1. Eseguire il modello Bicep per predisporre tutte le risorse Azure
2. Distribuire lo zip dell'API nell'App Service (incluso nella distribuzione ARM)
3. Lo schema del database viene distribuito automaticamente al primo avvio dell'API
4. Caricare il .sppkg SPFx nel catalogo app di SharePoint
5. Eseguire Deploy-AccessPoint.ps1 per configurare l'autenticazione esclusiva Entra per SQL e le autorizzazioni Graph
6. Ripristinare il database dal backup più recente per recuperare i dati
7. Ripristinare i documenti di Blob Storage dai backup con ridondanza geografica

L'infrastruttura come codice (modelli Bicep) e lo script di distribuzione garantiscono che l'ambiente sia completamente riproducibile.

Raccomandazioni per la pianificazione

• Abilitare l'archiviazione con ridondanza geografica (GRS) sull'account Blob Storage per la ridondanza documentale tra aree
• Abilitare la conservazione a lungo termine (LTR) su Azure SQL per backup settimanali, mensili e annuali oltre la finestra PITR predefinita
• Abilitare l'eliminazione temporanea su Blob Storage con un periodo di conservazione di 30 giorni
• Abilitare il controllo delle versioni dei blob per recuperare i documenti sovrascritti
• Documentare i propri parametri di distribuzione — conservare un registro del nome del tenant, del gruppo di risorse, dell'indirizzo e-mail di avviso e di eventuali impostazioni personalizzate dell'App Service per poter ridistribuire rapidamente
• Testare il ripristino annualmente — ripristinare il database e il Blob Storage in un ambiente di test per verificare il funzionamento dei propri backup
• Considerare Azure Front Door o Traffic Manager se la propria organizzazione richiede un failover automatico con tempi di inattività minimi

Monitoraggio dello stato di integrità

AccessPoint espone due endpoint di verifica dello stato di integrità:

Metriche chiave da monitorare

Ridimensionamento

Ridimensionamento verticale (aumento delle risorse)

Modificare il livello del piano App Service in Portale Azure > App Service > Aumenta risorse (piano App Service). Non è necessaria alcuna ridistribuzione.

Ridimensionamento orizzontale (aumento delle istanze)

L'API AccessPoint è senza stato e supporta più istanze. Configurare il ridimensionamento manuale o automatico in Portale Azure > App Service > Aumenta istanze (piano App Service).

Ridimensionamento SQL

Regolare il livello del database in base al carico di lavoro. Obiettivi di servizio comuni: Basic, S0, S1, S2, S3, P1, P2.

Rotazione di certificati e segreti