minio/mint Docker Image Overview

minio/mint

自动构建

MinIO对象服务器的测试框架，用于运行正确性、基准测试和压力测试，支持多种SDK和工具验证服务器功能与稳定性。

0 次下载activeminio镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

Mint ![Slack]([] ![Docker Pulls]([]

Mint是MinIO对象服务器的测试框架，作为podman镜像提供。它运行正确性、基准测试和压力测试。以下是正确性测试中使用的SDK/工具：

awscli
aws-sdk-go
aws-sdk-java
aws-sdk-java-v2
aws-sdk-php
aws-sdk-ruby
healthcheck
mc
minio-go
minio-java
minio-js
minio-py
s3cmd
s3select
versioning

运行Mint

Mint通过podman run命令运行，需要安装Podman。Podman安装步骤可参考此处。

测试MinIO Play服务器

以MinIO Play服务器为测试目标运行Mint：

sh
$ podman run -e SERVER_ENDPOINT=play.minio.io:9000 -e ACCESS_KEY=Q3AM3UQ867SPQQA43P2F \
             -e SECRET_KEY=zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG -e ENABLE_HTTPS=1 minio/mint

测试完成后，输出日志存储在容器内的/mint/log目录。使用podman cp命令获取日志，例如：

sh
podman cp <container-id>:/mint/log /tmp/logs

Mint环境变量

运行容器时需传递以下环境变量，支持的环境变量说明：

环境变量	描述	示例
`SERVER_ENDPOINT`	MinIO服务器端点，格式为`HOST:PORT`；虚拟风格访问时使用`IP:PORT`	`play.minio.io:9000`
`ACCESS_KEY`	`SERVER_ENDPOINT`的访问密钥	`Q3AM3UQ867SPQQA43P2F`
`SECRET_KEY`	`SERVER_ENDPOINT`的密钥	`zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG`
`ENABLE_HTTPS`	（可选）设为`1`表示使用HTTPS访问`SERVER_ENDPOINT`，默认`0`（HTTP）	`1`
`MINT_MODE`	（可选）测试类别模式，取值`core`（核心）或`full`（完整），默认`core`	`full`
`DOMAIN`	（可选）MinIO服务器中使用的MINIO_DOMAIN环境变量值	`myminio.com`
`ENABLE_VIRTUAL_STYLE`	（可选）设为`1`表示启用虚拟风格访问，默认`0`（路径风格）	`1`
`RUN_ON_FAIL`	（可选）设为`1`表示即使失败也执行所有测试（目前支持minio-go和minio-java），默认`0`	`1`
`SERVER_REGION`	（可选）为区域特定测试设置自定义区域	`us-west-1`

测试MinIO服务器的虚拟风格访问

按以下步骤使用Mint测试MinIO服务器的虚拟风格访问：

通过环境变量MINIO_DOMAIN为MinIO服务器设置域名，例如export MINIO_DOMAIN=myminio.com。
启动MinIO服务器。
执行以下命令对设置了MINIO_DOMAIN的MinIO服务器运行Mint测试：

sh
$ podman run -e "SERVER_ENDPOINT=192.168.86.133:9000" -e "DOMAIN=minio.com"  \
             -e "ACCESS_KEY=minio" -e "SECRET_KEY=minio123" -e "ENABLE_HTTPS=0" \
             -e "ENABLE_VIRTUAL_STYLE=1" minio/mint

Mint日志格式

所有测试日志以多JSON文档形式存储在容器内/mint/log/log.json文件中。日志中每个条目的JSON格式说明：

JSON字段	类型	描述	示例
`name`	string	测试工具/SDK名称	`"aws-sdk-php"`
`function`	string	测试函数名称	`"getBucketLocation ( array $params = [] )"`
`args`	object	（可选）传递给测试函数的键值对参数映射	`{"Bucket":"aws-sdk-php-bucket-20341"}`
`duration`	int	测试运行时间（毫秒）	`384`
`status`	string	测试状态，取值`PASS`（通过）、`FAIL`（失败）或`NA`（不适用）	`"PASS"`
`alert`	string	（可选）指示测试失败的告警消息	`"I/O error on create file"`
`message`	string	（可选）日志消息	`"validating checksum of downloaded object"`
`error`	string	状态为`FAIL`时的详细错误消息，包含堆栈跟踪	`"Error executing \"CompleteMultipartUpload\" on ...`

开发者指南

运行Mint开发代码

修改Mint源代码后，可构建并运行本地podman镜像：

sh
$ podman build -t minio/mint . -f Dockerfile
$ podman run -e SERVER_ENDPOINT=play.minio.io:9000 -e ACCESS_KEY=Q3AM3UQ867SPQQA43P2F \
             -e SECRET_KEY=zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG \
             -e ENABLE_HTTPS=1 -e MINT_MODE=full minio/mint:latest

添加新工具/SDK的测试

添加新工具/SDK测试需执行以下步骤：

在build和run/core目录下创建新应用目录。
在应用目录中创建install.sh，用于安装所需工具/SDK。
构建和安装时的依赖项需添加到install-packages.list。
构建时依赖项需添加到remove-packages.list，以便移除，确保镜像干净。
在run/core下的应用目录中添加run.sh，用于执行实际测试。

测试数据

测试可使用预创建的数据集对MinIO服务器执行各种对象操作。容器内/mint/data目录下提供以下数据文件：

文件名	大小
datafile-0-b	0B
datafile-1-b	1B
datafile-1-kB	1KiB
datafile-10-kB	10KiB
datafile-33-kB	33KiB
datafile-100-kB	100KiB
datafile-1-MB	1MiB
datafile-1.03-MB	1.03MiB
datafile-5-MB	5MiB
datafile-6-MB	6MiB
datafile-10-MB	10MiB
datafile-11-MB	11MiB
datafile-65-MB	65MiB
datafile-129-MB	129MiB