Alauda Container Platform
简体中文

安装

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>

相关信息

冗余因子映射表

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

实例数冗余因子
4 - 52
6 - 73
>= 84

Storage Pool Overview

Storage Pool Overview 参数计算公式
可用容量当实例数 ≤ 16 时，可用容量 = 单个存储卷容量 × (实例数 - 冗余因子)。
当实例数 > 16 时，可用容量 = 单个存储卷容量 × (实例数 - 4 × (实例数 + 15) / 16)。其中“4 × (实例数 + 15) / 16”结果向下取整。
总容量总容量 = 实例数 × 单个存储卷容量
可容忍故障存储服务数量当实例数 > 2 × 冗余因子时，可容忍故障存储服务数量 = 冗余因子。
当实例数 = 2 × 冗余因子时，可容忍故障存储服务数量 = 冗余因子 - 1