MINIO on Pigsty v5.0

MINIO 集群模型

Mon, 01 Jan 0001 00:00:00 +0000

MINIO 是 Pigsty 的对象存储兼容模块名。v4.5.0 当前源码通过 minio_type: silo 部署 Silo，并以集群组织一组对象存储实例。

每个集群都是一个自治的 S3 兼容对象存储单元，由至少一个实例组成，通过 S3 API 端口对外提供服务。

模块：MINIO

Mon, 01 Jan 0001 00:00:00 +0000

MINIO 是 Pigsty 中 S3 兼容对象存储的兼容模块名。当前角色部署 Silo，并且 minio_type 只接受 silo。

Silo 沿用 MinIO 的 S3/Admin API、MINIO_* 环境变量、磁盘格式与 mcli 客户端接口，可用作 PostgreSQL pgBackRest 备份仓库。模块名、参数前缀和监控 job 继续使用 MINIO / minio_*，以保持现有清单和运维入口兼容。

使用方法

Mon, 01 Jan 0001 00:00:00 +0000

当您配置并执行剧本部署 Silo 后，可以参考本页通过 S3 与 mcli 兼容接口使用它。

部署集群

首先在配置清单中定义单机单盘对象存储集群，并显式锁定引擎：

集群配置

Mon, 01 Jan 0001 00:00:00 +0000

在部署 MINIO 模块之前，需要在配置清单中定义 Silo 对象存储集群。当前角色要求 minio_type: silo，支持以下清单部署模式：

单机单盘：SNSD：单机单盘模式，可以使用任意目录作为数据盘，仅作为开发、测试、演示使用。
单机多盘：SNMD：折中模式，在单台服务器上使用多块磁盘 (>=2)，仅当资源极为有限时使用。
多机单盘：MNSD：多台服务器各使用一个独立数据盘，提供紧凑的节点级高可用能力。
多机多盘：MNMD：多机多盘模式，标准生产环境部署，具有最好的可靠性，但需要多台服务器。

SNSD 适合开发测试，三节点 MNSD 适合资源受限的紧凑高可用部署，MNMD 适合对容量、吞吐和磁盘冗余有更高要求的生产环境。SNMD 只解决单机内的磁盘故障，不能容忍整机故障。

参数列表

Mon, 01 Jan 0001 00:00:00 +0000

MINIO 模块共有 22 个公开参数，分为两个部分：

MINIO：19 个参数，用于部署 Silo 对象存储集群
MINIO_REMOVE：3 个参数，控制对象存储集群的移除

架构变化：Pigsty v3.6+

自 Pigsty v3.6 起，minio.yml 剧本不再包含移除功能，移除相关参数已迁移至独立的 minio_remove 角色和 minio-rm.yml 剧本。

预置剧本

Mon, 01 Jan 0001 00:00:00 +0000

MINIO 模块提供两个内置剧本：

minio.yml：安装并配置 Silo
minio-rm.yml：移除 Silo、配置和可选数据

`minio.yml`

minio.yml 以 hosts: all 运行，但会在预任务阶段跳过没有定义 minio_cluster 的主机。进入角色后还会校验：

管理预案

Mon, 01 Jan 0001 00:00:00 +0000

创建集群

要创建一个集群，在配置清单中定义好后，执行 minio.yml 剧本即可。

minio: { hosts: { 10.10.10.10: { minio_seq: 1 } }, vars: { minio_cluster: minio, minio_type: silo } }

例如，上面的配置定义了一个 SNSD 单机单盘 Silo 集群，使用以下命令即可创建所选对象存储集群：

监控告警

Mon, 01 Jan 0001 00:00:00 +0000

管理界面

Silo 默认通过 minio_admin_port（9001）提供管理界面，可直接访问 https://<node-ip>:9001。

部分配置模板还会通过 m.pigsty 暴露管理入口。登录凭证由 minio_access_key 与 minio_secret_key 指定。

HTTPS 与证书信任

对象存储默认使用 Pigsty CA 签发的 HTTPS 证书。浏览器和容器客户端必须信任该 CA；生产环境不要以忽略证书校验代替正确配置证书信任。

指标列表

Mon, 01 Jan 0001 00:00:00 +0000

MINIO 模块通过 /minio/metrics/v3 采集 Silo 指标。指标集合会随服务端版本和实际启用功能变化，因此本页列出当前仪表盘与告警依赖的稳定接口，不把某个版本的完整抓取快照当作长期契约。

常见问题

Mon, 01 Jan 0001 00:00:00 +0000

MINIO 模块默认部署哪个引擎？

v4.5.0 当前源码部署并且只部署 Silo，minio_type 唯一合法值是 silo。MINIO 是兼容模块名，不表示运行 MinIO 服务端。