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环境变量

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

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

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

1. 通过环境变量MINIO_DOMAIN为MinIO服务器设置域名，例如export MINIO_DOMAIN=myminio.com。
2. 启动MinIO服务器。
3. 执行以下命令对设置了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格式说明：

开发者指南

运行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测试需执行以下步骤：

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

测试数据

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

更新镜像中的SDK/二进制文件

多数情况下，更新镜像中的SDK或二进制文件只需提交更新仓库中对应版本的修改。但某些情况（如更新mc，每次构建镜像时会拉取最新mc）需触发镜像重建，此时需提交“虚拟”修改（空提交可能无法触发Docker Hub镜像重建）。