Skip to content

Latest commit

 

History

History
117 lines (96 loc) · 5.92 KB

CHARTER.md

File metadata and controls

117 lines (96 loc) · 5.92 KB

Project Charter

Overview

Crossplane is a framework for building cloud native control planes without needing to write code. It has a highly extensible backend that enables you to build a control plane that can orchestrate applications and infrastructure no matter where they run, and a highly configurable frontend that puts you in control of the schema of the declarative API it offers.

Control Planes

Control planes first emerged in network packet switching, where devices must forward packets as fast as possible, but also be highly configurable. Breaking out the control plane from the data plane allows the former to be optimized for flexibility while the latter is optimized for speed. It also decouples the failure domains - a control plane failure does not prevent the data plane from functioning. Control planes are rooted in control theory, in particular closed loop control where the actual state of a system is observed in order to determine how best to drive it toward a desired state.

Control planes power cloud computing. Cloud providers like AWS are built with control planes, as are projects like Kubernetes. In cloud computing the data plane is instead a “compute plane” consisting of applications and the infrastructure they run on - VMs, containers, databases, caches, queues, etc.

Control planes are popular in cloud computing because they:

  • Are “always-on”, constantly correcting drift by driving observed state toward desired state.
  • Are API-driven, which enables discovery, collaboration, and integration with other systems.
  • Don’t need to be installed on every laptop and CI/CD system, making them easier to operate.
  • Keep control in a separate failure domain from the plane under control (e.g. compute).

Cloud native organizations increasingly prefer control planes to approaches such as imperative scripts or Infrastructure-as-Code (IaC), but historically building a control plane has required a significant investment to design and code it from scratch. This is where Crossplane comes in.

What Crossplane Is

Crossplane is a neutral place for vendors and individuals to come together in enabling control planes. It offers a framework to build control planes for cloud native computing without needing to write code (unless you want to). It shares a foundation with Kubernetes, but supports many powerful extensions that enable it to control anything - not just containers. The Crossplane project consists of:

  • The Crossplane Resource Model (XRM). An API model for Crossplane extensions.
  • The ability to compose bespoke control plane APIs for any compute plane.
  • A package format and manager to extend your control plane with:
    • The ability to orchestrate any kind of compute plane resource.
    • New ways to compose control plane APIs.
    • New integration with supporting services such as secret stores.
  • Tooling to create and test new Crossplane extensions.
  • A conformance program for Crossplane extensions.

As a framework, Crossplane:

  • Avoids building features specific to any particular compute plane in its core. Instead features pertaining to any particular cloud provider, project, or tool are enabled through extension points.
  • Focuses on APIs. Crossplane provides and recommends “golden path” tools to build conformant extensions but does not require them. Anything with conformant API schema and behavior may be considered a Crossplane extension - regardless of how it is built.
  • Optimizes for “vertical integration”. That is, Crossplane extensions are intended and designed to be used in conjunction with Crossplane and each other.
  • Prioritizes enabling a “separation of concerns” between control plane curators and consumers. Curators deploy, extend, and configure control planes, while consumers use them to orchestrate compute planes.

What Crossplane Is Not

Crossplane is not intended to be a “batteries included” control plane for any particular use case. Instead it is a framework that you can deploy, configure, and extend to power control planes for your own highly bespoke use cases, often without writing any code.

The project is a neutral place for vendors and individuals to come together in enabling control planes. To that extent, it does not police Crossplane extensions. Any extension that passes the appropriate Crossplane conformance suite may consider itself to be “a Crossplane extension” - regardless of how it is built, how it is licensed, who maintains it, how it is governed, or where it is hosted. Conformance suites are typically concerned with behavior and (where applicable) API shape, not internal implementation details.

Concrete examples of things that are not in scope for the project include (but are not limited to):

  • Providing or mandating abstractions around specific use cases such as provisioning applications (e.g. a PaaS API) or provisioning Kubernetes clusters.
  • Providing or mandating a configuration language (for example, CUE). Crossplane provides a declarative API that may be targeted by arbitrary configuration languages, and extension points that may be powered by arbitrary languages.
  • Enabling the use of Crossplane extensions without using Crossplane and vice versa; this is not supported and may result in undefined behavior.
  • Providing or mandating opinions around control plane hosting and tenancy models.
  • Offering ‘in-tree’ support for particular compute planes - e.g. AWS. All features specific to any specific compute plane provider are built as extensions.
  • Offering a package specification or manager for anything other than Crossplane extensions.
  • Offering API clients such as command-line interfaces (CLIs) or web consoles.

Updating this Document

This is a living document. Changes to the scope, principles, or mission statement of the Crossplane project require a majority vote of the steering committee.