cloudfoundry/cloud_controller_ng

Cloud Controller NG is the REST API server component of Cloud Foundry that manages applications, services, user roles, and platform resources.

The Cloud Controller solves the problem of providing a unified interface for deploying and managing containerized applications across distributed infrastructure. It exposes REST API endpoints that allow operators and developers to create applications, manage services, configure user permissions, and orchestrate workloads. The system maintains a database of platform state, manages a blobstore for application packages and build artifacts, and coordinates with Diego to stage and execute applications on worker nodes. It supports both Postgres and MySQL for persistence and can store blobs across multiple backends including S3, Google Cloud Storage, Azure, and local filesystems.

Adoption suits organizations running Cloud Foundry as a platform-as-a-service or building internal developer platforms that need a production-grade API for application lifecycle management. The tool is designed for deployment via the capi-release BOSH release and integrates deeply with the Cloud Foundry ecosystem. Teams should expect to engage with both the V2 and V3 API specifications, as the project maintains both versions. Local development is supported through devcontainer setup or manual configuration with Ruby, Docker, and database tools, with helper scripts provided to streamline common tasks like database management and configuration generation.

The project maintains active continuous integration pipelines and publishes detailed architectural documentation including V3 design notes. Development follows a structured contribution process with a published contributors' guide and code of conduct. The codebase is organized around clear component boundaries separating API logic, database layer, blobstore management, and runtime coordination.