Restauración de una copia de seguridad en Azure Service Fabric

Artículo
07/27/2022
Tiempo de lectura: 8 minutos

En Azure Service Fabric, los servicios de confianza con estado y Reliable Actors pueden mantener un estado mutable y autoritativo después de que se ha completado una transacción de solicitud y respuesta. Un servicio con estado podría dejan de funcionar durante mucho tiempo o perder información debido a un desastre. Si esto sucede, el servicio debe restaurarse desde la última copia de seguridad aceptable, para que puede seguir funcionando.

Por ejemplo, puede configurar un servicio para realizar una copia de seguridad de sus datos a fin de protegerse frente a los siguientes casos:

Caso de recuperación ante desastres: En caso de que se produzca una pérdida permanente de todo un clúster de Service Fabric.
Caso de pérdida de datos: Pérdida permanente de la mayoría de las réplicas de una partición del servicio.
Caso de pérdida de datos: eliminación accidental o daños del servicio. Por ejemplo, un administrador elimina por error el servicio.
Caso de datos dañados: Los errores en el servicio provocan daños en los datos. Por ejemplo, se pueden producir daños en los datos cuando una actualización del código de servicio escribe datos defectuosos en una colección de confianza. En tal caso, puede que tenga que restaurar el código y los datos a un estado anterior.

Prerrequisitos

Para desencadenar la restauración, el servicio de análisis de errores (FAS) debe estar habilitado para el clúster.
El servicio de restauración de copia de seguridad (BRS) creó la copia de seguridad.
La restauración solo se puede desencadenar en una partición.
Instale el módulo Microsoft.ServiceFabric.PowerShell.Http (versión preliminar) para realizar llamadas de configuración.

    Install-Module -Name Microsoft.ServiceFabric.Powershell.Http -AllowPrerelease

Nota:

Si la versión de PowerShellGet es inferior a la 1.6.0, deberá actualizar para agregar compatibilidad con la marca -AllowPrerelease:

Install-Module -Name PowerShellGet -Force

Asegúrese de que el clúster esté conectado mediante el comando Connect-SFCluster antes de realizar una solicitud de configuración con el módulo Microsoft.ServiceFabric.Powershell.Http.


    Connect-SFCluster -ConnectionEndpoint 'https://mysfcluster.southcentralus.cloudapp.azure.com:19080'   -X509Credential -FindType FindByThumbprint -FindValue '1b7ebe2174649c45474a4819dafae956712c31d3' -StoreLocation 'CurrentUser' -StoreName 'My' -ServerCertThumbprint '1b7ebe2174649c45474a4819dafae956712c31d3'

Restauración desencadenada

Una restauración se puede desencadenar en cualquiera de los siguientes casos:

Restauración de datos en una recuperación ante desastres.
Restauración de datos ante pérdida de datos o daños en los datos.

Restauración de datos en caso de recuperación ante desastres

Si se pierde un clúster entero de Service Fabric, puede recuperar los datos de las particiones del servicio de confianza con estado y Reliable Actors. La copia de seguridad deseada se puede seleccionar de la lista cuando se usan los detalles de GetBackupAPI con almacenamiento de copia de seguridad. La enumeración de copia de seguridad puede ser para una aplicación, un servicio o una partición.

En el ejemplo siguiente, suponga que el clúster perdido es el mismo clúster al que se hace referencia en Habilitación de la copia de seguridad periódica del servicio de confianza con estado y Reliable Actors. En este caso, SampleApp se implementa con la directiva de copia de seguridad habilitada, y las copias de seguridad se configuran para Azure Storage.

PowerShell con el módulo Microsoft.ServiceFabric.Powershell.Http

Get-SFBackupsFromBackupLocation -Application -ApplicationName 'fabric:/SampleApp' -AzureBlobStore -ConnectionString 'DefaultEndpointsProtocol=https;AccountName=<account-name>;AccountKey=<account-key>;EndpointSuffix=core.windows.net' -ContainerName 'backup-container'

Llamada a REST mediante PowerShell

Ejecute un script de PowerShell para usar la API REST para devolver una lista de copias de seguridad creadas para todas las particiones dentro de la aplicación SampleApp. La API requiere la información de almacenamiento de copia de seguridad para enumerar las copias de seguridad disponibles.

$StorageInfo = @{
    ConnectionString = 'DefaultEndpointsProtocol=https;AccountName=<account-name>;AccountKey=<account-key>;EndpointSuffix=core.windows.net'
    ContainerName = 'backup-container'
    StorageKind = 'AzureBlobStore'
}

$BackupEntity = @{
    EntityKind = 'Application'
    ApplicationName='fabric:/SampleApp'
}

$BackupLocationAndEntityInfo = @{
    Storage = $StorageInfo
    BackupEntity = $BackupEntity
}

$body = (ConvertTo-Json $BackupLocationAndEntityInfo)
$url = "https://myalternatesfcluster.southcentralus.cloudapp.azure.com:19080/BackupRestore/$/GetBackups?api-version=6.4"

$response = Invoke-WebRequest -Uri $url -Method Post -Body $body -ContentType 'application/json' -CertificateThumbprint '1b7ebe2174649c45474a4819dafae956712c31d3'
$BackupPoints = (ConvertFrom-Json $response.Content)
$BackupPoints.Items

Salida de ejemplo de la ejecución anterior:

BackupId                : b9577400-1131-4f88-b309-2bb1e943322c
BackupChainId           : b9577400-1131-4f88-b309-2bb1e943322c
ApplicationName         : fabric:/SampleApp
ServiceName             : fabric:/SampleApp/MyStatefulService
PartitionInformation    : @{LowKey=-9223372036854775808; HighKey=9223372036854775807; ServicePartitionKind=Int64Range; Id=974bd92a-b395-4631-8a7f-53bd4ae9cf22}
BackupLocation          : SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 20.55.16.zip
BackupType              : Full
EpochOfLastBackupRecord : @{DataLossNumber=131675205859825409; ConfigurationNumber=8589934592}
LsnOfLastBackupRecord   : 3334
CreationTimeUtc         : 2018-04-06T20:55:16Z
FailureError            : 
*
BackupId                : b0035075-b327-41a5-a58f-3ea94b68faa4
BackupChainId           : b9577400-1131-4f88-b309-2bb1e943322c
ApplicationName         : fabric:/SampleApp
ServiceName             : fabric:/SampleApp/MyStatefulService
PartitionInformation    : @{LowKey=-9223372036854775808; HighKey=9223372036854775807; ServicePartitionKind=Int64Range; Id=974bd92a-b395-4631-8a7f-53bd4ae9cf22}
BackupLocation          : SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 21.10.27.zip
BackupType              : Incremental
EpochOfLastBackupRecord : @{DataLossNumber=131675205859825409; ConfigurationNumber=8589934592}
LsnOfLastBackupRecord   : 3552
CreationTimeUtc         : 2018-04-06T21:10:27Z
FailureError            :
*
BackupId                : 69436834-c810-4163-9386-a7a800f78359
BackupChainId           : b9577400-1131-4f88-b309-2bb1e943322c
ApplicationName         : fabric:/SampleApp
ServiceName             : fabric:/SampleApp/MyStatefulService
PartitionInformation    : @{LowKey=-9223372036854775808; HighKey=9223372036854775807; ServicePartitionKind=Int64Range; Id=974bd92a-b395-4631-8a7f-53bd4ae9cf22}
BackupLocation          : SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 21.25.36.zip
BackupType              : Incremental
EpochOfLastBackupRecord : @{DataLossNumber=131675205859825409; ConfigurationNumber=8589934592}
LsnOfLastBackupRecord   : 3764
CreationTimeUtc         : 2018-04-06T21:25:36Z
FailureError            :

Para desencadenar la restauración, elija una de las copias de seguridad. Por ejemplo, la copia de seguridad actual para la recuperación ante desastres podría ser la copia de seguridad siguiente:

BackupId                : b0035075-b327-41a5-a58f-3ea94b68faa4
BackupChainId           : b9577400-1131-4f88-b309-2bb1e943322c
ApplicationName         : fabric:/SampleApp
ServiceName             : fabric:/SampleApp/MyStatefulService
PartitionInformation    : @{LowKey=-9223372036854775808; HighKey=9223372036854775807; ServicePartitionKind=Int64Range; Id=974bd92a-b395-4631-8a7f-53bd4ae9cf22}
BackupLocation          : SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 21.10.27.zip
BackupType              : Incremental
EpochOfLastBackupRecord : @{DataLossNumber=131675205859825409; ConfigurationNumber=8589934592}
LsnOfLastBackupRecord   : 3552
CreationTimeUtc         : 2018-04-06T21:10:27Z
FailureError            :

Para la API de restauración, debe proporcionar los detalles BackupId y BackupLocation.

También debe elegir una partición de destino en el clúster alternativo, como se detalla en el esquema de partición. La copia de seguridad del clúster alternativo se restaura en la partición especificada en el esquema de partición del clúster perdido original.

Si el identificador de partición del clúster alternativo es 1c42c47f-439e-4e09-98b9-88b8f60800c6, puede asignarlo al identificador de partición del clúster original 974bd92a-b395-4631-8a7f-53bd4ae9cf22; simplemente compare la clave superior e inferior para la creación de particiones por rango (UniformInt64Partition) .

Para la creación de particiones con nombre, el valor de nombre se compara para identificar la partición de destino en el clúster alternativo.

PowerShell con el módulo Microsoft.ServiceFabric.Powershell.Http


Restore-SFPartition  -PartitionId '1c42c47f-439e-4e09-98b9-88b8f60800c6' -BackupId 'b0035075-b327-41a5-a58f-3ea94b68faa4' -BackupLocation 'SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 21.10.27.zip' -AzureBlobStore -ConnectionString 'DefaultEndpointsProtocol=https;AccountName=<account-name>;AccountKey=<account-key>;EndpointSuffix=core.windows.net' -ContainerName 'backup-container'

Llamada a REST mediante PowerShell

La restauración se solicita en la partición del clúster de copia de seguridad mediante la siguiente API de restauración:


$StorageInfo = @{
    ConnectionString = 'DefaultEndpointsProtocol=https;AccountName=<account-name>;AccountKey=<account-key>;EndpointSuffix=core.windows.net'
    ContainerName = 'backup-container'
    StorageKind = 'AzureBlobStore'
}

$RestorePartitionReference = @{
    BackupId = 'b0035075-b327-41a5-a58f-3ea94b68faa4'
    BackupLocation = 'SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 21.10.27.zip'
    BackupStorage  = $StorageInfo
}

$body = (ConvertTo-Json $RestorePartitionReference) 
$url = "https://mysfcluster.southcentralus.cloudapp.azure.com:19080/Partitions/1c42c47f-439e-4e09-98b9-88b8f60800c6/$/Restore?api-version=6.4" 

Invoke-WebRequest -Uri $url -Method Post -Body $body -ContentType 'application/json' -CertificateThumbprint '1b7ebe2174649c45474a4819dafae956712c31d3'

Puede realizar un seguimiento del progreso de una restauración con TrackRestoreProgress.

Nota:

Al usar PowerShell para restaurar la partición, si backuplocation tiene "$", aplíquele escape mediante "~".

Uso de Service Fabric Explorer

Puede desencadenar una restauración desde Service Fabric Explorer. Asegúrese de que se ha habilitado el modo avanzado en la configuración de Service Fabric Explorer.

Seleccione las particiones deseadas y haga clic en Acciones.
Seleccione Trigger Partition Restore (Desencadenar restauración de particiones) y rellene la información para Azure:

o recurso compartido de archivos:

Restauración de datos ante daños dañados/pérdida de datos

En el caso de pérdida de datos o datos dañados, las particiones en copia de seguridad de las particiones del servicio de confianza con estado y Reliable Actors se pueden restaurar a cualquiera de las copias de seguridad elegidas.

El siguiente ejemplo es una continuación del escenario de Habilitación de la copia de seguridad periódica del servicio de confianza con estado y Reliable Actors. En este ejemplo, una directiva de copia de seguridad está habilitada para la partición y el servicio está realizando copias de seguridad con una frecuencia deseada en Azure Storage.

Seleccione una copia de seguridad de la salida de GetBackupAPI. En este escenario, la copia de seguridad se genera del mismo clúster que antes.

Para desencadenar la restauración, elija una copia de seguridad de la lista. Para la pérdida de datos/datos dañados actuales, seleccione la siguiente copia de seguridad:

BackupId                : b0035075-b327-41a5-a58f-3ea94b68faa4
BackupChainId           : b9577400-1131-4f88-b309-2bb1e943322c
ApplicationName         : fabric:/SampleApp
ServiceName             : fabric:/SampleApp/MyStatefulService
PartitionInformation    : @{LowKey=-9223372036854775808; HighKey=9223372036854775807; ServicePartitionKind=Int64Range; Id=974bd92a-b395-4631-8a7f-53bd4ae9cf22}
BackupLocation          : SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 21.10.27.zip
BackupType              : Incremental
EpochOfLastBackupRecord : @{DataLossNumber=131675205859825409; ConfigurationNumber=8589934592}
LsnOfLastBackupRecord   : 3552
CreationTimeUtc         : 2018-04-06T21:10:27Z
FailureError            :

Para la API de restauración, proporcione los detalles BackupId y BackupLocation. Dado que el clúster tiene la copia de seguridad habilitada, el servicio de restauración de copia de seguridad (BRS) de Service Fabric identifica la ubicación de almacenamiento correcta a partir de la directiva de copia de seguridad asociada.

PowerShell con el módulo Microsoft.ServiceFabric.Powershell.Http

Restore-SFPartition  -PartitionId '974bd92a-b395-4631-8a7f-53bd4ae9cf22' -BackupId 'b0035075-b327-41a5-a58f-3ea94b68faa4' -BackupLocation 'SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 21.10.27.zip'

Llamada a REST mediante PowerShell

$RestorePartitionReference = @{
    BackupId = 'b0035075-b327-41a5-a58f-3ea94b68faa4',
    BackupLocation = 'SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-04-06 21.10.27.zip'
}

$body = (ConvertTo-Json $RestorePartitionReference)
$url = "https://mysfcluster.southcentralus.cloudapp.azure.com:19080/Partitions/974bd92a-b395-4631-8a7f-53bd4ae9cf22/$/Restore?api-version=6.4"

Invoke-WebRequest -Uri $url -Method Post -Body $body -ContentType 'application/json' -CertificateThumbprint '1b7ebe2174649c45474a4819dafae956712c31d3'

Puede realizar un seguimiento del progreso de la restauración mediante TrackRestoreProgress.

Nota:

Al usar PowerShell para restaurar la partición, si backuplocation tiene "$", aplíquele escape mediante "~".

Seguimiento del progreso de la restauración

Una partición de un servicio de confianza con estado o de Reliable Actors acepta solo una solicitud de restauración a la vez. Una partición solo acepta otra solicitud una vez completada la solicitud de restauración actual. Se pueden desencadenar varias solicitudes de restauración en distintas particiones al mismo tiempo.

PowerShell con el módulo Microsoft.ServiceFabric.Powershell.Http

    Get-SFPartitionRestoreProgress -PartitionId '974bd92a-b395-4631-8a7f-53bd4ae9cf22'

Llamada a REST mediante PowerShell

$url = "https://mysfcluster-backup.southcentralus.cloudapp.azure.com:19080/Partitions/974bd92a-b395-4631-8a7f-53bd4ae9cf22/$/GetRestoreProgress?api-version=6.4"

$response = Invoke-WebRequest -Uri $url -Method Get -CertificateThumbprint '1b7ebe2174649c45474a4819dafae956712c31d3'

$restoreResponse = (ConvertFrom-Json $response.Content)
$restoreResponse | Format-List

La solicitud de restauración progresa en el orden siguiente:

Accepted (Aceptado): el estado de restauración Accepted indica que la partición solicitada se ha desencadenado con los parámetros de solicitud correctos.

RestoreState  : Accepted
TimeStampUtc  : 0001-01-01T00:00:00Z
RestoredEpoch : @{DataLossNumber=131675205859825409; ConfigurationNumber=8589934592}
RestoredLsn   : 3552

InProgress: el estado de restauración InProgress indica que se está produciendo una restauración en la partición con la copia de seguridad mencionado en la solicitud. La partición notifica el estado dataloss.
```
RestoreState  : RestoreInProgress
TimeStampUtc  : 0001-01-01T00:00:00Z
RestoredEpoch : @{DataLossNumber=131675205859825409; ConfigurationNumber=8589934592}
RestoredLsn   : 3552
```
Success, Failure o Timeout: la restauración solicitada se puede realizar en cualquiera de los siguientes estados. Cada estado tiene los siguientes detalles de importancia y respuesta:
- Correcta: un estado Correcta de la restauración indica un estado de partición recuperado. La partición notifica los estados RestoredEpoch y RestoredLSN junto con la hora en UTC.
```
RestoreState  : Success
TimeStampUtc  : 2018-11-22T11:22:33Z
RestoredEpoch : @{DataLossNumber=131675205859825409; ConfigurationNumber=8589934592}
RestoredLsn   : 3552
```
- Error: el estado de restauración Failure indica el error de la solicitud de restauración. Se notifica la causa del error.
```
RestoreState  : Failure
TimeStampUtc  : 0001-01-01T00:00:00Z
RestoredEpoch : 
RestoredLsn   : 0
```
- Timeout: el estado de restauración Timeout indica que la solicitud tiene tiempo de espera. Cree una solicitud de restauración con un valor mayor de RestoreTimeout. El tiempo de espera predeterminado es de 10 minutos. Antes de volver a solicitar la restauración, asegúrese de que la partición esté fuera del estado de pérdida de datos.
```
RestoreState  : Timeout
TimeStampUtc  : 0001-01-01T00:00:00Z
RestoredEpoch : 
RestoredLsn   : 0
```

Restauración automática

Puede configurar las particiones del servicio de confianza con estado y Reliable Actors en el clúster de Service Fabric para la restauración automática. En la directiva de copia de seguridad, establezca AutoRestore en true. Ah habilitar la restauración automática se restauran automáticamente los datos de la copia de seguridad más reciente de la partición cuando se notifica la pérdida de datos. Para más información, consulte:

Restauración de una copia de seguridad en Azure Service Fabric

Prerrequisitos

Restauración desencadenada

Restauración de datos en caso de recuperación ante desastres

PowerShell con el módulo Microsoft.ServiceFabric.Powershell.Http

Llamada a REST mediante PowerShell

PowerShell con el módulo Microsoft.ServiceFabric.Powershell.Http

Llamada a REST mediante PowerShell

Uso de Service Fabric Explorer

Restauración de datos ante daños dañados/pérdida de datos

PowerShell con el módulo Microsoft.ServiceFabric.Powershell.Http

Llamada a REST mediante PowerShell

Seguimiento del progreso de la restauración

PowerShell con el módulo Microsoft.ServiceFabric.Powershell.Http

Llamada a REST mediante PowerShell

Restauración automática

Pasos siguientes