altmannmarcelo/minio

Minio Docker容器

容器概述

本容器用于针对S3 API进行集成测试，基于https://github.com/minio/minio "MinIO"服务构建。为方便测试，容器内置以下工具：

• aws cli
• iproute2 / tc（网络控制工具）
• dsniff / tcpkill（网络连接管理工具）
• curl（HTTP客户端）
• jq（JSON处理工具）

核心功能与特性

• 提供S3兼容的对象存储服务，用于API集成测试
• 支持自定义访问密钥（Access Key ID）和密钥（Secret Access Key）
• 可配置服务端口
• 内置网络测试工具，支持模拟网络问题（延迟、丢包等）
• 包含AWS CLI，便于直接进行S3操作测试

使用场景

• S3 API客户端应用的集成测试环境搭建
• 验证应用在网络异常情况下的容错能力
• 开发阶段快速搭建本地S3兼容服务

使用方法

Docker Hub镜像

通过以下命令启动容器：

bash
docker run -d --security-opt seccomp=unconfined --cap-add=NET_ADMIN --rm -p 9000:9000 --name s3 altmannmarcelo/minio:latest

可通过环境变量自定义配置：

• --env USER - 修改访问密钥ID（默认值：admin）
• --env PASSWORD - 修改密钥（默认值：password）
• --env PORT - 修改服务端口（默认值：9000）

示例（自定义配置）：

bash
docker run -d --security-opt seccomp=unconfined --cap-add=NET_ADMIN --rm -p 9001:9001 --env USER=myuser --env PASSWORD=myStrongPassw0rd! --env PORT=9001 --name s3 altmannmarcelo/minio:latest

本地构建镜像

使用Dockerfile构建本地镜像：

bash
docker build .

# 构建成功后会显示镜像ID，例如：
# Successfully built 5f1fd412b0e4

使用镜像ID启动容器：

bash
docker run -d --security-opt seccomp=unconfined --cap-add=NET_ADMIN --rm -p 9000:9000 --name s3 5f1fd412b0e4

也可在构建时指定标签，便于后续使用：

bash
docker build -t altmannmarcelo/minio:latest .
docker run -d --security-opt seccomp=unconfined --cap-add=NET_ADMIN --rm -p 9000:9000 --name s3 altmannmarcelo/minio:latest

AWS CLI操作示例

配置AWS CLI：

bash
aws configure
AWS Access Key ID [None]: admin
AWS Secret Access Key [None]: password
Default region name [None]: us-east-1
Default output format [None]:

# 设置S3签名版本
aws configure set default.s3.signature_version s3v4

基本S3操作：

bash
# 创建桶
aws --endpoint-url http://127.0.0.1:9000 s3 mb s3://newbucket

# 上传文件
echo "test" > test.txt
aws --endpoint-url http://127.0.0.1:9000 s3 cp test.txt s3://newbucket

# 列出桶
aws --endpoint-url http://127.0.0.1:9000 s3 ls

网络混沌测试

通过以下命令模拟网络问题，测试应用在异常网络环境下的表现：

bash
# 进入容器
docker exec -it s3 bash

# 终止应用连接（替换APP_HOST为应用IP）
APP_HOST=172.17.0.1
timeout 5 tcpkill host ${APP_HOST}

# 添加网络延迟（90ms）
tc qdisc add dev eth0 root netem delay 90ms
sleep $[($RANDOM%10) + 1]s  # 随机等待1-10秒
tc qdisc del dev eth0 root netem;  # 移除延迟配置

# 模拟严重网络问题（60秒延迟+99%丢包）
tc qdisc add dev eth0 root netem delay 60000ms loss 99%;
sleep $[($RANDOM%10) + 1]s
tc qdisc del dev eth0 root netem;