zenko/cloudserver

Zenko CloudServer

概述

CloudServer（前身为S3 Server）是一个开源的Amazon S3兼容对象存储服务器，是Zenko（Scality的开源多云数据控制器）的一部分。

CloudServer提供单一AWS S3 API接口，可访问多种后端数据存储，无论是本地部署还是公共云存储。

CloudServer对开发者非常有用，既可作为持续集成测试环境的一部分，在本地模拟AWS S3服务，也可作为抽象层，方便开发支持对象存储的应用。

了解更多：[***]

是否需要查阅详细文档？

Docker

https://hub.docker.com/r/zenko/cloudserver/

贡献

如需贡献，请遵循https://github.com/scality/Guidelines/blob/master/CONTRIBUTING.md%E3%80%82

安装

依赖

构建和运行Zenko CloudServer需要node.js 10.x和yarn v1.17.x。可在https://github.com/nodesource/distributions%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82

克隆源代码

shell
git clone https://github.com/scality/S3.git

安装JavaScript依赖

进入./S3文件夹：

shell
yarn install --frozen-lockfile

如果在安装diskUsage模块时遇到错误，请安装g++。

如果在level-down绑定方面遇到错误，尝试清除yarn缓存：

shell
yarn cache clean

使用文件后端运行

shell
yarn start

这将在端口8000上启动Zenko CloudServer。另外两个端口9990和9991在本地开放，分别用于元数据和数据的内部传输。

默认访问密钥为accessKey1，密钥为verySecretKey1。

默认情况下，元数据文件将保存在本地的./S3目录下的localMetadata文件夹中，数据文件保存在localData文件夹中。这些目录已在仓库中预先创建。如果希望将数据或元数据保存在其他位置，必须使用绝对路径指定。启动服务器时：

shell
mkdir -m 700 $(pwd)/myFavoriteDataPath
mkdir -m 700 $(pwd)/myFavoriteMetadataPath
export S3DATAPATH="$(pwd)/myFavoriteDataPath"
export S3METADATAPATH="$(pwd)/myFavoriteMetadataPath"
yarn start

使用多数据后端运行

shell
export S3DATA='multiple'
yarn start

这将在端口8000上启动Zenko CloudServer。默认访问密钥为accessKey1，密钥为verySecretKey1。

使用多后端时，可以通过在PUT请求中设置带有locationConstraint的以下头信息，选择每个对象的保存位置：

shell
'x-amz-meta-scal-location-constraint':'myLocationConstraint'

如果PUT对象请求未发送头信息，将由存储桶的位置约束决定数据保存位置。如果存储桶没有位置约束，将使用PUT请求的端点来确定位置。

有关如何设置位置约束，请参阅文档中的配置部分此处。

使用内存后端运行

shell
yarn run mem_backend

这将在端口8000上启动Zenko CloudServer。默认访问密钥为accessKey1，密钥为verySecretKey1。

使用Vault用户管理运行

注意：Vault是专有软件，必须单独获取访问权限。

shell
export S3VAULT=vault
yarn start

这将启动使用Vault进行用户管理的Zenko CloudServer。