Cloudserver custom build instructions

Cloudserver custom build instructions

Every S3 Connector(S3C) release has a corresponding tag in Git for Cloudserver. So a release, for example, S3C 7.4.4.7 has a tag 7.4.4.7 in Cloudserver’s git repository. The following instructions can be used to have a custom build of Cloudserver, this build writes metadata and data to the file system for persistence.

Run as a Docker container

This requires docker installed on the machine. Docker can be installed by following the instructions at https://www.docker.com/products/docker-desktop

Note: For S3C release 7.4.4.7 use 7.4.4.7 as the release number

export $S3C-VERSION=<release number>
git clone https://github.com/scality/cloudserver.git && cd cloudserver
git checkout tags/$S3C-VERSION
echo node_modules >> .dockerignore
docker build ./ -t cloudserver:$S3C-VERSION
docker run -d --name cloudserver-$S3C-VERSION -p 8000:8000 cloudserver:S3C-VERSION

Run directly on the development environment

This requires Node.js version 6.x installed on the host machine.

export $S3C-VERSION=<release number>
git clone https://github.com/scality/cloudserver.git && cd cloudserver
git checkout tags/$S3C-VERSION
npm install
npm start

This will have Cloudserver running on port 8000 on the loopback interface, so http://localhost:8000 can be used as an endpoint. The default credentials are

AWS_ACCESS_KEY_ID: accessKey1
AWS_SECRET_ACCESS_KEY: verySecretKey1