S3 术语

解释

AccessKey和SecretKey

AccessKey用于标识客户端身份；

SecretKey作为私钥保存在客户端服务器，不会在网络中传输，通常用于作为计算请求签名的密钥。

使用AccessKey进行身份识别，使用SecretKey进行签名，完成客户端的接入、认证和授权。

Object

Object即对象，Object包含key和data；

key为Object的名字，UTF-8编码后不能超过1024个字节；

data是Object的数据。

Object的key中可以带有斜杠，自动会在控制台里组织成目录结构。

Bucket

Bucket是S3的存储桶，S3是对象存储服务，Bucket就是存放Object的容器，每个Object必须存放在特定的Bucket中。

在Ceph RGW中每个用户最多创建1000个Bucket，每个Bucket中可以存放无数个Object。

Service

Service即服务，是S3提供给用户的虚拟存储空间，在这个虚拟空间里，一个用户可以拥有多个Bucket。

Region

在创建S3的Bucket时需要选择Region(区域)，一般用于标识存储的物理位置，如华东区、华北区。Region的外网域名具体指明该区的外网接入地址。

CEPH OBJECT GATEWAY S3 API FEATURES SUPPORT中给出了RGW和S3 API的兼容列表。

ACL

访问控制权限ACL是对Bucket和Object相关的访问控制策略，支持READ, READ, FULL_CONTROL三种权限，具体内容可以参考Managing Access with ACLs。

server {

      listen 80;

      server_name image-cache.ecf-cluster.svc;

      root /home/share;

      # 公有和私有镜像下载地址

      location ^~/ecx/ {

        proxy_set_header Host $host;

        proxy_set_header  X-Real-IP        $remote_addr;

        proxy_set_header  X-Forwarded-For  $proxy_add_x_forwarded_for;

        proxy_set_header X-Nginx-Proxy true;

        proxy_pass <s3url>;

    }

      location / {

        autoindex on;

        autoindex_exact_size on;

        autoindex_localtime on;

      }

  }

# 1.安装客户端工具，以下以awscli举例，也可以用s3cmd

$ sudo yum -y install python-pip

$ sudo pip install --upgrade pip

$ sudo pip install awscli --upgrade

# 2.配置AccessKey和SecretKey

$ aws configure --profile=ceph

AWS Access Key ID [None]: <ceph rgw的AccessKey>

AWS Secret Access Key [None]: <ceph rgw的SecretKey>

Default region name [None]:

Default output format [None]: json

# 3.创建对象桶(bucket)

$ aws --profile=ceph --endpoint=<ceph_rgw_host> s3 mb s3://evm

$ aws --profile=ceph --endpoint=<ceph_rgw_host> s3 ls

# 4.上传到对象桶(bucket)

$ aws --profile=ceph --endpoint=<ceph_rgw_host>  s3 cp Ceont7.6.qcow2 s3://evm/

规范

最大对象大小

5 TB

每次上传的分段的最大数量

10000

分段编号

1 到 10000 (含)

分段大小

5 MB 到 5 GB，上一个分段可以 <5 MB

列出分段请求返回的分段的最大数量

1000

在列出分段上传请求中返回的分段的最大数量

1000