Bits Service

Please note: the Bits-Service is not actively maintained anymore. More information.

The bits-service is an extraction from existing functionality of the cloud controller. It encapsulates all "bits operations" into its own, separately scalable service. All bits operations comprise buildpacks, droplets, app_stashes, packages and the buildpack_cache.

The API is a work in progress and will most likely change.

Supported Backends

Bits currently supports WebDAV and the following Fog connectors:

• AWS S3
• Azure
• Google
• Local (NFS)
• Openstack

Development

The CI config is in the bits-service-ci repo.

Additional Notes

It can be used standalone or through its BOSH-release.

Getting Started

Make sure you have a working Go environment and the Go vendoring tool glide is properly installed.

To install bitsgo:

mkdir -p $GOPATH/src/github.com/cloudfoundry-incubator
cd $GOPATH/src/github.com/cloudfoundry-incubator

git clone https://github.com/cloudfoundry-incubator/bits-service.git
cd bits-service

glide install

cd cmd/bitsgo
go install

Then run it:

bitsgo --config my/path/to/config.yml

To run tests:

1. Install ginkgo

2. Configure $PATH:

   export PATH=$GOPATH/bin:$PATH
   

3. Run tests with

   scripts/run-unit-tests
   

Contributing to Bits-Service

The Bits-Service team is happy to receive feedback, suggestions, improvements and Pull Requests.

If you want to create a Pull Request against Bits-Service please make sure that the Unit Tests are passing successfully (as described in the Getting Started section)

If you would like to discuss about possible changes or improvements feel free to reach out to us via Bits-Service Cloud Foundry Slack