diff --git a/docs/getting-started/run-applications.md b/docs/getting-started/run-applications.md index 47894552ca3..c6abbe53abe 100644 --- a/docs/getting-started/run-applications.md +++ b/docs/getting-started/run-applications.md @@ -33,12 +33,38 @@ on-demand by Crossplane. > published a PostgreSQLInstance with at least one working Composition in order > to create the OAM application we'll use in this guide. -## Install the OAM Addon +## Infrastructure Operator + +### Install workloads and traits As the infrastructure operator our work is almost done - we defined, published, -and composed the infrastructure that our application developer and operator -team-mates will use in the previous guide. One task remains for us, which is to -install and configure Crossplane's OAM addon. +and composed the infrastructure that our application developer and operator +teammates will use in the previous guide. One task remains, which is to define +the [_workloads_] and [_traits_] that our platform supports. + +OAM applications consist of workloads, each of which may be modified by traits. +The infrastructure operator may choose which workloads and traits by creating +or deleting `WorkloadDefinitions` and `TraitDefinitions` like below: + +```yaml +--- +apiVersion: core.oam.dev/v1alpha2 +kind: WorkloadDefinition +metadata: + name: containerizedworkloads.core.oam.dev +spec: + definitionRef: + name: containerizedworkloads.core.oam.dev +``` +Run the following command to add support for all the workloads and traits required +by this guide: + +```console +kubectl apply -f https://raw.githubusercontent.com/crossplane/crossplane/master/docs/snippets/run/definitions.yaml +``` + +Now that we've defined our workloads and traits, we must install Crossplane's OAM addon. This addon +packages the controllers that reconcile core OAM workloads and traits.