单节点多硬盘部署MinIO
本页面的步骤介绍了如何以单节点多驱动器(SNMD)配置部署MinIO。 SNMD 部署提供了驱动器级别的可靠性以及故障转移/恢复功能,但由于单个节点的限制,会对性能和扩展性产生限制。
对于生产环境,MinIO强烈推荐使用:ref:多节点多磁盘 (Distributed) <minio-mnmd> 拓扑结构进行部署,以实现企业级别的性能、可用性和可扩展性。
先决条件
存储需求
以下要求概述了MinIO硬件建议的 Storage 部分:
- 使用本地存储
直接连接存储(DAS)在性能和一致性方面比网络存储( 网络附加存储(NAS)、 存储区域网络(SAN)、 网络文件存储(NFS))有显著优势。 MinIO 强烈建议使用闪存存储(NVMe,SSD)作为主要或 “热” 数据。
- 使用 XFS 格式化驱动器。
MinIO 强烈建议为存储提供 XFS 格式化的驱动器。 MinIO 在内部测试和验证套件中使用 XFS,以提供对性能和行为在所有规模上的额外信心。
MinIO 并 不 测试也不推荐其他文件系统,如 EXT4、BTRFS 或 ZFS。
- 使用一致类型的驱动器
MinIO 不区分驱动器类型,并且不从混合存储类型中受益。 每个 :term:`pool`(池)必须使用相同类型(NVMe,SSD)的驱动器。
例如,部署一个仅由 NVMe 驱动器组成的池。 如果您将一些驱动器作为 SSD 或 HDD 部署,MinIO 会将与 NVMe 驱动器相同的方式来处理这些驱动器。 这可能会导致性能问题,因为一些驱动器具有不同的或更差的读/写特性,并且不能像 NVMe 驱动器那样以相同的速率响应。
- 使用一致大小的驱动器
MinIO 将每个硬盘使用的大小限制为池中最小的硬盘。
例如,部署一个由容量相同的
7.68TiB
NVMe驱动器组成的数据池。 如果您部署了一个容量为3.84TiB
的驱动器,MinIO会将池中的所有驱动器都视为具有那个较小的容量。- 配置顺序挂载驱动器
MinIO 使用 Go 扩展表示法
{x...y}
来表示在创建新 deployment 时驱动器的顺序系列,其中 deployment 中的所有节点都具有相同的一组挂载驱动器。 将驱动器挂载路径配置为顺序系列,以最佳支持这种表示法。 例如,使用模式/mnt/drive-n
挂载您的驱动器,其中n
从1
开始,每增加一个驱动器就递增1
。- 在重新启动后保持驱动器挂载和映射不变
使用
/etc/fstab
确保在节点重新启动后驱动器到挂载点的映射一致。在重新启动后,非Linux操作系统应使用等效的驱动器挂载管理工具以保持驱动器到挂载点的映射一致。
Exclusive access to drives
MinIO 要求 专有 对提供给对象存储的驱动器或卷的访问。 其他任何进程、软件、脚本或人员都不得直接对提供给MinIO的驱动器或卷执行 任何 操作,也不得对MinIO放置在其上的对象或文件执行操作。
除非由MinIO工程部门指导,否则不要使用脚本或工具直接修改、删除或移动提供给MinIO的驱动器上的任何数据片段、校验片段或元数据文件,包括从一个驱动器或节点移动到另一个驱动器或节点。 这些操作很可能会导致广泛的数据损坏和丢失,超出了MinIO的修复能力。
内存要求
在 RELEASE.2024-01-28T22-35-53Z 版本发生变更: MinIO 在启动时预分配 2GiB 的系统内存。
MinIO建议每个主机至少配备32GiB内存。 有关MinIO中内存分配的更多指导,请参阅 Memory。
Deploy 单节点多硬盘 MinIO
下面的流程部署MinIO,包括一个单独的MinIO服务器和多个驱动器或存储卷。
1) 下载MinIO服务器文件
打开一个终端,并运行以下命令来使用 `Homebrew <https://brew.sh>`_安装最新稳定版本的MinIO包:
brew install minio/stable/minio
重要
如果您之前使用 brew install minio
安装了MinIO服务器,那么我们建议您改为从 minio/stable/minio
重新安装。
brew uninstall minio
brew install minio/stable/minio
打开终端,然后使用以下命令下载最新稳定版本的MinIO二进制文件,将其设置为可执行文件,并安装到系统的 $PATH
中:
curl -O https://dl.minio.org.cn/server/minio/release/darwin-arm64/minio chmod +x ./minio sudo mv ./minio /usr/local/bin/
打开终端,然后使用以下命令下载最新稳定版本的MinIO二进制文件,将其设置为可执行,并安装到系统的 $PATH
中:
curl -O https://dl.minio.org.cn/server/minio/release/darwin-amd64/minio chmod +x ./minio sudo mv ./minio /usr/local/bin/
2) 创建环境变量文件
在指定位置创建一个环境变量文件 /etc/default/minio
。
对于Windows主机,请指定一个类似Windows风格的路径: C:\minio\config
。
MinIO服务器容器可以使用此文件作为来源: environment variables 。
以下示例提供了一个启动的环境变量配置文件:
# MINIO_ROOT_USER and MINIO_ROOT_PASSWORD sets the root account for the MinIO server.
# This user has unrestricted permissions to perform S3 and administrative API operations on any resource in the deployment.
# Omit to use the default values 'minioadmin:minioadmin'.
# MinIO recommends setting non-default values as a best practice, regardless of environment.
MINIO_ROOT_USER=myminioadmin
MINIO_ROOT_PASSWORD=minio-secret-key-change-me
# MINIO_VOLUMES sets the storage volumes or paths to use for the MinIO server.
# The specified path uses MinIO expansion notation to denote a sequential series of drives between 1 and 4, inclusive.
# All drives or paths included in the expanded drive list must exist *and* be empty or freshly formatted for MinIO to start successfully.
MINIO_VOLUMES="/data-{1...4}"
# MINIO_OPTS sets any additional commandline options to pass to the MinIO server.
# 例如, `--console-address :9001` sets the MinIO Console listen port
MINIO_OPTS="--console-address :9001"
根据您的本地部署需求,包括任何其他所需的环境变量。 ..
在 Server 版本加入: RELEASE.2024-03-03T17-50-39Z
MinIO会自动生成唯一的根凭据,如果以下所有条件都成立:
KES 版本 2024-03-01T18-06-46Z 或更高版本运行
Have not defined:
MINIO_ROOT_USER
variableMINIO_ROOT_PASSWORD
variable
Have:
使用 支持的KMS目标 设置KES
通过 MinIO环境变量 禁用根访问
当这些条件在启动时得到满足时,MinIO会使用KMS为部署生成唯一的根凭据,使用基于 哈希的消息验证码(HMAC) 。
如果MinIO生成了这样的凭据,那么用于生成凭据的密钥 必须 保持不变, 并且 继续存在。 部署上的所有数据都是用这个密钥加密的!
要旋转生成的根凭据,您需要在KMS中生成一个新密钥,然后更新 MINIO_KMS_KES_KEY_NAME
环境变量的值以使用新密钥。
3) Start the MinIO Deployment
在本地主机上发出以下命令来启动 MinIO SNSD 作为前台进程部署。 您必须保持 shell 或终端会话打开才能保持进程运行。
From the Terminal, use the minio server
to start a local MinIO instance in the ~/data
folder.从终端使用 minio server
命令在 ~/data
文件夹中启动本地MinIO实例。
如果需要,您可以将 ~/data
替换为另一个用户具有读、写和删除权限的MinIO实例的位置。
export MINIO_CONFIG_ENV_FILE=/etc/default/minio
minio server --console-address :9090
Status: 1 Online, 0 Offline.
API: http://192.168.2.100:9000 http://127.0.0.1:9000
RootUser: myminioadmin
RootPass: minio-secret-key-change-me
Console: http://192.168.2.100:9090 http://127.0.0.1:9090
RootUser: myminioadmin
RootPass: minio-secret-key-change-me
Command-line: https://minio.org.cn/docs/minio/linux/reference/minio-mc.html
$ mc alias set myminio http://10.0.2.100:9000 myminioadmin minio-secret-key-change-me
Documentation: https://minio.org.cn/docs/minio/linux/index.html
API
列出了客户端可以访问MinIO S3 API的网络接口和端口。
Console
列出了网络接口和端口,客户端可以通过这些接口和端口访问MinIO网页端的控制台。
4) Connect to the MinIO Deployment
您可以通过在首选的浏览器中输入MinIO服务器 Console控制台
中的任何主机名或IP地址来访问MinIO控制台,例如http://localhost:9001。
登录MinIO的用户名和密码配置参数为 MINIO_ROOT_USER
和 MINIO_ROOT_PASSWORD
这些配置可以在在容器指定的环境文件中进行修改。

您可以使用MinIO控制台进行一般管理任务,如身份和访问管理、指标和日志监控或服务器配置。每个MinIO服务器都包含其自己的嵌入式MinIO控制台。 如果您的本地主机防火墙允许外部访问控制台端口,则同一网络上的其他主机可以使用您的本地主机的IP地址或主机名访问控制台。
你可以使用终端或Shell访问MinIO部署,请参考以下文档 MinIO客户端 (
mc
) 。 请查看关于 MinIO客户端安装快速入门 的安装的说明mc
。使用下面的命令
alias
可创建一个新的mc连接,连接对应于的MinIO部署的S3服务器。
请指定来自MinIO 服务器的 API
对应的主机名或IP地址,例如: http://localhost:9000 。
mc alias set myminio http://localhost:9000 myminioadmin minio-secret-key-change-me
将
myminio
替换为所需的别名。将
myminioadmin
替换为容器指定的环境文件中的MINIO_ROOT_USER
值。将 minio-secret-key-change-me 替换为容器指定的环境文件中的
MINIO_ROOT_PASSWORD
值。您可以使用任何
mc
命令与容器进行交互。 如果您的本地主机防火墙允许外部访问MinIO S3 API端口,同一网络上的其他主机可以使用您本地主机的IP或主机名访问MinIO部署。