Azure Service Fabric 中的按需备份

  • 项目

可将可靠有状态服务和 Reliable Actors 的数据进行备份，以解决灾难或数据丢失的情况。

Azure Service Fabric 提供定期备份数据和按需备份数据的功能。 按需备份很有用，因为它可防止由于在基础服务或其环境中的计划更改而导致的数据丢失/数据损坏。

在手动触发服务或服务环境操作之前，按需备份功能有助于捕获服务的状态。 例如，如果你在升级或降级服务时对服务二进制文件做出了更改。 在这种情况下，按需备份可以帮助防止应用程序代码 bug 导致数据损坏。

先决条件

  • 安装 Microsoft.ServiceFabric.Powershell.Http模块 [在预览中] 进行配置调用。
    Install-Module -Name Microsoft.ServiceFabric.Powershell.Http -AllowPrerelease

注意

如果 PowerShellGet 版本低于 1.6.0，则需要进行更新以添加对 -AllowPrerelease 标志的支持：

Install-Module -Name PowerShellGet -Force

  • 请确保在使用 Microsoft.ServiceFabric.Powershell.Http 模块发出任何配置请求之前，先使用 Connect-SFCluster 命令连接群集。

    Connect-SFCluster -ConnectionEndpoint 'https://mysfcluster.chinaeast.cloudapp.chinacloudapi.cn:19080'   -X509Credential -FindType FindByThumbprint -FindValue '1b7ebe2174649c45474a4819dafae956712c31d3' -StoreLocation 'CurrentUser' -StoreName 'My' -ServerCertThumbprint '1b7ebe2174649c45474a4819dafae956712c31d3'

触发按需备份

按需备份要求提供存储详细信息用于上传备份文件。 可在定期备份策略或按需备份请求中指定按需备份位置。

按需备份到定期备份策略指定的存储

可将定期备份策略配置为使用可靠有状态服务或 Reliable Actor 的某个分区，以便在存储中创建额外的按需备份。

以下用例是为可靠有状态服务和 Reliable Actors 启用定期备份中的方案的延续。 在本例中，你启用了一个备份策略，以使用某个分区，并按设置的频率在 Azure 存储中创建备份。

使用Microsoft.ServiceFabric.Powershell.Http 模块的 PowerShell


Backup-SFPartition -PartitionId '974bd92a-b395-4631-8a7f-53bd4ae9cf22'

使用 Powershell 进行 Rest 调用

使用 BackupPartition API 为分区 ID 974bd92a-b395-4631-8a7f-53bd4ae9cf22 的按需备份设置触发。

$url = "https://mysfcluster.chinaeast.cloudapp.chinacloudapi.cn:19080/Partitions/974bd92a-b395-4631-8a7f-53bd4ae9cf22/$/Backup?api-version=6.4"

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

使用 GetBackupProgress API 启用按需备份进度跟踪。

指定存储的按需备份

可以请求可靠有状态服务或 Reliable Actor 的分区的按需备份。 请在按需备份请求中提供存储信息。

使用Microsoft.ServiceFabric.Powershell.Http 模块的 PowerShell


Backup-SFPartition -PartitionId '974bd92a-b395-4631-8a7f-53bd4ae9cf22' -AzureBlobStore -ConnectionString  'DefaultEndpointsProtocol=https;AccountName=<account-name>;AccountKey=<account-key>;EndpointSuffix=core.chinacloudapi.cn' -ContainerName 'backup-container'

使用 Powershell 进行 Rest 调用

使用 BackupPartition API 为分区 ID 974bd92a-b395-4631-8a7f-53bd4ae9cf22 的按需备份设置触发。 包括以下 Azure 存储信息：

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

$OnDemandBackupRequest = @{
    BackupStorage = $StorageInfo
}

$body = (ConvertTo-Json $OnDemandBackupRequest)
$url = "https://mysfcluster.chinaeast.cloudapp.chinacloudapi.cn:19080/Partitions/974bd92a-b395-4631-8a7f-53bd4ae9cf22/$/Backup?api-version=6.4"

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

可以使用 GetBackupProgress API 设置按需备份进度跟踪。

使用 Service Fabric Explorer

请确保已在 Service Fabric Explorer 设置中启用了“高级模式”。

  1. 选择所需分区，并单击“操作”。

  2. 选择“触发分区备份”，并填写用于 Azure 的信息：

    Trigger Partition Backup

    或 FileShare：

    Trigger Partition Backup FileShare

跟踪按需备份进度

可靠有状态服务或 Reliable Actor 的分区一次仅接受一个按需备份请求。 仅当已完成当前的按需备份请求后，才能接受另一个请求。

不同的分区可以同时触发按需备份请求。

使用Microsoft.ServiceFabric.Powershell.Http 模块的 PowerShell


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

使用 Powershell 进行 Rest 调用

$url = "https://mysfcluster-backup.chinaeast.cloudapp.chinacloudapi.cn:19080/Partitions/974bd92a-b395-4631-8a7f-53bd4ae9cf22/$/GetBackupProgress?api-version=6.4"

$response = Invoke-WebRequest -Uri $url -Method Get -CertificateThumbprint '1b7ebe2174649c45474a4819dafae956712c31d3' 
$backupResponse = (ConvertFrom-Json $response.Content) 
$backupResponse

按需备份请求可处于以下状态：

  • 已接受：备份已针对分区启动，且正在进行。 
    BackupState             : Accepted
TimeStampUtc            : 0001-01-01T00:00:00Z
BackupId                : 00000000-0000-0000-0000-000000000000
BackupLocation          :
EpochOfLastBackupRecord :
LsnOfLastBackupRecord   : 0
FailureError            :
  • 成功、失败或超时：可在以下任一状态中完成请求的按需备份：
    • 成功：“成功”备份状态表示已成功备份分区状态。 响应将提供分区的 BackupEpoch 和 BackupLSN 以及 UTC 格式的时间。 
      BackupState             : Success
TimeStampUtc            : 2018-11-21T20:00:01Z
BackupId                : 5d64b697-6acd-45a4-adbd-3d75e0078081
BackupLocation          : SampleApp\MyStatefulService\974bd92a-b395-4631-8a7f-53bd4ae9cf22\2018-11-21 20.00.01.zip
EpochOfLastBackupRecord : @{DataLossNumber=131873018908156893; ConfigurationNumber=8589934592}
LsnOfLastBackupRecord   : 36
FailureError            :
    • 失败：“失败”备份状态表示在备份分区状态期间发生失败。 响应中会指明失败的原因。 
      BackupState             : Failure
TimeStampUtc            : 0001-01-01T00:00:00Z
BackupId                : 00000000-0000-0000-0000-000000000000
BackupLocation          :
EpochOfLastBackupRecord :
LsnOfLastBackupRecord   : 0
FailureError            : @{Code=FABRIC_E_BACKUPCOPIER_UNEXPECTED_ERROR; Message=An error occurred during this operation.  Please check the trace logs for more details.}
    • 超时：“超时”备份状态表示在给定的时间内无法创建分区状态备份。 默认超时值为 10 分钟。 如果发生这种情况，请使用更大的 BackupTimeout 发起新的按需备份请求。 
      BackupState             : Timeout
TimeStampUtc            : 0001-01-01T00:00:00Z
BackupId                : 00000000-0000-0000-0000-000000000000
BackupLocation          :
EpochOfLastBackupRecord :
LsnOfLastBackupRecord   : 0
FailureError            : @{Code=FABRIC_E_TIMEOUT; Message=The request of backup has timed out.}

后续步骤