Zenko CloudServer
- 0 ratings
Zenko CloudServer, an open-source implementation of a server handling the Amazon S3 protocol.
Deploy this app to Linode with a free $100 credit!
CloudServer (formerly S3 Server) is an open-source Amazon S3-compatible object storage server that is part of Zenko, Scality’s Open Source Multi-Cloud Data Controller.
CloudServer provides a single AWS S3 API interface to access multiple backend data storage both on-premise or public in the cloud.
CloudServer is useful for Developers, either to run as part of a continous integration test environment to emulate the AWS S3 service locally or as an abstraction layer to develop object storage enabled application on the go.
Run your Zenko CloudServer with Docker
In order to contribute, please follow the Contributing Guidelines.
Building and running the Zenko CloudServer requires node.js 10.x and yarn v1.17.x . Up-to-date versions can be found at Nodesource.
git clone https://github.com/scality/S3.gitGo to the ./S3 folder,
yarn install --frozen-lockfileIf you get an error regarding installation of the diskUsage module, please install g++.
If you get an error regarding level-down bindings, try clearing your yarn cache:
yarn cache cleanyarn startThis starts a Zenko CloudServer on port 8000. Two additional ports 9990 and 9991 are also open locally for internal transfer of metadata and data, respectively.
The default access key is accessKey1 with a secret key of verySecretKey1.
By default the metadata files will be saved in the localMetadata directory and the data files will be saved in the localData directory within the ./S3 directory on your machine. These directories have been pre-created within the repository. If you would like to save the data or metadata in different locations of your choice, you must specify them with absolute paths. So, when starting the server:
mkdir -m 700 $(pwd)/myFavoriteDataPath
mkdir -m 700 $(pwd)/myFavoriteMetadataPath
export S3DATAPATH="$(pwd)/myFavoriteDataPath"
export S3METADATAPATH="$(pwd)/myFavoriteMetadataPath"
yarn startexport S3DATA='multiple'
yarn startThis starts a Zenko CloudServer on port 8000. The default access key is accessKey1 with a secret key of verySecretKey1.
With multiple backends, you have the ability to choose where each object will be saved by setting the following header with a locationConstraint on a PUT request:
'x-amz-meta-scal-location-constraint':'myLocationConstraint'If no header is sent with a PUT object request, the location constraint of the bucket will determine where the data is saved. If the bucket has no location constraint, the endpoint of the PUT request will be used to determine location.
See the Configuration section in our documentation here to learn how to set location constraints.
yarn run mem_backendThis starts a Zenko CloudServer on port 8000. The default access key is accessKey1 with a secret key of verySecretKey1.
Note: Vault is proprietary and must be accessed separately.
export S3VAULT=vault
yarn startThis starts a Zenko CloudServer using Vault for user management.
Please login to review this project.
No reviews for this project yet.
Comments (0)
Please login to join the discussion on this project.