Aliyun OSS Emulator

Setup

Install required gems:

gem install thor builder webrick

Original README:

关于

• oss-emulator 轻量级的OSS服务模拟器，提供与OSS服务相同的API接口。

使用场景

• 基于OSS应用的调试，甚至无网络环境下也可以调试基于OSS的应用；
• 基于OSS应用的性能测试，节省大量费用；

支持接口

• oss-emulator 支持 put, get, list, copy, delete, multipart 等数据操作API接口，支持部分Bucket操作接口。

Bucket相关接口

• 支持

ListBuckets(GetService),PutBucket(CreateBucket),GetBucket,DeleteBucket,
GetBucketLocation,GetBucketInfo,PutBucketACL,GetBucketACL

• 不支持

PutBucketLogging,PutBucketWebsite,PutBucketReferer,PutBucketLifecycle,
GetBucketLogging,GetBucketWebsite,GetBucketReferer,GetBucketLifecycle,
DeleteBucketLogging,DeleteBucketWebsite,DeleteBucketLifecycle

Object相关接口

• 支持

PutObject,CopyObject,AppendObject,GetObject,DeleteObject,DeleteMultipleObjects,
HeadObject,GetObjectMeta,PutObjectACL,GetObjectACL

• 不支持

PostObject,Callback,PutSymlink,GetSymlink,RestoreObject

Multipart相关接口

• 支持

InitiateMultipartUpload,UploadPart,CompleteMultipartUpload

• 不支持

UploadPartCopy,AbortMultipartUpload,ListMultipartUpload,ListParts

环境

• Ruby 2.2.8及以上

安装

安装运行 oss-emulator 前，请确保已经安装 Ruby。

Linux

• 安装依赖

    sudo gem install thor builder

• 下载 oss-emulator

• 运行。进入 oss-emulator 目录, 执行命令 ruby bin/emulator -r store -p 8080。

Windows

• 安装依赖

    gem install thor builder

• 下载 oss-emulator

• 运行。进入 oss-emulator 目录, 执行命令 ruby bin/emulator -r store -p 8080。

使用示例

ossutil

• 方法一：直接在命令行中携带参数, 其中endpoint设置为oss-emulator的IP; AccessKeyId和AccessKeySecret如下, 也可以不填。 如：

    ossutil -e http://192.168.0.1:8080 -i  AccessKeyId -k AccessKeySecret ls oss://bucket

• 方法二：使用 ossutil config 命令配置参数，参数配置和 方法一 相同：

    ossutil config

提示：

• ossutil文档请参考官网

Python SDK

• Python SDK 连接 oss-emulator 代码的如下, 其中endpoint设置为 oss-emulator 的IP, AccessKeyId和AccessKeySecret如下, 也可以不填。

    import oss2

    auth = oss2.Auth('AccessKeySecret', 'AccessKeySecret')
    bucket = oss2.Bucket(auth, 'http//:192.168.0.1:8080', 'MyBucketName')
    bucket.create_bucket()

提示：

• Python SDK的说明文档请参考官网