文档

将对象从 MinIO 迁移到 Azure

此页面上的步骤创建了一个新的对象生命周期管理规则,该规则将对象从 MinIO 存储桶迁移到 Azure 存储后端上的远程存储层。此步骤支持诸如在一段时间或日历日期后将旧数据移动到低成本公有云存储解决方案等用例。

需求

安装和配置 mc

此步骤使用 mc 对 MinIO 集群执行操作。在具有对源和目标集群的网络访问权限的机器上安装 mc。有关下载和安装 mc 的说明,请参阅 mc安装快速入门

使用 mc alias set 命令为源 MinIO 集群创建别名。创建别名需要为源和目标集群上的用户指定访问密钥。指定的用户必须具有 权限 以配置和应用转换操作。

所需的 MinIO 权限

MinIO 需要以下权限,这些权限范围限定在您为其创建生命周期管理规则的存储桶或存储桶。

MinIO 还需要在您为对象转换生命周期管理规则创建远程层级的集群上执行以下管理权限

例如,以下策略提供了在集群中任何存储桶上配置对象转换生命周期管理规则的权限。

{
   "Version": "2012-10-17",
   "Statement": [
      {
            "Action": [
               "admin:SetTier",
               "admin:ListTier"
            ],
            "Effect": "Allow",
            "Sid": "EnableRemoteTierManagement"
      },
      {
            "Action": [
               "s3:PutLifecycleConfiguration",
               "s3:GetLifecycleConfiguration"
            ],
            "Resource": [
                        "arn:aws:s3:::*"
            ],
            "Effect": "Allow",
            "Sid": "EnableLifecycleManagementRules"
      }
   ]
}

所需的 Azure 权限

对象转换生命周期管理规则需要远程存储层级上的其他权限。具体来说,MinIO 需要 Azure 凭据提供对远程存储帐户和容器的读取、写入、列出和删除权限。

请参阅 Azure RBAC 文档以获取有关配置所需权限的更完整指南。

远程存储帐户和容器必须存在

在使用该资源作为目标配置生命周期管理层级或规则之前,创建远程 Azure 存储帐户 和容器。创建 Azure 存储帐户 时,请确保存储帐户对应于具有本地冗余存储 (LRS) 冗余选项的标准或高级 Blob 存储。MinIO 使用的 Azure Go SDK API 不支持任何其他冗余选项。

如果设置了存储帐户 默认访问层级,则如果在定义远程层级时未指定 storage class,MinIO 将使用该默认值。请确保记录 Azure 存储帐户和 MinIO 分层配置的设置,以避免任何潜在的混淆、错误配置或其他意外结果。

有关 Azure 存储帐户的更多信息,请参阅 存储帐户

注意事项

对远程数据的独占访问

MinIO需要对远程存储层级上的转换数据进行独占访问。“热”MinIO 源上的对象元数据与“温/冷”远程层级上的对象数据紧密关联。MinIO 无法在没有访问远程的情况下检索对象数据,远程也无法用于恢复源上的丢失元数据。

对转换对象的所有访问必须仅通过 MinIO 通过 S3 API 操作进行。手动修改转换对象(无论是“热”MinIO 层级上的元数据还是远程“温/冷”层级上的对象数据)都可能导致该对象数据丢失。

MinIO 忽略远程存储桶或存储桶前缀中未由 MinIO 部署明确管理的任何对象。自动转换和透明对象检索取决于以下假设

  • 远程存储上没有外部变异、迁移或删除对象。

  • 远程存储桶上没有生命周期管理规则(例如转换或过期)。

MinIO 将所有转换后的对象存储在远程存储桶或资源中,位于唯一的每个部署前缀值下。此值并非旨在支持从后端识别源部署。MinIO 在配置远程目标时支持一个额外的可选人类可读前缀,这可能有助于与诊断、维护或灾难恢复相关的操作。

对于包含其他数据的远程存储层级(包括来自其他 MinIO 部署的转换对象),MinIO 建议指定此可选前缀。本教程包含设置此前缀的必要语法。

重要

MinIO不支持更改与 Azure 远程层级关联的帐户名称。Azure 存储后端与帐户绑定,因此更改帐户将更改存储后端并阻止访问转换到原始帐户/后端的任何对象。

如果您需要围绕配置 Azure 远程层级的特定情况的指导,请联系 MinIO 支持

远程数据的可用性

MinIO 分层行为取决于远程存储在请求时立即(毫秒到秒)返回对象。因此,MinIO无法支持需要重新水化、等待时间或人工干预的远程存储。

MinIO 为每个转换的对象创建元数据,以标识其在远程存储上的位置。应用程序无法独立于 MinIO 轻松识别和访问转换后的对象。因此,转换数据的可用性取决于与 擦除编码 和分布式部署拓扑为 MinIO 部署上的所有对象提供的相同核心保护。使用对象转换不会提供任何额外的业务连续性或灾难恢复优势。

需要 BC/DR 保护的工作负载应实施 MinIO 服务器端复制。复制确保对象保留在远程复制站点上,以便您可以在发生部分或全部数据丢失的情况下从远程重新同步。请参阅 重新同步(灾难恢复) 以获取有关使用复制在发生部分或全部数据丢失后恢复的更完整文档。

过程

1) 为生命周期管理配置用户帐户和策略

此步骤在 MinIO 部署中创建用户和策略,以支持生命周期管理操作。如果部署已经拥有具有必要 权限 的用户,则可以跳过此步骤。

以下示例使用 Alpha 作为 MinIO 部署的占位符 alias。将此值替换为您正在其上配置生命周期管理规则的 MinIO 部署的相应别名。将密码 LongRandomSecretKey 替换为一个长、随机且安全的密钥,符合您组织的密码生成最佳实践。

wget -O - https://min-io.cn/docs/minio/linux/examples/LifecycleManagementAdmin.json | \
mc admin policy create Alpha LifecycleAdminPolicy /dev/stdin
mc admin user add Alpha alphaLifecycleAdmin LongRandomSecretKey
mc admin policy attach Alpha LifecycleAdminPolicy --user=alphaLifecycleAdmin

此示例假设指定的别名具有在部署上创建策略和用户的必要权限。请参阅 用户管理MinIO 基于策略的访问控制 以获取有关 MinIO 用户和策略的更完整文档。

2) 配置远程存储层级

使用 mc ilm tier add 命令添加新的远程存储层级

mc ilm tier add azure TARGET TIER_NAME \
   --account-name ACCOUNT \
   --account-key KEY \
   --bucket CONTAINER \
   --endpoint ENDPOINT \
   --prefix PREFIX \
   --storage-class STORAGE_CLASS

以上示例使用以下参数

参数

描述

TARGET

要为其配置远程层级的 MinIO 部署的 alias

TIER_NAME

与新的 Azure Blob 远程存储层级关联的名称。请全部大写指定名称,例如 AZURE_TIER。此值在下一步中是必需的。

ACCOUNT

用作远程存储资源的 存储帐户

创建层级后,无法更改此帐户名称。

KEY

指定 ACCOUNT 的相应共享帐户密钥。

帐户密钥必须具有分配的 Azure 策略,该策略具有所需的 权限

请参阅 管理存储帐户访问密钥 以获取更多信息。

CONTAINER

Azure 存储后端上容器的名称,MinIO 将对象转换到该容器。

ENDPOINT

(可选) Azure Blob 存储后端的完整 URL,MinIO 将对象转换到该后端。如果未指定,则默认为 https://ACCOUNT.blob.core.windows.net

PREFIX

MinIO 将对象转换到的可选容器前缀。

MinIO 将所有转换后的对象存储在指定的 BUCKET 中,并在每个部署的唯一前缀值下进行存储。省略此参数仅使用该值来隔离和组织远程存储中的数据。

MinIO 建议为包含其他数据的远程存储层指定此可选前缀,包括来自其他 MinIO 部署的转换对象。此前缀应提供清晰的参考,指回源 MinIO 部署,以便于执行与诊断、维护或灾难恢复相关的操作。

STORAGE_CLASS

MinIO 应用于转换到 Azure 容器的对象的 Azure 访问层。

MinIO 分层行为取决于远程存储在请求时立即(毫秒到秒)返回对象。因此,MinIO无法支持需要重新水化、等待时间或人工干预的远程存储。

以下 Azure 访问层满足 MinIO 作为远程层的需求

  • 热存储

  • 冷存储

有关更多信息,请参阅 Blob 数据的热、冷和归档访问层

3) 创建和应用转换规则

使用 mc ilm rule add 命令为存储桶创建新的转换规则。以下示例配置在指定日历天数后进行转换

mc ilm rule add ALIAS/BUCKET \
--transition-tier TIERNAME \
--transition-days DAYS \
--noncurrent-transition-days NONCURRENT_DAYS
--noncurrent-transition-tier TIERNAME

以上示例指定了以下参数

参数

描述

ALIAS

指定您要为其创建生命周期管理规则的 MinIO 部署的 别名

BUCKET

指定您要为其创建生命周期管理规则的存储桶的完整路径。

TIERNAME

MinIO 将对象转换到的远程存储层。指定上一步中创建的远程存储层名称。

如果要将非当前对象版本转换到不同的远程层,请为 --noncurrent-transition-tier 指定不同的层名称。

DAYS

MinIO 将对象标记为可进行转换的日历天数。将天数指定为整数,例如 30 表示 30 天。

NONCURRENT_DAYS

MinIO 将非当前对象版本标记为可进行转换的日历天数。MinIO 特别是衡量对象变为非当前的时间,而不是对象创建时间。将天数指定为整数,例如 90 表示 90 天。

省略此值以忽略非当前对象版本。

此选项对非版本化存储桶无效。

4) 验证转换规则

使用 mc ilm rule ls 命令查看已配置的转换规则

mc ilm rule ls ALIAS/PATH --transition
  • ALIAS 替换为您要为其查看规则的 MinIO 部署的 别名

  • PATH 替换为要为其检索已配置生命周期管理规则的存储桶的名称。