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 example, to match S3C release 7.4.4.8 use 7.4.4.8 as the release number

#!/bin/bash

export S3C_VERSION=<release version>
echo "Building Cloudserver Version $S3C_VERSION"
git clone https://github.com/scality/cloudserver.git cloudserver-$S3C_VERSION
cd cloudserver-$S3C_VERSION
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 10.x installed on the host machine. Note: If npm errors with

#!/bin/bash

export S3C_VERSION=<release version>
echo "Building Cloudserver Version $S3C_VERSION"
git clone https://github.com/scality/cloudserver.git cloudserver-$S3C_VERSION
cd cloudserver-$S3C_VERSION
git checkout tags/$S3C_VERSION
yarn
yarn 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