文件

MinIO 物件鎖定

概觀

MinIO 物件鎖定(「物件保留」)強制執行「單次寫入、多次讀取 (WORM)」不可變性,以保護 已版本控制的物件 免遭刪除。MinIO 支援 基於持續時間的物件保留無限期的法律保留

根據 Cohasset Associates 的說法,MinIO 物件鎖定提供關鍵的資料保留合規性,並符合 SEC17a-4(f)、FINRA 4511(C) 和 CFTC 1.31(c)-(d) 的要求。

MinIO 物件鎖定與 AWS S3 在功能和 API 上相容。此頁面概述了 MinIO 實作的物件鎖定/保留概念。有關其他資源,請參閱 AWS S3 文件中的 S3 物件鎖定的工作方式

您只能在建立儲存貯體時啟用物件鎖定,如 S3 行為。您無法在未啟用鎖定的情況下建立的儲存貯體上啟用物件鎖定。然後,您可以隨時設定物件保留規則。物件鎖定需要 版本控制,並隱式啟用該功能。

與版本控制互動

受 WORM 鎖定保護的物件在鎖定到期或明確解除鎖定之前是不可變的。鎖定是按物件版本進行的,其中每個版本都是獨立不可變的。

如果應用程式對已鎖定的物件執行未版本化的刪除操作,該操作會產生一個刪除標記。嘗試明確刪除任何 WORM 鎖定的物件都會因錯誤而失敗。刪除標記符合 WORM 鎖定保護的資格。有關更多資訊,請參閱 S3 文件中關於管理刪除標記和物件生命週期的說明。

例如,考慮以下預設啟用治理模式鎖定的儲存桶

$ mc ls --versions play/locking-guide

  [DATETIME]    29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
  [DATETIME]    32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
  [DATETIME]    23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv

嘗試對 data.csv特定版本執行刪除會因物件鎖定設定而失敗

$ mc rm --version-id 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 play/data.csv

  Removing `play/locking-guide/data.csv` (versionId=62429eb1-9cb7-4dc5-b507-9cc23d0cc691).
  mc: <ERROR> Failed to remove `play/locking-guide/data.csv`.
      Object, 'data.csv (Version ID=62429eb1-9cb7-4dc5-b507-9cc23d0cc691)' is
      WORM protected and cannot be overwritten

嘗試對 data.csv 執行未版本化的刪除會成功,並為該物件建立一個新的 DeleteMarker

$ mc rm play/locking-guide/data.csv

  [DATETIME]     0B acce329f-ad32-46d9-8649-5fe8bf4ec6e0 v4 DEL data.csv
  [DATETIME]    29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
  [DATETIME]    32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
  [DATETIME]    23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv

與生命週期管理的互動

MinIO 物件過期會遵守過期規則所涵蓋物件的任何有效物件鎖定和保留設定。

  • 對於僅針對目前物件版本運作的過期規則,MinIO 會為鎖定的物件建立一個刪除標記。

  • 對於針對非目前物件版本運作的過期規則,MinIO 僅能在保留期過後已明確解除(例如法律保留)之後,才能使非目前版本過期。

例如,考慮以下預設啟用 45 天治理模式鎖定的儲存桶

$ mc ls --versions play/locking-guide

  [7D]    29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
  [30D]    32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
  [60D]    23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv

為早於 7 天的目前物件建立過期規則會導致該物件產生刪除標記

$ mc ls --versions play/locking-guide

  [0D]     0B acce329f-ad32-46d9-8649-5fe8bf4ec6e0 v4 DEL data.csv
  [7D]    29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
  [30D]    32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
  [60D]    23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv

但是,針對早於 7 天的非目前物件的過期規則,只有在設定的 WORM 鎖定過期才會生效。由於儲存桶設定了 45 天的 GOVERNANCE 保留期,因此只有 data.csvv1 版本被解鎖,因此符合刪除的條件。

教學

建立啟用物件鎖定的儲存桶

您必須根據 S3 的行為,在建立儲存桶時啟用物件鎖定。您可以使用 MinIO 主控台、MinIO mc CLI 或使用與 S3 相容的 SDK 建立啟用物件鎖定的儲存桶。

選取 MinIO 主控台的儲存桶區段以存取儲存桶建立和管理功能。從儲存桶清單中選取儲存桶列。您可以使用 搜尋列來篩選清單。

MinIO Console Bucket Management

按一下建立儲存桶按鈕以開啟儲存桶建立模式。切換物件鎖定選取器以在儲存桶上啟用物件鎖定。

MinIO Console Bucket Management

使用帶有 --with-lock 選項的 mc mb 命令來建立啟用物件鎖定的儲存桶

mc mb --with-lock ALIAS/BUCKET
  • ALIAS 替換為已設定的 MinIO 部署的別名

  • BUCKET 替換為要建立的儲存桶的名稱

設定儲存桶預設物件保留

您可以使用 MinIO 主控台、MinIO mc CLI 或使用與 S3 相容的 SDK 設定物件鎖定規則(「物件保留」)。

MinIO 支援設定儲存桶預設每個物件保留規則。以下範例設定儲存桶預設保留。對於每個物件的保留設定,請參考您偏好的 SDK 所使用的 PUT 操作的文件。

選取 MinIO 主控台的儲存桶區段以存取儲存桶建立和管理功能。您可以使用 搜尋列來篩選清單。

MinIO Console Bucket Management

每個儲存桶列都有一個管理按鈕,可開啟該儲存桶的管理檢視。

MinIO Console Bucket Management

保留區段中,選取已啟用。此區段僅適用於建立時已啟用物件鎖定的儲存桶。

設定保留配置模式中,設定所需的儲存桶預設保留設定。

  • 對於保留模式,請選取合規模式治理模式

  • 對於期間,請選取的保留期間單位。

  • 對於保留有效性,請設定 MinIO 在指定儲存桶的保留模式下保留物件的時間長度。

使用帶有 --recursive--default 選項的 mc retention set 命令來設定儲存桶的預設保留模式

mc retention set --recursive --default MODE DURATION ALIAS/BUCKET

物件保留模式

MinIO 實作以下S3 物件鎖定模式

模式

摘要

GOVERNANCE 模式

防止非特權使用者執行任何會變更或修改物件或其鎖定設定的操作。

在儲存桶或物件上具有s3:BypassGovernanceRetention權限的使用者可以修改物件或其鎖定設定。

在設定的保留規則持續時間過後,MinIO 會自動解除鎖定。

COMPLIANCE 模式

防止任何會變更或修改物件或其鎖定設定的操作。

沒有 MinIO 使用者可以修改物件或其設定,包括MinIO root使用者。

在設定的保留規則持續時間過後,MinIO 會自動解除鎖定。

治理模式

處於 GOVERNANCE 鎖定下的物件會受到保護,不會受到非特權使用者的寫入操作。

使用 GOVERNANCE 鎖定的物件會強制執行受管理的不可變性,具有 s3:BypassGovernanceRetention 行動權限的使用者可以修改鎖定的物件、變更保留期限或完全解除鎖定。繞過 GOVERNANCE 保留也需要在請求中設定 x-amz-bypass-governance-retention:true 標頭。

MinIO 的 GOVERNANCE 鎖定功能與 S3 GOVERNANCE 模式完全相同。

合規模式 (COMPLIANCE Mode)

處於 COMPLIANCE 鎖定下的物件會受到保護,所有 使用者(包括 MinIO root 使用者)都無法對其執行寫入操作。

使用 COMPLIANCE 鎖定的物件會強制執行鎖定物件的完全不可變性。在設定的保留期限結束之前,您無法變更或移除鎖定。

MinIO 的 COMPLIANCE 鎖定功能與 S3 COMPLIANCE 模式完全相同。