epigno/minio

MinIO镜像（集成mc客户端）

镜像概述

本镜像基于MinIO构建，核心特点是集成了MinIO Client(mc)命令，并包含服务启动等待机制，同时抑制了MinIO服务启动前等待期间的连接错误输出消息。旨在简化MinIO服务的容器化部署流程，提升管理操作的便捷性。

核心功能与特性

• 内置MinIO Client(mc)：容器中预先集成mc命令，可直接执行MinIO服务的管理操作（如创建bucket、设置访问策略、数据迁移等），无需额外安装客户端工具。
• 服务启动等待机制：自动等待MinIO服务完全启动后再执行后续流程，解决服务启动时序问题，确保依赖服务就绪后再进行交互。
• 连接错误输出抑制：在服务启动前的等待阶段，自动过滤并抑制不必要的连接错误消息，减少日志冗余，保持启动过程输出简洁清晰。

使用场景与适用范围

• MinIO服务的容器化部署场景，尤其是需要在启动后立即执行初始化配置（如创建默认存储桶、配置用户权限）的场景。
• 自动化部署流程（如CI/CD流水线）中，需通过mc客户端与MinIO服务进行交互的场景。
• 对容器日志输出整洁性有要求，希望减少启动阶段无关错误信息干扰的开发或生产环境。

使用方法与配置说明

基本部署命令

bash
docker run -d --name minio-instance \
  -e MINIO_ROOT_USER=admin \
  -e MINIO_ROOT_PASSWORD=StrongPassword123 \
  -p 9000:9000 \  # API端口
  -p 9001:9001 \  # 控制台端口
  [镜像名称]:[标签]

内置mc客户端使用示例

容器启动后，可通过docker exec进入容器直接使用mc命令：

bash
# 1. 进入容器
docker exec -it minio-instance /bin/sh

# 2. 配置MinIO服务别名（如需远程访问，替换localhost为实际服务地址）
mc alias set localminio http://localhost:9000 admin StrongPassword123

# 3. 执行管理操作（示例：创建存储桶）
mc mb localminio/my-first-bucket

# 4. 查看存储桶列表
mc ls localminio

启动等待机制说明

镜像启动时会自动检测MinIO服务在9000端口的就绪状态，等待期间无需额外配置。默认等待超时时间为300秒（可通过环境变量MINIO_WAIT_TIMEOUT自定义，单位：秒）。

注意事项

• 环境变量MINIO_ROOT_USER和MINIO_ROOT_PASSWORD为必填项，用于设置MinIO管理员凭证。
• 端口映射可根据实际需求调整，9000端口为API端口（必须映射），9001端口为Web控制台端口（可选映射）。
• 如需持久化存储数据，建议通过-v参数挂载宿主机目录至容器内/data路径（如：-v /path/on/host:/data）。