Document composition function credentials

[negz]

crossplane/crossplane#5543 adds the ability to pass credentials to a composition function.

apiVersion: apiextensions.crossplane.io/v1
kind: Composition
metadata:
  name: parent
spec:
  compositeTypeRef:
    apiVersion: nop.example.org/v1alpha1
    kind: XNopResource
  mode: Pipeline
  pipeline:
  - step: example
    functionRef:
      name: function-needs-a-secret
    credentials:
    - name: credentials-for-something
      source: Secret
      secretRef:
        namespace: crossplane-system
        name: super-secret

[jbw976]

Here's a demo repo that shows how to use credentials with functions - could be useful for writing the documentation.

https://github.com/jbw976/demo-xfn-creds/

[ytsarev]

There is also a related render capability extension crossplane/crossplane#5976 and https://github.com/cychiang/function-print-secrets/tree/main/example that is useful for testing out constructs like

crossplane render example/xr.yaml example/composition.yaml example/functions.yaml --function-credentials=example/secrets/default.yaml -r