mc Docker镜像文档

镜像概述和主要用途

本镜像基于MinIO客户端（mc）构建，主要用于在容器环境中执行各类脚本任务，提供便捷的对象存储管理能力。通过容器化部署，可快速集成mc工具到自动化流程或脚本中，简化依赖管理。

核心功能和特性

• 集成MinIO客户端（mc）：支持与MinIO对象存储服务交互，执行创建桶、上传/下载对象、设置访问策略、数据同步等核心操作。
• 容器化部署：轻量级镜像，可直接在Docker环境中运行，无需本地安装mc依赖。
• 版本化管理：提供多版本镜像，可通过标签指定具体版本（详见「版本信息」）。
• 灵活性：适用于各类脚本场景，支持通过命令行参数直接传递mc指令。

注意：镜像中包含的工具可能会不定期更新，版本变更无固定周期。

使用场景和适用范围

• 脚本自动化：在Shell脚本、Python脚本等自动化任务中调用mc，管理对象存储数据。
• CI/CD流程：集成到持续集成/部署管道，实现构建产物上传至MinIO、从MinIO拉取依赖等操作。
• 容器化环境管理：在Kubernetes、Docker Compose等容器编排环境中，作为临时任务容器执行对象存储操作。
• 数据备份/迁移：通过mc的mirror、cp等命令，实现跨存储服务的数据迁移或备份。

使用方法和配置说明

基础使用（docker run）

通过docker run命令直接运行容器并执行mc指令，基本格式如下：

bash
docker run --rm toolhippie/mc:latest <mc-command>

示例1：查看mc版本

bash
docker run --rm toolhippie/mc:latest mc --version

示例2：配置MinIO服务别名并列出桶

bash
docker run --rm toolhippie/mc:latest \
  mc alias set myminio [***] ACCESS_KEY SECRET_KEY && \
  mc ls myminio

示例3：挂载本地目录上传文件

如需上传本地文件到MinIO，可挂载本地目录至容器内的/data：

bash
docker run --rm -v /local/path:/data toolhippie/mc:latest \
  mc cp /data/local-file.txt myminio/mybucket/

版本选择

指定镜像标签可使用特定版本，例如：

bash
docker run --rm toolhippie/mc:20230101 mc --version

版本信息

如需查看所有可用版本，可访问以下标签页面：

• Docker Hub：toolhippie/mc 标签
• Quay.io：toolhippie/mc 标签

贡献指南

1. Fork 本仓库
2. 提交代码补丁（Patch）
3. 推送（Push）至个人分支
4. 提交Pull Request

作者

• Thomas Boerger (GitHub)

许可证

MIT

版权信息

console
Copyright (c) 2018 Thomas Boerger <[***]>