将对象从 MinIO 迁移到 GCS

安装和配置 mc

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

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

所需的 MinIO 权限

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

• s3:PutLifecycleConfiguration

• s3:GetLifecycleConfiguration

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

• admin:SetTier

• admin:ListTier

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

{
   "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"
      }
   ]
}

所需的 GCS 权限

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

有关配置所需权限的更完整指南，请参阅 GCS IAM 权限 文档。

远程存储桶必须存在

在使用该存储桶作为目标配置生命周期管理层级或规则之前，请创建远程 GCS 存储桶。

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

生命周期管理对象扫描器

MinIO 使用 扫描器进程 检查对象是否符合所有已配置的生命周期管理规则。由于高 IO 工作负载或系统资源有限导致的扫描缓慢可能会延迟生命周期管理规则的应用。有关更多信息，请参阅 生命周期管理对象扫描器。

远程数据的独占访问

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

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

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

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

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

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

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

远程数据的可用性

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

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

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

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

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

以下示例使用 Alpha 作为 MinIO 部署的占位符 别名。将此值替换为您正在配置生命周期管理规则的 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 命令添加一个新的 Google Cloud Storage 服务作为远程存储层

mc ilm tier add gcs TARGET TIER_NAME \
   --bucket BUCKET \
   --prefix PREFIX \
   --credentials-file CREDENTIALS \
   --storage-class STORAGE_CLASS

以上示例使用以下参数

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

以上示例指定以下参数

4) 验证转换规则

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

mc ilm rule ls ALIAS/PATH --transition

• 将 ALIAS 替换为 MinIO 部署的 alias。

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