Skip to content

Commit

Permalink
docs(render): add informations about render target (#79)
Browse files Browse the repository at this point in the history
* docs(render): add informations about render target

Signed-off-by: Christopher Haar <[email protected]>

* fix(typo): fix typo in configuration

Signed-off-by: Christopher Haar <[email protected]>

* docs(readme): add
 example for rendering

Signed-off-by: Christopher Haar <[email protected]>

---------

Signed-off-by: Christopher Haar <[email protected]>
  • Loading branch information
haarchri authored Aug 14, 2024
1 parent 9ac18c8 commit 1d6f29f
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 1 deletion.
30 changes: 30 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:{}
```
2 changes: 1 addition & 1 deletion examples/configuration.yaml
Original file line number Diff line number Diff line change
@@ -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

0 comments on commit 1d6f29f

Please sign in to comment.