使用 Docker 搭建 MinIO 集群

ljguo2008

已于 2024-09-18 10:47:43 修改

阅读量329

点赞数 8

分类专栏： docker 文章标签： docker 容器运维

于 2024-09-18 10:45:07 首次发布

本文链接：https://blog.csdn.net/ljguo2008/article/details/142326925

版权

docker 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

引言

MinIO 是一个轻量级、高性能的对象存储解决方案，广泛应用于分布式文件系统场景中。MinIO 完全兼容 Amazon S3 API，允许我们轻松构建支持海量数据存储的分布式存储集群。本文将深入讲解如何使用 Docker Compose 构建一个 4 节点 MinIO 集群，并对配置文件中的参数进行详细解释。

MinIO 集群架构

MinIO 支持分布式模式，即多个 MinIO 实例可以作为一个集群协同工作。MinIO 的分布式模式通过多节点共享数据，提升了可用性和容错能力。每个实例持有集群的一部分数据，失去一个或多个节点不会导致数据丢失。为了实现这种集群架构，我们需要至少 4 个 MinIO 节点，并通过 HTTP 协议连接这些节点。

核心配置文件讲解

`docker-compose.yml` 文件结构

version: '3.7'

x-minio-common: &minio-common
  image: minio/minio
  command: server --console-address ":9001" http://minio{1...4}/data
  expose:
    - "9000"
  environment:
    MINIO_ROOT_USER: minioadmin
    MINIO_ROOT_PASSWORD: minioadmin
  healthcheck:
    test:
      [
        "CMD",
        "curl",
        "-f",
        "http://localhost:9000/minio/health/live"
      ]
    interval: 30s
    timeout: 20s
    retries: 3

x-minio-common 定义：
- image: 使用 MinIO 官方镜像 minio/minio。
- command: 启动 MinIO 的核心命令。这一行的内容指定了 MinIO 运行的分布式模式，参数 server 命令用于启动 MinIO 实例并定义控制台地址（:9001）和节点配置 (http://minio{1...4}/data)。
  - --console-address ":9001"：定义 MinIO 控制台访问地址，监听 9001 端口。
  - http://minio{1...4}/data：定义分布式集群中每个节点的路径，MinIO 使用节点名称（minio1 到 minio4）和对应的数据路径（/data）来构建集群。
- expose: 公开 9000 端口，MinIO 默认使用此端口处理 API 请求。
- environment: 定义环境变量，用于设置 MinIO 的管理员用户名和密码。这里使用的是默认的 minioadmin。
  - MINIO_ROOT_USER: MinIO 的管理员用户名。
  - MINIO_ROOT_PASSWORD: MinIO 的管理员密码。
- healthcheck: 配置 MinIO 实例的健康检查，确保实例正常运行。每 30 秒通过 curl 检查 http://localhost:9000/minio/health/live 路径，如果失败则重试 3 次。
  - test: 定义健康检查的具体命令，curl 请求会检查 MinIO 的健康 API。
  - interval: 每次健康检查的时间间隔（30 秒）。
  - timeout: curl 命令的超时时间（20 秒）。
  - retries: 在报告不健康之前重试的次数（3 次）。

MinIO 服务定义

services:
  minio1:
    <<: *minio-common
    hostname: minio1
    container_name: minio1
    restart: always
    volumes:
      - ./data/data1:/data

hostname 和 container_name:
- hostname: 定义容器的主机名，这有助于集群中的其他节点通过名称识别和通信。
- container_name: Docker 容器的名字，便于管理和监控。
volumes:
- ./data/data1:/data: 数据挂载点，将主机上的 data1 目录挂载到容器内部的 /data，用于持久化存储 MinIO 数据。每个实例有自己的数据存储目录。

Nginx 服务定义

  nginx:
    image: nginx
    hostname: nginx
    container_name: nginx-minio
    restart: always
    volumes:
      - ./config/nginx.conf:/etc/nginx/nginx.conf:ro
    ports:
      - "9000:9000"
      - "9091:9091"
    depends_on:
      - minio1
      - minio2
      - minio3
      - minio4

Nginx 镜像: 使用官方的 Nginx 镜像。
volumes: 将主机中的 nginx.conf 配置文件挂载到容器内部的 /etc/nginx/nginx.conf，Nginx 启动时将使用该配置。
ports:
- 9000:9000: 将容器的 9000 端口映射到主机的 9000 端口，用于处理 MinIO API 请求。
- 9091:9091: 将容器的 9091 端口映射到主机的 9091 端口，用于访问 MinIO 控制台。
depends_on: Nginx 依赖于所有 MinIO 容器，确保 MinIO 实例启动后再启动 Nginx。

集群启动与验证

启动集群：
```
docker-compose up -d
```
这个命令会启动 4 个 MinIO 实例和 Nginx 负载均衡器。
验证集群状态：
- MinIO 控制台：通过 http://localhost:9091 访问 MinIO 控制台，使用默认的 minioadmin 作为用户名和密码进行登录。