存储桶版本控制

• Versioning overview
• Versioning lab

概述

MinIO 支持在单个存储桶中保留对象的多个“版本”。

启用后，版本控制允许 MinIO 保留同一对象的多个迭代版本。 原本会覆盖现有对象的写入操作，将改为为该对象创建一个新版本。 MinIO 版本控制可以防止意外覆盖和删除，同时支持对写入操作执行“撤销”。 配置 对象锁定和保留规则 的前提条件之一，就是启用存储桶版本控制。

对于已启用版本控制的存储桶，写入操作会为该对象创建一个带有唯一版本 ID 的新版本。 MinIO 会将对象的“最新”版本标记为客户端默认获取的版本。 之后，客户端可以显式选择列出、获取或移除某个特定对象版本。

可以定义 对象过期 规则，按版本数量或版本日期等条件移除不再需要的对象版本。

带版本对象的读取操作

查看本组中的四张图片，了解 MinIO 如何在启用版本控制的存储桶中获取对象。 使用图片两侧的箭头可在各张图片之间切换。

‹

单一版本对象MinIO 会在写入操作中为每个对象添加唯一的版本 ID。

多版本对象MinIO 会保留对象的所有版本，并将最近的版本标记为“最新”版本。

获取对象最新版本未指定版本 ID 的读取请求会返回该对象的最新版本。

获取特定对象版本在读取操作中指定版本 ID，即可获取对象的特定版本。

›

MinIO 会根据对象路径隐式推断前缀。 显式创建前缀通常只会出现在 Spark 及类似工作负载中，这类工作负载会在 S3 场景下采用传统 POSIX/HDFS 的目录创建行为。

版本控制按命名空间生效

MinIO 使用对象的完整命名空间（即存储桶和对象路径）来判断对象的唯一性。 例如，下列所有命名空间都对应“唯一”对象，对其中任一对象的变更，都会在该命名空间下创建新的对象版本：

databucket/object.blob
databucket/blobs/object.blob
blobbucket/object.blob
blobbucket/blobs/object.blob

尽管各个命名空间中的 object.blob 可能是相同的二进制数据， MinIO 仅在特定命名空间内实施版本控制，因此会将上面的每个 object.blob 视为彼此独立且唯一的对象。

版本控制与存储容量

MinIO 不执行增量式或差异式版本控制。 对于频繁变更的工作负载，较旧或老化的对象版本可能会占用大量磁盘空间。

例如，假设一个包含日志数据的对象大小为 1GB。应用向该日志追加 100MB 数据后重新上传到 MinIO。 此时 MinIO 会同时保存该对象的 1GB 和 1.1GB 两个版本。 如果应用连续 10 天每天都重复这一过程，那么该存储桶最终会为这一个对象累计保存超过 14GB 的数据。

MinIO 支持配置 对象生命周期管理规则，以自动过期或过渡老旧对象版本并释放存储容量。 例如，你可以配置一条规则，使对象版本在变为非当前版本（即不再是该对象的“最新”版本）90 天后自动过期。 更多信息请参见 MinIO 对象过期。

你也可以使用以下命令手动移除对象版本：

• mc rm --versions - 删除对象的所有版本。

• mc rm --versions --older-than -

  删除对象中早于指定日历日期的所有版本。

版本 ID 生成

MinIO 会在写入操作中为每个对象版本生成唯一且不可变的标识符。 每个对象版本 ID 都由一个 128 位固定长度的 UUIDv4 组成。 UUID 的生成具有足够随机性，可在任何环境中以极高概率保证唯一性，计算上也难以猜测，并且无需依赖中心化注册流程或机构来保证唯一性。

MinIO 不支持由客户端管理版本 ID 的分配。 所有版本 ID 的生成都由 MinIO 服务端进程处理。

对于在版本控制禁用或挂起期间创建的对象，MinIO 会使用 null 版本 ID。 在 S3 操作中将 null 指定为版本 ID，即可访问或移除这些对象。

版本控制下的删除操作

对带版本的对象执行 DELETE 操作时，会创建一个 0 字节的 DeleteMarker 作为该对象的最新版本。 如果对象的最新版本是 DeleteMarker，客户端必须指定版本控制相关标志或标识符，才能对该对象的先前版本执行 GET/HEAD/LIST/DELETE 操作。 在未显式指定版本的操作中，服务端默认会忽略 DeleteMarker 对象。

MinIO 可以利用 生命周期管理过期规则 自动永久移除对象的旧版本。 否则，可使用手动 DELETE 操作永久删除非当前版本对象或 DeleteMarker 对象。

若要永久删除某个对象版本，请执行 DELETE 操作并指定待删除对象的版本 ID。 这种删除操作不可逆。

‹

删除对象对带版本的对象执行 DELETE 操作时，会为该对象生成一个 DeleteMarker。

读取已删除对象客户端默认获取对象的“最新”版本。 如果最新版本是 DeleteMarker，MinIO 会返回类似 404 的响应。

获取已删除对象的先前版本即使“最新”版本是 DeleteMarker，客户端仍可通过指定版本 ID 获取该对象的任意先前版本。

删除特定对象版本客户端可在 DELETE 操作中指定版本 ID，以删除某个特定对象版本。 删除特定版本属于永久删除，不会创建 DeleteMarker。

›

以下 mc 命令可用于处理 DeleteMarkers 或带版本的对象：

• 使用 mc ls --versions 查看对象的所有版本，包括删除标记。
• 使用 mc cp --version-id=UUID ... 获取 UUID 匹配的“已删除”对象版本。
• 使用 mc rm --version-id=UUID ... 删除 UUID 匹配的对象版本。
• 使用 mc rm --versions 删除对象的所有版本。

教程

启用存储桶版本控制

你可以使用 MinIO Console、MinIO mc CLI 或兼容 S3 的 SDK 启用版本控制。

使用 mc version enable 命令为现有存储桶启用版本控制：

mc version enable ALIAS/BUCKET

• 将 ALIAS 替换为已配置 MinIO 部署的 alias。
• 将 BUCKET 替换为要启用版本控制的 目标存储桶。

在启用版本控制之前创建的对象，其 版本 ID 为 null。

从版本控制中排除前缀

你可以使用 MinIO Client 将某些 前缀 排除在版本控制之外。 这对于 Spark/Hadoop 等起初会使用临时前缀创建对象的工作负载尤其有用。

• 使用带 --excluded-prefixes 选项的 mc version enable：

  mc version enable --excluded-prefixes "prefix1, prefix2" ALIAS/BUCKET
  

  • 将 ALIAS 替换为已配置 MinIO 部署的 alias。
  • 将 BUCKET 替换为要为其排除 前缀 的 存储桶 名称。

--excluded-prefixes 中的前缀列表会匹配前缀或名称中包含指定字符串的所有对象，其行为类似 prefix* 形式的正则表达式。 若仅按前缀匹配对象，请使用 prefix/*。

例如，以下命令会将前缀或名称中包含 _test 或 _temp 的对象排除在版本控制之外：

mc version enable --excluded-prefixes "_test, _temp" local/my-bucket

每个存储桶最多可排除 10 个前缀。 若要添加或移除前缀，请使用更新后的列表再次执行 mc version enable 命令。 新列表会替换先前的列表。

若要查看当前排除的前缀，请使用带 --json 选项的 mc version info：

mc version info ALIAS/BUCKET --json

命令输出类似如下，排除前缀列表位于 ExcludedPrefixes 属性中：

$ mc version info local/my-bucket --json
{
 "Op": "info",
 "status": "success",
 "url": "local/my-bucket",
 "versioning": {
  "status": "Enabled",
  "MFADelete": "",
  "ExcludedPrefixes": [
   "prefix1, prefix2"
  ]
 }
}

若要禁用前缀排除并恢复对所有前缀启用版本控制，请在不带 --excluded-prefixes 的情况下再次执行 mc version enable：

mc version enable ALIAS/BUCKET

从版本控制中排除文件夹

你可以使用 MinIO Client 将文件夹排除在版本控制之外。

• 使用带 --exclude-folders 选项的 mc version enable，将名称以 / 结尾的对象排除在版本控制之外：

  mc version enable --exclude-folders ALIAS/BUCKET
  

  • 将 ALIAS 替换为已配置 MinIO 部署的 alias。
  • 将 BUCKET 替换为要为其排除 文件夹 的 存储桶。

若要检查某个存储桶中的文件夹是否启用版本控制，请使用带 --json 选项的 mc version enable 命令。 如果 ExcludeFolders 属性为 true，则该存储桶中的文件夹不启用版本控制。

mc version enable --excluded-prefixes ALIAS/BUCKET --json

命令输出类似如下：

$ mc version info local/my-bucket --json
{
 "Op": "info",
 "status": "success",
 "url": "local/my-bucket",
 "versioning": {
  "status": "Enabled",
  "MFADelete": "",
  "ExcludeFolders": true
 }
}

若要禁用文件夹排除并恢复对所有文件夹启用版本控制，请在不带 --exclude-folders 的情况下再次执行 mc version enable：

mc version enable ALIAS/BUCKET

挂起存储桶版本控制

你可以随时使用 MinIO mc CLI 或兼容 S3 的 SDK 挂起存储桶版本控制。

使用 mc version suspend 命令挂起现有存储桶的版本控制：

mc version suspend ALIAS/BUCKET

• 将 ALIAS 替换为已配置 MinIO 部署的 alias。
• 将 BUCKET 替换为要禁用版本控制的 目标存储桶。

在版本控制挂起期间创建的对象会被分配一个 null 版本 ID。 在版本控制挂起期间，对对象的任何变更都会覆盖该 null 版本对象。 MinIO 在挂起版本控制时不会删除或以其他方式更改已有的对象版本。 客户端仍可继续与存储桶中已有的各个对象版本进行交互。