Get Started on Crossplane

Install Crossplane

Crossplane installs into an existing Kubernetes cluster, creating the Crossplane pod.

Installing Crossplane enables the installation of Crossplane Provider, Function, and Configuration resources.

Tip

If you don’t have a Kubernetes cluster create one locally with Kind.

Prerequisites

An actively supported Kubernetes version
Helm version v3.2.0 or later

Install Crossplane

Install Crossplane using the Helm chart.

Get Started With Composition

This guide shows how to create a new kind of custom resource named App. When a user calls the custom resource API to create an App, Crossplane creates a Deployment and a Service.

Crossplane calls this composition. The App is composed of the Deployment and the Service.

Tip

The guide shows how to configure composition using YAML, templated YAML, Python, and KCL. You can pick your preferred language.

An App custom resource looks like this:

Get Started With Managed Resources

This guide shows how to install and use a new kind of custom resource called Bucket. When a user calls the custom resource API to create a Bucket, Crossplane creates a bucket in AWS S3.

Crossplane calls this a managed resource. A managed resource is a ready-made custom resource that manages something outside of the control plane.

A Bucket managed resource looks like this:

1apiVersion: s3.aws.m.upbound.io/v1beta1
2kind: Bucket
3metadata:
4 namespace: default
5 name: crossplane-bucket-example
6spec:
7 forProvider:
8 region: us-east-2

Note

Kubernetes calls third party API resources custom resources.

Prerequisites

This guide requires: