文档

MinIO 对象锁定

概述

MinIO 对象锁定(“对象保留”)对已版本化对象强制执行一次写入多次读取 (WORM) 不变性,以防止删除。MinIO 支持基于时间的对象保留无限期法律保留

MinIO 对象锁定提供关键数据保留合规性,并满足 SEC17a-4(f)、FINRA 4511(C) 和 CFTC 1.31(c)-(d) 的要求,根据 Cohasset Associates

MinIO 对象锁定是AWS S3 的功能和 API 兼容。此页面汇总了 MinIO 实施的对象锁定/保留概念。有关更多资源,请参阅有关 S3 对象锁定工作原理 的 AWS S3 文档。

您只能在存储桶创建期间启用对象锁定,根据 S3 行为。您不能在没有启用锁定的存储桶上启用对象锁定。然后,您可以随时配置对象保留规则。对象锁定需要版本控制,并且会隐式启用该功能。

与版本控制的交互

在 WORM 锁定下保存的对象在锁定过期或显式解除之前是不可变的。锁定按对象版本进行,每个版本都是独立不可变的。

如果应用程序对已锁定对象执行非版本化删除操作,该操作将生成一个删除标记。尝试显式删除任何 WORM 锁定对象都会失败并出现错误。删除标记符合 WORM 锁定下的保护条件。有关更多信息,请参见 S3 文档中的管理删除标记和对象生命周期

例如,考虑以下带有GOVERNANCE 模式锁定的存储桶,该模式默认启用。

$ 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 天启用GOVERNANCE 模式锁定。

$ 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

使用mc mb命令以及--with-lock选项来创建启用对象锁定的存储桶。

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

保留部分,选择已启用。此部分仅对使用启用对象锁定的存储桶创建的存储桶可见。

设置保留配置模态中,设置所需的存储桶默认保留设置。

  • 对于保留模式,选择COMPLIANCEGOVERNANCE

  • 对于持续时间,选择的保留持续时间单位。

  • 对于保留有效期,设置 MinIO 在指定的存储桶保留模式下保存对象的时间长度。

使用mc retention set命令以及--recursive--default选项来设置存储桶的默认保留模式。

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

对象保留模式

MinIO 实施了以下S3 对象锁定模式

模式

摘要

GOVERNANCE 模式

防止任何非特权用户会更改或修改对象或其锁定设置的操作。

具有s3:BypassGovernanceRetention权限的用户可以修改对象或其锁定设置。

MinIO 会在配置的保留规则持续时间过后自动解除锁定。

COMPLIANCE 模式

防止任何会更改或修改对象或其锁定设置的操作。

没有 MinIO 用户可以修改对象或其设置,包括MinIO root用户。

MinIO 会在配置的保留规则持续时间过后自动解除锁定。

GOVERNANCE 模式

处于GOVERNANCE锁定下的对象受到非特权用户的写入操作保护。

GOVERNANCE 锁定对象强制对锁定对象进行受管的不可变性,其中具有 s3:BypassGovernanceRetention 操作权限的用户可以修改锁定对象,更改保留期限,或完全解除锁定。绕过 GOVERNANCE 保留还需要在请求中设置 x-amz-bypass-governance-retention:true 标头。

MinIO GOVERNANCE 锁定在功能上与 S3 GOVERNANCE 模式 相同。

合规模式

处于 COMPLIANCE 锁定状态的对象受到所有用户的写入操作保护,包括 MinIO root 用户。

COMPLIANCE 锁定对象强制对锁定对象进行完全不可变性。在配置的保留期限过去之前,您不能更改或删除锁定。

MinIO COMPLIANCE 锁定在功能上与 S3 COMPLIANCE 模式 相同。