fanyinghao/ossutil

镜像概述

该镜像为包含常见工具的Dockerfile集合，旨在提供便捷的工具环境，帮助用户快速获取和使用各类常用工具。当前主要支持阿里云对象存储服务（OSS）的命令行工具ossutil。

核心功能与特性

支持的工具

• ossutil：阿里云官方OSS命令行工具，主要用于OSS的文件上传、下载、删除、列举等文件管理操作，支持批量处理及各类OSS操作场景。

使用场景

适用于需要在Docker环境中便捷使用ossutil工具进行阿里云OSS文件管理的场景，例如：

• 在CI/CD流程中，通过Docker容器使用ossutil将构建产物上传至OSS存储
• 在开发或测试环境中，快速部署包含ossutil的工具环境，进行OSS文件上传、下载等操作测试
• 需要隔离的工具环境中执行OSS相关自动化脚本任务

使用方法

获取镜像

（具体获取方式需根据实际镜像仓库确定，以下为通用使用流程示例）

构建本地镜像

若需基于Dockerfile构建本地镜像，可执行以下步骤：

1. 获取包含目标Dockerfile的源码（如克隆相关仓库）
2. 进入Dockerfile所在目录，执行构建命令：

   bash
   docker build -t common-utils:latest .
   

使用ossutil工具

构建或获取镜像后，可通过容器运行ossutil命令，基本使用格式如下：

bash
# 查看ossutil版本
docker run --rm common-utils:latest ossutil --version

# 执行文件上传操作（将本地文件上传至OSS）
docker run --rm -v /本地文件路径:/data common-utils:latest ossutil cp /data/本地文件名 oss://目标Bucket名称/目标路径/

配置说明

使用ossutil前需配置OSS访问信息，可通过以下方式实现：

• 环境变量配置：运行容器时通过-e参数设置环境变量，如OSS_ACCESS_KEY_ID（访问密钥ID）、OSS_ACCESS_KEY_SECRET（访问密钥Secret）、OSS_ENDPOINT（OSS服务端点）等
• 配置文件挂载：将本地已配置的ossutil配置文件（通常位于~/.ossutilconfig）通过-v参数挂载至容器内对应路径（如/root/.ossutilconfig），示例：

  bash
  docker run --rm -v ~/.ossutilconfig:/root/.ossutilconfig common-utils:latest ossutil ls oss://目标Bucket名称