diff --git a/README.md b/README.md index 9041143..d1dbc92 100644 --- a/README.md +++ b/README.md @@ -36,3 +36,33 @@ This repository serves as a foundational step. To enhance your control plane, co Upbound will automatically detect the commits you make in your repo and build the configuration package for you. To learn more about how to build APIs for your managed control planes in Upbound, read the guide on Upbound's docs. + +# Using the make file +## render target +### Overview +`make render` target automates the rendering of Crossplane manifests using specified annotations within your YAML files. +The annotations guide the rendering process, specifying paths to composition, function, environment, and observe files. + +### Annotations +The `make render` target relies on specific annotations in your YAML files to determine how to process each file. +The following annotations are supported: + +**render.crossplane.io/composition-path**: Specifies the path to the composition file to be used in rendering. + +**render.crossplane.io/function-path**: Specifies the path to the function file to be used in rendering. + +**render.crossplane.io/environment-path** (optional): Specifies the path to the environment file. If not provided, the rendering will proceed without an environment. + +**render.crossplane.io/observe-path** (optional): Specifies the path to the observe file. If not provided, the rendering will proceed without observation settings. + +```yaml +apiVersion: aws.platform.upbound.io/v1alpha1 +kind: XEKS +metadata: + name: configuration-aws-eks + annotations: + render.crossplane.io/composition-path: apis/pat/composition.yaml + render.crossplane.io/function-path: examples/functions.yaml +spec: + parameters:{} +``` \ No newline at end of file diff --git a/examples/configuration.yaml b/examples/configuration.yaml index d2d3873..632ddf6 100644 --- a/examples/configuration.yaml +++ b/examples/configuration.yaml @@ -1,6 +1,6 @@ apiVersion: pkg.crossplane.io/v1 kind: Configuration metadata: - name: cofiguration-aws-eks + name: configuration-aws-eks spec: package: xpkg.upbound.io/upbound/configuration-aws-eks:v0.12.0