mc admin tier

描述

mc admin tier 命令用于配置受支持的远程 S3 兼容服务，以支持 MinIO Lifecycle Management: Object Transition (“Tiering”)。

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

{
   "Version": "2012-10-17",
   "Statement": [
      {
            "Action": [
               "s3:ListBucket"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::MyDestinationBucket"
            ],
            "Sid": ""
      },
      {
            "Action": [
               "s3:GetObject",
               "s3:PutObject",
               "s3:DeleteObject"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::MyDestinationBucket/*"
            ],
            "Sid": ""
      }
   ]
}

语法

mc admin tier add

创建一个新的远程存储层，用于通过 MinIO 生命周期管理规则过渡对象。

Important

MinIO 不支持移除远程存储层。在将其添加为远程层目标*之前*，请先确保该存储后端能够满足预期工作负载。

命令语法如下：

mc admin tier add TIER_TYPE TARGET TIER_NAME [FLAGS]

此命令接受以下参数：

TIER_TYPE

Required

MinIO 用于过渡对象的云服务提供商存储后端（“Tier”）。请在以下受支持值中指定*一个*：

s3	使用 AWS S3 或 远程 MinIO 部署作为新 Tier 的存储后端。 需要额外指定以下选项： --access-key --secret-key
azure	使用 Azure Blob Storage 作为新 Tier 的存储后端。 需要额外指定以下选项： --account-name --account-key
gcs	使用 GCP Cloud Storage 作为新 Tier 的存储后端。 需要额外指定以下选项： --credentials-file

TARGET

Required

已配置 MinIO 部署的 alias，命令会在该部署上创建新的远程层。

TIER_NAME

Required

与新远程层关联的名称。该名称在 MinIO 集群所有已配置层中*必须*唯一。

你**必须**使用全大写指定 tier，例如 WARM_TIER。

--endpoint

Required

云服务提供商的 URL endpoint。该 URL endpoint 必须 能解析到 TIER_TYPE 指定的提供商。

--access-key

Required

远程 S3 层用户的 access key。该用户必须对远程存储桶或存储桶前缀具备读/写/列举/删除操作权限。

当 TIER_TYPE 为 s3 时必填。 对 TIER_TYPE 的其他取值，此选项无效。

--secret-key

Required

远程 S3 层用户的 secret key。

当 TIER_TYPE 为 s3 时必填。 对 TIER_TYPE 的其他取值，此选项无效。

--account-name

Required

远程 Azure 层用户的 account name。该用户必须对远程存储桶或存储桶前缀具备读/写/列举/删除操作权限。

当 TIER_TYPE 为 azure 时必填。 对 TIER_TYPE 的其他取值，此选项无效。

MinIO *不*支持修改与 Azure 远程层关联的 account name。Azure 存储后端与账号绑定，修改账号会改变存储后端，并导致无法访问已过渡到原账号/后端的任何对象。

--account-key

Required

与远程 Azure 层关联的 --account-name 对应的 account key。

当 TIER_TYPE 为 azure 时必填。 对 TIER_TYPE 的其他取值，此选项无效。

--credentials-file

Required

远程 GCS 层用户的 credential file。该用户必须对远程存储桶或存储桶前缀具备读/写/列举/删除操作权限。

当 TIER_TYPE 为 gcs 时必填。 对 TIER_TYPE 的其他取值，此选项无效。

--bucket

Required

MinIO 过渡对象所使用的远程层存储桶。

--prefix

Optional

指定 --bucket 下 MinIO 过渡对象使用的前缀路径。

省略此字段则将对象过渡到存储桶根路径。

--storage-class

Optional

MinIO 过渡对象时使用的 AWS 存储类。MinIO 仅支持以下存储类：

• STANDARD

• REDUCED_REDUNDANCY

省略时默认为 S3_STANDARD。

此选项仅在 TIER_TYPE 为 s3 时生效。 对 TIER_TYPE 的其他取值，此选项无效。

--region

Optional

指定 TIER_TYPE 的 S3 后端区域，例如 us-west-1。

此选项仅在 TIER_TYPE 为 s3 时生效。 对 TIER_TYPE 的其他取值，此选项无效。

mc admin tier edit

修改或移除 MinIO 集群中的远程存储层。远程存储层支持通过 MinIO 生命周期管理规则进行对象过渡。

命令语法如下：

mc admin tier edit TARGET TIER_NAME [FLAGS]

此命令接受以下参数：

TARGET

Required

已配置 MinIO 部署的 alias。

TIER_NAME

Required

命令要修改的远程层名称。该值对应于创建远程层时指定的 mc admin tier add TIER_NAME。

--access-key

Optional

远程 S3 层用户的 access key。该用户必须对远程存储桶或存储桶前缀具备读/写/列举/删除操作权限。

此选项仅适用于 TIER_TYPE 为 s3 的远程存储层。 对其他 TIER_TYPE，此选项无效。

--secret-key

Optional

远程 S3 层用户的 secret key。

此选项仅适用于 TIER_TYPE 为 s3 的远程存储层。 对其他 TIER_TYPE，此选项无效。

--account-key

Required

远程 Azure 层用户的 account key。 使用此选项可轮换与远程层关联的 --account-name 凭证。

此选项仅适用于 TIER_TYPE 为 azure 的远程存储层。 对其他 TIER_TYPE，此选项无效。

--credentials-file

Required

远程 GCS 层用户的 credential file。该用户必须对远程存储桶或存储桶前缀具备读/写/列举/删除操作权限。

此选项仅适用于 TIER_TYPE 为 gcs 的远程存储层。 对其他 TIER_TYPE，此选项无效。

mc admin tier ls

列出 MinIO 集群上的所有远程存储层。远程存储层支持通过 MinIO 生命周期管理规则进行对象过渡。

命令语法如下：

mc admin tier ls TARGET [FLAGS]

此命令接受以下参数：

TARGET

Required

已配置 MinIO 部署的 alias。