共用方式為


在 Azure Container Registry (預覽版) 中使用虛刪除原則復原已刪除的成品

Azure 容器登錄檔(ACR)允許你啟用 軟刪除政策 ,讓你在設定的保留期限內恢復意外刪除的產出物。

重要事項

虛刪除原則目前為預覽版。 請參閱 Microsoft Azure 預覽版增補使用規定,以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版,或尚未正式發行的版本) 的法律條款。

你可以隨時在 Azure 入口網站或使用 Azure CLI 來啟用或停用軟刪除政策。 當你在 ACR 啟用軟刪除政策時,登錄檔會將所有已刪除的產物視為軟刪除產出品,並有固定保留期。 在保留期間內,您可以列出、篩選並還原所有已刪除的文物。 保留期結束後,軟刪除的產物將永久刪除,無法恢復。

軟刪除構件的生命週期示意圖。

虛刪除的成品預設保留期為七天,但您可以選擇 1 到 90 天之間的任意值。 您可以設定、更新和變更保留原則值。 軟刪除的物件在保留期結束後即會過期。

自動清除功能每 24 小時執行一次,且在永久刪除檔案前,總是會考慮當前的保留天數。 例如,如果你在五天前刪除了一個文物,然後將保留值從 7 天改為 14 天,該文物會在刪除日期起 14 天後失效。

此預覽功能適用於所有 服務層級 (也稱為 SKU)。

附註

已虛刪除的成品仍會依照作用中 SKU 的儲存體定價計費。

請記住下列目前限制:

  • Azure 容器登錄檔目前不支援手動清除軟刪除的產物。
  • 虛刪除原則不支援設定為區域備援或異地複寫的登錄。
  • Azure 容器登錄檔不允許同時啟用 保留政策 和軟刪除政策。

先決條件

  • 如果您沒有 Azure 帳戶,請在開始之前建立 免費帳戶

  • 執行軟刪除操作時,使用者需在容器登錄層級具備以下權限:

    • Microsoft.ContainerRegistry/registries/deleted/read:列出軟刪除的構件
    • Microsoft.ContainerRegistry/registries/deleted/restore/action:還原已虛刪除的成品
  • 對於 Azure CLI,你可以使用 Azure Cloud Shell 或本地安裝來執行本文列出的指令。 我們建議使用最新版本的 Azure CLI。 如果您需要安裝或升級,請參閱如何安裝 Azure CLI

啟用虛刪除原則

你可以在 Azure 入口網站或使用 Azure CLI 啟用 Azure 容器登錄檔的軟刪除政策。

  1. 在 Azure 入口網站中移至您的 Azure Container Registry。
  2. 總覽中,檢查 軟刪除(預覽)的狀態。
  3. 如果 狀態停用,請選擇 停用 以開啟 屬性 面板。
  4. 選擇 軟刪除 的勾選框。
  5. 輸入1到90之間的天數以保留已刪除的項目。
  6. 選取 [儲存]。

截圖顯示在 Azure 入口網站啟用軟刪除的選項。

當啟用軟刪除,並執行如取消標籤清單或刪除文物等操作時,您可以在保留期限屆滿前選擇 「管理已刪除文物 」,如下一節所述,查看這些標籤與文物。

檢視並還原已虛刪除的成品

您可以在目前儲存庫設定的保留期間內查看並還原軟刪除的產物。 請記住以下考量:

  • 您無法將已虛刪除的映像匯入至來源和目標資源。
  • 將映像檔推送到軟刪除的儲存庫會恢復該儲存庫。
  • 不允許推送與已虛刪除的映像具有相同資訊清單摘要的映像。 請改為還原該已虛刪除的映像。

還原已虛刪除的成品

  1. 在 Azure 入口網站中移至您的 Azure Container Registry。

  2. 在服務選單中,在 服務區選擇 儲存庫

  3. 倉庫中選擇一個儲存庫。

  4. 選擇 「管理已刪除的文物」。

    截圖顯示如何在 Azure 入口網站中存取「管理已刪除的文物」選項。

  5. 在你想還原的已刪除文物列中,選擇 還原

  6. 還原工件 選區,選擇要還原的標籤。 你只能選擇一個標籤來恢復你的文物。 若要恢復額外的標記,您必須個別還原它們。

  7. 選取 還原

還原軟刪除的儲存庫

  1. 在 Azure 入口網站中移至您的 Azure Container Registry。
  2. 在服務選單中,在 服務區選擇 儲存庫
  3. 倉庫中選擇一個儲存庫。
  4. 選擇 管理已刪除的儲存庫
  5. 在你想還原的已刪除儲存庫列中,選擇 還原
  6. 還原工件 選區,選擇要還原的標籤。 你只能選擇一個標籤來還原你的儲存庫。 若要恢復額外的標記,您必須個別還原它們。
  7. 選取 [還原]

後續步驟