热门搜索:
minio/mint
自动构建
MinIO对象服务器的测试框架，用于运行正确性、基准测试和压力测试，支持多种SDK和工具验证服务器功能与稳定性。
Mint ![Slack]([***]
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命令获取日志，例如：
shpodman 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测试需执行以下步骤：
- 在https://github.com/minio/mint/tree/master/build%E5%92%8Chttps://github.com/minio/mint/tree/master/run/core%E7%9B%AE%E5%BD%95%E4%B8%8B%E5%88%9B%E5%BB%BA%E6%96%B0%E5%BA%94%E7%94%A8%E7%9B%AE%E5%BD%95%E3%80%82
- 在应用目录中创建
install.sh，用于安装所需工具/SDK。 - 构建和安装时的依赖项需添加到https://github.com/minio/mint/blob/master/install-packages.list%E3%80%82
- 构建时依赖项需添加到https://github.com/minio/mint/blob/master/remove-packages.list%EF%BC%8C%E4%BB%A5%E4%BE%BF%E7%A7%BB%E9%99%A4%EF%BC%8C%E7%A1%AE%E4%BF%9D%E9%95%9C%E5%83%8F%E5%B9%B2%E5%87%80%E3%80%82
- 在
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 |
更新镜像中的SDK/二进制文件
多数情况下，更新镜像中的SDK或二进制文件只需提交更新仓库中对应版本的修改。但某些情况（如更新mc，每次构建镜像时会拉取最新mc）需触发镜像重建，此时需提交“虚拟”修改（空提交可能无法触发Docker Hub镜像重建）。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull minio/mint:<标签>
更多 mint 镜像推荐
bitnami/minio
Bitnami Secure Images（VMware Tanzu）
Bitnami MinIO安全镜像是一款针对MinIO对象存储服务精心打造的预配置容器镜像，通过集成自动安全更新、合规性检查及性能优化机制实现深度安全加固，可简化企业级云原生环境下的部署流程，有效增强数据存储的保密性与可靠性，助力用户快速构建稳定高效的对象存储解决方案。
169 次收藏5000万+ 次下载
7 个月前更新
bitnamicharts/minio
bitnamicharts
Bitnami提供的Helm chart，用于在Kubernetes环境中部署和管理MinIO对象存储服务。
5 次收藏1000万+ 次下载
8 个月前更新
elestio/minio
elestio
由Elestio验证并打包的Minio对象存储服务，提供兼容S3 API的高性能数据存储解决方案，适用于云原生环境下的文件存储与管理。
10 次收藏5万+ 次下载
6 个月前更新
rook/minio
rook
Minio是面向云原生环境的高性能分布式对象存储服务器。
2 次收藏50万+ 次下载
5 年前更新
chainguard/minio
chainguard
使用Chainguard的低至零CVE容器镜像构建、交付和运行安全软件。
1 次收藏1万+ 次下载
9 天前更新
demisto/minio
demisto
暂无描述
1万+ 次下载
2 年前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"