共用方式為


備份與還原 Reliable Services 和 Reliable Actors

Azure Service Fabric 是高可用性平台,跨多個節點之間複寫狀態以維護這個高可用性。 因此,即使叢集中的一個節點失敗,服務可以繼續。 雖然這個由平台提供的內建備援對於一些特定情況可能已經足夠,但是服務最好能夠備份資料 (到外部存放區)。

注意

請務必備份和還原您的資料 (以及測試它是否運作正常),以便您從資料遺失情況下進行復原。

注意

Microsoft 建議使用定期備份和還原,設定可靠具狀態服務和 Reliable Actors 的資料備份。

例如,服務需要備份資料以在下列情節中提供保護:

  • 發生整個 Service Fabric 叢集永久遺失的情況。
  • 永久遺失多數的服務分割區複本
  • 不小心刪除或損毀狀態的系統管理錯誤。 例如,這可能會在具備足夠權限的系統管理員錯誤地刪除服務時發生。
  • 服務中造成資料損毀的錯誤。 例如,當服務程式碼升級而開始將錯誤資料寫入「可靠的集合」時,就可能發生此情況。 在這種情況下,可能必須將程式碼和資料還原成先前的狀態。
  • 離線資料處理。 對於獨立於服務來產生資料的商業智慧,離線處理資料相當方便。

備份/還原功能可以讓在 Reliable Services API 上建置的服務建立及還原備份。 平台提供的備份 API 可以備份服務分割區狀態,而不會封鎖讀取或寫入作業。 還原 API 可以從所選的備份還原服務分割區的狀態。

備份類型

有兩個備份選項︰完整和增量。 完整備份是包含重新建立複本狀態所需的所有資料的備份︰檢查點和所有記錄檔記錄。 因為它有檢查點和記錄檔,所以可以自行還原完整備份。

檢查點太大時,會發生完整備份問題。 例如,具有 16 GB 狀態的複本,其檢查點大約會增加為 16 GB。 如果復原點目標為五分鐘,則需要每五分鐘備份複本一次。 每次備份時,除了 50 MB (可使用 CheckpointThresholdInMB 設定) 的記錄之外,還需要複製 16 GB 的檢查點。

完整備份範例。

此問題的解決方案是增量備份,其中備份只會包含上次備份後的變更記錄資料列。

增量備份範例。

因為增量備份只是上次備份後的變更 (不包含檢查點),所以它們通常會比較快,但無法自行進行還原。 若要還原增量備份,需要整個備份鏈結。 備份鏈結是一連串的備份,開始為完整備份,而接著是數個連續的增量備份。

備份 Reliable Services

服務作者對於進行備份的時機與儲存備份的位置具有完整的控制權。

若要開始備份,服務必須叫用繼承的成員函式 BackupAsync
備份只能從主要複本進行,且需要授與它們寫入狀態。

如下所示,BackupAsync 接受 BackupDescription 物件,使用者可以在其中指定完整或增量備份,以及指定在本機建立備份資料夾並準備好移出到一些外部儲存體時,所要叫用的回呼函式 Func<< BackupInfo, CancellationToken, Task<bool>>>


BackupDescription myBackupDescription = new BackupDescription(BackupOption.Incremental,this.BackupCallbackAsync);

await this.BackupAsync(myBackupDescription);

要採取增量備份的要求可能會失敗,並出現 FabricMissingFullBackupException。 這個例外狀況表示發生了下列其中一個事項:

  • 複本在變成主要複本之後從未執行完整備份、
  • 自上次備份被截斷之後記錄了部分記錄檔,或
  • 傳遞 MaxAccumulatedBackupLogSizeInMB 限制的複本。

使用者可以透過設定 MinLogSizeInMBTruncationThresholdFactor 來提高能夠進行增量備份的可能性。 提高這些值將會增加每個複本磁碟的使用量。 如需詳細資訊,請參閱 Reliable Services 組態

BackupInfo 提供備份的相關資訊,包括執行階段儲存備份所在的資料夾位置 (BackupInfo.Directory)。 回呼函式可以將 BackupInfo.Directory 移到外部存放區或另一個位置。 此函式也會傳回 Bool,指出是否能夠順利將備份資料夾移動至目標位置。

下列程式碼示範如何使用 BackupCallbackAsync 方法將備份上傳至 Azure 儲存體:

private async Task<bool> BackupCallbackAsync(BackupInfo backupInfo, CancellationToken cancellationToken)
{
    var backupId = Guid.NewGuid();

    await externalBackupStore.UploadBackupFolderAsync(backupInfo.Directory, backupId, cancellationToken);

    return true;
}

在上述範例中,ExternalBackupStore 是用來與 Azure Blob 儲存體介接的範例類別,而 UploadBackupFolderAsync 是壓縮資料夾並將它放在 Azure Blob 存放區的方法。

請注意:

  • 在任何指定時間每個複本只能有一項進行中的備份作業。 一次多個 BackupAsync 呼叫會擲回 FabricBackupInProgressException,將傳遞備份限制為一個。
  • 如果當備份進行中時有複本容錯移轉,備份可能未完成。 因此,容錯移轉完成之後,服務必須負責視需要叫用 BackupAsync 以重新啟動備份。

還原 Reliable Services

一般而言,您可能需要執行還原作業的情況屬於下列其中一種:

  • 服務資料分割遺失資料。 例如,分割區的三分之二複本 (包括主要複本) 的磁碟損毀或抹除。 新的主要複本可能需要從備份還原資料。
  • 整個服務遺失。 例如,系統管理員移除整個服務,因此服務和資料需要還原。
  • 服務會複寫損毀的應用程式資料 (例如,因為應用程式錯誤)。 在此情況下,服務必須升級或還原以移除損毀的原因,且必須還原未損毀的資料。

雖然有許多種可行的方法,我們會提供一些範例,說明使用 RestoreAsync 從上述案例進行復原。

Reliable Services 中的分割區資料遺失

在此情況下,執行階段會自動偵測資料遺失,並且叫用 OnDataLossAsync API。

服務作者必須執行下列動作來復原:

  • 覆寫虛擬基底類別方法 OnDataLossAsync
  • 在包含服務備份的外部位置尋找最新的備份。
  • 下載最新的備份 (並將已壓縮的備份解壓縮到備份資料夾)。
  • OnDataLossAsync 方法會提供 RestoreContext。 在所提供的 RestoreContext 上呼叫 RestoreAsync API。
  • 如果還原成功,則會傳回 true。

以下是 OnDataLossAsync 方法的範例實作:

protected override async Task<bool> OnDataLossAsync(RestoreContext restoreCtx, CancellationToken cancellationToken)
{
    var backupFolder = await this.externalBackupStore.DownloadLastBackupAsync(cancellationToken);

    var restoreDescription = new RestoreDescription(backupFolder);

    await restoreCtx.RestoreAsync(restoreDescription);

    return true;
}

傳入 RestoreContext.RestoreAsync 呼叫中的 RestoreDescription 包含一個名為 BackupFolderPath 的成員。 還原單一完整備份時,這個 BackupFolderPath 應該設定為包含完整備份的資料夾本機路徑。 還原一個完整備份和一些增量備份時,BackupFolderPath 應該設定為資料夾的本機路徑,這個資料夾不只包含完整備份,也包含所有增量備份。 如果提供的 BackupFolderPath 不包含完整備份,RestoreAsync 呼叫可能會擲回 FabricMissingFullBackupException。 如果 BackupFolderPath 的增量備份包含中斷的鏈結,它也可能會擲回 ArgumentException。 例如,如果它包含完整備份、第一個增量和第三個增量備份,但沒有第二個增量備份。

注意

RestorePolicy 預設設定為 [安全]。 這表示如果 RestoreAsync API 偵測到備份資料夾包含早於或等於這個複本內含狀態的狀態,則它將會失敗且具有 ArgumentException。 RestorePolicy.Force 可以用來跳過這項安全檢查。 這會指定為屬於 RestoreDescription

已刪除或遺失的服務

如果服務已移除,您必須先重新建立該服務,才可以還原資料。 請務必以相同的組態建立服務 (例如分割配置),如此才能順暢地還原資料。 一旦服務啟動後,就必須在此服務的每個分割區上叫用還原資料的 API (上述的 OnDataLossAsync)。 達到這個目標的其中一種方法是在每個分割區上使用 FabricClient.TestManagementClient.StartPartitionDataLossAsync

從這裡開始,實作與上述案例相同。 每個資料分割都需要從外部存放區還原最新的相關備份。 有一點需要注意,分割識別碼現在可能已變更,因為執行階段會以動態方式建立分割識別碼。 因此,服務需要儲存適當的分割資訊和服務名稱,來識別要針對每個分割區還原的正確最新備份。

注意

不建議在每個分割區上使用 FabricClient.ServiceManager.InvokeDataLossAsync 來還原整個服務,因為可能會損毀您的叢集狀態。

損毀之應用程式資料的複寫

如果新部署的應用程式升級有錯誤,可能會造成資料損毀。 例如,應用程式升級可能會開始以無效的區碼更新「可靠的字典」中的每個電話號碼記錄。 在此情況下,因為 Service Fabric 並不知道要儲存的資料本質,所以會複寫無效的電話號碼。

偵測造成資料損毀的這類嚴重錯誤之後,您要做的第一件事是在應用程式層級凍結服務,並且在可行時升級至沒有錯誤的應用程式程式碼的版本。 不過,即使在修正服務程式碼之後,資料仍可能會損毀,因此需要還原資料。 在這種情況下,還原最新的備份可能還不足夠,因為最新的備份也可能已損毀。 因此,您必須尋找在資料損毀之前所做的最後一個備份。

如果不確定哪些備份正確,您可以部署新的 Service Fabric 叢集,並還原受影響的分割區備份,就像上述「已刪除或遺失的服務」案例一樣。 針對每個資料分割,開始還原從最新到最舊的備份。 一旦您找到沒有損毀的備份,就移動/刪除這個資料分割較新 (相較於備份) 的所有備份。 針對每個資料分割重複此程序。 現在,當您在生產叢集中的分割區上呼叫 OnDataLossAsync 時,外部存放區中找到的最後一個備份會是上述程序所挑選的備份。

現在,可以使用「已刪除或遺失的服務」中的步驟,將服務的狀態還原至不良程式碼損毀狀態之前的狀態。

請注意:

  • 當您還原時,還原的備份很有可能是早於資料遺失之前的分割區狀態。 因此,您應該只能將還原當成最後手段,盡可能復原最多資料。
  • 根據 FabricDataRoot 路徑和應用程式類型名稱的長度而定,代表備份資料夾路徑與備份資料夾內檔案路徑的字串可以大於 255 個字元。 這會造成某些 .NET 方法 (例如 Directory.Move) 擲回 PathTooLongException 例外狀況。 有個解決方法是直接呼叫 kernel32 API,例如 CopyFile

備份與還原 Reliable Actors

Reliable Actors 架構以 Reliable Services 為基礎。 裝載動作項目的 ActorService 是具狀態可靠服務。 因此,Reliable Services 中可用的所有備份和還原功能,也可用於 Reliable Actors (狀態供應器特定的行為除外)。 因為是依個別分割區進行備份,將會備份該分割區中所有動作項目的狀態 (還原也一樣依個別分割區進行)。 若要執行備份/還原,服務擁有者應該建立一個衍生自 ActorService 類別的自訂動作項目服務類別,然後進行備份/還原,類似於前面幾節所述的 Reliable Services。

class MyCustomActorService : ActorService
{
    public MyCustomActorService(StatefulServiceContext context, ActorTypeInformation actorTypeInfo)
          : base(context, actorTypeInfo)
    {
    }
    
    //
    // Method overrides and other code.
    //
}

當您建立自訂動作項目服務類別時,您也必須在註冊動作項目時註冊該類別。

ActorRuntime.RegisterActorAsync<MyActor>(
    (context, typeInfo) => new MyCustomActorService(context, typeInfo)).GetAwaiter().GetResult();

Reliable Actors 的預設狀態供應器是 KvsActorStateProviderKvsActorStateProvider 依預設不啟用增量備份。 您可以建立 KvsActorStateProvider 並於建構函式中指定適當的設定,然後傳給 ActorService 建構函式,以啟用增量備份,如下列程式碼片段所示︰

class MyCustomActorService : ActorService
{
    public MyCustomActorService(StatefulServiceContext context, ActorTypeInformation actorTypeInfo)
          : base(context, actorTypeInfo, null, null, new KvsActorStateProvider(true)) // Enable incremental backup
    {
    }
    
    //
    // Method overrides and other code.
    //
}

啟用增量備份之後,進行增量備份可能會因為下列原因之一而失敗,結果傳回 FabricMissingFullBackupException,您將需要先進行完整備份,再進行增量備份︰

  • 複本自從變成主要以來從未進行完整備份。
  • 自上次備份以來,某些記錄檔記錄已被截斷。

啟用增量備份時,KvsActorStateProvider 不會使用循環緩衝區來管理其記錄資料列,也不會定期截斷。 如果使用者已有 45 分鐘沒有進行備份,系統會自動截斷記錄檔記錄。 您可以在 KvsActorStateProvider 建構函式中指定 logTruncationIntervalInMinutes 來設定此間隔 (類似於啟用增量備份時)。 如果主要複本需要傳送其所有資料來建立另一個複本,也可能會截斷記錄檔記錄。

從備份鏈結還原時,類似於 Reliable Services,BackupFolderPath 應該包含一些子目錄,其中一個子目錄包含完整備份,而其他子目錄包含增量備份。 如果備份鏈結驗證失敗,還原 API 會擲回 FabricException 並傳回適當的錯誤訊息。

注意

KvsActorStateProvider 目前會忽略 RestorePolicy.Safe 選項。 即將推出的版本已規劃支援這項功能。

測試備份和還原

請務必確保重要資料正在進行備份,並可進行還原。 在 PowerShell 中叫用會引起特定分割區遺失資料的 Start-ServiceFabricPartitionDataLoss Cmdlet,以測試您服務的資料備份和還原功能是否如預期般運作。 此外,也可能以程式設計方式叫用資料遺失,並從該事件進行還原。

注意

您可以在 GitHub 上的 Web 參考應用程式中,找到備份與還原功能的範例實作。 如需詳細資訊,請查看 Inventory.Service 服務。

幕後:備份與還原的詳細資料

以下是備份與還原的詳細資料。

Backup

可靠的狀態管理員能夠建立一致的備份,而不會封鎖任何讀取或寫入作業。 為了達到這個目的,它會利用檢查點和記錄持續性機制。 可靠的狀態管理員會在特定時間點採用模糊 (輕量型) 檢查點,來減輕交易記錄檔的壓力和改善復原時間。 呼叫 BackupAsync 時,可靠的狀態管理員會指示所有可靠物件,將其最新檢查點檔案複製到本機備份資料夾。 然後,可靠的狀態管理員會從「開始指標」開始,將所有記錄檔記錄複製到備份資料夾中的最新記錄檔記錄。 因為記錄到最新記錄資料列的所有記錄資料列都會包含於備份中,而且可靠的狀態管理員會保留預寫記錄,所以,可靠的狀態管理員保證所有已認可的交易 (CommitAsync 已順利傳回) 都會包含於備份中。

呼叫 BackupAsync 之後認可的任何交易,不一定會在備份中。 一旦由平台填入本機備份資料夾 (亦即執行階段完成的本機備份) 之後,即會叫用服務的備份回呼。 此回呼會負責將備份資料夾移到外部位置,例如 Azure 儲存體。

還原

可靠的狀態管理員能夠利用 RestoreAsync API,從備份還原。
僅可在 OnDataLossAsync 方法內部呼叫 RestoreContext 上的 RestoreAsync 方法。 OnDataLossAsync 傳回的 Bool 表示服務是否從外部來源還原其狀態。 如果 OnDataLossAsync 傳回 true,Service Fabric 將會從這個主要複本重建所有其他複本。 Service Fabric 可確保將接收 OnDataLossAsync 呼叫的複本會先轉換成主要角色,但不會被授與讀取狀態或寫入狀態。 這暗示對於 StatefulService 實施者而言,將不會呼叫 RunAsync,直到 OnDataLossAsync 成功完成為止。 然後,會在新的主要複本上叫用 OnDataLossAsync。 在服務成功完成此 API (藉由傳回 true 或 false) 並完成相關重新設定之前,將會一次一個地繼續呼叫 API。

RestoreAsync 會在過去曾呼叫的主要複本中先卸除所有現有狀態。 然後,可靠的狀態管理員會建立存在於備份資料夾中所有可靠的物件。 接下來,可靠的物件會獲得指示從其備份資料夾中的檢查點還原。 最後,可靠的狀態管理員會從備份資料夾中的記錄檔記錄復原自己的狀態,並執行復原。 在復原程序的過程中,作業是從「開始點」開始,在備份資料夾中認可記錄檔記錄,並對可靠的物件重新執行。 這個步驟可確保復原的狀態一致。

下一步