MINIO 集群模型

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

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

MINIO 模块中有三种核心实体：

• 集群（Cluster）：自治的对象存储服务单元，用作其他实体的顶级命名空间。
• 实例（Instance）：单个 Silo 服务器进程，在节点上运行并管理本地磁盘。
• 节点（Node）：运行 Linux + Systemd 环境的硬件资源抽象，隐含式声明。

此外，Silo 保留 存储池（Pool）概念，用于扩容。

部署模式

Silo 支持 Pigsty 的三类清单部署模式：

单机单盘模式可以使用普通目录快速体验。Silo 多盘模式应使用真实磁盘挂载点，否则服务会拒绝启动。

具体样例

以下示例显式选择当前默认的 Silo 后端，并定义四节点多盘集群：

minio:
  hosts:
    10.10.10.10: { minio_seq: 1 }
    10.10.10.11: { minio_seq: 2 }
    10.10.10.12: { minio_seq: 3 }
    10.10.10.13: { minio_seq: 4 }
  vars:
    minio_type: silo
    minio_cluster: minio
    minio_data: '/data{1...4}'
    minio_node: '${minio_cluster}-${minio_seq}.pigsty'

上面的配置片段定义了一个四节点的 Silo 集群，每个节点使用四块磁盘；实例标识仍沿用 MINIO 模块的兼容命名：

身份参数

Pigsty 使用 MINIO 参数组为对象存储实体赋予确定身份。以下两项为必选参数：

只要在集群层面定义了集群名称，实例层面分配了实例编号，Pigsty 就能自动根据规则为每个实体生成唯一标识符。

MINIO 模块不会为主机节点赋予额外的身份标识，节点使用其原有的主机名或 IP 地址进行标识。 minio_node 用于生成 Silo 集群内部的节点名称（写入 /etc/hosts 供集群发现使用），而非主机节点身份。

角色在整个清单中按 minio_cluster 查找实际成员，Ansible Group 名称不必与集群名称一致。minio_type 是保留的后端选择器，当前必须为 silo。

核心配置参数

除身份参数外，以下参数对 Silo 集群配置至关重要：

这些参数共同决定 minio_volumes，再由角色写入 Silo 的 MINIO_VOLUMES：

• 单机单盘：直接使用 minio_data 的值，如 /data/minio
• 单机多盘：使用 minio_data 展开的多个目录，如 /data{1...4}
• 多机多盘：组合 minio_node 与 minio_data，如 https://minio-{1...4}.pigsty:9000/data{1...4}

端口与服务

每个对象存储实例会监听以下端口：

MINIO 模块默认启用 HTTPS 加密通信（由 minio_https 控制）。按默认 pgBackRest S3 仓库配置使用时应保持 HTTPS，并正确安装 Pigsty CA。

多节点 Silo 集群可以通过访问 任意一个节点 来访问其服务。最佳实践是使用负载均衡器（如 HAProxy + VIP）提供统一接入点。

资源置备

Silo 集群部署后，Pigsty 会自动创建以下资源（由 minio_provision 控制）：

默认存储桶（由 minio_buckets 定义）：

默认用户（由 minio_users 定义）：

这些密码属于文档公开的 默认凭据，仅供演示与本地开发使用，生产部署前必须替换。

pgbackrest 是 PostgreSQL 集群备份时使用的用户，s3user_meta 和 s3user_data 是未实际使用的保留用户。

监控标签体系

Pigsty 使用上面的 身份参数 标识对象存储实体。Silo 可用性序列示例如下：

minio_up{cls="minio", ins="minio-1", ip="10.10.10.10", job="minio"}
minio_up{cls="minio", ins="minio-2", ip="10.10.10.11", job="minio"}
minio_up{cls="minio", ins="minio-3", ip="10.10.10.12", job="minio"}
minio_up{cls="minio", ins="minio-4", ip="10.10.10.13", job="minio"}

其中 cls、ins、ip 分别对应集群名、实例名与节点 IP。兼容监控命名保持 job=minio，当前后端标签为 flavor=silo。详细接口见 指标列表。