将 MinIO 部署为容器

本页档记录了如何将 MinIO 作为容器部署到任何支持容器化进程的操作系统上。

This documentation assumes installation of Docker, Podman, or a similar runtime which supports the standard container image format. MinIO images useRed Hat Universal Base Image 9 Micro.

MinIO 容器的功能和性能可能受到基础操作系统的限制。

该流程包含部署单节点多驱动器（SNMD）和单节点单驱动器（SNSD）拓扑结构的指导，旨在支持早期开发和评估环境。

重要

MinIO 官方通过 MinIO Kubernetes Operator 在 Kubernetes 基础设施上支持容器化的多节点多驱动器（MNMD）“分布式”配置。

MinIO 既不支持也不提供使用 Docker Swarm、Docker Compose 或任何其他编排容器环境部署分布式集群的指导。

注意事项

审查清单

在尝试此过程之前，请确保您已查阅我们发布的硬件、软件和安全检查清单。

擦除编码奇偶校验

MinIO 自动确定默认值纠删码基于拓扑中的节点和驱动器总数配置集群。您可以配置每个对象的奇偶性设置集群时的设置or让 MinIO 选择默认值（EC:4适用于生产级集群）。

Parity controls the relationship between object availability and storage on disk. Use the MinIOErasure Code Calculator为您的集群选择合适的纠删码奇偶校验级别提供指导。

虽然您可以随时更改擦除码奇偶校验设置，但使用特定奇偶校验写入的对象不自动更新到新的奇偶校验设置。

容器存储

此过程假设您将一个或多个专用存储设备挂载到容器中，作为 MinIO 的持久存储。

存储在临时容器路径上的数据在容器重启或删除时会丢失。请自行承担使用此类路径的风险。

过程

启动容器

此过程提供了在 rootfull 模式下使用 Podman 和 Docker 的说明。对于 rootless 部署，请参考各运行时的文档进行配置和容器启动。

对于所有其他容器运行时，请遵循该运行时的文档并指定等效的选项、参数或配置。

Podman

以下命令将在您的主目录中创建一个文件夹，然后使用 Podman 启动 MinIO 容器：

mkdir -p ~/minio/data

podman run \
   -p 9000:9000 \
   -p 9001:9001 \
   --name minio \
   -v ~/minio/data:/data \
   -e "MINIO_ROOT_USER=ROOTNAME" \
   -e "MINIO_ROOT_PASSWORD=CHANGEME123" \
   quay.io/minio/minio server /data --console-address ":9001"

该命令绑定端口9000和9001分别对应 MinIO S3 API 和 Web 控制台。

本地驱动器~/minio/data已安装到/data容器上的文件夹。您可以修改MINIO_ROOT_USER和MINIO_ROOT_PASSWORD根据需要更改root登录的变量。

对于多驱动器部署，请将每个本地驱动器或其所在的文件夹绑定到远程设备上按顺序编号的路径。然后您可以修改minio server启动时指定这些路径：

mkdir -p ~/minio/data-{1..4}

podman run \
   -p 9000:9000 \
   -p 9001:9001 \
   --name minio \
   -v /mnt/drive-1:/mnt/drive-1 \
   -v /mnt/drive-2:/mnt/drive-2 \
   -v /mnt/drive-3:/mnt/drive-3 \
   -v /mnt/drive-4:/mnt/drive-4 \
   -e "MINIO_ROOT_USER=ROOTNAME" \
   -e "MINIO_ROOT_PASSWORD=CHANGEME123" \
   quay.io/minio/minio server http://localhost:9000/mnt/drive-{1...4} --console-address ":9001"

对于 Windows 主机，请使用 Windows 文件系统语义指定本地文件夹路径C:\minio\:/data.

Docker

以下命令将在您的主目录中创建一个文件夹，然后使用 Docker 启动 MinIO 容器：

mkdir -p ~/minio/data

docker run \
   -p 9000:9000 \
   -p 9001:9001 \
   --name minio \
   -v ~/minio/data:/data \
   -e "MINIO_ROOT_USER=ROOTNAME" \
   -e "MINIO_ROOT_PASSWORD=CHANGEME123" \
   quay.io/minio/minio server /data --console-address ":9001"

该命令绑定端口9000和9001分别对应 MinIO S3 API 和 Web 控制台。

本地驱动器~/minio/data已安装到/data容器上的文件夹。您可以修改MINIO_ROOT_USER和MINIO_ROOT_PASSWORD根据需要更改root登录的变量。

对于多驱动器部署，请将每个本地驱动器或其所在的文件夹绑定到远程设备上按顺序编号的路径。然后您可以修改minio server启动时指定这些路径：

mkdir -p ~/minio/data-{1..4}

docker run \
   -p 9000:9000 \
   -p 9001:9001 \
   --name minio \
   -v /mnt/drive-1:/mnt/drive-1 \
   -v /mnt/drive-2:/mnt/drive-2 \
   -v /mnt/drive-3:/mnt/drive-3 \
   -v /mnt/drive-4:/mnt/drive-4 \
   -e "MINIO_ROOT_USER=ROOTNAME" \
   -e "MINIO_ROOT_PASSWORD=CHANGEME123" \
   quay.io/minio/minio server http://localhost:9000/mnt/drive-{1...4} --console-address ":9001"

对于 Windows 主机，请使用 Windows 文件系统语义指定本地文件夹路径C:\minio\:/data.

2. 连接到部署

控制台

打开浏览器访问http://localhost:9000要打开MinIO 控制台登录页面。

使用登录MINIO_ROOT_USER和MINIO_ROOT_PASSWORD从上一步。

您可以使用 MinIO 控制台执行常规管理任务，例如身份和访问管理、指标和日志监控或服务器配置。每个 MinIO 服务器都包含其自己内嵌的 MinIO 控制台。

CLI

遵循安装说明formc在您的本地主机上运行。mc --version验证安装。

安装完成后，为 MinIO 部署创建别名：

mc alias set myminio http://localhost:9000 USERNAME PASSWORD

将主机名、用户名和密码更改为反映您的部署配置。