#安装

Alauda Container Platform (ACP) 基于 MinIO 的对象存储是一种基于 Apache License v2.0 开源协议的对象存储服务。它兼容 Amazon S3 云存储服务接口，适合存储大量非结构化数据，如图片、视频、日志文件、备份数据以及容器/虚拟机镜像。一个对象文件的大小可以是任意的，从几千字节到最大 5 TB。

#前提条件

MinIO 构建于底层存储之上，请确保当前集群已创建存储类。推荐使用 TopoLVM。

#部署 Operator

1. 在左侧导航栏，点击 Storage > Object Storage。

2. 点击 Configure Now。

3. 在 Deploy MinIO Operator 向导页面，点击右下角的 Deploy Operator。

   • 页面自动跳转到下一步时，表示 Operator 部署成功。

   • 若部署失败，请根据界面提示选择 Clean Up Deployed Information and Retry，然后重新部署 Operator。

#创建集群

1. 在 Create Cluster 向导页面，配置基本信息。

   参数	说明
   Access Key	访问密钥 ID。与私有访问密钥关联的唯一标识符；用于与访问密钥 ID 一起对请求进行加密和签名。
   Secret Key	与访问密钥 ID 配合使用的私有访问密钥，用于加密和签名请求，识别发送方，防止请求篡改。

2. 在 Resource Configuration 区域，根据以下说明配置规格。

   参数	说明
   Small scale	适用于处理最多 100,000 个对象，支持测试环境或数据备份场景中不超过 50 个并发访问。CPU 资源请求和限制默认设置为 2 核，内存资源请求和限制默认设置为 4 Gi。
   Medium scale	适用于企业级应用，需存储 1,000,000 个对象，支持最多 200 个并发请求。CPU 资源请求和限制默认设置为 4 核，内存资源请求和限制默认设置为 8 Gi。
   Large scale	适用于存储需求为 10,000,000 个对象，支持最多 500 个并发请求的集团用户，适合高负载场景。CPU 资源请求和限制默认设置为 8 核，内存资源请求和限制默认设置为 16 Gi。
   Custom	为有特定需求的专业用户提供灵活配置选项，确保服务规模和性能需求的精准匹配。注意：配置自定义规格时，请确保：

   • CPU 资源请求大于 100 m。
   • 内存资源请求大于或等于 2 Gi。
   • CPU 和内存资源限制大于或等于资源请求。 |

3. 在 Storage Pool 区域，根据以下说明配置相关信息。

   参数	说明
   Instance Number	增加 MinIO 集群中的实例数量可以显著提升系统性能和可靠性，确保数据高可用。但实例过多可能导致以下问题：

   • 资源消耗增加。
   • 如果一个节点承载多个实例，节点故障可能导致多个实例同时离线，降低集群整体可靠性。 注意：
   • 最小可输入实例数为 4。
   • 实例数大于 16 时，输入值必须是 8 的倍数。
   • 添加额外存储池时，实例数不得少于第一个存储池的实例数。 | | Single Storage Volume | 单个存储卷 PVC 的容量。每个存储服务管理一个存储卷。输入单个存储卷容量后，平台会自动计算存储池容量及其他信息，可在 Storage Pool Overview 中查看。 | | Underlying Storage | MinIO 集群使用的底层存储。请选择当前集群中已创建的存储类。推荐使用 TopoLVM。 | | Storage Nodes | 选择 MinIO 集群所需的存储节点，建议使用 4-16 个存储节点。平台会为每个选中的存储节点部署一个存储服务。 | | Storage Pool Overview | 具体参数及计算公式，请参见 Storage Pool Overview。 |

4. 在 Access Configuration 区域，根据以下说明配置相关信息。

   参数	说明
   External Access	启用时支持跨集群访问 MinIO；禁用时仅支持集群内访问。
   Protocol	支持 HTTP 和 HTTPS；选择 HTTPS 时需填写 Domain 并导入域名证书的 Public Key 和 Private Key。
   Note:

   • 访问协议为 HTTP 时，集群内 pod 可通过获取的 IP 或域名直接访问 MinIO，无需配置 IP 与域名映射；集群内节点可通过获取的 IP 直接访问 MinIO，若需域名访问，则需手动配置 IP 与域名映射；外部访问可直接通过获取的 IP 访问。
   • 访问协议为 HTTPS 时，集群内外均无法通过 IP 访问 MinIO。需手动配置获取的 IP 与集群创建时填写的域名映射，才能通过域名正常访问。 | | Access Method |
   • NodePort：在每个计算节点主机上开启固定端口，将服务暴露到外部。配置域名访问时，建议使用 VIP 进行域名解析以保证高可用。
   • LoadBalancer：通过负载均衡器转发流量到后端服务。使用前请确保当前集群已部署 MetalLB 插件且外部地址池有可用 IP。 |

5. 点击右下角 Create Cluster。

   • 页面自动跳转至 Cluster Details，表示集群创建成功。

   • 若集群仍处于创建中，可点击 Cancel。取消后会清理已部署的集群信息，可返回集群创建页面重新创建。

#创建 Bucket

登录集群控制节点，使用命令创建 bucket。

#操作步骤

1. 在集群详情页，点击 Access Method 标签查看 MinIO 访问地址，或使用以下命令查询。

   kubectl get svc -n <tenant ns> minio | grep -w minio | awk '{print $3}'

   注意：

   • 将 tenant ns 替换为实际命名空间 minio-system。
   • 示例：kubectl get svc -n minio-system minio | grep -w minio | awk '{print $3}'

2. 获取 mc 命令。

   wget https://dl.min.io/client/mc/release/linux-amd64/mc -O /bin/mc && chmod a+x /bin/mc

3. 配置 MinIO 集群别名。

   • IPv4：

     mc --insecure alias set <minio cluster alias> http://<minio endpoint>:<port> <accessKey> <secretKey>

   • IPv6：

     mc --insecure alias set <minio cluster alias> http://[<minio endpoint>]:<port> <accessKey> <secretKey>

   • 域名：

     mc --insecure alias set <minio cluster alias> http://<domain name>:<port> <accessKey> <secretKey>
     mc --insecure alias set <minio cluster alias> https://<domain name>:<port> <accessKey> <secretKey>

   注意：

   • minio endpoint 填写步骤 1 中获取的 IP 地址。
   • accessKey 和 secretKey 填写集群创建时配置的 Access Key 和 Secret Key。
   • 配置示例：
     • IPv4: mc --insecure alias set myminio http://12.4.121.250:80 07Apples@ 07Apples@
     • IPv6: mc --insecure alias set myminio http://[2004::192:168:143:117]:80 07Apples@ 07Apples@
     • 域名: mc --insecure alias set myminio http://test.minio.alauda:80 07Apples@ 07Apples@ 或 mc --insecure alias set myminio https://test.minio.alauda:443 07Apples@ 07Apples@

4. 创建 bucket。

   mc --insecure mb <minio cluster alias>/<bucket name>

#上传/下载文件

创建 bucket 后，可使用命令行上传文件到 bucket，或从 bucket 下载已有文件。

#操作步骤

1. 创建用于上传测试的文件。若上传已有文件，此步骤可跳过。

   touch <file name>

2. 上传文件到 bucket。

   mc --insecure cp <file name> <minio cluster alias>/<bucket name>

3. 查看 bucket 中的文件，确认上传成功。

   mc --insecure ls <minio cluster alias>/<bucket name>

4. 删除上传的文件。

   mc --insecure rm <minio cluster alias>/<bucket name>/<file name>

#相关信息

#冗余因子映射表

注意：添加额外存储池时，冗余因子需根据第一个存储池的实例数计算。

#Storage Pool Overview