OpenStack

OpenStack is a collection of interoperable components that can be deployed together to provide computing, networking, and storage resources. Once deployed, those resources are reached by end users through programmable APIs rather than a fixed console.

This particular repository is not that code. It represents OpenStack as a collection of git submodules, with the repositories for individual components hosted separately, and it is intended to be used in a read-only manner.

The superproject exists to answer a question that is otherwise awkward to answer.

• Tested combinations: any commit here points at a set of component commits that were explicitly tested with each other.
• Zuul gating: the continuous integration system gates all contained projects in an effective single timeline.
• Submodule tracking: Gerrit updates the superproject whenever a subproject changes, capturing the sequence Zuul produced.
• Component sources: the working repositories for each component live in the OpenStack namespace on opendev.
• Read-only intent: commits are not made here directly, since the superproject records history rather than holding it.

Anyone who needs to pin a deployment to a known-good combination of component versions can take it from here instead of reconstructing it commit by commit across every project. Documentation for the individual components, the contributor process, and the governance model is maintained separately by the OpenStack community.