leviy/minio

Minio 开发测试镜像

镜像概述

本镜像基于Minio构建，专为（AWS S3）对象存储集成的开发和测试场景设计。Minio是一款兼容S3 API的对象存储服务，本镜像提供轻量级部署方案，可在本地环境快速模拟S3服务，帮助开发者高效进行应用与S3集成的开发、调试及测试工作。

核心功能与特性

• S3 API兼容性：完全兼容AWS S3 API，支持常见S3操作（如上传、下载、删除对象，创建桶等），确保开发测试环境与生产S3服务行为一致。
• 轻量级部署：镜像体积小，启动快速，适合本地开发和测试环境资源有限的场景。
• 灵活配置：支持通过环境变量自定义访问密钥、密钥、端口等核心参数，满足不同测试需求。
• 本地存储支持：默认使用容器内存储，也可通过数据卷挂载实现持久化存储，便于测试数据管理。

使用场景与适用范围

• 应用开发：开发需要与S3集成的应用时，作为本地S3服务替代，避免依赖远程S3服务。
• 自动化测试：在CI/CD流水线中作为测试环境依赖，验证应用与S3交互的功能正确性。
• 功能原型验证：快速验证S3相关功能原型，无需配置真实AWS账户。
• 学习与演示：学习S3 API使用或演示S3集成功能时的本地环境搭建。

使用方法与配置说明

基本使用（docker run）

通过以下命令快速启动Minio服务：

bash
docker run -d -p 9000:9000 -p 9001:9001 \
  -e "MINIO_ROOT_USER=AKIAEXAMPLE" \
  -e "MINIO_ROOT_PASSWORD=examplepassword" \
  --name minio-dev \
  minio/minio server /data --console-address ":9001"

• -p 9000:9000：映射S3 API端口
• -p 9001:9001：映射Minio管理控制台端口
• MINIO_ROOT_USER：访问密钥（类似AWS Access Key）
• MINIO_ROOT_PASSWORD：密钥（类似AWS Secret Key）
• /data：容器内存储路径，可通过-v /local/path:/data挂载本地目录实现数据持久化

环境变量配置

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  minio:
    image: minio/minio
    ports:
      - "9000:9000"
      - "9001:9001"
    environment:
      MINIO_ROOT_USER: "AKIAEXAMPLE"
      MINIO_ROOT_PASSWORD: "examplepassword"
    volumes:
      - ./minio-data:/data
    command: server /data --console-address ":9001"

启动服务：

bash
docker-compose up -d

验证服务

服务启动后，可通过以下方式验证：

1. 访问管理控制台：http://localhost:9001，使用配置的MINIO_ROOT_USER和MINIO_ROOT_PASSWORD登录。
2. 使用S3客户端工具（如AWS CLI）连接测试：

bash
aws s3 --endpoint-url http://localhost:9000 ls