crossplane-function-cue

crossplane-function-cue

A crossplane function that runs cue scripts for composing resources.

Build status

Building

$ make # generate input, compile, test, lint
$ make docker # build docker image
$ make docker-push # push docker image

Function interface

You define the function as follows:

apiVersion: pkg.crossplane.io/v1beta1
kind: Function
metadata:
  name: fn-cue
spec:
  package: gotwarlost/crossplane-function-cue:latest
  packagePullPolicy: Always

and reference it in a composition as follows:

  pipeline:
    - step: run cue composition
      functionRef:
        name: fn-cue
      input:
        apiVersion: fn-cue/v1    # can be anything
        kind: CueFunctionParams  # can be anything
        spec:
          source: Inline         # only Inline is supported for now
          script: |              # text of cue program
            text of cue program
          # show inputs and outputs for the composition in the pod log in pretty format
          debug: true  

The full spec of the input object can be found here

The Go code

The program xp-function-cue provides the following subcommands:

• server - used by the docker image to run the function implementation
• openapi - utility that converts a cue type into an openAPI schema that has self-contained types.
• package-script - utility that takes a cue package and turns it into a self-contained cue script of the form:

  "_script": "script text"

• cue-test - utility to unit test your cue implementation using inputs from various stages of the composition lifecycle.

The cue script

The cue script is a single self-contained program(*) that you provide which is compiled after it is appended with additional cue code that looks like the following:

  "_request": <input-object>

The <input-object> is the same as the RunFunctionRequest message in JSON form, except it only contains the observed, desired, and context attributes. It does not have the meta or the input attributes.

The cue script is expected to return a response that is the JSON equivalent of the State message containing the desired state. The function runner will selectively update its internal desired state with the returned resources. If a composite is returned, it will also be set in the response. You will only typically include the status of the composite resource.

(*) Note that it is not necessary for the cue source code to be in a single file. It can span multiple files in a single package and depend on other packages. You use the package-script sub-command of xp-function-cue to create the self-contained script. This, in turn, uses cue def --inline-imports under the covers.

See the example implementation to get a sense of how the composition works. A detailed walkthrough can be found in the README for the example.

License

The code is distributed under the Apache 2 license. See the LICENSE file for details.