|
1 | 1 | ---
|
2 |
| -title: "Overview" |
| 2 | +title: "Welcome" |
3 | 3 | weight: -1
|
4 | 4 | cascade:
|
5 | 5 | version: "2.0-preview"
|
6 | 6 | ---
|
7 | 7 |
|
8 |
| -{{< img src="/media/banner.png" alt="Crossplane Popsicle Truck" size="large" >}} |
| 8 | +Welcome to the Crossplane documentation. Crossplane is a control plane framework |
| 9 | +for platform engineering. |
9 | 10 |
|
10 |
| -<br /> |
| 11 | +Crossplane lets you build control planes to manage your apps, infrastructure, or |
| 12 | +anything else. It lets you design the APIs and abstractions that your users use |
| 13 | +to interact with your control planes. |
11 | 14 |
|
12 |
| -Crossplane is an open source Kubernetes extension that transforms your Kubernetes |
13 |
| -cluster into a **universal control plane**. |
| 15 | +Crossplane has a rich ecosystem of extensions that make building a control plane |
| 16 | +faster and easier. It's built on Kubernetes, so it works with all the Kubernetes |
| 17 | +tools you already use. |
14 | 18 |
|
15 |
| -Crossplane lets you manage anything, anywhere, all through standard Kubernetes |
16 |
| -APIs. Crossplane can even let you |
17 |
| -[order a pizza](https://blog.crossplane.io/providers-101-ordering-pizza-with-kubernetes-and-crossplane/) |
18 |
| -directly from Kubernetes. If it has an API, Crossplane can connect to it. |
| 19 | +{{< hint "tip" >}} |
| 20 | +**A control plane is software that controls other software.** |
19 | 21 |
|
20 |
| -With Crossplane, platform teams can create new abstractions and custom |
21 |
| -APIs with the full power of Kubernetes policies, namespaces, role based access |
22 |
| -controls and more. Crossplane brings all your non-Kubernetes resources under |
23 |
| -one roof. |
| 22 | +Control planes expose an API. You use the API to tell the control plane what |
| 23 | +software it should deploy and how - this is your _desired state_. It could be |
| 24 | +any cloud native software, like an app, a load balancer, or a GitHub repository. |
24 | 25 |
|
25 |
| -Custom APIs, created by platform teams, allow security and compliance |
26 |
| -enforcement across resources or clouds, without exposing any complexity to the |
27 |
| -developers. A single API call can create multiple resources, in multiple clouds |
28 |
| -and use Kubernetes as the control plane for everything. |
| 26 | +The control plane deploys your software, then monitors it throughout its |
| 27 | +lifecycle. If your software ever _drifts_ from your desired state, the control |
| 28 | +plane automatically corrects the drift. |
29 | 29 |
|
30 |
| -{{< hint "tip" >}} |
31 |
| -**What's a control plane?** |
32 |
| -<!-- vale Google.WordList = NO --> |
33 |
| -Control planes create and manage the lifecycle of resources. Control planes |
34 |
| -constantly _check_ that the intended resources exist, _report_ when the intended |
35 |
| -state doesn't match reality and _act_ to make things right. |
36 |
| - |
37 |
| -Crossplane extends the Kubernetes control plane to be a **universal control |
38 |
| -plane** to check, report and act on any resource, anywhere. |
39 |
| -<!-- vale Google.WordList = YES --> |
| 30 | +Control planes are a core cloud native pattern. The major cloud providers are |
| 31 | +all built using control planes. |
40 | 32 | {{< /hint >}}
|
41 | 33 |
|
42 | 34 |
|
43 |
| -# Get started |
44 |
| -* [Install Crossplane]({{<ref "get-started/install">}}) in your Kubernetes cluster |
45 |
| -* Learn more about how Crossplane works in the |
46 |
| -[Crossplane introduction]({{<ref "get-started" >}}) |
47 |
| -* Join the [Crossplane Slack](https://slack.crossplane.io/) and start a |
48 |
| -conversation with a community of over 7,000 operators. |
| 35 | +# Using the documentation |
| 36 | + |
| 37 | +Crossplane organizes its documentation into the following sections: |
| 38 | + |
| 39 | +* [Get Started]({{<ref "get-started">}}) explains how to install Crossplane and |
| 40 | + create a control plane. |
| 41 | + |
| 42 | +* [Concepts]({{<ref "concepts">}}) introduces Crossplane's key concepts. |
| 43 | + |
| 44 | +* [Guides]({{<ref "guides">}}) guide you through common use cases, like |
| 45 | + monitoring Crossplane or extending it by writing a composition function. |
49 | 46 |
|
| 47 | +* [CLI Reference]({{<ref "cli">}}) documents the `crossplane` command-line |
| 48 | + interface that you can use to configure a Crossplane control plane. |
50 | 49 |
|
51 |
| -Crossplane is a [Cloud Native Compute Foundation](https://www.cncf.io/) project. |
| 50 | +* [API Reference]({{<ref "api">}}) documents the APIs that you can use to |
| 51 | + configure a Crossplane control plane. |
0 commit comments