This repository contains the code for the Cloud Controller. The NG signifies that this is a "next generation" component and this is not backward-compatible with the original cloud_controller. This version adds significant new functionality including the additional mandatory "organization" and "space" hierarchy that all users, applications and services must use.

The Cloud Controller itself is written in Ruby and provides REST API endpoints for clients to access the system. The Cloud Controller maintains a database with tables for orgs, spaces, apps, services, service instances, user roles, and more.

The Cloud Controller database has been tested with Postgres.

The Cloud Controller manages a blob store for:

• resources - files that are uploaded to the Cloud Controller with a unique SHA such that they can be reused without re-uploading the file
• app packages - unstaged files that represent an application
• droplets - the result of taking an app package and staging it (processesing a buildpack) and getting it ready to run

The blob store uses FOG such that it can use abstractions like Amazon S3 or an NFS-mounted file system for storage.

The Cloud Controller interacts with other core components of the Cloud Foundry platform using the NATS message bus. For example, it performs the following using NATS:

• Instructs a DEA to stage an application (processes a buildpack for the app) to prepare it to run
• Instructs a DEA to start or stop an application
• Receives information from the Health Manager about applications
• Subscribes to Service Gateways that advertise available services
• Instructs Service Gateways to handle provisioning, unprovision, bind and unbind operations for services