To use the prototype, clone this repository (this may take several minutes as it includes some large test files):

git clone https://github.com/glyn/bloblets.git

In the following, we assume the repository has been cloned into the bloblets directory.

Then install the pre-requisites and run and invoke the server as described below.

Install Go 1.5.x or later.

Get the compile-time dependencies:

go get https://github.com/cloudfoundry/cli.git

You will also need an AWS account and corresponding AWS keys so that the blobstore can be stored in Amazon S3.

Run the server locally as follows:

cd bloblets/server
AWS_ACCESS_KEY_ID=<access key> AWS_SECRET_ACCESS_KEY=<secret key> PORT=8080 go run server.go

Push an application to the server as follows:

cd bloblets/client
go install . && time client localhost:8080 <test-app>

where <test-app> is the path of the application to be pushed. For a suitable example, download zipkin-web.

Install the cf CLI if you don't already have it.

Build the server:

cd bloblets/server
GOOS=linux GOARCH=amd64 go build -o <app-dir> .

where <app-dir> is a convenient empty directory.

Copy manifest.yml to manifest.secret.yml and add your AWS keys to this file.

Then push the server:

cf api api.run.pivotal.io
// log in and set org/space
cf push <app-name> -p <app-dir> -c "./server" -b https://github.com/cloudfoundry/binary-buildpack.git -f ./manifest.secret.yml

where <app-name> is the name chosen for the application

The output will include the hostname of the deployed server:

urls: <app-name>.cfapps.io

Push an application to the server as follows:

cd bloblets/client
go install . && time client <app-name>.cfapps.io:80 <test-app>

where <app-name> is the name chosen for the application and <test-app> is the path of the application to be pushed. For a suitable example, download zipkin-web.